neulab/tldr huggingface dataset:
N      If the device stores multiple firmware images in separate regions of non-volatile memory, this parameter may be used to specify which region is to be written.  The default is 0, requesting that all regions are written.  All other values are driver-dependent.
-l --show-channels Queries the specified network device for the numbers of channels it has.  A channel is an IRQ and the set of queues that can trigger that IRQ.
-L --set-channels Changes the numbers of channels of the specified network device.
rx N   Changes the number of channels with only receive queues.
tx N   Changes the number of channels with only transmit queues.
other N Changes the number of channels used only for other purposes e.g. link interrupts or SR-IOV co-ordination.
combined N Changes the number of multi-purpose channels.
-m --dump-module-eeprom --module-info Retrieves and if possible decodes the EEPROM from plugin modules, e.g SFP+, QSFP.  If the driver and module support it, the optical diagnostic information is also read and decoded.  When either one of page, bank or i2c parameters is specified, dumps only of a single page or its portion is allowed. In such a case offset and length parameters are treated relatively to EEPROM page boundaries.
--show-priv-flags Queries the specified network device for its private flags.  The names and meanings of private flags (if any) are defined by each network device driver.
--set-priv-flags Sets the device's private flags as specified.
flag on|off Sets the state of the named private flag.
--show-eee Queries the specified network device for its support of Energy- Efficient Ethernet (according to the IEEE 802.3az specifications)
--set-eee Sets the device EEE behaviour.
eee on|off Enables/disables the device support of EEE.
tx-lpi on|off Determines whether the device should assert its Tx LPI.
advertise N Sets the speeds for which the device should advertise EEE capabilities.  Values are as for --change advertise
tx-timer N Sets the amount of time the device should stay in idle mode prior to asserting its Tx LPI (in microseconds). This has meaning only when Tx LPI is enabled.
--set-phy-tunable Sets the PHY tunable parameters.
downshift on|off Specifies whether downshift should be enabled.
count N Sets the PHY downshift re-tries count.
fast-link-down on|off Specifies whether Fast Link Down should be enabled and time until link down (if supported).
msecs N Sets the period after which the link is reported as down. Note that the PHY may choose the closest supported value. Only on reading back the tunable do you get the actual value.
energy-detect-power-down on|off Specifies whether Energy Detect Power Down (EDPD) should be enabled (if supported).  This will put the RX and TX circuit blocks into a low power mode, and the PHY will wake up periodically to send link pulses to avoid any lock-up situation with a peer PHY that may also have EDPD enabled. By default, this setting will also enable the periodic transmission of TX pulses.
msecs N Some PHYs support configuration of the wake-up interval to send TX pulses. This setting allows the control of this interval, and 0 disables TX pulses if the PHY supports this. Disabling TX pulses can create a lock-up situation where neither of the PHYs wakes the other one. If unspecified the default value (in milliseconds) will be used by the PHY.
--get-phy-tunable Gets the PHY tunable parameters.
downshift For operation in cabling environments that are incompatible with 1000BASE-T, PHY device provides an automatic link speed downshift operation.  Link speed downshift after N failed 1000BASE-T auto-negotiation attempts.  Downshift is useful where cable does not have the 4 pairs instance.
Gets the PHY downshift count/status.
fast-link-down Depending on the mode it may take 0.5s - 1s until a broken link is reported as down.  In certain use cases a link-down event needs to be reported as soon as possible.  Some PHYs support a Fast Link Down Feature and may allow configuration of the delay before a broken link is reported as being down.
Gets the PHY Fast Link Down status / period.
energy-detect-power-down Gets the current configured setting for Energy Detect Power Down (if supported).
--get-tunable Get the tunable parameters.
rx-copybreak Get the current rx copybreak value in bytes.
tx-copybreak Get the current tx copybreak value in bytes.
pfc-prevention-tout Get the current pfc prevention timeout value in msecs.
--set-tunable Set driver's tunable parameters.
rx-copybreak N Set the rx copybreak value in bytes.
tx-copybreak N Set the tx copybreak value in bytes.
pfc-prevention-tout N Set pfc prevention timeout in msecs. Value of 0 means disable and 65535 means auto.
--reset Reset hardware components specified by flags and components listed below
flags N Resets the components based on direct flags mask
mgmt   Management processor
irq    Interrupt requester
dma    DMA engine
filter Filtering/flow direction
offload Protocol offload
mac    Media access controller
phy    Transceiver/PHY
ram    RAM shared between multiple components ap Application Processor
dedicated All components dedicated to this interface
all    All components used by this interface, even if shared
--show-fec Queries the specified network device for its support of Forward Error Correction.
--set-fec Configures Forward Error Correction for the specified network device.
Forward Error Correction modes selected by a user are expected to be persisted after any hotplug events. If a module is swapped that does not support the current FEC mode, the driver or firmware must take the link down administratively and report the problem in the system logs for users to correct.
encoding auto|off|rs|baser|llrs [...]
Sets the FEC encoding for the device.  Combinations of options are specified as e.g.  encoding auto rs ; the semantics of such combinations vary between drivers.
auto    Use the driver's default encoding off     Turn off FEC RS      Force RS-FEC encoding BaseR   Force BaseR encoding LLRS    Force LLRS-FEC encoding
-Q|--per-queue Applies provided sub command to specific queues.
queue_mask %x Sets the specific queues which the sub command is applied to. If queue_mask is not set, the sub command will be applied to all queues.
sub_command Sub command to apply. The supported sub commands include --show-coalesce and --coalesce.
q.B --cable-test Perform a cable test and report the results. What results are returned depends on the capabilities of the network interface. Typically open pairs and shorted pairs can be reported, along with pairs being O.K. When a fault is detected the approximate distance to the fault may be reported.
--cable-test-tdr Perform a cable test and report the raw Time Domain Reflectometer data.  A pulse is sent down a cable pair and the amplitude of the reflection, for a given distance, is reported. A break in the cable returns a big reflection. Minor damage to the cable returns a small reflection. If the cable is shorted, the amplitude of the reflection can be negative. By default, data is returned for lengths between 0 and 150m at 1m steps, for all pairs. However parameters can be passed to restrict the collection of data. It should be noted, that the interface will round the distances to whatever granularity is actually implemented. This is often 0.8 of a meter. The results should include the actual rounded first and last distance and step size.
first  N Distance along the cable, in meters, where the first measurement should be made.
last  N Distance along the cable, in meters, where the last measurement should be made.
step  N Distance, in meters, between each measurement.
pair  N Which pair should be measured. Typically a cable has 4 pairs. 0 = Pair A, 1 = Pair B, ...
--monitor Listens to netlink notification and displays them.
command If argument matching a command is used, ethtool only shows notifications of this type. Without such argument or with --all, all notification types are shown.
devname If a device name is used as argument, only notification for this device are shown. Default is to show notifications for all devices.
--show-tunnels Show tunnel-related device capabilities and state.  List UDP ports kernel has programmed the device to parse as VxLAN, or GENEVE tunnels.
Not supported (in part or whole) on all network drivers.
ethtool was written by David Miller.
Modifications by Jeff Garzik, Tim Hockin, Jakub Jelinek, Andre Majorel, Eli Kupermann, Scott Feldman, Andi Kleen, Alexander Duyck, Sucheta Chakraborty, Jesse Brandeburg, Ben Hutchings, Scott Branden.
ethtool is available from ⟨http://www.kernel.org/pub/software/network/ethtool/⟩
LVEXTEND(8)                  System Manager's Manual                 LVEXTEND(8)
lvextend — Add space to a logical volume
lvextend option_args position_args [ option_args ] [ position_args ]
--alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit -A|--autobackup y|n --commandprofile String --config String -d|--debug --devices PV --devicesfile String --driverloaded y|n -l|--extents [+]Number[PERCENT] -f|--force -h|--help --journal String --lockopt String --longhelp -m|--mirrors Number -n|--nofsck --nohints --nolocking --nosync --noudevsync --poolmetadatasize [+]Size[m|UNIT] --profile String -q|--quiet --reportformat basic|json -r|--resizefs -L|--size [+]Size[m|UNIT] -i|--stripes Number -I|--stripesize Size[k|UNIT] -t|--test --type linear|striped|snapshot|raid|mirror|thin|thin-pool|vdo| vdo-pool|cache|cache-pool|writecache --usepolicies -v|--verbose --version -y|--yes
lvextend extends the size of an LV. This requires allocating logical extents from the VG's free physical extents. If the extension adds a new LV segment, the new segment will use the existing segment type of the LV.
Extending a copy-on-write snapshot LV adds space for COW blocks.
Use lvconvert(8) to change the number of data images in a RAID or mirrored LV.
In the usage section below, --size Size can be replaced with --extents Number.  See both descriptions the options section.
Extend an LV by a specified size.
lvextend -L|--size [+]Size[m|UNIT] LV [ -l|--extents [+]Number[PERCENT] ] [ -r|--resizefs ] [ -i|--stripes Number ] [ -I|--stripesize Size[k|UNIT] ] [    --poolmetadatasize [+]Size[m|UNIT] ] [ COMMON_OPTIONS ] [ PV ... ]
Extend an LV by specified PV extents.
lvextend LV PV ... [ -r|--resizefs ] [ -i|--stripes Number ] [ -I|--stripesize Size[k|UNIT] ] [ COMMON_OPTIONS ]
Extend a pool metadata SubLV by a specified size.
lvextend --poolmetadatasize [+]Size[m|UNIT] LV1 [ -i|--stripes Number ] [ -I|--stripesize Size[k|UNIT] ] [ COMMON_OPTIONS ] [ PV ... ]
LV1 types: thinpool
Extend an LV according to a predefined policy.
lvextend --usepolicies LV1 [ -r|--resizefs ] [ COMMON_OPTIONS ] [ PV ... ]
LV1 types: snapshot thinpool
Common options for command: [ -A|--autobackup y|n ] [ -f|--force ] [ -m|--mirrors Number ] [ -n|--nofsck ] [    --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit ] [    --nosync ] [    --noudevsync ] [    --reportformat basic|json ] [    --type linear|striped|snapshot|raid|mirror|thin|thin-pool|vdo| vdo-pool|cache|cache-pool|writecache ]
Common options for lvm: [ -d|--debug ] [ -h|--help ] [ -q|--quiet ] [ -t|--test ] [ -v|--verbose ] [ -y|--yes ] [    --commandprofile String ] [    --config String ] [    --devices PV ] [    --devicesfile String ] [    --driverloaded y|n ] [    --journal String ] [    --lockopt String ] [    --longhelp ] [    --nohints ] [    --nolocking ] [    --profile String ] [    --version ]
--alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit Determines the allocation policy when a command needs to allocate Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy which can be changed with vgchange/lvchange, or overridden on the command line.  normal applies common sense rules such as not placing parallel stripes on the same PV.  inherit applies the VG policy to an LV.  contiguous requires new PEs be placed adjacent to existing PEs.  cling places new PEs on the same PV as existing PEs in the same stripe of the LV.  If there are sufficient PEs for an allocation, but normal does not use them, anywhere will use them even if it reduces performance, e.g. by placing two stripes on the same PV.  Optional positional PV args on the command line can also be used to limit which PVs the command will use for allocation.  See lvm(8) for more information about allocation.
-A|--autobackup y|n Specifies if metadata should be backed up automatically after a change.  Enabling this is strongly advised! See vgcfgbackup(8) for more information.
--commandprofile String The command profile to use for command configuration.  See lvm.conf(5) for more information about profiles.
--config String Config settings for the command. These override lvm.conf(5) settings.  The String arg uses the same format as lvm.conf(5), or may use section/field syntax.  See lvm.conf(5) for more information about config.
-d|--debug ... Set debug level. Repeat from 1 to 6 times to increase the detail of messages sent to the log file and/or syslog (if configured).
--devices PV Devices that the command can use. This option can be repeated or accepts a comma separated list of devices. This overrides the devices file.
--devicesfile String A file listing devices that LVM should use.  The file must exist in /etc/lvm/devices/ and is managed with the lvmdevices(8) command.  This overrides the lvm.conf(5) devices/devicesfile and devices/use_devicesfile settings.
--driverloaded y|n If set to no, the command will not attempt to use device-mapper. For testing and debugging.
-l|--extents [+]Number[PERCENT] Specifies the new size of the LV in logical extents.  The --size and --extents options are alternate methods of specifying size. The total number of physical extents used will be greater when redundant data is needed for RAID levels.  An alternate syntax allows the size to be determined indirectly as a percentage of the size of a related VG, LV, or set of PVs. The suffix %VG denotes the total size of the VG, the suffix %FREE the remaining free space in the VG, and the suffix %PVS the free space in the specified PVs.  For a snapshot, the size can be expressed as a percentage of the total size of the origin LV with the suffix %ORIGIN (100%ORIGIN provides space for the whole origin).  When expressed as a percentage, the size defines an upper limit for the number of logical extents in the new LV. The precise number of logical extents in the new LV is not determined until the command has completed.  When the plus + or minus - prefix is used, the value is not an absolute size, but is relative and added or subtracted from the current size.
-f|--force ... Override various checks, confirmations and protections.  Use with extreme caution.
-h|--help Display help text.
--journal String Record information in the systemd journal.  This information is in addition to information enabled by the lvm.conf log/journal setting.  command: record information about the command.  output: record the default command output.  debug: record full command debugging.
--lockopt String Used to pass options for special cases to lvmlockd.  See lvmlockd(8) for more information.
--longhelp Display long help text.
-m|--mirrors Number Not used.
-n|--nofsck Do not perform fsck before resizing filesystem when filesystem requires it. You may need to use --force to proceed with this option.
--nohints Do not use the hints file to locate devices for PVs. A command may read more devices to find PVs when hints are not used. The command will still perform standard hint file invalidation where appropriate.
--nolocking Disable locking.
--nosync Causes the creation of mirror, raid1, raid4, raid5 and raid10 to skip the initial synchronization. In case of mirror, raid1 and raid10, any data written afterwards will be mirrored, but the original contents will not be copied. In case of raid4 and raid5, no parity blocks will be written, though any data written afterwards will cause parity blocks to be stored.  This is useful for skipping a potentially long and resource intensive initial sync of an empty mirror/raid1/raid4/raid5 and raid10 LV.  This option is not valid for raid6, because raid6 relies on proper parity (P and Q Syndromes) being created during initial synchronization in order to reconstruct proper user date in case of device failures.  raid0 and raid0_meta do not provide any data copies or parity support and thus do not support initial synchronization.
--noudevsync Disables udev synchronisation. The process will not wait for notification from udev. It will continue irrespective of any possible udev processing in the background. Only use this if udev is not running or has rules that ignore the devices LVM creates.
--poolmetadatasize [+]Size[m|UNIT] Specifies the new size of the pool metadata LV.  The plus prefix + can be used, in which case the value is added to the current size.
--profile String An alias for --commandprofile or --metadataprofile, depending on the command.
-q|--quiet ... Suppress output and log messages. Overrides --debug and --verbose. Repeat once to also suppress any prompts with answer 'no'.
--reportformat basic|json Overrides current output format for reports which is defined globally by the report/output_format setting in lvm.conf(5). basic is the original format with columns and rows.  If there is more than one report per command, each report is prefixed with the report name for identification. json produces report output in JSON format. See lvmreport(7) for more information.
-r|--resizefs Resize underlying filesystem together with the LV using fsadm(8).
-L|--size [+]Size[m|UNIT] Specifies the new size of the LV.  The --size and --extents options are alternate methods of specifying size.  The total number of physical extents used will be greater when redundant data is needed for RAID levels.  When the plus + or minus - prefix is used, the value is not an absolute size, but is relative and added or subtracted from the current size.
-i|--stripes Number Specifies the number of stripes in a striped LV. This is the number of PVs (devices) that a striped LV is spread across. Data that appears sequential in the LV is spread across multiple devices in units of the stripe size (see --stripesize). This does not change existing allocated space, but only applies to space being allocated by the command.  When creating a RAID 4/5/6 LV, this number does not include the extra devices that are required for parity. The largest number depends on the RAID type (raid0: 64, raid10: 32, raid4/5: 63, raid6: 62), and when unspecified, the default depends on the RAID type (raid0: 2, raid10: 2, raid4/5: 3, raid6: 5.)  To stripe a new raid LV across all PVs by default, see lvm.conf(5) allocation/raid_stripe_all_devices.
-I|--stripesize Size[k|UNIT] The amount of data that is written to one device before moving to the next in a striped LV.
-t|--test Run in test mode. Commands will not update metadata.  This is implemented by disabling all metadata writing but nevertheless returning success to the calling function. This may lead to unusual error messages in multi-stage operations if a tool relies on reading back metadata it believes has changed but hasn't.
--type linear|striped|snapshot|raid|mirror|thin|thin-pool|vdo|vdo-pool| cache|cache-pool|writecache The LV type, also known as "segment type" or "segtype".  See usage descriptions for the specific ways to use these types.  For more information about redundancy and performance (raid<N>, mirror, striped, linear) see lvmraid(7).  For thin provisioning (thin, thin-pool) see lvmthin(7).  For performance caching (cache, cache-pool) see lvmcache(7).  For copy-on-write snapshots (snapshot) see usage definitions.  For VDO (vdo) see lvmvdo(7). Several commands omit an explicit type option because the type is inferred from other options or shortcuts (e.g. --stripes, --mirrors, --snapshot, --virtualsize, --thin, --cache, --vdo). Use inferred types with care because it can lead to unexpected results.
--usepolicies Perform an operation according to the policy configured in lvm.conf(5) or a profile.
-v|--verbose ... Set verbose level. Repeat from 1 to 4 times to increase the detail of messages sent to stdout and stderr.
--version Display version information.
-y|--yes Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution.  (For automatic no, see -qq.)
LV     Logical Volume name.  See lvm(8) for valid names.  An LV positional arg generally includes the VG name and LV name, e.g. VG/LV.  LV1 indicates the LV must have a specific type, where the accepted LV types are listed. (raid represents raid<N> type).
PV     Physical Volume name, a device path under /dev.  For commands managing physical extents, a PV positional arg generally accepts a suffix indicating a range (or multiple ranges) of physical extents (PEs). When the first PE is omitted, it defaults to the start of the device, and when the last PE is omitted it defaults to end. Start and end range (inclusive): PV[:PE-PE]...  Start and length range (counting from 0): PV[:PE+PE]...
String See the option description for information about the string content.
Size[UNIT] Size is an input number that accepts an optional unit.  Input units are always treated as base two values, regardless of capitalization, e.g. 'k' and 'K' both refer to 1024.  The default input unit is specified by letter, followed by |UNIT.  UNIT represents other possible input units: b|B is bytes, s|S is sectors of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB, p|P is PiB, e|E is EiB.  (This should not be confused with the output control --units, where capital letters mean multiple of 1000.)
See lvm(8) for information about environment variables used by lvm.  For example, LVM_VG_NAME can generally be substituted for a required VG parameter.
Extend the size of an LV by 54MiB, using a specific PV. lvextend -L +54 vg01/lvol10 /dev/sdk3
Extend the size of an LV by the amount of free space on PV /dev/sdk3. This is equivalent to specifying "-l +100%PVS" on the command line. lvextend vg01/lvol01 /dev/sdk3
Extend an LV by 16MiB using specific physical extents. lvextend -L+16m vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9
Extend an LV to use all remaining free space in volume group and all resize its filesystem with fsadm(8). lvextend -l+100%FREE -r vg01/lvol01
lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8), pvremove(8), pvresize(8), pvs(8), pvscan(8),
vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8), vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8), vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8), vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8), lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
lvm-fullreport(8), lvm-lvpoll(8), lvm2-activation-generator(8), blkdeactivate(8), lvmdump(8),
dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8), lvmdbusd(8), fsadm(8),
lvmsystemid(7), lvmreport(7), lvmraid(7), lvmthin(7), lvmcache(7)
INSTALL(1)                        User Commands                       INSTALL(1)
install - copy files and set attributes
install [OPTION]... [-T] SOURCE DEST install [OPTION]... SOURCE... DIRECTORY install [OPTION]... -t DIRECTORY SOURCE... install [OPTION]... -d DIRECTORY...
This install program copies files (often just compiled) into destination locations you choose.  If you want to download and install a ready-to-use package on a GNU/Linux system, you should instead be using a package manager like yum(1) or apt-get(1).
In the first three forms, copy SOURCE to DEST or multiple SOURCE(s) to the existing DIRECTORY, while setting permission modes and owner/group. In the 4th form, create all components of the given DIRECTORY(ies).
--backup[=CONTROL] make a backup of each existing destination file
-b     like --backup but does not accept an argument
-c     (ignored)
-C, --compare compare each pair of source and destination files, and in some cases, do not modify the destination at all
-d, --directory treat all arguments as directory names; create all components of the specified directories
-D     create all leading components of DEST except the last, or all components of --target-directory, then copy SOURCE to DEST
-g, --group=GROUP set group ownership, instead of process' current group
-m, --mode=MODE set permission mode (as in chmod), instead of rwxr-xr-x
-o, --owner=OWNER set ownership (super-user only)
-p, --preserve-timestamps apply access/modification times of SOURCE files to corresponding destination files
-s, --strip strip symbol tables
--strip-program=PROGRAM program used to strip binaries
-S, --suffix=SUFFIX override the usual backup suffix
-t, --target-directory=DIRECTORY copy all SOURCE arguments into DIRECTORY
-T, --no-target-directory treat DEST as a normal file
-v, --verbose print the name of each directory as it is created
--preserve-context preserve SELinux security context
-Z     set SELinux security context of destination file and each created directory to default type
The backup suffix is '~', unless set with --suffix or SIMPLE_BACKUP_SUFFIX.  The version control method may be selected via the --backup option or through the VERSION_CONTROL environment variable. Here are the values:
none, off never make backups (even if --backup is given)
numbered, t make numbered backups
existing, nil numbered if numbered backups exist, simple otherwise
simple, never always make simple backups
Full documentation <https://www.gnu.org/software/coreutils/install> or available locally via: info '(coreutils) install invocation'
GROUPS(1)                         User Commands                        GROUPS(1)
groups - display current group names
groups [user]
The groups command displays the current group names or ID values. If the value does not have a corresponding entry in /etc/group, the value will be displayed as the numerical group value. The optional user parameter will display the groups for the named user.
Systems which do not support concurrent group sets will have the information from /etc/group reported. The user must use newgrp or sg to change his current real and effective group ID.
newgrp(1), getgid(2), getgroups(2), getuid(2).
runsv(8)                     System Manager's Manual                    runsv(8)
runsv - starts and monitors a service and optionally an appendant log service
runsv service
service must be a directory.
runsv switches to the directory service and starts ./run.  If ./run exits and ./finish exists, runsv starts ./finish.  If ./finish doesn't exist or ./finish exits, runsv restarts ./run.
If ./run or ./finish exit immediately, runsv waits a second before starting ./finish or restarting ./run.
Two arguments are given to ./finish.  The first one is ./run's exit code, or -1 if ./run didn't exit normally.  The second one is the least significant byte of the exit status as determined by waitpid(2); for instance it is 0 if ./run exited normally, and the signal number if ./run was terminated by a signal.  If runsv cannot start ./run for some reason, the exit code is 111 and the status is 0.
If the file service/down exists, runsv does not start ./run immediately. The control interface (see below) can be used to start the service and to give other commands to runsv.
If the directory service/log exists, runsv creates a pipe, redirects service/run's and service/finish's standard output to the pipe, switches to the directory service/log and starts ./run script. The standard input of the log service is redirected to read from the pipe.
runsv maintains status information in a binary format (compatible to the daemontools' supervise program) in service/supervise/status and service/log/supervise/status, and in a human-readable format in service/supervise/stat, service/log/supervise/stat, service/supervise/pid, service/log/supervise/pid.
The named pipes service/supervise/control, and (optionally) service/log/supervise/control are provided to give commands to runsv. You can use sv(8) to control the service or just write one of the following characters to the named pipe:
u      Up.  If the service is not running, start it.  If the service stops, restart it.
d      Down.  If the service is running, send it a TERM signal, and then a CONT signal.  If ./run exits, start ./finish if it exists. After it stops, do not restart service.
o      Once.  If the service is not running, start it.  Do not restart it if it stops.
p      Pause.  If the service is running, send it a STOP signal.
c      Continue.  If the service is running, send it a CONT signal.
h      Hangup.  If the service is running, send it a HUP signal.
a      Alarm.  If the service is running, send it a ALRM signal.
i      Interrupt.  If the service is running, send it a INT signal.
q      Quit.  If the service is running, send it a QUIT signal.
1      User-defined 1.  If the service is running, send it a USR1 signal.
2      User-defined 2.  If the service is running, send it a USR2 signal.
t      Terminate.  If the service is running, send it a TERM signal.
k      Kill.  If the service is running, send it a KILL signal.
x      Exit.  If the service is running, send it a TERM signal, and then a CONT signal.  Do not restart the service.  If the service is down, and no log service exists, runsv exits.  If the service is down and a log service exists, runsv closes the standard input of the log service, and waits for it to terminate.  If the log service is down, runsv exits.  This command is ignored if it is given to service/log/supervise/control.
Example: to send a TERM signal to the socklog-unix service, either do # sv term /etc/service/socklog-unix or # printf t >/etc/service/socklog-unix/supervise/control
printf(1) usually blocks if no runsv process is running in the service directory.
For each control character c sent to the control pipe, runsv first checks if service/control/c exists and is executable.  If so, it starts service/control/c and waits for it to terminate, before interpreting the command.  If the program exits with return code 0, runsv refrains from sending the service the corresponding signal.  The command o is always considered as command u.  On command d first service/control/t is checked, and then service/control/d.  On command x first service/control/t is checked, and then service/control/x.  The control of the optional log service cannot be customized.
If runsv receives a TERM signal, it acts as if the character x was written to the control pipe.
runsv exits 111 on an error on startup or if another runsv is running in service.
runsv exits 0 if it was told to exit.
sv(8), chpst(8), svlogd(8), runit(8), runit-init(8), runsvdir(8), runsvchdir(8), utmpset(8)
http://smarden.org/runit/
Gerrit Pape <pape@smarden.org>
CSVTOOL(1)                       [FIXME: manual]                      CSVTOOL(1)
csvtool - tool for performing manipulations on CSV files from shell scripts
csvtool [options] command [command-args] input.csv...
This manual page documents briefly the csvtool command.
This manual page was written for the Debian distribution because the original program does not have a manual page. Instead, it has documentation accessible with the --help option.
csvtool is a tool for performing manipulations on CSV files from shell scripts.
-help --help Show help.
This manual page was written by Stephane Glondu <steph@glondu.net> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.
Copyright Â© 2008 Stephane Glondu
THUNDERBIRD(1)                 Linux User's Manual                THUNDERBIRD(1)
thunderbird - Mail User Agent (MUA) and newsgroup/RSS client for X11 derived from the Mozilla Thunderbird.
/usr/lib/thunderbird/thunderbird [OPTIONS] [URL]
/usr/lib/thunderbird/thunderbird-bin [OPTIONS] [URL]
Thunderbird provides IMAP/POP support, a built-in RSS reader, support for HTML mail, powerful quick search, saved search folders, advanced message filtering, junk mail controls, message grouping, labels, return receipts, smart address book, LDAP address completion, import tools and the ability to manage multiple identities in email and newsgroup accounts.
Thunderbird provides enterprise and government grade security such as S/MIME, digital signing, message encryption, and support for certificates and security devices.
thunderbird is a executable file that will set up the environment for the starting executable, thunderbird-bin.  If there is an Thunderbird mail client already running, thunderbird will arrange for it to create a new mail client window; otherwise it will start the Thunderbird application.
A summary of the options supported by thunderbird is included below.
X11 options --display=DISPLAY X display to use
--sync Make X calls synchronous
--g-fatal-warnings Make all warnings fatal
Mozilla options -h, -help Show summary of options.
-v, -version Print the Thunderbird version.
-P [profile] Start with profile. When no profile is given, displays the Profile Manager. May require -no-remote, see below.
--profile [path] Start with with [profile] from the given [path].
--migration Start with migration wizard. May require -no-remote, see below.
--ProfileManager Start with profile manager. May require -no-remote, see below.
--no-remote Don't connect to a running Thunderbird instance. Don't accept or send remote commands. This option can be necessary in conjunction to several of the options above, that won't have any effect when an Thunderbird instance is running unless -no-remote is used at the same time.
--new-instance Open a new instance instead of a new windows in the running instance.
--UILocale locale Start with locale resources as User Interface locale. By default, it is guessed from environment and available locales for Thunderbird.
--safe-mode Starts Thunderbird in safe mode, i.e. disabling all extensions and showing a bit more debugging messages.
--jsconsole Start with Javascript Console
-addressbook Open the address book at startup.
-compose Compose a mail or news message.
-mail  Open the mail folder view.
-mail URL Open the message specified by this URL.
-news  Open the news client.
-setDefaultMail Set Thunderbird as the default mail client.
-options Open the options dialog.
-file  Open the specified email file.
-g     Starts Thunderbird through a debugger (gdb by default).
MOZILLA_DISABLE_PLUGINS - when set, totally disables loading plugins.
/usr/bin/thunderbird - shell script wrapping thunderbird-bin
/usr/lib/thunderbird/thunderbird-bin - thunderbird executable
Some typical use case for starting Thunderbird from a console Starting Thunderbird without any extra options, useful to any messages from thunderbird in case something went not o.k.:
Starting Thunderbird without any extensions or themes, useful if extensions may make some trouble:
thunderbird --safe-mode
Starting Thunderbird with a composing window:
thunderbird -compose
Starting Thunderbird with the default debugger:
/usr/lib/thunderbird/run-mozilla.sh -debug /usr/lib/thunderbird/thunderbird-bin
Starting Thunderbird with the specific debugger:
/usr/lib/thunderbird/run-mozilla.sh --debugger /foo/bar/debugger /usr/lib/thunderbird/thunderbird-bin
To report a bug, please visit http://bugzilla.mozilla.org/ and/or report bugs to the Debian Bug Tracking System, as usual.
The Mozilla Organization http://www.mozilla.org/about.html
MUTT(1)                           User Manuals                           MUTT(1)
mutt - The Mutt Mail User Agent
mutt  [-nRyzZ] [-e command] [-F rcfile] [-m type] [-f mailbox]
mutt  [-Enx] [-e command] [-F rcfile] [-H draft] [-i include] [-b bcc-addr] [-c cc-addr] [-s subject] [-a file ... --] to-addr ...
mutt  [-nx] [-e command] [-F rcfile] [-b bcc-addr] [-c cc-addr] [-s subject] [-a file ... --] to-addr ... < message
mutt  [-n] [-e command] [-F rcfile] -p
mutt  [-n] [-e command] [-F rcfile] -A alias
mutt  [-n] [-e command] [-F rcfile] -Q variable
mutt  -v[v]
mutt  -D
Mutt is a small but very powerful text based program for reading and sending electronic mail under unix operating systems, including support for color terminals, MIME, OpenPGP, and a threaded sorting mode.
Note: This manual page gives a brief overview of the mutt executable command line options.  A copy of the full manual is located in /usr/share/doc/mutt, in text, HTML, and/or PDF format.  Please refer to the manual to learn how to use and configure Mutt.
-A alias Print an expanded version of the given alias and exit.
-a file ... Attach a file using MIME.  Separating file and to-addr arguments with “--” is mandatory.  For example:
mutt -a image.jpg -- to-addr mutt -a img.jpg *.png -- to-addr-1 to-addr-2
The -a option must be placed at the end of command line options.
-b bcc-addr Specify a blind carbon copy (BCC) address.
-c cc-addr Specify a carbon copy (CC) address.
-d level If Mutt was compiled with +DEBUG log debugging output to ~/.muttdebug0.  Level can range from -5 to 5 and affects verbosity. A value of zero disables debugging. A value less than zero disables automatic log file rotation; the log level is then its absolute value. A value of 2 (-2) is recommended for most diagnosis.
-D     Print the value of all configuration options to stdout.
-E     Edit the draft file specified by -H or include file specified by -i during message composition.
-e command Specify a configuration command to be run after processing of initialization files.
-f mailbox Specify a mailbox to load.
-F rcfile Use rcfile instead of the user configuration file.
-h     Display a short option summary and exit.
-H draft Specify a draft file which contains header and body to use to send a message.  If draft is “-”, then data is read from stdin.  The draft file is expected to contain just an RFC822 email — headers and a body.  Although it is not an mbox file, if an mbox "From " line is present, it will be silently discarded.  Draft files are processed the same in interactive and batch mode; they are not passed through untouched.  For example, encrypted draft files will be decrypted.
-i include Specify an include file to be inserted into the body of a message. Ignored if -H is set.  If include is “-”, then data is read from stdin.
-m type Specify a default mailbox type for newly created folders.  Can be one of the following: mbox, MMDF, MH or Maildir.  See also $mbox_type in the manual.
-n     Do not read the system-wide Muttrc configuration file.
-p     Resume a postponed message.  Exit immediately if there are no postponed messages.
-Q variable Query a configuration variable.  The query is performed after all configuration files have been parsed, and any commands given on the command line have been executed.
-R     Open a mailbox in read-only mode.
-s subject Specify the subject of the message.  Must be enclosed in quotes if it contains spaces.
-v     Display the Mutt version number and compile-time definitions.
-vv    Display license and copyright information.
-x     Emulate the mailx(1) compose mode.
-y     Start Mutt with a listing of all mailboxes specified by the mailboxes configuration command.
-z     Exit immediately with code 1 if mailbox specified by -f does not contain any messages.
-Z     Open the first mailbox specified by the mailboxes configuration command which contains new mail.  Exit immediately with code 1 if there is no new mail in any of them.
--     Treat remaining arguments as to-addr even if they start with a dash.  See also -a above.  To-addr can be a local or network mail address as well as mailto: URL.
EDITOR, VISUAL Specifies the editor to use when composing messages.  If both EDITOR and VISUAL are set, VISUAL takes precedence.  If neither EDITOR nor VISUAL are set, the default is vi(1).
EGDSOCKET, RANDFILE Paths used to initialize the random engine for SSL library.
EMAIL  The user's e-mail address.
HOME   Full path of the user's home directory.
MAIL   Full path of the user's spool mailbox.
MAILDIR Full path of the user's spool mailbox if MAIL is unset.  Commonly used when the spool mailbox is a maildir(5) folder.
MAILCAPS Path to search for mailcap files.
MM_NOASK If this variable is set, mailcap are always used without prompting first.
PGPPATH Directory in which the user's PGP public keyring can be found. When used with the original PGP program, mutt and mutt_pgpring(1) rely on this being set.
REPLYTO Default Reply-To address.
TMPDIR Directory in which temporary files are created.  If unset, /tmp is used.  See also $tmpdir configuration variable.
LC_ALL, LC_CTYPE, LANG Used to determine charset and locale to use.
TEXTDOMAINDIR Directory containing translation files.  If set, this path overwrite the Mutt installation directory.  Used for testing translation changes.
~/.muttrc ~/.mutt/muttrc $XDG_CONFIG_HOME/mutt/muttrc User configuration files.
/etc/Muttrc or /usr/share/mutt/Muttrc System-wide configuration file.
/tmp/muttXXXXXX Temporary files created by Mutt.
~/.muttdebug0 File containing debugging output.  Log files are automatically rotated by mutt changing the number at the end.  See -d option above.
~/.mailcap User definition for handling non-text MIME types.
/etc/mailcap System definition for handling non-text MIME types.
~/.mime.types User's personal mapping between MIME types and file extensions.
/etc/mime.types System mapping between MIME types and file extensions.
/usr/bin/mutt_dotlock The privileged dotlocking program.
/usr/share/doc/mutt/manual.txt The Mutt manual.
None.  Mutts have fleas, not bugs.
Suspend/resume while editing a file with an external editor does not work under SunOS 4.x if you use the curses lib in /usr/5lib.  It does work with the S-Lang library, however.
Resizing the screen while using an external pager causes Mutt to go haywire on some systems.
Suspend/resume does not work under Ultrix.
The help line for the index menu is not updated if you change the bindings for one of the functions listed while Mutt is running.
For a more up-to-date list of bugs, errm, fleas, please visit the mutt project's bug tracking system under https://gitlab.com/muttmua/mutt/issues.
mutt_dotlock(1), mutt_pgpring(1), pgpewrap(1), sendmail(1), smail(1), smime_keys(1), curses(3), ncurses(3), mailcap(5), maildir(5), mbox(5), mmdf(5), muttrc(5)
Mutt Home Page: http://www.mutt.org/
The Mutt manual
RFC5322 — Internet Message Format: https://tools.ietf.org/rfcmarkup/5322 (obsoletes RFC2822 and RFC822)
Michael Elkins, and others.  Use <mutt-dev@mutt.org> to contact the developers.
cheat(1)                     General Commands Manual                    cheat(1)
cheat [option] command
cheat displays a cheatsheet for popular posix commands. It's designed to help remind system administrators of options and syntax for commands that they use frequently, but not frequently enough to remember.
Cheat differs from info or man in that cheat is example-centric. You learn from cheatsheets by seeing common examples of how the command is used, rather than reading about every option technically available. In other words, cheat is not complete, but by design. It shows you how a command is most frequently used, and that's all.
Issue this command:
cheat foo
and a cheatsheet for foo is displayed onscreen.
-d, --directories List directories on CHEATPATH
-e, --edit [cheat sheet] Edit an existing cheatsheet
-l, --list List all cheatsheets
-s, --search [keyword] Search for cheatsheet matching KEYWORD
-v, --version Print the version number
CHEATPATH environment variable By default, the location for cheatsheets is set to PYTHONPATH/cheat/cheatsheets
Additional cheatsheets may be stored in $HOME/.cheat
You can override the system location of cheatsheets by exporting a CHEATPATH environment variable pointing to an alternate location. For example, in your .bashrc file: export CHEATPATH=/opt/cheatsheets
Chris Allen Lane https://github.com/chrisallenlane
apropos(1), whatis(1), man(1), info(1), man.conf(5).
scancel(1)                       Slurm Commands                       scancel(1)
scancel - Used to signal jobs or job steps that are under the control of Slurm.
scancel [OPTIONS...] [job_id[_array_id][.step_id]] [job_id[_array_id][.step_id]...]
scancel is used to signal or cancel jobs, job arrays or job steps.  An arbitrary number of jobs or job steps may be signaled using job specification filters or a space separated list of specific job and/or job step IDs.  If the job ID of a job array is specified with an array ID value then only that job array element will be cancelled.  If the job ID of a job array is specified without an array ID value then all job array elements will be cancelled.  While a heterogeneous job is in pending state, only the entire job can be cancelled rather than its individual components.  A request to cancel an individual component of a heterogeneous job not in pending state will return an error.  After the job has begun execution, the individual component can be cancelled.  A job or job step can only be signaled by the owner of that job or user root.  If an attempt is made by an unauthorized user to signal a job or job step, an error message will be printed and the job will not be signaled.
-A, --account=account Restrict the scancel operation to jobs under this charge account.
-b, --batch By default, signals other than SIGKILL are not sent to the batch step (the shell script). With this option scancel signals only the batch step, but not any other steps.  This is useful when the shell script has to trap the signal and take some application defined action.  Note that most shells cannot handle signals while a command is running (child process of the batch step), the shell use to wait until the command ends to then handle the signal. Children of the batch step are not signaled with this option, use -f, --full instead.  NOTE: If used with -f, --full, this option ignored.  NOTE: This option is not applicable if step_id is specified.  NOTE: The shell itself may exit upon receipt of many signals.  You may avoid this by explicitly trap signals within the shell script (e.g. "trap <arg> <signals>"). See the shell documentation for details.
--ctld Send the job signal request to the slurmctld daemon rather than directly to the slurmd daemons. This increases overhead, but offers better fault tolerance.  This is the default behavior on architectures using front end nodes (e.g.  Cray ALPS computers) or when the --clusters option is used.
-f, --full By default, signals other than SIGKILL are not sent to the batch step (the shell script). With this option scancel signals also the batch script and its children processes.  Most shells cannot handle signals while a command is running (child process of the batch step), the shell use to wait until the command ends to then handle the signal. Unlike -b, --batch, children of the batch step are also signaled with this option.  NOTE: srun steps are also children of the batch step, so steps are also signaled with this option.
--help Print a help message describing all scancel options.
-H, --hurry Do not stage out any burst buffer data.
-i, --interactive Interactive mode. Confirm each job_id.step_id before performing the cancel operation.
-M, --clusters=<string> Cluster to issue commands to. Implies --ctld.  Note that the SlurmDBD must be up for this option to work properly.
-n, --jobname=job_name, --name=job_name Restrict the scancel operation to jobs with this job name.
-p, --partition=partition_name Restrict the scancel operation to jobs in this partition.
-q, --qos=qos Restrict the scancel operation to jobs with this quality of service.
-Q, --quiet Do not report an error if the specified job is already completed. This option is incompatible with the --verbose option.
-R, --reservation=reservation_name Restrict the scancel operation to jobs with this reservation name.
--sibling=cluster_name Remove an active sibling job from a federated job.
-s, --signal=signal_name The name or number of the signal to send.  If this option is not used the specified job or step will be terminated. Note. If this option is used the signal is sent directly to the slurmd where the job is running bypassing the slurmctld thus the job state will not change even if the signal is delivered to it. Use the scontrol command if you want the job state change be known to slurmctld.
-t, --state=job_state_name Restrict the scancel operation to jobs in this state. job_state_name may have a value of either "PENDING", "RUNNING" or "SUSPENDED".
-u, --user=user_name Restrict the scancel operation to jobs owned by this user.
--usage Print a brief help message listing the scancel options.