From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
To: util-linux@vger.kernel.org
Subject: [PATCH] man pages: Change a HYPHEN-MINUS (-) to a minus (\-) for options and numbers
Date: Mon, 16 Dec 2019 00:51:57 +0000 [thread overview]
Message-ID: <20191216005157.GA9796@rhi.hi.is> (raw)
Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of
1) a name of an option
2) a negative number to be printed.
See man-pages(7) [Debian package "manpages"].
The output from "nroff" is unchanged.
Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
disk-utils/fdisk.8 | 16 ++++++++--------
disk-utils/sfdisk.8 | 26 +++++++++++++-------------
login-utils/nologin.8 | 2 +-
login-utils/runuser.1 | 4 ++--
login-utils/utmpdump.1 | 2 +-
misc-utils/blkid.8 | 22 +++++++++++-----------
misc-utils/hardlink.1 | 4 ++--
misc-utils/kill.1 | 12 ++++++------
misc-utils/look.1 | 4 ++--
misc-utils/lsblk.8 | 12 ++++++------
misc-utils/lslocks.8 | 8 ++++----
misc-utils/rename.1 | 2 +-
misc-utils/uuidd.8.in | 8 ++++----
misc-utils/whereis.1 | 4 ++--
misc-utils/wipefs.8 | 10 +++++-----
schedutils/chrt.1 | 14 +++++++-------
schedutils/ionice.1 | 6 +++---
sys-utils/chmem.8 | 16 ++++++++--------
sys-utils/flock.1 | 14 +++++++-------
sys-utils/fstab.5 | 2 +-
sys-utils/fstrim.8 | 6 +++---
sys-utils/ipcrm.1 | 2 +-
sys-utils/ldattach.8 | 2 +-
sys-utils/losetup.8 | 18 +++++++++---------
sys-utils/lscpu.1 | 16 ++++++++--------
sys-utils/mount.8 | 24 ++++++++++++------------
sys-utils/pivot_root.8 | 4 ++--
sys-utils/prlimit.1 | 10 +++++-----
sys-utils/readprofile.8 | 10 +++++-----
sys-utils/renice.1 | 2 +-
sys-utils/setarch.8 | 10 +++++-----
sys-utils/setpriv.1 | 4 ++--
sys-utils/swapon.8 | 4 ++--
sys-utils/tunelp.8 | 2 +-
sys-utils/umount.8 | 4 ++--
sys-utils/unshare.1 | 36 ++++++++++++++++++------------------
term-utils/script.1 | 4 ++--
text-utils/column.1 | 18 +++++++++---------
text-utils/more.1 | 2 +-
39 files changed, 183 insertions(+), 183 deletions(-)
diff --git a/disk-utils/fdisk.8 b/disk-utils/fdisk.8
index c2321513e..cc172a0a5 100644
--- a/disk-utils/fdisk.8
+++ b/disk-utils/fdisk.8
@@ -37,7 +37,7 @@ sizes specified by the +/-<size>{M,G,...} notation are always aligned according
to the device properties.
CHS (Cylinder-Head-Sector) addressing is deprecated and not used by default.
-Please, do not follow old articles and recommendations with "fdisk -S <n> -H
+Please, do not follow old articles and recommendations with "fdisk \-S <n> \-H
<n>" advices for SSD or 4K-sector devices.
Note that
@@ -65,8 +65,8 @@ feature is supported for GPT and MBR.
Specify the compatibility mode, 'dos' or 'nondos'. The default is non-DOS
mode. For backward compatibility, it is possible to use the option without
the \fImode\fR argument -- then the default is used. Note that the optional
-\fImode\fR argument cannot be separated from the \fB-c\fR option by a space,
-the correct form is for example '-c=dos'.
+\fImode\fR argument cannot be separated from the \fB\-c\fR option by a space,
+the correct form is for example '\-c=dos'.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display a help text and exit.
@@ -89,7 +89,7 @@ Specify which output columns to print. Use
to get a list of all supported columns.
The default list of columns may be extended if \fIlist\fP is
-specified in the format \fI+list\fP (e.g., \fB-o +UUID\fP).
+specified in the format \fI+list\fP (e.g., \fB\-o +UUID\fP).
.TP
\fB\-s\fR, \fB\-\-getsz\fR
Print the size in 512-byte sectors of each given block device. This option is DEPRECATED
@@ -104,8 +104,8 @@ support for all other types.
When listing partition tables, show sizes in 'sectors' or in 'cylinders'. The
default is to show sizes in sectors. For backward compatibility, it is possible
to use the option without the \fIunit\fR argument -- then the default is used.
-Note that the optional \fIunit\fR argument cannot be separated from the \fB-u\fR
-option by a space, the correct form is for example '-u=cylinders'.
+Note that the optional \fIunit\fR argument cannot be separated from the \fB\-u\fR
+option by a space, the correct form is for example '\-u=cylinders'.
.TP
\fB\-C\fR, \fB\-\-cylinders\fR \fInumber\fR
@@ -168,7 +168,7 @@ The "last sector" dialog accepts partition size specified by number of sectors
or by +/-<size>{K,B,M,G,...} notation.
If the size is prefixed by '+' then it is interpreted as relative to the
-partition first sector. If the size is prefixed by '-' then it is interpreted
+partition first sector. If the size is prefixed by '\-' then it is interpreted
as relative to the high limit (last available sector for the partition).
In the case the size is specified in bytes than the number may be followed by
@@ -270,7 +270,7 @@ are performed before exiting when the partition table has been updated.
.B Note that all this is deprecated. You don't have to care about things like
.B geometry and cylinders on modern operating systems. If you really want
.B DOS-compatible partitioning then you have to enable DOS mode and cylinder
-.B units by using the '-c=dos -u=cylinders' fdisk command-line options.
+.B units by using the '\-c=dos \-u=cylinders' fdisk command-line options.
The DOS 6.x FORMAT command looks for some information in the first sector of
the data area of the partition, and treats this information as more reliable
diff --git a/disk-utils/sfdisk.8 b/disk-utils/sfdisk.8
index e7d7a272c..3ff5dd4e6 100644
--- a/disk-utils/sfdisk.8
+++ b/disk-utils/sfdisk.8
@@ -61,7 +61,7 @@ partitions.
.B sfdisk
uses BLKRRPART (reread partition table) ioctl to make sure that the device is
-not used by system or another tools (see also --no-reread). It's possible that
+not used by system or another tools (see also \-\-no-reread). It's possible that
this feature or another sfdisk activity races with \fBudevd\fR. The recommended way
how to avoid possible collisions is to use exclusive flock for the whole-disk
device to serialize device access. The exclusive lock will cause udevd to skip
@@ -97,7 +97,7 @@ unused partition given with \fB\-N\fR. See also \fB\-\-append\fR.
.TP
.BR \-A , " \-\-activate \fIdevice " [ \fIpartition-number...]
Switch on the bootable flag for the specified partitions and switch off the
-bootable flag on all unspecified partitions. The special placeholder '-'
+bootable flag on all unspecified partitions. The special placeholder '\-'
may be used instead of the partition numbers to switch off the bootable flag
on all partitions.
@@ -227,11 +227,11 @@ and the last command reorders partitions to match disk order
(the original sdc1 will become sdc2).
.RS
.sp
-.B "echo '+100M,' | sfdisk --move-data /dev/sdc -N 1"
+.B "echo '+100M,' | sfdisk \-\-move-data /dev/sdc \-N 1"
.br
-.B "echo '2048,' | sfdisk /dev/sdc --append
+.B "echo '2048,' | sfdisk /dev/sdc \-\-append
.br
-.B sfdisk /dev/sdc --reorder
+.B sfdisk /dev/sdc \-\-reorder
.sp
.RE
@@ -246,14 +246,14 @@ Specify which output columns to print. Use
to get a list of all supported columns.
.sp
The default list of columns may be extended if \fIlist\fP is
-specified in the format \fI+list\fP (e.g., \fB-o +UUID\fP).
+specified in the format \fI+list\fP (e.g., \fB\-o +UUID\fP).
.TP
.BR \-q , " \-\-quiet"
Suppress extra info messages.
.TP
.BR \-u , " \-\-unit S"
Deprecated option. Only the sector unit is supported. This option is not
-supported when using the --show-size command.
+supported when using the \-\-show-size command.
.TP
.BR \-X , " \-\-label " \fItype
Specify the disk label type (e.g., \fBdos\fR, \fBgpt\fR, ...). If this option
@@ -268,7 +268,7 @@ Force editing of a nested disk label. The primary disk label has to exist alrea
This option allows to edit for example a hybrid/protective MBR on devices with GPT.
.TP
-.BR -w , " \-\-wipe "\fIwhen
+.BR \-w , " \-\-wipe "\fIwhen
Wipe filesystem, RAID and partition-table signatures from the device, in order
to avoid possible collisions. The argument \fIwhen\fR can be \fBauto\fR,
\fBnever\fR or \fBalways\fR. When this option is not given, the default is
@@ -281,7 +281,7 @@ partition table is created. See also
command.
.TP
-.BR -W , " \-\-wipe-partitions "\fIwhen
+.BR \-W , " \-\-wipe-partitions "\fIwhen
Wipe filesystem, RAID and partition-table signatures from a newly created
partitions, in order to avoid possible collisions. The argument \fIwhen\fR can
be \fBauto\fR, \fBnever\fR or \fBalways\fR. When this option is not given, the
@@ -361,8 +361,8 @@ where each line fills one partition descriptor.
Fields are separated by whitespace, comma or semicolon possibly
followed by whitespace; initial and trailing whitespace is ignored.
Numbers can be octal, decimal or hexadecimal; decimal is the default.
-When a field is absent, empty or specified as '-' a default value is
-used. But when the \fB-N\fR option (change a single partition) is
+When a field is absent, empty or specified as '\-' a default value is
+used. But when the \fB\-N\fR option (change a single partition) is
given, the default for each field is its previous value.
.sp
The default value of
@@ -504,7 +504,7 @@ to a text file. The dump format is suitable for later \fBsfdisk\fR input.
For example:
.RS
.sp
-.B "sfdisk --dump /dev/sda > sda.dump"
+.B "sfdisk \-\-dump /dev/sda > sda.dump"
.sp
.RE
This can later be restored by:
@@ -524,7 +524,7 @@ Note that the same concept of backup files is used by
For example:
.RS
.sp
-.B "sfdisk --backup /dev/sda"
+.B "sfdisk \-\-backup /dev/sda"
.sp
.RE
The GPT header can later be restored by:
diff --git a/login-utils/nologin.8 b/login-utils/nologin.8
index d3882e2b1..054ed7344 100644
--- a/login-utils/nologin.8
+++ b/login-utils/nologin.8
@@ -43,7 +43,7 @@ is always 1.
These shell command-line options are ignored to avoid nologin error.
.IP "\fB\-h\fR, \fB\-\-help\fR"
Display help text and exit.
-.IP "\fB-V\fR, \fB\-\-version\fR"
+.IP "\fB\-V\fR, \fB\-\-version\fR"
Display version information and exit.
.SH NOTES
.B nologin
diff --git a/login-utils/runuser.1 b/login-utils/runuser.1
index 4f6064287..27dbf576c 100644
--- a/login-utils/runuser.1
+++ b/login-utils/runuser.1
@@ -106,12 +106,12 @@ Create pseudo-terminal for the session. The independent terminal provides
better security as user does not share terminal with the original
session. This allow to avoid TIOCSTI ioctl terminal injection and another
security attacks against terminal file descriptors. The all session is also
-possible to move to background (e.g., "runuser --pty -u username -- command &").
+possible to move to background (e.g., "runuser \-\-pty \-u username \-\- command &").
If the pseudo-terminal is enabled then runuser command works
as a proxy between the sessions (copy stdin and stdout).
.sp
This feature is mostly designed for interactive sessions. If the standard input
-is not a terminal, but for example pipe (e.g., echo "date" | runuser --pty -u user)
+is not a terminal, but for example pipe (e.g., echo "date" | runuser \-\-pty \-u user)
than ECHO flag for the pseudo-terminal is disabled to avoid messy output.
.TP
.BR \-m , " \-p" , " \-\-preserve\-environment"
diff --git a/login-utils/utmpdump.1 b/login-utils/utmpdump.1
index 9e6b5a3c2..d98117da4 100644
--- a/login-utils/utmpdump.1
+++ b/login-utils/utmpdump.1
@@ -51,7 +51,7 @@ out utmp/wtmp to an ASCII file, which can then be edited to remove
bogus entries, and reintegrated using:
.PP
.RS
-.B utmpdump -r < ascii_file > wtmp
+.B utmpdump \-r < ascii_file > wtmp
.RE
.PP
But be warned,
diff --git a/misc-utils/blkid.8 b/misc-utils/blkid.8
index b354f8c63..b3db17707 100644
--- a/misc-utils/blkid.8
+++ b/misc-utils/blkid.8
@@ -56,7 +56,7 @@ from the content metadata (e.g., LABEL or UUID fields).
.PP
.B It is recommended to use
.BR lsblk (8)
-.B command to get information about block devices, or lsblk --fs to get an overview of filesystems, or
+.B command to get information about block devices, or lsblk \-\-fs to get an overview of filesystems, or
.BR findmnt (8)
.B to search in already mounted filesystems.
.PP
@@ -90,7 +90,7 @@ more specified devices.
For security reasons
.B blkid
silently ignores all devices where the probing result is ambivalent (multiple
-colliding filesystems are detected). The low-level probing mode (\fB-p\fR)
+colliding filesystems are detected). The low-level probing mode (\fB\-p\fR)
provides more information and extra return code in this case.
It's recommended to use
.BR wipefs (8)
@@ -150,7 +150,7 @@ on systems where the same tag is used for multiple devices.
.TP
\fB\-L\fR, \fB\-\-label\fR \fIlabel\fR
Look up the device that uses this filesystem \fIlabel\fR; this is equal to
-.BR "--list-one --output device --match-token LABEL=\fIlabel\fR" .
+.BR "\-\-list-one \-\-output device \-\-match-token LABEL=\fIlabel\fR" .
This lookup method is able to reliably use /dev/disk/by-label
udev symlinks (dependent on a setting in /etc/blkid.conf). Avoid using the
symlinks directly; it is not reliable to use the symlinks without verification.
@@ -158,9 +158,9 @@ The \fB-\-label\fR option works on systems with and without udev.
Unfortunately, the original
.BR blkid (8)
-from e2fsprogs uses the \fB-L\fR option as a
-synonym for \fB-o list\fR. For better portability, use \fB-l -o device
--t LABEL=\fIlabel\fR and \fB-o list\fR in your scripts rather than the \fB-L\fR option.
+from e2fsprogs uses the \fB\-L\fR option as a
+synonym for \fB\-o list\fR. For better portability, use \fB\-l \-o device
+\-t LABEL=\fIlabel\fR and \fB\-o list\fR in your scripts rather than the \fB\-L\fR option.
.TP
\fB\-n\fR, \fB\-\-match\-types\fR \fIlist\fR
Restrict the probing functions to the specified (comma-separated) \fIlist\fR of
@@ -168,18 +168,18 @@ superblock types (names).
The list items may be prefixed with "no" to specify the types which should be ignored.
For example:
.sp
- blkid --probe --match-types vfat,ext3,ext4 /dev/sda1
+ blkid \-\-probe \-\-match-types vfat,ext3,ext4 /dev/sda1
.sp
probes for vfat, ext3 and ext4 filesystems, and
.sp
- blkid --probe --match-types nominix /dev/sda1
+ blkid \-\-probe \-\-match-types nominix /dev/sda1
.sp
probes for all supported formats except minix filesystems.
This option is only useful together with \fB\-\-probe\fR.
.TP
\fB\-o\fR, \fB\-\-output\fR \fIformat\fR
Use the specified output format. Note that the order of variables and
-devices is not fixed. See also option \fB-s\fR. The
+devices is not fixed. See also option \fB\-s\fR. The
.I format
parameter may be:
.RS
@@ -271,11 +271,11 @@ Restrict the probing functions to the specified (comma-separated) \fIlist\fR of
Supported usage types are: filesystem, raid, crypto and other. The list items may be
prefixed with "no" to specify the usage types which should be ignored. For example:
.sp
- blkid --probe --usages filesystem,other /dev/sda1
+ blkid \-\-probe \-\-usages filesystem,other /dev/sda1
.sp
probes for all filesystem and other (e.g., swap) formats, and
.sp
- blkid --probe --usages noraid /dev/sda1
+ blkid \-\-probe \-\-usages noraid /dev/sda1
.sp
probes for all supported formats except RAIDs.
This option is only useful together with \fB\-\-probe\fR.
diff --git a/misc-utils/hardlink.1 b/misc-utils/hardlink.1
index 738fac708..dcef8080e 100644
--- a/misc-utils/hardlink.1
+++ b/misc-utils/hardlink.1
@@ -34,7 +34,7 @@ Do not perform the consolidation; only print what would be changed.
.TP
.BR \-v , " \-\-verbose"
Print summary after hardlinking. The option may be specified more than once. In
-this case (e.g., \fB-vv\fR) it prints every hardlinked file and bytes saved.
+this case (e.g., \fB\-vv\fR) it prints every hardlinked file and bytes saved.
.TP
.BR \-x , " \-\-exclude " \fIregex\fR
Exclude files and directories matching pattern from hardlinking.
@@ -66,7 +66,7 @@ Historically \fBhardlink\fR silently excluded any names beginning with
".in.", as well as any names beginning with "." followed by exactly 6
other characters. That prior behavior can be achieved by specifying
.br
--x '^(\\.in\\.|\\.[^.]{6}$)'
+\-x '^(\\.in\\.|\\.[^.]{6}$)'
.SH AVAILABILITY
The hardlink command is part of the util-linux package and is available from
https://www.kernel.org/pub/linux/utils/util-linux/.
diff --git a/misc-utils/kill.1 b/misc-utils/kill.1
index 7a772e8d6..24cfe7999 100644
--- a/misc-utils/kill.1
+++ b/misc-utils/kill.1
@@ -7,7 +7,7 @@ kill \- terminate a process
.SH SYNOPSIS
.B kill
.RB [ \- \fIsignal\fR| \-s
-.IR signal | \fB-p\fP ]
+.IR signal | \fB\-p\fP ]
.RB [ \-q
.IR value ]
.RB [ \-a ]
@@ -62,17 +62,17 @@ is signaled.
.B 0
All processes in the current process group are signaled.
.TP
-.B -1
+.B \-1
All processes with a PID larger than 1 are signaled.
.TP
-.BI - n
+.BI \- n
where
.I n
is larger than 1. All processes in process group
.I n
-are signaled. When an argument of the form '-n' is given, and it is meant to
+are signaled. When an argument of the form '\-n' is given, and it is meant to
denote a process group, either a signal must be specified first, or the
-argument must be preceded by a '--' option, otherwise it will be taken as the
+argument must be preceded by a '\-\-' option, otherwise it will be taken as the
signal to send.
.RE
.TP
@@ -146,7 +146,7 @@ option.
Example. Send signals QUIT, TERM and KILL in sequence and wait for 1000
milliseconds between the signals
.br
-kill --verbose --timeout 1000 TERM --timeout 1000 KILL --signal QUIT 12345
+kill \-\-verbose \-\-timeout 1000 TERM \-\-timeout 1000 KILL \-\-signal QUIT 12345
.SH NOTES
Although it is possible to specify the TID (thread ID, see
.BR gettid (2))
diff --git a/misc-utils/look.1 b/misc-utils/look.1
index 28a724d81..eb3e2103f 100644
--- a/misc-utils/look.1
+++ b/misc-utils/look.1
@@ -97,8 +97,8 @@ no lines were found, and >1 if an error occurred.
.SH EXAMPLE
.RS
.nf
-sort -d /etc/passwd -o /tmp/look.dict
-look -t: root:foobar /tmp/look.dict
+sort \-d /etc/passwd \-o /tmp/look.dict
+look \-t: root:foobar /tmp/look.dict
.nf
.RE
.SH ENVIRONMENT
diff --git a/misc-utils/lsblk.8 b/misc-utils/lsblk.8
index f46f89bc7..373a80ee2 100644
--- a/misc-utils/lsblk.8
+++ b/misc-utils/lsblk.8
@@ -19,7 +19,7 @@ are necessary.
.PP
The command prints all block devices (except RAM disks) in a tree-like format
by default. Use
-.B "lsblk --help"
+.B "lsblk \-\-help"
to get a list of all available columns.
.PP
The default output, as well as the default output from options like
@@ -54,7 +54,7 @@ Print the SIZE column in bytes rather than in a human-readable format.
Print information about the discarding capabilities (TRIM, UNMAP) for each device.
.TP
.BR \-d , " \-\-nodeps"
-Do not print holder devices or slaves. For example, \fBlsblk --nodeps /dev/sda\fR prints
+Do not print holder devices or slaves. For example, \fBlsblk \-\-nodeps /dev/sda\fR prints
information about the sda device only.
.TP
.BR \-E , " \-\-dedup " \fIcolumn\fP
@@ -73,7 +73,7 @@ The filter is applied to the top-level devices only. This may be confusing for
.TP
.BR \-f , " \-\-fs"
Output info about filesystems. This option is equivalent to
-.BR -o\ NAME,FSTYPE,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINT .
+.BR \-o\ NAME,FSTYPE,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINT .
The authoritative information about filesystems and raids is provided by the
.BR blkid (8)
command.
@@ -104,7 +104,7 @@ Multi-path devices. The tree-like output is required.
.TP
.BR \-m , " \-\-perms"
Output info about device owner, group and mode. This option is equivalent to
-.BR -o\ NAME,SIZE,OWNER,GROUP,MODE .
+.BR \-o\ NAME,SIZE,OWNER,GROUP,MODE .
.TP
.BR \-n , " \-\-noheadings"
Do not print a header line.
@@ -116,7 +116,7 @@ to get a list of all supported columns. The columns may affect tree-like output
The default is to use tree for the column 'NAME' (see also \fB\-\-tree\fR).
The default list of columns may be extended if \fIlist\fP is
-specified in the format \fI+list\fP (e.g., \fBlsblk -o +UUID\fP).
+specified in the format \fI+list\fP (e.g., \fBlsblk \-o +UUID\fP).
.TP
.BR \-O , " \-\-output\-all "
Output all available columns.
@@ -146,7 +146,7 @@ The default is NAME column.
.BR \-t , " \-\-topology"
Output info about block-device topology.
This option is equivalent to
-.BR -o\ NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME .
+.BR \-o\ NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME .
.TP
.BR \-V , " \-\-version"
Display version information and exit.
diff --git a/misc-utils/lslocks.8 b/misc-utils/lslocks.8
index bcafe43a0..f48feba19 100644
--- a/misc-utils/lslocks.8
+++ b/misc-utils/lslocks.8
@@ -14,7 +14,7 @@ lslocks \- list local system locks
lists information about all the currently held file locks in a Linux system.
.sp
Note that lslocks also lists OFD (Open File Description) locks, these locks are
-not associated with any process (PID is -1). OFD locks are associated with the
+not associated with any process (PID is \-1). OFD locks are associated with the
open file description on which they are acquired. This lock type is available
since Linux 3.15, see \fBfcntl\fR(2) for more details.
@@ -34,11 +34,11 @@ Do not print a header line.
.TP
.BR \-o , " \-\-output " \fIlist\fP
Specify which output columns to print. Use
-.B "--help"
+.B \-\-help
to get a list of all supported columns.
The default list of columns may be extended if \fIlist\fP is
-specified in the format \fI+list\fP (e.g., \fBlslocks -o +BLOCKER\fP).
+specified in the format \fI+list\fP (e.g., \fBlslocks \-o +BLOCKER\fP).
.TP
.B \-\-output\-all
Output all available columns.
@@ -62,7 +62,7 @@ Display help text and exit.
.IP "COMMAND"
The command name of the process holding the lock.
.IP "PID"
-The process ID of the process which holds the lock or -1 for OFDLCK.
+The process ID of the process which holds the lock or \-1 for OFDLCK.
.IP "TYPE"
The type of lock; can be FLOCK (created with \fBflock\fR(2)), POSIX
(created with \fBfcntl\fR(2) and \fBlockf\fR(3)) or OFDLCK (created with fcntl(2).
diff --git a/misc-utils/rename.1 b/misc-utils/rename.1
index cd90e64b4..d8fdd6d94 100644
--- a/misc-utils/rename.1
+++ b/misc-utils/rename.1
@@ -92,7 +92,7 @@ mode, run for example:
.RS
.PP
.nf
-sh -c 'stty -icanon min 1; "$0" "$@"; stty icanon' rename -i from to files
+sh \-c 'stty \-icanon min 1; "$0" "$@"; stty icanon' rename \-i from to files
.fi
.PP
.RE
diff --git a/misc-utils/uuidd.8.in b/misc-utils/uuidd.8.in
index 0a5cf471b..75bcc7c67 100644
--- a/misc-utils/uuidd.8.in
+++ b/misc-utils/uuidd.8.in
@@ -48,7 +48,7 @@ request it to return a random-based UUID.
.TP
.BR \-S , " \-\-socket-activation "
Do not create a socket but instead expect it to be provided by the calling
-process. This implies \fB--no-fork\fR and \fB--no-pid\fR. This option is
+process. This implies \fB\-\-no-fork\fR and \fB\-\-no-pid\fR. This option is
intended to be used only with \fBsystemd\fR(1). It needs to be enabled with
a configure option.
.TP
@@ -75,9 +75,9 @@ Start up a daemon, print 42 random keys, and then stop the daemon:
.PP
.RS
.nf
-uuidd -p /tmp/uuidd.pid -s /tmp/uuidd.socket
-uuidd -d -r -n 42 -s /tmp/uuidd.socket
-uuidd -d -k -s /tmp/uuidd.socket
+uuidd \-p /tmp/uuidd.pid \-s /tmp/uuidd.socket
+uuidd \-d \-r \-n 42 \-s /tmp/uuidd.socket
+uuidd \-d \-k \-s /tmp/uuidd.socket
.nf
.RE
.SH AUTHOR
diff --git a/misc-utils/whereis.1 b/misc-utils/whereis.1
index a69395907..83182b067 100644
--- a/misc-utils/whereis.1
+++ b/misc-utils/whereis.1
@@ -63,7 +63,7 @@ the command line. Any new search restriction resets the search mask.
For example,
.RS
.sp
-.B "whereis -bm ls tr -m gcc"
+.B "whereis \-bm ls tr \-m gcc"
.sp
.RE
searches for "ls" and "tr" binaries and man pages, and for "gcc" man pages only.
@@ -72,7 +72,7 @@ The options \fB\-B\fP, \fB\-M\fP and \fB\-S\fP reset search paths for the
subsequent \fIname\fP patterns. For example,
.RS
.sp
-.B "whereis -m ls -M /usr/share/man/man1 -f cal"
+.B "whereis \-m ls \-M /usr/share/man/man1 \-f cal"
.sp
.RE
searches for "ls" man pages in all default paths, but for "cal" in
diff --git a/misc-utils/wipefs.8 b/misc-utils/wipefs.8
index e47b780d3..a6f8be7a5 100644
--- a/misc-utils/wipefs.8
+++ b/misc-utils/wipefs.8
@@ -47,7 +47,7 @@ the device (e.g., FAT, ZFS, GPT). The
command (since v2.31) lists all the offset where a magic strings have been
detected.
-When option \fB-a\fR is used, all magic strings that are visible for libblkid are
+When option \fB\-a\fR is used, all magic strings that are visible for libblkid are
erased. In this case the
.B wipefs
scans the device again after each modification (erase) until no magic string is found.
@@ -84,13 +84,13 @@ Do not print a header line.
Specify which output columns to print. Use \-\-help to
get a list of all supported columns.
.TP
-.BR -n , " \-\-no\-act"
+.BR \-n , " \-\-no\-act"
Causes everything to be done except for the write() call.
.TP
.BR \-o , " \-\-offset " \fIoffset\fP
Specify the location (in bytes) of the signature which should be erased from the
device. The \fIoffset\fR number may include a "0x" prefix; then the number will be
-interpreted as a hex value. It is possible to specify multiple \fB-o\fR options.
+interpreted as a hex value. It is possible to specify multiple \fB\-o\fR options.
.sp
The \fIoffset\fR argument may be followed by the multiplicative
suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB
@@ -110,14 +110,14 @@ be specified in a comma-separated list. The list or individual types
can be prefixed with 'no' to specify the types on which no action should be
taken. For more details see mount(8).
.TP
-.BR -V , " \-\-version"
+.BR \-V , " \-\-version"
Display version information and exit.
.SH EXAMPLES
.TP
.B wipefs /dev/sda*
Prints information about sda and all partitions on sda.
.TP
-.B wipefs --all --backup /dev/sdb
+.B wipefs \-\-all \-\-backup /dev/sdb
Erases all signatures from the device /dev/sdb and creates a signature backup
file ~/wipefs-sdb-<offset>.bak for each signature.
.TP
diff --git a/schedutils/chrt.1 b/schedutils/chrt.1
index 166579e2d..6dbb0ec03 100644
--- a/schedutils/chrt.1
+++ b/schedutils/chrt.1
@@ -66,7 +66,7 @@ Set scheduling policy to
.B SCHED_IDLE
(Linux-specific, supported since 2.6.23). The priority argument has to be set to zero.
.TP
-.BR -d ,\ --deadline
+.BR \-d ,\ \-\-deadline
Set scheduling policy to
.B SCHED_DEADLINE
(Linux-specific, supported since 3.14). The priority argument has to be set to zero.
@@ -102,23 +102,23 @@ scheduling policy (Linux-specific, supported since 2.6.31).
.SH OPTIONS
.TP
-.BR -a ,\ --all-tasks
+.BR \-a ,\ \-\-all-tasks
Set or retrieve the scheduling attributes of all the tasks (threads) for a
given PID.
.TP
-.BR -m ,\ --max
+.BR \-m ,\ \-\-max
Show minimum and maximum valid priorities, then exit.
.TP
-.BR -p ,\ --pid
+.BR \-p ,\ \-\-pid
Operate on an existing PID and do not launch a new task.
.TP
-.BR -v ,\ --verbose
+.BR \-v ,\ \-\-verbose
Show status information.
.TP
-.BR -V ,\ --version
+.BR \-V ,\ \-\-version
Display version information and exit.
.TP
-.BR -h ,\ --help
+.BR \-h ,\ \-\-help
Display help text and exit.
.SH USAGE
.TP
diff --git a/schedutils/ionice.1 b/schedutils/ionice.1
index 1b075d3e3..fa5c1ad19 100644
--- a/schedutils/ionice.1
+++ b/schedutils/ionice.1
@@ -116,15 +116,15 @@ Display version information and exit.
.SH EXAMPLES
.LP
.TP 7
-# \fBionice\fP -c 3 -p 89
+# \fBionice\fP \-c 3 \-p 89
.TP 7
Sets process with PID 89 as an idle I/O process.
.TP 7
-# \fBionice\fP -c 2 -n 0 bash
+# \fBionice\fP \-c 2 \-n 0 bash
.TP 7
Runs 'bash' as a best-effort program with highest priority.
.TP 7
-# \fBionice\fP -p 89 91
+# \fBionice\fP \-p 89 91
.TP 7
Prints the class and priority of the processes with PID 89 and 91.
.SH NOTES
diff --git a/sys-utils/chmem.8 b/sys-utils/chmem.8
index 21bcc14c0..c0941ea70 100644
--- a/sys-utils/chmem.8
+++ b/sys-utils/chmem.8
@@ -24,15 +24,15 @@ Specify \fIBLOCKRANGE\fP in the form <first>-<last> or <block> as shown in the
output of the \fBlsmem\fP command. <first> is the number of the first memory block
and <last> is the number of the last memory block in the memory
range. Alternatively a single block can be specified. \fIBLOCKRANGE\fP requires
-the \fB--blocks\fP option.
+the \fB\-\-blocks\fP option.
.
.IP "\(hy" 2
Specify \fIZONE\fP as the name of a memory zone, as shown in the output of the
-\fBlsmem -o +ZONES\fP command. The output shows one or more valid memory zones
+\fBlsmem \-o +ZONES\fP command. The output shows one or more valid memory zones
for each memory range. If multiple zones are shown, then the memory range
currently belongs to the first zone. By default, chmem will set memory online
to the zone Movable, if this is among the valid zones. This default can be
-changed by specifying the \fB--zone\fP option with another valid zone.
+changed by specifying the \fB\-\-zone\fP option with another valid zone.
For memory ballooning, it is recommended to select the zone Movable for memory
online and offline, if possible. Memory in this zone is much more likely to be
able to be offlined again, but it cannot be used for arbitrary kernel
@@ -57,7 +57,7 @@ block numbers.
.TP
.BR \-b ", " \-\-blocks
Use a \fIBLOCKRANGE\fP parameter instead of \fIRANGE\fP or \fISIZE\fP for the
-\fB--enable\fP and \fB--disable\fP options.
+\fB\-\-enable\fP and \fB\-\-disable\fP options.
.TP
.BR \-d ", " \-\-disable
Set the specified \fIRANGE\fP, \fISIZE\fP, or \fIBLOCKRANGE\fP of memory offline.
@@ -93,17 +93,17 @@ failure
partial success
.SH EXAMPLES
.TP
-.B chmem --enable 1024
+.B chmem \-\-enable 1024
This command requests 1024 MiB of memory to be set online.
.TP
-.B chmem -e 2g
+.B chmem \-e 2g
This command requests 2 GiB of memory to be set online.
.TP
-.B chmem --disable 0x00000000e4000000-0x00000000f3ffffff
+.B chmem \-\-disable 0x00000000e4000000-0x00000000f3ffffff
This command requests the memory range starting with 0x00000000e4000000
and ending with 0x00000000f3ffffff to be set offline.
.TP
-.B chmem -b -d 10
+.B chmem \-b \-d 10
This command requests the memory block number 10 to be set offline.
.SH SEE ALSO
.BR lsmem (1)
diff --git a/sys-utils/flock.1 b/sys-utils/flock.1
index 5b1d635b4..0a4da9d46 100644
--- a/sys-utils/flock.1
+++ b/sys-utils/flock.1
@@ -126,23 +126,23 @@ Display version information and exit.
Display help text and exit.
.SH EXAMPLES
.TP
-shell1> flock /tmp -c cat
+shell1> flock /tmp \-c cat
.TQ
-shell2> flock -w .007 /tmp -c echo; /bin/echo $?
+shell2> flock \-w .007 /tmp \-c echo; /bin/echo $?
Set exclusive lock to directory /tmp and the second command will fail.
.TP
-shell1> flock -s /tmp -c cat
+shell1> flock \-s /tmp \-c cat
.TQ
-shell2> flock -s -w .007 /tmp -c echo; /bin/echo $?
+shell2> flock \-s \-w .007 /tmp \-c echo; /bin/echo $?
Set shared lock to directory /tmp and the second command will not fail.
Notice that attempting to get exclusive lock with second command would fail.
.TP
-shell> flock -x local-lock-file echo 'a b c'
+shell> flock \-x local-lock-file echo 'a b c'
Grab the exclusive lock "local-lock-file" before running echo with 'a b c'.
.TP
(
.TQ
- flock -n 9 || exit 1
+ flock \-n 9 || exit 1
.TQ
# ... commands executed under lock ...
.TQ
@@ -159,7 +159,7 @@ write permission is required. Using
.I <
requires that the file already exists but only read permission is required.
.TP
-[ "${FLOCKER}" != "$0" ] && exec env FLOCKER="$0" flock -en "$0" "$0" "$@" || :
+[ "${FLOCKER}" != "$0" ] && exec env FLOCKER="$0" flock \-en "$0" "$0" "$@" || :
This is useful boilerplate code for shell scripts. Put it at the top of the
shell script you want to lock and it'll automatically lock itself on the first
run. If the env var $FLOCKER is not set to the shell script that is being run,
diff --git a/sys-utils/fstab.5 b/sys-utils/fstab.5
index 6e2ea7abc..94235b2ae 100644
--- a/sys-utils/fstab.5
+++ b/sys-utils/fstab.5
@@ -174,7 +174,7 @@ Basic filesystem-independent options are:
use default options: rw, suid, dev, exec, auto, nouser, and async.
.TP
.B noauto
-do not mount when "mount -a" is given (e.g., at boot time)
+do not mount when "mount \-a" is given (e.g., at boot time)
.TP
.B user
allow a user to mount
diff --git a/sys-utils/fstrim.8 b/sys-utils/fstrim.8
index eba52ab9e..a7adc6a03 100644
--- a/sys-utils/fstrim.8
+++ b/sys-utils/fstrim.8
@@ -32,7 +32,7 @@ is mounted.
Running
.B fstrim
frequently, or even using
-.BR "mount -o discard" ,
+.BR "mount \-o discard" ,
might negatively affect the lifetime of poor-quality SSD devices. For most
desktop and server systems a sufficient trimming frequency is once a week.
Note that not all
@@ -96,7 +96,7 @@ storage device. Further, the kernel block layer reserves the right to adjust
the discard ranges to fit raid stripe geometry, non-trim capable devices in a
LVM setup, etc. These reductions would not be reflected in fstrim_range.len
(the
-.B --length
+.B \-\-length
option).
.TP
.B \-\-quiet
@@ -125,7 +125,7 @@ all failed
some filesystem discards have succeeded, some failed
.PP
The command
-.B fstrim --all
+.B fstrim \-\-all
returns 0 (all succeeded), 32 (all failed) or 64 (some failed, some succeeded).
.SH AUTHOR
diff --git a/sys-utils/ipcrm.1 b/sys-utils/ipcrm.1
index be73dff5a..6bb93f6bc 100644
--- a/sys-utils/ipcrm.1
+++ b/sys-utils/ipcrm.1
@@ -47,7 +47,7 @@ The identifiers and keys can be found by using
.BR ipcs (1).
.SH OPTIONS
.TP
-\fB-a\fR, \fB\-\-all\fR [\fBshm\fR] [\fBmsg\fR] [\fBsem\fR]
+\fB\-a\fR, \fB\-\-all\fR [\fBshm\fR] [\fBmsg\fR] [\fBsem\fR]
Remove all resources. When an option argument is provided, the removal is
performed only for the specified resource types. \fIWarning!\fR Do not use
.B \-a
diff --git a/sys-utils/ldattach.8 b/sys-utils/ldattach.8
index 1b4683dcd..5c71dbcab 100644
--- a/sys-utils/ldattach.8
+++ b/sys-utils/ldattach.8
@@ -113,7 +113,7 @@ and to print verbose messages about its progress to standard error output.
.BR \-e , " \-\-evenparity"
Set the parity of the serial line to even.
.TP
-.BR -i , " --iflag " [ \- ] \fIvalue\fR...
+.BR \-i , " \-\-iflag " [ \- ] \fIvalue\fR...
Set the specified bits in the c_iflag word of the serial line.
The given \fIvalue\fP may be a number or a symbolic name.
If \fIvalue\fP is prefixed by a minus sign, the specified bits are cleared
diff --git a/sys-utils/losetup.8 b/sys-utils/losetup.8
index a14e7cb33..4cf548741 100644
--- a/sys-utils/losetup.8
+++ b/sys-utils/losetup.8
@@ -9,10 +9,10 @@ Get info:
.B losetup
[\fIloopdev\fP]
.sp
-.B losetup -l
+.B losetup \-l
.RB [ \-a ]
.sp
-.B losetup -j
+.B losetup \-j
.I file
.RB [ \-o
.IR offset ]
@@ -61,8 +61,8 @@ to detach loop devices, and to query the status of a loop device. If only the
\fIloopdev\fP argument is given, the status of the corresponding loop
device is shown. If no option is given, all loop devices are shown.
.sp
-Note that the old output format (i.e., \fBlosetup -a\fR) with comma-delimited
-strings is deprecated in favour of the \fB--list\fR output format.
+Note that the old output format (i.e., \fBlosetup \-a\fR) with comma-delimited
+strings is deprecated in favour of the \fB\-\-list\fR output format.
.sp
It's possible to create more independent loop devices for the same backing
file.
@@ -80,7 +80,7 @@ KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB and YB.
.BR \-a , " \-\-all"
Show the status of all loop devices. Note that not all information is accessible
for non-root users. See also \fB\-\-list\fR. The old output format (as printed
-without \fB--list)\fR is deprecated.
+without \fB\-\-list)\fR is deprecated.
.TP
.BR \-d , " \-\-detach " \fIloopdev\fR...
Detach the file or device associated with the specified loop device(s). Note
@@ -140,7 +140,7 @@ to \fBon\fR.
Verbose mode.
.TP
.BR \-l , " \-\-list"
-If a loop device or the \fB-a\fR option is specified, print the default columns
+If a loop device or the \fB\-a\fR option is specified, print the default columns
for either the specified loop device or all loop devices; the default is to
print info about all devices. See also \fB\-\-output\fP, \fB\-\-noheadings\fP,
\fB\-\-raw\fP, and \fB\-\-json\fP.
@@ -191,13 +191,13 @@ The following commands can be used as an example of using the loop device.
.nf
.IP
# dd if=/dev/zero of=~/file.img bs=1024k count=10
-# losetup --find --show ~/file.img
+# losetup \-\-find \-\-show ~/file.img
/dev/loop0
-# mkfs -t ext2 /dev/loop0
+# mkfs \-t ext2 /dev/loop0
# mount /dev/loop0 /mnt
...
# umount /dev/loop0
-# losetup --detach /dev/loop0
+# losetup \-\-detach /dev/loop0
.fi
.SH ENVIRONMENT
.IP LOOPDEV_DEBUG=all
diff --git a/sys-utils/lscpu.1 b/sys-utils/lscpu.1
index 9abffc6fe..8f45997c2 100644
--- a/sys-utils/lscpu.1
+++ b/sys-utils/lscpu.1
@@ -104,15 +104,15 @@ Minimum megahertz value for the CPU.
.SH OPTIONS
.TP
.BR \-a , " \-\-all"
-Include lines for online and offline CPUs in the output (default for \fB-e\fR).
-This option may only be specified together with option \fB-e\fR or \fB-p\fR.
+Include lines for online and offline CPUs in the output (default for \fB\-e\fR).
+This option may only be specified together with option \fB\-e\fR or \fB\-p\fR.
.TP
.BR \-B , " \-\-bytes"
Print the sizes in bytes rather than in a human-readable format.
.TP
.BR \-b , " \-\-online"
-Limit the output to online CPUs (default for \fB-p\fR).
-This option may only be specified together with option \fB-e\fR or \fB-p\fR.
+Limit the output to online CPUs (default for \fB\-p\fR).
+This option may only be specified together with option \fB\-e\fR or \fB\-p\fR.
.TP
.BR \-C , " \-\-caches" [=\fIlist\fP]
Display details about CPU caches. For details about available information see \fB\-\-help\fR
@@ -123,11 +123,11 @@ are included in the command output.
When specifying the \fIlist\fP argument, the string of option, equal sign (=), and
\fIlist\fP must not contain any blanks or other whitespace.
-Examples: '\fB-C=NAME,ONE-SIZE\fP' or '\fB--caches=NAME,ONE-SIZE\fP'.
+Examples: '\fB\-C=NAME,ONE-SIZE\fP' or '\fB\-\-caches=NAME,ONE-SIZE\fP'.
.TP
.BR \-c , " \-\-offline"
Limit the output to offline CPUs.
-This option may only be specified together with option \fB-e\fR or \fB-p\fR.
+This option may only be specified together with option \fB\-e\fR or \fB\-p\fR.
.TP
.BR \-e , " \-\-extended" [=\fIlist\fP]
Display the CPU information in human-readable format.
@@ -137,7 +137,7 @@ are included in the command output.
When specifying the \fIlist\fP argument, the string of option, equal sign (=), and
\fIlist\fP must not contain any blanks or other whitespace.
-Examples: '\fB-e=cpu,node\fP' or '\fB--extended=cpu,node\fP'.
+Examples: '\fB\-e=cpu,node\fP' or '\fB\-\-extended=cpu,node\fP'.
.TP
.BR \-h , " \-\-help"
Display help text and exit.
@@ -156,7 +156,7 @@ If the \fIlist\fP argument is used, cache columns are separated with a colon (:)
When specifying the \fIlist\fP argument, the string of option, equal sign (=), and
\fIlist\fP must not contain any blanks or other whitespace.
-Examples: '\fB-p=cpu,node\fP' or '\fB--parse=cpu,node\fP'.
+Examples: '\fB\-p=cpu,node\fP' or '\fB\-\-parse=cpu,node\fP'.
.TP
.BR \-s , " \-\-sysroot " \fIdirectory\fP
Gather CPU data for a Linux instance other than the instance from which the
diff --git a/sys-utils/mount.8 b/sys-utils/mount.8
index 97ee5bddd..6a02a85bf 100644
--- a/sys-utils/mount.8
+++ b/sys-utils/mount.8
@@ -154,8 +154,8 @@ adding or removing a device can cause changes in names. This is the reason why i
strongly recommended to use filesystem or partition identifiers like UUID or
LABEL.
-The command \fBlsblk --fs\fR provides an overview of filesystems, LABELs and UUIDs
-on available block devices. The command \fBblkid -p <device>\fR provides details about
+The command \fBlsblk \-\-fs\fR provides an overview of filesystems, LABELs and UUIDs
+on available block devices. The command \fBblkid \-p <device>\fR provides details about
a filesystem on the specified device.
Don't forget that there is no guarantee that UUIDs and labels are really
@@ -403,7 +403,7 @@ For example:
.RS
.br
-.B mount -o bind,ro foo foo
+.B mount \-o bind,ro foo foo
.RE
This feature is not supported by the Linux kernel; it is implemented in userspace
@@ -432,14 +432,14 @@ will be read-only.
It's also possible to change nosuid, nodev, noexec, noatime, nodiratime and
relatime VFS entry flags by "remount,bind" operation. The another (for example
filesystem specific flags) are silently ignored. It's impossible to change mount
-options recursively (for example with \fB-o rbind,ro\fR).
+options recursively (for example with \fB\-o rbind,ro\fR).
.BR mount (8)
since v2.31 ignores the \fBbind\fR flag from
.I /etc/fstab
on
.B remount operation
-(if "-o remount" specified on command line). This is necessary to fully control
+(if "\-o remount" specified on command line). This is necessary to fully control
mount options on remount by command line. In the previous versions the bind
flag has been always applied and it was impossible to re-define mount options
without interaction with the bind semantic. This
@@ -606,7 +606,7 @@ Don't canonicalize paths. The mount command canonicalizes all paths
together with the
.B \-f
flag for already canonicalized absolute paths. The option is designed for mount
-helpers which call \fBmount -i\fR. It is strongly recommended to not use this
+helpers which call \fBmount \-i\fR. It is strongly recommended to not use this
command-line option for normal mount operations.
.sp
Note that \fBmount\fR(8) does not pass this option to the
@@ -827,7 +827,7 @@ is used to indicate the filesystem type. The filesystem types which are
currently supported depend on the running kernel. See
.I /proc/filesystems
and
-.I /lib/modules/$(uname -r)/kernel/fs
+.I /lib/modules/$(uname \-r)/kernel/fs
for a complete list of the filesystems. The most common are ext2, ext3, ext4,
xfs, btrfs, vfat, sysfs, proc, nfs and cifs.
.sp
@@ -1244,7 +1244,7 @@ mount(8) allows to use \fB\-\-all\fR to remount all already mounted filesystems
which match a specified filter (\fB\-O\fR and \fB\-t\fR). For example:
.sp
.in +4
-.B "mount \-\-all \-o remount,ro -t vfat"
+.B "mount \-\-all \-o remount,ro \-t vfat"
.in
.sp
remounts all already mounted vfat filesystems in read-only mode. The each of the
@@ -1634,7 +1634,7 @@ previously pointed at one file to point at a different file,
potentially causing data corruption. For this reason, this
option also mounts the filesystem readonly.
-To maintain backward compatibility, '-o nfs' is also accepted,
+To maintain backward compatibility, '\-o nfs' is also accepted,
defaulting to
.BR stale_rw .
.TP
@@ -2144,7 +2144,7 @@ Make all files in the filesystem belong to the given user.
uid=forget can be specified independently of (or usually in
addition to) uid=<user> and results in UDF
not storing uids to the media. In fact the recorded uid
-is the 32-bit overflow uid -1 as defined by the UDF standard.
+is the 32-bit overflow uid \-1 as defined by the UDF standard.
The value is given as either <user> which is a valid user name or the corresponding
decimal user id, or the special string "forget".
.TP
@@ -2153,7 +2153,7 @@ Make all files in the filesystem belong to the given group.
gid=forget can be specified independently of (or usually in
addition to) gid=<group> and results in UDF
not storing gids to the media. In fact the recorded gid
-is the 32-bit overflow gid -1 as defined by the UDF standard.
+is the 32-bit overflow gid \-1 as defined by the UDF standard.
The value is given as either <group> which is a valid group name or the corresponding
decimal group id, or the special string "forget".
.TP
@@ -2423,7 +2423,7 @@ For example commands:
.B mksquashfs /etc /tmp/etc.squashfs
.B dd if=/dev/zero of=/tmp/etc.hash bs=1M count=10
.B veritysetup format /tmp/etc.squashfs /tmp/etc.hash
-.B mount -o verity.hashdevice=/tmp/etc.hash,verity.roothash=<hash> /tmp/etc.squashfs /mnt
+.B mount \-o verity.hashdevice=/tmp/etc.hash,verity.roothash=<hash> /tmp/etc.squashfs /mnt
.fi
.RE
.sp
diff --git a/sys-utils/pivot_root.8 b/sys-utils/pivot_root.8
index febedd03b..ace49dac7 100644
--- a/sys-utils/pivot_root.8
+++ b/sys-utils/pivot_root.8
@@ -57,11 +57,11 @@ Mount the new root file system over NFS from 10.0.0.1:/my_root and run
ifconfig lo 127.0.0.1 up # for portmap
# configure Ethernet or such
portmap # for lockd (implicitly started by mount)
-mount -o ro 10.0.0.1:/my_root /mnt
+mount \-o ro 10.0.0.1:/my_root /mnt
killall portmap # portmap keeps old root busy
cd /mnt
pivot_root . old_root
-exec chroot . sh -c 'umount /old_root; exec /sbin/init' \\
+exec chroot . sh \-c 'umount /old_root; exec /sbin/init' \\
<dev/console >dev/console 2>&1
.fi
.SH "SEE ALSO"
diff --git a/sys-utils/prlimit.1 b/sys-utils/prlimit.1
index 86d3e2123..96cb92d44 100644
--- a/sys-utils/prlimit.1
+++ b/sys-utils/prlimit.1
@@ -26,7 +26,7 @@ The \fIlimits\fP parameter is composed of a soft and a hard value, separated
by a colon (:), in order to modify the existing values. If no \fIlimits\fR are
given, \fBprlimit\fP will display the current values. If one of the values
is not given, then the existing one will be used. To specify the unlimited or
-infinity limit (RLIM_INFINITY), the -1 or 'unlimited' string can be passed.
+infinity limit (RLIM_INFINITY), the \-1 or 'unlimited' string can be passed.
Because of the nature of limits, the soft limit must be lower or equal to the
high limit (also called the ceiling). To see all available resource limits,
@@ -92,15 +92,15 @@ Timeout for real-time tasks.
.SH EXAMPLES
.IP "\fBprlimit \-\-pid 13134\fP"
Display limit values for all current resources.
-.IP "\fBprlimit \-\-pid 13134 \--rss --nofile=1024:4095\fP"
+.IP "\fBprlimit \-\-pid 13134 \-\-rss \-\-nofile=1024:4095\fP"
Display the limits of the RSS, and set the soft and hard limits for the number
of open files to 1024 and 4095, respectively.
-.IP "\fBprlimit \-\-pid 13134 --nproc=512:\fP"
+.IP "\fBprlimit \-\-pid 13134 \-\-nproc=512:\fP"
Modify only the soft limit for the number of processes.
-.IP "\fBprlimit \-\-pid $$ --nproc=unlimited\fP"
+.IP "\fBprlimit \-\-pid $$ \-\-nproc=unlimited\fP"
Set for the current process both the soft and ceiling values for the number of
processes to unlimited.
-.IP "\fBprlimit --cpu=10 sort -u hugefile\fP"
+.IP "\fBprlimit \-\-cpu=10 sort \-u hugefile\fP"
Set both the soft and hard CPU time limit to ten seconds and run 'sort'.
.SH "SEE ALSO"
diff --git a/sys-utils/readprofile.8 b/sys-utils/readprofile.8
index a37aa0a91..9aef1bfba 100644
--- a/sys-utils/readprofile.8
+++ b/sys-utils/readprofile.8
@@ -93,12 +93,12 @@ Display help text and exit.
.SH EXAMPLES
Browse the profiling buffer ordering by clock ticks:
.nf
- readprofile | sort -nr | less
+ readprofile | sort \-nr | less
.fi
Print the 20 most loaded procedures:
.nf
- readprofile | sort -nr +2 | head -20
+ readprofile | sort \-nr +2 | head \-20
.fi
Print only filesystem profile:
@@ -108,17 +108,17 @@ Print only filesystem profile:
.fi
Look at all the kernel information, with ram addresses:
.nf
- readprofile -av | less
+ readprofile \-av | less
.fi
Browse a `frozen' profile buffer for a non current kernel:
.nf
- readprofile -p ~/profile.freeze -m /zImage.map.gz
+ readprofile \-p ~/profile.freeze \-m /zImage.map.gz
.fi
Request profiling at 2kHz per CPU, and reset the profiling buffer:
.nf
- sudo readprofile -M 20
+ sudo readprofile \-M 20
.fi
.SH BUGS
.LP
diff --git a/sys-utils/renice.1 b/sys-utils/renice.1
index 513d98422..44af9e065 100644
--- a/sys-utils/renice.1
+++ b/sys-utils/renice.1
@@ -81,7 +81,7 @@ Display help text and exit.
The following command would change the priority of the processes with
PIDs 987 and 32, plus all processes owned by the users daemon and root:
.TP
-.B " renice" +1 987 -u daemon root -p 32
+.B " renice" +1 987 \-u daemon root \-p 32
.SH NOTES
Users other than the superuser may only alter the priority of processes they
own. Furthermore, an unprivileged user can only
diff --git a/sys-utils/setarch.8 b/sys-utils/setarch.8
index e59921476..cee9717f2 100644
--- a/sys-utils/setarch.8
+++ b/sys-utils/setarch.8
@@ -19,7 +19,7 @@ setarch \- change reported architecture in new program environment and/or set pe
.B setarch
modifies execution domains and process personality flags.
.PP
-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
will cause \fIprogram\fR to see i686 instead of x86_64 as the machine type.
It also allows to set various personality options.
@@ -114,13 +114,13 @@ Display version information and exit.
.BR \-h , " \-\-help"
Display help text and exit.
.SH EXAMPLES
-setarch --addr-no-randomize mytestprog
+setarch \-\-addr-no-randomize mytestprog
.br
-setarch ppc32 rpmbuild --target=ppc --rebuild foo.src.rpm
+setarch ppc32 rpmbuild \-\-target=ppc \-\-rebuild foo.src.rpm
.br
-setarch ppc32 -v -vL3 rpmbuild --target=ppc --rebuild bar.src.rpm
+setarch ppc32 \-v \-vL3 rpmbuild \-\-target=ppc \-\-rebuild bar.src.rpm
.br
-setarch ppc32 --32bit rpmbuild --target=ppc --rebuild foo.src.rpm
+setarch ppc32 \-\-32bit rpmbuild \-\-target=ppc \-\-rebuild foo.src.rpm
.SH AUTHOR
.MT sopwith@redhat.com
Elliot Lee
diff --git a/sys-utils/setpriv.1 b/sys-utils/setpriv.1
index 09092efa7..7b7110381 100644
--- a/sys-utils/setpriv.1
+++ b/sys-utils/setpriv.1
@@ -142,7 +142,7 @@ and is therefore not allowed.
.BR "\-\-pdeathsig keep" | clear | <signal>
Keep, clear or set the parent death signal. Some LSMs, most notably SELinux and
AppArmor, clear the signal when the process' credentials change. Using
-\fB--pdeathsig keep\fR will restore the parent death signal after changing
+\fB\-\-pdeathsig keep\fR will restore the parent death signal after changing
credentials to remedy that situation.
.TP
.BI \-\-selinux\-label " label"
@@ -194,7 +194,7 @@ restrictions from taking effect.
If you're looking for behaviour similar to
.BR su (1)/ runuser "(1), or " sudo (8)
(without the
-.B -g
+.B \-g
option), try something like:
.sp
.B " setpriv \-\-reuid=1000 \-\-regid=1000 \-\-init\-groups"
diff --git a/sys-utils/swapon.8 b/sys-utils/swapon.8
index fc9a577b1..c8ad3bfff 100644
--- a/sys-utils/swapon.8
+++ b/sys-utils/swapon.8
@@ -129,7 +129,7 @@ For example:
.RS
.RS
.sp
-.B "swapon -o pri=1,discard=pages,nofail /dev/sda2"
+.B "swapon \-o pri=1,discard=pages,nofail /dev/sda2"
.sp
.RE
The \fIopts\fP string is evaluated last and overrides all other
@@ -147,7 +147,7 @@ for a full description of swap priorities. Add
to the option field of
.I /etc/fstab
for use with
-.BR "swapon -a" .
+.BR "swapon \-a" .
When no priority is defined, it defaults to \-1.
.TP
.BR \-s , " \-\-summary"
diff --git a/sys-utils/tunelp.8 b/sys-utils/tunelp.8
index 90db83491..5c927458f 100644
--- a/sys-utils/tunelp.8
+++ b/sys-utils/tunelp.8
@@ -23,7 +23,7 @@ characteristics accordingly.
specifies the IRQ to use for the parallel port in question. If this is set
to something non-zero, \-t and \-c have no effect. If your port does not use
interrupts, this option will make printing stop. The command
-.B tunelp -i 0
+.B tunelp \-i 0
restores non-interrupt driven (polling) action, and your printer should work
again. If your parallel port does support interrupts, interrupt-driven
printing should be somewhat faster and efficient, and will probably be
diff --git a/sys-utils/umount.8 b/sys-utils/umount.8
index 785393f0c..b075467d5 100644
--- a/sys-utils/umount.8
+++ b/sys-utils/umount.8
@@ -123,7 +123,7 @@ anymore.
A system reboot would be expected in near future if you're going to use this
option for network filesystem or local filesystem with submounts. The
-recommended use-case for \fBumount -l\fR is to prevent hangs on shutdown due to
+recommended use-case for \fBumount \-l\fR is to prevent hangs on shutdown due to
an unreachable network share where a normal umount will hang due to a downed
server or a network partition. Remounts of the share will not be possible.
@@ -219,7 +219,7 @@ command independently of /etc/mtab.
In this case the device is initialized with "autoclear" flag (see
.BR losetup (8)
output for more details), otherwise it's necessary to use the option \fB \-\-detach\-loop\fR
-or call \fBlosetup -d <device>\fR. The autoclear feature is supported since Linux 2.6.25.
+or call \fBlosetup \-d <device>\fR. The autoclear feature is supported since Linux 2.6.25.
.SH EXTERNAL HELPERS
The syntax of external unmount helpers is:
.PP
diff --git a/sys-utils/unshare.1 b/sys-utils/unshare.1
index 9a4196743..597e6160e 100644
--- a/sys-utils/unshare.1
+++ b/sys-utils/unshare.1
@@ -25,8 +25,8 @@ The namespaces to be unshared are indicated via options. Unshareable namespaces
.B mount namespace
Mounting and unmounting filesystems will not affect the rest of the system,
except for filesystems which are explicitly marked as
-shared (with \fBmount --make-shared\fP; see \fI/proc/self/mountinfo\fP or
-\fBfindmnt -o+PROPAGATION\fP for the \fBshared\fP flags).
+shared (with \fBmount \-\-make-shared\fP; see \fI/proc/self/mountinfo\fP or
+\fBfindmnt \-o+PROPAGATION\fP for the \fBshared\fP flags).
For further details, see
.BR mount_namespaces (7)
and the discussion of the
@@ -110,7 +110,7 @@ namespace is created by a bind mount.
Unshare the mount namespace. If \fIfile\fP is specified, then a persistent
namespace is created by a bind mount.
Note that \fIfile\fP has to be located on a filesystem with the propagation
-flag set to \fBprivate\fP. Use the command \fBfindmnt -o+PROPAGATION\fP
+flag set to \fBprivate\fP. Use the command \fBfindmnt \-o+PROPAGATION\fP
when not sure about the current setting. See also the examples below.
.TP
.BR \-n , " \-\-net" [ =\fIfile ]
@@ -119,8 +119,8 @@ namespace is created by a bind mount.
.TP
.BR \-p , " \-\-pid" [ =\fIfile ]
Unshare the PID namespace. If \fIfile\fP is specified then persistent
-namespace is created by a bind mount. See also the \fB--fork\fP and
-\fB--mount-proc\fP options.
+namespace is created by a bind mount. See also the \fB\-\-fork\fP and
+\fB\-\-mount-proc\fP options.
.TP
.BR \-u , " \-\-uts" [ =\fIfile ]
Unshare the UTS namespace. If \fIfile\fP is specified, then a persistent
@@ -139,15 +139,15 @@ Fork the specified \fIprogram\fR as a child process of \fBunshare\fR rather than
running it directly. This is useful when creating a new PID namespace.
.TP
.B \-\-keep\-caps
-When the \fB--user\fP option is given, ensure that capabilities granted
+When the \fB\-\-user\fP option is given, ensure that capabilities granted
in the user namespace are preserved in the child process.
.TP
.BR \-\-kill\-child [ =\fIsigname ]
When \fBunshare\fR terminates, have \fIsigname\fP be sent to the forked child process.
-Combined with \fB--pid\fR this allows for an easy and reliable killing of the entire
+Combined with \fB\-\-pid\fR this allows for an easy and reliable killing of the entire
process tree below \fBunshare\fR.
If not given, \fIsigname\fP defaults to \fBSIGKILL\fR.
-This option implies \fB--fork\fR.
+This option implies \fB\-\-fork\fR.
.TP
.BR \-\-mount\-proc [ =\fImountpoint ]
Just before running the program, mount the proc filesystem at \fImountpoint\fP
@@ -163,12 +163,12 @@ conveniently gain capabilities needed to manage various aspects of the newly cre
namespaces (such as configuring interfaces in the network namespace or mounting filesystems in
the mount namespace) even when run unprivileged. As a mere convenience feature, it does not support
more sophisticated use cases, such as mapping multiple ranges of UIDs and GIDs.
-This option implies \fB--setgroups=deny\fR and \fB--user\fR.
+This option implies \fB\-\-setgroups=deny\fR and \fB\-\-user\fR.
.TP
.BR \-c , " \-\-map\-current\-user"
Run the program only after the current effective user and group IDs have been mapped to
the same UID and GID in the newly created user namespace. This option implies
-\fB--setgroups=deny\fR and \fB--user\fR.
+\fB\-\-setgroups=deny\fR and \fB\-\-user\fR.
.TP
.BR "\-\-propagation private" | shared | slave | unchanged
Recursively set the mount propagation flag in the new mount namespace. The default
@@ -220,14 +220,14 @@ files that a more privileged user made unavailable. In short the rule for proc
and sysfs is as close to a bind mount as possible.
.SH EXAMPLES
.TP
-.B # unshare --fork --pid --mount-proc readlink /proc/self
+.B # unshare \-\-fork \-\-pid \-\-mount-proc readlink /proc/self
.TQ
1
.br
Establish a PID namespace, ensure we're PID 1 in it against a newly mounted
procfs instance.
.TP
-.B $ unshare --map-root-user --user sh -c whoami
+.B $ unshare \-\-map-root-user \-\-user sh \-c whoami
.TQ
root
.br
@@ -235,9 +235,9 @@ Establish a user namespace as an unprivileged user with a root user within it.
.TP
.B # touch /root/uts-ns
.TQ
-.B # unshare --uts=/root/uts-ns hostname FOO
+.B # unshare \-\-uts=/root/uts-ns hostname FOO
.TQ
-.B # nsenter --uts=/root/uts-ns hostname
+.B # nsenter \-\-uts=/root/uts-ns hostname
.TQ
FOO
.TQ
@@ -247,19 +247,19 @@ Establish a persistent UTS namespace, and modify the hostname. The namespace
is then entered with \fBnsenter\fR. The namespace is destroyed by unmounting
the bind reference.
.TP
-.B # mount --bind /root/namespaces /root/namespaces
+.B # mount \-\-bind /root/namespaces /root/namespaces
.TQ
-.B # mount --make-private /root/namespaces
+.B # mount \-\-make-private /root/namespaces
.TQ
.B # touch /root/namespaces/mnt
.TQ
-.B # unshare --mount=/root/namespaces/mnt
+.B # unshare \-\-mount=/root/namespaces/mnt
.br
Establish a persistent mount namespace referenced by the bind mount
/root/namespaces/mnt. This example shows a portable solution, because it
makes sure that the bind mount is created on a shared filesystem.
.TP
-.B # unshare -pf --kill-child -- bash -c "(sleep 999 &) && sleep 1000" &
+.B # unshare \-pf \-\-kill-child \-\- bash \-c "(sleep 999 &) && sleep 1000" &
.TQ
.B # pid=$!
.TQ
diff --git a/term-utils/script.1 b/term-utils/script.1
index 1b70dec5c..daf4a6ff3 100644
--- a/term-utils/script.1
+++ b/term-utils/script.1
@@ -110,7 +110,7 @@ the child process is always stored in type script file too.
.TP
\fB\-f\fR, \fB\-\-flush\fR
Flush output after each write. This is nice for telecooperation: one person
-does `mkfifo foo; script -f foo', and another can supervise real-time what is
+does `mkfifo foo; script \-f foo', and another can supervise real-time what is
being done using `cat foo'. Note that flush has an impact on performance, it's
possible to use SIGUSR1 to flush logs on demand.
.TP
@@ -228,7 +228,7 @@ by login shells only:
.na
.RS
.nf
-if test -t 0 ; then
+if test \-t 0 ; then
script
exit
fi
diff --git a/text-utils/column.1 b/text-utils/column.1
index fd1aaabed..237b26b36 100644
--- a/text-utils/column.1
+++ b/text-utils/column.1
@@ -46,11 +46,11 @@ utility formats its input into multiple columns. The util support three modes:
This is the default mode (required by backward compatibility).
.TP
.B rows are filled before columns
-This mode is enabled by option \fB-x, \-\-fillrows\fP
+This mode is enabled by option \fB\-x, \-\-fillrows\fP
.TP
.B table
Determine the number of columns the input contains and create a table. This
-mode is enabled by option \fB-t, \-\-table\fP and columns formatting is
+mode is enabled by option \fB\-t, \-\-table\fP and columns formatting is
possible to modify by \fB\-\-table-*\fP options. Use this mode if not sure.
.PP
Input is taken from \fIfile\fR, or otherwise from standard input. Empty lines
@@ -66,7 +66,7 @@ Use JSON output format to print the table, the option
\fB\-\-table\-columns\fP is required and the option \fB\-\-table\-name\fP is recommended.
.IP "\fB\-c, \-\-output\-width\fP \fIwidth\fP"
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.
.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.
@@ -100,8 +100,8 @@ Print header line for each page.
Specify columns where is possible to use multi-line cell for long text when
necessary.
.IP "\fB\-H, \-\-table-hide\fP \fIcolumns\fP"
-Don't print specified columns. The special placeholder '-' may be used to
-hide all unnamed columns (see --table-columns).
+Don't print specified columns. The special placeholder '\-' may be used to
+hide all unnamed columns (see \-\-table-columns).
.IP "\fB\-O, \-\-table-order\fP \fIcolumns\fP"
Specify columns order on output.
.IP "\fB\-n, \-\-table-name\fP \fIname\fP"
@@ -129,19 +129,19 @@ the screen if no other information is available.
.SH EXAMPLES
Print fstab with header line and align number to the right:
.EX
-\fBsed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE,OPTIONS,PASS,FREQ --table-right PASS,FREQ\fR
+\fBsed 's/#.*//' /etc/fstab | column \-\-table \-\-table-columns SOURCE,TARGET,TYPE,OPTIONS,PASS,FREQ \-\-table-right PASS,FREQ\fR
.EE
.PP
Print fstab and hide unnamed columns:
.EX
-\fBsed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE --table-hide -\fR
+\fBsed 's/#.*//' /etc/fstab | column \-\-table \-\-table-columns SOURCE,TARGET,TYPE \-\-table-hide \-\fR
.EE
.PP
.PP
Print a tree:
.EX
-\fBecho -e '1 0 A\\n2 1 AA\\n3 1 AB\\n4 2 AAA\\n5 2 AAB' | column --tree-id 1 --tree-parent 2 --tree 3\fR
+\fBecho \-e '1 0 A\\n2 1 AA\\n3 1 AB\\n4 2 AAA\\n5 2 AAB' | column \-\-tree-id 1 \-\-tree-parent 2 \-\-tree 3\fR
1 0 A
2 1 |-AA
4 2 | |-AAA
@@ -154,7 +154,7 @@ Version 2.23 changed the
option to be non-greedy, for example:
.PP
.EX
-\fBprintf "a:b:c\\n1::3\\n" | column -t -s ':'\fR
+\fBprintf "a:b:c\\n1::3\\n" | column \-t \-s ':'\fR
.EE
.PP
Old output:
diff --git a/text-utils/more.1 b/text-utils/more.1
index 8b2407ec6..56d054df1 100644
--- a/text-utils/more.1
+++ b/text-utils/more.1
@@ -231,7 +231,7 @@ Eric Shienbrood, UC Berkeley
.br
Modified by Geoff Peck, UCB to add underlining, single spacing
.br
-Modified by John Foderaro, UCB to add -c and MORE environment variable
+Modified by John Foderaro, UCB to add \-c and MORE environment variable
.SH HISTORY
The
.B more
--
2.24.0
reply other threads:[~2019-12-16 0:52 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20191216005157.GA9796@rhi.hi.is \
--to=bjarniig@rhi.hi.is \
--cc=util-linux@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).