[src/trunk]: src/lib/libc/sys socket(2): Move prose list of socket type summa...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/92384e6cf9c5
branches:  trunk
changeset: 376257:92384e6cf9c5
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Tue Jun 06 09:14:27 2023 +0000

description:
socket(2): Move prose list of socket type summaries into a table.

diffstat:

 lib/libc/sys/socket.2 |  44 ++++++++++++++------------------------------
 1 files changed, 14 insertions(+), 30 deletions(-)

diffs (70 lines):

diff -r 0f4a0838e872 -r 92384e6cf9c5 lib/libc/sys/socket.2
--- a/lib/libc/sys/socket.2     Tue Jun 06 09:10:08 2023 +0000
+++ b/lib/libc/sys/socket.2     Tue Jun 06 09:14:27 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: socket.2,v 1.44 2023/06/06 09:10:08 riastradh Exp $
+.\"    $NetBSD: socket.2,v 1.45 2023/06/06 09:14:27 riastradh Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -76,12 +76,24 @@ The socket has the indicated
 which specifies the semantics of communication.
 Currently defined types are:
 .Pp
-.Bl -tag -offset indent -compact
+.Bl -tag -offset indent -width 20n
 .It Dv SOCK_STREAM
+Provides sequenced, reliable, two-way connection based byte streams.
+An out-of-band data transmission mechanism may be supported.
 .It Dv SOCK_DGRAM
+Supports datagrams: connectionless, unreliable messages of a
+fixed\(emtypically small\(emmaximum length.
 .It Dv SOCK_RAW
+Provides access to internal network protocols and interfaces.
+Available only to the super-user.
+Not described here.
 .It Dv SOCK_SEQPACKET
+Provide a sequenced, reliable, two-way connection-based data
+transmission path for datagrams of fixed maximum length.
+A consumer may be required to read an entire packet with each read
+system call.
 .It Dv SOCK_RDM
+Not implemented.
 .El
 .Pp
 The following flags can be or'ed to the type to condition the returned
@@ -100,34 +112,6 @@ instead of raising
 .Dv SIGPIPE .
 .El
 .Pp
-A
-.Dv SOCK_STREAM
-type provides sequenced, reliable,
-two-way connection based byte streams.
-An out-of-band data transmission mechanism may be supported.
-A
-.Dv SOCK_DGRAM
-socket supports
-datagrams (connectionless, unreliable messages of
-a fixed (typically small) maximum length).
-A
-.Dv SOCK_SEQPACKET
-socket may provide a sequenced, reliable,
-two-way connection-based data transmission path for datagrams
-of fixed maximum length; a consumer may be required to read
-an entire packet with each read system call.
-This facility is protocol specific, and presently implemented
-only for
-.Dv PF_NS .
-.Dv SOCK_RAW
-sockets provide access to internal network protocols and interfaces.
-The types
-.Dv SOCK_RAW ,
-which is available only to the super-user, and
-.Dv SOCK_RDM ,
-which is planned,
-but not yet implemented, are not described here.
-.Pp
 The
 .Fa protocol
 specifies a particular protocol to be used with the socket.