aboutsummaryrefslogtreecommitdiffstats
path: root/man3
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2007-12-22 16:40:46 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2007-12-22 16:40:46 +0000
commit94e9d9febdb3c68f94bcff26002311fa464837df (patch)
tree3a855c552ff4049052ef3cf9dc7c2f68cee7e03e /man3
parent009df872f730972ec53a70652959c7b47c7ece8b (diff)
downloadman-pages-94e9d9febdb3c68f94bcff26002311fa464837df.tar.gz
Replace "-" by "\-" where a real dash is required.
Diffstat (limited to 'man3')
-rw-r--r--man3/aio_fsync.32
-rw-r--r--man3/aio_read.312
-rw-r--r--man3/aio_write.312
-rw-r--r--man3/bsearch.32
-rw-r--r--man3/dl_iterate_phdr.32
-rw-r--r--man3/encrypt.32
-rw-r--r--man3/getaddrinfo.34
-rw-r--r--man3/getpwnam.34
-rw-r--r--man3/getutent.310
-rw-r--r--man3/glob.320
-rw-r--r--man3/login.36
-rw-r--r--man3/makecontext.36
-rw-r--r--man3/mq_getattr.32
-rw-r--r--man3/mq_notify.314
-rw-r--r--man3/mq_open.310
-rw-r--r--man3/queue.312
-rw-r--r--man3/rtime.32
-rw-r--r--man3/termios.310
-rw-r--r--man3/timeradd.34
19 files changed, 68 insertions, 68 deletions
diff --git a/man3/aio_fsync.3 b/man3/aio_fsync.3
index 04cd4c185d..63182d5ebe 100644
--- a/man3/aio_fsync.3
+++ b/man3/aio_fsync.3
@@ -33,7 +33,7 @@ The
.BR aio_fsync ()
function does a sync on all outstanding asynchronous I/O operations
associated with
-.IR aiocbp->aio_fildes .
+.IR aiocbp\->aio_fildes .
.LP
More precisely, if
.I op
diff --git a/man3/aio_read.3 b/man3/aio_read.3
index b773f5aae2..543fa7611d 100644
--- a/man3/aio_read.3
+++ b/man3/aio_read.3
@@ -33,15 +33,15 @@ The
.BR aio_read ()
function requests an asynchronous "n = read(fd, buf, count)"
with fd, buf, count given by
-.IR aiocbp->aio_fildes ,
-.IR aiocbp->aio_buf ,
-.IR aiocbp->aio_nbytes ,
+.IR aiocbp\->aio_fildes ,
+.IR aiocbp\->aio_buf ,
+.IR aiocbp\->aio_nbytes ,
respectively.
The return status n can be retrieved upon completion using
.BR aio_return (3).
.LP
The data is read starting at the absolute file offset
-.IR aiocbp->aio_offset ,
+.IR aiocbp\->aio_offset ,
regardless of the current file position.
After this request,
the value of the current file position is unspecified.
@@ -57,10 +57,10 @@ If
is defined, and this file supports it,
then the asynchronous operation is submitted at a priority equal
to that of the calling process minus
-.IR aiocbp->aio_reqprio .
+.IR aiocbp\->aio_reqprio .
.LP
The field
-.I aiocbp->aio_lio_opcode
+.I aiocbp\->aio_lio_opcode
is ignored.
.LP
No data is read from a regular file beyond its maximum offset.
diff --git a/man3/aio_write.3 b/man3/aio_write.3
index 4a4a0a0bd5..569e14ffdd 100644
--- a/man3/aio_write.3
+++ b/man3/aio_write.3
@@ -33,9 +33,9 @@ The
.BR aio_write ()
function requests an asynchronous "n = write(fd, buf, count)"
with fd, buf, count given by
-.IR aiocbp->aio_fildes ,
-.IR aiocbp->aio_buf ,
-.IR aiocbp->aio_nbytes ,
+.IR aiocbp\->aio_fildes ,
+.IR aiocbp\->aio_buf ,
+.IR aiocbp\->aio_nbytes ,
respectively.
The return status n can be retrieved upon completion using
.BR aio_return (3).
@@ -44,7 +44,7 @@ If
.B O_APPEND
is not set, the data is written starting at the
absolute file offset
-.IR aiocbp->aio_offset ,
+.IR aiocbp\->aio_offset ,
regardless of the current file position.
If
.B O_APPEND
@@ -62,10 +62,10 @@ If
is defined, and this file supports it,
then the asynchronous operation is submitted at a priority equal
to that of the calling process minus
-.IR aiocbp->aio_reqprio .
+.IR aiocbp\->aio_reqprio .
.LP
The field
-.I aiocbp->aio_lio_opcode
+.I aiocbp\->aio_lio_opcode
is ignored.
.LP
No data is written to a regular file beyond its maximum offset.
diff --git a/man3/bsearch.3 b/man3/bsearch.3
index e78c63c27f..e8f3f80f08 100644
--- a/man3/bsearch.3
+++ b/man3/bsearch.3
@@ -107,7 +107,7 @@ main(int argc, char **argv)
if (res == NULL)
printf("'%s': unknown month\en", argv[i]);
else
- printf("%s: month #%d\en", res->name, res->nr);
+ printf("%s: month #%d\en", res\->name, res\->nr);
}
exit(EXIT_SUCCESS);
}
diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3
index 01ed784c44..36977c73a6 100644
--- a/man3/dl_iterate_phdr.3
+++ b/man3/dl_iterate_phdr.3
@@ -141,7 +141,7 @@ Note that we can calculate the location of a particular program header,
in virtual memory using the formula:
.nf
- addr == info->dlpi_addr + info->dlpi_phdr[x].p_vaddr;
+ addr == info\->dlpi_addr + info\->dlpi_phdr[x].p_vaddr;
.fi
.SH RETURN VALUE
The
diff --git a/man3/encrypt.3 b/man3/encrypt.3
index 26f7a0762f..79b015cbae 100644
--- a/man3/encrypt.3
+++ b/man3/encrypt.3
@@ -100,7 +100,7 @@ struct crypt_data {
Before calling
.BR setkey_r ()
set
-.I data->initialized
+.I data\->initialized
to zero.
.SH "RETURN VALUE"
These functions do not return any value.
diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3
index 3d9cd97773..5cf50695c0 100644
--- a/man3/getaddrinfo.3
+++ b/man3/getaddrinfo.3
@@ -333,7 +333,7 @@ The return value is an exact copy of the value returned by the name
resolution function.
If the name is encoded using ACE, then it will contain the
-.I xn--
+.I xn\-\-
prefix for one or more components of the name.
To convert these components into a readable form the
.B AI_CANONIDN
@@ -342,7 +342,7 @@ flag can be passed in addition to
The resulting string is encoded using the current locale's encoding.
.\"
.\"Implementation Detail:
-.\"If no component of the returned name starts with xn-- the IDN
+.\"If no component of the returned name starts with xn\-\- the IDN
.\"step can be skipped, therefore avoiding unnecessary slowdowns.
.TP
.BR AI_IDN_ALLOW_UNASSIGNED ", " AI_IDN_USE_STD3_ASCII_RULES
diff --git a/man3/getpwnam.3 b/man3/getpwnam.3
index d2e0cf1e70..c5d2b0ec46 100644
--- a/man3/getpwnam.3
+++ b/man3/getpwnam.3
@@ -218,12 +218,12 @@ An application that wants to determine its user's home directory
should inspect the value of
.B HOME
(rather than the value
-.IR getpwuid(getuid())->pw_dir )
+.IR getpwuid(getuid())\->pw_dir )
since this allows the user to modify their notion of
"the home directory" during a login session.
To determine the (initial) home directory of another user,
it is necessary to use
-.I getpwnam("username")->pw_dir
+.I getpwnam("username")\->pw_dir
or similar.
.SH "SEE ALSO"
.BR endpwent (3),
diff --git a/man3/getutent.3 b/man3/getutent.3
index 4938c29ab6..c63fc5e16d 100644
--- a/man3/getutent.3
+++ b/man3/getutent.3
@@ -74,23 +74,23 @@ the line.
.BR getutid ()
searches forward from the current file position in the utmp
file based upon \fIut\fP.
-If \fIut\fP->ut_type is one of \fBRUN_LVL\fP,
+If \fIut\fP\->ut_type is one of \fBRUN_LVL\fP,
\fBBOOT_TIME\fP, \fBNEW_TIME\fP, or \fBOLD_TIME\fP,
.BR getutid ()
will
-find the first entry whose \fIut_type\fP field matches \fIut\fP->ut_type.
-If \fIut\fP->ut_type is one of \fBINIT_PROCESS\fP, \fBLOGIN_PROCESS\fP,
+find the first entry whose \fIut_type\fP field matches \fIut\fP\->ut_type.
+If \fIut\fP\->ut_type is one of \fBINIT_PROCESS\fP, \fBLOGIN_PROCESS\fP,
\fBUSER_PROCESS\fP, or \fBDEAD_PROCESS\fP,
.BR getutid ()
will find the
-first entry whose ut_id field matches \fIut\fP->ut_id.
+first entry whose ut_id field matches \fIut\fP\->ut_id.
.PP
.BR getutline ()
searches forward from the current file position in the
utmp file.
It scans entries whose ut_type is \fBUSER_PROCESS\fP
or \fBLOGIN_PROCESS\fP and returns the first one whose ut_line field
-matches \fIut\fP->ut_line.
+matches \fIut\fP\->ut_line.
.PP
.BR pututline ()
writes the utmp structure \fIut\fP into the utmp file.
diff --git a/man3/glob.3 b/man3/glob.3
index 9e9ace3b94..9801f520dc 100644
--- a/man3/glob.3
+++ b/man3/glob.3
@@ -109,9 +109,9 @@ By default, the returned pathnames are sorted.
.TP
.B GLOB_DOOFFS
Reserve
-.I pglob->gl_offs
+.I pglob\->gl_offs
slots at the beginning of the list of strings in
-.IR pglob->pathv .
+.IR pglob\->pathv .
The reserved slots contain NULL pointers.
.TP
.B GLOB_NOCHECK
@@ -146,11 +146,11 @@ By default, metacharacters can't match a leading period.
.TP
.B GLOB_ALTDIRFUNC
Use alternative functions
-.IR pglob->gl_closedir ,
-.IR pglob->gl_readdir ,
-.IR pglob->gl_opendir ,
-.IR pglob->gl_lstat ", and"
-.I pglob->gl_stat
+.IR pglob\->gl_closedir ,
+.IR pglob\->gl_readdir ,
+.IR pglob\->gl_opendir ,
+.IR pglob\->gl_lstat ", and"
+.I pglob\->gl_stat
for file system access instead of the normal library
functions.
.TP
@@ -234,9 +234,9 @@ will terminate after the call to
.IR errfunc .
.PP
Upon successful return,
-.I pglob->gl_pathc
+.I pglob\->gl_pathc
contains the number of matched pathnames and
-.I pglob->gl_pathv
+.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.
.PP
@@ -250,7 +250,7 @@ flag has to be set in
on the second and later invocations.
.PP
As a GNU extension,
-.I pglob->gl_flags
+.I pglob\->gl_flags
is set to the flags specified, \fBor\fRed with
.B GLOB_MAGCHAR
if any metacharacters were found.
diff --git a/man3/login.3 b/man3/login.3
index 18aadabf78..e4bba60bd5 100644
--- a/man3/login.3
+++ b/man3/login.3
@@ -53,14 +53,14 @@ More precisely,
takes the argument
.I ut
struct, fills the field
-.I ut->ut_type
+.I ut\->ut_type
(if there is such a field) with the value
.BR USER_PROCESS ,
and fills the field
-.I ut->ut_pid
+.I ut\->ut_pid
(if there is such a field) with the process ID of the calling process.
Then it tries to fill the field
-.IR ut->ut_line .
+.IR ut\->ut_line .
It takes the first of \fIstdin\fP, \fIstdout\fP, \fIstderr\fP
that is a tty, and
stores the corresponding pathname minus a possible leading \fI/dev/\fP
diff --git a/man3/makecontext.3 b/man3/makecontext.3
index 259a893e4f..d9e4a59f35 100644
--- a/man3/makecontext.3
+++ b/man3/makecontext.3
@@ -53,9 +53,9 @@ by \fIucp\fP (which was obtained from a call to
Before invoking
.BR makecontext (),
the caller must allocate a new stack
-for this context and assign its address to \fIucp->uc_stack\fP,
+for this context and assign its address to \fIucp\->uc_stack\fP,
and define a successor context and
-assign its address to \fIucp->uc_link\fP.
+assign its address to \fIucp\->uc_link\fP.
When this context is later activated (using
.BR setcontext (2)
@@ -95,7 +95,7 @@ Insufficient stack space left.
.SH "CONFORMING TO"
SUSv2, POSIX.1-2001.
.SH NOTES
-The interpretation of \fIucp->uc_stack\fP is just as in
+The interpretation of \fIucp\->uc_stack\fP is just as in
.BR sigaltstack (2),
namely, this struct contains the start and length of a memory area
to be used as the stack, regardless of the direction of growth of
diff --git a/man3/mq_getattr.3 b/man3/mq_getattr.3
index 797866c83e..de77b25a6e 100644
--- a/man3/mq_getattr.3
+++ b/man3/mq_getattr.3
@@ -127,7 +127,7 @@ The descriptor specified in
is invalid.
.TP
.B EINVAL
-.I newattr->mq_flags
+.I newattr\->mq_flags
contained set bits other than
.BR O_NONBLOCK .
.SH CONFORMING TO
diff --git a/man3/mq_notify.3 b/man3/mq_notify.3
index 58ab9affc8..9f8480b2cf 100644
--- a/man3/mq_notify.3
+++ b/man3/mq_notify.3
@@ -101,7 +101,7 @@ is set to
is set to the signal number;
.I si_value
is set to the value specified in
-.IR notification->sigev_value ;
+.IR notification\->sigev_value ;
.\" I don't know of other implementations that set
.\" si_pid and si_uid -- MTK
.I si_pid
@@ -113,13 +113,13 @@ The same information is available if the signal is accepted using
.TP
.B SIGEV_THREAD
Deliver notification by invoking
-.I notification->sigev_thread_function
+.I notification\->sigev_thread_function
as the start function of a new thread.
The function is invoked with
-.I notification->sigev_value
+.I notification\->sigev_value
as its sole argument.
If
-.I notification->sigev_notify_attributes
+.I notification\->sigev_notify_attributes
is not NULL, then it should point to a
.I pthread_attr_t
structure that defines attributes for the thread.
@@ -179,13 +179,13 @@ Another process has already registered to receive notification
for this message queue.
.TP
.B EINVAL
-.I notification->sigev_notify
+.I notification\->sigev_notify
is not one of the permitted values; or
-.I notification->sigev_notify
+.I notification\->sigev_notify
is
.B SIGEV_SIGNAL
and
-.I notification->sigev_signo
+.I notification\->sigev_signo
is not a valid signal number.
.TP
.B ENOMEM
diff --git a/man3/mq_open.3 b/man3/mq_open.3
index e6b5681c6d..5f140a43a5 100644
--- a/man3/mq_open.3
+++ b/man3/mq_open.3
@@ -147,24 +147,24 @@ was specified in
and
.I attr
was not NULL, but
-.I attr->mq_maxmsg
+.I attr\->mq_maxmsg
or
-.I attr->mq_msqsize
+.I attr\->mq_msqsize
was invalid.
Both of these fields must be greater than zero.
In a process that is unprivileged (does not have the
.B CAP_SYS_RESOURCE
capability),
-.I attr->mq_maxmsg
+.I attr\->mq_maxmsg
must be less than or equal to the
.I msg_max
limit, and
-.I attr->mq_msgsize
+.I attr\->mq_msgsize
must be less than or equal to the
.I msgsize_max
limit.
In addition, even in a privileged process,
-.I attr->mq_maxmsg
+.I attr\->mq_maxmsg
cannot exceed the
.B HARD_MAX
limit.
diff --git a/man3/queue.3 b/man3/queue.3
index 043c19bd72..84b28ee1a9 100644
--- a/man3/queue.3
+++ b/man3/queue.3
@@ -343,8 +343,8 @@ TAILQ_INSERT_TAIL(&head, n1, entries);
n2 = malloc(sizeof(struct entry)); /* Insert after. */
TAILQ_INSERT_AFTER(&head, n1, n2, entries);
/* Forward traversal. */
-for (np = head.tqh_first; np != NULL; np = np->entries.tqe_next)
- np-> ...
+for (np = head.tqh_first; np != NULL; np = np\->entries.tqe_next)
+ np\-> ...
/* Delete. */
while (head.tqh_first != NULL)
TAILQ_REMOVE(&head, head.tqh_first, entries);
@@ -455,11 +455,11 @@ n2 = malloc(sizeof(struct entry)); /* Insert before. */
CIRCLEQ_INSERT_BEFORE(&head, n1, n2, entries);
/* Forward traversal. */
for (np = head.cqh_first; np != (void *)&head;
- np = np->entries.cqe_next)
- np-> ...
+ np = np\->entries.cqe_next)
+ np\-> ...
/* Reverse traversal. */
-for (np = head.cqh_last; np != (void *)&head; np = np->entries.cqe_prev)
- np-> ...
+for (np = head.cqh_last; np != (void *)&head; np = np\->entries.cqe_prev)
+ np\-> ...
/* Delete. */
while (head.cqh_first != (void *)&head)
CIRCLEQ_REMOVE(&head, head.cqh_first, entries);
diff --git a/man3/rtime.3 b/man3/rtime.3
index 91818523f8..6a37ed6131 100644
--- a/man3/rtime.3
+++ b/man3/rtime.3
@@ -29,7 +29,7 @@ is non-NULL, the udp/time socket (port 37) is used.
Otherwise, the tcp/time socket (port 37) is used.
.SH "RETURN VALUE"
On success, 0 is returned, and the obtained 32-bit time value is stored in
-.IR timep->tv_sec .
+.IR timep\->tv_sec .
In case of error \-1 is returned, and
.I errno
is set appropriately.
diff --git a/man3/termios.3 b/man3/termios.3
index d72bd975f3..db6e7783de 100644
--- a/man3/termios.3
+++ b/man3/termios.3
@@ -761,12 +761,12 @@ terminal input and output characters is disabled.
The terminal attributes are set as follows:
.nf
- termios_p->c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP
+ termios_p\->c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP
| INLCR | IGNCR | ICRNL | IXON);
- termios_p->c_oflag &= ~OPOST;
- termios_p->c_lflag &= ~(ECHO | ECHONL | ICANON | ISIG | IEXTEN);
- termios_p->c_cflag &= ~(CSIZE | PARENB);
- termios_p->c_cflag |= CS8;
+ termios_p\->c_oflag &= ~OPOST;
+ termios_p\->c_lflag &= ~(ECHO | ECHONL | ICANON | ISIG | IEXTEN);
+ termios_p\->c_cflag &= ~(CSIZE | PARENB);
+ termios_p\->c_cflag |= CS8;
.fi
.SS "Line control"
.LP
diff --git a/man3/timeradd.3 b/man3/timeradd.3
index 414e012101..4f02c76535 100644
--- a/man3/timeradd.3
+++ b/man3/timeradd.3
@@ -72,7 +72,7 @@ and places the sum in the
pointed to by
.IR res .
The result is normalized such that
-.I res->tv_usec
+.I res\->tv_usec
has a value in the range 0 to 999,999.
.BR timersub ()
@@ -85,7 +85,7 @@ and places the result in the
pointed to by
.IR res .
The result is normalized such that
-.I res->tv_usec
+.I res\->tv_usec
has a value in the range 0 to 999,999.
.BR timerclear ()