Hyphen/dash fixes

This commit is contained in:
Michael Kerrisk 2005-07-06 06:54:27 +00:00
parent bed66765fa
commit e9496f74fa
22 changed files with 41 additions and 40 deletions

View File

@ -59,7 +59,7 @@ The
.I addr .I addr
parameter of parameter of
.B free_hugepages() .B free_hugepages()
tells which page is being freed - it was the return value of a tells which page is being freed: it was the return value of a
call to call to
.BR alloc_hugepages() . .BR alloc_hugepages() .
(The memory is first actually freed when all users have released it.) (The memory is first actually freed when all users have released it.)
@ -103,7 +103,7 @@ is set appropriately.
.B ENOSYS .B ENOSYS
The system call is not supported on this kernel. The system call is not supported on this kernel.
.SH "CONFORMING TO" .SH "CONFORMING TO"
These calls existed only in Linux 2.5.36 - 2.5.54. These calls existed only in Linux 2.5.36 through to 2.5.54.
These calls are specific to Linux on Intel processors, and should not be These calls are specific to Linux on Intel processors, and should not be
used in programs intended to be portable. Indeed, the system call numbers used in programs intended to be portable. Indeed, the system call numbers
are marked for reuse, so programs using these may do something random are marked for reuse, so programs using these may do something random

View File

@ -108,7 +108,7 @@ The prototype for
is only available if is only available if
.B _BSD_SOURCE .B _BSD_SOURCE
is defined (either explicitly, or implicitly, by not defining is defined (either explicitly, or implicitly, by not defining
_POSIX_SOURCE or compiling with the -ansi flag). _POSIX_SOURCE or compiling with the \-ansi flag).
.SH "CONFORMING TO" .SH "CONFORMING TO"
The The
.B chdir .B chdir

View File

@ -158,7 +158,7 @@ The prototype for
is only available if is only available if
.B _BSD_SOURCE .B _BSD_SOURCE
is defined (either explicitly, or implicitly, by not defining is defined (either explicitly, or implicitly, by not defining
_POSIX_SOURCE or compiling with the -ansi flag). _POSIX_SOURCE or compiling with the \-ansi flag).
.SH "CONFORMING TO" .SH "CONFORMING TO"
The The
.B chown .B chown

View File

@ -195,7 +195,7 @@ read the sources of the futex userspace library referenced below.
Initial futex support was merged in Linux 2.5.7 but with different semantics Initial futex support was merged in Linux 2.5.7 but with different semantics
from what was described above. A 4-parameter system call with the semantics from what was described above. A 4-parameter system call with the semantics
given here was introduced in Linux 2.5.40. In Linux 2.5.70 one parameter given here was introduced in Linux 2.5.40. In Linux 2.5.70 one parameter
was added. In Linux 2.6.7 a sixth parameter was added - messy, especially was added. In Linux 2.6.7 a sixth parameter was added \- messy, especially
on the s390 architecture. on the s390 architecture.
.SH "SEE ALSO" .SH "SEE ALSO"
.PP .PP

View File

@ -110,7 +110,7 @@ variable won't do since registers are restored.
.LP .LP
When a signal occurs, the current user context is saved and When a signal occurs, the current user context is saved and
a new context is created by the kernel for the signal handler. a new context is created by the kernel for the signal handler.
Do not leave the handler using \fIlongjmp()\fP - it is undefined Do not leave the handler using \fIlongjmp()\fP: it is undefined
what would happen with contexts. Use \fIsiglongjmp()\fP or what would happen with contexts. Use \fIsiglongjmp()\fP or
\fIsetcontext()\fP instead. \fIsetcontext()\fP instead.
.SH "CONFORMING TO" .SH "CONFORMING TO"

View File

@ -115,7 +115,7 @@ The prototype for
is only available if is only available if
.B _BSD_SOURCE .B _BSD_SOURCE
is defined (either explicitly, or implicitly, by not defining is defined (either explicitly, or implicitly, by not defining
_POSIX_SOURCE or compiling with the -ansi flag). _POSIX_SOURCE or compiling with the \-ansi flag).
.SH "CONFORMING TO" .SH "CONFORMING TO"
SVr4, SVID (issue 4 only; these calls were not present in SVr3), SVr4, SVID (issue 4 only; these calls were not present in SVr3),
X/OPEN, 4.3BSD. The X/OPEN, 4.3BSD. The

View File

@ -152,7 +152,7 @@ the effective user ID of the caller to match
the real or effective user ID of the process \fIwho\fP. the real or effective user ID of the process \fIwho\fP.
.LP .LP
The actual priority range varies between kernel versions. The actual priority range varies between kernel versions.
Linux before 1.3.36 had -infinity..15. Linux since 1.3.43 has \-20..19, Linux before 1.3.36 had \-infinity..15. Linux since 1.3.43 has \-20..19,
and the system call getpriority returns 40..1 for these values and the system call getpriority returns 40..1 for these values
(since negative numbers are error codes). (since negative numbers are error codes).
The library call converts N into 20-N. The library call converts N into 20-N.

View File

@ -85,9 +85,9 @@ int tz_dsttime; /* type of dst correction */
}; };
.fi .fi
.PP .PP
The use of the timezone struct is obsolete; the The use of the timezone struct is obsolete: the
.I tz_dsttime .I tz_dsttime
field has never been used under Linux - it has not field has never been used under Linux; it has not
been and will not be supported by libc or glibc. been and will not be supported by libc or glibc.
Each and every occurrence of this field in the kernel source Each and every occurrence of this field in the kernel source
(other than the declaration) is a bug. Thus, the following (other than the declaration) is a bug. Thus, the following
@ -97,7 +97,7 @@ The field
.I tz_dsttime .I tz_dsttime
contains a symbolic constant (values are given below) contains a symbolic constant (values are given below)
that indicates in which part of the year Daylight Saving Time that indicates in which part of the year Daylight Saving Time
is in force. (Note: its value is constant throughout the year - is in force. (Note: its value is constant throughout the year:
it does not indicate that DST is in force, it just selects an it does not indicate that DST is in force, it just selects an
algorithm.) algorithm.)
The daylight saving time algorithms defined are as follows : The daylight saving time algorithms defined are as follows :
@ -213,7 +213,7 @@ and the defines for
are (since glibc2.2.2) only available if are (since glibc2.2.2) only available if
.B _BSD_SOURCE .B _BSD_SOURCE
is defined (either explicitly, or implicitly, by not defining is defined (either explicitly, or implicitly, by not defining
_POSIX_SOURCE or compiling with the -ansi flag). _POSIX_SOURCE or compiling with the \-ansi flag).
.LP .LP
Traditionally, the fields of struct timeval were longs. Traditionally, the fields of struct timeval were longs.
.SH "CONFORMING TO" .SH "CONFORMING TO"

View File

@ -70,10 +70,10 @@ serial number.
The macros describing this structure live in <asm/ioctl.h> The macros describing this structure live in <asm/ioctl.h>
and are _IO(type,nr) and {_IOR,_IOW,_IOWR}(type,nr,size). and are _IO(type,nr) and {_IOR,_IOW,_IOWR}(type,nr,size).
They use sizeof(size) so that size is a They use sizeof(size) so that size is a
misnomer here - this third parameter is a data type. misnomer here: this third parameter is a data type.
.LP .LP
Note that the size bits are very unreliable - in lots of cases Note that the size bits are very unreliable: in lots of cases
they are wrong - either because of buggy macros using they are wrong, either because of buggy macros using
sizeof(sizeof(struct)), or because of legacy values. sizeof(sizeof(struct)), or because of legacy values.
.LP .LP
Thus, it seems that the new structure only gave disadvantages: Thus, it seems that the new structure only gave disadvantages:

View File

@ -110,7 +110,7 @@ to release locked or shared pages (with MADV_DONTNEED).
maximum resident set size. maximum resident set size.
.TP .TP
.B ENOMEM .B ENOMEM
(for MADV_WILLNEED) Not enough memory - paging in failed. (for MADV_WILLNEED) Not enough memory: paging in failed.
.TP .TP
.B ENOMEM .B ENOMEM
Addresses in the specified range are not currently Addresses in the specified range are not currently

View File

@ -51,7 +51,7 @@ address. On return, the kernel will have filled
with bytes, of which the least significant bit indicates if a page is with bytes, of which the least significant bit indicates if a page is
core resident. (The other bits are undefined, reserved for possible core resident. (The other bits are undefined, reserved for possible
later use.) later use.)
Of course this is only a snapshot - pages that are not Of course this is only a snapshot: pages that are not
locked in core can come and go any moment, and the contents of locked in core can come and go any moment, and the contents of
.I vec .I vec
may be stale already when this call returns. may be stale already when this call returns.
@ -91,7 +91,7 @@ is not a multiple of the page size.
.B ENOMEM .B ENOMEM
.I len .I len
is greater than is greater than
.RI ( TASK_SIZE " - " start ). .RI ( TASK_SIZE " \- " start ).
(This could occur if a negative value is specified for (This could occur if a negative value is specified for
.IR len , .IR len ,
since that value will be interpreted as a large since that value will be interpreted as a large

View File

@ -322,7 +322,7 @@ Note that
.BR open () .BR open ()
can open device special files, but can open device special files, but
.BR creat () .BR creat ()
cannot create them - use cannot create them; use
.BR mknod (2) .BR mknod (2)
instead. instead.
.LP .LP
@ -387,7 +387,7 @@ The system limit on the total number of open files has been reached.
.B ENODEV .B ENODEV
.I pathname .I pathname
refers to a device special file and no corresponding device exists. refers to a device special file and no corresponding device exists.
(This is a Linux kernel bug - in this situation ENXIO must be returned.) (This is a Linux kernel bug; in this situation ENXIO must be returned.)
.TP .TP
.B ENOENT .B ENOENT
O_CREAT is not set and the named file does not exist. O_CREAT is not set and the named file does not exist.
@ -418,7 +418,7 @@ Or, the file is a device special file and no corresponding device exists.
.TP .TP
.B EOVERFLOW .B EOVERFLOW
.I pathname .I pathname
refers to a regular file, too large to be opened - see O_LARGEFILE above. refers to a regular file, too large to be opened; see O_LARGEFILE above.
.TP .TP
.B EPERM .B EPERM
The The
@ -480,7 +480,7 @@ macro to get its definition.
.SH BUGS .SH BUGS
"The thing that has always disturbed me about O_DIRECT is that the whole "The thing that has always disturbed me about O_DIRECT is that the whole
interface is just stupid, and was probably designed by a deranged monkey interface is just stupid, and was probably designed by a deranged monkey
on some serious mind-controlling substances." -- Linus on some serious mind-controlling substances." \(em Linus
.SH RESTRICTIONS .SH RESTRICTIONS
There are many infelicities in the protocol underlying NFS, affecting There are many infelicities in the protocol underlying NFS, affecting
amongst others amongst others

View File

@ -35,7 +35,7 @@ of the file hierarchy. A process may get a different root directory
by use of the by use of the
.BR chroot (2) .BR chroot (2)
system call. A process may get an entirely private namespace in case system call. A process may get an entirely private namespace in case
it - or one of its ancestors - was started by an invocation of the it \(em or one of its ancestors \(em was started by an invocation of the
.BR clone (2) .BR clone (2)
system call that had the CLONE_NEWNS flag set.) system call that had the CLONE_NEWNS flag set.)
This handles the '/' part of the pathname. This handles the '/' part of the pathname.
@ -121,7 +121,7 @@ outside of the filesystem hierarchy on "dev".
.SS "Trailing slashes" .SS "Trailing slashes"
If a pathname ends in a '/', that forces resolution of the preceding If a pathname ends in a '/', that forces resolution of the preceding
component as in Step 2 - it has to exist and resolve to a directory. component as in Step 2: it has to exist and resolve to a directory.
Otherwise a trailing '/' is ignored. Otherwise a trailing '/' is ignored.
(Or, equivalently, a pathname with a trailing '/' is equivalent to (Or, equivalently, a pathname with a trailing '/' is equivalent to
the pathname obtained by appending '.' to it.) the pathname obtained by appending '.' to it.)

View File

@ -46,7 +46,7 @@ are unaffected.
If If
.I newpath .I newpath
already exists it will be atomically replaced (subject to already exists it will be atomically replaced (subject to
a few conditions - see ERRORS below), so that there is a few conditions; see ERRORS below), so that there is
no point at which another process attempting to access no point at which another process attempting to access
.I newpath .I newpath
will find it missing. will find it missing.
@ -105,7 +105,7 @@ it was open for reading) or is in use by the system
(for example as mount point), while the system considers (for example as mount point), while the system considers
this an error. this an error.
(Note that there is no requirement to return EBUSY in such (Note that there is no requirement to return EBUSY in such
cases - there is nothing wrong with doing the rename anyway - cases \(em there is nothing wrong with doing the rename anyway \(em
but it is allowed to return EBUSY if the system cannot otherwise but it is allowed to return EBUSY if the system cannot otherwise
handle such situations.) handle such situations.)
.TP .TP

View File

@ -108,7 +108,7 @@ Three independent sets of descriptors are watched. Those listed in
.I readfds .I readfds
will be watched to see if characters become will be watched to see if characters become
available for reading (more precisely, to see if a read will not available for reading (more precisely, to see if a read will not
block - in particular, a file descriptor is also ready on end-of-file), block; in particular, a file descriptor is also ready on end-of-file),
those in those in
.I writefds .I writefds
will be watched to see if a write will not block, and will be watched to see if a write will not block, and

View File

@ -92,7 +92,7 @@ struct sigaction {
.fi .fi
.RE .RE
.PP .PP
On some architectures a union is involved - do not assign to both On some architectures a union is involved: do not assign to both
.I sa_handler .I sa_handler
and and
.IR sa_sigaction . .IR sa_sigaction .

View File

@ -21,7 +21,7 @@
.\" aeb, various minor fixes .\" aeb, various minor fixes
.TH SIGALTSTACK 2 2001-09-27 "Linux 2.4" "Linux Programmer's Manual" .TH SIGALTSTACK 2 2001-09-27 "Linux 2.4" "Linux Programmer's Manual"
.SH NAME .SH NAME
sigaltstack - set and/or get signal stack context sigaltstack \- set and/or get signal stack context
.SH SYNOPSIS .SH SYNOPSIS
.B #include <signal.h> .B #include <signal.h>
.sp .sp

View File

@ -121,10 +121,11 @@ only executes the `clear ring buffer' command.
.br .br
The kernel routine \fIprintk\fP() will only print a message on the The kernel routine \fIprintk\fP() will only print a message on the
console, if it has a loglevel less than the value of the variable console, if it has a loglevel less than the value of the variable
.I console_loglevel .IR console_loglevel .
(initially DEFAULT_CONSOLE_LOGLEVEL (7), but set to 10 if the This variable initially has the value DEFAULT_CONSOLE_LOGLEVEL (7),
but is set to 10 if the
kernel command line contains the word `debug', and to 15 in case kernel command line contains the word `debug', and to 15 in case
of a kernel fault - the 10 and 15 are just silly, and equivalent to 8). of a kernel fault (the 10 and 15 are just silly, and equivalent to 8).
This variable is set (to a value in the range 1-8) by the call This variable is set (to a value in the range 1-8) by the call
.B syslog .B syslog
.RI (8, dummy , value ). .RI (8, dummy , value ).
@ -135,7 +136,7 @@ with \fItype\fP equal to 6 or 7, set it to 1 (kernel panics only)
or 7 (all except debugging messages), respectively. or 7 (all except debugging messages), respectively.
Every text line in a message has its own loglevel. This level is Every text line in a message has its own loglevel. This level is
DEFAULT_MESSAGE_LOGLEVEL - 1 (6) unless the line starts with <d> DEFAULT_MESSAGE_LOGLEVEL \- 1 (6) unless the line starts with <d>
where \fId\fP is a digit in the range 1-7, in which case the level where \fId\fP is a digit in the range 1-7, in which case the level
is \fId\fP. The conventional meaning of the loglevel is defined in is \fId\fP. The conventional meaning of the loglevel is defined in
.I <linux/kernel.h> .I <linux/kernel.h>
@ -166,7 +167,7 @@ An attempt was made to change console_loglevel or clear the kernel
message ring buffer by a process without root permissions. message ring buffer by a process without root permissions.
.TP .TP
.B ERESTARTSYS .B ERESTARTSYS
System call was interrupted by a signal - nothing was read. System call was interrupted by a signal; nothing was read.
(This can be seen only during a trace.) (This can be seen only during a trace.)
.SH "CONFORMING TO" .SH "CONFORMING TO"
This system call is Linux specific and should not be used in programs This system call is Linux specific and should not be used in programs

View File

@ -102,7 +102,7 @@ All times reported are in clock ticks.
returns the number of clock ticks that have elapsed since returns the number of clock ticks that have elapsed since
an arbitrary point in the past. an arbitrary point in the past.
For Linux 2.4 and earlier this point is the moment the system was booted. For Linux 2.4 and earlier this point is the moment the system was booted.
Since Linux 2.6, this point is \fI(2^32/HZ) - 300\fP Since Linux 2.6, this point is \fI(2^32/HZ) \- 300\fP
(i.e., about 429 million) seconds before system boot time. (i.e., about 429 million) seconds before system boot time.
The return value may overflow the possible range of type The return value may overflow the possible range of type
.I clock_t. .I clock_t.

View File

@ -101,7 +101,7 @@ and the \fIdomainname\fP field.
The length of the fields in the struct varies. Some operating systems The length of the fields in the struct varies. Some operating systems
or libraries use a hardcoded 9 or 33 or 65 or 257. Other systems use or libraries use a hardcoded 9 or 33 or 65 or 257. Other systems use
SYS_NMLN or _SYS_NMLN or UTSLEN or _UTSNAME_LENGTH. Clearly, it is a bad SYS_NMLN or _SYS_NMLN or UTSLEN or _UTSNAME_LENGTH. Clearly, it is a bad
idea to use any of these constants - just use sizeof(...). idea to use any of these constants; just use sizeof(...).
Often 257 is chosen in order to have room for an internet hostname. Often 257 is chosen in order to have room for an internet hostname.
.LP .LP
There have been three Linux system calls \fIuname\fP(). The first one There have been three Linux system calls \fIuname\fP(). The first one

View File

@ -53,7 +53,7 @@ family of functions.
.SH ERRORS .SH ERRORS
.TP .TP
.B EAGAIN .B EAGAIN
Too many processes - try again. Too many processes; try again.
.TP .TP
.B ENOMEM .B ENOMEM
There is insufficient swap space for the new process. There is insufficient swap space for the new process.
@ -111,7 +111,7 @@ or an exit occurred. The parent process was suspended while the
child was using its resources. child was using its resources.
The use of The use of
.BR vfork () .BR vfork ()
was tricky - for example, not modifying data was tricky: for example, not modifying data
in the parent process depended on knowing which variables are in the parent process depended on knowing which variables are
held in a register. held in a register.
.SH BUGS .SH BUGS

View File

@ -1,7 +1,7 @@
.\" Hey Emacs! This file is -*- nroff -*- source. .\" Hey Emacs! This file is -*- nroff -*- source.
.\" .\"
.\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) .\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
.\" (c) 2004 bu Michael Kerrisk (mtk-manpages@gmx.net) .\" (c) 2004 by Michael Kerrisk (mtk-manpages@gmx.net)
.\" .\"
.\" Permission is granted to make and distribute verbatim copies of this .\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are .\" manual provided the copyright notice and this permission notice are
@ -130,7 +130,7 @@ defined in
The prototype for these functions is only available if The prototype for these functions is only available if
.B _BSD_SOURCE .B _BSD_SOURCE
is defined (either explicitly, or implicitly, by not defining is defined (either explicitly, or implicitly, by not defining
_POSIX_SOURCE or compiling with the -ansi flag). _POSIX_SOURCE or compiling with the \-ansi flag).
.SH "CONFORMING TO" .SH "CONFORMING TO"
4.3BSD 4.3BSD
.SH "SEE ALSO" .SH "SEE ALSO"