summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorkeramida <keramida@FreeBSD.org>2004-12-23 23:45:25 +0000
committerkeramida <keramida@FreeBSD.org>2004-12-23 23:45:25 +0000
commit9992d6428f038cb027b08a659e8253ae0f0503a1 (patch)
treefa17121d9a635b571177c32da68d0670990b2c96
parent9cd8396061808a32518fcb7e287437308d5ef937 (diff)
downloadFreeBSD-src-9992d6428f038cb027b08a659e8253ae0f0503a1.zip
FreeBSD-src-9992d6428f038cb027b08a659e8253ae0f0503a1.tar.gz
``NULL is a specific instance of a null pointer constant; the generic is
a "null pointer".'' Making good use of the excellent explanations sent to me by Ruslan Ermilov, Garrett Wollman and Bruce Evans, correct the descriptions of null pointers. They are just "null pointers", not nil, not NULL or ".Dv NULL". Suggested by: ru, wollman, bde Reviewed by: ru, wollman Pointy hat: keramida
-rw-r--r--lib/libc/sys/acct.24
-rw-r--r--lib/libc/sys/adjtime.24
-rw-r--r--lib/libc/sys/aio_suspend.210
-rw-r--r--lib/libc/sys/getitimer.24
-rw-r--r--lib/libc/sys/recv.25
-rw-r--r--lib/libc/sys/select.215
6 files changed, 12 insertions, 30 deletions
diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2
index 1119bbe..4f371d3 100644
--- a/lib/libc/sys/acct.2
+++ b/lib/libc/sys/acct.2
@@ -51,9 +51,7 @@ system call enables or disables the collection of system accounting
records.
If the argument
.Fa file
-is a
-.Dv NULL
-pointer, accounting is disabled.
+is a null pointer, accounting is disabled.
If
.Fa file
is an
diff --git a/lib/libc/sys/adjtime.2 b/lib/libc/sys/adjtime.2
index a5f873e..5794a32 100644
--- a/lib/libc/sys/adjtime.2
+++ b/lib/libc/sys/adjtime.2
@@ -72,9 +72,7 @@ may not be finished when
is called again.
If
.Fa olddelta
-is not a
-.Dv NULL
-pointer,
+is not a null pointer,
the structure pointed to will contain, upon return, the
number of microseconds still to be corrected
from the earlier call.
diff --git a/lib/libc/sys/aio_suspend.2 b/lib/libc/sys/aio_suspend.2
index 77d8ec5..db704f1 100644
--- a/lib/libc/sys/aio_suspend.2
+++ b/lib/libc/sys/aio_suspend.2
@@ -52,18 +52,14 @@ is an array of
.Fa niocb
pointers to asynchronous I/O requests.
Array members containing
-NULL will be silently ignored.
+null pointers will be silently ignored.
.Pp
If
.Fa timeout
-is not a
-.Dv NULL
-pointer, it specifies a maximum interval to suspend.
+is not a null pointer, it specifies a maximum interval to suspend.
If
.Fa timeout
-is a
-.Dv NULL
-pointer, the suspend blocks indefinitely.
+is a null pointer, the suspend blocks indefinitely.
To effect a
poll, the
.Fa timeout
diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2
index 2efb0f8..90f4977 100644
--- a/lib/libc/sys/getitimer.2
+++ b/lib/libc/sys/getitimer.2
@@ -66,9 +66,7 @@ system call sets a timer to the specified
.Fa value
(returning the previous value of the timer if
.Fa ovalue
-is not a
-.Dv NULL
-pointer).
+is not a null pointer).
.Pp
A timer value is defined by the
.Fa itimerval
diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2
index 8c3e1b6..6833a59 100644
--- a/lib/libc/sys/recv.2
+++ b/lib/libc/sys/recv.2
@@ -63,8 +63,7 @@ it is connection-oriented.
.Pp
If
.Fa from
-is not
-.Dv NULL ,
+is not a null pointer
and the socket is not connection-oriented,
the source address of the message is filled in.
The
@@ -85,7 +84,7 @@ socket (see
and is identical to
.Fn recvfrom
with a
-.Dv NULL
+null pointer passed as its
.Fa from
argument.
As it is redundant, it may not be supported in future releases.
diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2
index 193c903..d90d521 100644
--- a/lib/libc/sys/select.2
+++ b/lib/libc/sys/select.2
@@ -108,23 +108,18 @@ to the maximum number of descriptors supported by the system.
.Pp
If
.Fa timeout
-is not a
-.Dv NULL
-pointer, it specifies the maximum interval to wait for the
+is not a null pointer, it specifies the maximum interval to wait for the
selection to complete.
System activity can lengthen the interval by
an indeterminate amount.
.Pp
If
.Fa timeout
-is a
-.Dv NULL
-pointer, the select blocks indefinitely.
+is a null pointer, the select blocks indefinitely.
.Pp
To effect a poll, the
.Fa timeout
-argument should not be
-.Dv NULL ,
+argument should not be a null pointer,
but it should point to a zero-valued timeval structure.
.Pp
Any of
@@ -132,9 +127,7 @@ Any of
.Fa writefds ,
and
.Fa exceptfds
-may be given as
-.Dv NULL
-pointers if no descriptors are of interest.
+may be given as null pointers if no descriptors are of interest.
.Sh RETURN VALUES
The
.Fn select
OpenPOWER on IntegriCloud