_length_::
The length of the partition (in 512-byte sectors).
+include::man-common/help-version.adoc[]
+
== SEE ALSO
*delpart*(8),
*--report*::
Print a report for the specified device. It is possible to give multiple devices. If none is given, all devices which appear in _/proc/partitions_ are shown. Note that the partition StartSec is in 512-byte sectors.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Print version and exit.
+include::man-common/help-version.adoc[]
== COMMANDS
== OPTIONS
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
*-L*, *--color*[**=**__when__]::
Colorize the output. The optional argument _when_ can be *auto*, *never* or *always*. If the _when_ argument is omitted, it defaults to *auto*. The colors can be disabled, for the current built-in default see *--help* output. See also the *COLORS* section.
*-r*, *--read-only*::
Forced open in read-only mode.
-*-V*, *--version*::
-Display version information and exit.
-
*-z*, *--zero*::
Start with an in-memory zeroed partition table. This option does not zero the partition table on the disk; rather, it simply starts the program without reading the existing partition table. This option allows you to create a new partition table from scratch or from an *sfdisk*(8)-compatible script.
This command doesn't manipulate partitions on a block device.
+== OPTIONS
+
+include::man-common/help-version.adoc[]
+
== SEE ALSO
*addpart*(8),
*-n*, *--no-verify*::
Skip the verification that is normally performed after the formatting.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NOTES
*-c*, *--compatibility*[=_mode_]::
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 _mode_ argument -- then the default is used. Note that the optional _mode_ argument cannot be separated from the *-c* option by a space, the correct form is for example *-c*=_dos_.
-*-h*, *--help*::
-Display a help text and exit.
+include::man-common/help-version.adoc[]
*-L*, *--color*[=_when_]::
Colorize the output. The optional argument _when_ can be *auto*, *never* or *always*. If the _when_ argument is omitted, it defaults to *auto*. The colors can be disabled; for the current built-in default see the *--help* output. See also the *COLORS* section.
*-y*::
This option is silently ignored.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-f*, *--force*::
Force a filesystem check even if the filesystem was marked as valid. Marking is done by the kernel when the filesystem is unmounted.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== DIAGNOSTICS
+
The size of the file (or block device) holding an iso9660 filesystem can be marginally larger than the actual size of the iso9660 filesystem. One reason for this is that cd writers are allowed to add "run out" sectors at the end of an iso9660 image.
+include::man-common/help-version.adoc[]
+
== EXIT STATUS
*0*::
*-V*, *--verbose*::
Produce verbose output, including all filesystem-specific commands that are executed. Specifying this option more than once inhibits execution of any filesystem-specific commands. This is really only useful for testing.
-*-V*, *--version*::
-Display version information and exit. (Option *-V* will display version information only when it is the only parameter, otherwise it will work as *--verbose*.)
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
+(Option *-V* will display version information only when it is the only parameter, otherwise it will work as *--verbose*.)
== BUGS
*-l*::
This option is silently ignored.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit. Option *-V* only works as *--version* when it is the only option.
+include::man-common/help-version.adoc[]
+Option *-V* only works as *--version* when it is the only option.
== EXIT STATUS
*-z*::
Make explicit holes.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-3*::
Make a Minix version 3 filesystem.
-*-V*, *--version*::
-Display version information and exit. The long option cannot be combined with other options.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
+The long option cannot be combined with other options.
== ENVIRONMENT
*--verbose*::
Verbose execution. With this option *mkswap* will output more details about detected problems during swap area set up.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== ENVIRONMENT
*-v*, *--verbose*::
Verbose mode.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== ENVIRONMENT
*-a*, *--all*::
With *-q*, specify that all bound raw devices should be queried.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== NOTES
_length_::
The new length of the partition (in 512-byte sectors).
+include::man-common/help-version.adoc[]
+
== SEE ALSO
*addpart*(8),
== OPTIONS
-*-h*, *--help*::
- Display help text and exit.
+include::man-common/help-version.adoc[]
*-L*, *--label* _label_::
Specify a new _label_ for the device. Swap partition labels can be at most 16 characters long. If _label_ is longer than 16 characters, *swaplabel* will truncate it and print a warning message.
*-h*, *--home-phone* _home-phone_::
Specify your home phone number.
-*-u*, *--help*::
-Display help text and exit.
-
-*-v*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== CONFIG FILE ITEMS
*-l*, *--list-shells*::
Print the list of shells listed in _/etc/shells_ and exit.
-*-h*, *--help*::
-Display help text and exit.
-
-*-v*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== VALID SHELLS
*-x*, *--system*::
Display the system shutdown entries and run level changes.
+include::man-common/help-version.adoc[]
+
== TIME FORMATS
The options that take the _time_ argument understand the following formats:
*-H*::
Used by other servers (for example, *telnetd*(8)) to tell *login* that printing the hostname should be suppressed in the login: prompt. See also *LOGIN_PLAIN_PROMPT* below.
-*--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== CONFIG FILE ITEMS
-*login* reads the _/etc/login.defs_ configuration file (see login.defs(5)). Note that the configuration file could be distributed with another package (usually shadow-utils). The following configuration items are relevant for *login*:
+*login* reads the _/etc/login.defs_ configuration file (see *login.defs*(5)). Note that the configuration file could be distributed with another package (usually shadow-utils). The following configuration items are relevant for *login*:
*MOTD_FILE* (string)::
Specifies a ":" delimited list of "message of the day" files and directories to be displayed upon login. If the specified path is a directory then displays all files with .motd file extension in version-sort order from the directory.
+
Note that relation between user and group may be invisible for primary group if the user is not explicitly specify as group member (e.g., in _/etc/group_). If the command *lslogins* scans for groups than it uses groups database only, and user database with primary GID is not used at all.
-*-h*, *--help*::
-Display help information and exit.
-
*-L*, *--last*::
Display data containing information about the users' last login sessions.
*-u*, *--user-accs*::
Show user accounts. These are by default all accounts with UID above 1000 (inclusive), with the exception of either nobody or nfsnobody (UID 65534). This hardcoded default maybe overwritten by parameters UID_MIN and UID_MAX in the file _/etc/login.defs_.
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
*--wtmp-file* _path_::
Alternate path for wtmp.
If no group is specified, the GID is changed to the login GID.
+== OPTIONS
+
+include::man-common/help-version.adoc[]
+
== FILES
_/etc/group_,
These shell command-line options are ignored to avoid *nologin* error.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== NOTES
*-w*, *--whitelist-environment*=_list_::
Don't reset the environment variables specified in the comma-separated _list_ when clearing the environment for *--login*. The whitelist is ignored for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and *PATH*.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== CONFIG FILES
*-w*, **--whitelist-environment**=__list__::
Don't reset the environment variables specified in the comma-separated _list_ when clearing the environment for *--login*. The whitelist is ignored for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and *PATH*.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== SIGNALS
*-t*, *--timeout* _seconds_::
Specify the maximum amount of time to wait for user input. By default, *sulogin* will wait forever.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== ENVIRONMENT
*-r*, *--reverse*::
Undump, write back edited login information into the utmp or wtmp files.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NOTES
*vipw* edits the password file after setting the appropriate locks, and does any necessary processing after the password file is unlocked. If the password file is already locked for editing by another user, *vipw* will ask you to try again later. The default editor for *vipw* and *vigr* is *vi*(1). *vigr* edits the group file in the same manner as *vipw* does the passwd file.
+== OPTIONS
+
+include::man-common/help-version.adoc[]
+
== ENVIRONMENT
If the following environment variable exists, it will be utilized by *vipw* and *vigr*:
--- /dev/null
+*-h*, *--help*::
+Display help text and exit.
+
+*-V*, *--version*::
+Print version and exit.
For empty lines within a description (to keep the indentation) you can use the "plus" character at the beginning of an otherwise empty line.
//Last but not least, don't forget the common options:
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NOTES
*-g*, *--garbage-collect*::
Perform a garbage collection pass on the blkid cache to remove devices which no longer exist.
-*-h*, *--help*::
-Display a usage message and exit.
-
*-H*, *--hint* _setting_::
Set probing hint. The hints are an optional way to force probing functions to
check, for example, another location. The currently supported is
*-U*, *--uuid* _uuid_::
Look up the device that uses this filesystem _uuid_. For more details see the *--label* option.
-*-V*, *--version*::
-Display version number and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*--color*[=_when_]::
Colorize the output. The optional argument _when_ can be *auto*, *never* or *always*. If the _when_ argument is omitted, it defaults to *auto*. The colors can be disabled; for the current built-in default see the *--help* output. See also the *COLORS* section.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== PARAMETERS
*-J*, *--json*::
Use JSON output format.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
*blkid*
____
+include::man-common/help-version.adoc[]
+
== EXIT STATUS
*0*::
*-f*, *--first-only*::
Print the first matching filesystem only.
-*-h*, *--help*::
-Display help text and exit.
-
*-i*, *--invert*::
Invert the sense of matching.
*--vfs-all*::
When used with *VFS-OPTIONS* column, print all VFS (fs-independent) flags. This option is designed for auditing purposes to list also default VFS kernel mount options which are normally not listed.
+include::man-common/help-version.adoc[]
+
== EXIT STATUS
The exit value is 0 if there is something to display, or 1 on any error
*-a*, *--alternative*::
Allow long options to start with a single '*-*'.
-*-h*, *--help*::
-Display help text and exit. No other output is generated.
-
*-l*, *--longoptions* _longopts_::
The long (multi-character) options to be recognized. More than one option name may be specified at once, by separating the names with commas. This option may be given more than once, the _longopts_ are cumulative. Each long option name in _longopts_ may be followed by one colon to indicate it has a required argument, and by two colons to indicate it has an optional argument.
*-u*, *--unquoted*::
Do not quote the output. Note that whitespace and special (shell-dependent) characters can cause havoc in this mode (like they do with other *getopt*(1) implementations).
-*-V*, *--version*::
-Display version information and exit. No other output is generated.
+include::man-common/help-version.adoc[]
== PARSING
== OPTIONS
-*-h*, *--help*::
-print quick usage details to the screen.
-
-*-v*, *--verbose*::
-More verbose output. If specified once, every hardlinked file is displayed, if specified twice, it also shows every comparison.
+include::man-common/help-version.adoc[]
+If specified once, every hardlinked file is displayed, if specified twice, it also shows every comparison.
*-q*, *--quiet*::
Quiet mode, don't print anything.
*--*::
End the argument list. This allows the _message_ to start with a hyphen (-).
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-t*, *--terminate* _character_::
Specify a string termination character, i.e., only the characters in _string_ up to and including the first occurrence of _character_ are compared.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
The *look* utility exits 0 if one or more lines were found and displayed, 1 if no lines were found, and >1 if an error occurred.
*-f*, *--fs*::
Output info about filesystems. This option is equivalent to *-o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS*. The authoritative information about filesystems and raids is provided by the *blkid*(8) command.
-*-h*, *--help*::
-Display help text and exit.
-
*-I*, *--include* _list_::
Include devices specified by the comma-separated _list_ of major device numbers. The filter is applied to the top-level devices only. This may be confusing for *--list* output format where hierarchy of the devices is not obvious.
+
*-o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME*.
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
*-w*, *--width* _number_::
Specifies output width as a number of characters. The default is the number of the terminal columns, and if not executed on a terminal, then output width is not restricted at all by default. This option also forces *lsblk* to assume that terminal control characters and unsafe characters are not allowed. The expected use-case is for example when *lsblk* is used by the *watch*(1) command.
*--dump-counters*::
Dump the definition of counters used in *--summary* output.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== OUTPUT COLUMNS
*-u*, *--notruncate*::
Do not truncate text in columns.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== OUTPUT
*-v*, *--verbose*::
Inform where randomness originated, with amount of entropy read from each source.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== FILES
*-x*, *--mountpoints*::
Show mountpoint directories with a 'D' rather than a 'd'.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== BUGS
*-i*, *--interactive*::
Ask before overwriting existing files.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== WARNING
*-t*, *--time*::
Test *uuidd* by trying to connect to a running uuidd daemon and request it to return a time-based UUID.
-*-V*, *--version*::
-Output version information and exit.
-
-*-h*, *--help*::
-Display help screen and exit.
+include::man-common/help-version.adoc[]
== EXAMPLE
*-t*, *--time*::
Generate a time-based UUID. This method creates a UUID based on the system clock plus the system's ethernet hardware address, if present.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
*-m*, *--md5*::
Use MD5 as the hash algorithm.
*-r*, *--raw*::
Use the raw output format.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
*-l*::
Output the list of effective lookup paths that *whereis* is using. When none of *-B*, *-M*, or *-S* is specified, the option will output the hard-coded paths that the command was able to find on the system.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== FILE SEARCH PATHS
*-f*, *--force*::
Force erasure, even if the filesystem is mounted. This is required in order to erase a partition-table signature on a block device.
-*-h*, *--help*::
-Display help text and exit.
-
*-J*, *--json*::
Use JSON output format.
*-t*, *--types* _list_::
Limit the set of printed or erased signatures. More than one type may 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).
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== ENVIRONMENT
*-v*, *--verbose*::
Show status information.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== USAGE
*-t*, *--ignore*::
Ignore failure to set the requested priority. If _command_ was specified, run it even in case it was not possible to set the desired scheduling priority, which can happen due to insufficient privileges or an old kernel version.
-*-h*, *--help*::
-Display help text and exit.
-
*-u*, *--uid* _UID_...::
Specify the user IDs of running processes for which to get or set the scheduling parameters.
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== NOTES
*-p*, *--pid*::
Operate on an existing PID and do not launch a new task.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== USAGE
*-v*, *--verbose*::
Show status information.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== USAGE
*-v*, *--verbose*::
Display the aligned values of _offset_ and _length_. If the *--step* option is specified, it prints the discard progress every second.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
*-v*, *--verbose*::
Display the number of zones returned in the report or the range of sectors reset.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
*-r*, *--rescan*::
Trigger a rescan of CPUs. After a rescan, the Linux kernel recognizes the new CPUs. Use this option on systems that do not automatically detect newly attached CPUs.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-z*, *--zone*::
Select the memory _ZONE_ where to set the specified _RANGE_, _SIZE_, or _BLOCKRANGE_ of memory online or offline. By default, memory will be set online to the zone Movable, if possible.
-*-h*, *--help*::
-Print a short help text, then exit.
-
*-v*, *--verbose*::
Verbose mode. Causes *chmem* to print debugging messages about it's progress.
-*-V*, *--version*::
-Print the version number, then exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-n*, *--adjust* _value_::
Specify the adjust score value.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== NOTES
== OPTIONS
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== FILES
*-x*, *--decode*::
Decode facility and level (priority) numbers to human-readable prefixes.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== COLORS
*-f*, *--floppy*::
This option specifies that the drive should be ejected using a removable floppy disk eject command.
-*-h*, *--help*::
-Display help text and exit.
-
*-i*, **--manualeject on**|*off*::
This option controls locking of the hardware eject button. When enabled, the drive will not be ejected when the button is pressed. This is useful when you are carrying a laptop in a bag or case and don't want it to eject if the button is inadvertently pressed.
*-t*, *--trayclose*::
With this option the drive is given a CD-ROM tray close command. Not all devices support this command.
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
*-v*, *--verbose*::
Run in verbose mode; more information is displayed about what the command is doing.
+
Available since Linux 3.14 for ext4 (only for extent-based files) and XFS.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
*--verbose*::
Report how long it took to acquire the lock, or why the lock could not be obtained.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-u*, *--unfreeze*::
This option is used to un-freeze the filesystem and allow operations to continue. Any filesystem modifications that were blocked by the freeze are unblocked and allowed to complete.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== FILESYSTEM SUPPORT
*--quiet-unsupported*::
Suppress error messages if trim operation (ioctl) is unsupported. This option is meant to be used in *systemd* service file or in *cron*(8) scripts to hide warnings that are result of known problems, such as NTFS driver reporting _Bad file descriptor_ when device is mounted read-only, or lack of file system support for ioctl _FITRIM_ call. This option also cleans exit status when unsupported filesystem specified on *fstrim* command line.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-w*, *--systohc*::
Set the Hardware Clock from the System Clock, and update the timestamps in _{ADJTIME_PATH}_. With the *--update-drift* option also (re)calculate the drift factor. Try it without the option if *--systohc* fails. See *--update-drift* below.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== OPTIONS
*-p*, *--mode* _mode_::
Access permissions for the resource. Default is 0644.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
*-s*, *--semaphore-id* _semid_::
Remove the semaphore identified by _semid_.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NOTES
*-i*, *--id* _id_::
Show full details on just the one resource element identified by _id_. This option needs to be combined with one of the three resource options: *-m*, *-q* or *-s*.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
=== Resource options
*-S*, *--softirq*::
Show softirqs information.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== INTERACTIVE MODE KEY COMMANDS
Set the speed (the baud rate) of the serial line to the specified _value_.
*-c*, *--intro-command* _string_::
-Define an intro command that is sent through the serial line before the invocation of ldattach. E.g. in conjunction with line discipline GSM0710, the command 'AT+CMUX=0\r' is commonly suitable to switch the modem into the CMUX mode.
+Define an intro command that is sent through the serial line before the invocation of *ldattach*. E.g. in conjunction with line discipline GSM0710, the command 'AT+CMUX=0\r' is commonly suitable to switch the modem into the CMUX mode.
*-p*, *--pause* _value_::
-Sleep for _value_ seconds before the invocation of ldattach. Default is one second.
-
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+Sleep for _value_ seconds before the invocation of *ldattach*. Default is one second.
== AUTHORS
*-J*, *--json*::
Use JSON format for *--list* output.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
-
== ENCRYPTION
*Cryptoloop is no longer supported in favor of dm-crypt.* For more details see *cryptsetup*(8).
+
The default list of columns may be extended if list is specified in the format +list (e.g., lscpu -e=+MHZ).
-*-h*, *--help*::
-Display help text and exit.
-
*-J*, *--json*::
Use JSON output format for the default summary or extended output (see *--extended*).
+
The CPU logical numbers are not affected by this option.
-*-V*, *--version*::
-Display version information and exit.
-
*--output-all*::
Output all available columns. This option must be combined with either *--extended*, *--parse* or *--caches*.
*-g*, *--global*::
Show system-wide usage and limits of IPC resources. This option may be combined with one of the three resource options: *-m*, *-q* or *-s*. The default is to show information about all resources.
-*-h*, *--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
=== Resource options
*-S*, *--softirq*::
Show softirqs information.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
*-b*, *--bytes*::
include::man-common/in-bytes.adoc[]
-*-h*, *--help*::
-Display help text and exit.
-
*-J*, *--json*::
Use JSON output format.
*-s*, *--sysroot* _directory_::
Gather memory data for a Linux instance other than the instance from which the *lsmem* command is issued. The specified _directory_ is the system root of the Linux instance to be inspected.
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
*--summary*[=_when_]::
This option controls summary lines output. The optional argument _when_ can be *never*, *always* or *only*. If the _when_ argument is omitted, it defaults to *"only"*. The summary output is suppressed for *--raw*, *--pairs* and *--json*.
Use tree-like output format.
If *process* is given as _rel_, print process tree(s) in each name space. This is default when *--tree* is not specified. If *parent* is given, print tree(s) constructed by the parent/child relationship. If *owner* is given, print tree(s) constructed by the owner/owned relationship. *owner* is used as default when _rel_ is omitted.
-
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
+
Note that specifying *-w* on the command line forces *mount* to never try read-only mount on write-protected devices or already mounted read-only filesystems.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== FILESYSTEM-INDEPENDENT MOUNT OPTIONS
*-x*, *--devno*::
Show the major/minor numbers of the given blockdevice on standard output.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-Z*, *--follow-context*::
Set the SELinux security context used for executing a new process according to already running process specified by *--target* PID. (The util-linux has to be compiled with SELinux support otherwise the option is unavailable.)
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
== OPTIONS
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXAMPLE
== GENERAL OPTIONS
-*-h, --help*::
-Display help text and exit.
-
*--noheadings*::
Do not print a header line.
*--verbose*::
Verbose mode.
-*-V, --version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== RESOURCE OPTIONS
*-v*, *--verbose*::
Verbose. The output is organized in four columns and filled with blanks. The first column is the RAM address of a kernel function, the second is the name of the function, the third is the number of clock ticks and the last is the normalized load.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== FILES
*-u*, *--user*::
Interpret the succeeding arguments as usernames or UIDs.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== FILES
*-r*, *--raw*::
Use the raw output format.
-*--help*::
-Display help text and exit.
-
-*--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== COMMANDS
*-v*, *--verbose*::
Be verbose.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NOTES
*-Z*, *--mmap-page-zero*::
SVr4 bug emulation that will set *mmap*(3p) page zero as read-only. Use when _program_ depends on this behavior, and the source code is not available to be fixed. Turns on *MMAP_PAGE_ZERO*.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXAMPLE
+
The environment variable *PATH* may be different on systems where _/bin_ and _/sbin_ are merged into _/usr_. The environment variable *SHELL* defaults to */bin/sh* if none is given in the user's passwd entry.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NOTES
*-f*, *--fixpgsz*::
Reinitialize (exec mkswap) the swap space if its page size does not match that of the current running kernel. *mkswap*(8) initializes the whole device and does not check for bad blocks.
-*-h*, *--help*::
-Display help text and exit.
-
*-L* _label_::
Use the partition that has the specified _label_. (For this, access to _/proc/partitions_ is needed.)
*-v*, *--verbose*::
Be verbose.
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
== OPTIONS
-*-h, --help*::
-Display help text and exit.
-
-*-V, --version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-v*, *--verbose*::
Verbose mode.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NON-SUPERUSER UMOUNTS
*--boottime* _offset_::
Set the offset of *CLOCK_BOOTTIME* which will be used in the entered time namespace. This option requires unsharing a time namespace with *--time*.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NOTES
*-x*, *--flags-only*::
Same as *-I -T*.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== AUTHORS
*-t*, *--streams* _number_::
Set the maximum number of compression streams that can be used for the device. The default is use all CPUs and one stream for kernels older than 4.6.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*--reload*::
Ask all running agetty instances to reload and update their displayed prompts, if the user has not yet commenced logging in. After doing so the command will exit. This feature might be unsupported on systems without Linux *inotify*(7).
-*--version*::
-Display version information and exit.
-
-*--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXAMPLE
*-v*, *--verbose*::
Explain what is being done.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXIT STATUS
*-t*[_file_], *--timing*[=_file_]::
Output timing data to standard error, or to _file_ when given. This option is deprecated in favour of *--log-timing* where the _file_ argument is not optional.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== SIGNALS
*-m*, *--maxdelay* _number_::
Set the maximum delay between updates to _number_ of seconds. The argument is a floating-point number. This can be used to avoid long pauses in the typescript replay.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXAMPLES
*-x*, *--stream* _type_::
Forces *scriptreplay* to print only the specified stream. The supported stream types are _in_, _out_, _signal_, or _info_. This option is recommended for multi-stream logs (e.g., *--log-io*) in order to print only specified data.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== EXAMPLES
*--underline* on|off::
Turns underline mode on or off.
-*--version*::
-Displays version information and exits.
-
-*--help*::
-Displays a help text and exits.
+include::man-common/help-version.adoc[]
== COMPATIBILITY
*-g*, *--group* _group_::
Limit printing message to members of group defined as a _group_ argument. The argument can be group name or GID.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== NOTES
== OPTIONS
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== HISTORY
*-x*, *--spaces*::
Output multiple spaces instead of tabs.
-*-V*, *--version*::
-Display version information and exit.
-
-*-H*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== CONFORMING TO
*-2*, *--half-lines*::
Causes all half-lines to be printed, effectively double spacing the output. Normally, a minimal space output format is used which will suppress empty lines. The program never suppresses two consecutive empty lines, however. The *-2* option is useful for sending output to the line printer when the output contains superscripts and subscripts which would otherwise be invisible.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== HISTORY
== OPTIONS
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== HISTORY
*-x, --fillrows*::
Fill rows before filling columns.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h, --help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== ENVIRONMENT
*-x*, *--two-bytes-hex*::
_Two-byte hexadecimal display_. Display the input offset in hexadecimal, followed by eight space-separated, four-column, zero-filled, two-byte quantities of input data, in hexadecimal, per line.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
For each input file, *hexdump* sequentially copies the input to standard output, transforming the data according to the format strings specified by the *-e* and *-f* options, in the order that they were specified.
If an iteration count and/or a byte count is specified, a single slash must be placed after the iteration count and/or before the byte count to disambiguate them. Any whitespace before or after the slash is ignored.
-The format is required and must be surrounded by double quote (" ") marks. It is interpreted as a fprintf-style format string (see *fprintf*(3), with the following exceptions:
+The format is required and must be surrounded by double quote (" ") marks. It is interpreted as a fprintf-style format string (see *fprintf*(3)), with the following exceptions:
1.::
An asterisk (*) may not be used as a field width or precision.
**+**/__string__::
The _string_ to be searched in each file before starting to display it.
-*--help*::
-Display help text and exit.
-
-*-V*, *--version*::
-Display version information and exit.
+include::man-common/help-version.adoc[]
== COMMANDS
*-s*::
Print messages in _standout_ mode, if the terminfo entry for the terminal provides this capability.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== COMMANDS
== OPTIONS
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== SEE ALSO
*-t*, *-T*, *--terminal* _terminal_::
Override the environment variable *TERM* with the specified _terminal_ type.
-*-V*, *--version*::
-Display version information and exit.
-
-*-h*, *--help*::
-Display help text and exit.
+include::man-common/help-version.adoc[]
== ENVIRONMENT