bin tel
.BI "% " "ls \-l"
total 2
-drwxrwxr-x 2 aeb 1024 Aug 6 23:51 bin
--rw-rw-r-- 1 aeb 37 Aug 6 23:52 tel
+drwxrwxr\-x 2 aeb 1024 Aug 6 23:51 bin
+\-rw\-rw\-r\-\- 1 aeb 37 Aug 6 23:52 tel
.BI "% " "cat tel"
-maja 0501-1136285
-peter 0136-7399214
+maja 0501\-1136285
+peter 0136\-7399214
.BI "% " "cp tel tel2"
.BI "% " "ls \-l"
total 3
-drwxr-xr-x 2 aeb 1024 Aug 6 23:51 bin
--rw-r--r-- 1 aeb 37 Aug 6 23:52 tel
--rw-r--r-- 1 aeb 37 Aug 6 23:53 tel2
+drwxr\-xr\-x 2 aeb 1024 Aug 6 23:51 bin
+\-rw\-r\-\-r\-\- 1 aeb 37 Aug 6 23:52 tel
+\-rw\-r\-\-r\-\- 1 aeb 37 Aug 6 23:53 tel2
.BI "% " "mv tel tel1"
.BI "% " "ls \-l"
total 3
-drwxr-xr-x 2 aeb 1024 Aug 6 23:51 bin
--rw-r--r-- 1 aeb 37 Aug 6 23:52 tel1
--rw-r--r-- 1 aeb 37 Aug 6 23:53 tel2
+drwxr\-xr\-x 2 aeb 1024 Aug 6 23:51 bin
+\-rw\-r\-\-r\-\- 1 aeb 37 Aug 6 23:52 tel1
+\-rw\-r\-\-r\-\- 1 aeb 37 Aug 6 23:53 tel2
.BI "% " "diff tel1 tel2"
.BI "% " "rm tel1"
.BI "% " "grep maja tel2"
-maja 0501-1136285
+maja 0501\-1136285
.B "% "
.fi
.RE
.BR get_thread_area ()
returns an entry in the current thread's Thread Local Storage (TLS) array.
The index of the entry corresponds to the value
-of \fIu_info->entry_number\fP, passed in by the user.
+of \fIu_info\->entry_number\fP, passed in by the user.
If the value is in bounds,
.BR get_thread_area ()
copies the corresponding
\fIu_info\fP is an invalid pointer.
.TP
.B EINVAL
-\fIu_info->entry_number\fP is out of bounds.
+\fIu_info\->entry_number\fP is out of bounds.
.SH VERSIONS
A version of
.BR get_thread_area ()
is not valid;
or, for
.BR setrlimit ():
-.I rlim->rlim_cur
+.I rlim\->rlim_cur
was greater than
-.IR rlim->rlim_max .
+.IR rlim\->rlim_max .
.TP
.B EPERM
An unprivileged process tried to use
for
.BR setrlimit ()
when
-.I rlim->rlim_cur
+.I rlim\->rlim_cur
was greater than
-.IR rlim->rlim_max .
+.IR rlim\->rlim_max .
.SH "SEE ALSO"
.BR dup (2),
.BR fcntl (2),
Some
.I image
slot is filled in incorrectly,
-.I image->name
+.I image\->name
does not correspond to the original module name, some
-.I image->deps
+.I image\->deps
entry does not correspond to a loaded module,
or some other similar inconsistency.
.TP
.BR sched_setparam ()
checks the validity of \fIparam\fP for the scheduling policy of the
process.
-The parameter \fIparam->sched_priority\fP must lie within the
+The parameter \fIparam\->sched_priority\fP must lie within the
range given by
.BR sched_get_priority_min (2)
and
The TLS array entry set by
.BR set_thread_area ()
corresponds to the value of
-.I u_info->entry_number
+.I u_info\->entry_number
passed in by the user.
If this value is in bounds,
.BR set_thread_area ()
If
.BR set_thread_area ()
finds a free TLS entry, the value of
-.I u_info->entry_number
+.I u_info\->entry_number
is set upon return to show which entry was changed.
.SH "RETURN VALUE"
.BR set_thread_area ()
.SH "ERRORS"
.TP
.B EINVAL
-\fIu_info->entry_number\fP is out of bounds.
+\fIu_info\->entry_number\fP is out of bounds.
.TP
.B EFAULT
\fIu_info\fP is an invalid pointer.
S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH
.fi
-(because 0666 & ~022 = 0644; i.e., rw-r--r--).
+(because 0666 & ~022 = 0644; i.e., rw\-r\-\-r\-\-).
.SH "RETURN VALUE"
This system call always succeeds and the previous value of the mask
is returned.
.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
.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.
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.
.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).
.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
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.
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);
}
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
Before calling
.BR setkey_r ()
set
-.I data->initialized
+.I data\->initialized
to zero.
.SH "RETURN VALUE"
These functions do not return any value.
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
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
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),
.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.
.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
.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
.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
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.
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
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)
.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
is invalid.
.TP
.B EINVAL
-.I newattr->mq_flags
+.I newattr\->mq_flags
contained set bits other than
.BR O_NONBLOCK .
.SH CONFORMING 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
.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.
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
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.
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);
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);
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.
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
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 ()
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 ()
the internal status of the socket.
The "tx_queue" and "rx_queue" are the
outgoing and incoming data queue in terms of kernel memory usage.
-The "tr", "tm->when", and "rexmits" fields are not used by RAW.
+The "tr", "tm\->when", and "rexmits" fields are not used by RAW.
The "uid"
field holds the effective UID of the creator of the socket.
.\" .TP
(if connected). 'St' is the internal status of the socket.
The 'tx_queue' and 'rx_queue' are the
outgoing and incoming data queue in terms of kernel memory usage.
-The "tr", "tm->when", and "rexmits" fields hold internal information of
+The "tr", "tm\->when", and "rexmits" fields hold internal information of
the kernel socket state and are only useful for debugging.
The "uid"
field holds the effective UID of the creator of the socket.
(if connected). "St" is the internal status of the socket.
The "tx_queue" and "rx_queue" are the outgoing and incoming data queue
in terms of kernel memory usage.
-The "tr", "tm->when", and "rexmits" fields
+The "tr", "tm\->when", and "rexmits" fields
are not used by UDP.
The "uid"
field holds the effective UID of the creator of the socket.
.nf
.ft CW
.in 1n
-sl local_address rem_address st tx_queue rx_queue tr rexmits tm->when uid
+sl local_address rem_address st tx_queue rx_queue tr rexmits tm\->when uid
1: 01642C89:0201 0C642C89:03FF 01 00000000:00000001 01:000071BA 00000000 0
1: 00000000:0801 00000000:0000 0A 00000000:00000000 00:00000000 6F000100 0
1: 00000000:0201 00000000:0000 0A 00000000:00000000 00:00000000 00000000 0
reserve=0x300,32 blah=0x300
.IP
keeps all device drivers except the driver for 'blah' from probing
-0x300-0x31f.
+0x300\-0x31f.
.TP
.B "'mem=...'"
The BIOS call defined in the PC specification that returns
This file can be used to view and change the ceiling value for the
maximum number of messages in a queue.
This value acts as a ceiling on the
-.I attr->mq_maxmsg
+.I attr\->mq_maxmsg
argument given to
.BR mq_open (3).
The default and minimum value for
This file can be used to view and change the ceiling on the
maximum message size.
This value acts as a ceiling on the
-.I attr->mq_msgsize
+.I attr\->mq_msgsize
argument given to
.BR mq_open (3).
The default and minimum value for
for (nh = (struct nlmsghdr *) buf; NLMSG_OK (nh, len);
nh = NLMSG_NEXT (nh, len)) {
/* The end of multipart message. */
- if (nh->nlmsg_type == NLMSG_DONE)
+ if (nh\->nlmsg_type == NLMSG_DONE)
return;
- if (nh->nlmsg_type == NLMSG_ERROR)
+ if (nh\->nlmsg_type == NLMSG_ERROR)
/* Do some error handling. */
...
.nf
.B "Operator Associativity"
-() [] -> . left to right
-! ~ ++ -- + - (type) * & sizeof right to left
+() [] \-> . left to right
+! ~ ++ \-\- + \- (type) * & sizeof right to left
* / % left to right
-+ - left to right
++ \- left to right
<< >> left to right
< <= > >= left to right
== != left to right
&& left to right
|| left to right
?: right to left
-= += -= *= /= %= <<= >>= &= ^= |= right to left
+= += \-= *= /= %= <<= >>= &= ^= |= right to left
, left to right
.fi
.\"