clone.2, ioctl_tty.2, syslog.2, setlocale.3, stdio.3, console_codes.4, inode.7, namespaces.7, netlink.7, signal-safety.7, socket.7: Better table formatting

In particular, allow for rendering in widths different from
(especially less than) 80 columns.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2021-01-06 23:16:03 +01:00
parent 30e3e116bb
commit 0b174fe008
11 changed files with 530 additions and 188 deletions

View File

@ -250,14 +250,16 @@ and the fields in the
.I clone_args
argument supplied to
.BR clone3 ():
.RS
.RS 4
.TS
lb lb lb
l l l
li li l.
clone() clone3() Notes
\fIcl_args\fP field
flags & \(ti0xff flags For most flags; details below
flags & \(ti0xff flags T{
For most flags; details below
T}
parent_tid pidfd See CLONE_PIDFD
child_tid child_tid See CLONE_CHILD_SETTID
parent_tid parent_tid See CLONE_PARENT_SETTID
@ -325,7 +327,7 @@ should be set is defined by
which cannot be larger than the number of currently nested PID namespaces.
.PP
To create a process with the following PIDs in a PID namespace hierarchy:
.RS
.RS 4
.TS
lb lb lb
l l l.

View File

@ -337,15 +337,29 @@ If the first byte is not
(0), it is an OR of one
or more of the following bits:
.IP
.ad l
.TS
lb l.
TIOCPKT_FLUSHREAD The read queue for the terminal is flushed.
TIOCPKT_FLUSHWRITE The write queue for the terminal is flushed.
TIOCPKT_STOP Output to the terminal is stopped.
TIOCPKT_START Output to the terminal is restarted.
TIOCPKT_DOSTOP The start and stop characters are \fB\(haS\fP/\fB\(haQ\fP.
TIOCPKT_NOSTOP The start and stop characters are not \fB\(haS\fP/\fB\(haQ\fP.
TIOCPKT_FLUSHREAD T{
The read queue for the terminal is flushed.
T}
TIOCPKT_FLUSHWRITE T{
The write queue for the terminal is flushed.
T}
TIOCPKT_STOP T{
Output to the terminal is stopped.
T}
TIOCPKT_START T{
Output to the terminal is restarted.
T}
TIOCPKT_DOSTOP T{
The start and stop characters are \fB\(haS\fP/\fB\(haQ\fP.
T}
TIOCPKT_NOSTOP T{
The start and stop characters are not \fB\(haS\fP/\fB\(haQ\fP.
T}
.TE
.ad
.IP
While packet mode is in use, the presence
of control status information to be read

View File

@ -300,11 +300,15 @@ lB lB lB
lB c l.
Kernel constant Level value Meaning
KERN_EMERG 0 System is unusable
KERN_ALERT 1 Action must be taken immediately
KERN_ALERT 1 T{
Action must be taken immediately
T}
KERN_CRIT 2 Critical conditions
KERN_ERR 3 Error conditions
KERN_WARNING 4 Warning conditions
KERN_NOTICE 5 Normal but significant condition
KERN_NOTICE 5 T{
Normal but significant condition
T}
KERN_INFO 6 Informational
KERN_DEBUG 7 Debug-level messages
.TE

View File

@ -50,32 +50,50 @@ the program's current locale is modified according to the arguments.
The argument
.I category
determines which parts of the program's current locale should be modified.
.ad l
.nh
.TS
lB lB
lB l.
lB lx.
Category Governs
LC_ALL All of the locale
LC_ADDRESS T{
Formatting of addresses and
.br
geography-related items (*)
T}
LC_COLLATE String collation
LC_CTYPE Character classification
LC_IDENTIFICATION Metadata describing the locale (*)
LC_IDENTIFICATION T{
Metadata describing the locale (*)
T}
LC_MEASUREMENT T{
Settings related to measurements
.br
(metric versus US customary) (*)
T}
LC_MESSAGES Localizable natural-language messages
LC_MONETARY Formatting of monetary values
LC_NAME Formatting of salutations for persons (*)
LC_NUMERIC Formatting of nonmonetary numeric values
LC_PAPER Settings related to the standard paper size (*)
LC_TELEPHONE Formats to be used with telephone services (*)
LC_TIME Formatting of date and time values
LC_MESSAGES T{
Localizable natural-language messages
T}
LC_MONETARY T{
Formatting of monetary values
T}
LC_NAME T{
Formatting of salutations for persons (*)
T}
LC_NUMERIC T{
Formatting of nonmonetary numeric values
T}
LC_PAPER T{
Settings related to the standard paper size (*)
T}
LC_TELEPHONE T{
Formats to be used with telephone services (*)
T}
LC_TIME T{
Formatting of date and time values
T}
.TE
.hy
.ad
.PP
The categories marked with an asterisk in the above table
are GNU extensions.

View File

@ -180,68 +180,182 @@ and
.B putchar
exist and will be used if the macros definitions are explicitly removed.
.SS List of functions
.nh
.ad l
.TS
;
lb lb
lb lbx
l l.
Function Description
_
\fBclearerr\fP(3) check and reset stream status
\fBfclose\fP(3) close a stream
\fBfdopen\fP(3) stream open functions
\fBfeof\fP(3) check and reset stream status
\fBferror\fP(3) check and reset stream status
\fBfflush\fP(3) flush a stream
\fBfgetc\fP(3) get next character or word from input stream
\fBfgetpos\fP(3) reposition a stream
\fBfgets\fP(3) get a line from a stream
\fBfileno\fP(3) return the integer descriptor of the argument stream
\fBfopen\fP(3) stream open functions
\fBfprintf\fP(3) formatted output conversion
\fBfpurge\fP(3) flush a stream
\fBfputc\fP(3) output a character or word to a stream
\fBfputs\fP(3) output a line to a stream
\fBfread\fP(3) binary stream input/output
\fBfreopen\fP(3) stream open functions
\fBfscanf\fP(3) input format conversion
\fBfseek\fP(3) reposition a stream
\fBfsetpos\fP(3) reposition a stream
\fBftell\fP(3) reposition a stream
\fBfwrite\fP(3) binary stream input/output
\fBgetc\fP(3) get next character or word from input stream
\fBgetchar\fP(3) get next character or word from input stream
\fBgets\fP(3) get a line from a stream
\fBgetw\fP(3) get next character or word from input stream
\fBmktemp\fP(3) make temporary filename (unique)
\fBperror\fP(3) system error messages
\fBprintf\fP(3) formatted output conversion
\fBputc\fP(3) output a character or word to a stream
\fBputchar\fP(3) output a character or word to a stream
\fBputs\fP(3) output a line to a stream
\fBputw\fP(3) output a character or word to a stream
\fBremove\fP(3) remove directory entry
\fBrewind\fP(3) reposition a stream
\fBscanf\fP(3) input format conversion
\fBsetbuf\fP(3) stream buffering operations
\fBsetbuffer\fP(3) stream buffering operations
\fBsetlinebuf\fP(3) stream buffering operations
\fBsetvbuf\fP(3) stream buffering operations
\fBsprintf\fP(3) formatted output conversion
\fBsscanf\fP(3) input format conversion
\fBstrerror\fP(3) system error messages
\fBsys_errlist\fP(3) system error messages
\fBsys_nerr\fP(3) system error messages
\fBtempnam\fP(3) temporary file routines
\fBtmpfile\fP(3) temporary file routines
\fBtmpnam\fP(3) temporary file routines
\fBungetc\fP(3) un-get character from input stream
\fBvfprintf\fP(3) formatted output conversion
\fBvfscanf\fP(3) input format conversion
\fBvprintf\fP(3) formatted output conversion
\fBvscanf\fP(3) input format conversion
\fBvsprintf\fP(3) formatted output conversion
\fBvsscanf\fP(3) input format conversion
\fBclearerr\fP(3) T{
check and reset stream status
T}
\fBfclose\fP(3) T{
close a stream
T}
\fBfdopen\fP(3) T{
stream open functions
T}
\fBfeof\fP(3) T{
check and reset stream status
T}
\fBferror\fP(3) T{
check and reset stream status
T}
\fBfflush\fP(3) T{
flush a stream
T}
\fBfgetc\fP(3) T{
get next character or word from input stream
T}
\fBfgetpos\fP(3) T{
reposition a stream
T}
\fBfgets\fP(3) T{
get a line from a stream
T}
\fBfileno\fP(3) T{
return the integer descriptor of the argument stream
T}
\fBfopen\fP(3) T{
stream open functions
T}
\fBfprintf\fP(3) T{
formatted output conversion
T}
\fBfpurge\fP(3) T{
flush a stream
T}
\fBfputc\fP(3) T{
output a character or word to a stream
T}
\fBfputs\fP(3) T{
output a line to a stream
T}
\fBfread\fP(3) T{
binary stream input/output
T}
\fBfreopen\fP(3) T{
stream open functions
T}
\fBfscanf\fP(3) T{
input format conversion
T}
\fBfseek\fP(3) T{
reposition a stream
T}
\fBfsetpos\fP(3) T{
reposition a stream
T}
\fBftell\fP(3) T{
reposition a stream
T}
\fBfwrite\fP(3) T{
binary stream input/output
T}
\fBgetc\fP(3) T{
get next character or word from input stream
T}
\fBgetchar\fP(3) T{
get next character or word from input stream
T}
\fBgets\fP(3) T{
get a line from a stream
T}
\fBgetw\fP(3) T{
get next character or word from input stream
T}
\fBmktemp\fP(3) T{
make temporary filename (unique)
T}
\fBperror\fP(3) T{
system error messages
T}
\fBprintf\fP(3) T{
formatted output conversion
T}
\fBputc\fP(3) T{
output a character or word to a stream
T}
\fBputchar\fP(3) T{
output a character or word to a stream
T}
\fBputs\fP(3) T{
output a line to a stream
T}
\fBputw\fP(3) T{
output a character or word to a stream
T}
\fBremove\fP(3) T{
remove directory entry
T}
\fBrewind\fP(3) T{
reposition a stream
T}
\fBscanf\fP(3) T{
input format conversion
T}
\fBsetbuf\fP(3) T{
stream buffering operations
T}
\fBsetbuffer\fP(3) T{
stream buffering operations
T}
\fBsetlinebuf\fP(3) T{
stream buffering operations
T}
\fBsetvbuf\fP(3) T{
stream buffering operations
T}
\fBsprintf\fP(3) T{
formatted output conversion
T}
\fBsscanf\fP(3) T{
input format conversion
T}
\fBstrerror\fP(3) T{
system error messages
T}
\fBsys_errlist\fP(3) T{
system error messages
T}
\fBsys_nerr\fP(3) T{
system error messages
T}
\fBtempnam\fP(3) T{
temporary file routines
T}
\fBtmpfile\fP(3) T{
temporary file routines
T}
\fBtmpnam\fP(3) T{
temporary file routines
T}
\fBungetc\fP(3) T{
un-get character from input stream
T}
\fBvfprintf\fP(3) T{
formatted output conversion
T}
\fBvfscanf\fP(3) T{
input format conversion
T}
\fBvprintf\fP(3) T{
formatted output conversion
T}
\fBvscanf\fP(3) T{
input format conversion
T}
\fBvsprintf\fP(3) T{
formatted output conversion
T}
\fBvsscanf\fP(3) T{
input format conversion
T}
.TE
.ad
.hy
.SH CONFORMING TO
The
.I stdio

View File

@ -119,8 +119,9 @@ DEL (0x7F) is ignored;
CSI (0x9B) is equivalent to ESC [.
.PP
.B "ESC- but not CSI-sequences"
.ad l
.TS
l l l.
l l lx.
ESC c RIS Reset.
ESC D IND Linefeed.
ESC E NEL Newline.
@ -135,21 +136,36 @@ ESC 7 DECSC T{
Save current state (cursor coordinates,
attributes, character sets pointed at by G0, G1).
T}
ESC 8 DECRC Restore state most recently saved by ESC 7.
ESC 8 DECRC T{
Restore state most recently saved by ESC 7.
T}
ESC [ CSI Control sequence introducer
ESC % Start sequence selecting character set
ESC % @ \0\0\0Select default (ISO 646 / ISO 8859-1)
ESC % G \0\0\0Select UTF-8
ESC % 8 \0\0\0Select UTF-8 (obsolete)
ESC # 8 DECALN DEC screen alignment test \- fill screen with E's.
ESC ( Start sequence defining G0 character set
ESC ( B \0\0\0Select default (ISO 8859-1 mapping)
ESC ( 0 \0\0\0Select VT100 graphics mapping
ESC ( U \0\0\0Select null mapping \- straight to character ROM
ESC ( K \0\0\0Select user mapping \- the map that is loaded by
\0\0\0the utility \fBmapscrn\fP(8).
ESC ) Start sequence defining G1
(followed by one of B, 0, U, K, as above).
ESC # 8 DECALN T{
DEC screen alignment test \- fill screen with E's
T}
ESC ( T{
Start sequence defining G0 character set
(followed by one of B, 0, U, K, as below)
T}
ESC ( B T{
Select default (ISO 8859-1 mapping)
T}
ESC ( 0 T{
Select VT100 graphics mapping
T}
ESC ( U T{
Select null mapping \- straight to character ROM
T}
ESC ( K T{
Select user mapping \- the map that is loaded by the utility \fBmapscrn\fP(8)
T}
ESC ) T{
Start sequence defining G1 (followed by one of B, 0, U, K, as above).
T}
ESC > DECPNM Set numeric keypad mode
ESC = DECPAM Set application keypad mode
ESC ] OSC T{
@ -161,6 +177,7 @@ the red/green/blue values (0\(en255).
ESC ] R: reset palette
T}
.TE
.ad
.PP
.B "ECMA-48 CSI sequences"
.PP
@ -175,37 +192,92 @@ and this entire sequence is ignored.
(The idea is to ignore an echoed function key.)
.PP
The action of a CSI sequence is determined by its final character.
.ad l
.TS
l l l.
@ ICH Insert the indicated # of blank characters.
A CUU Move cursor up the indicated # of rows.
B CUD Move cursor down the indicated # of rows.
C CUF Move cursor right the indicated # of columns.
D CUB Move cursor left the indicated # of columns.
E CNL Move cursor down the indicated # of rows, to column 1.
F CPL Move cursor up the indicated # of rows, to column 1.
G CHA Move cursor to indicated column in current row.
H CUP Move cursor to the indicated row, column (origin at 1,1).
J ED Erase display (default: from cursor to end of display).
ESC [ 1 J: erase from start to cursor.
ESC [ 2 J: erase whole display.
ESC [ 3 J: erase whole display including scroll-back
buffer (since Linux 3.0).
l l lx.
@ ICH T{
Insert the indicated # of blank characters.
T}
A CUU T{
Move cursor up the indicated # of rows.
T}
B CUD T{
Move cursor down the indicated # of rows.
T}
C CUF T{
Move cursor right the indicated # of columns.
T}
D CUB T{
Move cursor left the indicated # of columns.
T}
E CNL T{
Move cursor down the indicated # of rows, to column 1.
T}
F CPL T{
Move cursor up the indicated # of rows, to column 1.
T}
G CHA T{
Move cursor to indicated column in current row.
T}
H CUP T{
Move cursor to the indicated row, column (origin at 1,1).
T}
J ED T{
Erase display (default: from cursor to end of display).
T}
T{
ESC [ 1 J: erase from start to cursor.
T}
T{
ESC [ 2 J: erase whole display.
T}
T{
ESC [ 3 J: erase whole display including scroll-back
buffer (since Linux 3.0).
T}
.\" ESC [ 3 J: commit f8df13e0a901fe55631fed66562369b4dba40f8b
K EL Erase line (default: from cursor to end of line).
ESC [ 1 K: erase from start of line to cursor.
ESC [ 2 K: erase whole line.
L IL Insert the indicated # of blank lines.
M DL Delete the indicated # of lines.
P DCH Delete the indicated # of characters on current line.
X ECH Erase the indicated # of characters on current line.
a HPR Move cursor right the indicated # of columns.
c DA Answer ESC [ ? 6 c: "I am a VT102".
d VPA Move cursor to the indicated row, current column.
e VPR Move cursor down the indicated # of rows.
f HVP Move cursor to the indicated row, column.
g TBC Without parameter: clear tab stop at current position.
ESC [ 3 g: delete all tab stops.
K EL T{
Erase line (default: from cursor to end of line).
T}
T{
ESC [ 1 K: erase from start of line to cursor.
T}
T{
ESC [ 2 K: erase whole line.
T}
L IL T{
Insert the indicated # of blank lines.
T}
M DL T{
Delete the indicated # of lines.
T}
P DCH T{
Delete the indicated # of characters on current line.
T}
X ECH T{
Erase the indicated # of characters on current line.
T}
a HPR T{
Move cursor right the indicated # of columns.
T}
c DA T{
Answer ESC [ ? 6 c: "I am a VT102".
T}
d VPA T{
Move cursor to the indicated row, current column.
T}
e VPR T{
Move cursor down the indicated # of rows.
T}
f HVP T{
Move cursor to the indicated row, column.
T}
g TBC T{
Without parameter: clear tab stop at current position.
T}
T{
ESC [ 3 g: delete all tab stops.
T}
h SM Set Mode (see below).
l RM Reset Mode (see below).
m SGR Set attributes (see below).
@ -215,11 +287,16 @@ q DECLL Set keyboard LEDs.
ESC [ 1 q: set Scroll Lock LED
ESC [ 2 q: set Num Lock LED
ESC [ 3 q: set Caps Lock LED
r DECSTBM Set scrolling region; parameters are top and bottom row.
r DECSTBM T{
Set scrolling region; parameters are top and bottom row.
T}
s ? Save cursor location.
u ? Restore cursor location.
\` HPA Move cursor to indicated column in current row.
\` HPA T{
Move cursor to indicated column in current row.
T}
.TE
.ad
.PP
.B ECMA-48 Set Graphics Rendition
.PP
@ -229,12 +306,17 @@ Several attributes can be set in the same sequence, separated by
semicolons.
An empty parameter (between semicolons or string initiator or
terminator) is interpreted as a zero.
.ad l
.TS
l l.
l lx.
param result
0 reset all attributes to their defaults
0 T{
reset all attributes to their defaults
T}
1 set bold
2 set half-bright (simulated with color on a color display)
2 T{
set half-bright (simulated with color on a color display)
T}
4 T{
set underscore (simulated with color on a color display)
(the colors used to simulate dim or underline are set
@ -293,18 +375,25 @@ T}
256/24-bit background color follows, shoehorned into 8 basic colors
T}
49 set default background color
90..97 set foreground to bright versions of 30..37
100.107 set background, same as 40..47 (bright not supported)
90..97 T{
set foreground to bright versions of 30..37
T}
100.107 T{
set background, same as 40..47 (bright not supported)
T}
.TE
.ad
.PP
Commands 38 and 48 require further arguments:
.TS
l l.
l lx.
;5;x T{
256 color: values 0..15 are IBGR (black, red, green, ... white),
16..231 a 6x6x6 color cube, 232..255 a grayscale ramp
T}
;2;r;g;b 24-bit color, r/g/b components are in the range 0..255
;2;r;g;b T{
24-bit color, r/g/b components are in the range 0..255
T}
.TE
.PP
.B ECMA-48 Mode Switches
@ -386,16 +475,34 @@ Colors are in SGR parameters:
0 = black, 1 = red, 2 = green, 3 = brown, 4 = blue, 5 = magenta, 6 =
cyan, 7 = white; 8\(en15 = bright versions of 0\(en7.
.TS
l l.
ESC [ 1 ; \fIn\fP ] Set color \fIn\fP as the underline color.
ESC [ 2 ; \fIn\fP ] Set color \fIn\fP as the dim color.
ESC [ 8 ] Make the current color pair the default attributes.
ESC [ 9 ; \fIn\fP ] Set screen blank timeout to \fIn\fP minutes.
ESC [ 10 ; \fIn\fP ] Set bell frequency in Hz.
ESC [ 11 ; \fIn\fP ] Set bell duration in msec.
ESC [ 12 ; \fIn\fP ] Bring specified console to the front.
ESC [ 13 ] Unblank the screen.
ESC [ 14 ; \fIn\fP ] Set the VESA powerdown interval in minutes.
l lx.
ESC [ 1 ; \fIn\fP ] T{
Set color \fIn\fP as the underline color.
T}
ESC [ 2 ; \fIn\fP ] T{
Set color \fIn\fP as the dim color.
T}
ESC [ 8 ] T{
Make the current color pair the default attributes.
T}
ESC [ 9 ; \fIn\fP ] T{
Set screen blank timeout to \fIn\fP minutes.
T}
ESC [ 10 ; \fIn\fP ] T{
Set bell frequency in Hz.
T}
ESC [ 11 ; \fIn\fP ] T{
Set bell duration in msec.
T}
ESC [ 12 ; \fIn\fP ] T{
Bring specified console to the front.
T}
ESC [ 13 ] T{
Unblank the screen.
T}
ESC [ 14 ; \fIn\fP ] T{
Set the VESA powerdown interval in minutes.
T}
ESC [ 15 ] T{
Bring the previous console to the front
(since Linux 2.6.0).
@ -520,11 +627,15 @@ BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC.
VT100 console sequences not implemented on the Linux console:
.TS
l l l.
ESC N SS2 Single shift 2. (Select G2 character set for the next
character only.)
ESC O SS3 Single shift 3. (Select G3 character set for the next
character only.)
ESC P DCS Device control string (ended by ESC \e)
ESC N SS2 T{
Single shift 2. (Select G2 character set for the next character only.)
T}
ESC O SS3 T{
Single shift 3. (Select G3 character set for the next character only.)
T}
ESC P DCS T{
Device control string (ended by ESC \e)
T}
ESC X SOS Start of string.
ESC \(ha PM Privacy message (ended by ESC \e)
ESC \e ST String terminator
@ -553,13 +664,16 @@ In addition to the ECMA-48 string terminator (ST),
These are a few of the OSC control sequences recognized by \fBxterm\fP(1):
.TS
l l.
ESC ] 0 ; \fItxt\fP ST Set icon name and window title to \fItxt\fP.
ESC ] 0 ; \fItxt\fP ST T{
Set icon name and window title to \fItxt\fP.
T}
ESC ] 1 ; \fItxt\fP ST Set icon name to \fItxt\fP.
ESC ] 2 ; \fItxt\fP ST Set window title to \fItxt\fP.
ESC ] 4 ; \fInum\fP; \fItxt\fP ST Set ANSI color \fInum\fP to \fItxt\fP.
ESC ] 10 ; \fItxt\fP ST Set dynamic text color to \fItxt\fP.
ESC ] 4 6 ; \fIname\fP ST Change log file to \fIname\fP (normally disabled
by a compile-time option)
ESC ] 4 6 ; \fIname\fP ST T{
Change log file to \fIname\fP (normally disabled by a compile-time option)
T}
ESC ] 5 0 ; \fIfn\fP ST Set font to \fIfn\fP.
.TE
.PP
@ -573,9 +687,11 @@ ESC 8 DECRC Restore cursor
.PP
It also recognizes
.TS
l l l.
ESC F Cursor to lower left corner of screen (if enabled by
\fBxterm\fP(1)'s \fBhpLowerleftBugCompat\fP resource)
l l lx.
ESC F T{
Cursor to lower left corner of screen (if enabled
by \fBxterm\fP(1)'s \fBhpLowerleftBugCompat\fP resource)
T}
ESC l Memory lock (per HP terminals).
Locks memory above the cursor.
ESC m Memory unlock (per HP terminals).

View File

@ -364,29 +364,61 @@ the file mode component of the
.I st_mode
field:
.in +4n
.nh
.ad l
.TS
lB l l.
S_ISUID 04000 set-user-ID bit (see \fBexecve\fP(2))
S_ISGID 02000 set-group-ID bit (see below)
S_ISVTX 01000 sticky bit (see below)
lB l lx.
S_ISUID 04000 T{
set-user-ID bit (see \fBexecve\fP(2))
T}
S_ISGID 02000 T{
set-group-ID bit (see below)
T}
S_ISVTX 01000 T{
sticky bit (see below)
T}
S_IRWXU 00700 owner has read, write, and execute permission
S_IRUSR 00400 owner has read permission
S_IWUSR 00200 owner has write permission
S_IXUSR 00100 owner has execute permission
S_IRWXU 00700 T{
owner has read, write, and execute permission
T}
S_IRUSR 00400 T{
owner has read permission
T}
S_IWUSR 00200 T{
owner has write permission
T}
S_IXUSR 00100 T{
owner has execute permission
T}
S_IRWXG 00070 group has read, write, and execute permission
S_IRGRP 00040 group has read permission
S_IWGRP 00020 group has write permission
S_IXGRP 00010 group has execute permission
S_IRWXG 00070 T{
group has read, write, and execute permission
T}
S_IRGRP 00040 T{
group has read permission
T}
S_IWGRP 00020 T{
group has write permission
T}
S_IXGRP 00010 T{
group has execute permission
T}
S_IRWXO 00007 T{
others (not in group) have read, write, and execute permission
T}
S_IROTH 00004 others have read permission
S_IWOTH 00002 others have write permission
S_IXOTH 00001 others have execute permission
S_IROTH 00004 T{
others have read permission
T}
S_IWOTH 00002 T{
others have write permission
T}
S_IXOTH 00001 T{
others have execute permission
T}
.TE
.ad
.hy
.in
.PP
The set-group-ID bit

View File

@ -48,35 +48,38 @@ The third column identifies the manual page that provides details
on the namespace type.
The last column is a summary of the resources that are isolated by
the namespace type.
.ad l
.nh
.TS
lB lB lB lB
l1 lB1 l1 l.
Namespace Flag Page Isolates
Cgroup CLONE_NEWCGROUP \fBcgroup_namespaces\fP(7) Cgroup root directory
Cgroup CLONE_NEWCGROUP \fBcgroup_namespaces\fP(7) T{
Cgroup root directory
T}
IPC CLONE_NEWIPC \fBipc_namespaces\fP(7) T{
System V IPC,
.br
POSIX message queues
T}
Network CLONE_NEWNET \fBnetwork_namespaces\fP(7) T{
Network devices,
.br
stacks, ports, etc.
T}
Mount CLONE_NEWNS \fBmount_namespaces\fP(7) Mount points
PID CLONE_NEWPID \fBpid_namespaces\fP(7) Process IDs
Time CLONE_NEWTIME \fBtime_namespaces\fP(7) T{
Boot and monotonic
.br
clocks
T}
User CLONE_NEWUSER \fBuser_namespaces\fP(7) User and group IDs
User CLONE_NEWUSER \fBuser_namespaces\fP(7) T{User and group IDs
T}
UTS CLONE_NEWUTS \fButs_namespaces\fP(7) T{
Hostname and NIS
.br
domain name
T}
.TE
.hy
.ad
.\"
.\" ==================== The namespaces API ====================
.\"

View File

@ -205,39 +205,56 @@ appropriate manual pages for that, for example,
.BR rtnetlink (7)
for
.BR NETLINK_ROUTE .
.nh
.ad l
.TS
tab(:);
l s
lB l.
lB lx.
Standard flag bits in \fInlmsg_flags\fP
_
NLM_F_REQUEST:Must be set on all request messages.
NLM_F_REQUEST:T{
Must be set on all request messages.
T}
NLM_F_MULTI:T{
The message is part of a multipart message terminated by
.BR NLMSG_DONE .
T}
NLM_F_ACK:Request for an acknowledgment on success.
NLM_F_ECHO:Echo this request.
NLM_F_ACK:T{
Request for an acknowledgment on success.
T}
NLM_F_ECHO:T{
Echo this request.
T}
.TE
.ad
.hy
.\" No right adjustment for text blocks in tables
.nh
.ad l
.TS
tab(:);
l s
lB l.
lB lx.
Additional flag bits for GET requests
_
NLM_F_ROOT:Return the complete table instead of a single entry.
NLM_F_ROOT:T{
Return the complete table instead of a single entry.
T}
NLM_F_MATCH:T{
Return all entries matching criteria passed in message content.
Not implemented yet.
T}
NLM_F_ATOMIC:Return an atomic snapshot of the table.
NLM_F_ATOMIC:T{
Return an atomic snapshot of the table.
T}
NLM_F_DUMP:T{
Convenience macro; equivalent to
.br
(NLM_F_ROOT|NLM_F_MATCH).
T}
.TE
.ad
.hy
.\" FIXME NLM_F_ATOMIC is not used anymore?
.PP
Note that
@ -245,17 +262,29 @@ Note that
requires the
.B CAP_NET_ADMIN
capability or an effective UID of 0.
.nh
.ad l
.TS
tab(:);
l s
lB l.
lB lx.
Additional flag bits for NEW requests
_
NLM_F_REPLACE:Replace existing matching object.
NLM_F_EXCL:Don't replace if the object already exists.
NLM_F_CREATE:Create object if it doesn't already exist.
NLM_F_APPEND:Add to the end of the object list.
NLM_F_REPLACE:T{
Replace existing matching object.
T}
NLM_F_EXCL:T{
Don't replace if the object already exists.
T}
NLM_F_CREATE:T{
Create object if it doesn't already exist.
T}
NLM_F_APPEND:T{
Add to the end of the object list.
T}
.TE
.ad
.hy
.PP
.I nlmsg_seq
and

View File

@ -114,7 +114,9 @@ Function Notes
\fBcreat\fP(2)
\fBdup\fP(2)
\fBdup2\fP(2)
\fBexecl\fP(3) Added in POSIX.1-2008; see notes below
\fBexecl\fP(3) T{
Added in POSIX.1-2008; see notes below
T}
\fBexecle\fP(3) See notes below
\fBexecv\fP(3) Added in POSIX.1-2008
\fBexecve\fP(2)
@ -153,7 +155,9 @@ Function Notes
\fBlink\fP(2)
\fBlinkat\fP(2) Added in POSIX.1-2008
\fBlisten\fP(2)
\fBlongjmp\fP(3) Added in POSIX.1-2008 TC2; see notes below
\fBlongjmp\fP(3) T{
Added in POSIX.1-2008 TC2; see notes below
T}
\fBlseek\fP(2)
\fBlstat\fP(2)
\fBmemccpy\fP(3) Added in POSIX.1-2008 TC2
@ -207,7 +211,9 @@ Function Notes
\fBsigemptyset\fP(3)
\fBsigfillset\fP(3)
\fBsigismember\fP(3)
\fBsiglongjmp\fP(3) Added in POSIX.1-2008 TC2; see notes below
\fBsiglongjmp\fP(3) T{
Added in POSIX.1-2008 TC2; see notes below
T}
\fBsignal\fP(2)
\fBsigpause\fP(3)
\fBsigpending\fP(2)

View File

@ -163,7 +163,7 @@ or
.TS
tab(:) allbox;
c s s
l l l.
l l lx.
I/O events
Event:Poll flag:Occurrence
Read:POLLIN:T{
@ -194,8 +194,12 @@ An outgoing
.BR connect (2)
finished.
T}
Read/Write:POLLERR:An asynchronous error occurred.
Read/Write:POLLHUP:The other end has shut down one direction.
Read/Write:POLLERR:T{
An asynchronous error occurred.
T}
Read/Write:POLLHUP:T{
The other end has shut down one direction.
T}
Exception:POLLPRI:T{
Urgent data arrived.
.B SIGURG