From a4b155d7a2170a500eb79b46959eef4018441062 Mon Sep 17 00:00:00 2001 From: ru Date: Wed, 18 Dec 2002 09:22:32 +0000 Subject: mdoc(7) police: Tidy up the syscall language. Stop calling system calls "function calls". Use "The .Fn system call" a-la "The .Nm utility". When referring to a non-BSD implementation in the HISTORY section, call syscall a function, to be safe. --- lib/libc/sys/socket.2 | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) (limited to 'lib/libc/sys/socket.2') diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index bd1a14c..c3869a7 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -46,7 +46,9 @@ .Ft int .Fn socket "int domain" "int type" "int protocol" .Sh DESCRIPTION -.Fn Socket +The +.Fn socket +system call creates an endpoint for communication and returns a descriptor. .Pp The @@ -156,7 +158,7 @@ to pipes. A stream socket must be in a state before any data may be sent or received on it. A connection to another socket is created with a .Xr connect 2 -call. +system call. Once connected, data may be transferred using .Xr read 2 and @@ -165,14 +167,14 @@ calls or some variant of the .Xr send 2 and .Xr recv 2 -calls. +functions. (Some protocol families, such as the Internet family, support the notion of an .Dq implied connect , which permits data to be sent piggybacked onto a connect operation by using the .Xr sendto 2 -call.) +system call.) When a session has been completed a .Xr close 2 may be performed. @@ -229,7 +231,7 @@ which returns the next datagram with its return address. .Pp An .Xr fcntl 2 -call can be used to specify a process group to receive +system call can be used to specify a process group to receive a .Dv SIGURG signal when the out-of-band data arrives. @@ -252,7 +254,7 @@ value is a descriptor referencing the socket. .Sh ERRORS The .Fn socket -call fails if: +system call fails if: .Bl -tag -width Er .It Bq Er EPROTONOSUPPORT The protocol type or the specified protocol is not supported @@ -300,5 +302,5 @@ The socket cannot be created until sufficient resources are freed. .Sh HISTORY The .Fn socket -function call appeared in +system call appeared in .Bx 4.2 . -- cgit v1.1