From f7a10404bccd5370cf494e1453a276bbf09b1143 Mon Sep 17 00:00:00 2001 From: ru Date: Mon, 20 Nov 2000 14:11:46 +0000 Subject: mdoc(7) police: Nm -> Fn where appropriate. --- lib/libc/gen/getvfsbyname.3 | 7 +------ lib/libc/gen/shm_open.3 | 21 ++++++++++----------- lib/libc/gen/signal.3 | 2 +- lib/libc/gen/tcsetpgrp.3 | 18 +++++++----------- lib/libc/gen/unvis.3 | 2 +- lib/libc/net/getaddrinfo.3 | 2 +- lib/libc/net/inet.3 | 8 ++++---- lib/libc/rpc/getrpcent.3 | 2 +- lib/libc/sys/setresuid.2 | 4 ++-- lib/libc/sys/shm_open.2 | 21 ++++++++++----------- lib/libc/sys/undelete.2 | 4 ++-- 11 files changed, 40 insertions(+), 51 deletions(-) (limited to 'lib/libc') diff --git a/lib/libc/gen/getvfsbyname.3 b/lib/libc/gen/getvfsbyname.3 index 41167bd..df7511e 100644 --- a/lib/libc/gen/getvfsbyname.3 +++ b/lib/libc/gen/getvfsbyname.3 @@ -71,12 +71,7 @@ flag bits that are used to initialize a new mount point using the filesystem .El .Sh RETURN VALUES -If the call to -.Nm getvfsbyname -is successful, 0 is returned. -Otherwise \-1 is returned and -.Va errno -is set appropriately. +.Rv -std getvfsbyname .Sh ERRORS The following errors may be reported: .Bl -tag -width Er diff --git a/lib/libc/gen/shm_open.3 b/lib/libc/gen/shm_open.3 index cbd4dc7..e4910a9 100644 --- a/lib/libc/gen/shm_open.3 +++ b/lib/libc/gen/shm_open.3 @@ -47,13 +47,13 @@ .Fn shm_unlink "const char *path" .Sh DESCRIPTION The -.Nm shm_open +.Fn shm_open function opens (or optionally creates) a .Tn POSIX shared memory object named .Fa path . The -.Nm shm_unlink +.Fn shm_unlink function removes a shared memory object named .Fa path . .Pp @@ -63,9 +63,9 @@ implementation, .Tn POSIX shared memory objects are implemented as ordinary files. The -.Nm shm_open +.Fn shm_open and -.Nm shm_unlink +.Fn shm_unlink act as wrappers around the .Xr open 2 and @@ -87,7 +87,7 @@ In addition, the implementation causes .Fn mmap of a descriptor returned by -.Nm shm_open +.Fn shm_open to behave as if the .Dv MAP_NOSYNC flag had been specified to @@ -96,7 +96,7 @@ flag had been specified to .Xr fcntl 2 . ) .Pp The -.Nm shm_unlink +.Fn shm_unlink function makes no effort to ensure that .Fa path refers to a shared memory object. @@ -173,16 +173,16 @@ specifies an access mode of .Xr unlink 2 .Sh STANDARDS The -.Nm shm_open +.Fn shm_open and -.Nm shm_unlink +.Fn shm_unlink functions are believed to conform to .St -p1003.1b . .Sh HISTORY The -.Nm shm_open +.Fn shm_open and -.Nm shm_unlink +.Fn shm_unlink functions first appeared in .Fx 5.0 . .Sh AUTHORS @@ -191,4 +191,3 @@ functions first appeared in .Pp .An Matthew Dillon Aq dillon@FreeBSD.org .Pq Dv MAP_NOSYNC - diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3 index 2c108d1..f453ed8 100644 --- a/lib/libc/gen/signal.3 +++ b/lib/libc/gen/signal.3 @@ -232,6 +232,6 @@ or .Xr tty 4 .Sh HISTORY This -.Nm signal +.Fn signal facility appeared in .Bx 4.0 . diff --git a/lib/libc/gen/tcsetpgrp.3 b/lib/libc/gen/tcsetpgrp.3 index 4f4b48b..a7d3409 100644 --- a/lib/libc/gen/tcsetpgrp.3 +++ b/lib/libc/gen/tcsetpgrp.3 @@ -47,7 +47,7 @@ .Fn tcsetpgrp "int fd" "pid_t pgrp_id" .Sh DESCRIPTION If the process has a controlling terminal, the -.Nm tcsetpgrp +.Fn tcsetpgrp function sets the foreground process group ID associated with the terminal device to .Fa pgrp_id . @@ -60,16 +60,12 @@ The value of .Fa pgrp_id must be the same as the process group ID of a process in the same session as the calling process. -.Pp -Upon successful completion, -.Nm tcsetpgrp -returns a value of zero. +.Sh RETURN VALUES +.Rv -std tcsetpgrp .Sh ERRORS -If an error occurs, -.Nm tcsetpgrp -returns -1 and the global variable -.Va errno -is set to indicate the error, as follows: +The +.Fn tcsetpgrp +function will fail if: .Bl -tag -width Er .It Bq Er EBADF The @@ -97,7 +93,7 @@ session as the calling process. .Xr tcgetpgrp 3 .Sh STANDARDS The -.Nm tcsetpgprp +.Fn tcsetpgrp function is expected to be compliant with the .St -p1003.1-88 specification. diff --git a/lib/libc/gen/unvis.3 b/lib/libc/gen/unvis.3 index 7f1e25a..74de5f8 100644 --- a/lib/libc/gen/unvis.3 +++ b/lib/libc/gen/unvis.3 @@ -190,7 +190,7 @@ if (unvis(&out, (char)0, &state, UNVIS_END) == UNVIS_VALID) .Re .Sh HISTORY The -.Nm unvis +.Fn unvis function first appeared in .Bx 4.4 . diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3 index deb575f..3af62f9 100644 --- a/lib/libc/net/getaddrinfo.3 +++ b/lib/libc/net/getaddrinfo.3 @@ -411,7 +411,7 @@ Similarly, if it resolves to IPv6, socket is used. Observe that there is no hardcoded reference to particular address family. The code works even if -.Nm getaddrinfo +.Fn getaddrinfo returns addresses that are not IPv4/v6. .Bd -literal -offset indent struct addrinfo hints, *res, *res0; diff --git a/lib/libc/net/inet.3 b/lib/libc/net/inet.3 index 2c7069d..b04d383 100644 --- a/lib/libc/net/inet.3 +++ b/lib/libc/net/inet.3 @@ -235,17 +235,17 @@ for malformed requests. .Re .Sh STANDARDS The -.Nm inet_ntop +.Fn inet_ntop and -.Nm inet_pton +.Fn inet_pton functions conform to .St -xns5.2d2.0 . Note that -.Nm inet_pton +.Fn inet_pton does not accept 1-, 2-, or 3-part dotted addresses; all four parts must be specified. This is a narrower input set than that accepted by -.Nm inet_aton . +.Fn inet_aton . .Sh HISTORY These functions appeared in diff --git a/lib/libc/rpc/getrpcent.3 b/lib/libc/rpc/getrpcent.3 index eef8067..208e5d0 100644 --- a/lib/libc/rpc/getrpcent.3 +++ b/lib/libc/rpc/getrpcent.3 @@ -57,7 +57,7 @@ The .Fn getrpcent function reads the next line of the file, opening the file if necessary. The -.Nm getrpcent +.Fn setrpcent function opens and rewinds the file. If the .Fa stayopen flag is non-zero, diff --git a/lib/libc/sys/setresuid.2 b/lib/libc/sys/setresuid.2 index 8ae2117..deb9978 100644 --- a/lib/libc/sys/setresuid.2 +++ b/lib/libc/sys/setresuid.2 @@ -37,11 +37,11 @@ .Fn setresuid "uid_t ruid" "uid_t euid" "uid_t suid" .Sh DESCRIPTION The -.Nm setresuid +.Fn setresuid system call sets the real, effective and saved user IDs of the current process. The analogous -.Nm setresgid +.Fn setresgid sets the real, effective and saved group IDs. .Pp Privileged processes may set these IDs diff --git a/lib/libc/sys/shm_open.2 b/lib/libc/sys/shm_open.2 index cbd4dc7..e4910a9 100644 --- a/lib/libc/sys/shm_open.2 +++ b/lib/libc/sys/shm_open.2 @@ -47,13 +47,13 @@ .Fn shm_unlink "const char *path" .Sh DESCRIPTION The -.Nm shm_open +.Fn shm_open function opens (or optionally creates) a .Tn POSIX shared memory object named .Fa path . The -.Nm shm_unlink +.Fn shm_unlink function removes a shared memory object named .Fa path . .Pp @@ -63,9 +63,9 @@ implementation, .Tn POSIX shared memory objects are implemented as ordinary files. The -.Nm shm_open +.Fn shm_open and -.Nm shm_unlink +.Fn shm_unlink act as wrappers around the .Xr open 2 and @@ -87,7 +87,7 @@ In addition, the implementation causes .Fn mmap of a descriptor returned by -.Nm shm_open +.Fn shm_open to behave as if the .Dv MAP_NOSYNC flag had been specified to @@ -96,7 +96,7 @@ flag had been specified to .Xr fcntl 2 . ) .Pp The -.Nm shm_unlink +.Fn shm_unlink function makes no effort to ensure that .Fa path refers to a shared memory object. @@ -173,16 +173,16 @@ specifies an access mode of .Xr unlink 2 .Sh STANDARDS The -.Nm shm_open +.Fn shm_open and -.Nm shm_unlink +.Fn shm_unlink functions are believed to conform to .St -p1003.1b . .Sh HISTORY The -.Nm shm_open +.Fn shm_open and -.Nm shm_unlink +.Fn shm_unlink functions first appeared in .Fx 5.0 . .Sh AUTHORS @@ -191,4 +191,3 @@ functions first appeared in .Pp .An Matthew Dillon Aq dillon@FreeBSD.org .Pq Dv MAP_NOSYNC - diff --git a/lib/libc/sys/undelete.2 b/lib/libc/sys/undelete.2 index 9eb71e7..5be51a2 100644 --- a/lib/libc/sys/undelete.2 +++ b/lib/libc/sys/undelete.2 @@ -57,7 +57,7 @@ any objects in a lower layer of the union stack to become visible once more. .Pp Eventually, the -.Nm undelete +.Fn undelete functionality may be expanded to other filesystems able to recover deleted files such as the log-structured filesystem. .Sh RETURN VALUES @@ -102,5 +102,5 @@ points outside the process's allocated address space. .Xr mount_union 8 .Sh HISTORY An -.Nm undelete +.Fn undelete function call first appeared in 4.4BSD-Lite. -- cgit v1.1