Manual pages: various: reword "allow(s) to"
The wording "allow(s) to" is not grammatical English. Reword various pages to use a more correct form such "can be use to" or "allows the [noun] of". Aklong the way, fix a few nearby wording errors in some pages. Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
This commit is contained in:
parent
10fa311d3e
commit
4f68c8b179
|
@ -200,7 +200,7 @@ are deprecated.
|
||||||
|
|
||||||
.SH SCRIPT FILES
|
.SH SCRIPT FILES
|
||||||
.B fdisk
|
.B fdisk
|
||||||
allows reading (by 'I' command) sfdisk compatible script files. The script is
|
allows reading (by 'I' command) sfdisk compatible script files. The script is
|
||||||
applied to in-memory partition table, and then it is possible to modify the
|
applied to in-memory partition table, and then it is possible to modify the
|
||||||
partition table before you write it to the device.
|
partition table before you write it to the device.
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -296,7 +296,6 @@ disk label (see the \fBEMPTY DISK LABEL\fR section below).
|
||||||
.BR \-Y , " \-\-label\-nested " \fItype
|
.BR \-Y , " \-\-label\-nested " \fItype
|
||||||
Force editing of a nested disk label. The primary disk label has to exist already.
|
Force editing of a nested disk label. The primary disk label has to exist already.
|
||||||
This option allows editing for example a hybrid/protective MBR on devices with GPT.
|
This option allows editing for example a hybrid/protective MBR on devices with GPT.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.BR \-w , " \-\-wipe "\fIwhen
|
.BR \-w , " \-\-wipe "\fIwhen
|
||||||
Wipe filesystem, RAID and partition-table signatures from the device, in order
|
Wipe filesystem, RAID and partition-table signatures from the device, in order
|
||||||
|
|
|
@ -24,7 +24,8 @@ filesystem labels/volume names, unique identifiers/serial numbers.
|
||||||
A common use is to allow use of LABEL= and UUID= tags instead of hard-coding
|
A common use is to allow use of LABEL= and UUID= tags instead of hard-coding
|
||||||
specific block device names into configuration files.
|
specific block device names into configuration files.
|
||||||
.P
|
.P
|
||||||
The low-level part of the library also allows to extract information about
|
The low-level part of the library also allows the extraction
|
||||||
|
of information about
|
||||||
partitions and block device topology.
|
partitions and block device topology.
|
||||||
.P
|
.P
|
||||||
The high-level part of the library keeps information about block devices in a
|
The high-level part of the library keeps information about block devices in a
|
||||||
|
|
|
@ -133,9 +133,9 @@ to tell
|
||||||
that printing the hostname should be suppressed in the login: prompt.
|
that printing the hostname should be suppressed in the login: prompt.
|
||||||
See also
|
See also
|
||||||
.B LOGIN_PLAIN_PROMPT
|
.B LOGIN_PLAIN_PROMPT
|
||||||
below if your server does not allow to configure
|
below if your server does not allow the
|
||||||
.B login
|
.B login
|
||||||
command line.
|
command line to be configured.
|
||||||
.TP
|
.TP
|
||||||
\fB\-\-help\fR
|
\fB\-\-help\fR
|
||||||
Display help text and exit.
|
Display help text and exit.
|
||||||
|
@ -193,9 +193,9 @@ to stop display content specified by
|
||||||
.B MOTD_FILE
|
.B MOTD_FILE
|
||||||
after the first accessible item in the list.
|
after the first accessible item in the list.
|
||||||
Note that a directory is one item in this case.
|
Note that a directory is one item in this case.
|
||||||
This option allows to configure
|
This option allows
|
||||||
.B login
|
.B login
|
||||||
semantic to be more compatible with pam_motd.
|
semantics to be configured to be more compatible with pam_motd.
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
.B LOGIN_PLAIN_PROMPT
|
.B LOGIN_PLAIN_PROMPT
|
||||||
|
|
|
@ -6,7 +6,7 @@ su \- run a command with substitute user and group ID
|
||||||
.RI [ user " [" argument ...]]
|
.RI [ user " [" argument ...]]
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.B su
|
.B su
|
||||||
allows to run commands with a substitute user and group ID.
|
allows commands to be with a substitute user and group ID.
|
||||||
.PP
|
.PP
|
||||||
When called with no
|
When called with no
|
||||||
.I user
|
.I user
|
||||||
|
@ -122,7 +122,7 @@ This option is ignored if the option \fB\-\-login\fR is specified.
|
||||||
.BR \-P , " \-\-pty"
|
.BR \-P , " \-\-pty"
|
||||||
Create pseudo-terminal for the session. The independent terminal provides
|
Create pseudo-terminal for the session. The independent terminal provides
|
||||||
better security as user does not share terminal with the original
|
better security as user does not share terminal with the original
|
||||||
session. This allow to avoid TIOCSTI ioctl terminal injection and other
|
session. This can be used to avoid TIOCSTI ioctl terminal injection and other
|
||||||
security attacks against terminal file descriptors. The all session is also
|
security attacks against terminal file descriptors. The all session is also
|
||||||
possible to move to background (e.g., "su \-\-pty \- username \-c
|
possible to move to background (e.g., "su \-\-pty \- username \-c
|
||||||
application &"). If the pseudo-terminal is enabled then su command works
|
application &"). If the pseudo-terminal is enabled then su command works
|
||||||
|
@ -280,7 +280,7 @@ global logindef config file
|
||||||
For security reasons
|
For security reasons
|
||||||
.B su
|
.B su
|
||||||
always logs failed log-in attempts to the btmp file, but it does not write to
|
always logs failed log-in attempts to the btmp file, but it does not write to
|
||||||
the lastlog file at all. This solution allows to control
|
the lastlog file at all. This solution can be used to control
|
||||||
.B su
|
.B su
|
||||||
behavior by PAM configuration. If you want to use the pam_lastlog module to
|
behavior by PAM configuration. If you want to use the pam_lastlog module to
|
||||||
print warning message about failed log-in attempts then the pam_lastlog has to
|
print warning message about failed log-in attempts then the pam_lastlog has to
|
||||||
|
|
|
@ -281,7 +281,8 @@ parameters should be observed.
|
||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
.BI \%\-\-delay= seconds
|
.BI \%\-\-delay= seconds
|
||||||
This option allows to overwrite internally used delay when set clock time. The
|
This option can be used to overwrite the internally used delay
|
||||||
|
when setting the clock time. The
|
||||||
default is 0.5 (500ms) for rtc_cmos, for another RTC types the delay is 0. If
|
default is 0.5 (500ms) for rtc_cmos, for another RTC types the delay is 0. If
|
||||||
RTC type is impossible to determine (from sysfs) then it defaults also to 0.5
|
RTC type is impossible to determine (from sysfs) then it defaults also to 0.5
|
||||||
to be backwardly compatible.
|
to be backwardly compatible.
|
||||||
|
|
|
@ -584,7 +584,7 @@ with a single
|
||||||
.BR mount (2)
|
.BR mount (2)
|
||||||
system call, and the flags cannot be mixed with other mount options and operations.
|
system call, and the flags cannot be mixed with other mount options and operations.
|
||||||
|
|
||||||
Since util-linux 2.23 the \fBmount\fR command allows to do more propagation
|
Since util-linux 2.23 the \fBmount\fR command can be used to do more propagation
|
||||||
(topology) changes by one mount(8) call and do it also together with other
|
(topology) changes by one mount(8) call and do it also together with other
|
||||||
mount operations. This feature is EXPERIMENTAL. The propagation flags are applied
|
mount operations. This feature is EXPERIMENTAL. The propagation flags are applied
|
||||||
by additional \fBmount\fR(2) system calls when the preceding mount operations
|
by additional \fBmount\fR(2) system calls when the preceding mount operations
|
||||||
|
@ -891,9 +891,9 @@ explicitly define that the argument is the mount target.
|
||||||
.TP
|
.TP
|
||||||
.BI \-\-target\-prefix " directory"
|
.BI \-\-target\-prefix " directory"
|
||||||
Prepend the specified directory to all mount targets.
|
Prepend the specified directory to all mount targets.
|
||||||
This option allows to follow
|
This option can be used to follow
|
||||||
.IR fstab ,
|
.IR fstab ,
|
||||||
but mount operations is done on another place, for example:
|
but mount operations are done in another place, for example:
|
||||||
.RS
|
.RS
|
||||||
.RS
|
.RS
|
||||||
.sp
|
.sp
|
||||||
|
|
|
@ -22,7 +22,7 @@ modifies execution domains and process personality flags.
|
||||||
The execution domains currently only affects the output of \fBuname \-m\fR.
|
The execution domains currently only affects the output of \fBuname \-m\fR.
|
||||||
For example, on an AMD64 system, running \fBsetarch i386 \fIprogram\fR
|
For example, on an AMD64 system, running \fBsetarch i386 \fIprogram\fR
|
||||||
will cause \fIprogram\fR to see i686 instead of x86_64 as the machine type.
|
will cause \fIprogram\fR to see i686 instead of x86_64 as the machine type.
|
||||||
It also allows to set various personality options.
|
It can also be used to set various personality options.
|
||||||
The default \fIprogram\fR is \fB/bin/sh\fR.
|
The default \fIprogram\fR is \fB/bin/sh\fR.
|
||||||
.PP
|
.PP
|
||||||
Since version 2.33 the
|
Since version 2.33 the
|
||||||
|
|
|
@ -215,13 +215,15 @@ option on a line, anybody can umount the corresponding filesystem. For more det
|
||||||
.BR mount (8)
|
.BR mount (8)
|
||||||
man page.
|
man page.
|
||||||
.PP
|
.PP
|
||||||
Since version 2.34 \fBumount\fR command allows to perform umount operation also
|
Since version 2.34 the \fBumount\fR command can be used to
|
||||||
|
perform umount operation also
|
||||||
for fuse filesystems if kernel mount table contains user's ID. In this case fstab
|
for fuse filesystems if kernel mount table contains user's ID. In this case fstab
|
||||||
user= mount option is not required.
|
user= mount option is not required.
|
||||||
.PP
|
.PP
|
||||||
Since version 2.35 \fBumount\fR command does not exit when user permissions are
|
Since version 2.35 \fBumount\fR command does not exit when user permissions are
|
||||||
inadequate by internal libmount security rules. It drops suid permissions
|
inadequate by internal libmount security rules. It drops suid permissions
|
||||||
and continue as regular non-root user. It allows to support use-cases where
|
and continue as regular non-root user.
|
||||||
|
This can be used to support use-cases where
|
||||||
root permissions are not necessary (e.g., fuse filesystems, user namespaces,
|
root permissions are not necessary (e.g., fuse filesystems, user namespaces,
|
||||||
etc).
|
etc).
|
||||||
.SH LOOP DEVICE
|
.SH LOOP DEVICE
|
||||||
|
|
|
@ -241,7 +241,8 @@ Call vhangup() to do a virtual hangup of the specified terminal.
|
||||||
Try to keep the existing baud rate. The baud rates from the command line are
|
Try to keep the existing baud rate. The baud rates from the command line are
|
||||||
used when agetty receives a BREAK character. If another baud rates specified
|
used when agetty receives a BREAK character. If another baud rates specified
|
||||||
then the original baud rate is also saved to the end of the wanted baud rates
|
then the original baud rate is also saved to the end of the wanted baud rates
|
||||||
list. It allows to return to the original baud rate after unexpected BREAKs.
|
list.
|
||||||
|
This can be used to return to the original baud rate after unexpected BREAKs.
|
||||||
.TP
|
.TP
|
||||||
\-t, \-\-timeout \fItimeout\fP
|
\-t, \-\-timeout \fItimeout\fP
|
||||||
Terminate if no user name could be read within \fItimeout\fP seconds.
|
Terminate if no user name could be read within \fItimeout\fP seconds.
|
||||||
|
@ -357,7 +358,7 @@ checks for \fI/etc/issue.d\fP directory. The directory is optional extension to
|
||||||
the default issue file and content of the directory is printed after
|
the default issue file and content of the directory is printed after
|
||||||
\fI/etc/issue\fP content. If the \fI/etc/issue\fP does not exist than the
|
\fI/etc/issue\fP content. If the \fI/etc/issue\fP does not exist than the
|
||||||
directory is ignored. All files \fBwith .issue extension\fP from the directory are
|
directory is ignored. All files \fBwith .issue extension\fP from the directory are
|
||||||
printed in version-sort order. The directory allow to maintain 3rd-party
|
printed in version-sort order. The directory can be used to maintain 3rd-party
|
||||||
messages independently on the primary system \fI/etc/issue\fP file.
|
messages independently on the primary system \fI/etc/issue\fP file.
|
||||||
|
|
||||||
Since version 2.35 additional locations for issue file and directory are
|
Since version 2.35 additional locations for issue file and directory are
|
||||||
|
@ -413,7 +414,7 @@ S or S{VARIABLE}
|
||||||
Insert the VARIABLE data from \fI/etc/os-release\fP. If this file does not exist
|
Insert the VARIABLE data from \fI/etc/os-release\fP. If this file does not exist
|
||||||
then fall back to \fI/usr/lib/os-release\fP. If the VARIABLE argument is not
|
then fall back to \fI/usr/lib/os-release\fP. If the VARIABLE argument is not
|
||||||
specified, then use PRETTY_NAME from the file or the system name (see \\s).
|
specified, then use PRETTY_NAME from the file or the system name (see \\s).
|
||||||
This escape code allows to keep \fI/etc/issue\fP distribution and release
|
This escape code can be used to keep \fI/etc/issue\fP distribution and release
|
||||||
independent. Note that \\S{ANSI_COLOR} is converted to the real terminal
|
independent. Note that \\S{ANSI_COLOR} is converted to the real terminal
|
||||||
escape sequence.
|
escape sequence.
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -49,7 +49,7 @@ and to store additional information about the session.
|
||||||
.PP
|
.PP
|
||||||
Since version 2.35
|
Since version 2.35
|
||||||
.B script
|
.B script
|
||||||
supports multiple streams and allows to log input and output to separate
|
supports multiple streams and allows the logging of input and output to separate
|
||||||
files or all the one file. This version also supports new timing file
|
files or all the one file. This version also supports new timing file
|
||||||
which records additional information. The command
|
which records additional information. The command
|
||||||
.B scriptreplay \-\-summary
|
.B scriptreplay \-\-summary
|
||||||
|
|
|
@ -67,7 +67,9 @@ Output is formatted to a width specified as number of characters. The original
|
||||||
name of this option is \-\-columns; this name is deprecated since v2.30. Note that input
|
name of this option is \-\-columns; this name is deprecated since v2.30. Note that input
|
||||||
longer than \fIwidth\fP is not truncated by default.
|
longer than \fIwidth\fP is not truncated by default.
|
||||||
.IP "\fB\-d, \-\-table\-noheadings\fP"
|
.IP "\fB\-d, \-\-table\-noheadings\fP"
|
||||||
Do not print header. This option allows to use logical column names on command line, but keep the header hidden when print the table.
|
Do not print header.
|
||||||
|
This option allows the use of logical column names on the command line,
|
||||||
|
but keeps the header hidden when printing the table.
|
||||||
.IP "\fB\-o, \-\-output\-separator\fP \fIstring\fP"
|
.IP "\fB\-o, \-\-output\-separator\fP \fIstring\fP"
|
||||||
Specify the columns delimiter for table output (default is two spaces).
|
Specify the columns delimiter for table output (default is two spaces).
|
||||||
.IP "\fB\-s, \-\-separator\fP \fIseparators\fP"
|
.IP "\fB\-s, \-\-separator\fP \fIseparators\fP"
|
||||||
|
@ -83,7 +85,7 @@ for the table header or to address column in option arguments.
|
||||||
.IP "\fB\-R, \-\-table-right\fP \fIcolumns\fP"
|
.IP "\fB\-R, \-\-table-right\fP \fIcolumns\fP"
|
||||||
Right align text in the specified columns.
|
Right align text in the specified columns.
|
||||||
.IP "\fB\-T, \-\-table-truncate\fP \fIcolumns\fP"
|
.IP "\fB\-T, \-\-table-truncate\fP \fIcolumns\fP"
|
||||||
Specify columns where is allowed to truncate text when necessary, otherwise
|
Specify columns where text can be truncated when necessary, otherwise
|
||||||
very long table entries may be printed on multiple lines.
|
very long table entries may be printed on multiple lines.
|
||||||
.IP "\fB\-E, \-\-table-noextreme\fP \fIcolumns\fP"
|
.IP "\fB\-E, \-\-table-noextreme\fP \fIcolumns\fP"
|
||||||
Specify columns where is possible to ignore unusually long (longer than
|
Specify columns where is possible to ignore unusually long (longer than
|
||||||
|
|
Loading…
Reference in New Issue