tripathysagar/man_text huggingface dataset:
# pmdabonding

## NAME



           **pmdabonding** - Linux bonded interface performance metrics domain
           agent (PMDA)
    


## DESCRIPTION



           **pmdabonding** is a Performance Metrics Domain Agent (PMDA) which
           exports metric values from bonded network interfaces in the Linux
           kernel.
    


## INSTALLATION



           Install the bonding PMDA by using the Install script as root:
    
               **# cd $PCP_PMDAS_DIR/bonding**
               **# ./Install**
    
           To uninstall, the following must be done as root:
    
               **# cd $PCP_PMDAS_DIR/bonding**
               **# ./Remove**
    
           **pmdabonding** is launched by pmcd(1) and should never be executed
           directly. The Install and Remove scripts notify pmcd(1) when the
           agent is installed or removed.
    


## FILES



           **$PCP_PMDAS_DIR/bonding/Install**
               installation script for the **pmdabonding** agent
    
           **$PCP_PMDAS_DIR/bonding/Remove**
               undo installation script for the **pmdabonding** agent
    
           **$PCP_LOG_DIR/pmcd/bonding.log**
               default log file for error messages from **pmdabonding**
    


## PCP ENVIRONMENT



           Environment variables with the prefix **PCP_** are used to
           parameterize the file and directory names used by **PCP**. On each
           installation, the file **/etc/pcp.conf** contains the local values for
           these variables.  The **$PCP_CONF** variable may be used to specify an
           alternative configuration file, as described in pcp.conf(5).
    


* * *
# vlock

## NAME



           vlock - Virtual Console lock program
    


## SYNOPSIS



           **vlock**
    
           **vlock [ -a,--all ] [ -c,--current ] [ -h,--help ] [ -v,--version ]**
    


## DESCRIPTION



           **vlock** is a program to lock one or more sessions on the Linux
           console.  This is especially useful for Linux machines which have
           multiple users with access to the console.  One user may lock his
           or her session(s) while still allowing other users to use the
           system on other virtual consoles.  If desired, the entire console
           may be locked and virtual console switching disabled.
    
           By default, only the current VC (virtual console) is locked.  With
           the **-a,-all** option all VCs are locked.  The locked VCs cannot be
           unlocked without the invoker's password.  And, for the paranoid,
           vlock makes it a trying experience for those attempting to guess
           the password, so unauthorized access to session(s) is highly
           unlikely.
    
           Please note that it is entirely possible to completely lock
           yourself out of the console with the **-a,--all** option if you cannot
           remember your password!  Unless you are able to kill vlock by
           logging in remotely via a serial terminal or network, a hard reset
           is the only method of ``unlocking'' the display.
    
           **vlock** works for console sessions primarily.  However, there is
           support for trying to lock non-console sessions as well, but that
           support has not been well tested.
    


## OPTIONS



           **-a,--all**
    
                  Lock all console sessions and disable VC switching.
    
           **-c,--current**
    
                  Lock the current session (this is the default).
    
           **-h,--help**
    
                  Print a brief help message.
    
           **-v,--version**
    
                  Print the version number of **vlock**.
    


* * *
# mbstream

## NAME



           mbstream - Serialize/deserialize files in the XBSTREAM format
    


## DESCRIPTION



           Use **mbstream --help** for details on usage.
    
           For more information, please refer to the MariaDB Knowledge Base,
           available online at https://mariadb.com/kb/
    


* * *
# flatpak-permission-show

## NAME



           flatpak-permission-show - Show permissions
    


## SYNOPSIS



    
           **flatpak permission-show**[OPTION...] APP_ID
    


## DESCRIPTION



           Lists dynamic permissions for the given app which are stored in
           the Flatpak permission store.
    
           The permission store is used by portals. Each portal generally has
           its own table in the permission store, and the format of the table
           entries is specific to each portal.
    


## OPTIONS



           The following options are understood:
    
           **-h** , **--help**
               Show help options and exit.
    
           **-v** , **--verbose**
               Print debug information during command processing.
    
           **--ostree-verbose**
               Print OSTree debug information during command processing.
    


* * *
# ms_print

## NAME



           ms_print - post-processing tool for Massif
    


## SYNOPSIS



    
           **ms_print**[_options_] _massif-out-file_
    


## DESCRIPTION



           **ms_print** takes an output file produced by the Valgrind tool Massif
           and prints the information in an easy-to-read form.
    


## OPTIONS



           **-h --help**
               Show the help message.
    
           **--version**
               Show the version number.
    
           **--threshold= <m.n> [default: 1.0]**
               Same as Massif's **--threshold** option, but applied after
               profiling rather than during.
    
           **--x= <4..1000> [default: 72]**
               Width of the graph, in columns.
    
           **--y= <4..1000> [default: 20]**
               Height of the graph, in rows.
    


* * *
# trace-cmd-stop

## NAME



           trace-cmd-stop - stop the Ftrace Linux kernel tracer from writing
           to the ring buffer.
    


## SYNOPSIS



           **trace-cmd stop**[_OPTIONS_]
    


## DESCRIPTION



           The trace-cmd(1) stop is a complement to trace-cmd-start(1). This
           will disable Ftrace from writing to the ring buffer. This does not
           stop the overhead that the tracing may incur. Only the updating of
           the ring buffer is disabled, the Ftrace tracing may still be
           inducing overhead.
    
           After stopping the trace, the trace-cmd-extract(1) may strip out
           the data from the ring buffer and create a trace.dat file. The
           Ftrace pseudo file system may also be examined.
    
           To disable the tracing completely to remove the overhead it
           causes, use trace-cmd-reset(1). But after a reset is performed,
           the data that has been recorded is lost.
    


## OPTIONS



           **-B** _buffer-name_
               If the kernel supports multiple buffers, this will stop the
               trace for only the given buffer. It does not affect any other
               buffer. This may be used multiple times to specify different
               buffers. When this option is used, the top level instance will
               not be stopped unless **-t** is given.
    
           **-a**
               Stop the trace for all existing buffer instances. When this
               option is used, the top level instance will not be stopped
               unless **-t** is given.
    
           **-t**
               Stops the top level instance buffer. Without the **-B** or **-a**
               option this is the same as the default. But if **-B** or **-a** is
               used, this is required if the top level instance buffer should
               also be stopped.
    


## RESOURCES



           **https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/ **
    


## COPYING



           Copyright (C) 2010 Red Hat, Inc. Free use of this software is
           granted under the terms of the GNU Public License (GPL).
    


## NOTES



            1. rostedt@goodmis.org
               mailto:rostedt@goodmis.org
    


* * *
# lessecho

## NAME



           lessecho - expand metacharacters
    


## SYNOPSIS



           **lessecho** _[-ox] [-cx] [-pn] [-dn] [-mx] [-nn] [-ex] [-a] file ..._
    


## DESCRIPTION



           **lessecho** is a program that simply echos its arguments on standard
           output.  But any metacharacter in the output is preceded by an
           "escape" character, which by default is a backslash.  **lessecho** is
           invoked internally by **less** , and is not intended to be used
           directly by humans.
    


## OPTIONS



           A summary of options is included below.
    
           **-e** _x_    Specifies "_x_ ", rather than backslash, to be the escape char
                  for metachars.  If _x_ is "-", no escape char is used and
                  arguments containing metachars are surrounded by quotes
                  instead.
    
           **-o** _x_    Specifies "_x_ ", rather than double-quote, to be the open
                  quote character, which is used if the -e- option is
                  specified.
    
           **-c** _x_    Specifies "_x_ " to be the close quote character.
    
           **-p** _n_    Specifies "_n_ " to be the open quote character, as an
                  integer.
    
           **-d** _n_    Specifies "_n_ " to be the close quote character, as an
                  integer.
    
           **-m** _x_    Specifies "_x_ " to be a metachar.  By default, no characters
                  are considered metachars.
    
           **-n** _n_    Specifies "_n_ " to be a metachar, as an integer.
    
           **-f** _n_    Specifies "_n_ " to be the escape char for metachars, as an
                  integer.
    
           **-a** Specifies that all arguments are to be quoted.  The default
                  is that only arguments containing metacharacters are
                  quoted.
    


* * *
# dirname

## NAME



           dirname - strip last component from file name
    


## SYNOPSIS



           **dirname**[_OPTION_] _NAME_...
    


## DESCRIPTION



           Output each NAME with its last non-slash component and trailing
           slashes removed; if NAME contains no /'s, output '.' (meaning the
           current directory).
    
           **-z** , **--zero**
                  end each output line with NUL, not newline
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    


## EXAMPLES



           dirname /usr/bin/
                  -> "/usr"
    
           dirname dir1/str dir2/str
                  -> "dir1" followed by "dir2"
    
           dirname stdio.h
                  -> "."
    


* * *
# perf

## NAME



           perf - Performance analysis tools for Linux
    


## SYNOPSIS



           _perf_ [--version] [--help] [OPTIONS] COMMAND [ARGS]
    


## OPTIONS



           -h, --help
               Run perf help command.
    
           -v, --version
               Display perf version.
    
           -vv
               Print the compiled-in status of libraries.
    
           --exec-path
               Display or set exec path.
    
           --html-path
               Display html documentation path.
    
           -p, --paginate
               Set up pager.
    
           --no-pager
               Do not set pager.
    
           --buildid-dir
               Setup buildid cache directory. It has higher priority than
               buildid.dir config file option.
    
           --list-cmds
               List the most commonly used perf commands.
    
           --list-opts
               List available perf options.
    
           --debugfs-dir
               Set debugfs directory or set environment variable
               PERF_DEBUGFS_DIR.
    
           --debug
               Setup debug variable (see list below) in value range (0, 10).
               Use like: --debug verbose # sets verbose = 1 --debug verbose=2
               # sets verbose = 2
    
                   List of debug variables allowed to set:
                     verbose          - general debug messages
                     ordered-events   - ordered events object debug messages
                     data-convert     - data convert command debug messages
                     stderr           - write debug output (option -v) to stderr
                                        in browser mode
                     perf-event-open  - Print perf_event_open() arguments and
                                        return value
                     kmaps            - Print kernel and module maps (perf script
                                        and perf report without browser)
    
           --debug-file
               Write debug output to a specified file.
    


## DESCRIPTION



           Performance counters for Linux are a new kernel-based subsystem
           that provide a framework for all things performance analysis. It
           covers hardware level (CPU/PMU, Performance Monitoring Unit)
           features and software features (software counters, tracepoints) as
           well.
    


* * *
# dh_icons

## NAME



           dh_icons - Update caches of Freedesktop icons
    


## SYNOPSIS



           **dh_icons**[_debhelper options_] [**-n**]
    


## DESCRIPTION



           **dh_icons** is a debhelper program that updates caches of Freedesktop
           icons when needed, using the **update-icon-caches** program provided
           by GTK+2.12.  Currently this program does not handle installation
           of the files, though it may do so at a later date, so should be
           run after icons are installed in the package build directories.
    
           It takes care of adding maintainer script fragments to call
           **update-icon-caches** for icon directories. (This is not done for
           gnome and hicolor icons, as those are handled by triggers.)  These
           commands are inserted into the maintainer scripts by
           dh_installdeb(1).
    


## OPTIONS



           **-n** , **--no-scripts**
               Do not modify maintainer scripts.
    


* * *
# find-filter

## NAME



           **find-filter** - fine-grained file selection based on time attributes
    


## SYNOPSIS



           **$PCP_BINADM_DIR/find-filter**[**-v?**]  _predicate_
    


## DESCRIPTION



           **find-filter** is a filter for a list of file names read on standard
           input, and if the files match the _predicate_ their names are
           written on standard output.
    
           The supported _predicate_ forms are based on the file's creation
           time or modification time, and take the form **ctime** or **mtime**
           followed by a time specification.  A time specification takes the
           form of a **+** or **-** followed by days (a non-negative integer),
           optionally followed by a colon (**:**) and hours (an integer in the
           range 0 to 23), optionally followed by another colon (**:**) and
           minutes (an integer in the range 0 to 59).
    
           The semantics of the time specification are that a file matches
           the predicate if the chosen time attribute for the file is _less_
           _than_ (**+**) the current time minus the time specification, else _more_
           _than or equal to_ (**-**) the current time minus the time
           specification.  Alternatively, **+** means _before_ the current time
           minus the time specification, and **-** means _at_ or _after_ the current
           time minus the time specification.
    
           **find-filter** is intended to be used to provide finer-grain and
           platform independent selection compared to the **-mtime** or **-ctime**
           options of find(1).  **find-filter** is expected to be used as a post-
           filter for the output from find(1), and this is how it is used in
           the pmlogger_daily(1) scripts to select files to be compressed or
           culled.
    


## EXAMPLES



           The following _predicate_ examples illustrate some typical uses.
    
           **mtime +3** Matches files modified more than 3 days ago.
    
           **ctime -0:2** Matches files created in the last 2 hours.
    
           **ctime +0:0:15**
                       Matches files created more than 15 minutes ago.
    


## DIAGNOSTICS



           There are none, unless the **-v** option is used, in which case some
           diagnostics are written to standard error.
    
           Exit status is always zero, unless there are errors found when
           parsing the command line arguments.
    


* * *
# pmdanutcracker

## NAME



           **pmdanutcracker** - NutCracker performance metrics domain agent
           (PMDA)
    


## DESCRIPTION



           This PMDA extracts performance data from NutCracker (or
           TwemProxy), a fast and lightweight proxy for memcached and Redis
           protocol.
    


## INSTALLATION



           Configure to export statistics via its stats interface (see
           --stats-port option to the **nutcracker** server).  The corresponding
           configuration must be reflected in the
           $PCP_PMDAS_DIR/nutcracker/nutcracker.conf file.
    
               **# cd $PCP_PMDAS_DIR/nutcracker**
               **# [ edit nutcracker.conf ]**
    
           Once this is setup, you can access the names and values for the
           nutcracker performance metrics by doing the following as root:
    
               **# cd $PCP_PMDAS_DIR/nutcracker**
               **# ./Install**
    
           To uninstall, the following must be done as root:
    
               **# cd $PCP_PMDAS_DIR/nutcracker**
               **# ./Remove**
    
           **pmdanutcracker** is launched by pmcd(1) and should never be executed
           directly. The Install and Remove scripts notify pmcd(1) when the
           agent is installed or removed.
    


## FILES



           **$PCP_PMDAS_DIR/nutcracker/nutcracker.conf**
               mandatory configuration file listing monitored memcache or
               Redis instances
    
           **$PCP_PMDAS_DIR/nutcracker/Install**
               installation script for the **pmdanutcracker** agent
    
           **$PCP_PMDAS_DIR/nutcracker/Remove**
               undo installation script for the **pmdanutcracker** agent
    
           **$PCP_LOG_DIR/pmcd/nutcracker.log**
               default log file for error messages from **pmdanutcracker**
    


## PCP ENVIRONMENT



           Environment variables with the prefix **PCP_** are used to
           parameterize the file and directory names used by **PCP**. On each
           installation, the file **/etc/pcp.conf** contains the local values for
           these variables.  The **$PCP_CONF** variable may be used to specify an
           alternative configuration file, as described in pcp.conf(5).
    


* * *
# valgrind-di-server

## NAME



           valgrind-di-server - Experimental debuginfo server for valgrind
    


## SYNOPSIS



    
           **valgrind-di-server**[_options_]
    


## DESCRIPTION



           **valgrind-di-server** accepts (multiple) connections from **valgrind**
           processes that use the
            **--debuginfo-server** option on the specified port and serves
           (compressed) debuginfo files (in chunks) from the current working
           directory.
    


## OPTIONS



           **-e --exit-at-zero**
               When the number of connected processes falls back to zero,
               exit. Without this, it will run forever, that is, until you
               send it Control-C.
    
           **--max-connect=INTEGER**
               By default, the server can connect to up to 50 processes.
               Occasionally, that number is too small. Use this option to
               provide a different limit. E.g.  --max-connect=100.
    
           **portnumber**
               Changes the port it listens on from the default (1500). The
               specified port must be in the range 1024 to 65535. The same
               restriction applies to port numbers specified by the
               **--debuginfo-server** option to Valgrind itself.
    


* * *
# basenc

## NAME



           basenc - Encode/decode data and print to standard output
    


## SYNOPSIS



           **basenc**[_OPTION_]... [_FILE_]
    


## DESCRIPTION



           basenc encode or decode FILE, or standard input, to standard
           output.
    
           With no FILE, or when FILE is -, read standard input.
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
           **--base64**
                  same as 'base64' program (RFC4648 section 4)
    
           **--base64url**
                  file- and url-safe base64 (RFC4648 section 5)
    
           **--base32**
                  same as 'base32' program (RFC4648 section 6)
    
           **--base32hex**
                  extended hex alphabet base32 (RFC4648 section 7)
    
           **--base16**
                  hex encoding (RFC4648 section 8)
    
           **--base2msbf**
                  bit string with most significant bit (msb) first
    
           **--base2lsbf**
                  bit string with least significant bit (lsb) first
    
           **-d** , **--decode**
                  decode data
    
           **-i** , **--ignore-garbage**
                  when decoding, ignore non-alphabet characters
    
           **-w** , **--wrap** =_COLS_
                  wrap encoded lines after COLS character (default 76).  Use
                  0 to disable line wrapping
    
           **--z85** ascii85-like encoding (ZeroMQ spec:32/Z85); when encoding,
                  input length must be a multiple of 4; when decoding, input
                  length must be a multiple of 5
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    
           When decoding, the input may contain newlines in addition to the
           bytes of the formal alphabet.  Use **--ignore-garbage** to attempt to
           recover from any other non-alphabet bytes in the encoded stream.
    


## ENCODING EXAMPLES



                  $ printf '\376\117\202' | basenc --base64
                  /k+C
    
                  $ printf '\376\117\202' | basenc --base64url
                  _k-C
    
                  $ printf '\376\117\202' | basenc --base32
                  7ZHYE===
    
                  $ printf '\376\117\202' | basenc --base32hex
                  VP7O4===
    
                  $ printf '\376\117\202' | basenc --base16
                  FE4F82
    
                  $ printf '\376\117\202' | basenc --base2lsbf
                  011111111111001001000001
    
                  $ printf '\376\117\202' | basenc --base2msbf
                  111111100100111110000010
    
                  $ printf '\376\117\202\000' | basenc --z85
                  @.FaC
    


* * *
# pmdauwsgi

## NAME



           **pmdauwsgi** - uwsgi performance metrics domain agent (PMDA)
    


## DESCRIPTION



           **pmdauwsgi** is a Performance Metrics Domain Agent (PMDA) which
           exports performance metrics from uwsgi.  uWSGI is often used in
           conjunction with web servers such Nginx, which offer direct
           support for uWSGI's native uwsgi protocol, to serve Python web
           applications such as Django.
    
           **pmdauwsgi** reads an optional ini-style configuration file:
    
                  $PCP_SYSCONF_DIR _/uwsgi/uwsgi.conf_
    
           This file has a [pmda] section
    
           **[pmda]**
    
           **host =**(_127.0.0.1_)
                  Connect uwsgi stats server on the given hostname.
    
           **port =**(_9051_)
                  Connect to the uwsgi stats server on the given port.
    


## INSTALLATION



           This PMDA requires that uwsgi is running on the local host with a
           uwsgi stats server running on TCP port 9051 (by default) and
           stats-http enabled.
    
           Install the uwsgi PMDA by using the Install script as root:
    
                 # cd $PCP_PMDAS_DIR/uwsgi
                 # ./Install
    
           To uninstall, do the following as root:
    
                 # cd $PCP_PMDAS_DIR/uwsgi
                 # ./Remove
    
           **pmdauwsgi** is launched by pmcd(1) and should never be executed
           directly. The Install and Remove scripts notify pmcd(1) when the
           agent is installed or removed.
    


## FILES



           **$PCP_PMDAS_DIR/uwsgi/Install**
               installation script for the **pmdauwsgi** agent
    
           **$PCP_PMDAS_DIR/uwsgi/Remove**
               undo installation script for the **pmdauwsgi** agent
    
           **$PCP_LOG_DIR/pmcd/uwsgi.log**
               default log file for error messages from **pmdauwsgi**
    
           **$PCP_SYSCONF_DIR/uwsgi/uwsgi.conf**
               optional configuration file for **pmdauwsgi** agent
    


## PCP ENVIRONMENT



           Environment variables with the prefix **PCP_** are used to
           parameterize the file and directory names used by **PCP**. On each
           installation, the file **/etc/pcp.conf** contains the local values for
           these variables.  The **$PCP_CONF** variable may be used to specify an
           alternative configuration file, as described in pcp.conf(5).
    


* * *
# dh_lintian

## NAME



           dh_lintian - install lintian override files into package build
           directories
    


## SYNOPSIS



           **dh_lintian**[_debhelper options_]
    


## DESCRIPTION



           **dh_lintian** is a debhelper program that is responsible for
           installing override files used by lintian into package build
           directories.
    


## FILES



           debian/_package_.lintian-overrides
               Installed into usr/share/lintian/overrides/_package_ in the
               package build directory. This file is used to suppress
               erroneous lintian diagnostics.
    
           _debian/source/lintian-overrides_
               These files are not installed, but will be scanned by lintian
               to provide overrides for the source package.
    


* * *
# dh_installsysusers

## NAME



           dh_installsysusers - install and integrates systemd sysusers files
    


## SYNOPSIS



           **dh_installsysusers**[_debhelper options_]
    


## DESCRIPTION



           **dh_installsysusers** is a debhelper program that is responsible for
           installing package maintainer supplied systemd sysusers files.
    
           It also finds the systemd sysusers files installed in a package
           and generates relevant integration snippets for enabling the users
           on installation.  These snippets are added to the package by
           dh_installdeb(1).
    


## FILES



           debian/_package_.sysusers
               If the file exist, it will be installed as
               _/usr/lib/sysusers.d/package.conf_.
    


## OPTIONS



           **--name=**_name_
               When this parameter is used, **dh_installsysusers** looks for and
               installs files named debian/_package_._name_.sysusers instead of
               the usual debian/_package_.sysusers.
    
               Furthermore, the file is installed as
               _/usr/lib/sysusers.d/name.conf_ rather than
               _/usr/lib/sysusers.d/package.conf_.
    


## NOTES



           This command is not idempotent. dh_prep(1) should be called
           between invocations of this command (with the same arguments).
           Otherwise, it may cause multiple instances of the same text to be
           added to maintainer scripts.
    


* * *
# pic2graph

## Name



           pic2graph - convert a _pic_ diagram into a cropped image
    


## Synopsis



           **pic2graph**[**-unsafe**] [**-format** _output-format_] [**-eqn** _delimiters_]
                     [_convert-argument_ ...]
    
           **pic2graph --help**
    
           **pic2graph -v**
    
           **pic2graph --version**
    


## Description



           _pic2graph_ reads a _pic_(1) program from the standard input and
           writes an image file, by default in Portable Network Graphics
           (PNG) format, to the standard output.  It furthermore translates
           _eqn_(1) constructs, so it can be used to generate images of
           mathematical formulae.
    
           The input PIC code should _not_ be wrapped with the **.PS** and
           **.PE** /**.PF** /**.PY** macros that normally guard it within _groff_(1)
           documents.
    
           Arguments not recognized by _pic2graph_ are passed to the
           ImageMagick or GraphicsMagick program _convert_(1).  By specifying
           these, you can give your image a border, set the image's pixel
           density, or perform other useful transformations.
    
           The output image is clipped using _convert_ 's **-trim** option to the
           smallest possible bounding box that contains all the black pixels.
    


## Options



           **--help** displays a usage message, while **-v** and **--version** show
           version information; all exit afterward.
    
           **-eqn** _delimiters_
                  Use _delimiters_ as the opening and closing characters that
                  delimit _eqn_ directives; the default is “$$”.  The option
                  argument _delimiters_ should be a two-character string, but
                  an empty string ("") is accepted as a directive to disable
                  _eqn_ processing.
    
           **-format** _output-format_
                  Write the image in _output-format_ , which must be understood
                  by _convert_ ; the default is PNG.
    
           **-unsafe**
                  Run _groff_ in _unsafe_ mode, enabling the PIC command **sh** to
                  execute arbitrary Unix shell commands.  The _groff_ default
                  is to forbid this.
    


## Environment



           _GROFF_TMPDIR_
           _TMPDIR_
           _TMP_
           _TEMP_   These environment variables are searched in the order shown
                  to determine the directory where temporary files will be
                  created.  If none are set, _/tmp_ is used.
    


## Authors



           _pic2graph_ was written by Eric S. Raymond ⟨esr@thyrsus.com⟩, based
           on a recipe by W. Richard Stevens.
    


## See also



           W. Richard Stevens, _Turning PIC into HTML_ 
           ⟨http://www.kohala.com/start/troff/pic2html.html⟩
    
           _eqn2graph_(1), _grap2graph_(1), _pic_(1), _eqn_(1), _groff_(1), _convert_(1)
    


* * *
# rstream

## NAME



           rstream - streaming over RDMA ping-pong test.
    


## SYNOPSIS



           _rstream_ [-s server_address] [-b bind_address] [-f address_format]
                          [-B buffer_size] [-I iterations] [-C transfer_count]
                          [-S transfer_size] [-p server_port] [-T test_option]
    


## DESCRIPTION



           Uses the streaming over RDMA protocol (rsocket) to connect and
           exchange data between a client and server application.
    


## OPTIONS



           -s server_address
                  The network name or IP address of the server system
                  listening for connections.  The used name or address must
                  route over an RDMA device.  This option must be specified
                  by the client.
    
           -b bind_address
                  The local network address to bind to.
    
           -f address_format
                  Supported address formats are ip, ipv6, gid, or name.
    
           -B buffer_size
                  Indicates the size of the send and receive network buffers.
    
           -I iterations
                  The number of times that the specified number of messages
                  will be exchanged between the client and server.  (default
                  1000)
    
           -C transfer_count
                  The number of messages to transfer from the client to the
                  server and back again on each iteration.  (default 1000)
    
           -S transfer_size
                  The size of each send transfer, in bytes.  (default 1000)
                  If 'all' is specified, rstream will run a series of tests
                  of various sizes.
    
           -p server_port
                  The server's port number.
    
           -T test_option
                  Specifies test parameters.  Available options are:
    
           s | socket  - uses standard socket calls to transfer data
    
           a | async - uses asynchronous operation (e.g. select / poll)
    
           b | blocking - uses blocking calls
    
           f | fork - fork server processing (forces -T s option)
    
           n | nonblocking - uses non-blocking calls
    
           r | resolve - use rdma cm to resolve address
    
           v | verify - verifies data transfers
    


## NOTES



           Basic usage is to start rstream on a server system, then run
           rstream -s server_name on a client system.  By default, rstream
           will run a series of latency and bandwidth performance tests.
           Specifying a different iterations, transfer_count, or
           transfer_size will run a user customized test using default values
           where none have been specified.
    
           Because this test maps RDMA resources to userspace, users must
           ensure that they have available system resources and permissions.
           See the libibverbs README file for additional details.
    


* * *
# galera_recovery

## NAME



           galera_recovery - recover from non-graceful shutdown
    


## DESCRIPTION



           Use: Recover from non-graceful shutdown.
    
           For more information, please refer to the MariaDB Knowledge Base,
           available online at https://mariadb.com/kb/
    


* * *
# fold

## NAME



           fold - wrap each input line to fit in specified width
    


## SYNOPSIS



           **fold**[_OPTION_]... [_FILE_]...
    


## DESCRIPTION



           Wrap input lines in each FILE, writing to standard output.
    
           With no FILE, or when FILE is -, read standard input.
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
           **-b** , **--bytes**
                  count bytes rather than columns
    
           **-s** , **--spaces**
                  break at spaces
    
           **-w** , **--width** =_WIDTH_
                  use WIDTH columns instead of 80
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    


* * *
# stg-patches

## NAME



           stg-patches - Show patches that modify files
    


## SYNOPSIS



           _stg patches_ [OPTIONS] [path]...
    


## DESCRIPTION



           Show the applied patches modifying the given paths. Without path
           arguments, the files modified in the working tree are used as the
           paths.
    


## OPTIONS



           -b <branch>, --branch=<branch>
               Use <branch> instead of current branch
    
           -d, --diff
               Show the diff for the given paths
    
           -O <option>, --diff-opt=<option>
               Pass additional <option> to **git diff**.
    
               See the git-diff(1) man page. This option may be specified
               multiple times.
    


## STGIT



           Part of the StGit suite - see stg(1)
    


* * *
# pmdaunbound

## NAME



           **pmdaunbound** - Unbound resolver PMDA
    


## DESCRIPTION



           **pmdaunbound** is a Performance Metrics Domain Agent (PMDA) which
           exports metric values about the Unbound DNS resolver using the
           **unbound-control**(8) **stats_noreset** command.
    
           This gives lots of insight into query types, response time, cache
           hits/misses, etc. Please see the **unbound-control**(8) man page for
           explanation about each statistics counter.
    
           Further details on the Unbound DNS resolver can be found at
           **https://unbound.net/ **.
    


## INSTALLATION



           Install the Unbound PMDA by using the Install script as root:
    
               **# cd $PCP_PMDAS_DIR/unbound**
               **# ./Install**
    
           To uninstall, do the following as root:
    
               **# cd $PCP_PMDAS_DIR/unbound**
               **# ./Remove**
    
           **pmdaunbound** is launched by pmcd(1) and should never be executed
           directly. The Install and Remove scripts notify pmcd(1) when the
           agent is installed or removed.
    


## FILES



           **$PCP_PMDAS_DIR/unbound/Install**
               installation script for the **pmdaunbound** agent
    
           **$PCP_PMDAS_DIR/unbound/Remove**
               undo installation script for the **pmdaunbound** agent
    
           **$PCP_LOG_DIR/pmcd/unbound.log**
               default log file for error messages from **pmdaunbound**
    


## PCP ENVIRONMENT



           Environment variables with the prefix **PCP_** are used to
           parameterize the file and directory names used by **PCP**. On each
           installation, the file **/etc/pcp.conf** contains the local values for
           these variables.  The **$PCP_CONF** variable may be used to specify an
           alternative configuration file, as described in pcp.conf(5).
    


* * *
# mariadb-backup

## NAME



           mariabackup - Backup tool
    


## DESCRIPTION



           Use **mariabackup --help** for details on usage.
    
           For more information, please refer to the MariaDB Knowledge Base,
           available online at https://mariadb.com/kb/
    


* * *
# chgrp

## NAME



           chgrp - change group ownership
    


## SYNOPSIS



           **chgrp**[_OPTION_]... _GROUP FILE_...
           **chgrp**[_OPTION_]... _--reference=RFILE FILE_...
    


## DESCRIPTION



           Change the group of each FILE to GROUP.  With **--reference** , change
           the group of each FILE to that of RFILE.
    
           **-c** , **--changes**
                  like verbose but report only when a change is made
    
           **-f** , **--silent** , **--quiet**
                  suppress most error messages
    
           **-v** , **--verbose**
                  output a diagnostic for every file processed
    
           **--dereference**
                  affect the referent of each symbolic link (this is the
                  default), rather than the symbolic link itself
    
           **-h** , **--no-dereference**
                  affect symbolic links instead of any referenced file
                  (useful only on systems that can change the ownership of a
                  symlink)
    
           **--from** =_CURRENT_OWNER_ :CURRENT_GROUP
                  change the ownership of each file only if its current owner
                  and/or group match those specified here. Either may be
                  omitted, in which case a match is not required for the
                  omitted attribute
    
           **--no-preserve-root**
                  do not treat '/' specially (the default)
    
           **--preserve-root**
                  fail to operate recursively on '/'
    
           **--reference** =_RFILE_
                  use RFILE's ownership rather than specifying values.  RFILE
                  is always dereferenced if a symbolic link.
    
           **-R** , **--recursive**
                  operate on files and directories recursively
    
           The following options modify how a hierarchy is traversed when the
           **-R** option is also specified.  If more than one is specified, only
           the final one takes effect. **-P** is the default.
    
           **-H** if a command line argument is a symbolic link to a
                  directory, traverse it
    
           **-L** traverse every symbolic link to a directory encountered
    
           **-P** do not traverse any symbolic links
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    


## EXAMPLES



           chgrp staff /u
                  Change the group of /u to "staff".
    
           chgrp -hR staff /u
                  Change the group of /u and subfiles to "staff".
    


* * *
# pidof

## NAME



           pidof - find the process ID of a running program
    


## SYNOPSIS



           **pidof**[**-s**] [**-c**] [**-q**] [**-w**] [**-x**] [**-o** _omitpid_[,...]] ... [**-t**] [**-S**
           _separator_] _program_ ...
    


## DESCRIPTION



           **Pidof** finds the process id's (pids) of the named programs. It
           prints those id's on the standard output.
    


## OPTIONS



           **-s** Single shot - this instructs the program to only return one
                  _pid_.
    
           **-c** Only return process ids that are running with the same root
                  directory.  This option is ignored for non-root users, as
                  they will be unable to check the current root directory of
                  processes they do not own.
    
           **-q** Quiet mode, suppress any output and only sets the exit
                  status accordingly.
    
           **-w** Show also processes that do not have visible command line
                  (e.g. kernel worker threads).
    
           **-x** Scripts too - this causes the program to also return
                  process id's of shells running the named scripts.
    
           **-o** _omitpid_
                  Tells **pidof** to omit processes with that process id. The
                  special pid **%PPID** can be used to name the parent process of
                  the **pidof** program, in other words the calling shell or
                  shell script.
    
           **-t** Shows all thread ids instead of pids.
    
           **-S** _separator_
                  Use _separator_ as a separator put between pids. Used only
                  when more than one pids are printed for the program.  The
                  **-d** option is an alias for this option for sysvinit **pidof**
                  compatibility.
    


## EXIT STATUS



           **0** At least one program was found with the requested name.
    
           **1** No program was found with the requested name.
    


## BUGS



           When using the **-x** option, **pidof** only has a simple method for
           detecting scripts and will miss scripts that, for example, use
           env. This limitation is due to how the scripts look in the proc
           filesystem.
    


* * *
# head

## NAME



           head - output the first part of files
    


## SYNOPSIS



           **head**[_OPTION_]... [_FILE_]...
    


## DESCRIPTION



           Print the first 10 lines of each FILE to standard output.  With
           more than one FILE, precede each with a header giving the file
           name.
    
           With no FILE, or when FILE is -, read standard input.
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
           **-c** , **--bytes** =_[-]NUM_
                  print the first NUM bytes of each file; with the leading
                  '-', print all but the last NUM bytes of each file
    
           **-n** , **--lines** =_[-]NUM_
                  print the first NUM lines instead of the first 10; with the
                  leading '-', print all but the last NUM lines of each file
    
           **-q** , **--quiet** , **--silent**
                  never print headers giving file names
    
           **-v** , **--verbose**
                  always print headers giving file names
    
           **-z** , **--zero-terminated**
                  line delimiter is NUL, not newline
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    
           NUM may have a multiplier suffix: b 512, kB 1000, K 1024, MB
           1000*1000, M 1024*1024, GB 1000*1000*1000, G 1024*1024*1024, and
           so on for T, P, E, Z, Y, R, Q.  Binary prefixes can be used, too:
           KiB=K, MiB=M, and so on.
    


* * *
# sha384sum

## NAME



           sha384sum - compute and check SHA384 message digest
    


## SYNOPSIS



           **sha384sum**[_OPTION_]... [_FILE_]...
    


## DESCRIPTION



           Print or check SHA384 (384-bit) checksums.
    
           With no FILE, or when FILE is -, read standard input.
    
           **-b** , **--binary**
                  read in binary mode
    
           **-c** , **--check**
                  read checksums from the FILEs and check them
    
           **--tag** create a BSD-style checksum
    
           **-t** , **--text**
                  read in text mode (default)
    
           **-z** , **--zero**
                  end each output line with NUL, not newline, and disable
                  file name escaping
    
       **The following five options are useful only when verifying checksums:**
           **--ignore-missing**
                  don't fail or report status for missing files
    
           **--quiet**
                  don't print OK for each successfully verified file
    
           **--status**
                  don't output anything, status code shows success
    
           **--strict**
                  exit non-zero for improperly formatted checksum lines
    
           **-w** , **--warn**
                  warn about improperly formatted checksum lines
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    
           The sums are computed as described in FIPS-180-2.  When checking,
           the input should be a former output of this program.  The default
           mode is to print a line with: checksum, a space, a character
           indicating input mode ('*' for binary, ' ' for text or where
           binary is insignificant), and name for each FILE.
    
           There is no difference between binary mode and text mode on GNU
           systems.
    


* * *