misc/46447: No documentation for kernel sockets - socreate sobind soclose etc.

[nathanialsloss%yahoo.com.au@localhost]

>Number:         46447
>Category:       misc
>Synopsis:       No documentation for kernel sockets - socreate sobind soclose 
>etc.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Sun May 13 00:30:00 +0000 2012
>Originator:     Nat Sloss
>Release:        NetBSD Current 6.99.6
>Organization:
>Environment:
NetBSD beast 6.99.6 NetBSD 6.99.6 (LOCKDEBUG) #6: Sat May 12 00:23:26 EST 2012  
build@beast:/usr/src/sys/arch/i386/compile/obj/LOCKDEBUG i386
>Description:
Hi.

After trying to program using kernel sockets I found it frustrating that the 
functions socreate sobind soclose etc. were not documented.

I managed though to work it out by reading the source and various include files 
as well as reading the manual pages for other BSDs.

Other BSDs have manual pages for kernel sockets but our sockets differ (mbufs) 
so documentation would be useful.
>How-To-Repeat:
Refer to above.
>Fix:
Other sources for kernel socket manual pages include:

FreeBSD socket.9
OpenBSD socreate.9


Regards,

Nat.