diff options
45 files changed, 67 insertions, 67 deletions
diff --git a/man2/epoll_ctl.2 b/man2/epoll_ctl.2 index d20efeb12f..1fbe74eeea 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -239,7 +239,7 @@ interface supports all file descriptors that support .SH BUGS In kernel versions before 2.6.9, the .B EPOLL_CTL_DEL -operation required a non-NULL pointer in +operation required a non-null pointer in .IR event , even though this argument is ignored. Since Linux 2.6.9, @@ -248,7 +248,7 @@ can be specified as NULL when using .BR EPOLL_CTL_DEL . Applications that need to be portable to kernels before 2.6.9 -should specify a non-NULL pointer in +should specify a non-null pointer in .IR event . .SH SEE ALSO .BR epoll_create (2), diff --git a/man2/execve.2 b/man2/execve.2 index 803caecb9e..bee813da01 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -62,7 +62,7 @@ By convention, the first of these strings should contain the filename associated with the file being executed. \fIenvp\fP is an array of strings, conventionally of the form \fBkey=value\fP, which are passed as environment to the new program. -Both \fIargv\fP and \fIenvp\fP must be terminated by a NULL pointer. +Both \fIargv\fP and \fIenvp\fP must be terminated by a null pointer. The argument vector and environment can be accessed by the called program's main function, when it is defined as: @@ -502,7 +502,7 @@ or .I envp can be specified as NULL, which has the same effect as specifying these arguments -as a pointer to a list containing a single NULL pointer. +as a pointer to a list containing a single null pointer. .B "Do not take advantage of this misfeature!" It is nonstandard and nonportable: on most other UNIX systems doing this will result in an error diff --git a/man2/recv.2 b/man2/recv.2 index 1d3ae18bac..267d4ade18 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -313,7 +313,7 @@ and .I msg_namelen specify the source address if the socket is unconnected; .I msg_name -may be given as a NULL pointer if no names are desired or required. +may be given as a null pointer if no names are desired or required. The fields .I msg_iov and diff --git a/man2/timer_create.2 b/man2/timer_create.2 index 67f00070f0..8bc5425e83 100644 --- a/man2/timer_create.2 +++ b/man2/timer_create.2 @@ -54,7 +54,7 @@ _POSIX_C_SOURCE\ >=\ 199309L creates a new per-process interval timer. The ID of the new timer is returned in the buffer pointed to by .IR timerid , -which must be a non-NULL pointer. +which must be a non-null pointer. This ID is unique within the process, until the timer is deleted. The new timer is initially disarmed. diff --git a/man2/wait.2 b/man2/wait.2 index 5c39f8a561..f5ea617380 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -539,7 +539,7 @@ must ensure that .I infop points to a .I siginfo_t -structure (i.e., that it is a non-NULL pointer). +structure (i.e., that it is a non-null pointer). On Linux, if .I infop is NULL, diff --git a/man3/argz_add.3 b/man3/argz_add.3 index 2dfb272ece..3d07fc0be6 100644 --- a/man3/argz_add.3 +++ b/man3/argz_add.3 @@ -58,7 +58,7 @@ If the length is nonzero, the last byte of the buffer must be a null byte. .LP These functions are for handling argz vectors. The pair (NULL,0) is an argz vector, and, conversely, -argz vectors of length 0 must have NULL pointer. +argz vectors of length 0 must have null pointer. Allocation of nonempty argz vectors is done using .BR malloc (3), so that diff --git a/man3/basename.3 b/man3/basename.3 index 817ad9215c..15027fc5f0 100644 --- a/man3/basename.3 +++ b/man3/basename.3 @@ -70,7 +70,7 @@ and return the string "/". If .I path -is a NULL pointer or points to an empty string, then both +is a null pointer or points to an empty string, then both .BR dirname () and .BR basename () diff --git a/man3/dlopen.3 b/man3/dlopen.3 index 359bee74f3..1d22e00b97 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -192,7 +192,7 @@ This flag is not specified in POSIX.1-2001. .PP If .I filename -is a NULL pointer, then the returned handle is for the main program. +is NULL, then the returned handle is for the main program. When given to .BR dlsym (), this handle causes a search for a symbol in the main program, diff --git a/man3/exec.3 b/man3/exec.3 index 51d665b36d..6356d2c445 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -101,7 +101,7 @@ The first argument, by convention, should point to the filename associated with the file being executed. The list of arguments .I must -be terminated by a NULL pointer, +be terminated by a null pointer, and, since these are variadic functions, this pointer must be cast .IR "(char\ *) NULL" . .PP @@ -116,7 +116,7 @@ The first argument, by convention, should point to the filename associated with the file being executed. The array of pointers .I must -be terminated by a NULL pointer. +be terminated by a null pointer. .PP The .BR execle () @@ -129,7 +129,7 @@ The .I envp argument is an array of pointers to null-terminated strings and .I must -be terminated by a NULL pointer. +be terminated by a null pointer. The other functions take the environment for the new process image from the external variable .I environ diff --git a/man3/fopencookie.3 b/man3/fopencookie.3 index 9582d50f7d..ab01d06f79 100644 --- a/man3/fopencookie.3 +++ b/man3/fopencookie.3 @@ -141,7 +141,7 @@ function should update the stream offset appropriately. If .I *read -is a NULL pointer, +is a null pointer, then reads from the custom stream always return end of file. .TP .I cookie_write_function_t *write @@ -168,7 +168,7 @@ function should update the stream offset appropriately. If .I *write -is a NULL pointer, +is a null pointer, then output to the stream is discarded. .TP .I cookie_seek_function_t *seek @@ -210,7 +210,7 @@ function should return 0 on success, and \-1 on error. If .I *seek -is a NULL pointer, +is a null pointer, then it is not possible to perform seek operations on the stream. .TP .I cookie_close_function_t *close diff --git a/man3/fts.3 b/man3/fts.3 index a6f68ecb55..93744638fa 100644 --- a/man3/fts.3 +++ b/man3/fts.3 @@ -373,7 +373,7 @@ The function takes a pointer to an array of character pointers naming one or more paths which make up a logical file hierarchy to be traversed. The array must be terminated by a -NULL pointer. +null pointer. .PP There are a number of options, at least one of which (either diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index 0f8c0efa7d..63110e37be 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -176,7 +176,7 @@ Multiple flags are specified by bitwise OR-ing them together. .PP All the other fields in the structure pointed to by .I hints -must contain either 0 or a NULL pointer, as appropriate. +must contain either 0 or a null pointer, as appropriate. .PP Specifying .I hints diff --git a/man3/getcwd.3 b/man3/getcwd.3 index c1c65f4991..d3519389ca 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -183,7 +183,7 @@ The .I size argument is zero and .I buf -is not a NULL pointer. +is not a null pointer. .TP EINVAL .BR getwd (): diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 9be2c28fd0..fc76e892fb 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -262,7 +262,7 @@ The members of the \fIhostent\fP structure are: The official name of the host. .TP .I h_aliases -An array of alternative names for the host, terminated by a NULL pointer. +An array of alternative names for the host, terminated by a null pointer. .TP .I h_addrtype The type of address; always @@ -276,7 +276,7 @@ The length of the address in bytes. .TP .I h_addr_list An array of pointers to network addresses for the host (in network byte -order), terminated by a NULL pointer. +order), terminated by a null pointer. .TP .I h_addr The first address in \fIh_addr_list\fP for backward compatibility. @@ -287,7 +287,7 @@ and .BR gethostbyaddr () functions return the .I hostent -structure or a NULL pointer if an error occurs. +structure or a null pointer if an error occurs. On error, the .I h_errno variable holds an error number. diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index 0a67dcb436..af3e838f75 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -105,14 +105,14 @@ field points to a structure containing the interface address. .I sa_family subfield should be consulted to determine the format of the address structure.) -This field may contain a NULL pointer. +This field may contain a null pointer. .PP The .I ifa_netmask field points to a structure containing the netmask associated with .IR ifa_addr , if applicable for the address family. -This field may contain a NULL pointer. +This field may contain a null pointer. .PP Depending on whether the bit .B IFF_BROADCAST diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index 9972eaa425..96806e0aa5 100644 --- a/man3/getipnodebyname.3 +++ b/man3/getipnodebyname.3 @@ -184,7 +184,7 @@ and must be set to .IR "sizeof(struct in6_addr)" . .SH RETURN VALUE -A NULL pointer is returned if an error occurred, and +NULL is returned if an error occurred, and .I error_num will contain an error code from the following list: .TP @@ -213,7 +213,7 @@ This is the official name of this network host. .TP .I h_aliases This is an array of pointers to unofficial aliases for the same host. -The array is terminated by a NULL pointer. +The array is terminated by a null pointer. .TP .I h_addrtype This is a copy of the @@ -254,7 +254,7 @@ is .I h_addr_list This is an array of one or more pointers to network address structures for the network host. -The array is terminated by a NULL pointer. +The array is terminated by a null pointer. .SH CONFORMING TO RFC\ 2553. .\" Not in POSIX.1-2001. diff --git a/man3/getlogin.3 b/man3/getlogin.3 index cd43163b92..fcbd0fb9fe 100644 --- a/man3/getlogin.3 +++ b/man3/getlogin.3 @@ -53,7 +53,7 @@ _XOPEN_SOURCE .BR getlogin () returns a pointer to a string containing the name of the user logged in on the controlling terminal of the process, or a -NULL pointer if this information cannot be determined. +null pointer if this information cannot be determined. The string is statically allocated and might be overwritten on subsequent calls to this function or to @@ -69,7 +69,7 @@ of size returns a pointer to a string containing a username associated with the effective user ID of the process. If \fIstring\fP -is not a NULL pointer, it should be an array that can hold at least +is not a null pointer, it should be an array that can hold at least \fBL_cuserid\fP characters; the string is returned in this array. Otherwise, a pointer to a string in a static area is returned. This diff --git a/man3/getnetent.3 b/man3/getnetent.3 index 22f4050d4d..f0717445cf 100644 --- a/man3/getnetent.3 +++ b/man3/getnetent.3 @@ -136,7 +136,7 @@ and functions return a pointer to a statically allocated .I netent -structure, or a NULL pointer if an +structure, or a null pointer if an error occurs or the end of the file is reached. .SH FILES .TP diff --git a/man3/getprotoent.3 b/man3/getprotoent.3 index 552fbbf0aa..d41e926646 100644 --- a/man3/getprotoent.3 +++ b/man3/getprotoent.3 @@ -129,7 +129,7 @@ and functions return a pointer to a statically allocated .I protoent -structure, or a NULL pointer if an +structure, or a null pointer if an error occurs or the end of the file is reached. .SH FILES .PD 0 diff --git a/man3/getrpcent.3 b/man3/getrpcent.3 index 920d3f802b..760b5abad3 100644 --- a/man3/getrpcent.3 +++ b/man3/getrpcent.3 @@ -94,7 +94,7 @@ and return a pointer to a statically allocated .I rpcent structure. -A NULL pointer is returned on EOF or error. +NULL is returned on EOF or error. .SH FILES .TP .I /etc/rpc diff --git a/man3/getservent.3 b/man3/getservent.3 index 373c467add..c22905315e 100644 --- a/man3/getservent.3 +++ b/man3/getservent.3 @@ -148,7 +148,7 @@ and functions return a pointer to a statically allocated .I servent -structure, or a NULL pointer if an +structure, or NULL if an error occurs or the end of the file is reached. .SH FILES .TP diff --git a/man3/getusershell.3 b/man3/getusershell.3 index b52fb04316..87d02bac2d 100644 --- a/man3/getusershell.3 +++ b/man3/getusershell.3 @@ -85,7 +85,7 @@ function closes .SH RETURN VALUE The .BR getusershell () -function returns a NULL pointer on end-of-file. +function returns NULL on end-of-file. .SH FILES .nf /etc/shells diff --git a/man3/glob.3 b/man3/glob.3 index 923ca559eb..2f1285360e 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -114,7 +114,7 @@ Reserve .I pglob\->gl_offs slots at the beginning of the list of strings in .IR pglob\->pathv . -The reserved slots contain NULL pointers. +The reserved slots contain null pointers. .TP .B GLOB_NOCHECK If no pattern matches, return the original pattern. @@ -241,7 +241,7 @@ Upon successful return, contains the number of matched pathnames and .I pglob\->gl_pathv contains a pointer to the list of pointers to matched pathnames. -The list of pointers is terminated by a NULL pointer. +The list of pointers is terminated by a null pointer. .PP It is possible to call .BR glob () diff --git a/man3/if_nameindex.3 b/man3/if_nameindex.3 index 19642316ad..2480b24401 100644 --- a/man3/if_nameindex.3 +++ b/man3/if_nameindex.3 @@ -72,7 +72,7 @@ when no longer needed. On success, .BR if_nameindex () returns pointer to the array; -on error, a NULL pointer is returned, and +on error, NULL is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man3/inet_ntop.3 b/man3/inet_ntop.3 index 34463d852c..5144344827 100644 --- a/man3/inet_ntop.3 +++ b/man3/inet_ntop.3 @@ -41,7 +41,7 @@ in the address family into a character string. The resulting string is copied to the buffer pointed to by .IR dst , -which must be a non-NULL pointer. +which must be a non-null pointer. The caller specifies the number of bytes available in this buffer in the argument .IR size . @@ -83,7 +83,7 @@ bytes long. .SH RETURN VALUE On success, .BR inet_ntop () -returns a non-NULL pointer to +returns a non-null pointer to .IR dst . NULL is returned if there was an error, with .I errno diff --git a/man3/lio_listio.3 b/man3/lio_listio.3 index 9c68299cbb..d7accebf5c 100644 --- a/man3/lio_listio.3 +++ b/man3/lio_listio.3 @@ -71,7 +71,7 @@ The .I nitems argument specifies the size of the array .IR aiocb_list . -NULL pointers in +null pointers in .I aiocb_list are ignored. diff --git a/man3/mblen.3 b/man3/mblen.3 index 442f41f303..873cf53508 100644 --- a/man3/mblen.3 +++ b/man3/mblen.3 @@ -25,7 +25,7 @@ mblen \- determine number of bytes in next multibyte character .SH DESCRIPTION If .I s -is not a NULL pointer, the +is not NULL, the .BR mblen () function inspects at most .I n @@ -64,7 +64,7 @@ also returns \-1. .PP If .I s -is a NULL pointer, the +is NULL, the .BR mblen () function .\" The Dinkumware doc and the Single UNIX specification say this, but diff --git a/man3/mbrlen.3 b/man3/mbrlen.3 index 0695eec609..4132bf88cc 100644 --- a/man3/mbrlen.3 +++ b/man3/mbrlen.3 @@ -75,7 +75,7 @@ are undefined. .PP If .I ps -is a NULL pointer, a static anonymous state known only to the +is NULL, a static anonymous state known only to the .BR mbrlen () function is used instead. .SH RETURN VALUE diff --git a/man3/mbrtowc.3 b/man3/mbrtowc.3 index 077ce25aae..f970f74686 100644 --- a/man3/mbrtowc.3 +++ b/man3/mbrtowc.3 @@ -129,7 +129,7 @@ in the initial state and returns 0. .PP In all of the above cases, if .I ps -is a NULL pointer, a static anonymous +is NULL, a static anonymous state known only to the .BR mbrtowc () function is used instead. diff --git a/man3/mbsinit.3 b/man3/mbsinit.3 index e7b5f60c4d..a487afe0d1 100644 --- a/man3/mbsinit.3 +++ b/man3/mbsinit.3 @@ -79,7 +79,7 @@ returns nonzero if .I *ps is an initial state, or if .I ps -is a NULL pointer. +is NULL. Otherwise it returns 0. .SH ATTRIBUTES .SS Multithreading (see pthreads(7)) diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index ad15ba94e2..7700896e57 100644 --- a/man3/mbsnrtowcs.3 +++ b/man3/mbsnrtowcs.3 @@ -54,7 +54,7 @@ is limited to .PP If .I dest -is not a NULL pointer, the +is not NULL, the .BR mbsnrtowcs () function converts at most @@ -137,7 +137,7 @@ and that no destination length limit exists. .PP In both of the above cases, if .I ps -is a NULL pointer, a static anonymous +is NULL, a static anonymous state known only to the .BR mbsnrtowcs () function is used instead. diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index a743f6d332..a629ea629a 100644 --- a/man3/mbsrtowcs.3 +++ b/man3/mbsrtowcs.3 @@ -26,7 +26,7 @@ mbsrtowcs \- convert a multibyte string to a wide-character string .SH DESCRIPTION If .I dest -is not a NULL pointer, the +is not NULL, the .BR mbsrtowcs () function converts the multibyte string @@ -101,7 +101,7 @@ and that no length limit exists. In both of the above cases, if .I ps -is a NULL pointer, a static anonymous +is NULL, a static anonymous state known only to the .BR mbsrtowcs () function is used instead. diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index bdbbfbcc09..e912670a4c 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -25,7 +25,7 @@ mbstowcs \- convert a multibyte string to a wide-character string .SH DESCRIPTION If .I dest -is not a NULL pointer, +is not NULL, the .BR mbstowcs () function converts the diff --git a/man3/mq_notify.3 b/man3/mq_notify.3 index 11a711f0dd..42c5d83d03 100644 --- a/man3/mq_notify.3 +++ b/man3/mq_notify.3 @@ -51,7 +51,7 @@ For the definition and general details of this structure, see .PP If .I sevp -is a non-NULL pointer, then +is a non-null pointer, then .BR mq_notify () registers the calling process to receive message notification. The diff --git a/man3/ptsname.3 b/man3/ptsname.3 index 6e883ca024..47712bc911 100644 --- a/man3/ptsname.3 +++ b/man3/ptsname.3 @@ -45,7 +45,7 @@ On success, returns a pointer to a string in static storage which will be overwritten by subsequent calls. This pointer must not be freed. -On failure, a NULL pointer is returned. +On failure, NULL is returned. On success, .BR ptsname_r () diff --git a/man3/realpath.3 b/man3/realpath.3 index a518bf1623..b28845cd51 100644 --- a/man3/realpath.3 +++ b/man3/realpath.3 @@ -94,7 +94,7 @@ If there is no error, returns a pointer to the .IR resolved_path . -Otherwise, it returns a NULL pointer, the contents +Otherwise, it returns NULL, the contents of the array .I resolved_path are undefined, and diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index 7a12875262..2a85a95fd5 100644 --- a/man3/setnetgrent.3 +++ b/man3/setnetgrent.3 @@ -66,7 +66,7 @@ function retrieves the next netgroup entry, and returns pointers in .IR host , .IR user , .IR domain . -A NULL pointer means that the corresponding entry matches any string. +A null pointer means that the corresponding entry matches any string. The pointers are valid only as long as there is no call to other netgroup-related functions. To avoid this problem you can use the GNU function @@ -81,7 +81,7 @@ is a member of a netgroup. The function .BR innetgr () can be used for this without calling the above three functions. -Again, a NULL pointer is a wildcard and matches any string. +Again, a null pointer is a wildcard and matches any string. The function is thread-safe. .SH RETURN VALUE These functions return 1 on success and 0 for failure. diff --git a/man3/sigvec.3 b/man3/sigvec.3 index 918a21b3a0..49a18a4506 100644 --- a/man3/sigvec.3 +++ b/man3/sigvec.3 @@ -76,7 +76,7 @@ To obtain the current disposition of .I sig without changing it, specify NULL for .IR vec , -and a non-NULL pointer for +and a non-null pointer for .IR ovec . The dispositions for diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 3d4aeef06c..8c82a6f97f 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -79,8 +79,8 @@ The .BR strsignal () function returns the appropriate description string, or an unknown signal message if the signal number is invalid. -On some systems (but not on Linux), a NULL pointer may be -returned instead for an invalid signal number. +On some systems (but not on Linux), NULL may instead be +returned for an invalid signal number. .SH CONFORMING TO POSIX.1-2008. Present on Solaris and the BSDs. diff --git a/man3/strtok.3 b/man3/strtok.3 index bf4cb76a11..6d84fb7b65 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -127,7 +127,7 @@ successive calls to .BR strtok () that specify the delimiter string "\fI;,\fP" would return the strings "\fIaaa\fP" and "\fIbbb\fP", -and then a NULL pointer. +and then a null pointer. The .BR strtok_r () diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3 index e87d656e24..13d88e296b 100644 --- a/man3/wcrtomb.3 +++ b/man3/wcrtomb.3 @@ -87,7 +87,7 @@ is an internal anonymous buffer. .PP In all of the above cases, if .I ps -is a NULL pointer, a static anonymous +is NULL, a static anonymous state known only to the .BR wcrtomb () function is used instead. diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index b5fd2bd9bd..479cb58d11 100644 --- a/man3/wcsnrtombs.3 +++ b/man3/wcsnrtombs.3 @@ -55,7 +55,7 @@ is limited to .PP If .I dest -is not a NULL pointer, +is not NULL, the .BR wcsnrtombs () function converts @@ -133,7 +133,7 @@ no destination length limit exists. In both of the above cases, if .I ps -is a NULL pointer, a static anonymous +is NULL, a static anonymous state known only to the .BR wcsnrtombs () function is used instead. diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index 0c1566900a..473b27ff06 100644 --- a/man3/wcsrtombs.3 +++ b/man3/wcsrtombs.3 @@ -26,7 +26,7 @@ wcsrtombs \- convert a wide-character string to a multibyte string .SH DESCRIPTION If .I dest -is not a NULL pointer, +is not NULL, the .BR wcsrtombs () function converts @@ -99,7 +99,7 @@ no length limit exists. In both of the above cases, if .I ps -is a NULL pointer, a static anonymous +is NULL, a static anonymous state known only to the .BR wcsrtombs () function is used instead. diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index 1e1b045c6d..40f00fb8d1 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -25,7 +25,7 @@ wcstombs \- convert a wide-character string to a multibyte string .SH DESCRIPTION If .I dest -is not a NULL pointer, the +is not NULL, the .BR wcstombs () function converts the wide-character string diff --git a/man3/xdr.3 b/man3/xdr.3 index 7079f479fe..463f8e88b2 100644 --- a/man3/xdr.3 +++ b/man3/xdr.3 @@ -249,7 +249,7 @@ This routine returns one if it succeeds, zero otherwise. .IP Like .BR xdr_reference () -except that it serializes NULL pointers, whereas +except that it serializes null pointers, whereas .BR xdr_reference () does not. Thus, @@ -348,7 +348,7 @@ is an XDR procedure that filters the structure between its C form and its external representation. This routine returns one if it succeeds, zero otherwise. .IP -Warning: this routine does not understand NULL pointers. +Warning: this routine does not understand null pointers. Use .BR xdr_pointer () instead. |