Explicitly mention in RETURN VALUES that socket() sets
authorSascha Wildner <swildner@dragonflybsd.org>
Wed, 26 Jan 2005 21:52:36 +0000 (21:52 +0000)
committerSascha Wildner <swildner@dragonflybsd.org>
Wed, 26 Jan 2005 21:52:36 +0000 (21:52 +0000)
errno upon failure.

Noticed-by: Liam J. Foy <liamfoy@sepulcrum.org>
lib/libc/sys/socket.2
lib/libcr/sys/socket.2

index 91980ae..5904c0a 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     From: @(#)socket.2     8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/socket.2,v 1.12.2.11 2002/12/29 16:35:34 schweikh Exp $
-.\" $DragonFly: src/lib/libc/sys/socket.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/socket.2,v 1.3 2005/01/26 21:52:36 swildner Exp $
 .\"
 .Dd November 24, 1997
 .Dt SOCKET 2
@@ -248,8 +248,12 @@ and
 .Xr getsockopt 2
 are used to set and get options, respectively.
 .Sh RETURN VALUES
-A -1 is returned if an error occurs, otherwise the return
-value is a descriptor referencing the socket.
+Upon successful completion
+.Fn socket
+returns a descriptor referencing the socket.
+Otherwise, -1 is returned and the global variable
+.Va errno
+is set to indicate the error.
 .Sh ERRORS
 The
 .Fn socket
index 853f89f..0bf42fb 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     From: @(#)socket.2     8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/socket.2,v 1.12.2.11 2002/12/29 16:35:34 schweikh Exp $
-.\" $DragonFly: src/lib/libcr/sys/Attic/socket.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libcr/sys/Attic/socket.2,v 1.3 2005/01/26 21:52:36 swildner Exp $
 .\"
 .Dd November 24, 1997
 .Dt SOCKET 2
@@ -248,8 +248,12 @@ and
 .Xr getsockopt 2
 are used to set and get options, respectively.
 .Sh RETURN VALUES
-A -1 is returned if an error occurs, otherwise the return
-value is a descriptor referencing the socket.
+Upon successful completion
+.Fn socket
+returns a descriptor referencing the socket.
+Otherwise, -1 is returned and the global variable
+.Va errno
+is set to indicate the error.
 .Sh ERRORS
 The
 .Fn socket