tripathysagar/man_text huggingface dataset:
# printf

## NAME



           printf - format and print data
    


## SYNOPSIS



           **printf** _FORMAT_ [_ARGUMENT_]...
           **printf** _OPTION_
    


## DESCRIPTION



           Print ARGUMENT(s) according to FORMAT, or execute according to
           OPTION:
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    
           FORMAT controls the output as in C printf.  Interpreted sequences
           are:
    
           \"     double quote
    
           \\     backslash
    
           \a     alert (BEL)
    
           \b     backspace
    
           \c     produce no further output
    
           \e     escape
    
           \f     form feed
    
           \n     new line
    
           \r     carriage return
    
           \t     horizontal tab
    
           \v     vertical tab
    
           \NNN   byte with octal value NNN (1 to 3 digits)
    
           \xHH   byte with hexadecimal value HH (1 to 2 digits)
    
           \uHHHH Unicode (ISO/IEC 10646) character with hex value HHHH (4
                  digits)
    
           \UHHHHHHHH
                  Unicode character with hex value HHHHHHHH (8 digits)
    
           %%     a single %
    
           %b     ARGUMENT as a string with '\' escapes interpreted, except
                  that octal escapes should have a leading 0 like \0NNN
    
           %q     ARGUMENT is printed in a format that can be reused as shell
                  input, escaping non-printable characters with the POSIX $''
                  syntax
    
           and all C format specifications ending with one of diouxXfeEgGcs,
           with ARGUMENTs converted to proper type first.  Variable widths
           are handled.
    
           Your shell may have its own version of printf, which usually
           supersedes the version described here.  Please refer to your
           shell's documentation for details about the options it supports.
    


* * *
# factor

## NAME



           factor - factor numbers
    


## SYNOPSIS



           **factor**[_OPTION_] [_NUMBER_]...
    


## DESCRIPTION



           Print the prime factors of each specified integer NUMBER.  If none
           are specified on the command line, read them from standard input.
    
           **-h** , **--exponents**
                  print repeated factors in form p^e unless e is 1
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    


* * *
# dh_systemd_start

## NAME



           dh_systemd_start - start/stop/restart systemd unit files
    


## SYNOPSIS



           **dh_systemd_start**[_debhelper options_] [**--restart-after-upgrade**]
           [**--no-stop-on-upgrade**] [_unit file_ ...]
    


## DESCRIPTION



           **dh_systemd_start** is a debhelper program that is responsible for
           starting/stopping or restarting systemd unit files in case no
           corresponding sysv init script is available.
    
           As with **dh_installinit** , the unit file is stopped before upgrades
           and started afterwards (unless **--restart-after-upgrade** is
           specified, in which case it will only be restarted after the
           upgrade).  This logic is not used when there is a corresponding
           SysV init script because invoke-rc.d performs the
           stop/start/restart in that case.
    


## OPTIONS



           **--restart-after-upgrade**
               Do not stop the unit file until after the package upgrade has
               been completed.  This is the default behaviour in compat 10.
    
               In earlier compat levels the default was to stop the unit file
               in the _prerm_ , and start it again in the _postinst_.
    
               This can be useful for daemons that should not have a possibly
               long downtime during upgrade. But you should make sure that
               the daemon will not get confused by the package being upgraded
               while it's running before using this option.
    
           **--no-restart-after-upgrade**
               Undo a previous **--restart-after-upgrade**(or the default of
               compat 10).  If no other options are given, this will cause
               the service to be stopped in the _prerm_ script and started
               again in the _postinst_ script.
    
           **-r** , **--no-stop-on-upgrade** , **--no-restart-on-upgrade**
               Do not stop service on upgrade.
    
           **--no-start**
               Do not start the unit file after upgrades and after initial
               installation (the latter is only relevant for services without
               a corresponding init script).
    


## NOTES



           Note that 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.
    
           Note that **dh_systemd_start** should be run after **dh_installinit** so
           that it can detect corresponding SysV init scripts. The default
           sequence in **dh** does the right thing, this note is only relevant
           when you are calling **dh_systemd_start** manually.
    


* * *
# newgrp

## NAME



           newgrp - log in to a new group
    


## SYNOPSIS



    
           **newgrp**[-] [_group_]
    


## DESCRIPTION



           The **newgrp** command is used to change the current group ID during a
           login session. If the optional **-** flag is given, the user's
           environment will be reinitialized as though the user had logged
           in, otherwise the current environment, including current working
           directory, remains unchanged.
    
           **newgrp** changes the current real group ID to the named group, or to
           the default group listed in /etc/passwd if no group name is given.
           **newgrp** also tries to add the group to the user groupset. If not
           root, the user will be prompted for a password if she does not
           have a password (in /etc/shadow if this user has an entry in the
           shadowed password file, or in /etc/passwd otherwise) and the group
           does, or if the user is not listed as a member and the group has a
           password. The user will be denied access if the group password is
           empty and the user is not listed as a member.
    
           If there is an entry for this group in /etc/gshadow, then the list
           of members and the password of this group will be taken from this
           file, otherwise, the entry in /etc/group is considered.
    


## CONFIGURATION



           The following configuration variables in /etc/login.defs change
           the behavior of this tool:
    
           **SYSLOG_SG_ENAB**(boolean)
               Enable "syslog" logging of **sg** activity.
    


## FILES



           /etc/passwd
               User account information.
    
           /etc/shadow
               Secure user account information.
    
           /etc/group
               Group account information.
    
           /etc/gshadow
               Secure group account information.
    


* * *
# ranlib

## NAME



           ranlib - generate an index to an archive
    


## SYNOPSIS



           ranlib [**--plugin** _name_] [**-DhHvVt**] _archive_
    


## DESCRIPTION



           **ranlib** generates an index to the contents of an archive and stores
           it in the archive.  The index lists each symbol defined by a
           member of an archive that is a relocatable object file.
    
           You may use **nm -s** or **nm --print-armap** to list this index.
    
           An archive with such an index speeds up linking to the library and
           allows routines in the library to call each other without regard
           to their placement in the archive.
    
           The GNU **ranlib** program is another form of GNU **ar** ; running **ranlib**
           is completely equivalent to executing **ar -s**.
    


## OPTIONS



           **-h**
           **-H**
           **--help**
               Show usage information for **ranlib**.
    
           **-v**
           **-V**
           **--version**
               Show the version number of **ranlib**.
    
           **-D** Operate in _deterministic_ mode.  The symbol map archive
               member's header will show zero for the UID, GID, and
               timestamp.  When this option is used, multiple runs will
               produce identical output files.
    
               If _binutils_ was configured with
               **--enable-deterministic-archives** , then this mode is on by
               default.  It can be disabled with the **-U** option, described
               below.
    
           **-t** Update the timestamp of the symbol map of an archive.
    
           **-U** Do _not_ operate in _deterministic_ mode.  This is the inverse of
               the **-D** option, above: the archive index will get actual UID,
               GID, timestamp, and file mode values.
    
               If _binutils_ was configured _without_
               **--enable-deterministic-archives** , then this mode is on by
               default.
    
           **@**_file_
               Read command-line options from _file_.  The options read are
               inserted in place of the original @_file_ option.  If _file_ does
               not exist, or cannot be read, then the option will be treated
               literally, and not removed.
    
               Options in _file_ are separated by whitespace.  A whitespace
               character may be included in an option by surrounding the
               entire option in either single or double quotes.  Any
               character (including a backslash) may be included by prefixing
               the character to be included with a backslash.  The _file_ may
               itself contain additional @_file_ options; any such options will
               be processed recursively.
    


* * *
# stap-report

## NAME



           stap-report - collect system information that is useful for
           debugging systemtap bugs
    


## SYNOPSIS



           **stap-report**
    


## DESCRIPTION



           The stap-report executable collects system information that is
           useful for debugging systemtap bugs. It is a good idea to include
           such a report in bug reports especially if you send them directly
           to the upstream. stap-report can be run either as a normal user or
           as root. The report will be more complete if stap-report is run as
           root.
    


## EXAMPLES



                  $ stap-report > report.txt
                  $ head report.txt
                  == id ==
                  uid=1000(user) gid=1000(user) groups=122(stapdev),123(stapusr),129(stapsys)
                  == stap -V ==
                  Systemtap translator/driver (version 2.2.1/0.153, Debian version 2.2.1-1)
                  Copyright (C) 2005-2013 Red Hat, Inc. and others
                  This is free software; see the source for copying conditions.
                  enabled features: AVAHI LIBSQLITE3 NSS TR1_UNORDERED_MAP NLS
                  == which stap ==
                  /usr/bin/stap
                  == locate --regex '/stap(run)?$' | xargs ls -ald ==
    


## BUGS



           Use the Bugzilla link of the project web page or our mailing list.
           **http://sourceware.org/systemtap/ **,**< systemtap@sourceware.org>**.
    


* * *
# pmsleep

## NAME



           **pmpause** , **pmsleep** - portable subsecond-capable sleep
    


## SYNOPSIS



           **$PCP_BINADM_DIR/pmpause**[**-w** _where_]
           **$PCP_BINADM_DIR/pmsleep**[**-w** _where_] _interval_
    


## DESCRIPTION



           **pmpause** sleeps indefinitely, until interrupted by SIGKILL.
    
           **pmsleep** sleeps for the specified _interval_.  The _interval_ argument
           follows the syntax described in PCPIntro(1) for **-t,** and in the
           simplest form may be an unsigned integer or floating point
           constant (the implied units in this case are seconds).
    
           The **-w** option is provided to allow annotation of scripts with
           multiple uses of **pmpause** and/or **pmsleep** to identify a particular
           use in the process's arguments, e.g. as visible to ps(1).
    


## DIAGNOSTICS



           The exit status is 0 for success, or 1 for a malformed command
           line.  If the underlying nanosleep(2) system call fails, an errno
           is returned.
    


* * *
# truncate

## NAME



           truncate - shrink or extend the size of a file to the specified
           size
    


## SYNOPSIS



           **truncate** _OPTION_... _FILE_...
    


## DESCRIPTION



           Shrink or extend the size of each FILE to the specified size
    
           A FILE argument that does not exist is created.
    
           If a FILE is larger than the specified size, the extra data is
           lost.  If a FILE is shorter, it is extended and the sparse
           extended part (hole) reads as zero bytes.
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
           **-c** , **--no-create**
                  do not create any files
    
           **-o** , **--io-blocks**
                  treat SIZE as number of IO blocks instead of bytes
    
           **-r** , **--reference** =_RFILE_
                  base size on RFILE
    
           **-s** , **--size** =_SIZE_
                  set or adjust the file size by SIZE bytes
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    
           The SIZE argument is an integer and optional unit (example: 10K is
           10*1024).  Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or
           KB,MB,... (powers of 1000).  Binary prefixes can be used, too:
           KiB=K, MiB=M, and so on.
    
           SIZE may also be prefixed by one of the following modifying
           characters: '+' extend by, '-' reduce by, '<' at most, '>' at
           least, '/' round down to multiple of, '%' round up to multiple of.
    


* * *
# pwd

## NAME



           pwd - print name of current/working directory
    


## SYNOPSIS



           **pwd**[_OPTION_]...
    


## DESCRIPTION



           Print the full filename of the current working directory.
    
           **-L** , **--logical**
                  use PWD from environment, even if it contains symlinks
    
           **-P** , **--physical**
                  resolve all symlinks
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    
           If no option is specified, **-P** is assumed.
    
           Your shell may have its own version of pwd, which usually
           supersedes the version described here.  Please refer to your
           shell's documentation for details about the options it supports.
    


* * *
# git-check-mailmap

## NAME



           git-check-mailmap - Show canonical names and email addresses of
           contacts
    


## SYNOPSIS



           _git check-mailmap_ [<options>] <contact>...
    


## DESCRIPTION



           For each “Name <user@host>”, “<user@host>”, or “user@host” from
           the command-line or standard input (when using **--stdin**), look up
           the person’s canonical name and email address (see "Mapping
           Authors" below). If found, print them; otherwise print the input
           as-is.
    


## OPTIONS



           --stdin
               Read contacts, one per line, from the standard input after
               exhausting contacts provided on the command-line.
    
           --mailmap-file=<file>
               In addition to any configured mailmap files, read the
               specified mailmap file. Entries in this file take precedence
               over entries in either the default mailmap file or any
               configured mailmap file.
    
           --mailmap-blob=<blob>
               Like **--mailmap-file** , but consider the value as a reference to
               a blob in the repository. If both **--mailmap-file** and
               **--mailmap-blob** are specified, entries in **--mailmap-file** will
               take precedence.
    


## OUTPUT



           For each contact, a single line is output, terminated by a
           newline. If the name is provided or known to the _mailmap_ , “Name
           <user@host>” is printed; otherwise only “<user@host>” is printed.
    


## CONFIGURATION



           See **mailmap.file** and **mailmap.blob** in git-config(1) for how to
           specify a custom **.mailmap** target file or object.
    


## GIT



           Part of the git(1) suite
    


* * *
# mkdir

## NAME



           mkdir - make directories
    


## SYNOPSIS



           **mkdir**[_OPTION_]... _DIRECTORY_...
    


## DESCRIPTION



           Create the DIRECTORY(ies), if they do not already exist.
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
           **-m** , **--mode** =_MODE_
                  set file mode (as in chmod), not a=rwx - umask
    
           **-p** , **--parents**
                  no error if existing, make parent directories as needed,
                  with their file modes unaffected by any **-m** option
    
           **-v** , **--verbose**
                  print a message for each created directory
    
           **-Z** set SELinux security context of each created directory to
                  the default type
    
           **--context**[=_CTX_]
                  like **-Z** , or if CTX is specified then set the SELinux or
                  SMACK security context to CTX
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    


* * *
# unlink

## NAME



           unlink - call the unlink function to remove the specified file
    


## SYNOPSIS



           **unlink** _FILE_
           **unlink** _OPTION_
    


## DESCRIPTION



           Call the unlink function to remove the specified FILE.
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    


* * *
# echo

## NAME



           echo - display a line of text
    


## SYNOPSIS



           **echo**[_SHORT-OPTION_]... [_STRING_]...
           **echo** _LONG-OPTION_
    


## DESCRIPTION



           Echo the STRING(s) to standard output.
    
           **-n** do not output the trailing newline
    
           **-e** enable interpretation of backslash escapes
    
           **-E** disable interpretation of backslash escapes (default)
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    
           If **-e** is in effect, the following sequences are recognized:
    
           \\     backslash
    
           \a     alert (BEL)
    
           \b     backspace
    
           \c     produce no further output
    
           \e     escape
    
           \f     form feed
    
           \n     new line
    
           \r     carriage return
    
           \t     horizontal tab
    
           \v     vertical tab
    
           \0NNN  byte with octal value NNN (1 to 3 digits)
    
           \xHH   byte with hexadecimal value HH (1 to 2 digits)
    
           Your shell may have its own version of echo, which usually
           supersedes the version described here.  Please refer to your
           shell's documentation for details about the options it supports.
    
           Consider using the printf(1) command instead, as it avoids
           problems when outputting option-like strings.
    


* * *
# flatpak-repo

## NAME



           flatpak-repo - Show information about a local repository
    


## SYNOPSIS



    
           **flatpak repo**[OPTION...] LOCATION
    


## DESCRIPTION



           Show information about a local repository.
    
           If you need to modify a local repository, see the **flatpak**
           **build-update-repo** command, or use the **ostree** tool.
    


## OPTIONS



           The following options are understood:
    
           **-h** , **--help**
               Show help options and exit.
    
           **--info**
               Print general information about a local repository.
    
           **--branches**
               List the branches in a local repository.
    
           **--metadata=BRANCH**
               Print metadata for a branch in the repository.
    
           **--commits=BRANCH**
               Show commits and deltas for a branch in the repository.
    
           **-v** , **--verbose**
               Print debug information during command processing.
    
           **--ostree-verbose**
               Print OSTree debug information during command processing.
    


## EXAMPLES



           **$ flatpak repo --info ~/my-repo**
    


* * *
# mckey

## NAME



           mckey - RDMA CM multicast setup and simple data transfer test.
    


## SYNOPSIS



           _mckey_ -m multicast_address [-s] [-b bind_address] [-c connections]
                     [-C message_count] [-S message_size] [-p port_space]
           _mckey_ -m multicast_address -s [-b bind_address] [-c connections]
                     [-C message_count] [-S message_size] [-p port_space]
           _mckey_ -M unmapped_multicast_address -b bind_address [-s] [-c connections]
                     [-C message_count] [-S message_size] [-p port_space]
    


## DESCRIPTION



           Establishes a set of RDMA multicast communication paths between
           nodes using the librdmacm, optionally transfers datagrams to
           receiving nodes, then tears down the communication.
    


## OPTIONS



           -m multicast_address
                  IP multicast address to join.
    
           -M unmapped_multicast_address
                  RDMA transport specific multicast address to join.
    
           -s     Send datagrams to the multicast group.
    
           -b bind_address
                  The local network address to bind to.
    
           -c connections
                  The number of QPs to join the multicast group.  (default 1)
    
           -C message_count
                  The number of messages to transfer over each connection.
                  (default 10)
    
           -S message_size
                  The size of each message transferred, in bytes.  This value
                  must be smaller than the MTU of the underlying RDMA
                  transport, or an error will occur.  (default 100)
    
           -o     Join the multicast group as a send-only full-member.
                  Otherwise the group is joined as a full-member.
    
           -l     Prevent multicast message loopback. Other receivers on the
                  local system will not receive the multicast messages.
                  Otherwise all multicast messages are also send to the host
                  they originated from and local listeners (and probably the
                  sending process itself) will receive the messages.  -p
                  port_space The port space of the datagram communication.
                  May be either the RDMA UDP (0x0111) or IPoIB (0x0002) port
                  space.  (default RDMA_PS_UDP)
    


## NOTES



           Basic usage is to start mckey -m multicast_address on a server
           system, then run mckey -m multicast_address -s on a client system.
    
           Unique Infiniband SA assigned multicast GIDs can be retrieved by
           invoking mckey with a zero MGID or IP address.  (Example, -M 0 or
           -m 0.0.0.0).  The assigned address will be displayed to allow
           mckey clients to join the created group.
    
           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.
    


* * *
# pfbtops

## Name



           pfbtops - translate PostScript Printer Font Binary files to
           Printer Font ASCII
    


## Synopsis



           **pfbtops**[_pfb-file_]
    
           **pfbtops --help**
    
           **pfbtops -v**
    
           **pfbtops --version**
    


## Description



           _pfbtops_ translates a PostScript Type 1 font in Printer Font Binary
           (PFB) format to Printer Font ASCII (PFA) format, splitting
           overlong lines in text packets into smaller chunks.  If _pfb-file_
           is omitted, the PFB file will be read from the standard input
           stream.  The PFA font will be written on the standard output
           stream.  PostScript fonts for MS-DOS were historically supplied in
           PFB format.  Use of a PostScript Type 1 font with _groff_ requires
           conversion of its metrics (AFM file) to a _groff_ font description
           file; see _afmtodit_(1).
    
           The **--help** option displays a usage message, while **-v** and **--version**
           show version information; all exit afterward.
    


## See also



           _grops_(1), _gropdf_(1)
    


* * *
# cronnext

## NAME



           cronnext - time of next job cron will execute
    


## SYNOPSIS



           **cronnext**[**-i** _users_] [**-e** _users_] [**-s**] [**-a**] [**-t** _time_] [**-q** _time_] [**-j**
                    _command_] [**-l**] [**-c**] [**-f**] [**-h**] [**-V**] [file]...
    


## DESCRIPTION



           Determine the time cron will execute the next job.  Without
           arguments, it prints that time considering all crontabs, in number
           of seconds since the Epoch, rounded to the minute. This number can
           be converted into other formats using date(1), like **date --date**
           **@43243254**
    
           The file arguments are optional. If provided, _cronnext_ uses them
           as crontabs instead of the ones installed in the system.
    


## OPTIONS



           **-i** _user,user,user,..._
                  Consider only the crontabs of the specified users.  Use
                  ***system*** for the system crontab.
    
           **-e** _user,user,user,..._
                  Do not consider the crontabs of the specified users.
    
           **-s** Do not consider the system crontab, usually the
                  _/etc/crontab_ file.  The system crontab usually contains the
                  hourly, daily, weekly and monthly crontabs, which might be
                  better dealt with anacron(8).
    
           **-a** Use the crontabs installed in the system in addition to the
                  ones passed as file arguments. This is implicit if no file
                  is passed.
    
           **-t** _time_
                  Determine the next job from this time, instead of now.  The
                  time is expressed in number of seconds since the Epoch, as
                  obtained for example by **date +%s --date "now + 2 hours"** ,
                  and is internally rounded to the minute.
    
           **-q** _time_
                  Do not check jobs over this time, expressed in the same way
                  as in option **-t**.
    
           **-j** _command_
                  Only look for jobs that contain _command_ as a substring.
    
           **-l** Print the whole entries of the jobs that are the next to be
                  executed by cron.  The default is to only print their next
                  time of execution.
    
           **-c** Print every entry in every crontab with the next time it is
                  executed.
    
           **-f** Print all jobs that are executed in the given interval.
                  Requires option **-q**.
    
           **-h** Print usage output and exit.
    
           **-V** Print version and exit.
    


* * *
# stg-commit

## NAME



           stg-commit - Finalize patches to the stack base
    


## SYNOPSIS



           _stg commit_ [OPTIONS] [patch]...
           _stg commit_ [OPTIONS] -n <number>
           _stg commit_ [OPTIONS] --all
    


## DESCRIPTION



           Finalize one or more patches into the base of the current stack
           and remove them from the series. This is the opposite of
           stg-uncommit(1). Use this command when a patch is completed and no
           longer needs to be managed with StGit.
    
           By default, the bottommost patch is committed. If patch names are
           given, the stack is rearranged so that those patches are at the
           bottom, and then they are committed.
    
           The -n/--number option specifies the number of applied patches to
           commit (counting from the bottom of the stack). If -a/--all is
           given, all applied patches are committed.
    


## OPTIONS



           -n <number>, --number=<number>
               Commit the specified number of applied patches
    
           -a, --all
               Commit all applied patches
    
           --allow-empty
               Allow empty patches to be committed
    


## STGIT



           Part of the StGit suite - see stg(1)
    


* * *
# dh_installwm

## NAME



           dh_installwm - register a window manager
    


## SYNOPSIS



           **dh_installwm**[_debhelper options_] [**-n**] [**--priority=**_n_] [_wm_ ...]
    


## DESCRIPTION



           **dh_installwm** is a debhelper program that is responsible for
           generating the _postinst_ and _prerm_ commands that register a window
           manager with **update-alternatives**(8). The window manager's man page
           is also registered as a slave symlink (in v6 mode and up).  It
           must be installed in _usr/share/man/man1/_ in the package build
           directory prior to calling **dh_installwm**.  In compat 9 and earlier,
           the manpage was optional.
    


## FILES



           debian/_package_.wm
               List window manager programs to register.
    
               Supports substitution variables in compat 13 and later as
               documented in debhelper(7).
    


## OPTIONS



           **--priority=**_n_
               Set the priority of the window manager. Default is 20, which
               is too low for most window managers; see the Debian Policy
               document for instructions on calculating the correct value.
    
           **-n** , **--no-scripts**
               Do not modify _postinst_ /_prerm_ scripts. Turns this command into
               a no-op.
    
           **-A** , **--all**
               Modify scripts for window managers specified by command line
               parameters in ALL packages acted on, not just the first.
    
           _wm_ ...
               Window manager programs to register.
    


## NOTES



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


* * *
# pmdanfsclient

## NAME



           **pmdanfsclient** - NFS client statistics performance metrics domain
           agent (PMDA)
    


## DESCRIPTION



           **pmdanfsclient** is a Performance Metrics Domain Agent (PMDA) which
           exports metric values from the _/proc/self/mountstats_ interface to
           provide information on NFS mounts.
    


## INSTALLATION



           Install the nfsclient PMDA by using the Install script as root:
    
               **# cd $PCP_PMDAS_DIR/nfsclient**
               **# ./Install**
    
           To uninstall, the following must be done as root:
    
               **# cd $PCP_PMDAS_DIR/nfsclient**
               **# ./Remove**
    
           **pmdanfsclient** 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/nfsclient/Install**
               installation script for the **pmdanfsclient** agent
    
           **$PCP_PMDAS_DIR/nfsclient/Remove**
               undo installation script for the **pmdanfsclient** agent
    
           **$PCP_LOG_DIR/pmcd/nfsclient.log**
               default log file for error messages from **pmdanfsclient**
    


## 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).
    


* * *
# trace-cmd-agent

## NAME



           trace-cmd-agent - Run as an agent on a machine (to be controlled
           by another machine)
    


## SYNOPSIS



           **trace-cmd agent**[_OPTIONS_]
    


## DESCRIPTION



           The trace-cmd(1) agent listens over a vsocket (for virtual
           machines) or a TCP port for connections to control the tracing of
           the machine. The agent will then start tracing on the local
           machine and pass the data to the controlling connection.
    


## OPTIONS



           **-N** _client_
               Listen over TCP instead of a vsocket. Must pass in a client
               host name or IP address to allow connection to. It will only
               connect to the specified client. Note, any process on that
               client can control the agent.
    
                   *This is a very insecure setting. Only use on a trusted network*
                   *Only use if the client machine is totally trusted*
    
           **-p** _port_
               This option will specify the port to listen to.
    
           **-D**
               This options causes trace-cmd agent to go into a daemon mode
               and run in the background.
    
           **-P** _cid_
               Allow an agent to also act as a proxy server, where it can be
               run on a host and connect with a guest.  _cid_ is the context ID
               (see vsock(7)) of the client (e.g., guest VM) it will allow to
               connect.
    
           **--verbose**[=_level_]
               Set the log level. Supported log levels are "none",
               "critical", "error", "warning", "info", "debug", "all" or
               their identifiers "0", "1", "2", "3", "4", "5", "6". Setting
               the log level to specific value enables all logs from that and
               all previous levels. The level will default to "info" if one
               is not specified.
    
                   Example: enable all critical, error and warning logs
    
                   trace-cmd listen --verbose=warning
    


## 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
    


* * *
# msgexec

## NAME



           msgexec - process translations of message catalog
    


## SYNOPSIS



           **msgexec**[_OPTION_] _COMMAND_ [_COMMAND-OPTION_]
    


## DESCRIPTION



           Applies a command to all translations of a translation catalog.
           The COMMAND can be any program that reads a translation from
           standard input.  It is invoked once for each translation.  Its
           output becomes msgexec's output.  msgexec's return code is the
           maximum return code across all invocations.
    
           A special builtin command called '0' outputs the translation,
           followed by a null byte.  The output of "msgexec 0" is suitable as
           input for "xargs **-0** ".
    
       **Command input:**
           **--newline**
                  add newline at the end of input
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
       **Input file location:**
           **-i** , **--input** =_INPUTFILE_
                  input PO file
    
           **-D** , **--directory** =_DIRECTORY_
                  add DIRECTORY to list for input files search
    
           If no input file is given or if it is -, standard input is read.
    
       **Input file syntax:**
           **-P** , **--properties-input**
                  input file is in Java .properties syntax
    
           **--stringtable-input**
                  input file is in NeXTstep/GNUstep .strings syntax
    
       **Informative output:**
           **-h** , **--help**
                  display this help and exit
    
           **-V** , **--version**
                  output version information and exit
    


* * *
# gencnval

## NAME



           **gencnval** - compile the converters aliases file
    


## SYNOPSIS



           **gencnval**[ **-h** , **-?** , **--help**] [ **-v** , **--verbose**] [ **-c** , **--copyright**]
           [ **-s** , **--sourcedir** _source_ ] [ **-d** , **--destdir** _destination_ ] [
           _converterfile_ ]
    


## DESCRIPTION



           **gencnval** converts the ICU aliases file _converterfile_ into the
           binary file **cnvalias.icu**.  This binary file can then be read
           directly by ICU, or used by pkgdata(1) for incorporation into a
           larger archive or library.
    
           If _converterfile_ is not provided, the default ICU **convrtrs.txt**
           file is used.
    


## OPTIONS



           **-h** , **-?** , **--help**
                  Print help about usage and exit.
    
           **-v** , **--verbose**
                  Display verbose output. This information can include
                  information about conflicting aliases and the converters
                  the aliases resolve to.
    
           **-c** , **--copyright**
                  Include a copyright notice in the binary data.
    
           **-s** , **--sourcedir** _source_
                  Set the source directory to _source_.  The default source
                  directory is specified by the environment variable
                  **ICU_DATA**.
    
           **-d** , **--destdir** _destination_
                  Set the destination directory to _destination_.  The default
                  destination directory is specified by the environment
                  variable **ICU_DATA**.
    


## ENVIRONMENT



           **ICU_DATA**
                  Specifies the directory containing ICU data. Defaults to
                  **${prefix}/share/icu/76.0.1/**.  Some tools in ICU depend on
                  the presence of the trailing slash. It is thus important to
                  make sure that it is present if **ICU_DATA** is set.
    


## FILES



           **icu/source/data/mappings/convrtrs.txt**
                  Description of ICU's converters and their aliases. This
                  data file is not normally installed, and it is available as
                  a part of ICU source code.
    


## VERSION



           76.0.1
    


* * *
# repomanage

## NAME



           repomanage - list the newest or oldest RPM packages in a directory
    


## SYNOPSIS



           **repomanage**[options] directory
    


## DESCRIPTION



           **repomanage** is a program to manage a directory of RPM packages. It
           displays a list of the newest or oldest packages in a directory
           for easy piping to xargs or similar programs.
    


## OPTIONS



           **-h, --help**
                  Display a help message, and then quit.
    
           **-o, --old**
                  Print the oldest packages.
    
           **-n, --new**
                  Print the newest packages.
    
           **-s, --space**
                  Space-separated instead of newline-separated output.
    
           **-k KEEP, --keep=KEEP**
                  Newest N packages to keep - defaults to 1.
    
           **-c, --nocheck**
                  Do not check package payload signatures/digests.
    


* * *
# exch

## NAME



           exch - atomically exchanges paths between two files
    


## SYNOPSIS



           **exch** _oldpath newpath_
    


## DESCRIPTION



           **exch** atomically exchanges oldpath and newpath. **exch** is a simple
           command wrapping **RENAME_EXCHANGE** of **renameat2** system call.
    


## OPTIONS



           **-h** , **--help**
               Display help text and exit.
    
           **-V** , **--version**
               Display version and exit.
    


## EXIT STATUS



           **exch** has the following exit status values:
    
           **0**
               success
    
           **1**
               unspecified failure
    


## AVAILABILITY



           The **exch** command is part of the util-linux package which can be
           downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) If you discover any
           rendering problems in this HTML version of the page, or you
           believe there is a better or more up-to-date source for the page,
           or you have corrections or improvements to the information in this
           COLOPHON (which is _not_ part of the original manual page), send a
           mail to man-pages@man7.org
    
    util-linux 2.42-start-521-ec46  2025-01-16                        _EXCH_(1)
    


* * *
# pcre2-config

## NAME



           pcre2-config - program to return PCRE2 configuration
    


## SYNOPSIS



    
           **pcre2-config [--prefix] [--exec-prefix] [--version]**
                        **[--libs8] [--libs16] [--libs32] [--libs-posix]**
                        **[--cflags] [--cflags-posix]**
    


## DESCRIPTION



    
           **pcre2-config** returns the configuration of the installed PCRE2
           libraries and the options required to compile a program to use
           them. Some of the options apply only to the 8-bit, 16-bit, or
           32-bit libraries, respectively, and are not available for
           libraries that have not been built. If an unavailable option is
           encountered, the "usage" information is output.
    


## OPTIONS



    
           **--prefix**
                  Writes the directory prefix used in the PCRE2 installation
                  for architecture-independent files (_/usr_ on many systems,
                  _/usr/local_ on some systems) to the standard output.
    
           **--exec-prefix**
                  Writes the directory prefix used in the PCRE2 installation
                  for architecture-dependent files (normally the same as
                  **--prefix**) to the standard output.
    
           **--version**
                  Writes the version number of the installed PCRE2 libraries
                  to the standard output.
    
           **--libs8**
                  Writes to the standard output the command line options
                  required to link with the 8-bit PCRE2 library (**-lpcre2-8** on
                  many systems).
    
           **--libs16**
                  Writes to the standard output the command line options
                  required to link with the 16-bit PCRE2 library (**-lpcre2-16**
                  on many systems).
    
           **--libs32**
                  Writes to the standard output the command line options
                  required to link with the 32-bit PCRE2 library (**-lpcre2-32**
                  on many systems).
    
           **--libs-posix**
                  Writes to the standard output the command line options
                  required to link with PCRE2's POSIX API wrapper library
                  (**-lpcre2-posix -lpcre2-8** on many systems).
    
           **--cflags**
                  Writes to the standard output the command line options
                  required to compile files that use PCRE2 (this may include
                  some **-I** options, but is blank on many systems).
    
           **--cflags-posix**
                  Writes to the standard output the command line options
                  required to compile files that use PCRE2's POSIX API
                  wrapper library (this may include some **-I** options, but is
                  blank on many systems).
    


## REVISION



    
           Last updated: 28 September 2014
    


* * *
# pcp-rocestat

## NAME



           **pcp-rocestat** - Reports statistics for nVidia RoCE devices.
    


## SYNOPSIS



           **pcp**[_pcp options_] **rocestat** _[--hw_stats|--lane_stats]_
    


## DESCRIPTION



           The **pcp-rocestat** tool utilizes ethtool counters for each device
           and reports throughput per priority queue.  By default **pcp-**
           **rocestat** reports live data for the local host.  It has the ability
           to analyze data from PDP archives as well.
    


## OPTIONS



           **--hw_stats**
                  Display hardware counters.
    
           **--lane_stats**
                  Display lane statistics.
    
           **-a** _archive_ , **--archive** =_archive_
                  Specify the PCP archive to examine.
    
           **-s** _samples_ , **--samples** =_samples_
                  Specify number of _samples_ to report.
    
           **-S** _starttime_ , **--start** =_starttime_
                  Report the samples from the archive from the given time.
    
           **-T** _endtime_ , **--finish** =_endtime_
                  Report samples from the archive until the given time.
    
           **-V** , **--version**
                  Display version number and exit.
    
           **-?** , **--help**
                  Display usage message and exit.
    


## 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).
    
           For environment variables affecting PCP tools, see
           pmGetOptions(3).
    


* * *