Socket Documentation

[Chris Johns]

Paul Whitfield wrote:
> 
> We are having to support some developers here who lack "socket savvy".
> I was wondering if anyone had a good recommendation for a source
> of documentation for the BSD Sockets, i.e. a good place to get
> man pages or texinfo files for the version of BSD sockets used in
> RTEMS.
> 
> I don't need pointers to tutorials, just a source to put together
> man pages / a pdf of the sockets calls.
> 
> We are using a cygwin hosted environment which sadly lacks
> man pages for sockets, and the users we are supporting
> do not have access to a linux or bsd box.
> 

I am no expert with this but on Linux I can convert a Linux man page to PDF with:

   $ man -t socket | ps2pdf - > socket.pdf

For the man pages for the RTEMS networking stack I suggest you obtain the FreeBSD man 
pages (http://www.freebsd.org/) and then try the -M option of man to select a 
different man page base.

To find the list of man pages referenced check out the man option -w (again on 
Linux). Mayeb this may help create a list.

A simple trick with postscript is to append separate ps files together then convert 
to resulting file to PDF. This creates a single PDF (I used this when receiving faxes 
:-)).

If you can create a script to do this I am sure it would be a welcome part of the 
RTEMS documentation package.

-- 
  Chris Johns, cjohns at cybertec.com.au