mirror of https://github.com/mkerrisk/man-pages
intro.1, time.1, _syscall.2, accept.2, capget.2, clone.2, execve.2, fcntl.2, intro.2, ioctl_list.2, ioprio_set.2, kill.2, mlock.2, nanosleep.2, perf_event_open.2, select.2, stat.2, times.2, ustat.2, vfork.2, wait.2, cfree.3, dbopen.3, dlopen.3, fenv.3, fmtmsg.3, gamma.3, getaddrinfo.3, gethostbyname.3, getnameinfo.3, getspnam.3, login.3, printf.3, regex.3, stdio.3, sysconf.3, termios.3, ttyslot.3, undocumented.3, wordexp.3, console_codes.4, initrd.4, mouse.4, random.4, st.4, tty_ioctl.4, wavelan.4, charmap.5, dir_colors.5, hosts.5, termcap.5, armscii-8.7, boot.7, bootparam.7, capabilities.7, charsets.7, ddp.7, futex.7, glob.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, man.7, numa.7, path_resolution.7, pipe.7, posixoptions.7, pthreads.7, pty.7, rtnetlink.7, signal.7, time.7, udp.7, udplite.7, unicode.7, uri.7, utf-8.7: G;lobal fix: remove unneeded double quotes in .SS headings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
47297adb6e
commit
73d8cece72
14
man1/intro.1
14
man1/intro.1
|
@ -57,7 +57,7 @@ tell the computer what to do.
|
||||||
That is faster and more powerful,
|
That is faster and more powerful,
|
||||||
but requires finding out what the commands are.
|
but requires finding out what the commands are.
|
||||||
Below a bare minimum, to get started.
|
Below a bare minimum, to get started.
|
||||||
.SS "Login"
|
.SS Login
|
||||||
In order to start working, you probably first have to login,
|
In order to start working, you probably first have to login,
|
||||||
that is, give your username and password.
|
that is, give your username and password.
|
||||||
See also
|
See also
|
||||||
|
@ -71,7 +71,7 @@ In case of a graphical login, you get a screen with menus or icons
|
||||||
and a mouse click will start a shell in a window.
|
and a mouse click will start a shell in a window.
|
||||||
See also
|
See also
|
||||||
.BR xterm (1).
|
.BR xterm (1).
|
||||||
.SS "The shell"
|
.SS The shell
|
||||||
One types commands to the
|
One types commands to the
|
||||||
.IR shell ,
|
.IR shell ,
|
||||||
the command interpreter.
|
the command interpreter.
|
||||||
|
@ -194,7 +194,7 @@ The command
|
||||||
.I grep
|
.I grep
|
||||||
(from "g/re/p") finds occurrences of a string in one or more files.
|
(from "g/re/p") finds occurrences of a string in one or more files.
|
||||||
Here it finds Maja's telephone number.
|
Here it finds Maja's telephone number.
|
||||||
.SS "Pathnames and the current directory"
|
.SS Pathnames and the current directory
|
||||||
Files live in a large tree, the file hierarchy.
|
Files live in a large tree, the file hierarchy.
|
||||||
Each has a
|
Each has a
|
||||||
.I "pathname"
|
.I "pathname"
|
||||||
|
@ -215,7 +215,7 @@ The command
|
||||||
.I cd
|
.I cd
|
||||||
changes the current directory.
|
changes the current directory.
|
||||||
Try "cd /" and "pwd" and "cd" and "pwd".
|
Try "cd /" and "pwd" and "cd" and "pwd".
|
||||||
.SS "Directories"
|
.SS Directories
|
||||||
The command
|
The command
|
||||||
.I mkdir
|
.I mkdir
|
||||||
makes a new directory.
|
makes a new directory.
|
||||||
|
@ -235,7 +235,7 @@ of the tree.
|
||||||
Large searches on a multi-GB disk will be time-consuming,
|
Large searches on a multi-GB disk will be time-consuming,
|
||||||
and it may be better to use
|
and it may be better to use
|
||||||
.BR locate (1).
|
.BR locate (1).
|
||||||
.SS "Disks and filesystems"
|
.SS Disks and filesystems
|
||||||
The command
|
The command
|
||||||
.I mount
|
.I mount
|
||||||
will attach the file system found on some disk (or floppy, or CDROM or so)
|
will attach the file system found on some disk (or floppy, or CDROM or so)
|
||||||
|
@ -246,7 +246,7 @@ detaches it again.
|
||||||
The command
|
The command
|
||||||
.I df
|
.I df
|
||||||
will tell you how much of your disk is still free.
|
will tell you how much of your disk is still free.
|
||||||
.SS "Processes"
|
.SS Processes
|
||||||
On a UNIX system many user and system processes run simultaneously.
|
On a UNIX system many user and system processes run simultaneously.
|
||||||
The one you are talking to runs in the
|
The one you are talking to runs in the
|
||||||
.IR foreground ,
|
.IR foreground ,
|
||||||
|
@ -264,7 +264,7 @@ request: please go away.
|
||||||
And "kill \-9" followed by the number
|
And "kill \-9" followed by the number
|
||||||
of the process is an immediate kill.
|
of the process is an immediate kill.
|
||||||
Foreground processes can often be killed by typing Control-C.
|
Foreground processes can often be killed by typing Control-C.
|
||||||
.SS "Getting information"
|
.SS Getting information
|
||||||
There are thousands of commands, each with many options.
|
There are thousands of commands, each with many options.
|
||||||
Traditionally commands are documented on
|
Traditionally commands are documented on
|
||||||
.IR "man pages" ,
|
.IR "man pages" ,
|
||||||
|
|
|
@ -119,7 +119,7 @@ sys %S
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
is used.
|
is used.
|
||||||
.SS "The format string"
|
.SS The format string
|
||||||
The format is interpreted in the usual printf-like way.
|
The format is interpreted in the usual printf-like way.
|
||||||
Ordinary characters are directly copied, tab, newline
|
Ordinary characters are directly copied, tab, newline
|
||||||
and backslash are escaped using \et, \en and \e\e,
|
and backslash are escaped using \et, \en and \e\e,
|
||||||
|
@ -219,7 +219,7 @@ Number of signals delivered to the process.
|
||||||
.TP
|
.TP
|
||||||
.B %x
|
.B %x
|
||||||
(Not in tcsh.) Exit status of the command.
|
(Not in tcsh.) Exit status of the command.
|
||||||
.SS "GNU options"
|
.SS GNU options
|
||||||
.TP
|
.TP
|
||||||
.BI "\-f " FORMAT ", \-\-format=" FORMAT
|
.BI "\-f " FORMAT ", \-\-format=" FORMAT
|
||||||
Specify output format, possibly overriding the format specified
|
Specify output format, possibly overriding the format specified
|
||||||
|
@ -236,7 +236,7 @@ Do not send the results to \fIstderr\fP, but overwrite the specified file.
|
||||||
.TP
|
.TP
|
||||||
.B "\-v, \-\-verbose"
|
.B "\-v, \-\-verbose"
|
||||||
Give very verbose output about all the program knows about.
|
Give very verbose output about all the program knows about.
|
||||||
.SS "GNU standard options"
|
.SS GNU standard options
|
||||||
.TP
|
.TP
|
||||||
.B "\-\-help"
|
.B "\-\-help"
|
||||||
Print a usage message on standard output and exit successfully.
|
Print a usage message on standard output and exit successfully.
|
||||||
|
|
|
@ -150,7 +150,7 @@ main(void)
|
||||||
exit(EXIT_SUCCESS);
|
exit(EXIT_SUCCESS);
|
||||||
}
|
}
|
||||||
.fi
|
.fi
|
||||||
.SS "Sample output"
|
.SS Sample output
|
||||||
.nf
|
.nf
|
||||||
code error = 0
|
code error = 0
|
||||||
uptime = 502034s
|
uptime = 502034s
|
||||||
|
|
|
@ -182,7 +182,7 @@ for the accepted socket.
|
||||||
On error, \-1 is returned, and
|
On error, \-1 is returned, and
|
||||||
.I errno
|
.I errno
|
||||||
is set appropriately.
|
is set appropriately.
|
||||||
.SS "Error handling"
|
.SS Error handling
|
||||||
Linux
|
Linux
|
||||||
.BR accept ()
|
.BR accept ()
|
||||||
(and
|
(and
|
||||||
|
|
|
@ -48,7 +48,7 @@ use the easier-to-use interfaces
|
||||||
.BR capsetp (3)
|
.BR capsetp (3)
|
||||||
and
|
and
|
||||||
.BR capgetp (3).
|
.BR capgetp (3).
|
||||||
.SS "Current details"
|
.SS Current details
|
||||||
Now that you have been warned, some current kernel details.
|
Now that you have been warned, some current kernel details.
|
||||||
The structures are defined as follows.
|
The structures are defined as follows.
|
||||||
.sp
|
.sp
|
||||||
|
|
|
@ -758,7 +758,7 @@ space of the calling process at the time of
|
||||||
Memory writes or file mappings/unmappings performed by one of the
|
Memory writes or file mappings/unmappings performed by one of the
|
||||||
processes do not affect the other, as with
|
processes do not affect the other, as with
|
||||||
.BR fork (2).
|
.BR fork (2).
|
||||||
.SS "sys_clone"
|
.SS sys_clone
|
||||||
The
|
The
|
||||||
.B sys_clone
|
.B sys_clone
|
||||||
system call corresponds more closely to
|
system call corresponds more closely to
|
||||||
|
|
|
@ -296,7 +296,7 @@ For portable use,
|
||||||
.I optional-arg
|
.I optional-arg
|
||||||
should either be absent, or be specified as a single word (i.e., it
|
should either be absent, or be specified as a single word (i.e., it
|
||||||
should not contain white space); see NOTES below.
|
should not contain white space); see NOTES below.
|
||||||
.SS "Limits on size of arguments and environment"
|
.SS Limits on size of arguments and environment
|
||||||
Most UNIX implementations impose some limit on the total size
|
Most UNIX implementations impose some limit on the total size
|
||||||
of the command-line argument
|
of the command-line argument
|
||||||
.RI ( argv )
|
.RI ( argv )
|
||||||
|
|
16
man2/fcntl.2
16
man2/fcntl.2
|
@ -88,7 +88,7 @@ and we identify the argument using the name
|
||||||
or
|
or
|
||||||
.I void
|
.I void
|
||||||
is specified if the argument is not required.
|
is specified if the argument is not required.
|
||||||
.SS "Duplicating a file descriptor"
|
.SS Duplicating a file descriptor
|
||||||
.TP
|
.TP
|
||||||
.BR F_DUPFD " (\fIint\fP)"
|
.BR F_DUPFD " (\fIint\fP)"
|
||||||
Find the lowest numbered available file descriptor
|
Find the lowest numbered available file descriptor
|
||||||
|
@ -122,7 +122,7 @@ see the description of
|
||||||
.B O_CLOEXEC
|
.B O_CLOEXEC
|
||||||
in
|
in
|
||||||
.BR open (2).
|
.BR open (2).
|
||||||
.SS "File descriptor flags"
|
.SS File descriptor flags
|
||||||
The following commands manipulate the flags associated with
|
The following commands manipulate the flags associated with
|
||||||
a file descriptor.
|
a file descriptor.
|
||||||
Currently, only one such flag is defined:
|
Currently, only one such flag is defined:
|
||||||
|
@ -142,7 +142,7 @@ is ignored.
|
||||||
.BR F_SETFD " (\fIint\fP)"
|
.BR F_SETFD " (\fIint\fP)"
|
||||||
Set the file descriptor flags to the value specified by
|
Set the file descriptor flags to the value specified by
|
||||||
.IR arg .
|
.IR arg .
|
||||||
.SS "File status flags"
|
.SS File status flags
|
||||||
Each open file description has certain associated status flags,
|
Each open file description has certain associated status flags,
|
||||||
initialized by
|
initialized by
|
||||||
.BR open (2)
|
.BR open (2)
|
||||||
|
@ -188,7 +188,7 @@ flags.
|
||||||
.\" FIXME . According to POSIX.1-2001, O_SYNC should also be modifiable
|
.\" FIXME . According to POSIX.1-2001, O_SYNC should also be modifiable
|
||||||
.\" via fcntl(2), but currently Linux does not permit this
|
.\" via fcntl(2), but currently Linux does not permit this
|
||||||
.\" See http://bugzilla.kernel.org/show_bug.cgi?id=5994
|
.\" See http://bugzilla.kernel.org/show_bug.cgi?id=5994
|
||||||
.SS "Advisory locking"
|
.SS Advisory locking
|
||||||
.BR F_GETLK ", " F_SETLK " and " F_SETLKW
|
.BR F_GETLK ", " F_SETLK " and " F_SETLKW
|
||||||
are used to acquire, release, and test for the existence of record
|
are used to acquire, release, and test for the existence of record
|
||||||
locks (also known as file-segment or file-region locks).
|
locks (also known as file-segment or file-region locks).
|
||||||
|
@ -386,7 +386,7 @@ should be avoided; use
|
||||||
and
|
and
|
||||||
.BR write (2)
|
.BR write (2)
|
||||||
instead.
|
instead.
|
||||||
.SS "Mandatory locking"
|
.SS Mandatory locking
|
||||||
(Non-POSIX.)
|
(Non-POSIX.)
|
||||||
The above record locks may be either advisory or mandatory,
|
The above record locks may be either advisory or mandatory,
|
||||||
and are advisory by default.
|
and are advisory by default.
|
||||||
|
@ -432,7 +432,7 @@ and
|
||||||
|
|
||||||
The Linux implementation of mandatory locking is unreliable.
|
The Linux implementation of mandatory locking is unreliable.
|
||||||
See BUGS below.
|
See BUGS below.
|
||||||
.SS "Managing signals"
|
.SS Managing signals
|
||||||
.BR F_GETOWN ,
|
.BR F_GETOWN ,
|
||||||
.BR F_SETOWN ,
|
.BR F_SETOWN ,
|
||||||
.BR F_GETOWN_EX ,
|
.BR F_GETOWN_EX ,
|
||||||
|
@ -920,7 +920,7 @@ structure as its second argument, and the
|
||||||
field of this argument will hold the descriptor of the leased file
|
field of this argument will hold the descriptor of the leased file
|
||||||
that has been accessed by another process.
|
that has been accessed by another process.
|
||||||
(This is useful if the caller holds leases against multiple files).
|
(This is useful if the caller holds leases against multiple files).
|
||||||
.SS "File and directory change notification (dnotify)"
|
.SS File and directory change notification (dnotify)
|
||||||
.TP
|
.TP
|
||||||
.BR F_NOTIFY " (\fIint\fP)"
|
.BR F_NOTIFY " (\fIint\fP)"
|
||||||
(Linux 2.4 onward)
|
(Linux 2.4 onward)
|
||||||
|
@ -1012,7 +1012,7 @@ which provides a much superior interface for obtaining notifications of
|
||||||
file system events.
|
file system events.
|
||||||
See
|
See
|
||||||
.BR inotify (7).
|
.BR inotify (7).
|
||||||
.SS "Changing the capacity of a pipe"
|
.SS Changing the capacity of a pipe
|
||||||
.TP
|
.TP
|
||||||
.BR F_SETPIPE_SZ " (\fIint\fP; since Linux 2.6.35)"
|
.BR F_SETPIPE_SZ " (\fIint\fP; since Linux 2.6.35)"
|
||||||
Change the capacity of the pipe referred to by
|
Change the capacity of the pipe referred to by
|
||||||
|
|
|
@ -71,7 +71,7 @@ and standards to which calls in this section conform.
|
||||||
See
|
See
|
||||||
.BR standards (7).
|
.BR standards (7).
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
.SS "Calling directly"
|
.SS Calling directly
|
||||||
In most cases, it is unnecessary to invoke a system call directly,
|
In most cases, it is unnecessary to invoke a system call directly,
|
||||||
but there are times when the Standard C library does not implement
|
but there are times when the Standard C library does not implement
|
||||||
a nice wrapper function for you.
|
a nice wrapper function for you.
|
||||||
|
|
|
@ -49,7 +49,7 @@ These are marked \fI//\ MORE\fP and documented further in a
|
||||||
separate section.
|
separate section.
|
||||||
.PP
|
.PP
|
||||||
This list is very incomplete.
|
This list is very incomplete.
|
||||||
.SS "ioctl structure"
|
.SS ioctl structure
|
||||||
.\" added two sections - aeb
|
.\" added two sections - aeb
|
||||||
Ioctl command values are 32-bit constants.
|
Ioctl command values are 32-bit constants.
|
||||||
In principle these constants are completely arbitrary, but people have
|
In principle these constants are completely arbitrary, but people have
|
||||||
|
|
|
@ -223,7 +223,7 @@ These system calls only have an effect when used
|
||||||
in conjunction with an I/O scheduler that supports I/O priorities.
|
in conjunction with an I/O scheduler that supports I/O priorities.
|
||||||
As at kernel 2.6.17 the only such scheduler is the Completely Fair Queuing
|
As at kernel 2.6.17 the only such scheduler is the Completely Fair Queuing
|
||||||
(CFQ) I/O scheduler.
|
(CFQ) I/O scheduler.
|
||||||
.SS "Selecting an I/O scheduler"
|
.SS Selecting an I/O scheduler
|
||||||
I/O Schedulers are selected on a per-device basis via the special
|
I/O Schedulers are selected on a per-device basis via the special
|
||||||
file
|
file
|
||||||
.IR /sys/block/<device>/queue/scheduler .
|
.IR /sys/block/<device>/queue/scheduler .
|
||||||
|
@ -260,7 +260,7 @@ Password:
|
||||||
.RB "#" " echo cfq > /sys/block/hda/queue/scheduler"
|
.RB "#" " echo cfq > /sys/block/hda/queue/scheduler"
|
||||||
.fi
|
.fi
|
||||||
.RE
|
.RE
|
||||||
.SS "The Completely Fair Queuing (CFQ) I/O scheduler"
|
.SS The Completely Fair Queuing (CFQ) I/O scheduler
|
||||||
Since v3 (aka CFQ Time Sliced) CFQ implements
|
Since v3 (aka CFQ Time Sliced) CFQ implements
|
||||||
I/O nice levels similar to those
|
I/O nice levels similar to those
|
||||||
of CPU scheduling.
|
of CPU scheduling.
|
||||||
|
@ -307,7 +307,7 @@ constantly accessing the disk.
|
||||||
Refer to
|
Refer to
|
||||||
.I Documentation/block/ioprio.txt
|
.I Documentation/block/ioprio.txt
|
||||||
for more information on the CFQ I/O Scheduler and an example program.
|
for more information on the CFQ I/O Scheduler and an example program.
|
||||||
.SS "Required permissions to set I/O priorities"
|
.SS Required permissions to set I/O priorities
|
||||||
Permission to change a process's priority is granted or denied based
|
Permission to change a process's priority is granted or denied based
|
||||||
on two assertions:
|
on two assertions:
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -143,7 +143,7 @@ at least one
|
||||||
unblocked signal must be delivered to the sending thread before the
|
unblocked signal must be delivered to the sending thread before the
|
||||||
.BR kill ()
|
.BR kill ()
|
||||||
returns.
|
returns.
|
||||||
.SS "Linux notes"
|
.SS Linux notes
|
||||||
Across different kernel versions, Linux has enforced different rules
|
Across different kernel versions, Linux has enforced different rules
|
||||||
for the permissions required for an unprivileged process
|
for the permissions required for an unprivileged process
|
||||||
to send a signal to another process.
|
to send a signal to another process.
|
||||||
|
|
|
@ -52,7 +52,7 @@ respectively unlocking part or all of the calling process's virtual
|
||||||
address space, so that pages in the specified virtual address range may
|
address space, so that pages in the specified virtual address range may
|
||||||
once more to be swapped out if required by the kernel memory manager.
|
once more to be swapped out if required by the kernel memory manager.
|
||||||
Memory locking and unlocking are performed in units of whole pages.
|
Memory locking and unlocking are performed in units of whole pages.
|
||||||
.SS "mlock() and munlock()"
|
.SS mlock() and munlock()
|
||||||
.BR mlock ()
|
.BR mlock ()
|
||||||
locks pages in the address range starting at
|
locks pages in the address range starting at
|
||||||
.I addr
|
.I addr
|
||||||
|
@ -71,7 +71,7 @@ and continuing for
|
||||||
bytes.
|
bytes.
|
||||||
After this call, all pages that contain a part of the specified
|
After this call, all pages that contain a part of the specified
|
||||||
memory range can be moved to external swap space again by the kernel.
|
memory range can be moved to external swap space again by the kernel.
|
||||||
.SS "mlockall() and munlockall()"
|
.SS mlockall() and munlockall()
|
||||||
.BR mlockall ()
|
.BR mlockall ()
|
||||||
locks all pages mapped into the address space of the
|
locks all pages mapped into the address space of the
|
||||||
calling process.
|
calling process.
|
||||||
|
@ -289,7 +289,7 @@ has locked using
|
||||||
and
|
and
|
||||||
.BR mmap (2)
|
.BR mmap (2)
|
||||||
.BR MAP_LOCKED .
|
.BR MAP_LOCKED .
|
||||||
.SS "Limits and permissions"
|
.SS Limits and permissions
|
||||||
In Linux 2.6.8 and earlier,
|
In Linux 2.6.8 and earlier,
|
||||||
a process must be privileged
|
a process must be privileged
|
||||||
.RB ( CAP_IPC_LOCK )
|
.RB ( CAP_IPC_LOCK )
|
||||||
|
|
|
@ -177,7 +177,7 @@ function; ...
|
||||||
Consequently, these time services shall expire when the requested relative
|
Consequently, these time services shall expire when the requested relative
|
||||||
interval elapses, independently of the new or old value of the clock.
|
interval elapses, independently of the new or old value of the clock.
|
||||||
.RE
|
.RE
|
||||||
.SS "Old behavior"
|
.SS Old behavior
|
||||||
In order to support applications requiring much more precise pauses
|
In order to support applications requiring much more precise pauses
|
||||||
(e.g., in order to control some time-critical hardware),
|
(e.g., in order to control some time-critical hardware),
|
||||||
.BR nanosleep ()
|
.BR nanosleep ()
|
||||||
|
|
|
@ -1009,7 +1009,7 @@ This defines the size of the user stack to dump on sample.
|
||||||
|
|
||||||
.RE
|
.RE
|
||||||
|
|
||||||
.SS "Reading results"
|
.SS Reading results
|
||||||
Once a
|
Once a
|
||||||
.BR perf_event_open ()
|
.BR perf_event_open ()
|
||||||
file descriptor has been opened, the values
|
file descriptor has been opened, the values
|
||||||
|
@ -1099,7 +1099,7 @@ was specified in read_format.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
.SS "MMAP layout"
|
.SS MMAP layout
|
||||||
|
|
||||||
When using
|
When using
|
||||||
.BR perf_event_open ()
|
.BR perf_event_open ()
|
||||||
|
@ -1691,7 +1691,7 @@ This indicates the size of the record.
|
||||||
|
|
||||||
.RE
|
.RE
|
||||||
|
|
||||||
.SS "Signal overflow"
|
.SS Signal overflow
|
||||||
|
|
||||||
Events can be set to deliver a signal when a threshold is crossed.
|
Events can be set to deliver a signal when a threshold is crossed.
|
||||||
The signal handler is set up using the
|
The signal handler is set up using the
|
||||||
|
@ -1736,7 +1736,7 @@ a signal is provided for every overflow, even if
|
||||||
.I wakeup_events
|
.I wakeup_events
|
||||||
is not set.
|
is not set.
|
||||||
|
|
||||||
.SS "rdpmc instruction"
|
.SS rdpmc instruction
|
||||||
Starting with Linux 3.4 on x86, you can use the
|
Starting with Linux 3.4 on x86, you can use the
|
||||||
.I rdpmc
|
.I rdpmc
|
||||||
instruction to get low-latency reads without having to enter the kernel.
|
instruction to get low-latency reads without having to enter the kernel.
|
||||||
|
@ -1749,7 +1749,7 @@ Support for this can be detected with the
|
||||||
field in the mmap page; documentation on how
|
field in the mmap page; documentation on how
|
||||||
to calculate event values can be found in that section.
|
to calculate event values can be found in that section.
|
||||||
|
|
||||||
.SS "perf_event ioctl calls"
|
.SS perf_event ioctl calls
|
||||||
.PP
|
.PP
|
||||||
Various ioctls act on
|
Various ioctls act on
|
||||||
.BR perf_event_open ()
|
.BR perf_event_open ()
|
||||||
|
@ -1829,7 +1829,7 @@ This adds an ftrace filter to this event.
|
||||||
|
|
||||||
The argument is a pointer to the desired ftrace filter.
|
The argument is a pointer to the desired ftrace filter.
|
||||||
|
|
||||||
.SS "Using prctl"
|
.SS Using prctl
|
||||||
A process can enable or disable all the event groups that are
|
A process can enable or disable all the event groups that are
|
||||||
attached to it using the
|
attached to it using the
|
||||||
.BR prctl (2)
|
.BR prctl (2)
|
||||||
|
|
|
@ -229,7 +229,7 @@ then call
|
||||||
with the desired
|
with the desired
|
||||||
.IR sigmask ,
|
.IR sigmask ,
|
||||||
avoiding the race.)
|
avoiding the race.)
|
||||||
.SS "The timeout"
|
.SS The timeout
|
||||||
The time structures involved are defined in
|
The time structures involved are defined in
|
||||||
.I <sys/time.h>
|
.I <sys/time.h>
|
||||||
and look like
|
and look like
|
||||||
|
|
|
@ -438,7 +438,7 @@ prescribes the synonyms
|
||||||
.BR S_IRUSR ,
|
.BR S_IRUSR ,
|
||||||
.BR S_IWUSR ,
|
.BR S_IWUSR ,
|
||||||
.BR S_IXUSR .
|
.BR S_IXUSR .
|
||||||
.SS "Other systems"
|
.SS Other systems
|
||||||
Values that have been (or are) in use on various systems:
|
Values that have been (or are) in use on various systems:
|
||||||
.ad l
|
.ad l
|
||||||
.TS
|
.TS
|
||||||
|
|
|
@ -179,7 +179,7 @@ instead.
|
||||||
.\" .PP
|
.\" .PP
|
||||||
.\" On older systems the number of clock ticks per second is given
|
.\" On older systems the number of clock ticks per second is given
|
||||||
.\" by the variable HZ.
|
.\" by the variable HZ.
|
||||||
.SS "Historical"
|
.SS Historical
|
||||||
SVr1-3 returns
|
SVr1-3 returns
|
||||||
.I long
|
.I long
|
||||||
and the struct members are of type
|
and the struct members are of type
|
||||||
|
|
|
@ -97,7 +97,7 @@ is deprecated and has only been provided for compatibility.
|
||||||
All new programs should use
|
All new programs should use
|
||||||
.BR statfs (2)
|
.BR statfs (2)
|
||||||
instead.
|
instead.
|
||||||
.SS "HP-UX notes"
|
.SS HP-UX notes
|
||||||
The HP-UX version of the
|
The HP-UX version of the
|
||||||
.I ustat
|
.I ustat
|
||||||
structure has an additional field,
|
structure has an additional field,
|
||||||
|
|
|
@ -58,7 +58,7 @@ _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
|
||||||
.RE
|
.RE
|
||||||
.ad b
|
.ad b
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.SS "Standard description"
|
.SS Standard description
|
||||||
(From POSIX.1)
|
(From POSIX.1)
|
||||||
The
|
The
|
||||||
.BR vfork ()
|
.BR vfork ()
|
||||||
|
@ -77,7 +77,7 @@ was called, or calls any other function before successfully calling
|
||||||
or one of the
|
or one of the
|
||||||
.BR exec (3)
|
.BR exec (3)
|
||||||
family of functions.
|
family of functions.
|
||||||
.SS "Linux description"
|
.SS Linux description
|
||||||
.BR vfork (),
|
.BR vfork (),
|
||||||
just like
|
just like
|
||||||
.BR fork (2),
|
.BR fork (2),
|
||||||
|
@ -127,7 +127,7 @@ arrive after the child releases the parent's memory
|
||||||
(i.e., after the child terminates
|
(i.e., after the child terminates
|
||||||
or calls
|
or calls
|
||||||
.BR execve (2)).
|
.BR execve (2)).
|
||||||
.SS "Historic description"
|
.SS Historic description
|
||||||
Under Linux,
|
Under Linux,
|
||||||
.BR fork (2)
|
.BR fork (2)
|
||||||
is implemented using copy-on-write pages, so the only penalty incurred by
|
is implemented using copy-on-write pages, so the only penalty incurred by
|
||||||
|
|
|
@ -101,7 +101,7 @@ In the remainder of this page, a child whose state has changed
|
||||||
and which has not yet been waited upon by one of these system
|
and which has not yet been waited upon by one of these system
|
||||||
calls is termed
|
calls is termed
|
||||||
.IR waitable .
|
.IR waitable .
|
||||||
.SS "wait() and waitpid()"
|
.SS wait() and waitpid()
|
||||||
The
|
The
|
||||||
.BR wait ()
|
.BR wait ()
|
||||||
system call suspends execution of the calling process until one of its
|
system call suspends execution of the calling process until one of its
|
||||||
|
@ -237,7 +237,7 @@ returned true.
|
||||||
(since Linux 2.6.10)
|
(since Linux 2.6.10)
|
||||||
returns true if the child process was resumed by delivery of
|
returns true if the child process was resumed by delivery of
|
||||||
.BR SIGCONT .
|
.BR SIGCONT .
|
||||||
.SS "waitid()"
|
.SS waitid()
|
||||||
The
|
The
|
||||||
.BR waitid ()
|
.BR waitid ()
|
||||||
system call (available since Linux 2.6.9) provides more precise
|
system call (available since Linux 2.6.9) provides more precise
|
||||||
|
|
|
@ -53,7 +53,7 @@ This function should never be used.
|
||||||
Use
|
Use
|
||||||
.BR free (3)
|
.BR free (3)
|
||||||
instead.
|
instead.
|
||||||
.SS "1-arg cfree"
|
.SS 1-arg cfree
|
||||||
In glibc, the function
|
In glibc, the function
|
||||||
.BR cfree ()
|
.BR cfree ()
|
||||||
is a synonym for
|
is a synonym for
|
||||||
|
@ -65,7 +65,7 @@ The declaration is sometimes in
|
||||||
.I <stdlib.h>
|
.I <stdlib.h>
|
||||||
and sometimes in
|
and sometimes in
|
||||||
.IR <malloc.h> .
|
.IR <malloc.h> .
|
||||||
.SS "3-arg cfree"
|
.SS 3-arg cfree
|
||||||
Some SCO and Solaris versions have malloc libraries with a 3-argument
|
Some SCO and Solaris versions have malloc libraries with a 3-argument
|
||||||
.BR cfree (),
|
.BR cfree (),
|
||||||
apparently as an analog to
|
apparently as an analog to
|
||||||
|
|
|
@ -448,7 +448,7 @@ manual page for more information.)
|
||||||
routines return \-1 on error (setting
|
routines return \-1 on error (setting
|
||||||
.IR errno )
|
.IR errno )
|
||||||
and 0 on success.
|
and 0 on success.
|
||||||
.SS "Key/data pairs"
|
.SS Key/data pairs
|
||||||
Access to all file types is based on key/data pairs.
|
Access to all file types is based on key/data pairs.
|
||||||
Both keys and data are represented by the following data structure:
|
Both keys and data are represented by the following data structure:
|
||||||
.in +4n
|
.in +4n
|
||||||
|
|
|
@ -55,7 +55,7 @@ The four functions
|
||||||
.BR dlclose (),
|
.BR dlclose (),
|
||||||
.BR dlerror ()
|
.BR dlerror ()
|
||||||
implement the interface to the dynamic linking loader.
|
implement the interface to the dynamic linking loader.
|
||||||
.SS "dlerror()"
|
.SS dlerror()
|
||||||
The function
|
The function
|
||||||
.BR dlerror ()
|
.BR dlerror ()
|
||||||
returns a human readable string describing the most recent error
|
returns a human readable string describing the most recent error
|
||||||
|
@ -68,7 +68,7 @@ since the last call to
|
||||||
.BR dlerror ().
|
.BR dlerror ().
|
||||||
It returns NULL if no errors have occurred since initialization or since
|
It returns NULL if no errors have occurred since initialization or since
|
||||||
it was last called.
|
it was last called.
|
||||||
.SS "dlopen()"
|
.SS dlopen()
|
||||||
The function
|
The function
|
||||||
.BR dlopen ()
|
.BR dlopen ()
|
||||||
loads the dynamic library file named by the null-terminated
|
loads the dynamic library file named by the null-terminated
|
||||||
|
@ -233,7 +233,7 @@ may force symbol resolution for a library earlier loaded with
|
||||||
If
|
If
|
||||||
.BR dlopen ()
|
.BR dlopen ()
|
||||||
fails for any reason, it returns NULL.
|
fails for any reason, it returns NULL.
|
||||||
.SS "dlsym()"
|
.SS dlsym()
|
||||||
The function
|
The function
|
||||||
.BR dlsym ()
|
.BR dlsym ()
|
||||||
takes a "handle" of a dynamic library returned by
|
takes a "handle" of a dynamic library returned by
|
||||||
|
@ -274,7 +274,7 @@ will find the next occurrence of a function in the search order
|
||||||
after the current library.
|
after the current library.
|
||||||
This allows one to provide a wrapper
|
This allows one to provide a wrapper
|
||||||
around a function in another shared library.
|
around a function in another shared library.
|
||||||
.SS "dlclose()"
|
.SS dlclose()
|
||||||
The function
|
The function
|
||||||
.BR dlclose ()
|
.BR dlclose ()
|
||||||
decrements the reference count on the dynamic library handle
|
decrements the reference count on the dynamic library handle
|
||||||
|
@ -285,7 +285,7 @@ symbols in it, then the dynamic library is unloaded.
|
||||||
The function
|
The function
|
||||||
.BR dlclose ()
|
.BR dlclose ()
|
||||||
returns 0 on success, and nonzero on error.
|
returns 0 on success, and nonzero on error.
|
||||||
.SS "The obsolete symbols _init() and _fini()"
|
.SS The obsolete symbols _init() and _fini()
|
||||||
The linker recognizes special symbols
|
The linker recognizes special symbols
|
||||||
.B _init
|
.B _init
|
||||||
and
|
and
|
||||||
|
|
|
@ -93,7 +93,7 @@ The
|
||||||
.I invalid
|
.I invalid
|
||||||
exception occurs when there is no well-defined result
|
exception occurs when there is no well-defined result
|
||||||
for an operation, as for 0/0 or infinity \- infinity or sqrt(\-1).
|
for an operation, as for 0/0 or infinity \- infinity or sqrt(\-1).
|
||||||
.SS "Exception handling"
|
.SS Exception handling
|
||||||
Exceptions are represented in two ways: as a single bit
|
Exceptions are represented in two ways: as a single bit
|
||||||
(exception present/absent), and these bits correspond in some
|
(exception present/absent), and these bits correspond in some
|
||||||
implementation-defined way with bit positions in an integer,
|
implementation-defined way with bit positions in an integer,
|
||||||
|
@ -204,7 +204,7 @@ The value of
|
||||||
should reflect the current rounding mode as set by
|
should reflect the current rounding mode as set by
|
||||||
.BR fesetround ()
|
.BR fesetround ()
|
||||||
(but see BUGS).
|
(but see BUGS).
|
||||||
.SS "Floating-point environment"
|
.SS Floating-point environment
|
||||||
The entire floating-point environment, including
|
The entire floating-point environment, including
|
||||||
control modes and status flags, can be handled
|
control modes and status flags, can be handled
|
||||||
as one opaque object, of type
|
as one opaque object, of type
|
||||||
|
|
|
@ -53,7 +53,7 @@ information can be found.
|
||||||
It should contain the
|
It should contain the
|
||||||
.I label
|
.I label
|
||||||
value and a unique identification number.
|
value and a unique identification number.
|
||||||
.SS "Dummy arguments"
|
.SS Dummy arguments
|
||||||
Each of the arguments can have a dummy value.
|
Each of the arguments can have a dummy value.
|
||||||
The dummy classification value
|
The dummy classification value
|
||||||
.B MM_NULLMC
|
.B MM_NULLMC
|
||||||
|
@ -72,7 +72,7 @@ the empty string, and
|
||||||
.B MM_NULLSEV
|
.B MM_NULLSEV
|
||||||
is a synonym for
|
is a synonym for
|
||||||
.BR NO_SEV .
|
.BR NO_SEV .
|
||||||
.SS "The classification argument"
|
.SS The classification argument
|
||||||
The
|
The
|
||||||
.I classification
|
.I classification
|
||||||
argument is the sum of values describing 4 types of information.
|
argument is the sum of values describing 4 types of information.
|
||||||
|
@ -119,7 +119,7 @@ It is a recoverable error.
|
||||||
.TP
|
.TP
|
||||||
.B MM_NRECOV
|
.B MM_NRECOV
|
||||||
It is a nonrecoverable error.
|
It is a nonrecoverable error.
|
||||||
.SS "The severity argument"
|
.SS The severity argument
|
||||||
The
|
The
|
||||||
.I severity
|
.I severity
|
||||||
argument can take one of the following values:
|
argument can take one of the following values:
|
||||||
|
|
|
@ -43,11 +43,11 @@ functions, as appropriate.
|
||||||
|
|
||||||
For the definition of the Gamma function, see
|
For the definition of the Gamma function, see
|
||||||
.BR tgamma (3).
|
.BR tgamma (3).
|
||||||
.SS "*BSD version"
|
.SS *BSD version
|
||||||
The libm in 4.4BSD and some versions of FreeBSD had a
|
The libm in 4.4BSD and some versions of FreeBSD had a
|
||||||
.BR gamma ()
|
.BR gamma ()
|
||||||
function that computes the Gamma function, as one would expect.
|
function that computes the Gamma function, as one would expect.
|
||||||
.SS "glibc version"
|
.SS glibc version
|
||||||
Glibc has a
|
Glibc has a
|
||||||
.BR gamma ()
|
.BR gamma ()
|
||||||
function that is equivalent to
|
function that is equivalent to
|
||||||
|
|
|
@ -411,7 +411,7 @@ The
|
||||||
function frees the memory that was allocated
|
function frees the memory that was allocated
|
||||||
for the dynamically allocated linked list
|
for the dynamically allocated linked list
|
||||||
.IR res .
|
.IR res .
|
||||||
.SS "Extensions to getaddrinfo() for Internationalized Domain Names"
|
.SS Extensions to getaddrinfo() for Internationalized Domain Names
|
||||||
.PP
|
.PP
|
||||||
Starting with glibc 2.3.4,
|
Starting with glibc 2.3.4,
|
||||||
.BR getaddrinfo ()
|
.BR getaddrinfo ()
|
||||||
|
|
|
@ -362,7 +362,7 @@ The BSD prototype for
|
||||||
uses
|
uses
|
||||||
.I const char *
|
.I const char *
|
||||||
for the first argument.
|
for the first argument.
|
||||||
.SS "System V/POSIX extension"
|
.SS System V/POSIX extension
|
||||||
POSIX requires the
|
POSIX requires the
|
||||||
.BR gethostent ()
|
.BR gethostent ()
|
||||||
call, that should return the next entry in the host data base.
|
call, that should return the next entry in the host data base.
|
||||||
|
@ -379,7 +379,7 @@ The glibc version will ignore ipv6 entries.
|
||||||
This function is not reentrant,
|
This function is not reentrant,
|
||||||
and glibc adds a reentrant version
|
and glibc adds a reentrant version
|
||||||
.BR gethostent_r ().
|
.BR gethostent_r ().
|
||||||
.SS "GNU extensions"
|
.SS GNU extensions
|
||||||
Glibc2 also has a
|
Glibc2 also has a
|
||||||
.BR gethostbyname2 ()
|
.BR gethostbyname2 ()
|
||||||
that works like
|
that works like
|
||||||
|
|
|
@ -111,7 +111,7 @@ cannot be determined.)
|
||||||
If set, then the numeric form of the service address is returned.
|
If set, then the numeric form of the service address is returned.
|
||||||
(When not set, this will still happen in case the service's name
|
(When not set, this will still happen in case the service's name
|
||||||
cannot be determined.)
|
cannot be determined.)
|
||||||
.SS "Extensions to getnameinfo() for Internationalized Domain Names"
|
.SS Extensions to getnameinfo() for Internationalized Domain Names
|
||||||
.PP
|
.PP
|
||||||
Starting with glibc 2.3.4,
|
Starting with glibc 2.3.4,
|
||||||
.BR getnameinfo ()
|
.BR getnameinfo ()
|
||||||
|
|
|
@ -159,7 +159,7 @@ These were the functions that formed the original shadow API.
|
||||||
They are widely available.
|
They are widely available.
|
||||||
.\" Also in libc5
|
.\" Also in libc5
|
||||||
.\" SUN doesn't have sgetspent()
|
.\" SUN doesn't have sgetspent()
|
||||||
.SS "Reentrant versions"
|
.SS Reentrant versions
|
||||||
Analogous to the reentrant functions for the password database, glibc
|
Analogous to the reentrant functions for the password database, glibc
|
||||||
also has reentrant functions for the shadow password database.
|
also has reentrant functions for the shadow password database.
|
||||||
The
|
The
|
||||||
|
|
|
@ -47,7 +47,7 @@ and writes it to both the utmp and the wtmp file.
|
||||||
The function
|
The function
|
||||||
.BR logout ()
|
.BR logout ()
|
||||||
clears the entry in the utmp file again.
|
clears the entry in the utmp file again.
|
||||||
.SS "GNU details"
|
.SS GNU details
|
||||||
More precisely,
|
More precisely,
|
||||||
.BR login ()
|
.BR login ()
|
||||||
takes the argument
|
takes the argument
|
||||||
|
|
|
@ -149,7 +149,7 @@ would cause copying to take place between objects that overlap
|
||||||
(e.g., if the target string array and one of the supplied input arguments
|
(e.g., if the target string array and one of the supplied input arguments
|
||||||
refer to the same buffer).
|
refer to the same buffer).
|
||||||
See NOTES.
|
See NOTES.
|
||||||
.SS "Return value"
|
.SS Return value
|
||||||
Upon successful return, these functions return the number of characters
|
Upon successful return, these functions return the number of characters
|
||||||
printed (excluding the null byte used to end output to strings).
|
printed (excluding the null byte used to end output to strings).
|
||||||
|
|
||||||
|
@ -170,7 +170,7 @@ or more means that the output was truncated.
|
||||||
(See also below under NOTES.)
|
(See also below under NOTES.)
|
||||||
|
|
||||||
If an output error is encountered, a negative value is returned.
|
If an output error is encountered, a negative value is returned.
|
||||||
.SS "Format of the format string"
|
.SS Format of the format string
|
||||||
The format string is a character string, beginning and ending
|
The format string is a character string, beginning and ending
|
||||||
in its initial shift state, if any.
|
in its initial shift state, if any.
|
||||||
The format string is composed of zero or more directives: ordinary
|
The format string is composed of zero or more directives: ordinary
|
||||||
|
@ -252,7 +252,7 @@ Thus,
|
||||||
.in
|
.in
|
||||||
results in "1234567.89" in the POSIX locale, in "1234567,89" in the
|
results in "1234567.89" in the POSIX locale, in "1234567,89" in the
|
||||||
nl_NL locale, and in "1.234.567,89" in the da_DK locale.
|
nl_NL locale, and in "1.234.567,89" in the da_DK locale.
|
||||||
.SS "The flag characters"
|
.SS The flag characters
|
||||||
The character % is followed by zero or more of the following flags:
|
The character % is followed by zero or more of the following flags:
|
||||||
.TP
|
.TP
|
||||||
.B #
|
.B #
|
||||||
|
@ -385,7 +385,7 @@ the output uses the locale's alternative output digits, if any.
|
||||||
For example, since glibc 2.2.3 this will give Arabic-Indic digits
|
For example, since glibc 2.2.3 this will give Arabic-Indic digits
|
||||||
in the Persian ("fa_IR") locale.
|
in the Persian ("fa_IR") locale.
|
||||||
.\" outdigits keyword in locale file
|
.\" outdigits keyword in locale file
|
||||||
.SS "The field width"
|
.SS The field width
|
||||||
An optional decimal digit string (with nonzero first digit) specifying
|
An optional decimal digit string (with nonzero first digit) specifying
|
||||||
a minimum field width.
|
a minimum field width.
|
||||||
If the converted value has fewer characters
|
If the converted value has fewer characters
|
||||||
|
@ -401,7 +401,7 @@ positive field width.
|
||||||
In no case does a nonexistent or small field width cause truncation of a
|
In no case does a nonexistent or small field width cause truncation of a
|
||||||
field; if the result of a conversion is wider than the field width, the
|
field; if the result of a conversion is wider than the field width, the
|
||||||
field is expanded to contain the conversion result.
|
field is expanded to contain the conversion result.
|
||||||
.SS "The precision"
|
.SS The precision
|
||||||
An optional precision, in the form of a period (\(aq.\(aq) followed by an
|
An optional precision, in the form of a period (\(aq.\(aq) followed by an
|
||||||
optional decimal digit string.
|
optional decimal digit string.
|
||||||
Instead of a decimal digit string one may write "*" or "*m$"
|
Instead of a decimal digit string one may write "*" or "*m$"
|
||||||
|
@ -437,7 +437,7 @@ string for
|
||||||
and
|
and
|
||||||
.B S
|
.B S
|
||||||
conversions.
|
conversions.
|
||||||
.SS "The length modifier"
|
.SS The length modifier
|
||||||
Here, "integer conversion" stands for
|
Here, "integer conversion" stands for
|
||||||
.BR d ,
|
.BR d ,
|
||||||
.BR i ,
|
.BR i ,
|
||||||
|
@ -574,7 +574,7 @@ and
|
||||||
.BR Lf ,
|
.BR Lf ,
|
||||||
.BR Lg ,
|
.BR Lg ,
|
||||||
.BR LG ).
|
.BR LG ).
|
||||||
.SS "The conversion specifier"
|
.SS The conversion specifier
|
||||||
A character that specifies the type of conversion to be applied.
|
A character that specifies the type of conversion to be applied.
|
||||||
The conversion specifiers and their meanings are:
|
The conversion specifiers and their meanings are:
|
||||||
.TP
|
.TP
|
||||||
|
|
10
man3/regex.3
10
man3/regex.3
|
@ -49,7 +49,7 @@ regcomp, regexec, regerror, regfree \- POSIX regex functions
|
||||||
.BI "void regfree(regex_t *" preg );
|
.BI "void regfree(regex_t *" preg );
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.SS "POSIX regex compiling"
|
.SS POSIX regex compiling
|
||||||
.BR regcomp ()
|
.BR regcomp ()
|
||||||
is used to compile a regular expression into a form that is suitable
|
is used to compile a regular expression into a form that is suitable
|
||||||
for subsequent
|
for subsequent
|
||||||
|
@ -126,7 +126,7 @@ whether
|
||||||
.I eflags
|
.I eflags
|
||||||
contains
|
contains
|
||||||
.BR REG_NOTEOL .
|
.BR REG_NOTEOL .
|
||||||
.SS "POSIX regex matching"
|
.SS POSIX regex matching
|
||||||
.BR regexec ()
|
.BR regexec ()
|
||||||
is used to match a null-terminated string
|
is used to match a null-terminated string
|
||||||
against the precompiled pattern buffer,
|
against the precompiled pattern buffer,
|
||||||
|
@ -159,7 +159,7 @@ The match-end-of-line operator always fails to match (but see the
|
||||||
compilation flag
|
compilation flag
|
||||||
.B REG_NEWLINE
|
.B REG_NEWLINE
|
||||||
above)
|
above)
|
||||||
.SS "Byte offsets"
|
.SS Byte offsets
|
||||||
Unless
|
Unless
|
||||||
.B REG_NOSUB
|
.B REG_NOSUB
|
||||||
was set for the compilation of the pattern buffer, it is possible to
|
was set for the compilation of the pattern buffer, it is possible to
|
||||||
|
@ -209,7 +209,7 @@ The relative
|
||||||
.I rm_eo
|
.I rm_eo
|
||||||
element indicates the end offset of the match,
|
element indicates the end offset of the match,
|
||||||
which is the offset of the first character after the matching text.
|
which is the offset of the first character after the matching text.
|
||||||
.SS "POSIX error reporting"
|
.SS POSIX error reporting
|
||||||
.BR regerror ()
|
.BR regerror ()
|
||||||
is used to turn the error codes that can be returned by both
|
is used to turn the error codes that can be returned by both
|
||||||
.BR regcomp ()
|
.BR regcomp ()
|
||||||
|
@ -238,7 +238,7 @@ are nonzero,
|
||||||
is filled in with the first
|
is filled in with the first
|
||||||
.I "errbuf_size \- 1"
|
.I "errbuf_size \- 1"
|
||||||
characters of the error message and a terminating null byte (\(aq\\0\(aq).
|
characters of the error message and a terminating null byte (\(aq\\0\(aq).
|
||||||
.SS "POSIX pattern buffer freeing"
|
.SS POSIX pattern buffer freeing
|
||||||
Supplying
|
Supplying
|
||||||
.BR regfree ()
|
.BR regfree ()
|
||||||
with a precompiled pattern buffer,
|
with a precompiled pattern buffer,
|
||||||
|
|
|
@ -178,7 +178,7 @@ Function versions of the macro functions
|
||||||
and
|
and
|
||||||
.B putchar
|
.B putchar
|
||||||
exist and will be used if the macros definitions are explicitly removed.
|
exist and will be used if the macros definitions are explicitly removed.
|
||||||
.SS "List of functions"
|
.SS List of functions
|
||||||
.TS
|
.TS
|
||||||
;
|
;
|
||||||
lb lb
|
lb lb
|
||||||
|
|
|
@ -99,7 +99,7 @@ The
|
||||||
.BR sysconf ()
|
.BR sysconf ()
|
||||||
argument will be
|
argument will be
|
||||||
.BR _SC_FOO .
|
.BR _SC_FOO .
|
||||||
.SS "POSIX.1 variables"
|
.SS POSIX.1 variables
|
||||||
We give the name of the variable, the name of the
|
We give the name of the variable, the name of the
|
||||||
.BR sysconf ()
|
.BR sysconf ()
|
||||||
argument used to inquire about its value,
|
argument used to inquire about its value,
|
||||||
|
@ -218,7 +218,7 @@ format
|
||||||
the value
|
the value
|
||||||
.B 199009L
|
.B 199009L
|
||||||
indicates the Sept. 1990 revision.
|
indicates the Sept. 1990 revision.
|
||||||
.SS "POSIX.2 variables"
|
.SS POSIX.2 variables
|
||||||
Next, the POSIX.2 values, giving limits for utilities.
|
Next, the POSIX.2 values, giving limits for utilities.
|
||||||
.TP
|
.TP
|
||||||
.BR BC_BASE_MAX " - " _SC_BC_BASE_MAX
|
.BR BC_BASE_MAX " - " _SC_BC_BASE_MAX
|
||||||
|
|
|
@ -86,7 +86,7 @@ _BSD_SOURCE
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The termios functions describe a general terminal interface that is
|
The termios functions describe a general terminal interface that is
|
||||||
provided to control asynchronous communications ports.
|
provided to control asynchronous communications ports.
|
||||||
.SS "The termios structure"
|
.SS The termios structure
|
||||||
.LP
|
.LP
|
||||||
Many of the functions described here have a \fItermios_p\fP argument
|
Many of the functions described here have a \fItermios_p\fP argument
|
||||||
that is a pointer to a \fItermios\fP structure.
|
that is a pointer to a \fItermios\fP structure.
|
||||||
|
@ -649,7 +649,7 @@ and
|
||||||
.BR VTIME ,
|
.BR VTIME ,
|
||||||
see the description of
|
see the description of
|
||||||
noncanonical mode below.
|
noncanonical mode below.
|
||||||
.SS "Retrieving and changing terminal settings"
|
.SS Retrieving and changing terminal settings
|
||||||
.PP
|
.PP
|
||||||
.BR tcgetattr ()
|
.BR tcgetattr ()
|
||||||
gets the parameters associated with the object referred by \fIfd\fP and
|
gets the parameters associated with the object referred by \fIfd\fP and
|
||||||
|
@ -677,7 +677,7 @@ the change occurs after all output written to the object referred by
|
||||||
.I fd
|
.I fd
|
||||||
has been transmitted, and all input that has been received but not read
|
has been transmitted, and all input that has been received but not read
|
||||||
will be discarded before the change is made.
|
will be discarded before the change is made.
|
||||||
.SS "Canonical and noncanonical mode"
|
.SS Canonical and noncanonical mode
|
||||||
The setting of the
|
The setting of the
|
||||||
.B ICANON
|
.B ICANON
|
||||||
canon flag in
|
canon flag in
|
||||||
|
@ -761,7 +761,7 @@ MIN byte have been read,
|
||||||
or when the inter-byte timeout expires.
|
or when the inter-byte timeout expires.
|
||||||
Because the timer is only started after the initial byte
|
Because the timer is only started after the initial byte
|
||||||
becomes available, at least one byte will be read.
|
becomes available, at least one byte will be read.
|
||||||
.SS "Raw mode"
|
.SS Raw mode
|
||||||
.LP
|
.LP
|
||||||
.BR cfmakeraw ()
|
.BR cfmakeraw ()
|
||||||
sets the terminal to something like the
|
sets the terminal to something like the
|
||||||
|
@ -779,7 +779,7 @@ The terminal attributes are set as follows:
|
||||||
termios_p\->c_cflag &= ~(CSIZE | PARENB);
|
termios_p\->c_cflag &= ~(CSIZE | PARENB);
|
||||||
termios_p\->c_cflag |= CS8;
|
termios_p\->c_cflag |= CS8;
|
||||||
.fi
|
.fi
|
||||||
.SS "Line control"
|
.SS Line control
|
||||||
.LP
|
.LP
|
||||||
.BR tcsendbreak ()
|
.BR tcsendbreak ()
|
||||||
transmits a continuous stream of zero-valued bits for a specific
|
transmits a continuous stream of zero-valued bits for a specific
|
||||||
|
@ -831,7 +831,7 @@ transmitting data to the system.
|
||||||
.LP
|
.LP
|
||||||
The default on open of a terminal file is that neither its input nor its
|
The default on open of a terminal file is that neither its input nor its
|
||||||
output is suspended.
|
output is suspended.
|
||||||
.SS "Line speed"
|
.SS Line speed
|
||||||
The baud rate functions are provided for getting and setting the values
|
The baud rate functions are provided for getting and setting the values
|
||||||
of the input and output baud rates in the \fItermios\fP structure.
|
of the input and output baud rates in the \fItermios\fP structure.
|
||||||
The new values do not take effect
|
The new values do not take effect
|
||||||
|
|
|
@ -53,7 +53,7 @@ returns the index of the current user's entry in some file.
|
||||||
.LP
|
.LP
|
||||||
Now "What file?" you ask.
|
Now "What file?" you ask.
|
||||||
Well, let's first look at some history.
|
Well, let's first look at some history.
|
||||||
.SS "Ancient history"
|
.SS Ancient history
|
||||||
There used to be a file
|
There used to be a file
|
||||||
.I /etc/ttys
|
.I /etc/ttys
|
||||||
in UNIX V6, that was read by the
|
in UNIX V6, that was read by the
|
||||||
|
@ -83,7 +83,7 @@ Later systems have more elaborate syntax.
|
||||||
System V-like systems have
|
System V-like systems have
|
||||||
.I /etc/inittab
|
.I /etc/inittab
|
||||||
instead.
|
instead.
|
||||||
.SS "Ancient history (2)"
|
.SS Ancient history (2)
|
||||||
On the other hand, there is the file
|
On the other hand, there is the file
|
||||||
.I /etc/utmp
|
.I /etc/utmp
|
||||||
listing the people currently logged in.
|
listing the people currently logged in.
|
||||||
|
@ -97,7 +97,7 @@ using the
|
||||||
call to find the number of the line in
|
call to find the number of the line in
|
||||||
.I /etc/ttys
|
.I /etc/ttys
|
||||||
(counting from 1).
|
(counting from 1).
|
||||||
.SS "The semantics of ttyslot"
|
.SS The semantics of ttyslot
|
||||||
Thus, the function
|
Thus, the function
|
||||||
.BR ttyslot ()
|
.BR ttyslot ()
|
||||||
returns the index of the controlling terminal of the calling process
|
returns the index of the controlling terminal of the calling process
|
||||||
|
|
|
@ -40,7 +40,7 @@ please look in the source code, write a man page (using a style
|
||||||
similar to that of the other Linux section 3 man pages), and send it to
|
similar to that of the other Linux section 3 man pages), and send it to
|
||||||
.B mtk.manpages@gmail.com
|
.B mtk.manpages@gmail.com
|
||||||
for inclusion in the next man page release.
|
for inclusion in the next man page release.
|
||||||
.SS "The list"
|
.SS The list
|
||||||
|
|
||||||
.BR authdes_create (3),
|
.BR authdes_create (3),
|
||||||
.BR authdes_getucred (3),
|
.BR authdes_getucred (3),
|
||||||
|
|
|
@ -80,7 +80,7 @@ More precisely, it does not free
|
||||||
its argument, but it frees the array
|
its argument, but it frees the array
|
||||||
.I we_wordv
|
.I we_wordv
|
||||||
and the strings that points to.
|
and the strings that points to.
|
||||||
.SS "The string argument"
|
.SS The string argument
|
||||||
Since the expansion is the same as the expansion by the shell (see
|
Since the expansion is the same as the expansion by the shell (see
|
||||||
.BR sh (1))
|
.BR sh (1))
|
||||||
of the parameters to a command, the string
|
of the parameters to a command, the string
|
||||||
|
@ -96,7 +96,7 @@ If the argument
|
||||||
contains a word that starts with an unquoted comment character #,
|
contains a word that starts with an unquoted comment character #,
|
||||||
then it is unspecified whether that word and all following words
|
then it is unspecified whether that word and all following words
|
||||||
are ignored, or the # is treated as a non-comment character.
|
are ignored, or the # is treated as a non-comment character.
|
||||||
.SS "The expansion"
|
.SS The expansion
|
||||||
The expansion done consists of the following stages:
|
The expansion done consists of the following stages:
|
||||||
tilde expansion (replacing ~user by user's home directory),
|
tilde expansion (replacing ~user by user's home directory),
|
||||||
variable substitution (replacing $FOO by the value of the environment
|
variable substitution (replacing $FOO by the value of the environment
|
||||||
|
@ -109,11 +109,11 @@ The result of expansion of special parameters
|
||||||
.LP
|
.LP
|
||||||
Field splitting is done using the environment variable $IFS.
|
Field splitting is done using the environment variable $IFS.
|
||||||
If it is not set, the field separators are space, tab and newline.
|
If it is not set, the field separators are space, tab and newline.
|
||||||
.SS "The output array"
|
.SS The output array
|
||||||
The array
|
The array
|
||||||
.I we_wordv
|
.I we_wordv
|
||||||
contains the words found, followed by a NULL.
|
contains the words found, followed by a NULL.
|
||||||
.SS "The flags argument"
|
.SS The flags argument
|
||||||
The
|
The
|
||||||
.I flag
|
.I flag
|
||||||
argument is a bitwise inclusive OR of the following values:
|
argument is a bitwise inclusive OR of the following values:
|
||||||
|
|
|
@ -64,7 +64,7 @@ always want to use a terminfo-aware screen library or utility such as
|
||||||
.BR tput (1),
|
.BR tput (1),
|
||||||
or
|
or
|
||||||
.BR reset (1).
|
.BR reset (1).
|
||||||
.SS "Linux console controls"
|
.SS Linux console controls
|
||||||
This section describes all the control characters and escape sequences
|
This section describes all the control characters and escape sequences
|
||||||
that invoke special functions (i.e., anything other than writing a
|
that invoke special functions (i.e., anything other than writing a
|
||||||
glyph at the current cursor location) on the Linux console.
|
glyph at the current cursor location) on the Linux console.
|
||||||
|
@ -372,7 +372,7 @@ ESC [ 12 ; \fIn\fP ] Bring specified console to the front.
|
||||||
ESC [ 13 ] Unblank the screen.
|
ESC [ 13 ] Unblank the screen.
|
||||||
ESC [ 14 ; \fIn\fP ] Set the VESA powerdown interval in minutes.
|
ESC [ 14 ; \fIn\fP ] Set the VESA powerdown interval in minutes.
|
||||||
.TE
|
.TE
|
||||||
.SS "Character sets"
|
.SS Character sets
|
||||||
The kernel knows about 4 translations of bytes into console-screen
|
The kernel knows about 4 translations of bytes into console-screen
|
||||||
symbols.
|
symbols.
|
||||||
The four tables are: a) Latin1 \-> PC,
|
The four tables are: a) Latin1 \-> PC,
|
||||||
|
@ -409,7 +409,7 @@ s = map[c] is sent to the video memory.
|
||||||
The bitmap that corresponds to
|
The bitmap that corresponds to
|
||||||
s is found in the character ROM, and can be changed using
|
s is found in the character ROM, and can be changed using
|
||||||
.BR setfont (8).
|
.BR setfont (8).
|
||||||
.SS "Mouse tracking"
|
.SS Mouse tracking
|
||||||
The mouse tracking facility is intended to return
|
The mouse tracking facility is intended to return
|
||||||
.BR xterm (1)-compatible
|
.BR xterm (1)-compatible
|
||||||
mouse status reports.
|
mouse status reports.
|
||||||
|
@ -452,7 +452,7 @@ pressed and are added together: 4=Shift, 8=Meta, 16=Control.
|
||||||
Again \fIx\fP and
|
Again \fIx\fP and
|
||||||
\fIy\fP are the x and y coordinates of the mouse event.
|
\fIy\fP are the x and y coordinates of the mouse event.
|
||||||
The upper left corner is (1,1).
|
The upper left corner is (1,1).
|
||||||
.SS "Comparisons with other terminals"
|
.SS Comparisons with other terminals
|
||||||
Many different terminal types are described, like the Linux console,
|
Many different terminal types are described, like the Linux console,
|
||||||
as being "VT100-compatible".
|
as being "VT100-compatible".
|
||||||
Here we discuss differences between the
|
Here we discuss differences between the
|
||||||
|
|
|
@ -89,7 +89,7 @@ different device.
|
||||||
.\"
|
.\"
|
||||||
.\"
|
.\"
|
||||||
.\"
|
.\"
|
||||||
.SS "Boot-up operation"
|
.SS Boot-up operation
|
||||||
When booting up with
|
When booting up with
|
||||||
.BR initrd ,
|
.BR initrd ,
|
||||||
the system boots as follows:
|
the system boots as follows:
|
||||||
|
@ -228,7 +228,7 @@ device having a suitable root file-system.
|
||||||
.\"
|
.\"
|
||||||
.\"
|
.\"
|
||||||
.\"
|
.\"
|
||||||
.SS "Changing the normal root file system"
|
.SS Changing the normal root file system
|
||||||
By default,
|
By default,
|
||||||
the kernel's settings
|
the kernel's settings
|
||||||
(e.g., set in the kernel file with
|
(e.g., set in the kernel file with
|
||||||
|
|
12
man4/mouse.4
12
man4/mouse.4
|
@ -69,7 +69,7 @@ bit/s string
|
||||||
.TE
|
.TE
|
||||||
|
|
||||||
The first byte of a data packet can be used to synchronization purposes.
|
The first byte of a data packet can be used to synchronization purposes.
|
||||||
.SS "Microsoft protocol"
|
.SS Microsoft protocol
|
||||||
The \fBMicrosoft\fP protocol uses 1 start bit, 7 data bits, no parity
|
The \fBMicrosoft\fP protocol uses 1 start bit, 7 data bits, no parity
|
||||||
and one stop bit at the speed of 1200 bits/sec.
|
and one stop bit at the speed of 1200 bits/sec.
|
||||||
Data is sent to RxD in 3-byte packets.
|
Data is sent to RxD in 3-byte packets.
|
||||||
|
@ -84,7 +84,7 @@ byte d6 d5 d4 d3 d2 d1 d0
|
||||||
2 0 dx5 dx4 dx3 dx2 dx1 dx0
|
2 0 dx5 dx4 dx3 dx2 dx1 dx0
|
||||||
3 0 dy5 dy4 dy3 dy2 dy1 dy0
|
3 0 dy5 dy4 dy3 dy2 dy1 dy0
|
||||||
.TE
|
.TE
|
||||||
.SS "3-button Microsoft protocol"
|
.SS 3-button Microsoft protocol
|
||||||
Original Microsoft mice only have two buttons.
|
Original Microsoft mice only have two buttons.
|
||||||
However, there are some
|
However, there are some
|
||||||
three button mice which also use the Microsoft protocol.
|
three button mice which also use the Microsoft protocol.
|
||||||
|
@ -93,7 +93,7 @@ releasing the middle button is reported by sending a packet with zero
|
||||||
movement and no buttons pressed.
|
movement and no buttons pressed.
|
||||||
(Thus, unlike for the other two buttons, the status of the middle
|
(Thus, unlike for the other two buttons, the status of the middle
|
||||||
button is not reported in each packet.)
|
button is not reported in each packet.)
|
||||||
.SS "Logitech protocol"
|
.SS Logitech protocol
|
||||||
Logitech serial 3-button mice use a different extension of the
|
Logitech serial 3-button mice use a different extension of the
|
||||||
Microsoft protocol: when the middle button is up, the above 3-byte
|
Microsoft protocol: when the middle button is up, the above 3-byte
|
||||||
packet is sent.
|
packet is sent.
|
||||||
|
@ -102,7 +102,7 @@ sent, where the 4th byte has value 0x20 (or at least has the 0x20
|
||||||
bit set).
|
bit set).
|
||||||
In particular, a press of the middle button is reported
|
In particular, a press of the middle button is reported
|
||||||
as 0,0,0,0x20 when no other buttons are down.
|
as 0,0,0,0x20 when no other buttons are down.
|
||||||
.SS "Mousesystems protocol"
|
.SS Mousesystems protocol
|
||||||
The \fBMousesystems\fP protocol uses 1 start bit, 8 data bits, no parity
|
The \fBMousesystems\fP protocol uses 1 start bit, 8 data bits, no parity
|
||||||
and two stop bits at the speed of 1200 bits/sec.
|
and two stop bits at the speed of 1200 bits/sec.
|
||||||
Data is sent to RxD in
|
Data is sent to RxD in
|
||||||
|
@ -125,10 +125,10 @@ byte d7 d6 d5 d4 d3 d2 d1 d0
|
||||||
|
|
||||||
Bytes 4 and 5 describe the change that occurred since bytes 2 and 3
|
Bytes 4 and 5 describe the change that occurred since bytes 2 and 3
|
||||||
were transmitted.
|
were transmitted.
|
||||||
.SS "Sun protocol"
|
.SS Sun protocol
|
||||||
The \fBSun\fP protocol is the 3-byte version of the above 5-byte
|
The \fBSun\fP protocol is the 3-byte version of the above 5-byte
|
||||||
Mousesystems protocol: the last two bytes are not sent.
|
Mousesystems protocol: the last two bytes are not sent.
|
||||||
.SS "MM protocol"
|
.SS MM protocol
|
||||||
The \fBMM\fP protocol uses 1 start bit, 8 data bits, odd parity and one
|
The \fBMM\fP protocol uses 1 start bit, 8 data bits, odd parity and one
|
||||||
stop bit at the speed of 1200 bits/sec.
|
stop bit at the speed of 1200 bits/sec.
|
||||||
Data is sent to RxD in 3-byte
|
Data is sent to RxD in 3-byte
|
||||||
|
|
|
@ -150,7 +150,7 @@ run during the Linux system shutdown:
|
||||||
[ \-r $poolfile ] && bytes=\`cat $poolfile\` || bytes=512
|
[ \-r $poolfile ] && bytes=\`cat $poolfile\` || bytes=512
|
||||||
dd if=/dev/urandom of=$random_seed count=1 bs=$bytes
|
dd if=/dev/urandom of=$random_seed count=1 bs=$bytes
|
||||||
.fi
|
.fi
|
||||||
.SS "/proc Interface"
|
.SS /proc Interface
|
||||||
The files in the directory
|
The files in the directory
|
||||||
.I /proc/sys/kernel/random
|
.I /proc/sys/kernel/random
|
||||||
(present since 2.3.16) provide an additional interface to the
|
(present since 2.3.16) provide an additional interface to the
|
||||||
|
|
|
@ -170,7 +170,7 @@ on the system.
|
||||||
Starting from kernel 2.6.2, the driver exports in the sysfs directory
|
Starting from kernel 2.6.2, the driver exports in the sysfs directory
|
||||||
.I /sys/class/scsi_tape
|
.I /sys/class/scsi_tape
|
||||||
the attached devices and some parameters assigned to the devices.
|
the attached devices and some parameters assigned to the devices.
|
||||||
.SS "Data transfer"
|
.SS Data transfer
|
||||||
The driver supports operation in both fixed-block mode and
|
The driver supports operation in both fixed-block mode and
|
||||||
variable-block mode (if supported by the drive).
|
variable-block mode (if supported by the drive).
|
||||||
In fixed-block mode the drive
|
In fixed-block mode the drive
|
||||||
|
@ -236,7 +236,7 @@ driver are passed to the
|
||||||
driver.
|
driver.
|
||||||
The definitions below are from
|
The definitions below are from
|
||||||
.IR /usr/include/linux/mtio.h :
|
.IR /usr/include/linux/mtio.h :
|
||||||
.SS "MTIOCTOP \(em perform a tape operation"
|
.SS MTIOCTOP \(em perform a tape operation
|
||||||
.PP
|
.PP
|
||||||
This request takes an argument of type
|
This request takes an argument of type
|
||||||
.IR "(struct mtop *)" .
|
.IR "(struct mtop *)" .
|
||||||
|
@ -678,7 +678,7 @@ If the bit pattern is zero, one or more bits under the mask indicate
|
||||||
the cleaning request.
|
the cleaning request.
|
||||||
If the pattern is nonzero, the pattern must match
|
If the pattern is nonzero, the pattern must match
|
||||||
the masked sense data byte.
|
the masked sense data byte.
|
||||||
.SS "MTIOCGET \(em get status"
|
.SS MTIOCGET \(em get status
|
||||||
.PP
|
.PP
|
||||||
This request takes an argument of type
|
This request takes an argument of type
|
||||||
.IR "(struct mtget *)" .
|
.IR "(struct mtget *)" .
|
||||||
|
@ -800,7 +800,7 @@ This value is set to \-1 when the block number is unknown (e.g., after
|
||||||
.BR MTBSS ,
|
.BR MTBSS ,
|
||||||
or
|
or
|
||||||
.BR MTSEEK ).
|
.BR MTSEEK ).
|
||||||
.SS "MTIOCPOS \(em get tape position"
|
.SS MTIOCPOS \(em get tape position
|
||||||
.PP
|
.PP
|
||||||
This request takes an argument of type
|
This request takes an argument of type
|
||||||
.I "(struct mtpos *)"
|
.I "(struct mtpos *)"
|
||||||
|
|
|
@ -22,7 +22,7 @@ makes for nonportable programs.
|
||||||
Use the POSIX interface described in
|
Use the POSIX interface described in
|
||||||
.BR termios (3)
|
.BR termios (3)
|
||||||
whenever possible.
|
whenever possible.
|
||||||
.SS "Get and set terminal attributes"
|
.SS Get and set terminal attributes
|
||||||
.TP
|
.TP
|
||||||
.BI "TCGETS struct termios *" argp
|
.BI "TCGETS struct termios *" argp
|
||||||
Equivalent to
|
Equivalent to
|
||||||
|
@ -67,7 +67,7 @@ instead of a
|
||||||
.BI "TCSETAW const struct termio *" argp
|
.BI "TCSETAW const struct termio *" argp
|
||||||
.TP
|
.TP
|
||||||
.BI "TCSETAF const struct termio *" argp
|
.BI "TCSETAF const struct termio *" argp
|
||||||
.SS "Locking the termios structure"
|
.SS Locking the termios structure
|
||||||
The
|
The
|
||||||
.I termios
|
.I termios
|
||||||
structure of a terminal can be locked.
|
structure of a terminal can be locked.
|
||||||
|
@ -88,7 +88,7 @@ structure of the terminal.
|
||||||
Only root (more precisely: a process with the
|
Only root (more precisely: a process with the
|
||||||
.BR CAP_SYS_ADMIN
|
.BR CAP_SYS_ADMIN
|
||||||
capability) can do this.
|
capability) can do this.
|
||||||
.SS "Get and set window size"
|
.SS Get and set window size
|
||||||
Window sizes are kept in the kernel, but not used by the kernel
|
Window sizes are kept in the kernel, but not used by the kernel
|
||||||
(except in the case of virtual consoles, where the kernel will
|
(except in the case of virtual consoles, where the kernel will
|
||||||
update the window size when the size of the virtual console changes,
|
update the window size when the size of the virtual console changes,
|
||||||
|
@ -120,7 +120,7 @@ When the window size changes, a
|
||||||
.B SIGWINCH
|
.B SIGWINCH
|
||||||
signal is sent to the
|
signal is sent to the
|
||||||
foreground process group.
|
foreground process group.
|
||||||
.SS "Sending a break"
|
.SS Sending a break
|
||||||
.TP
|
.TP
|
||||||
.BI "TCSBRK int " arg
|
.BI "TCSBRK int " arg
|
||||||
Equivalent to
|
Equivalent to
|
||||||
|
@ -168,7 +168,7 @@ Turn break on, that is, start sending zero bits.
|
||||||
.TP
|
.TP
|
||||||
.B "TIOCCBRK void"
|
.B "TIOCCBRK void"
|
||||||
Turn break off, that is, stop sending zero bits.
|
Turn break off, that is, stop sending zero bits.
|
||||||
.SS "Software flow control"
|
.SS Software flow control
|
||||||
.TP
|
.TP
|
||||||
.BI "TCXONC int " arg
|
.BI "TCXONC int " arg
|
||||||
Equivalent to
|
Equivalent to
|
||||||
|
@ -181,7 +181,7 @@ for the argument values
|
||||||
.BR TCOON ,
|
.BR TCOON ,
|
||||||
.BR TCIOFF ,
|
.BR TCIOFF ,
|
||||||
.BR TCION .
|
.BR TCION .
|
||||||
.SS "Buffer count and flushing"
|
.SS Buffer count and flushing
|
||||||
.TP
|
.TP
|
||||||
.BI "FIONREAD int *" argp
|
.BI "FIONREAD int *" argp
|
||||||
Get the number of bytes in the input buffer.
|
Get the number of bytes in the input buffer.
|
||||||
|
@ -203,11 +203,11 @@ for the argument values
|
||||||
.BR TCIFLUSH ,
|
.BR TCIFLUSH ,
|
||||||
.BR TCOFLUSH ,
|
.BR TCOFLUSH ,
|
||||||
.BR TCIOFLUSH .
|
.BR TCIOFLUSH .
|
||||||
.SS "Faking input"
|
.SS Faking input
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCSTI const char *" argp
|
.BI "TIOCSTI const char *" argp
|
||||||
Insert the given byte in the input queue.
|
Insert the given byte in the input queue.
|
||||||
.SS "Redirecting console output"
|
.SS Redirecting console output
|
||||||
.TP
|
.TP
|
||||||
.B "TIOCCONS void"
|
.B "TIOCCONS void"
|
||||||
Redirect output that would have gone to
|
Redirect output that would have gone to
|
||||||
|
@ -230,7 +230,7 @@ pointing at
|
||||||
.I /dev/console
|
.I /dev/console
|
||||||
or
|
or
|
||||||
.IR /dev/tty0 .
|
.IR /dev/tty0 .
|
||||||
.SS "Controlling terminal"
|
.SS Controlling terminal
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCSCTTY int " arg
|
.BI "TIOCSCTTY int " arg
|
||||||
Make the given terminal the controlling terminal of the calling process.
|
Make the given terminal the controlling terminal of the calling process.
|
||||||
|
@ -256,7 +256,7 @@ and
|
||||||
.B SIGCONT
|
.B SIGCONT
|
||||||
to the foreground process group
|
to the foreground process group
|
||||||
and all processes in the current session lose their controlling terminal.
|
and all processes in the current session lose their controlling terminal.
|
||||||
.SS "Process group and session ID"
|
.SS Process group and session ID
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCGPGRP pid_t *" argp
|
.BI "TIOCGPGRP pid_t *" argp
|
||||||
When successful, equivalent to
|
When successful, equivalent to
|
||||||
|
@ -277,7 +277,7 @@ This will fail with
|
||||||
in case the terminal is not a master pseudoterminal
|
in case the terminal is not a master pseudoterminal
|
||||||
and not our controlling terminal.
|
and not our controlling terminal.
|
||||||
Strange.
|
Strange.
|
||||||
.SS "Exclusive mode"
|
.SS Exclusive mode
|
||||||
.TP
|
.TP
|
||||||
.B "TIOCEXCL void"
|
.B "TIOCEXCL void"
|
||||||
Put the terminal into exclusive mode.
|
Put the terminal into exclusive mode.
|
||||||
|
@ -292,14 +292,14 @@ capability.)
|
||||||
.TP
|
.TP
|
||||||
.B "TIOCNXCL void"
|
.B "TIOCNXCL void"
|
||||||
Disable exclusive mode.
|
Disable exclusive mode.
|
||||||
.SS "Line discipline"
|
.SS Line discipline
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCGETD int *" argp
|
.BI "TIOCGETD int *" argp
|
||||||
Get the line discipline of the terminal.
|
Get the line discipline of the terminal.
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCSETD const int *" argp
|
.BI "TIOCSETD const int *" argp
|
||||||
Set the line discipline of the terminal.
|
Set the line discipline of the terminal.
|
||||||
.SS "Pseudoterminal ioctls"
|
.SS Pseudoterminal ioctls
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCPKT const int *" argp
|
.BI "TIOCPKT const int *" argp
|
||||||
Enable (when
|
Enable (when
|
||||||
|
@ -346,7 +346,7 @@ The BSD ioctls
|
||||||
.BR TIOCUCNTL ,
|
.BR TIOCUCNTL ,
|
||||||
.B TIOCREMOTE
|
.B TIOCREMOTE
|
||||||
have not been implemented under Linux.
|
have not been implemented under Linux.
|
||||||
.SS "Modem control"
|
.SS Modem control
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCMGET int *" argp
|
.BI "TIOCMGET int *" argp
|
||||||
get the status of modem bits.
|
get the status of modem bits.
|
||||||
|
@ -375,7 +375,7 @@ TIOCM_RNG RNG (ring)
|
||||||
TIOCM_RI see TIOCM_RNG
|
TIOCM_RI see TIOCM_RNG
|
||||||
TIOCM_DSR DSR (data set ready)
|
TIOCM_DSR DSR (data set ready)
|
||||||
.fi
|
.fi
|
||||||
.SS "Marking a line as local"
|
.SS Marking a line as local
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCGSOFTCAR int *" argp
|
.BI "TIOCGSOFTCAR int *" argp
|
||||||
("Get software carrier flag")
|
("Get software carrier flag")
|
||||||
|
@ -405,12 +405,12 @@ If
|
||||||
is set, the line behaves as if DCD is always asserted.
|
is set, the line behaves as if DCD is always asserted.
|
||||||
The software carrier flag is usually turned on for local devices,
|
The software carrier flag is usually turned on for local devices,
|
||||||
and is off for lines with modems.
|
and is off for lines with modems.
|
||||||
.SS "Linux-specific"
|
.SS Linux-specific
|
||||||
For the
|
For the
|
||||||
.B TIOCLINUX
|
.B TIOCLINUX
|
||||||
ioctl, see
|
ioctl, see
|
||||||
.BR console_ioctl (4).
|
.BR console_ioctl (4).
|
||||||
.SS "Kernel debugging"
|
.SS Kernel debugging
|
||||||
.B "#include <linux/tty.h>"
|
.B "#include <linux/tty.h>"
|
||||||
.TP
|
.TP
|
||||||
.BI "TIOCTTYGSTRUCT struct tty_struct *" argp
|
.BI "TIOCTTYGSTRUCT struct tty_struct *" argp
|
||||||
|
|
|
@ -52,7 +52,7 @@ saved in permanent storage for future use).
|
||||||
Set the list of name to be used for each wavelan cards device (name
|
Set the list of name to be used for each wavelan cards device (name
|
||||||
used by
|
used by
|
||||||
.BR ifconfig (8)).
|
.BR ifconfig (8)).
|
||||||
.SS "Wireless extensions"
|
.SS Wireless extensions
|
||||||
Use
|
Use
|
||||||
.BR iwconfig (8)
|
.BR iwconfig (8)
|
||||||
to manipulate wireless extensions.
|
to manipulate wireless extensions.
|
||||||
|
@ -95,7 +95,7 @@ The
|
||||||
and
|
and
|
||||||
.I misc discarded packet
|
.I misc discarded packet
|
||||||
counters are not implemented.
|
counters are not implemented.
|
||||||
.SS "Private ioctl"
|
.SS Private ioctl
|
||||||
You may use
|
You may use
|
||||||
.BR iwpriv (8)
|
.BR iwpriv (8)
|
||||||
to manipulate private ioctls.
|
to manipulate private ioctls.
|
||||||
|
@ -109,7 +109,7 @@ to count the number of packets received in each of those defined
|
||||||
intervals.
|
intervals.
|
||||||
This distribution might be used to calculate the mean value
|
This distribution might be used to calculate the mean value
|
||||||
and standard deviation of the signal level.
|
and standard deviation of the signal level.
|
||||||
.SS "Specific notes"
|
.SS Specific notes
|
||||||
This driver will fail to detect some
|
This driver will fail to detect some
|
||||||
.B non-NCR/ATT&T/Lucent
|
.B non-NCR/ATT&T/Lucent
|
||||||
Wavelan cards.
|
Wavelan cards.
|
||||||
|
|
|
@ -88,7 +88,7 @@ multibyte-characters, which are currently not implemented.
|
||||||
.PP
|
.PP
|
||||||
The last line in a charmap-definition file must contain
|
The last line in a charmap-definition file must contain
|
||||||
.B END CHARMAP.
|
.B END CHARMAP.
|
||||||
.SS "Symbolic names"
|
.SS Symbolic names
|
||||||
A
|
A
|
||||||
.B symbolic name
|
.B symbolic name
|
||||||
for a character contains only characters of the
|
for a character contains only characters of the
|
||||||
|
@ -101,7 +101,7 @@ are interpreted as itself; for example, the sequence
|
||||||
represents the symbolic name
|
represents the symbolic name
|
||||||
.B "\\\\>"
|
.B "\\\\>"
|
||||||
enclosed in angle brackets.
|
enclosed in angle brackets.
|
||||||
.SS "Character encoding"
|
.SS Character encoding
|
||||||
The
|
The
|
||||||
encoding may be in each of the following three forms:
|
encoding may be in each of the following three forms:
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -178,7 +178,7 @@ for
|
||||||
.B emacs
|
.B emacs
|
||||||
backup files.
|
backup files.
|
||||||
This form should be considered obsolete.
|
This form should be considered obsolete.
|
||||||
.SS "ISO 6429 (ANSI) color sequences"
|
.SS ISO 6429 (ANSI) color sequences
|
||||||
Most color-capable ASCII terminals today use ISO 6429 (ANSI) color sequences,
|
Most color-capable ASCII terminals today use ISO 6429 (ANSI) color sequences,
|
||||||
and many common terminals without color capability, including
|
and many common terminals without color capability, including
|
||||||
.B xterm
|
.B xterm
|
||||||
|
@ -248,7 +248,7 @@ and
|
||||||
.B FILE
|
.B FILE
|
||||||
codes to the numerical codes for your normal foreground and background
|
codes to the numerical codes for your normal foreground and background
|
||||||
colors.
|
colors.
|
||||||
.SS "Other terminal types (advanced configuration)"
|
.SS Other terminal types (advanced configuration)
|
||||||
If you have a color-capable (or otherwise highlighting) terminal (or
|
If you have a color-capable (or otherwise highlighting) terminal (or
|
||||||
printer!) which uses a different set of codes, you can still generate
|
printer!) which uses a different set of codes, you can still generate
|
||||||
a suitable setup.
|
a suitable setup.
|
||||||
|
@ -294,7 +294,7 @@ definition will have no effect.
|
||||||
A different
|
A different
|
||||||
.B ENDCODE
|
.B ENDCODE
|
||||||
can, however, be specified, which would have the same effect.
|
can, however, be specified, which would have the same effect.
|
||||||
.SS "Escape sequences"
|
.SS Escape sequences
|
||||||
To specify control- or blank characters in the color sequences or
|
To specify control- or blank characters in the color sequences or
|
||||||
filename extensions, either C-style \e-escaped notation or
|
filename extensions, either C-style \e-escaped notation or
|
||||||
.BR stty \-style
|
.BR stty \-style
|
||||||
|
|
|
@ -88,7 +88,7 @@ advantage.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
Modifications to this file normally take effect immediately,
|
Modifications to this file normally take effect immediately,
|
||||||
except in cases where the file is cached by applications.
|
except in cases where the file is cached by applications.
|
||||||
.SS "Historical notes"
|
.SS Historical notes
|
||||||
RFC\ 952 gave the original format for the host table, though it has
|
RFC\ 952 gave the original format for the host table, though it has
|
||||||
since changed.
|
since changed.
|
||||||
|
|
||||||
|
|
|
@ -92,7 +92,7 @@ Boolean: :bs:\e
|
||||||
Numeric: :co#80:\e
|
Numeric: :co#80:\e
|
||||||
String: :sr=\eE[H:\e
|
String: :sr=\eE[H:\e
|
||||||
.fi
|
.fi
|
||||||
.SS "Boolean capabilities"
|
.SS Boolean capabilities
|
||||||
.nf
|
.nf
|
||||||
5i Printer will not echo on screen
|
5i Printer will not echo on screen
|
||||||
am Automatic margins which means automatic line wrap
|
am Automatic margins which means automatic line wrap
|
||||||
|
@ -122,7 +122,7 @@ xo Terminal uses xon/xoff protocol
|
||||||
xs Text typed over standout text will be displayed in standout
|
xs Text typed over standout text will be displayed in standout
|
||||||
xt Teleray glitch, destructive tabs and odd standout mode
|
xt Teleray glitch, destructive tabs and odd standout mode
|
||||||
.fi
|
.fi
|
||||||
.SS "Numeric capabilities"
|
.SS Numeric capabilities
|
||||||
.nf
|
.nf
|
||||||
co Number of columns
|
co Number of columns
|
||||||
dB Delay in milliseconds for backspace on hardcopy terminals
|
dB Delay in milliseconds for backspace on hardcopy terminals
|
||||||
|
@ -144,7 +144,7 @@ ug Underline glitch
|
||||||
vt virtual terminal number
|
vt virtual terminal number
|
||||||
ws Width of status line if different from screen width
|
ws Width of status line if different from screen width
|
||||||
.fi
|
.fi
|
||||||
.SS "String capabilities"
|
.SS String capabilities
|
||||||
.nf
|
.nf
|
||||||
!1 shifted save key
|
!1 shifted save key
|
||||||
!2 shifted suspend key
|
!2 shifted suspend key
|
||||||
|
|
|
@ -30,7 +30,7 @@ hexadecimal
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The Armenian Standard Code for Information Interchange,
|
The Armenian Standard Code for Information Interchange,
|
||||||
8-bit coded character set.
|
8-bit coded character set.
|
||||||
.SS "ArmSCII-8 characters"
|
.SS ArmSCII-8 characters
|
||||||
The following table displays the characters in ArmSCII-8, which
|
The following table displays the characters in ArmSCII-8, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
14
man7/boot.7
14
man7/boot.7
|
@ -20,7 +20,7 @@ but can be roughly divided to the following steps:
|
||||||
(iii) kernel startup, (iv) init and inittab,
|
(iii) kernel startup, (iv) init and inittab,
|
||||||
(v) boot scripts.
|
(v) boot scripts.
|
||||||
We will describe each of these in more detail below.
|
We will describe each of these in more detail below.
|
||||||
.SS "Hardware-boot"
|
.SS Hardware-boot
|
||||||
After power-on or hard reset, control is given
|
After power-on or hard reset, control is given
|
||||||
to a program stored on read-only memory (normally
|
to a program stored on read-only memory (normally
|
||||||
PROM).
|
PROM).
|
||||||
|
@ -49,7 +49,7 @@ We do not cover here booting from network.
|
||||||
Those who want
|
Those who want
|
||||||
to investigate this subject may want to research:
|
to investigate this subject may want to research:
|
||||||
DHCP, TFTP, PXE, Etherboot.
|
DHCP, TFTP, PXE, Etherboot.
|
||||||
.SS "OS loader"
|
.SS OS loader
|
||||||
In PC, the OS loader is located in the first sector
|
In PC, the OS loader is located in the first sector
|
||||||
of the boot device \- this is the \fBMBR\fR
|
of the boot device \- this is the \fBMBR\fR
|
||||||
(Master Boot Record).
|
(Master Boot Record).
|
||||||
|
@ -83,7 +83,7 @@ interactive use, to enable specification of alternative
|
||||||
kernel (maybe a backup in case the last compiled one
|
kernel (maybe a backup in case the last compiled one
|
||||||
isn't functioning) and to pass optional parameters
|
isn't functioning) and to pass optional parameters
|
||||||
to the kernel.
|
to the kernel.
|
||||||
.SS "Kernel startup"
|
.SS Kernel startup
|
||||||
When the kernel is loaded, it initializes the devices (via
|
When the kernel is loaded, it initializes the devices (via
|
||||||
their drivers), starts the swapper (it is a "kernel process",
|
their drivers), starts the swapper (it is a "kernel process",
|
||||||
called kswapd in modern Linux kernels), and mounts the root
|
called kswapd in modern Linux kernels), and mounts the root
|
||||||
|
@ -102,7 +102,7 @@ This process executes the
|
||||||
program
|
program
|
||||||
.IR /sbin/init ,
|
.IR /sbin/init ,
|
||||||
passing any parameters that weren't handled by the kernel already.
|
passing any parameters that weren't handled by the kernel already.
|
||||||
.SS "init and inittab"
|
.SS init and inittab
|
||||||
When init starts it reads
|
When init starts it reads
|
||||||
.I /etc/inittab
|
.I /etc/inittab
|
||||||
for further instructions.
|
for further instructions.
|
||||||
|
@ -121,7 +121,7 @@ and query the current run-level via
|
||||||
However, since it is not convenient to manage individual services
|
However, since it is not convenient to manage individual services
|
||||||
by editing this file, inittab only bootstraps a set of scripts
|
by editing this file, inittab only bootstraps a set of scripts
|
||||||
that actually start/stop the individual services.
|
that actually start/stop the individual services.
|
||||||
.SS "Boot scripts"
|
.SS Boot scripts
|
||||||
.TP
|
.TP
|
||||||
Note:
|
Note:
|
||||||
The following description applies to System V release 4-based systems, which
|
The following description applies to System V release 4-based systems, which
|
||||||
|
@ -143,7 +143,7 @@ accept other "convenience" parameters (e.g: "restart", to stop and then
|
||||||
start, "status" do display the service status).
|
start, "status" do display the service status).
|
||||||
Running the script
|
Running the script
|
||||||
without parameters displays the possible arguments.
|
without parameters displays the possible arguments.
|
||||||
.SS "Sequencing directories"
|
.SS Sequencing directories
|
||||||
To make specific scripts start/stop at specific run-levels and in
|
To make specific scripts start/stop at specific run-levels and in
|
||||||
specific order, there are \fIsequencing directories\fR.
|
specific order, there are \fIsequencing directories\fR.
|
||||||
These
|
These
|
||||||
|
@ -175,7 +175,7 @@ To manage the boot order and run-levels, we have to manage these links.
|
||||||
However, on many versions of Linux, there are tools to help with this task
|
However, on many versions of Linux, there are tools to help with this task
|
||||||
(e.g:
|
(e.g:
|
||||||
.BR chkconfig (8)).
|
.BR chkconfig (8)).
|
||||||
.SS "Boot configuration"
|
.SS Boot configuration
|
||||||
Usually the daemons started may optionally receive command-line options
|
Usually the daemons started may optionally receive command-line options
|
||||||
and parameters.
|
and parameters.
|
||||||
To allow system administrators to change these
|
To allow system administrators to change these
|
||||||
|
|
|
@ -70,7 +70,7 @@ into a SB compatible mode.
|
||||||
Booting DOS with the supplied driver, and
|
Booting DOS with the supplied driver, and
|
||||||
then loading Linux from the DOS prompt with loadlin avoids the reset
|
then loading Linux from the DOS prompt with loadlin avoids the reset
|
||||||
of the card that happens if one rebooted instead.
|
of the card that happens if one rebooted instead.
|
||||||
.SS "The argument list"
|
.SS The argument list
|
||||||
The kernel command line is parsed into a list of strings
|
The kernel command line is parsed into a list of strings
|
||||||
(boot arguments) separated by spaces.
|
(boot arguments) separated by spaces.
|
||||||
Most of the boot args take the form of:
|
Most of the boot args take the form of:
|
||||||
|
@ -117,7 +117,7 @@ to boot the computer in single user mode, and not launch all the usual
|
||||||
daemons.
|
daemons.
|
||||||
Check the manual page for the version of init installed on
|
Check the manual page for the version of init installed on
|
||||||
your system to see what arguments it accepts.
|
your system to see what arguments it accepts.
|
||||||
.SS "General non-device specific boot arguments"
|
.SS General non-device specific boot arguments
|
||||||
.TP
|
.TP
|
||||||
.B "'init=...'"
|
.B "'init=...'"
|
||||||
This sets the initial command to be executed by the kernel.
|
This sets the initial command to be executed by the kernel.
|
||||||
|
@ -308,7 +308,7 @@ instead jump through the BIOS.
|
||||||
A command-line option of 'nosmp' or 'maxcpus=0' will disable SMP
|
A command-line option of 'nosmp' or 'maxcpus=0' will disable SMP
|
||||||
activation entirely; an option 'maxcpus=N' limits the maximum number
|
activation entirely; an option 'maxcpus=N' limits the maximum number
|
||||||
of CPUs activated in SMP mode to N.
|
of CPUs activated in SMP mode to N.
|
||||||
.SS "Boot arguments for use by kernel developers"
|
.SS Boot arguments for use by kernel developers
|
||||||
.TP
|
.TP
|
||||||
.B "'debug'"
|
.B "'debug'"
|
||||||
Kernel messages are handed off to the kernel log daemon klogd so that they
|
Kernel messages are handed off to the kernel log daemon klogd so that they
|
||||||
|
@ -364,7 +364,7 @@ Set the six parameters max_buff_age, buff_advance, buff_decline,
|
||||||
buff_initial_age, bufferout_weight, buffermem_grace that control
|
buff_initial_age, bufferout_weight, buffermem_grace that control
|
||||||
kernel buffer memory management.
|
kernel buffer memory management.
|
||||||
For kernel tuners only.
|
For kernel tuners only.
|
||||||
.SS "Boot arguments for ramdisk use"
|
.SS Boot arguments for ramdisk use
|
||||||
(Only if the kernel was compiled with
|
(Only if the kernel was compiled with
|
||||||
.BR CONFIG_BLK_DEV_RAM .)
|
.BR CONFIG_BLK_DEV_RAM .)
|
||||||
In general it is a bad idea to use a ramdisk under Linux\(emthe
|
In general it is a bad idea to use a ramdisk under Linux\(emthe
|
||||||
|
@ -433,7 +433,7 @@ leave the initrd data under
|
||||||
(This device can be used only once: the data is freed as soon as
|
(This device can be used only once: the data is freed as soon as
|
||||||
the last process that used it has closed
|
the last process that used it has closed
|
||||||
.IR /dev/initrd .)
|
.IR /dev/initrd .)
|
||||||
.SS "Boot arguments for SCSI devices"
|
.SS Boot arguments for SCSI devices
|
||||||
General notation for this section:
|
General notation for this section:
|
||||||
|
|
||||||
.I iobase
|
.I iobase
|
||||||
|
@ -760,7 +760,7 @@ nosync:bitmask, nodma:x, period:ns, disconnect:x, debug:x,
|
||||||
clock:x, next.
|
clock:x, next.
|
||||||
For details, see
|
For details, see
|
||||||
.IR /usr/src/linux/drivers/scsi/wd33c93.c .
|
.IR /usr/src/linux/drivers/scsi/wd33c93.c .
|
||||||
.SS "Hard disks"
|
.SS Hard disks
|
||||||
.TP
|
.TP
|
||||||
.B "IDE Disk/CD-ROM Driver Parameters"
|
.B "IDE Disk/CD-ROM Driver Parameters"
|
||||||
The IDE driver accepts a number of parameters, which range from disk
|
The IDE driver accepts a number of parameters, which range from disk
|
||||||
|
@ -876,7 +876,7 @@ xd=2,5,0x320,3
|
||||||
.B "Syquest's EZ* removable disks"
|
.B "Syquest's EZ* removable disks"
|
||||||
.IP
|
.IP
|
||||||
.BI ez= iobase[,irq[,rep[,nybble]]]
|
.BI ez= iobase[,irq[,rep[,nybble]]]
|
||||||
.SS "IBM MCA bus devices"
|
.SS IBM MCA bus devices
|
||||||
See also
|
See also
|
||||||
.IR /usr/src/linux/Documentation/mca.txt .
|
.IR /usr/src/linux/Documentation/mca.txt .
|
||||||
.TP
|
.TP
|
||||||
|
@ -1010,7 +1010,7 @@ where type is one of the following (case sensitive) strings:
|
||||||
\&'SoundBlaster', 'LaserMate', or 'SPEA'.
|
\&'SoundBlaster', 'LaserMate', or 'SPEA'.
|
||||||
The I/O base is that of the
|
The I/O base is that of the
|
||||||
CD-ROM interface, and not that of the sound portion of the card.
|
CD-ROM interface, and not that of the sound portion of the card.
|
||||||
.SS "Ethernet devices"
|
.SS Ethernet devices
|
||||||
Different drivers make use of different parameters, but they all at
|
Different drivers make use of different parameters, but they all at
|
||||||
least share having an IRQ, an I/O port base value, and a name.
|
least share having an IRQ, an I/O port base value, and a name.
|
||||||
In its most generic form, it looks something like this:
|
In its most generic form, it looks something like this:
|
||||||
|
@ -1038,7 +1038,7 @@ cards and on the card/driver-specific implementation
|
||||||
of the param_n values where used.
|
of the param_n values where used.
|
||||||
Interested readers should refer to
|
Interested readers should refer to
|
||||||
the section in that document on their particular card.
|
the section in that document on their particular card.
|
||||||
.SS "The floppy disk driver"
|
.SS The floppy disk driver
|
||||||
There are many floppy driver options, and they are all listed in
|
There are many floppy driver options, and they are all listed in
|
||||||
.I Documentation/floppy.txt
|
.I Documentation/floppy.txt
|
||||||
(or
|
(or
|
||||||
|
@ -1116,7 +1116,7 @@ This is needed on IBM L40SX laptops in certain video modes.
|
||||||
be an interaction between video and floppy.
|
be an interaction between video and floppy.
|
||||||
The unexpected interrupts
|
The unexpected interrupts
|
||||||
only affect performance, and can safely be ignored.)
|
only affect performance, and can safely be ignored.)
|
||||||
.SS "The sound driver"
|
.SS The sound driver
|
||||||
The sound driver can also accept boot args to override the compiled in
|
The sound driver can also accept boot args to override the compiled in
|
||||||
values.
|
values.
|
||||||
This is not recommended, as it is rather complex.
|
This is not recommended, as it is rather complex.
|
||||||
|
@ -1145,7 +1145,7 @@ As you can see it gets pretty messy, and you are better off to compile
|
||||||
in your own personal values as recommended.
|
in your own personal values as recommended.
|
||||||
Using a boot arg of
|
Using a boot arg of
|
||||||
\&'sound=0' will disable the sound driver entirely.
|
\&'sound=0' will disable the sound driver entirely.
|
||||||
.SS "ISDN drivers"
|
.SS ISDN drivers
|
||||||
.TP
|
.TP
|
||||||
.B "The ICN ISDN driver"
|
.B "The ICN ISDN driver"
|
||||||
Syntax:
|
Syntax:
|
||||||
|
@ -1173,7 +1173,7 @@ teles=iobase,irq,membase,protocol,teles_id
|
||||||
where iobase is the i/o port address of the card, membase is the
|
where iobase is the i/o port address of the card, membase is the
|
||||||
shared memory base address of the card, irq is the interrupt channel
|
shared memory base address of the card, irq is the interrupt channel
|
||||||
the card uses, and teles_id is the unique ASCII string identifier.
|
the card uses, and teles_id is the unique ASCII string identifier.
|
||||||
.SS "Serial port drivers"
|
.SS Serial port drivers
|
||||||
.TP
|
.TP
|
||||||
.B "The RISCom/8 Multiport Serial Driver ('riscom8=')"
|
.B "The RISCom/8 Multiport Serial Driver ('riscom8=')"
|
||||||
Syntax:
|
Syntax:
|
||||||
|
@ -1235,7 +1235,7 @@ the dummy 0 is required because of a bug in the setup code.
|
||||||
The mode parameter is a string with syntax hw:modem,
|
The mode parameter is a string with syntax hw:modem,
|
||||||
where hw is one of sbc, wss, wssfdx and modem is one of
|
where hw is one of sbc, wss, wssfdx and modem is one of
|
||||||
afsk1200, fsk9600.
|
afsk1200, fsk9600.
|
||||||
.SS "The line printer driver"
|
.SS The line printer driver
|
||||||
.TP
|
.TP
|
||||||
.B "'lp='"
|
.B "'lp='"
|
||||||
Syntax:
|
Syntax:
|
||||||
|
@ -1265,7 +1265,7 @@ lp=0.
|
||||||
Syntax:
|
Syntax:
|
||||||
.IP
|
.IP
|
||||||
wdt=io,irq
|
wdt=io,irq
|
||||||
.SS "Mouse drivers"
|
.SS Mouse drivers
|
||||||
.TP
|
.TP
|
||||||
.B "'bmouse=irq'"
|
.B "'bmouse=irq'"
|
||||||
The busmouse driver only accepts one parameter, that being the
|
The busmouse driver only accepts one parameter, that being the
|
||||||
|
@ -1283,7 +1283,7 @@ x-threshold and y-threshold.
|
||||||
Otherwise, the first argument
|
Otherwise, the first argument
|
||||||
is the x-threshold, and the second the y-threshold.
|
is the x-threshold, and the second the y-threshold.
|
||||||
These values must lie between 1 and 20 (inclusive); the default is 2.
|
These values must lie between 1 and 20 (inclusive); the default is 2.
|
||||||
.SS "Video hardware"
|
.SS Video hardware
|
||||||
.TP
|
.TP
|
||||||
.B "'no-scroll'"
|
.B "'no-scroll'"
|
||||||
This option tells the console driver not to use hardware scroll
|
This option tells the console driver not to use hardware scroll
|
||||||
|
|
|
@ -933,7 +933,7 @@ The new permitted set must be a subset of the existing permitted set
|
||||||
that the thread does not currently have).
|
that the thread does not currently have).
|
||||||
.IP 4.
|
.IP 4.
|
||||||
The new effective set must be a subset of the new permitted set.
|
The new effective set must be a subset of the new permitted set.
|
||||||
.SS The """securebits"" flags: establishing a capabilities-only environment
|
.SS The securebits flags: establishing a capabilities-only environment
|
||||||
.\" For some background:
|
.\" For some background:
|
||||||
.\" see http://lwn.net/Articles/280279/ and
|
.\" see http://lwn.net/Articles/280279/ and
|
||||||
.\" http://article.gmane.org/gmane.linux.kernel.lsm/5476/
|
.\" http://article.gmane.org/gmane.linux.kernel.lsm/5476/
|
||||||
|
|
|
@ -295,7 +295,7 @@ At the current time, the console driver does not handle combining
|
||||||
characters.
|
characters.
|
||||||
So Thai, Sioux and any other script needing combining
|
So Thai, Sioux and any other script needing combining
|
||||||
characters can't be handled on the console.
|
characters can't be handled on the console.
|
||||||
.SS "ISO 2022 and ISO 4873"
|
.SS ISO 2022 and ISO 4873
|
||||||
The ISO 2022 and 4873 standards describe a font-control model
|
The ISO 2022 and 4873 standards describe a font-control model
|
||||||
based on VT100 practice.
|
based on VT100 practice.
|
||||||
This model is (partially) supported
|
This model is (partially) supported
|
||||||
|
|
|
@ -57,7 +57,7 @@ Raw sockets may be only opened by a process with effective user ID 0
|
||||||
or when the process has the
|
or when the process has the
|
||||||
.B CAP_NET_RAW
|
.B CAP_NET_RAW
|
||||||
capability.
|
capability.
|
||||||
.SS "Address format"
|
.SS Address format
|
||||||
An Appletalk socket address is defined as a combination of a network number,
|
An Appletalk socket address is defined as a combination of a network number,
|
||||||
a node number, and a port number.
|
a node number, and a port number.
|
||||||
.PP
|
.PP
|
||||||
|
@ -112,7 +112,7 @@ wildcard and also implies \(lqthis node.\(rq The value of
|
||||||
is a link
|
is a link
|
||||||
local broadcast address.
|
local broadcast address.
|
||||||
.\" FIXME this doesn't make sense [johnl]
|
.\" FIXME this doesn't make sense [johnl]
|
||||||
.SS "Socket options"
|
.SS Socket options
|
||||||
No protocol-specific socket options are supported.
|
No protocol-specific socket options are supported.
|
||||||
.SS /proc interfaces
|
.SS /proc interfaces
|
||||||
IP supports a set of
|
IP supports a set of
|
||||||
|
|
|
@ -45,7 +45,7 @@ Processes can share this integer using
|
||||||
.BR mmap (2),
|
.BR mmap (2),
|
||||||
via shared memory segments or because they share memory space,
|
via shared memory segments or because they share memory space,
|
||||||
in which case the application is commonly called multithreaded.
|
in which case the application is commonly called multithreaded.
|
||||||
.SS "Semantics"
|
.SS Semantics
|
||||||
.PP
|
.PP
|
||||||
Any futex operation starts in user space,
|
Any futex operation starts in user space,
|
||||||
but it may necessary to communicate with the kernel using the
|
but it may necessary to communicate with the kernel using the
|
||||||
|
|
|
@ -36,7 +36,7 @@ These days there is also a library routine
|
||||||
that will perform this function for a user program.
|
that will perform this function for a user program.
|
||||||
|
|
||||||
The rules are as follows (POSIX.2, 3.13).
|
The rules are as follows (POSIX.2, 3.13).
|
||||||
.SS "Wildcard matching"
|
.SS Wildcard matching
|
||||||
A string is a wildcard pattern if it contains one of the
|
A string is a wildcard pattern if it contains one of the
|
||||||
characters \(aq?\(aq, \(aq*\(aq or \(aq[\(aq.
|
characters \(aq?\(aq, \(aq*\(aq or \(aq[\(aq.
|
||||||
Globbing is the operation
|
Globbing is the operation
|
||||||
|
@ -99,7 +99,7 @@ If a filename starts with a \(aq.\(aq,
|
||||||
this character must be matched explicitly.
|
this character must be matched explicitly.
|
||||||
(Thus, \fIrm\ *\fP will not remove .profile, and \fItar\ c\ *\fP will not
|
(Thus, \fIrm\ *\fP will not remove .profile, and \fItar\ c\ *\fP will not
|
||||||
archive all your files; \fItar\ c\ .\fP is better.)
|
archive all your files; \fItar\ c\ .\fP is better.)
|
||||||
.SS "Empty lists"
|
.SS Empty lists
|
||||||
The nice and simple rule given above: "expand a wildcard pattern
|
The nice and simple rule given above: "expand a wildcard pattern
|
||||||
into the list of matching pathnames" was the original UNIX
|
into the list of matching pathnames" was the original UNIX
|
||||||
definition.
|
definition.
|
||||||
|
|
|
@ -135,7 +135,7 @@ IPv4 and IPv6 share the local port space.
|
||||||
When you get an IPv4 connection
|
When you get an IPv4 connection
|
||||||
or packet to a IPv6 socket, its source address will be mapped
|
or packet to a IPv6 socket, its source address will be mapped
|
||||||
to v6 and it will be mapped to v6.
|
to v6 and it will be mapped to v6.
|
||||||
.SS "Address format"
|
.SS Address format
|
||||||
.in +4n
|
.in +4n
|
||||||
.nf
|
.nf
|
||||||
struct sockaddr_in6 {
|
struct sockaddr_in6 {
|
||||||
|
@ -185,7 +185,7 @@ Special addresses are ::1 for loopback and ::FFFF:<IPv4 address>
|
||||||
for IPv4-mapped-on-IPv6.
|
for IPv4-mapped-on-IPv6.
|
||||||
.PP
|
.PP
|
||||||
The port space of IPv6 is shared with IPv4.
|
The port space of IPv6 is shared with IPv4.
|
||||||
.SS "Socket options"
|
.SS Socket options
|
||||||
IPv6 supports some protocol-specific socket options that can be set with
|
IPv6 supports some protocol-specific socket options that can be set with
|
||||||
.BR setsockopt (2)
|
.BR setsockopt (2)
|
||||||
and read with
|
and read with
|
||||||
|
|
|
@ -43,7 +43,7 @@ Spanish, and Swedish.
|
||||||
.P
|
.P
|
||||||
Note that the ISO 8859-1 characters are also the first 256 characters
|
Note that the ISO 8859-1 characters are also the first 256 characters
|
||||||
of ISO 10646 (Unicode).
|
of ISO 10646 (Unicode).
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -63,7 +63,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-1 characters"
|
.SS ISO 8859-1 characters
|
||||||
The following table displays the characters in ISO 8859-1 (Latin-1),
|
The following table displays the characters in ISO 8859-1 (Latin-1),
|
||||||
which are printable and unlisted in the
|
which are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -32,7 +32,7 @@ characters used in Nordic languages.
|
||||||
.\" (Though in my system with glibc-2.8-20080929
|
.\" (Though in my system with glibc-2.8-20080929
|
||||||
.\" I found only lg_UG using this charset, and certainly UG
|
.\" I found only lg_UG using this charset, and certainly UG
|
||||||
.\" is not a "Nordic" country!).
|
.\" is not a "Nordic" country!).
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -52,7 +52,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-10 characters"
|
.SS ISO 8859-10 characters
|
||||||
The following table displays the characters in ISO 8859-10, which
|
The following table displays the characters in ISO 8859-10, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -31,7 +31,7 @@ and hexadecimal
|
||||||
The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
||||||
character set (also known as ISO 646-IRV).
|
character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-11 encodes the characters used in the Thai language.
|
ISO 8859-11 encodes the characters used in the Thai language.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -51,7 +51,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-11 characters"
|
.SS ISO 8859-11 characters
|
||||||
The following table displays the characters in ISO 8859-11, which
|
The following table displays the characters in ISO 8859-11, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -30,7 +30,7 @@ character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-13 encodes the characters used in Baltic Rim languages.
|
ISO 8859-13 encodes the characters used in Baltic Rim languages.
|
||||||
.\" In my system with glibc-2.8-20080929 is used for
|
.\" In my system with glibc-2.8-20080929 is used for
|
||||||
.\" Lithuanian, Latvian and the Maori language in New Zealand.
|
.\" Lithuanian, Latvian and the Maori language in New Zealand.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -50,7 +50,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-13 characters"
|
.SS ISO 8859-13 characters
|
||||||
The following table displays the characters in ISO 8859-13, which
|
The following table displays the characters in ISO 8859-13, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -28,7 +28,7 @@ and hexadecimal
|
||||||
The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
||||||
character set (also known as ISO 646-IRV).
|
character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-14 encodes the characters used in Celtic languages.
|
ISO 8859-14 encodes the characters used in Celtic languages.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -48,7 +48,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-14 characters"
|
.SS ISO 8859-14 characters
|
||||||
The following table displays the characters in ISO 8859-14, which
|
The following table displays the characters in ISO 8859-14, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -43,7 +43,7 @@ Catalan, Danish, Dutch, English, Estonian, Faroese, Finnish, French,
|
||||||
Frisian, Galician, German, Greenlandic, Icelandic, Irish Gaelic,
|
Frisian, Galician, German, Greenlandic, Icelandic, Irish Gaelic,
|
||||||
Italian, Latin, Luxemburgish, Norwegian, Portuguese, Rhaeto-Romanic,
|
Italian, Latin, Luxemburgish, Norwegian, Portuguese, Rhaeto-Romanic,
|
||||||
Scottish Gaelic, Spanish, and Swedish.
|
Scottish Gaelic, Spanish, and Swedish.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -63,7 +63,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-15 characters"
|
.SS ISO 8859-15 characters
|
||||||
The following table displays the characters in ISO 8859-15 (Latin-9),
|
The following table displays the characters in ISO 8859-15 (Latin-9),
|
||||||
which are printable and unlisted in the
|
which are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -39,7 +39,7 @@ Romanian, Slovenian and Serbian.
|
||||||
.P
|
.P
|
||||||
Also note that the following Cyrillic-based languages have one-to-one
|
Also note that the following Cyrillic-based languages have one-to-one
|
||||||
transliterations to Latin 10: Macedonian and Serbian.
|
transliterations to Latin 10: Macedonian and Serbian.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -59,7 +59,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-16 characters"
|
.SS ISO 8859-16 characters
|
||||||
The following table displays the characters in ISO 8859-16 (Latin-10),
|
The following table displays the characters in ISO 8859-16 (Latin-10),
|
||||||
which are printable and unlisted in the
|
which are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -42,7 +42,7 @@ Slovak, Slovenian and Sorbian.
|
||||||
.P
|
.P
|
||||||
Also note that the following Cyrillic-based languages have one-to-one
|
Also note that the following Cyrillic-based languages have one-to-one
|
||||||
transliterations to Latin 2: Macedonian and Serbian.
|
transliterations to Latin 2: Macedonian and Serbian.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -62,7 +62,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-2 characters"
|
.SS ISO 8859-2 characters
|
||||||
The following table displays the characters in ISO 8859-2 (Latin-2),
|
The following table displays the characters in ISO 8859-2 (Latin-2),
|
||||||
which are printable and unlisted in the
|
which are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -31,7 +31,7 @@ character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-3 encodes the characters used in Southeast European languages.
|
ISO 8859-3 encodes the characters used in Southeast European languages.
|
||||||
.\" (Though in my system with glibc-2.8-20080929
|
.\" (Though in my system with glibc-2.8-20080929
|
||||||
.\" I found only mt_MT (Malta) using this charset).
|
.\" I found only mt_MT (Malta) using this charset).
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -51,7 +51,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-3 characters"
|
.SS ISO 8859-3 characters
|
||||||
The following table displays the characters in ISO 8859-3, which
|
The following table displays the characters in ISO 8859-3, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -29,7 +29,7 @@ The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
||||||
character set (also known as ISO 646-IRV).
|
character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-4 encodes the characters used in
|
ISO 8859-4 encodes the characters used in
|
||||||
Scandinavian and Baltic languages (Latin-4).
|
Scandinavian and Baltic languages (Latin-4).
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -49,7 +49,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-4 characters"
|
.SS ISO 8859-4 characters
|
||||||
The following table displays the characters in ISO 8859-4, which
|
The following table displays the characters in ISO 8859-4, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -28,7 +28,7 @@ and hexadecimal
|
||||||
The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
||||||
character set (also known as ISO 646-IRV).
|
character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-5 encodes the Cyrillic alphabet as used in Russian and Macedonian.
|
ISO 8859-5 encodes the Cyrillic alphabet as used in Russian and Macedonian.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -48,7 +48,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-5 characters"
|
.SS ISO 8859-5 characters
|
||||||
The following table displays the characters in ISO 8859-5, which
|
The following table displays the characters in ISO 8859-5, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -28,7 +28,7 @@ and hexadecimal
|
||||||
The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
||||||
character set (also known as ISO 646-IRV).
|
character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-6 encodes the characters used in the Arabic language.
|
ISO 8859-6 encodes the characters used in the Arabic language.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -48,7 +48,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-6 characters"
|
.SS ISO 8859-6 characters
|
||||||
The following table displays the characters in ISO 8859-6, which
|
The following table displays the characters in ISO 8859-6, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -30,7 +30,7 @@ The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
||||||
character set (also known as ISO 646-IRV).
|
character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-7 encodes the
|
ISO 8859-7 encodes the
|
||||||
characters used in modern monotonic Greek.
|
characters used in modern monotonic Greek.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -50,7 +50,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-7 characters"
|
.SS ISO 8859-7 characters
|
||||||
The following table displays the characters in ISO 8859-7, which
|
The following table displays the characters in ISO 8859-7, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -34,7 +34,7 @@ ISO 8859-8, or "ISO Hebrew" encodes the
|
||||||
characters used in Modern Hebrew (or Ivrit).
|
characters used in Modern Hebrew (or Ivrit).
|
||||||
Neither short vowels nor diacritical marks are included,
|
Neither short vowels nor diacritical marks are included,
|
||||||
and Yiddish is not provided for.
|
and Yiddish is not provided for.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -54,7 +54,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-8 characters"
|
.SS ISO 8859-8 characters
|
||||||
The following table displays the characters in ISO 8859-8, which
|
The following table displays the characters in ISO 8859-8, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -30,7 +30,7 @@ The ISO 8859 standard includes several 8-bit extensions to the ASCII
|
||||||
character set (also known as ISO 646-IRV).
|
character set (also known as ISO 646-IRV).
|
||||||
ISO 8859-9, also known as
|
ISO 8859-9, also known as
|
||||||
the "Latin Alphabet No. 5", encodes the characters used in Turkish.
|
the "Latin Alphabet No. 5", encodes the characters used in Turkish.
|
||||||
.SS "ISO 8859 alphabets"
|
.SS ISO 8859 alphabets
|
||||||
The full set of ISO 8859 alphabets includes:
|
The full set of ISO 8859 alphabets includes:
|
||||||
.TS
|
.TS
|
||||||
l l.
|
l l.
|
||||||
|
@ -50,7 +50,7 @@ ISO 8859-14 Celtic (Latin-8)
|
||||||
ISO 8859-15 West European languages (Latin-9)
|
ISO 8859-15 West European languages (Latin-9)
|
||||||
ISO 8859-16 Romanian (Latin-10)
|
ISO 8859-16 Romanian (Latin-10)
|
||||||
.TE
|
.TE
|
||||||
.SS "ISO 8859-9 characters"
|
.SS ISO 8859-9 characters
|
||||||
The following table displays the characters in ISO 8859-9 (Latin-5),
|
The following table displays the characters in ISO 8859-9 (Latin-5),
|
||||||
which are printable and unlisted in the
|
which are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -48,7 +48,7 @@ area.
|
||||||
.PP
|
.PP
|
||||||
A more complete set of Cyrillic characters is also defined by the
|
A more complete set of Cyrillic characters is also defined by the
|
||||||
ISO-8859-5 character set.
|
ISO-8859-5 character set.
|
||||||
.SS "KOI8-R characters"
|
.SS KOI8-R characters
|
||||||
The following table displays the characters in KOI8-R, which
|
The following table displays the characters in KOI8-R, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
|
@ -35,7 +35,7 @@ KOI8-U is compatible with KOI8-R (RFC 1489)
|
||||||
for all Russian letters, and extends KOI8-R with four
|
for all Russian letters, and extends KOI8-R with four
|
||||||
Ukrainian letters (in both upper and lower case)
|
Ukrainian letters (in both upper and lower case)
|
||||||
in locations that are compliant with ISO-IR-111.
|
in locations that are compliant with ISO-IR-111.
|
||||||
.SS "KOI8-U characters"
|
.SS KOI8-U characters
|
||||||
The following table displays the characters in KOI8-U, which
|
The following table displays the characters in KOI8-U, which
|
||||||
are printable and unlisted in the
|
are printable and unlisted in the
|
||||||
.BR ascii (7)
|
.BR ascii (7)
|
||||||
|
|
16
man7/man.7
16
man7/man.7
|
@ -173,7 +173,7 @@ command can be used to specify a word in bold followed by a mark of
|
||||||
punctuation in Roman.
|
punctuation in Roman.
|
||||||
If no arguments are given, the command is applied to the following line
|
If no arguments are given, the command is applied to the following line
|
||||||
of text.
|
of text.
|
||||||
.SS "Other macros and strings"
|
.SS Other macros and strings
|
||||||
.PP
|
.PP
|
||||||
Below are other relevant macros and predefined strings.
|
Below are other relevant macros and predefined strings.
|
||||||
Unless noted otherwise, all macros
|
Unless noted otherwise, all macros
|
||||||
|
@ -193,7 +193,7 @@ By default a given indent is measured in ens;
|
||||||
try to use ens or ems as units for
|
try to use ens or ems as units for
|
||||||
indents, since these will automatically adjust to font size changes.
|
indents, since these will automatically adjust to font size changes.
|
||||||
The other key macro definitions are:
|
The other key macro definitions are:
|
||||||
.SS "Normal paragraphs"
|
.SS Normal paragraphs
|
||||||
.TP 9m
|
.TP 9m
|
||||||
.B \&.LP
|
.B \&.LP
|
||||||
Same as
|
Same as
|
||||||
|
@ -207,7 +207,7 @@ Same as
|
||||||
.TP
|
.TP
|
||||||
.B \&.PP
|
.B \&.PP
|
||||||
Begin a new paragraph and reset prevailing indent.
|
Begin a new paragraph and reset prevailing indent.
|
||||||
.SS "Relative margin indent"
|
.SS Relative margin indent
|
||||||
.TP 9m
|
.TP 9m
|
||||||
.BI \&.RS " i"
|
.BI \&.RS " i"
|
||||||
Start relative margin indent: moves the left margin
|
Start relative margin indent: moves the left margin
|
||||||
|
@ -223,7 +223,7 @@ indented until the corresponding
|
||||||
.B \&.RE
|
.B \&.RE
|
||||||
End relative margin indent and
|
End relative margin indent and
|
||||||
restores the previous value of the prevailing indent.
|
restores the previous value of the prevailing indent.
|
||||||
.SS "Indented paragraph macros"
|
.SS Indented paragraph macros
|
||||||
.TP 9m
|
.TP 9m
|
||||||
.BI \&.HP " i"
|
.BI \&.HP " i"
|
||||||
Begin paragraph with a hanging indent
|
Begin paragraph with a hanging indent
|
||||||
|
@ -257,7 +257,7 @@ The tag is given on the next line, but
|
||||||
its results are like those of the
|
its results are like those of the
|
||||||
.B \&.IP
|
.B \&.IP
|
||||||
command.
|
command.
|
||||||
.SS "Hypertext link macros"
|
.SS Hypertext link macros
|
||||||
(Feature supported with
|
(Feature supported with
|
||||||
.B groff
|
.B groff
|
||||||
only.)
|
only.)
|
||||||
|
@ -333,7 +333,7 @@ A number of other link macros are available.
|
||||||
See
|
See
|
||||||
.BR groff_www (7)
|
.BR groff_www (7)
|
||||||
for more details.
|
for more details.
|
||||||
.SS "Miscellaneous macros"
|
.SS Miscellaneous macros
|
||||||
.TP 9m
|
.TP 9m
|
||||||
.B \&.DT
|
.B \&.DT
|
||||||
Reset tabs to default tab values (every 0.5 inches);
|
Reset tabs to default tab values (every 0.5 inches);
|
||||||
|
@ -350,7 +350,7 @@ Subheading
|
||||||
(like
|
(like
|
||||||
.BR \&.SH ,
|
.BR \&.SH ,
|
||||||
but used for a subsection inside a section).
|
but used for a subsection inside a section).
|
||||||
.SS "Predefined strings"
|
.SS Predefined strings
|
||||||
The
|
The
|
||||||
.B man
|
.B man
|
||||||
package has the following predefined strings:
|
package has the following predefined strings:
|
||||||
|
@ -364,7 +364,7 @@ Trademark Symbol: \*(Tm
|
||||||
Left angled double quote: \*(lq
|
Left angled double quote: \*(lq
|
||||||
.IP \e*(rq
|
.IP \e*(rq
|
||||||
Right angled double quote: \*(rq
|
Right angled double quote: \*(rq
|
||||||
.SS "Safe subset"
|
.SS Safe subset
|
||||||
Although technically
|
Although technically
|
||||||
.B man
|
.B man
|
||||||
is a troff macro package, in reality a large number of other tools
|
is a troff macro package, in reality a large number of other tools
|
||||||
|
|
|
@ -49,7 +49,7 @@ and
|
||||||
However, applications should normally use the interface provided by
|
However, applications should normally use the interface provided by
|
||||||
.IR libnuma ;
|
.IR libnuma ;
|
||||||
see "Library Support" below.
|
see "Library Support" below.
|
||||||
.SS /proc/[number]/numa_maps " (since Linux 2.6.14)"
|
.SS /proc/[number]/numa_maps (since Linux 2.6.14)
|
||||||
.\" See also Changelog-2.6.14
|
.\" See also Changelog-2.6.14
|
||||||
This file displays information about a process's
|
This file displays information about a process's
|
||||||
NUMA memory policy and allocation.
|
NUMA memory policy and allocation.
|
||||||
|
|
|
@ -26,7 +26,7 @@ path_resolution \- how a pathname is resolved to a file
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
Some UNIX/Linux system calls have as parameter one or more filenames.
|
Some UNIX/Linux system calls have as parameter one or more filenames.
|
||||||
A filename (or pathname) is resolved as follows.
|
A filename (or pathname) is resolved as follows.
|
||||||
.SS "Step 1: start of the resolution process"
|
.SS Step 1: start of the resolution process
|
||||||
If the pathname starts with the \(aq/\(aq character,
|
If the pathname starts with the \(aq/\(aq character,
|
||||||
the starting lookup directory
|
the starting lookup directory
|
||||||
is the root directory of the calling process.
|
is the root directory of the calling process.
|
||||||
|
@ -56,7 +56,7 @@ system call.)
|
||||||
|
|
||||||
Pathnames starting with a \(aq/\(aq character are called absolute pathnames.
|
Pathnames starting with a \(aq/\(aq character are called absolute pathnames.
|
||||||
Pathnames not starting with a \(aq/\(aq are called relative pathnames.
|
Pathnames not starting with a \(aq/\(aq are called relative pathnames.
|
||||||
.SS "Step 2: walk along the path"
|
.SS Step 2: walk along the path
|
||||||
Set the current lookup directory to the starting lookup directory.
|
Set the current lookup directory to the starting lookup directory.
|
||||||
Now, for each nonfinal component of the pathname, where a component
|
Now, for each nonfinal component of the pathname, where a component
|
||||||
is a substring delimited by \(aq/\(aq characters, this component is looked up
|
is a substring delimited by \(aq/\(aq characters, this component is looked up
|
||||||
|
@ -105,7 +105,7 @@ exceeded ("Too many levels of symbolic links").
|
||||||
.\" presently: max recursion depth during symlink resolution: 5
|
.\" presently: max recursion depth during symlink resolution: 5
|
||||||
.\" max total number of symbolic links followed: 40
|
.\" max total number of symbolic links followed: 40
|
||||||
.\" _POSIX_SYMLOOP_MAX is 8
|
.\" _POSIX_SYMLOOP_MAX is 8
|
||||||
.SS "Step 3: find the final entry"
|
.SS Step 3: find the final entry
|
||||||
The lookup of the final component of the pathname goes just like
|
The lookup of the final component of the pathname goes just like
|
||||||
that of all other components, as described in the previous step,
|
that of all other components, as described in the previous step,
|
||||||
with two differences: (i) the final component need not be a
|
with two differences: (i) the final component need not be a
|
||||||
|
@ -117,7 +117,7 @@ we are just creating it.
|
||||||
The details on the treatment
|
The details on the treatment
|
||||||
of the final entry are described in the manual pages of the specific
|
of the final entry are described in the manual pages of the specific
|
||||||
system calls.
|
system calls.
|
||||||
.SS ". and .."
|
.SS . and ..
|
||||||
By convention, every directory has the entries "." and "..",
|
By convention, every directory has the entries "." and "..",
|
||||||
which refer to the directory itself and to its parent directory,
|
which refer to the directory itself and to its parent directory,
|
||||||
respectively.
|
respectively.
|
||||||
|
@ -127,7 +127,7 @@ their conventional meanings, regardless of whether they are
|
||||||
actually present in the physical file system.
|
actually present in the physical file system.
|
||||||
|
|
||||||
One cannot walk down past the root: "/.." is the same as "/".
|
One cannot walk down past the root: "/.." is the same as "/".
|
||||||
.SS "Mount points"
|
.SS Mount points
|
||||||
After a "mount dev path" command, the pathname "path" refers to
|
After a "mount dev path" command, the pathname "path" refers to
|
||||||
the root of the file system hierarchy on the device "dev", and no
|
the root of the file system hierarchy on the device "dev", and no
|
||||||
longer to whatever it referred to earlier.
|
longer to whatever it referred to earlier.
|
||||||
|
@ -135,13 +135,13 @@ longer to whatever it referred to earlier.
|
||||||
One can walk out of a mounted file system: "path/.." refers to
|
One can walk out of a mounted file system: "path/.." refers to
|
||||||
the parent directory of "path",
|
the parent directory of "path",
|
||||||
outside of the file system hierarchy on "dev".
|
outside of the file system hierarchy on "dev".
|
||||||
.SS "Trailing slashes"
|
.SS Trailing slashes
|
||||||
If a pathname ends in a \(aq/\(aq, that forces resolution of the preceding
|
If a pathname ends in a \(aq/\(aq, 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 \(aq/\(aq is ignored.
|
Otherwise a trailing \(aq/\(aq is ignored.
|
||||||
(Or, equivalently, a pathname with a trailing \(aq/\(aq is equivalent to
|
(Or, equivalently, a pathname with a trailing \(aq/\(aq is equivalent to
|
||||||
the pathname obtained by appending \(aq.\(aq to it.)
|
the pathname obtained by appending \(aq.\(aq to it.)
|
||||||
.SS "Final symlink"
|
.SS Final symlink
|
||||||
If the last component of a pathname is a symbolic link, then it
|
If the last component of a pathname is a symbolic link, then it
|
||||||
depends on the system call whether the file referred to will be
|
depends on the system call whether the file referred to will be
|
||||||
the symbolic link or the result of path resolution on its contents.
|
the symbolic link or the result of path resolution on its contents.
|
||||||
|
@ -150,21 +150,21 @@ For example, the system call
|
||||||
will operate on the symlink, while
|
will operate on the symlink, while
|
||||||
.BR stat (2)
|
.BR stat (2)
|
||||||
operates on the file pointed to by the symlink.
|
operates on the file pointed to by the symlink.
|
||||||
.SS "Length limit"
|
.SS Length limit
|
||||||
There is a maximum length for pathnames.
|
There is a maximum length for pathnames.
|
||||||
If the pathname (or some
|
If the pathname (or some
|
||||||
intermediate pathname obtained while resolving symbolic links)
|
intermediate pathname obtained while resolving symbolic links)
|
||||||
is too long, an
|
is too long, an
|
||||||
.B ENAMETOOLONG
|
.B ENAMETOOLONG
|
||||||
error is returned ("Filename too long").
|
error is returned ("Filename too long").
|
||||||
.SS "Empty pathname"
|
.SS Empty pathname
|
||||||
In the original UNIX, the empty pathname referred to the current directory.
|
In the original UNIX, the empty pathname referred to the current directory.
|
||||||
Nowadays POSIX decrees that an empty pathname must not be resolved
|
Nowadays POSIX decrees that an empty pathname must not be resolved
|
||||||
successfully.
|
successfully.
|
||||||
Linux returns
|
Linux returns
|
||||||
.B ENOENT
|
.B ENOENT
|
||||||
in this case.
|
in this case.
|
||||||
.SS "Permissions"
|
.SS Permissions
|
||||||
The permission bits of a file consist of three groups of three bits, cf.\&
|
The permission bits of a file consist of three groups of three bits, cf.\&
|
||||||
.BR chmod (1)
|
.BR chmod (1)
|
||||||
and
|
and
|
||||||
|
@ -200,7 +200,7 @@ instead of the effective group ID.
|
||||||
See
|
See
|
||||||
.BR setfsgid (2).
|
.BR setfsgid (2).
|
||||||
.\" FIXME say something about file system mounted read-only ?
|
.\" FIXME say something about file system mounted read-only ?
|
||||||
.SS "Bypassing permission checks: superuser and capabilities"
|
.SS Bypassing permission checks: superuser and capabilities
|
||||||
On a traditional UNIX system, the superuser
|
On a traditional UNIX system, the superuser
|
||||||
.RI ( root ,
|
.RI ( root ,
|
||||||
user ID 0) is all-powerful, and bypasses all permissions restrictions
|
user ID 0) is all-powerful, and bypasses all permissions restrictions
|
||||||
|
|
|
@ -63,7 +63,7 @@ for further details.
|
||||||
although FIFOs have a pathname in the file system,
|
although FIFOs have a pathname in the file system,
|
||||||
I/O on FIFOs does not involve operations on the underlying device
|
I/O on FIFOs does not involve operations on the underlying device
|
||||||
(if there is one).
|
(if there is one).
|
||||||
.SS "I/O on pipes and FIFOs"
|
.SS I/O on pipes and FIFOs
|
||||||
The only difference between pipes and FIFOs is the manner in which
|
The only difference between pipes and FIFOs is the manner in which
|
||||||
they are created and opened.
|
they are created and opened.
|
||||||
Once these tasks have been accomplished,
|
Once these tasks have been accomplished,
|
||||||
|
@ -117,7 +117,7 @@ are delivered when appropriate.
|
||||||
It is not possible to apply
|
It is not possible to apply
|
||||||
.BR lseek (2)
|
.BR lseek (2)
|
||||||
to a pipe.
|
to a pipe.
|
||||||
.SS "Pipe capacity"
|
.SS Pipe capacity
|
||||||
A pipe has a limited capacity.
|
A pipe has a limited capacity.
|
||||||
If the pipe is full, then a
|
If the pipe is full, then a
|
||||||
.BR write (2)
|
.BR write (2)
|
||||||
|
@ -205,7 +205,7 @@ the caller should check the return value from
|
||||||
.BR write (2)
|
.BR write (2)
|
||||||
to see how many bytes were actually written),
|
to see how many bytes were actually written),
|
||||||
and these bytes may be interleaved with writes by other processes.
|
and these bytes may be interleaved with writes by other processes.
|
||||||
.SS "Open file status flags"
|
.SS Open file status flags
|
||||||
The only open file status flags that can be meaningfully applied to
|
The only open file status flags that can be meaningfully applied to
|
||||||
a pipe or FIFO are
|
a pipe or FIFO are
|
||||||
.B O_NONBLOCK
|
.B O_NONBLOCK
|
||||||
|
@ -223,7 +223,7 @@ for details).
|
||||||
On Linux,
|
On Linux,
|
||||||
.B O_ASYNC
|
.B O_ASYNC
|
||||||
is supported for pipes and FIFOs only since kernel 2.6.
|
is supported for pipes and FIFOs only since kernel 2.6.
|
||||||
.SS "Portability notes"
|
.SS Portability notes
|
||||||
On some systems (but not Linux), pipes are bidirectional:
|
On some systems (but not Linux), pipes are bidirectional:
|
||||||
data can be transmitted in both directions between the pipe ends.
|
data can be transmitted in both directions between the pipe ends.
|
||||||
According to POSIX.1-2001, pipes only need to be unidirectional.
|
According to POSIX.1-2001, pipes only need to be unidirectional.
|
||||||
|
|
|
@ -44,7 +44,7 @@ parameter used to inquire about the option, and possibly
|
||||||
a very short description.
|
a very short description.
|
||||||
Much more precise detail can be found in the POSIX standard itself,
|
Much more precise detail can be found in the POSIX standard itself,
|
||||||
versions of which can nowadays be accessed freely on the web.
|
versions of which can nowadays be accessed freely on the web.
|
||||||
.SS "ADV - _POSIX_ADVISORY_INFO - _SC_ADVISORY_INFO"
|
.SS ADV - _POSIX_ADVISORY_INFO - _SC_ADVISORY_INFO
|
||||||
The following advisory functions are present:
|
The following advisory functions are present:
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -57,7 +57,7 @@ The following advisory functions are present:
|
||||||
.br
|
.br
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "AIO - _POSIX_ASYNCHRONOUS_IO - _SC_ASYNCHRONOUS_IO"
|
.SS AIO - _POSIX_ASYNCHRONOUS_IO - _SC_ASYNCHRONOUS_IO
|
||||||
The header
|
The header
|
||||||
.I <aio.h>
|
.I <aio.h>
|
||||||
is present.
|
is present.
|
||||||
|
@ -77,7 +77,7 @@ The following functions are present:
|
||||||
.br
|
.br
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "BAR - _POSIX_BARRIERS - _SC_BARRIERS"
|
.SS BAR - _POSIX_BARRIERS - _SC_BARRIERS
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_THREADS
|
.B _POSIX_THREADS
|
||||||
and
|
and
|
||||||
|
@ -100,7 +100,7 @@ The following functions are present:
|
||||||
.\" Batch environment.
|
.\" Batch environment.
|
||||||
.\" .SS "CD"
|
.\" .SS "CD"
|
||||||
.\" C development.
|
.\" C development.
|
||||||
.SS "--- - POSIX_CHOWN_RESTRICTED"
|
.SS --- - POSIX_CHOWN_RESTRICTED
|
||||||
If this option is in effect (as it always is under POSIX.1-2001)
|
If this option is in effect (as it always is under POSIX.1-2001)
|
||||||
then only root may change the owner of a file, and nonroot can only
|
then only root may change the owner of a file, and nonroot can only
|
||||||
set the group of a file to one of the groups it belongs to.
|
set the group of a file to one of the groups it belongs to.
|
||||||
|
@ -108,7 +108,7 @@ This affects the functions
|
||||||
.IR chown (),
|
.IR chown (),
|
||||||
.IR fchown ().
|
.IR fchown ().
|
||||||
.\" What about lchown() ?
|
.\" What about lchown() ?
|
||||||
.SS "CS - _POSIX_CLOCK_SELECTION - _SC_CLOCK_SELECTION"
|
.SS CS - _POSIX_CLOCK_SELECTION - _SC_CLOCK_SELECTION
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_TIMERS
|
.B _POSIX_TIMERS
|
||||||
option.
|
option.
|
||||||
|
@ -128,7 +128,7 @@ If
|
||||||
is changed by the function
|
is changed by the function
|
||||||
.IR clock_settime (),
|
.IR clock_settime (),
|
||||||
then this affects all timers set for an absolute time.
|
then this affects all timers set for an absolute time.
|
||||||
.SS "CPT - _POSIX_CPUTIME - _SC_CPUTIME"
|
.SS CPT - _POSIX_CPUTIME - _SC_CPUTIME
|
||||||
The clockID CLOCK_PROCESS_CPUTIME_ID is supported.
|
The clockID CLOCK_PROCESS_CPUTIME_ID is supported.
|
||||||
The initial value of this clock is 0 for each process.
|
The initial value of this clock is 0 for each process.
|
||||||
This option implies the
|
This option implies the
|
||||||
|
@ -141,16 +141,16 @@ is present.
|
||||||
.\" Fortran development
|
.\" Fortran development
|
||||||
.\" .SS "FR"
|
.\" .SS "FR"
|
||||||
.\" Fortran runtime
|
.\" Fortran runtime
|
||||||
.SS "--- - _POSIX_FILE_LOCKING - _SC_FILE_LOCKING"
|
.SS --- - _POSIX_FILE_LOCKING - _SC_FILE_LOCKING
|
||||||
This option has been deleted.
|
This option has been deleted.
|
||||||
Not in final XPG6.
|
Not in final XPG6.
|
||||||
.SS "FSC - _POSIX_FSYNC - _SC_FSYNC "
|
.SS FSC - _POSIX_FSYNC - _SC_FSYNC
|
||||||
The function
|
The function
|
||||||
.IR fsync ()
|
.IR fsync ()
|
||||||
is present.
|
is present.
|
||||||
.SS "IP6 - _POSIX_IPV6 - _SC_IPV6"
|
.SS IP6 - _POSIX_IPV6 - _SC_IPV6
|
||||||
Internet Protocol Version 6 is supported.
|
Internet Protocol Version 6 is supported.
|
||||||
.SS "--- - _POSIX_JOB_CONTROL - _SC_JOB_CONTROL"
|
.SS --- - _POSIX_JOB_CONTROL - _SC_JOB_CONTROL
|
||||||
If this option is in effect (as it always is under POSIX.1-2001)
|
If this option is in effect (as it always is under POSIX.1-2001)
|
||||||
then the system implements POSIX-style job control,
|
then the system implements POSIX-style job control,
|
||||||
and the following functions are present:
|
and the following functions are present:
|
||||||
|
@ -167,7 +167,7 @@ and the following functions are present:
|
||||||
.IR tcsetpgrp ().
|
.IR tcsetpgrp ().
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "MF - _POSIX_MAPPED_FILES - _SC_MAPPED_FILES"
|
.SS MF - _POSIX_MAPPED_FILES - _SC_MAPPED_FILES
|
||||||
Shared memory is supported.
|
Shared memory is supported.
|
||||||
The include file
|
The include file
|
||||||
.I <sys/mman.h>
|
.I <sys/mman.h>
|
||||||
|
@ -176,23 +176,23 @@ The following functions are present:
|
||||||
.IR mmap (),
|
.IR mmap (),
|
||||||
.IR msync (),
|
.IR msync (),
|
||||||
.IR munmap ().
|
.IR munmap ().
|
||||||
.SS "ML - _POSIX_MEMLOCK - _SC_MEMLOCK"
|
.SS ML - _POSIX_MEMLOCK - _SC_MEMLOCK
|
||||||
Shared memory can be locked into core.
|
Shared memory can be locked into core.
|
||||||
The functions
|
The functions
|
||||||
.IR mlockall (),
|
.IR mlockall (),
|
||||||
.IR munlockall ()
|
.IR munlockall ()
|
||||||
are present.
|
are present.
|
||||||
.SS "MR/MLR - _POSIX_MEMLOCK_RANGE - _SC_MEMLOCK_RANGE"
|
.SS MR/MLR - _POSIX_MEMLOCK_RANGE - _SC_MEMLOCK_RANGE
|
||||||
More precisely, ranges can be locked into core.
|
More precisely, ranges can be locked into core.
|
||||||
The functions
|
The functions
|
||||||
.IR mlock (),
|
.IR mlock (),
|
||||||
.IR munlock ()
|
.IR munlock ()
|
||||||
are present.
|
are present.
|
||||||
.SS "MPR - _POSIX_MEMORY_PROTECTION - _SC_MEMORY_PROTECTION"
|
.SS MPR - _POSIX_MEMORY_PROTECTION - _SC_MEMORY_PROTECTION
|
||||||
The function
|
The function
|
||||||
.IR mprotect ()
|
.IR mprotect ()
|
||||||
is present.
|
is present.
|
||||||
.SS "MSG - _POSIX_MESSAGE_PASSING - _SC_MESSAGE_PASSING"
|
.SS MSG - _POSIX_MESSAGE_PASSING - _SC_MESSAGE_PASSING
|
||||||
The include file
|
The include file
|
||||||
.I <mqueue.h>
|
.I <mqueue.h>
|
||||||
is present.
|
is present.
|
||||||
|
@ -212,7 +212,7 @@ The following functions are present:
|
||||||
.br
|
.br
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "MON - _POSIX_MONOTONIC_CLOCK - _SC_MONOTONIC_CLOCK"
|
.SS MON - _POSIX_MONOTONIC_CLOCK - _SC_MONOTONIC_CLOCK
|
||||||
.B CLOCK_MONOTONIC
|
.B CLOCK_MONOTONIC
|
||||||
is supported.
|
is supported.
|
||||||
This option implies the
|
This option implies the
|
||||||
|
@ -229,19 +229,19 @@ Affected functions are
|
||||||
.IR timer_create ().
|
.IR timer_create ().
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "--- - _POSIX_MULTI_PROCESS - _SC_MULTI_PROCESS"
|
.SS --- - _POSIX_MULTI_PROCESS - _SC_MULTI_PROCESS
|
||||||
This option has been deleted.
|
This option has been deleted.
|
||||||
Not in final XPG6.
|
Not in final XPG6.
|
||||||
.\" .SS "MX"
|
.\" .SS "MX"
|
||||||
.\" IEC 60559 Floating-Point Option.
|
.\" IEC 60559 Floating-Point Option.
|
||||||
.SS "--- - _POSIX_NO_TRUNC"
|
.SS --- - _POSIX_NO_TRUNC
|
||||||
If this option is in effect (as it always is under POSIX.1-2001)
|
If this option is in effect (as it always is under POSIX.1-2001)
|
||||||
then pathname components longer than
|
then pathname components longer than
|
||||||
.B NAME_MAX
|
.B NAME_MAX
|
||||||
are not truncated,
|
are not truncated,
|
||||||
but give an error.
|
but give an error.
|
||||||
This property may be dependent on the path prefix of the component.
|
This property may be dependent on the path prefix of the component.
|
||||||
.SS "PIO - _POSIX_PRIORITIZED_IO - _SC_PRIORITIZED_IO"
|
.SS PIO - _POSIX_PRIORITIZED_IO - _SC_PRIORITIZED_IO
|
||||||
This option says that one can specify priorities for asynchronous I/O.
|
This option says that one can specify priorities for asynchronous I/O.
|
||||||
This affects the functions
|
This affects the functions
|
||||||
.br
|
.br
|
||||||
|
@ -252,7 +252,7 @@ This affects the functions
|
||||||
.IR aio_write ().
|
.IR aio_write ().
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "PS - _POSIX_PRIORITY_SCHEDULING - _SC_PRIORITY_SCHEDULING"
|
.SS PS - _POSIX_PRIORITY_SCHEDULING - _SC_PRIORITY_SCHEDULING
|
||||||
The include file
|
The include file
|
||||||
.I <sched.h>
|
.I <sched.h>
|
||||||
is present.
|
is present.
|
||||||
|
@ -285,12 +285,12 @@ is in effect, then the following functions are present:
|
||||||
.IR posix_spawnattr_setschedpolicy ().
|
.IR posix_spawnattr_setschedpolicy ().
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "RS - _POSIX_RAW_SOCKETS"
|
.SS RS - _POSIX_RAW_SOCKETS
|
||||||
Raw sockets are supported.
|
Raw sockets are supported.
|
||||||
Affected functions are
|
Affected functions are
|
||||||
.IR getsockopt (),
|
.IR getsockopt (),
|
||||||
.IR setsockopt ().
|
.IR setsockopt ().
|
||||||
.SS "--- - _POSIX_READER_WRITER_LOCKS - _SC_READER_WRITER_LOCKS"
|
.SS --- - _POSIX_READER_WRITER_LOCKS - _SC_READER_WRITER_LOCKS
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_THREADS
|
.B _POSIX_THREADS
|
||||||
option.
|
option.
|
||||||
|
@ -313,7 +313,7 @@ The following functions are present:
|
||||||
.IR pthread_rwlockattr_init ().
|
.IR pthread_rwlockattr_init ().
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "RTS - _POSIX_REALTIME_SIGNALS - _SC_REALTIME_SIGNALS"
|
.SS RTS - _POSIX_REALTIME_SIGNALS - _SC_REALTIME_SIGNALS
|
||||||
Realtime signals are supported.
|
Realtime signals are supported.
|
||||||
The following functions are present:
|
The following functions are present:
|
||||||
.br
|
.br
|
||||||
|
@ -326,7 +326,7 @@ The following functions are present:
|
||||||
.br
|
.br
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "--- - _POSIX_REGEXP - _SC_REGEXP"
|
.SS --- - _POSIX_REGEXP - _SC_REGEXP
|
||||||
If this option is in effect (as it always is under POSIX.1-2001)
|
If this option is in effect (as it always is under POSIX.1-2001)
|
||||||
then POSIX regular expressions are supported
|
then POSIX regular expressions are supported
|
||||||
and the following functions are present:
|
and the following functions are present:
|
||||||
|
@ -341,7 +341,7 @@ and the following functions are present:
|
||||||
.br
|
.br
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "--- - _POSIX_SAVED_IDS - _SC_SAVED_IDS"
|
.SS --- - _POSIX_SAVED_IDS - _SC_SAVED_IDS
|
||||||
If this option is in effect (as it always is under POSIX.1-2001)
|
If this option is in effect (as it always is under POSIX.1-2001)
|
||||||
then a process has a saved set-user-ID and a saved set-group-ID.
|
then a process has a saved set-user-ID and a saved set-group-ID.
|
||||||
Affected functions are
|
Affected functions are
|
||||||
|
@ -360,7 +360,7 @@ Affected functions are
|
||||||
.fi
|
.fi
|
||||||
.\" .SS "SD"
|
.\" .SS "SD"
|
||||||
.\" Software development
|
.\" Software development
|
||||||
.SS "SEM - _POSIX_SEMAPHORES - _SC_SEMAPHORES"
|
.SS SEM - _POSIX_SEMAPHORES - _SC_SEMAPHORES
|
||||||
The include file
|
The include file
|
||||||
.I <semaphore.h>
|
.I <semaphore.h>
|
||||||
is present.
|
is present.
|
||||||
|
@ -381,7 +381,7 @@ The following functions are present:
|
||||||
.br
|
.br
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "SHM - _POSIX_SHARED_MEMORY_OBJECTS - _SC_SHARED_MEMORY_OBJECTS"
|
.SS SHM - _POSIX_SHARED_MEMORY_OBJECTS - _SC_SHARED_MEMORY_OBJECTS
|
||||||
The following functions are present:
|
The following functions are present:
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -394,12 +394,12 @@ The following functions are present:
|
||||||
.br
|
.br
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "--- - _POSIX_SHELL - _SC_SHELL"
|
.SS --- - _POSIX_SHELL - _SC_SHELL
|
||||||
If this option is in effect (as it always is under POSIX.1-2001),
|
If this option is in effect (as it always is under POSIX.1-2001),
|
||||||
the function
|
the function
|
||||||
.IR system ()
|
.IR system ()
|
||||||
is present.
|
is present.
|
||||||
.SS "SPN - _POSIX_SPAWN - _SC_SPAWN"
|
.SS SPN - _POSIX_SPAWN - _SC_SPAWN
|
||||||
This option describes support for process creation in a context where
|
This option describes support for process creation in a context where
|
||||||
it is difficult or impossible to use
|
it is difficult or impossible to use
|
||||||
.IR fork (),
|
.IR fork (),
|
||||||
|
@ -447,7 +447,7 @@ the following functions are present:
|
||||||
.IR posix_spawnattr_setschedpolicy ().
|
.IR posix_spawnattr_setschedpolicy ().
|
||||||
.in -4
|
.in -4
|
||||||
.fi
|
.fi
|
||||||
.SS "SPI - _POSIX_SPIN_LOCKS - _SC_SPIN_LOCKS"
|
.SS SPI - _POSIX_SPIN_LOCKS - _SC_SPIN_LOCKS
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_THREADS
|
.B _POSIX_THREADS
|
||||||
and
|
and
|
||||||
|
@ -466,7 +466,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "SS - _POSIX_SPORADIC_SERVER - _SC_SPORADIC_SERVER"
|
.SS SS - _POSIX_SPORADIC_SERVER - _SC_SPORADIC_SERVER
|
||||||
The scheduling policy
|
The scheduling policy
|
||||||
.B SCHED_SPORADIC
|
.B SCHED_SPORADIC
|
||||||
is supported.
|
is supported.
|
||||||
|
@ -483,13 +483,13 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "SIO - _POSIX_SYNCHRONIZED_IO - _SC_SYNCHRONIZED_IO"
|
.SS SIO - _POSIX_SYNCHRONIZED_IO - _SC_SYNCHRONIZED_IO
|
||||||
Affected functions are
|
Affected functions are
|
||||||
.IR open (),
|
.IR open (),
|
||||||
.IR msync (),
|
.IR msync (),
|
||||||
.IR fsync (),
|
.IR fsync (),
|
||||||
.IR fdatasync ().
|
.IR fdatasync ().
|
||||||
.SS "TSA - _POSIX_THREAD_ATTR_STACKADDR - _SC_THREAD_ATTR_STACKADDR"
|
.SS TSA - _POSIX_THREAD_ATTR_STACKADDR - _SC_THREAD_ATTR_STACKADDR
|
||||||
Affected functions are
|
Affected functions are
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -502,7 +502,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TSS - _POSIX_THREAD_ATTR_STACKSIZE - _SC_THREAD_ATTR_STACKSIZE"
|
.SS TSS - _POSIX_THREAD_ATTR_STACKSIZE - _SC_THREAD_ATTR_STACKSIZE
|
||||||
Affected functions are
|
Affected functions are
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -515,7 +515,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TCT - _POSIX_THREAD_CPUTIME - _SC_THREAD_CPUTIME"
|
.SS TCT - _POSIX_THREAD_CPUTIME - _SC_THREAD_CPUTIME
|
||||||
The clockID CLOCK_THREAD_CPUTIME_ID is supported.
|
The clockID CLOCK_THREAD_CPUTIME_ID is supported.
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_TIMERS
|
.B _POSIX_TIMERS
|
||||||
|
@ -533,7 +533,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TPI - _POSIX_THREAD_PRIO_INHERIT - _SC_THREAD_PRIO_INHERIT"
|
.SS TPI - _POSIX_THREAD_PRIO_INHERIT - _SC_THREAD_PRIO_INHERIT
|
||||||
Affected functions are
|
Affected functions are
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -544,7 +544,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TPP - _POSIX_THREAD_PRIO_PROTECT - _SC_THREAD_PRIO_PROTECT"
|
.SS TPP - _POSIX_THREAD_PRIO_PROTECT - _SC_THREAD_PRIO_PROTECT
|
||||||
Affected functions are
|
Affected functions are
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -559,7 +559,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TPS - _POSIX_THREAD_PRIORITY_SCHEDULING - _SC_THREAD_PRIORITY_SCHEDULING"
|
.SS TPS - _POSIX_THREAD_PRIORITY_SCHEDULING - _SC_THREAD_PRIORITY_SCHEDULING
|
||||||
If this option is in effect, the different threads inside a process
|
If this option is in effect, the different threads inside a process
|
||||||
can run with different priorities and/or different schedulers.
|
can run with different priorities and/or different schedulers.
|
||||||
Affected functions are
|
Affected functions are
|
||||||
|
@ -579,7 +579,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TSH - _POSIX_THREAD_PROCESS_SHARED - _SC_THREAD_PROCESS_SHARED"
|
.SS TSH - _POSIX_THREAD_PROCESS_SHARED - _SC_THREAD_PROCESS_SHARED
|
||||||
Affected functions are
|
Affected functions are
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -596,7 +596,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TSF - _POSIX_THREAD_SAFE_FUNCTIONS - _SC_THREAD_SAFE_FUNCTIONS"
|
.SS TSF - _POSIX_THREAD_SAFE_FUNCTIONS - _SC_THREAD_SAFE_FUNCTIONS
|
||||||
Affected functions are
|
Affected functions are
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -624,7 +624,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TSP - _POSIX_THREAD_SPORADIC_SERVER - _SC_THREAD_SPORADIC_SERVER"
|
.SS TSP - _POSIX_THREAD_SPORADIC_SERVER - _SC_THREAD_SPORADIC_SERVER
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_THREAD_PRIORITY_SCHEDULING
|
.B _POSIX_THREAD_PRIORITY_SCHEDULING
|
||||||
option.
|
option.
|
||||||
|
@ -639,7 +639,7 @@ Affected functions are
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "THR - _POSIX_THREADS - _SC_THREADS"
|
.SS THR - _POSIX_THREADS - _SC_THREADS
|
||||||
Basic support for POSIX threads is available.
|
Basic support for POSIX threads is available.
|
||||||
The following functions are present:
|
The following functions are present:
|
||||||
.br
|
.br
|
||||||
|
@ -697,7 +697,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TMO - _POSIX_TIMEOUTS - _SC_TIMEOUTS"
|
.SS TMO - _POSIX_TIMEOUTS - _SC_TIMEOUTS
|
||||||
The following functions are present:
|
The following functions are present:
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -713,7 +713,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TMR - _POSIX_TIMERS - _SC_TIMERS"
|
.SS TMR - _POSIX_TIMERS - _SC_TIMERS
|
||||||
The following functions are present:
|
The following functions are present:
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -731,7 +731,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TRC - _POSIX_TRACE - _SC_TRACE"
|
.SS TRC - _POSIX_TRACE - _SC_TRACE
|
||||||
POSIX tracing is available.
|
POSIX tracing is available.
|
||||||
The following functions are present:
|
The following functions are present:
|
||||||
.br
|
.br
|
||||||
|
@ -772,7 +772,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TEF - _POSIX_TRACE_EVENT_FILTER - _SC_TRACE_EVENT_FILTER"
|
.SS TEF - _POSIX_TRACE_EVENT_FILTER - _SC_TRACE_EVENT_FILTER
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_TRACE
|
.B _POSIX_TRACE
|
||||||
option.
|
option.
|
||||||
|
@ -792,7 +792,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TRI - _POSIX_TRACE_INHERIT - _SC_TRACE_INHERIT"
|
.SS TRI - _POSIX_TRACE_INHERIT - _SC_TRACE_INHERIT
|
||||||
Tracing children of the traced process is supported.
|
Tracing children of the traced process is supported.
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_TRACE
|
.B _POSIX_TRACE
|
||||||
|
@ -807,7 +807,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TRL - _POSIX_TRACE_LOG - _SC_TRACE_LOG"
|
.SS TRL - _POSIX_TRACE_LOG - _SC_TRACE_LOG
|
||||||
This option implies the
|
This option implies the
|
||||||
.B _POSIX_TRACE
|
.B _POSIX_TRACE
|
||||||
option.
|
option.
|
||||||
|
@ -827,7 +827,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "TYM - _POSIX_TYPED_MEMORY_OBJECTS - _SC_TYPED_MEMORY_OBJECT"
|
.SS TYM - _POSIX_TYPED_MEMORY_OBJECTS - _SC_TYPED_MEMORY_OBJECT
|
||||||
The following functions are present:
|
The following functions are present:
|
||||||
.br
|
.br
|
||||||
.nf
|
.nf
|
||||||
|
@ -839,7 +839,7 @@ The following functions are present:
|
||||||
.in -4
|
.in -4
|
||||||
.br
|
.br
|
||||||
.fi
|
.fi
|
||||||
.SS "--- - _POSIX_VDISABLE"
|
.SS --- - _POSIX_VDISABLE
|
||||||
Always present (probably 0).
|
Always present (probably 0).
|
||||||
Value to set a changeable special control
|
Value to set a changeable special control
|
||||||
character to indicate that it is disabled.
|
character to indicate that it is disabled.
|
||||||
|
|
|
@ -106,7 +106,7 @@ capabilities (see
|
||||||
.IP \- 3
|
.IP \- 3
|
||||||
CPU affinity
|
CPU affinity
|
||||||
.RB ( sched_setaffinity (2))
|
.RB ( sched_setaffinity (2))
|
||||||
.SS "Pthreads function return values"
|
.SS Pthreads function return values
|
||||||
Most pthreads functions return 0 on success, and an error number of failure.
|
Most pthreads functions return 0 on success, and an error number of failure.
|
||||||
Note that the pthreads functions do not set
|
Note that the pthreads functions do not set
|
||||||
.IR errno .
|
.IR errno .
|
||||||
|
@ -127,7 +127,7 @@ or a detached thread has terminated.
|
||||||
In all pthreads functions that accept a thread ID as an argument,
|
In all pthreads functions that accept a thread ID as an argument,
|
||||||
that ID by definition refers to a thread in
|
that ID by definition refers to a thread in
|
||||||
the same process as the caller.
|
the same process as the caller.
|
||||||
.SS "Thread-safe functions"
|
.SS Thread-safe functions
|
||||||
A thread-safe function is one that can be safely
|
A thread-safe function is one that can be safely
|
||||||
(i.e., it will deliver the same results regardless of whether it is)
|
(i.e., it will deliver the same results regardless of whether it is)
|
||||||
called from multiple threads at the same time.
|
called from multiple threads at the same time.
|
||||||
|
@ -650,10 +650,10 @@ any nonstandard function that may block as a cancellation point.
|
||||||
.\" vscanf
|
.\" vscanf
|
||||||
.\" vsyslog
|
.\" vsyslog
|
||||||
.\" vwscanf
|
.\" vwscanf
|
||||||
.SS "Compiling on Linux"
|
.SS Compiling on Linux
|
||||||
On Linux, programs that use the Pthreads API should be compiled using
|
On Linux, programs that use the Pthreads API should be compiled using
|
||||||
.IR "cc \-pthread" .
|
.IR "cc \-pthread" .
|
||||||
.SS "Linux implementations of POSIX threads"
|
.SS Linux implementations of POSIX threads
|
||||||
Over time, two threading implementations have been provided by
|
Over time, two threading implementations have been provided by
|
||||||
the GNU C library on Linux:
|
the GNU C library on Linux:
|
||||||
.TP
|
.TP
|
||||||
|
@ -844,7 +844,7 @@ is executed, perhaps using the
|
||||||
shell built-in command
|
shell built-in command
|
||||||
.RI ( "limit stacksize"
|
.RI ( "limit stacksize"
|
||||||
in the C shell).
|
in the C shell).
|
||||||
.SS "Determining the threading implementation"
|
.SS Determining the threading implementation
|
||||||
Since glibc 2.3.2, the
|
Since glibc 2.3.2, the
|
||||||
.BR getconf (1)
|
.BR getconf (1)
|
||||||
command can be used to determine
|
command can be used to determine
|
||||||
|
@ -867,7 +867,7 @@ bash$ $( ldd /bin/ls | grep libc.so | awk \(aq{print $3}\(aq ) | \\
|
||||||
Native POSIX Threads Library by Ulrich Drepper et al
|
Native POSIX Threads Library by Ulrich Drepper et al
|
||||||
.in
|
.in
|
||||||
.fi
|
.fi
|
||||||
.SS "Selecting the threading implementation: LD_ASSUME_KERNEL"
|
.SS Selecting the threading implementation: LD_ASSUME_KERNEL
|
||||||
On systems with a glibc that supports both LinuxThreads and NPTL
|
On systems with a glibc that supports both LinuxThreads and NPTL
|
||||||
(i.e., glibc 2.3.\fIx\fP), the
|
(i.e., glibc 2.3.\fIx\fP), the
|
||||||
.B LD_ASSUME_KERNEL
|
.B LD_ASSUME_KERNEL
|
||||||
|
|
|
@ -68,7 +68,7 @@ on Linux systems.
|
||||||
Since kernel 2.6.4, BSD-style pseudoterminals are considered deprecated
|
Since kernel 2.6.4, BSD-style pseudoterminals are considered deprecated
|
||||||
(they can be disabled when configuring the kernel);
|
(they can be disabled when configuring the kernel);
|
||||||
UNIX 98 pseudoterminals should be used in new applications.
|
UNIX 98 pseudoterminals should be used in new applications.
|
||||||
.SS "UNIX 98 pseudoterminals"
|
.SS UNIX 98 pseudoterminals
|
||||||
An unused UNIX 98 pseudoterminal master is opened by calling
|
An unused UNIX 98 pseudoterminal master is opened by calling
|
||||||
.BR posix_openpt (3).
|
.BR posix_openpt (3).
|
||||||
(This function opens the master clone device,
|
(This function opens the master clone device,
|
||||||
|
@ -100,7 +100,7 @@ and a corresponding file,
|
||||||
indicates how many pseudoterminals are currently in use.
|
indicates how many pseudoterminals are currently in use.
|
||||||
For further details on these two files, see
|
For further details on these two files, see
|
||||||
.BR proc (5).
|
.BR proc (5).
|
||||||
.SS "BSD pseudoterminals"
|
.SS BSD pseudoterminals
|
||||||
BSD-style pseudoterminals are provided as precreated pairs, with
|
BSD-style pseudoterminals are provided as precreated pairs, with
|
||||||
names of the form
|
names of the form
|
||||||
.I /dev/ptyXY
|
.I /dev/ptyXY
|
||||||
|
|
|
@ -35,7 +35,7 @@ It is based on netlink messages; see
|
||||||
.BR netlink (7)
|
.BR netlink (7)
|
||||||
for more information.
|
for more information.
|
||||||
.\" FIXME ? all these macros could be moved to rtnetlink(3)
|
.\" FIXME ? all these macros could be moved to rtnetlink(3)
|
||||||
.SS "Routing attributes"
|
.SS Routing attributes
|
||||||
Some rtnetlink messages have optional attributes after the initial header:
|
Some rtnetlink messages have optional attributes after the initial header:
|
||||||
|
|
||||||
.in +4n
|
.in +4n
|
||||||
|
|
|
@ -47,7 +47,7 @@ signal \- overview of signals
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
Linux supports both POSIX reliable signals (hereinafter
|
Linux supports both POSIX reliable signals (hereinafter
|
||||||
"standard signals") and POSIX real-time signals.
|
"standard signals") and POSIX real-time signals.
|
||||||
.SS "Signal dispositions"
|
.SS Signal dispositions
|
||||||
Each signal has a current
|
Each signal has a current
|
||||||
.IR disposition ,
|
.IR disposition ,
|
||||||
which determines how the process behaves when it is delivered
|
which determines how the process behaves when it is delivered
|
||||||
|
@ -165,7 +165,7 @@ call is delivered to the caller.
|
||||||
The buffer returned by
|
The buffer returned by
|
||||||
.BR read (2)
|
.BR read (2)
|
||||||
contains a structure describing the signal.
|
contains a structure describing the signal.
|
||||||
.SS "Signal mask and pending signals"
|
.SS Signal mask and pending signals
|
||||||
A signal may be
|
A signal may be
|
||||||
.IR blocked ,
|
.IR blocked ,
|
||||||
which means that it will not be delivered until it is later unblocked.
|
which means that it will not be delivered until it is later unblocked.
|
||||||
|
@ -217,7 +217,7 @@ A child created via
|
||||||
initially has an empty pending signal set;
|
initially has an empty pending signal set;
|
||||||
the pending signal set is preserved across an
|
the pending signal set is preserved across an
|
||||||
.BR execve (2).
|
.BR execve (2).
|
||||||
.SS "Standard signals"
|
.SS Standard signals
|
||||||
Linux supports the standard signals listed below.
|
Linux supports the standard signals listed below.
|
||||||
Several signal numbers
|
Several signal numbers
|
||||||
are architecture-dependent, as indicated in the "Value" column.
|
are architecture-dependent, as indicated in the "Value" column.
|
||||||
|
@ -341,7 +341,7 @@ is synonymous with
|
||||||
.\" parisc is the only exception: SIGSYS is 12, SIGUNUSED is 31
|
.\" parisc is the only exception: SIGSYS is 12, SIGUNUSED is 31
|
||||||
.B SIGSYS
|
.B SIGSYS
|
||||||
on most architectures.
|
on most architectures.
|
||||||
.SS "Real-time signals"
|
.SS Real-time signals
|
||||||
Linux supports real-time signals as originally defined in the POSIX.1b
|
Linux supports real-time signals as originally defined in the POSIX.1b
|
||||||
real-time extensions (and now included in POSIX.1-2001).
|
real-time extensions (and now included in POSIX.1-2001).
|
||||||
The range of supported real-time signals is defined by the macros
|
The range of supported real-time signals is defined by the macros
|
||||||
|
@ -443,7 +443,7 @@ resource limit, which specifies a per-user limit for queued
|
||||||
signals; see
|
signals; see
|
||||||
.BR setrlimit (2)
|
.BR setrlimit (2)
|
||||||
for further details.
|
for further details.
|
||||||
.SS "Async-signal-safe functions"
|
.SS Async-signal-safe functions
|
||||||
.PP
|
.PP
|
||||||
A signal handler function must be very careful,
|
A signal handler function must be very careful,
|
||||||
since processing elsewhere may be interrupted
|
since processing elsewhere may be interrupted
|
||||||
|
|
14
man7/time.7
14
man7/time.7
|
@ -27,7 +27,7 @@
|
||||||
.SH NAME
|
.SH NAME
|
||||||
time \- overview of time and timers
|
time \- overview of time and timers
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.SS "Real time and process time"
|
.SS Real time and process time
|
||||||
.I "Real time"
|
.I "Real time"
|
||||||
is defined as time measured from some fixed point,
|
is defined as time measured from some fixed point,
|
||||||
either from a standard point in the past
|
either from a standard point in the past
|
||||||
|
@ -54,14 +54,14 @@ A program can determine the amount of CPU time it has consumed using
|
||||||
.BR getrusage (2),
|
.BR getrusage (2),
|
||||||
or
|
or
|
||||||
.BR clock (3).
|
.BR clock (3).
|
||||||
.SS "The hardware clock"
|
.SS The hardware clock
|
||||||
Most computers have a (battery-powered) hardware clock which the kernel
|
Most computers have a (battery-powered) hardware clock which the kernel
|
||||||
reads at boot time in order to initialize the software clock.
|
reads at boot time in order to initialize the software clock.
|
||||||
For further details, see
|
For further details, see
|
||||||
.BR rtc (4)
|
.BR rtc (4)
|
||||||
and
|
and
|
||||||
.BR hwclock (8).
|
.BR hwclock (8).
|
||||||
.SS "The software clock, HZ, and jiffies"
|
.SS The software clock, HZ, and jiffies
|
||||||
The accuracy of various system calls that set timeouts,
|
The accuracy of various system calls that set timeouts,
|
||||||
(e.g.,
|
(e.g.,
|
||||||
.BR select (2),
|
.BR select (2),
|
||||||
|
@ -102,7 +102,7 @@ User-space applications can determine the value of this constant using
|
||||||
.\" glibc gets this info with a little help from the ELF loader;
|
.\" glibc gets this info with a little help from the ELF loader;
|
||||||
.\" see glibc elf/dl-support.c and kernel fs/binfmt_elf.c.
|
.\" see glibc elf/dl-support.c and kernel fs/binfmt_elf.c.
|
||||||
.\"
|
.\"
|
||||||
.SS "High-resolution timers"
|
.SS High-resolution timers
|
||||||
Before Linux 2.6.21, the accuracy of timer and sleep system calls
|
Before Linux 2.6.21, the accuracy of timer and sleep system calls
|
||||||
(see below) was also limited by the size of the jiffy.
|
(see below) was also limited by the size of the jiffy.
|
||||||
|
|
||||||
|
@ -121,7 +121,7 @@ or looking at the "resolution" entries in
|
||||||
|
|
||||||
HRTs are not supported on all hardware architectures.
|
HRTs are not supported on all hardware architectures.
|
||||||
(Support is provided on x86, arm, and powerpc, among others.)
|
(Support is provided on x86, arm, and powerpc, among others.)
|
||||||
.SS "The Epoch"
|
.SS The Epoch
|
||||||
UNIX systems represent time in seconds since the
|
UNIX systems represent time in seconds since the
|
||||||
.IR Epoch ,
|
.IR Epoch ,
|
||||||
1970-01-01 00:00:00 +0000 (UTC).
|
1970-01-01 00:00:00 +0000 (UTC).
|
||||||
|
@ -137,7 +137,7 @@ provides similar information, but only with accuracy to the
|
||||||
nearest second.
|
nearest second.
|
||||||
The system time can be changed using
|
The system time can be changed using
|
||||||
.BR settimeofday (2).
|
.BR settimeofday (2).
|
||||||
.SS "Broken-down time"
|
.SS Broken-down time
|
||||||
Certain library functions use a structure of
|
Certain library functions use a structure of
|
||||||
type
|
type
|
||||||
.I tm
|
.I tm
|
||||||
|
@ -155,7 +155,7 @@ string representations of the time are described in
|
||||||
.BR strftime (3),
|
.BR strftime (3),
|
||||||
and
|
and
|
||||||
.BR strptime (3).
|
.BR strptime (3).
|
||||||
.SS "Sleeping and setting timers"
|
.SS Sleeping and setting timers
|
||||||
Various system calls and functions allow a program to sleep
|
Various system calls and functions allow a program to sleep
|
||||||
(suspend execution) for a specified period of time; see
|
(suspend execution) for a specified period of time; see
|
||||||
.BR nanosleep (2),
|
.BR nanosleep (2),
|
||||||
|
|
|
@ -89,12 +89,12 @@ When turned off, UDP will fragment outgoing UDP packets
|
||||||
that exceed the interface MTU.
|
that exceed the interface MTU.
|
||||||
However, disabling it is not recommended
|
However, disabling it is not recommended
|
||||||
for performance and reliability reasons.
|
for performance and reliability reasons.
|
||||||
.SS "Address format"
|
.SS Address format
|
||||||
UDP uses the IPv4
|
UDP uses the IPv4
|
||||||
.I sockaddr_in
|
.I sockaddr_in
|
||||||
address format described in
|
address format described in
|
||||||
.BR ip (7).
|
.BR ip (7).
|
||||||
.SS "Error handling"
|
.SS Error handling
|
||||||
All fatal errors will be passed to the user as an error return even
|
All fatal errors will be passed to the user as an error return even
|
||||||
when the socket is not connected.
|
when the socket is not connected.
|
||||||
This includes asynchronous errors
|
This includes asynchronous errors
|
||||||
|
@ -169,7 +169,7 @@ Each UDP socket is able to use the size for sending data,
|
||||||
even if total pages of UDP sockets exceed
|
even if total pages of UDP sockets exceed
|
||||||
.I udp_mem
|
.I udp_mem
|
||||||
pressure.
|
pressure.
|
||||||
.SS "Socket options"
|
.SS Socket options
|
||||||
To set or get a UDP socket option, call
|
To set or get a UDP socket option, call
|
||||||
.BR getsockopt (2)
|
.BR getsockopt (2)
|
||||||
to read or
|
to read or
|
||||||
|
|
|
@ -53,7 +53,7 @@ The UDP-Lite implementation is a full extension of
|
||||||
.BR udp (7),
|
.BR udp (7),
|
||||||
i.e., it shares the same API and API behaviour, and in addition
|
i.e., it shares the same API and API behaviour, and in addition
|
||||||
offers two socket options to control the checksum coverage.
|
offers two socket options to control the checksum coverage.
|
||||||
.SS "Address format"
|
.SS Address format
|
||||||
UDP-Litev4 uses the
|
UDP-Litev4 uses the
|
||||||
.I sockaddr_in
|
.I sockaddr_in
|
||||||
address format described in
|
address format described in
|
||||||
|
@ -62,7 +62,7 @@ UDP-Litev6 uses the
|
||||||
.I sockaddr_in6
|
.I sockaddr_in6
|
||||||
address format described in
|
address format described in
|
||||||
.BR ipv6 (7).
|
.BR ipv6 (7).
|
||||||
.SS "Socket options"
|
.SS Socket options
|
||||||
To set or get a UDP-Lite socket option, call
|
To set or get a UDP-Lite socket option, call
|
||||||
.BR getsockopt (2)
|
.BR getsockopt (2)
|
||||||
to read or
|
to read or
|
||||||
|
|
|
@ -115,7 +115,7 @@ classic
|
||||||
character set and the characters in the range 0x0000 to 0x00ff
|
character set and the characters in the range 0x0000 to 0x00ff
|
||||||
are identical to those in
|
are identical to those in
|
||||||
.BR "ISO 8859-1 Latin-1" .
|
.BR "ISO 8859-1 Latin-1" .
|
||||||
.SS "Combining characters"
|
.SS Combining characters
|
||||||
Some code points in
|
Some code points in
|
||||||
.B UCS
|
.B UCS
|
||||||
have been assigned to
|
have been assigned to
|
||||||
|
@ -136,7 +136,7 @@ followed by a "combining diaeresis": 0x0041 0x0308.
|
||||||
Combining characters are essential for instance for encoding the Thai
|
Combining characters are essential for instance for encoding the Thai
|
||||||
script or for mathematical typesetting and users of the International
|
script or for mathematical typesetting and users of the International
|
||||||
Phonetic Alphabet.
|
Phonetic Alphabet.
|
||||||
.SS "Implementation levels"
|
.SS Implementation levels
|
||||||
As not all systems are expected to support advanced mechanisms like
|
As not all systems are expected to support advanced mechanisms like
|
||||||
combining characters, ISO 10646-1 specifies the following three
|
combining characters, ISO 10646-1 specifies the following three
|
||||||
.I implementation levels
|
.I implementation levels
|
||||||
|
@ -175,7 +175,7 @@ various characters.
|
||||||
They provide guidelines and algorithms for
|
They provide guidelines and algorithms for
|
||||||
editing, sorting, comparing, normalizing, converting and displaying
|
editing, sorting, comparing, normalizing, converting and displaying
|
||||||
Unicode strings.
|
Unicode strings.
|
||||||
.SS "Unicode under Linux"
|
.SS Unicode under Linux
|
||||||
Under GNU/Linux, the C type
|
Under GNU/Linux, the C type
|
||||||
.I wchar_t
|
.I wchar_t
|
||||||
is a signed 32-bit integer type.
|
is a signed 32-bit integer type.
|
||||||
|
@ -221,7 +221,7 @@ by some UTF-8 terminal emulators and ISO 10646 fonts (level 2), but in
|
||||||
general precomposed characters should be preferred where available
|
general precomposed characters should be preferred where available
|
||||||
(Unicode calls this
|
(Unicode calls this
|
||||||
.BR "Normalization Form C" ).
|
.BR "Normalization Form C" ).
|
||||||
.SS "Private area"
|
.SS Private area
|
||||||
In the
|
In the
|
||||||
.BR BMP ,
|
.BR BMP ,
|
||||||
the range 0xe000 to 0xf8ff will never be assigned to any characters by
|
the range 0xe000 to 0xf8ff will never be assigned to any characters by
|
||||||
|
|
|
@ -485,7 +485,7 @@ URNs are to be supported by the urn: scheme, with a hierarchical name space
|
||||||
(e.g., urn:ietf:... would identify IETF documents); at this time
|
(e.g., urn:ietf:... would identify IETF documents); at this time
|
||||||
URNs are not widely implemented.
|
URNs are not widely implemented.
|
||||||
Not all tools support all schemes.
|
Not all tools support all schemes.
|
||||||
.SS "Character encoding"
|
.SS Character encoding
|
||||||
.PP
|
.PP
|
||||||
URIs use a limited number of characters so that they can be
|
URIs use a limited number of characters so that they can be
|
||||||
typed in and used in a variety of situations.
|
typed in and used in a variety of situations.
|
||||||
|
@ -535,7 +535,7 @@ then
|
||||||
.IP 2.
|
.IP 2.
|
||||||
use the URI escaping mechanism, that is,
|
use the URI escaping mechanism, that is,
|
||||||
use the %HH encoding for unsafe octets.
|
use the %HH encoding for unsafe octets.
|
||||||
.SS "Writing a URI"
|
.SS Writing a URI
|
||||||
When written, URIs should be placed inside double quotes
|
When written, URIs should be placed inside double quotes
|
||||||
(e.g., "http://www.kernelnotes.org"),
|
(e.g., "http://www.kernelnotes.org"),
|
||||||
enclosed in angle brackets (e.g., <http://lwn.net>),
|
enclosed in angle brackets (e.g., <http://lwn.net>),
|
||||||
|
|
|
@ -188,7 +188,7 @@ encoded as:
|
||||||
.RS
|
.RS
|
||||||
11100010 10001001 10100000 = 0xe2 0x89 0xa0
|
11100010 10001001 10100000 = 0xe2 0x89 0xa0
|
||||||
.RE
|
.RE
|
||||||
.SS "Application notes"
|
.SS Application notes
|
||||||
Users have to select a
|
Users have to select a
|
||||||
.B UTF-8
|
.B UTF-8
|
||||||
locale, for example with
|
locale, for example with
|
||||||
|
|
Loading…
Reference in New Issue