socket.2: socket() uses the lowest available file descriptor

Reported-by: Yubin Ruan <ablacktshirt@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/socket.2 b/man2/socket.2
index 5cc07fb485bff4fc03d3c8be328a9758eb4af359..dfba70ff6098538e8db8f5d74246f9730f9d112b 100644 (file)
--- a/man2/socket.2
+++ b/man2/socket.2
@@ -53,6 +53,8 @@ socket \- create an endpoint for communication
 .BR socket ()
 creates an endpoint for communication and returns a file descriptor
 that refers to that endpoint.
+The file descriptor returned by a successful call will be
+the lowest-numbered file descriptor not currently open for the process.
 .PP
 The
 .I domain