*-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.
-*--lock*[=_mode_]::
+*--lock*[**=**_mode_]::
Use exclusive BSD lock for device or file it operates. The optional argument _mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument is omitted, it defaults to *yes*. This option overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, but it's recommended to avoid collisions with *systemd-udevd*(8) or other tools.
*-r*, *--read-only*::
*-B*, *--protect-boot*::
Don't erase the beginning of the first disk sector when creating a new disk label. This feature is supported for GPT and MBR.
-*-c*, *--compatibility*[=_mode_]::
+*-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_.
include::man-common/help-version.adoc[]
-*-L*, *--color*[=_when_]::
+*-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.
*-l*, *--list*::
*-x*, *--list-details*::
Like *--list*, but provides more details.
-*--lock*[=_mode_]::
+*--lock*[**=**_mode_]::
Use exclusive BSD lock for device or file it operates. The optional argument _mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument is omitted, it defaults to *yes*. This option overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, but it's recommended to avoid collisions with *systemd-udevd*(8) or other tools.
*-n*, *--noauto-pt*::
*-t*, *--type* _type_::
Enable support only for disklabels of the specified _type_, and disable support for all other types.
-*-u*, *--units*[=_unit_]::
+*-u*, *--units*[**=**_unit_]::
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 _unit_ argument -- then the default is used. Note that the optional _unit_ argument cannot be separated from the *-u* option by a space, the correct form is for example '**-u=**__cylinders__'.
*-C*, *--cylinders* _number_::
*-b*, *--blocksize* _blocksize_::
Use this blocksize, defaults to page size. Must be equal to what was set at creation time. Only used for *--extract*.
-*--extract*[=_directory_]::
+*--extract*[**=**_directory_]::
Test to uncompress the whole file system. Optionally extract contents of the _file_ to _directory_.
*-a*::
*-F*, *--fname* _name_::
Specify the filesystem _name_. I have no idea if/where this is used.
-*--lock*[=_mode_]::
+*--lock*[**=**_mode_]::
Use exclusive BSD lock for device or file it operates. The optional argument _mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument is omitted, it defaults to *yes*. This option overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, but it's recommended to avoid collisions with *systemd-udevd*(8) or other tools.
*-v*, *--verbose*::
*-z*::
Make explicit holes.
-*-l*[=_mode_]::
+*-l*[**=**_mode_]::
Use exclusive BSD lock for device or file it operates. The optional argument
_mode_ can be _yes_, _no_ (or 1 and 0) or _nonblock_. If the _mode_
argument is omitted, it defaults to _"yes"_. This option overwrites
*-n*, *--namelength* _length_::
Specify the maximum length of filenames. Currently, the only allowable values are 14 and 30 for file system versions 1 and 2. Version 3 allows only value 60. The default is 30.
-*--lock*[=_mode_]::
+*--lock*[**=**_mode_]::
Use exclusive BSD lock for device or file it operates. The optional argument _mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument is omitted, it defaults to *yes*. This option overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, but it's recommended to avoid collisions with *systemd-udevd*(8) or other tools.
*-i*, *--inodes* _number_::
*-L*, *--label* _label_::
Specify a _label_ for the device, to allow *swapon*(8) by label.
-*--lock*[=_mode_]::
+*--lock*[**=**_mode_]::
Use exclusive BSD lock for device or file it operates. The optional argument _mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument is omitted, it defaults to *yes*. This option overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, but it's recommended to avoid collisions with *systemd-udevd*(8) or other tools.
*-p*, *--pagesize* _size_::
*--Linux*::
Deprecated and ignored option. Partitioning that is compatible with Linux (and other modern operating systems) is the default.
-*--lock*[=_mode_]::
+*--lock*[**=**_mode_]::
Use exclusive BSD lock for device or file it operates. The optional argument _mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument is omitted, it defaults to *yes*. This option overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, but it's recommended to avoid collisions with *systemd-udevd*(8) or other tools.
*-n*, *--no-act*::
== SYNOPSIS
-*lslogins* [options] [*-s*|*-u*[=_UID_]] [*-g* _groups_] [*-l* _logins_] [_username_]
+*lslogins* [options] [*-s*|*-u*[**=**_UID_]] [*-g* _groups_] [*-l* _logins_] [_username_]
== DESCRIPTION
*-Y, --twelve*::
Display a calendar for the next twelve months.
-*-w*, *--week*[=_number_]::
+*-w*, *--week*[**=**_number_]::
Display week numbers in the calendar according to the US or ISO-8601 format. If
a _number_ is specified, the requested week will be printed in the desired or
current year. The _number_ may be overwritten if _day_ and _month_ are also
+
See the *NOTES* section for more details.
-*--color*[=_when_]::
+*--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.
*-c, --columns*=_columns_::
*-m*, *--list-ioctl*::
List ioctls known to *enosys*.
-*-d*, *--dump*[=_file_]::
+*-d*, *--dump*[**=**_file_]::
Dump seccomp bytecode filter to standard output.
+
The dump can for example be used by *setpriv --seccomp-filter*.
*-e*, *--evaluate*::
Convert all tags (LABEL, UUID, PARTUUID, or PARTLABEL) to the corresponding device names for the SOURCE column. It's an unusual situation, but the same tag may be duplicated (used for more devices). For this purpose, there is SOURCES (pl.) column. This column displays by multi-line cell all devices where the tag is detected by libblkid. This option makes sense for _fstab_ only.
-*--hyperlink*[=_mode_]::
+*--hyperlink*[**=**_mode_]::
Print mountpoint paths as terminal hyperlinks. The _mode_ can be set to "always", "never", or "auto". The optional argument _when_ can be set to "auto", "never", or "always". If the _when_ argument is omitted, it will default to "auto". The "auto" setting means that hyperlinks will only be used if the output is on a terminal.
*-F*, *--tab-file* _path_::
zero-copy way, in this case file contents are not copied to the userspace and all
calculation is done in kernel.
-*--reflink*[=_when_]::
+*--reflink*[**=**_when_]::
Create copy-on-write clones (aka reflinks) rather than hardlinks. The reflinked files
share only on-disk data, but the file mode and owner can be different. It's recommended
to use it with *--ignore-owner* and *--ignore-mode* options. This option implies
*-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.
-*--hyperlink*[=_mode_]::
+*--hyperlink*[**=**_mode_]::
Print mountpoint paths as terminal hyperlinks. The _mode_ can be set to "always", "never", or "auto". The optional argument _when_ can be set to "auto", "never", or "always". If the _when_ argument is omitted, it will default to "auto". The "auto" setting means that hyperlinks will only be used if the output is on a terminal.
*-I*, *--include* _list_::
== OPTIONS
-*-C*, *--cont-clock*[=_time_]::
+*-C*, *--cont-clock*[**=**_time_]::
Activate continuous clock handling for time based UUIDs. *uuidd* could use all possible clock values, beginning with the daemon's start time. The optional argument can be used to set a value for the max_clock_offset. This guarantees, that a clock value of a UUID will always be within the range of the max_clock_offset.
+
The option *-C* or *--cont-clock* enables the feature with a default max_clock_offset of 2 hours.
*-a*, *--all*::
Erase all available signatures. The set of erased signatures can be restricted with the *-t* option.
-*-b*, *--backup*[=_dir_]::
+*-b*, *--backup*[**=**_dir_]::
Create a signature backup to the file _wipefs-<devname>-<offset>.bak_ in _$HOME_ or the directory specified as the optional argument. For more details see the *EXAMPLE* section.
*-f*, *--force*::
*-J*, *--json*::
Use JSON output format.
-*--lock*[=_mode_]::
+*--lock*[**=**_mode_]::
Use exclusive BSD lock for device or file it operates. The optional argument _mode_ can be *yes*, *no* (or 1 and 0) or *nonblock*. If the _mode_ argument is omitted, it defaults to *"yes"*. This option overwrites environment variable *$LOCK_BLOCK_DEVICE*. The default is not to use any lock at all, but it's recommended to avoid collisions with udevd or other tools.
*-i*, *--noheadings*::
*-k*, *--kernel*::
Print kernel messages.
-*-L*, *--color*[=_when_]::
+*-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 below.
*-l*, *--level* _list_::
*-b*, *--online*::
Limit the output to online CPUs (default for *-p*). This option may only be specified together with option *-e* or *-p*.
-*-C*, *--caches*[=_list_]::
+*-C*, *--caches*[**=**_list_]::
Display details about CPU caches. For details about available information see *--help* output.
+
If the _list_ argument is omitted, all columns for which data is available are included in the command output.
*-c*, *--offline*::
Limit the output to offline CPUs. This option may only be specified together with option *-e* or *-p*.
-*--hierarchic*[=_when_]::
+*--hierarchic*[**=**_when_]::
Use subsections in summary output. For backward compatibility, the default is to use subsections only when output on a terminal and flattened output on a non-terminal. The optional argument _when_ can be *never*, *always* or *auto*. If the _when_ argument is omitted, it defaults to "always".
-*-e*, *--extended*[=_list_]::
+*-e*, *--extended*[**=**_list_]::
Display the CPU information in human-readable format.
+
If the _list_ argument is omitted, the default columns are included in the command output. The default output is subject to change.
summary behavior for non-terminals (e.g., pipes) where subsections are missing. See
also *--hierarchic*.
-*-p*, *--parse*[=_list_]::
+*-p*, *--parse*[**=**_list_]::
Optimize the command output for easy parsing.
+
If the _list_ argument is omitted, the command output is compatible with earlier versions of *lscpu*. In this compatible format, two commas are used to separate CPU cache columns. If no CPU caches are identified the cache column is omitted. If the _list_ argument is used, cache columns are separated with a colon (:).
include::man-common/help-version.adoc[]
-*--summary*[=_when_]::
+*--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*.
== AUTHORS
mount -t auto -o'X-mount.auto-fstypes="noext2,ext3"' /dev/sdc1 /mnt/test
____
-*X-mount.mkdir*[=_mode_]::
+*X-mount.mkdir*[**=**_mode_]::
Allow to make a target directory (mountpoint) if it does not exist yet. The optional argument _mode_ specifies the filesystem access mode used for *mkdir*(2) in octal notation. The default mode is 0755. This functionality is supported only for root users or when *mount* is executed without suid permissions. The option is also supported as *x-mount.mkdir*, but this notation is deprecated since v2.30. See also *--mkdir* command line option.
-*X-mount.nocanonicalize*[=_type_]::
+*X-mount.nocanonicalize*[**=**_type_]::
Allows disabling of canonicalization for mount source and target paths. By default, the `mount` command resolves all paths to their absolute paths without symlinks. However, this behavior may not be desired in certain situations, such as when binding a mount over a symlink, or a symlink over a directory or another symlink. The optional argument _type_ can be either "source" or "target" (mountpoint). If no _type_ is specified, then canonicalization is disabled for both types. This mount option does not affect the conversion of source tags (e.g. LABEL= or UUID=) and fstab processing.
+
The command line option *--no-canonicalize* overrides this mount option and affects all path and tag conversions in all situations, but it does not modify flags for open_tree syscalls.
_/proc/pid/cwd_;;
the working directory respectively
-*-m*, *--mount*[=_file_]::
+*-m*, *--mount*[**=**_file_]::
Enter the mount namespace. If no file is specified, enter the mount namespace of the target process. If _file_ is specified, enter the mount namespace specified by _file_.
-*-u*, *--uts*[=_file_]::
+*-u*, *--uts*[**=**_file_]::
Enter the UTS namespace. If no file is specified, enter the UTS namespace of the target process. If _file_ is specified, enter the UTS namespace specified by _file_.
-*-i*, *--ipc*[=_file_]::
+*-i*, *--ipc*[**=**_file_]::
Enter the IPC namespace. If no file is specified, enter the IPC namespace of the target process. If _file_ is specified, enter the IPC namespace specified by _file_.
-*-n*, *--net*[=_file_]::
+*-n*, *--net*[**=**_file_]::
Enter the network namespace. If no file is specified, enter the network namespace of the target process. If _file_ is specified, enter the network namespace specified by _file_.
*-N*, *--net-socket* _fd_::
Enter the network namespace of the target process's socket. It requires *--target* process specified. Supported since Linux 5.6.
-*-p*, *--pid*[=_file_]::
+*-p*, *--pid*[**=**_file_]::
Enter the PID namespace. If no file is specified, enter the PID namespace of the target process. If _file_ is specified, enter the PID namespace specified by _file_.
-*-U*, *--user*[=_file_]::
+*-U*, *--user*[**=**_file_]::
Enter the user namespace. If no file is specified, enter the user namespace of the target process. If _file_ is specified, enter the user namespace specified by _file_. See also the *--setuid* and *--setgid* options.
*--user-parent*::
Enter the parent user namespace. Parent user namespace will be acquired from any other enabled namespace.
If combined with *--user* option the parent user namespace will be fetched from the user namespace and replace it.
-*-C*, *--cgroup*[=_file_]::
+*-C*, *--cgroup*[**=**_file_]::
Enter the cgroup namespace. If no file is specified, enter the cgroup namespace of the target process. If _file_ is specified, enter the cgroup namespace specified by _file_.
-*-T*, *--time*[=_file_]::
+*-T*, *--time*[**=**_file_]::
Enter the time namespace. If no file is specified, enter the time namespace of the target process. If _file_ is specified, enter the time namespace specified by _file_.
*-G*, *--setgid* _gid_::
*--preserve-credentials*::
Don't modify UID and GID when enter user namespace. The default is to drops supplementary groups and sets GID and UID to 0.
-*-r*, *--root*[=_directory_]::
+*-r*, *--root*[**=**_directory_]::
Set the root directory. If no directory is specified, set the root directory to the root directory of the target process. If directory is specified, set the root directory to the specified directory. The specified _directory_ is open before it switches to the requested namespaces.
-*-w*, *--wd*[=_directory_]::
+*-w*, *--wd*[**=**_directory_]::
Set the working directory. If no directory is specified, set the working directory to the working directory of the target process. If directory is specified, set the working directory to the specified directory. The specified _directory_ is open before it switches to the requested namespaces, it means the specified directory works as "tunnel" to the current namespace. See also *--wdns*.
-*-W*, *--wdns*[=_directory_]::
+*-W*, *--wdns*[**=**_directory_]::
Set the working directory. The _directory_ is open after switch to the requested namespaces and after *chroot*(2) call. The options *--wd* and *--wdns* are mutually exclusive.
*-e*, *--env*::
== SYNOPSIS
-*prlimit* [options] [*--resource*[=_limits_]] [*--pid* _PID_]
+*prlimit* [options] [*--resource*[**=**_limits_]] [*--pid* _PID_]
-*prlimit* [options] [*--resource*[=_limits_]] _command_ [_argument_...]
+*prlimit* [options] [*--resource*[**=**_limits_]] _command_ [_argument_...]
== DESCRIPTION
== RESOURCE OPTIONS
-*-c*, *--core*[=_limits_]::
+*-c*, *--core*[**=**_limits_]::
Maximum size of a core file.
-*-d*, *--data*[=_limits_]::
+*-d*, *--data*[**=**_limits_]::
Maximum data size.
-*-e*, *--nice*[=_limits_]::
+*-e*, *--nice*[**=**_limits_]::
Maximum nice priority allowed to raise.
-*-f*, *--fsize*[=_limits_]::
+*-f*, *--fsize*[**=**_limits_]::
Maximum file size.
-*-i*, *--sigpending*[=_limits_]::
+*-i*, *--sigpending*[**=**_limits_]::
Maximum number of pending signals.
-*-l*, *--memlock*[=_limits_]::
+*-l*, *--memlock*[**=**_limits_]::
Maximum locked-in-memory address space.
-*-m*, *--rss*[=_limits_]::
+*-m*, *--rss*[**=**_limits_]::
Maximum Resident Set Size (RSS).
-*-n*, *--nofile*[=_limits_]::
+*-n*, *--nofile*[**=**_limits_]::
Maximum number of open files.
-*-q*, *--msgqueue*[=_limits_]::
+*-q*, *--msgqueue*[**=**_limits_]::
Maximum number of bytes in POSIX message queues.
-*-r*, *--rtprio*[=_limits_]::
+*-r*, *--rtprio*[**=**_limits_]::
Maximum real-time priority.
-*-s*, *--stack*[=_limits_]::
+*-s*, *--stack*[**=**_limits_]::
Maximum size of the stack.
-*-t*, *--cpu*[=_limits_]::
+*-t*, *--cpu*[**=**_limits_]::
CPU time, in seconds.
-*-u*, *--nproc*[=_limits_]::
+*-u*, *--nproc*[**=**_limits_]::
Maximum number of processes.
-*-v*, *--as*[=_limits_]::
+*-v*, *--as*[**=**_limits_]::
Address space limit.
-*-x*, *--locks*[=_limits_]::
+*-x*, *--locks*[**=**_limits_]::
Maximum number of file locks held.
-*-y*, *--rttime*[=_limits_]::
+*-y*, *--rttime*[**=**_limits_]::
Timeout for real-time tasks.
== NOTES
*-l*, *--login-program* _login_program_::
Invoke the specified _login_program_ instead of /bin/login. This allows the use of a non-standard login program. Such a program could, for example, ask for a dial-up password or use a different password file. See *--login-options*.
-*-L*, *--local-line*[=__mode__]::
+*-L*, *--local-line*[**=**__mode__]::
Control the CLOCAL line flag. The optional _mode_ argument is *auto*, *always* or *never*. If the _mode_ argument is omitted, then the default is *always*. If the *--local-line* option is not given at all, then the default is *auto*.
_always_;;
*-q*, *--quiet*::
Be quiet (do not write start and done messages to standard output).
-*-t*[_file_], *--timing*[=_file_]::
+*-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.
include::man-common/help-version.adoc[]
*--background* __8-color__|default::
Sets the background text color.
-*--blank*[=0-60|force|poke]::
+*--blank*[**=**0-60|force|poke]::
Sets the interval of inactivity, in minutes, after which the screen will be automatically blanked (using APM if available). Without an argument, it gets the blank status (returns which vt was blanked, or zero for an unblanked vt). Virtual consoles only.
+
The *force* argument keeps the screen blank even if a key is pressed.
+
The *poke* argument unblanks the screen.
-*--bfreq*[=_number_]::
+*--bfreq*[**=**_number_]::
Sets the bell frequency in Hertz. Without an argument, it defaults to *0*. Virtual consoles only.
-*--blength*[=0-2000]::
+*--blength*[**=**0-2000]::
Sets the bell duration in milliseconds. Without an argument, it defaults to *0*. Virtual consoles only.
*--blink* on|off::
*--bold* on|off::
urns bold (extra bright) mode on or off. Except on a virtual console, *--bold off* turns off all attributes (bold, half-brightness, blink, reverse).
-*--clear*[=all|rest]::
+*--clear*[**=**all|rest]::
Without an argument or with the argument *all*, the entire screen is cleared and the cursor is set to the home position, just like *clear*(1) does. With the argument *rest*, the screen is cleared from the current cursor position to the end.
-*--clrtabs*[=_tab1 tab2 tab3_ ...]::
+*--clrtabs*[**=**_tab1 tab2 tab3_ ...]::
Clears tab stops from the given horizontal cursor positions, in the range *1-160*. Without arguments, it clears all tab stops. Virtual consoles only.
*--cursor* on|off::
*--default*::
Sets the terminal's rendering options to the default values.
-*--dump*[=_console_number_]::
+*--dump*[**=**_console_number_]::
Writes a snapshot of the virtual console with the given number to the file specified with the *--file* option, overwriting its contents; the default is _screen.dump_. Without an argument, it dumps the current virtual console. This overrides *--append*.
*--file* _filename_::
+
Virtual consoles only.
-*--powerdown*[=0-60]::
+*--powerdown*[**=**0-60]::
Sets the VESA powerdown interval in minutes. Without an argument, it defaults to *0* (disable powerdown). If the console is blanked or the monitor is in suspend mode, then the monitor will go into vsync suspend mode or powerdown mode respectively after this period of time has elapsed.
*--powersave* _mode_::
*off*;;
Turns monitor VESA powersaving features.
-*--regtabs*[=1-160]::
+*--regtabs*[**=**1-160]::
Clears all tab stops, then sets a regular tab stop pattern, with one tab every specified number of positions. Without an argument, it defaults to *8*. Virtual consoles only.
*--repeat* on|off::
*--store*::
Stores the terminal's current rendering options (foreground and background colors) as the values to be used at reset-to-default. Virtual consoles only.
-*--tabs*[=_tab1 tab2 tab3_ ...]::
+*--tabs*[**=**_tab1 tab2 tab3_ ...]::
Sets tab stops at the given horizontal cursor positions, in the range *1-160*. Without arguments, it shows the current tab stop settings.
*--term* _terminal_name_::
*-f*, *--format-file* _file_::
Specify a file that contains one or more newline-separated format strings. Empty lines and lines whose first non-blank character is a hash mark (#) are ignored.
-*-L*, *--color*[=_when_]::
+*-L*, *--color*[**=**_when_]::
Accept color units for 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* subsection and the *COLORS* section below.
*-n*, *--length* _length_::
projects / thirdparty / util-linux.git / commitdiff
