tripathysagar/man_text huggingface dataset:
# git-quiltimport

## NAME



           git-quiltimport - Applies a quilt patchset onto the current branch
    


## SYNOPSIS



           _git quiltimport_ [--dry-run | -n] [--author <author>] [--patches <dir>]
                           [--series <file>] [--keep-non-patch]
    


## DESCRIPTION



           Applies a quilt patchset onto the current Git branch, preserving
           the patch boundaries, patch order, and patch descriptions present
           in the quilt patchset.
    
           For each patch the code attempts to extract the author from the
           patch description. If that fails it falls back to the author
           specified with --author. If the --author flag was not given the
           patch description is displayed and the user is asked to
           interactively enter the author of the patch.
    
           If a subject is not found in the patch description the patch name
           is preserved as the 1 line subject in the Git description.
    


## OPTIONS



           -n, --dry-run
               Walk through the patches in the series and warn if we cannot
               find all of the necessary information to commit a patch. At
               the time of this writing only missing author information is
               warned about.
    
           --author _Author Name <Author Email>_
               The author name and email address to use when no author
               information can be found in the patch description.
    
           --patches <dir>
               The directory to find the quilt patches.
    
               The default for the patch directory is _patches_ or the value of
               the **$QUILT_PATCHES** environment variable.
    
           --series <file>
               The quilt series file.
    
               The default for the series file is <patches>/series or the
               value of the **$QUILT_SERIES** environment variable.
    
           --keep-non-patch
               Pass **-b** flag to _git mailinfo_ (see git-mailinfo(1)).
    


## GIT



           Part of the git(1) suite
    


* * *
# lxc-device

## NAME



           lxc-device - manage devices of running containers
    


## SYNOPSIS



           **lxc-device**[-h] [-n _name_] [add] [DEVICE] [NAME]
    


## DESCRIPTION



           **lxc-device** manages devices in running container.
    


## OPTIONS



           **-h** The full command help message.
    
           **-n, --name=**_NAME_
                  The name of the target container.
    
           **action** What action to perform. Only 'add' is supported at this
                  point.
    
           **DEVICE** The device to add to the container.  It can either be the
                  path to a device under /dev or a network interface name.
    
           **[NAME]** Name for the device within the container.
    


## EXAMPLES



           lxc-device -n p1 add /dev/video0
                  Creates a /dev/video0 device in container p1 based on the
                  matching device on the host.
    
           lxc-device -n p1 add eth0 eth1
                  Moves eth0 from the host as eth1 in p1.
    


* * *
# git-init-db

## NAME



           git-init-db - Creates an empty Git repository
    


## SYNOPSIS



           _git init-db_ [-q | --quiet] [--bare] [--template=<template-directory>] [--separate-git-dir <git-dir>] [--shared[=<permissions>]]
    


## DESCRIPTION



           This is a synonym for git-init(1). Please refer to the
           documentation of that command.
    


## GIT



           Part of the git(1) suite
    


* * *
# systemd-pty-forward

## NAME



           systemd-pty-forward - Run a command with a custom terminal
           background color or title
    


## SYNOPSIS



    
           **systemd-pty-forward**[OPTIONS...] {COMMAND}
    


## DESCRIPTION



           **systemd-pty-forward** can be used to run a command with a custom
           terminal background color or title.
    


## OPTIONS



           The following options are understood:
    
           **--background=**_COLOR_
               Change the terminal background color to the specified ANSI
               color as long as the command runs. The color specified should
               be an ANSI X3.64 SGR background color, i.e. strings such as
               "40", "41", ..., "47", "48;2;...", "48;5;...". See **ANSI Escape**
               **Code (Wikipedia)******[1] for details.
    
               Example: "--background=44" for a blue background.
    
               Added in version 258.**--title=**_TITLE_
               Change the terminal title to the specified string as long as
               the command runs.
    
               Added in version 258.
    
           **--quiet** , **-q**
               Suppresses additional informational output while running.
    
               Added in version 258.
    
           **--read-only**
               Do not accept any user input on standard input.
    
               Added in version 258.
    
           **-h** , **--help**
               Print a short help text and exit.
    
           **--version**
               Print a short version string and exit.
    


## NOTES



            1. ANSI Escape Code (Wikipedia)
               https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters
    


* * *
# stg-id

## NAME



           stg-id - Print git hash of a StGit revision
    


## SYNOPSIS



           _stg id_ [OPTIONS] [revision]
    


## DESCRIPTION



           Print the hash (object id) of a StGit revision.
    
           In addition to standard Git revision specifiers (revspecs),
           patches may be of a stack. If no branch is specified, the current
           branch is used by default. The parent of a patch may be specified
           with _[ <branch>:]<patch>^_.
    


## OPTIONS



           -b <branch>, --branch=<branch>
               Use <branch> instead of current branch
    


## STGIT



           Part of the StGit suite - see stg(1)
    


* * *
# nice

## NAME



           nice - run a program with modified scheduling priority
    


## SYNOPSIS



           **nice**[_OPTION_] [_COMMAND_ [_ARG_]...]
    


## DESCRIPTION



           Run COMMAND with an adjusted niceness, which affects process
           scheduling.  With no COMMAND, print the current niceness.
           Niceness values range from **-20**(most favorable to the process) to
           19 (least favorable to the process).
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
           **-n** , **--adjustment** =_N_
                  add integer N to the niceness (default 10)
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    
           Your shell may have its own version of nice, which usually
           supersedes the version described here.  Please refer to your
           shell's documentation for details about the options it supports.
    
       **Exit status:**
           125    if the nice command itself fails
    
           126    if COMMAND is found but cannot be invoked
    
           127    if COMMAND cannot be found
    
           -      the exit status of COMMAND otherwise
    


* * *
# clear

## NAME



           **clear** - clear the terminal screen
    


## SYNOPSIS



           **clear**[**-T** _type_] [**-V**] [**-x**]
    


## DESCRIPTION



           **clear** clears your terminal's screen if this is possible, including
           the terminal's scrollback buffer (if the extended “E3” capability
           is defined).  **clear** looks in the environment for the terminal type
           given by the environment variable **TERM** , and then in the **terminfo**
           database to determine how to clear the screen.
    
           **clear** writes to the standard output.  You can redirect the
           standard output to a file (which prevents **clear** from actually
           clearing the screen), and later **cat** the file to the screen,
           clearing it at that point.
    


## OPTIONS



           **-T** _type_
                indicates the _type_ of terminal.  Normally this option is
                unnecessary, because the default is taken from the
                environment variable **TERM**.  If **-T** is specified, then the
                shell variables **LINES** and **COLUMNS** will also be ignored.
    
           **-V** reports the version of ncurses which was used in this
                program, and exits.  The options are as follows:
    
           **-x** do not attempt to clear the terminal's scrollback buffer
                using the extended “E3” capability.
    


## PORTABILITY



           Neither IEEE Std 1003.1/The Open  Group  Base  Specifications
           Issue  7 (POSIX.1-2008) nor X/Open Curses Issue 7 documents tset
           or reset.
    
           The latter documents **tput** , which could be used to replace this
           utility either via a shell script or by an alias (such as a
           symbolic link) to run **tput** as **clear**.
    


* * *
# dpkg-buildapi

## NAME



           dpkg-buildapi - returns the build API level to use during package
           build
    


## SYNOPSIS



           **dpkg-buildapi**[_option_...] [_command_]
    


## DESCRIPTION



           **dpkg-buildapi** is a tool to retrieve the dpkg-build-api(7) level to
           use during build of source Debian packages.
    
           This program was introduced in dpkg 1.22.0.
    


## COMMANDS



           **--help**
               Show the usage message and exit.
    
           **--version**
               Show the version and exit.
    


## OPTIONS



           **-c** _control-file_
               Specifies the main source control file to read information
               from.  The default is _debian/control_.
    


## ENVIRONMENT



           **DPKG_BUILD_API**
               The build API level to use.  This is intended to be used
               internally by the tools executed from _debian/rules_ to avoid
               having to parse _debian/control_ multiple times, and not to set
               the global build API level from _debian/rules_ , otherwise build
               drivers (such as dpkg-buildpackage(1)) cannot access it.
    
           **DPKG_COLORS**
               Sets the color mode.  The currently accepted values are: **auto**
               (default), **always** and **never**.
    
           **DPKG_NLS**
               If set, it will be used to decide whether to activate Native
               Language Support, also known as internationalization (or i18n)
               support.  The accepted values are: **0** and **1**(default).
    


## FILES



       **Packaging support**
           **/usr/local/share/dpkg/buildapi.mk**
               Makefile snippet that parses the build API level into a
               variable.
    


* * *
# pmdamongodb

## NAME



           **pmdamongodb** - MongoDB database metrics
    


## DESCRIPTION



           **pmdamongodb** is a Performance Co-Pilot (PCP) Performance Metrics
           Domain Agent (PMDA) which extracts live performance data from a
           running MongoDB database server.
    


## CONFIGURATION



           Firstly, **pmdamongodb** requires installation of the **pymongo** support
           packages - a general purpose Python module for querying MongoDB.
    
           Next, **pmdamongodb** reads an optional ini-style configuration file:
    
                  $PCP_PMDAS_DIR _/mongodb/mongodb.conf_
    
           This file currently allows for two sections, one for configuring
           the MongoDB socket connection, the other for authentication.
    
           **[connection]**
    
           **host**(_localhost_)
                  Connect to the MongoDB socket on the given hostname.
    
           **port**(_27017_)
                  Connect to the MongoDB socket on the given port.
    
           **[authentication]**
    
           **username**(_empty_)
                  Username to connect to the database.
    
           **password**(empty)
                  Password to connect to the database.
    


## INSTALLATION



           To install, the following must be done as root:
    
               **# cd $PCP_PMDAS_DIR/mongodb**
               **# ./Install**
    
           To uninstall, the following must be done as root:
    
               **# cd $PCP_PMDAS_DIR/mongodb**
               **# ./Remove**
    
           **pmdamongodb** 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 _/mongodb/mongodb.conf_
                configuration file for the **pmdamongodb** agent
    
           $PCP_PMDAS_DIR _/mongodb/Install_
                installation script for the **pmdamongodb** agent
    
           $PCP_PMDAS_DIR _/mongodb/Remove_
                undo installation script for the **pmdamongodb** agent
    
           $PCP_LOG_DIR _/pmcd/mongodb.log_
                default log file for messages from the **pmdamongodb** agent
    
           Note that the usual/default value for **$PCP_PMDAS_DIR** is
           **/var/lib/pcp/pmdas** and the default for **$PCP_LOG_DIR** is
           **/var/log/pcp** but these settings are platform dependent.
    


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


* * *
# git-prune

## NAME



           git-prune - Prune all unreachable objects from the object database
    


## SYNOPSIS



           _git prune_ [-n] [-v] [--progress] [--expire <time>] [--] [<head>...]
    


## DESCRIPTION



               **Note**
    
               In most cases, users should run _git gc_ , which calls _git prune_.
               See the section "NOTES", below.
    
           This runs _git fsck --unreachable_ using all the refs available in
           **refs/** , optionally with an additional set of objects specified on
           the command line, and prunes all unpacked objects unreachable from
           any of these head objects from the object database. In addition,
           it prunes the unpacked objects that are also found in packs by
           running _git prune-packed_. It also removes entries from
           .git/shallow that are not reachable by any ref.
    
           Note that unreachable, packed objects will remain. If this is not
           desired, see git-repack(1).
    


## OPTIONS



           -n, --dry-run
               Do not remove anything; just report what it would remove.
    
           -v, --verbose
               Report all removed objects.
    
           --progress
               Show progress.
    
           --expire <time>
               Only expire loose objects older than <time>.
    
           --
               Do not interpret any more arguments as options.
    
           <head>...
               In addition to objects reachable from any of our references,
               keep objects reachable from listed <head>s.
    


## EXAMPLES



           To prune objects not used by your repository or another that
           borrows from your repository via its **.git/objects/info/alternates** :
    
               $ git prune $(cd ../another && git rev-parse --all)
    


## NOTES



           In most cases, users will not need to call _git prune_ directly, but
           should instead call _git gc_ , which handles pruning along with many
           other housekeeping tasks.
    
           For a description of which objects are considered for pruning, see
           _git fsck_ 's --unreachable option.
    


## GIT



           Part of the git(1) suite
    


* * *
# myisamlog

## NAME



           myisamlog - display MyISAM log file contents
    


## SYNOPSIS



    
           **myisamlog [**_options_**] [**_log_file_ **[**_tbl_name_**] ...]**
    


## DESCRIPTION



           **myisamlog** processes the contents of a MyISAM log file.
    
           Invoke **myisamlog** like this:
    
               shell> **myisamlog [**_options_**] [**_log_file_ **[**_tbl_name_**] ...]**
               shell> **isamlog [**_options_**] [**_log_file_ **[**_tbl_name_**] ...]**
    
           The default operation is update (**-u**). If a recovery is done (**-r**),
           all writes and possibly updates and deletes are done and errors
           are only counted. The default log file name is myisam.log for
           **myisamlog** and isam.log for **isamlog** if no _log_file_ argument is
           given. If tables are named on the command line, only those tables
           are updated.
    
           **myisamlog** supports the following options:
    
           •   **-?** , **-I**
    
               Display a help message and exit.
    
           •   **-c** _N_
    
               Execute only _N_ commands.
    
           •   **-f** _N_
    
               Specify the maximum number of open files.
    
           •   **-i**
    
               Display extra information before exiting.
    
           •   **-o** _offset_
    
               Specify the starting offset.
    
           •   **-p** _N_
    
               Remove _N_ components from path.
    
           •   **-r**
    
               Perform a recovery operation.
    
           •   **-R** _record_pos_file record_pos_
    
               Specify record position file and record position.
    
           •   **-u**
    
               Perform an update operation.
    
           •   **-v**
    
               Verbose mode. Print more output about what the program does.
               This option can be given multiple times to produce more and
               more output.
    
           •   **-w** _write_file_
    
               Specify the write file.
    
           •   **-V**
    
               Display version information.
    


* * *
# mariadb-service-convert

## NAME



           mariadb-service-convert - generate a mariadb.service file based on
           the current mariadb settings
    


## DESCRIPTION



           Use: Generate a mariadb.service file based on the current mariadb
           settings.  This is to assist distro maintainers in migrating to
           systemd service definations from a user mariadbd-safe settings in
           the my.cnf files.
    
           Redirect output to user directory like
           /etc/systemd/system/mariadb.service.d/migrated-from-my.cnf-
           settings.conf
    
           For more information, please refer to the MariaDB Knowledge Base,
           available online at https://mariadb.com/kb/
    


* * *
# pmap

## NAME



           pmap - report memory map of a process
    


## SYNOPSIS



           **pmap**[_option_ ...] _pid_ ...
    


## DESCRIPTION



           The **pmap** command reports the memory map of a process or processes.
    


## OPTIONS



           **-x** , **--extended**
                  Show the extended format.
    
           **-d** , **--device**
                  Show the device format.
    
           **-q** , **--quiet**
                  Do not display some header or footer lines.
    
           **-A** , **--range** _low_ ,_high_
                  Limit results to the given range to _low_ and _high_ address
                  range.  Notice that the low and high arguments are single
                  string separated with comma.
    
           **-X** Show even more details than the **-x** option. WARNING: format
                  changes according to _/proc/PID/smaps_
    
           **-XX** Show everything the kernel provides
    
           **-p** , **--show-path**
                  Show full path to files in the mapping column
    
           **-k** , **--use-kernel-name**
                  If available, use names provided by the kernel instead of
                  "[ anon ]"
    
           **-c** , **--read-rc**
                  Read the default configuration
    
           **-C** , **--read-rc-from** _file_
                  Read the configuration from _file_
    
           **-n** , **--create-rc**
                  Create new default configuration
    
           **-N** , **--create-rc-to** _file_
                  Create new configuration to _file_
    
           **-h** , **--help**
                  Display help text and exit.
    
           **-V** , **--version**
                  Display version information and exit.
    


## EXIT STATUS



                  **0** Success.
    
                  **1** Failure.
    
                  **42** Did not find all processes asked for.
    


## STANDARDS



           No standards apply, but **pmap** looks an awful lot like a SunOS
           command.
    


* * *
# touch

## NAME



           touch - change file timestamps
    


## SYNOPSIS



           **touch**[_OPTION_]... _FILE_...
    


## DESCRIPTION



           Update the access and modification times of each FILE to the
           current time.
    
           A FILE argument that does not exist is created empty, unless **-c** or
           **-h** is supplied.
    
           A FILE argument string of - is handled specially and causes touch
           to change the times of the file associated with standard output.
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
           **-a** change only the access time
    
           **-c** , **--no-create**
                  do not create any files
    
           **-d** , **--date** =_STRING_
                  parse STRING and use it instead of current time
    
           **-f**(ignored)
    
           **-h** , **--no-dereference**
                  affect each symbolic link instead of any referenced file
                  (useful only on systems that can change the timestamps of a
                  symlink)
    
           **-m** change only the modification time
    
           **-r** , **--reference** =_FILE_
                  use this file's times instead of current time
    
           **-t**[[CC]YY]MMDDhhmm[.ss]
                  use specified time instead of current time, with a
                  date-time format that differs from **-d** 's
    
           **--time** =_WORD_
                  specify which time to change: access time (**-a**): 'access',
                  'atime', 'use'; modification time (**-m**): 'modify', 'mtime'
    
           **--help** display this help and exit
    
           **--version**
                  output version information and exit
    


## DATE STRING



           The --date=STRING is a mostly free format human readable date
           string such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29
           16:21:42" or even "next Thursday".  A date string may contain
           items indicating calendar date, time of day, time zone, day of
           week, relative time, relative date, and numbers.  An empty string
           indicates the beginning of the day.  The date string format is
           more complex than is easily documented here but is fully described
           in the info documentation.
    


* * *
# pcp-reboot-init

## NAME



           **pcp-reboot-init** - Performance Co-Pilot helper script after system
           reboot
    


## SYNOPSIS



           **$PCP_BINADM_DIR/pcp-reboot-init**
    


## DESCRIPTION



           **pcp-reboot-init** performs ``one-trip'' initialization after system
           reboot for the various components of the Performance Co-Pilot
           (PCP).
    
           The script is normally called from init(1) or systemd(1) scripts
           prior to starting other PCP components.  It should not need to be
           run at other times, but is idempotent so repeated execution is
           harmless, but useless.
    
           **pcp-reboot-init** is intended to be run as the ``root'' user, and
           will fail otherwise.
    


## PCP ENVIRONMENT



           The file **/etc/pcp.conf** contains the local values for PCP_
           variables used in this script.
    


* * *
# flatpak-make-current

## NAME



           flatpak-make-current - Make a specific version of an app current
    


## SYNOPSIS



    
           **flatpak make-current**[OPTION...] APP BRANCH
    


## DESCRIPTION



           Makes a particular branch of an application current. Only the
           current branch of an app has its exported files (such as desktop
           files and icons) made visible to the host.
    
           When a new branch is installed it will automatically be made
           current, so this command is often not needed.
    
           Unless overridden with the **--user** or **--installation** options, this
           command changes the default system-wide installation.
    


## OPTIONS



           The following options are understood:
    
           **-h** , **--help**
               Show help options and exit.
    
           **-u** , **--user**
               Update a per-user installation.
    
           **--system**
               Update the default system-wide installation.
    
           **--installation=NAME**
               Updates a system-wide installation specified by NAME among
               those defined in /etc/flatpak/installations.d/. Using
               **--installation=default** is equivalent to using **--system**.
    
           **--arch=ARCH**
               The architecture to make current for. See **flatpak**
               **--supported-arches** for architectures supported by the host.
    
           **-v** , **--verbose**
               Print debug information during command processing.
    
           **--ostree-verbose**
               Print OSTree debug information during command processing.
    


## EXAMPLES



           **$ flatpak --user make-current org.gnome.gedit 3.14**
    


* * *
# git-unpack-objects

## NAME



           git-unpack-objects - Unpack objects from a packed archive
    


## SYNOPSIS



           _git unpack-objects_ [-n] [-q] [-r] [--strict]
    


## DESCRIPTION



           Read a packed archive (.pack) from the standard input, expanding
           the objects contained within and writing them into the repository
           in "loose" (one object per file) format.
    
           Objects that already exist in the repository will **not** be unpacked
           from the packfile. Therefore, nothing will be unpacked if you use
           this command on a packfile that exists within the target
           repository.
    
           See git-repack(1) for options to generate new packs and replace
           existing ones.
    


## OPTIONS



           -n
               Dry run. Check the pack file without actually unpacking the
               objects.
    
           -q
               The command usually shows percentage progress. This flag
               suppresses it.
    
           -r
               When unpacking a corrupt packfile, the command dies at the
               first corruption. This flag tells it to keep going and make
               the best effort to recover as many objects as possible.
    
           --strict
               Don’t write objects with broken content or links.
    
           --max-input-size=<size>
               Die, if the pack is larger than <size>.
    


## GIT



           Part of the git(1) suite
    


* * *
# stg-sync

## NAME



           stg-sync - Synchronize patches with a branch or a series
    


## SYNOPSIS



           _stg sync_ <--ref-branch=BRANCH|--series=SERIES> [<patch>...|--all]
    


## DESCRIPTION



           For each of the specified patches, perform a three-way merge with
           the same patch in the specified branch or series. The command can
           be used for keeping patches on several branches in sync. Note that
           the operation may fail for some patches because of conflicts. The
           patches in the series must apply cleanly.
    


## OPTIONS



           -a, --all
               Synchronize all applied patches
    
           -B <branch>, --ref-branch=<branch>
               Synchronize patches with <branch>
    
           -S <series>, --series=<series>
               Synchronize patches with <series>
    
           --committer-date-is-author-date
               Instead of using the current time as the committer date, use
               the author date of the commit as the committer date.
    


## STGIT



           Part of the StGit suite - see stg(1)
    


* * *
# b2sum

## NAME



           b2sum - compute and check BLAKE2 message digest
    


## SYNOPSIS



           **b2sum**[_OPTION_]... [_FILE_]...
    


## DESCRIPTION



           Print or check BLAKE2b (512-bit) checksums.
    
           With no FILE, or when FILE is -, read standard input.
    
           Mandatory arguments to long options are mandatory for short
           options too.
    
           **-b** , **--binary**
                  read in binary mode
    
           **-c** , **--check**
                  read checksums from the FILEs and check them
    
           **-l** , **--length** =_BITS_
                  digest length in bits; must not exceed the max for the
                  blake2 algorithm and must be a multiple of 8
    
           **--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 RFC 7693.  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.
    


* * *
# flatpak-build-bundle

## NAME



           flatpak-build-bundle - Create a single-file bundle from a local
           repository
    


## SYNOPSIS



    
           **flatpak build-bundle**[OPTION...] LOCATION FILENAME NAME [BRANCH]
    


## DESCRIPTION



           Creates a single-file named FILENAME for the application (or
           runtime) named NAME in the repository at LOCATION. If a BRANCH is
           specified, this branch of the application is used.
    
           The collection ID set on the repository at LOCATION (if set) will
           be used for the bundle.
    
           Unless **--oci** is used, the format of the bundle file is that of an
           ostree static delta (against an empty base) with some flatpak
           specific metadata for the application icons and appdata.
    


## OPTIONS



           The following options are understood:
    
           **-h** , **--help**
               Show help options and exit.
    
           **--runtime**
               Export a runtime instead of an application.
    
           **--arch=ARCH**
               The arch to create a bundle for. See **flatpak**
               **--supported-arches** for architectures supported by the host.
    
           **--repo-url=URL**
               The URL for the repository from which the application can be
               updated. Installing the bundle will automatically configure a
               remote for this URL.
    
           **--runtime-repo=URL**
               The URL for a .flatpakrepo file that contains the information
               about the repository that supplies the runtimes required by
               the app.
    
           **--gpg-keys=FILE**
               Add the GPG key from FILE (use - for stdin).
    
           **--gpg-homedir=PATH**
               GPG Homedir to use when looking for keyrings.
    
           **--from-commit=COMMIT**
               The OSTree commit to create a delta bundle from.
    
           **--oci**
               Export to an OCI image instead of a Flatpak bundle.
    
           **-v** , **--verbose**
               Print debug information during command processing.
    
           **--ostree-verbose**
               Print OSTree debug information during command processing.
    


## EXAMPLES



           **$ flatpak build-bundle /var/lib/flatpak/repo**
           **gnome-calculator.flatpak org.gnome.Calculator stable**
    
           **$ flatpak build-bundle ~/.local/share/flatpak/repo**
           **gnome-calculator.flatpak org.gnome.Calculator stable**
    


* * *
# resolveip

## NAME



           resolveip - resolve host name to IP address or vice versa
    


## SYNOPSIS



    
           **resolveip [**_options_**] {**_host_name_**|**_ip-addr_**} ...**
    


## DESCRIPTION



           The **resolveip** utility resolves host names to IP addresses and vice
           versa.
    
           Invoke **resolveip** like this:
    
               shell> **resolveip [**_options_**] {**_host_name_**|**_ip-addr_**} ...**
    
           **resolveip** supports the following options.
    
           •   **--help** , **--info** , **-?** , **-I**
    
               Display a help message and exit.
    
           •   **--silent** , **-s**
    
               Silent mode. Produce less output.
    
           •   **--version** , **-V**
    
               Display version information and exit.
    


* * *
# mariadb-setpermission

## NAME



           mariadb-setpermission - interactively set permissions in grant
           tables (mariadb-setpermission is now a symlink to mariadb-
           setpermission)
    


## SYNOPSIS



    
           **mariadb-setpermission [**_options_**]**
    


## DESCRIPTION



           **mariadb-setpermission** is a Perl script that was originally written
           and contributed by Luuk de Boer. It interactively sets permissions
           in the MariaDB grant tables.  **mariadb-setpermission** is written in
           Perl and requires that the DBI and DBD::MariaDB Perl modules be
           installed.
    
           Invoke **mariadb-setpermission** like this:
    
               shell> **mariadb-setpermission [**_options_**]**
    
           _options_ should be either **--help** to display the help message, or
           options that indicate how to connect to the MariaDB server. The
           account used when you connect determines which permissions you
           have when attempting to modify existing permissions in the grant
           tables.
    
           **mariadb-setpermission** also reads options from the [client] and
           [perl] groups in the .my.cnf file in your home directory, if the
           file exists.
    
           **mariadb-setpermission** supports the following options:
    
           •   **--help**
    
               Display a help message and exit.
    
           •   **--host=**_host_name_
    
               Connect to the MariaDB server on the given host.
    
           •   **--password=**_password_
    
               The password to use when connecting to the server. Note that
               the password value is not optional for this option, unlike for
               other MariaDB programs.
    
               Specifying a password on the command line should be considered
               insecure. You can use an option file to avoid giving the
               password on the command line.
    
           •   **--port=**_port_num_
    
               The TCP/IP port number to use for the connection.
    
           •   **--socket=**_path_
    
               For connections to localhost, the Unix socket file to use.
    
           •   **--user=**_user_name_
    
               The MariaDB user name to use when connecting to the server.
    


* * *
# lxc-destroy

## NAME



           lxc-destroy - destroy a container.
    


## SYNOPSIS



           **lxc-destroy**{-n _name_} [-f] [-s]
    


## DESCRIPTION



           **lxc-destroy** destroys  the system object previously created by the
           **lxc-create** command.
    


## OPTIONS



           **-f, --force**
                  If a container is running, stop it first. If this option is
                  not specified and the container is running, then **lxc-de‐**
                  **stroy** will be aborted.
    
           **-s, --snapshots**
                  destroy the specified container including all its snap‐
                  shots.
    


## COMMON OPTIONS



           These options are common to most of lxc commands.
    
           **-?, -h, --help**
                  Print a longer usage message than normal.
    
           **--usage**
                  Give the usage message
    
           **-q, --quiet**
                  mute on
    
           **-P, --lxcpath=**_PATH_
                  Use an alternate container path. The default is
                  /var/lib/lxc.
    
           **-o, --logfile=**_FILE_
                  Output to an alternate log _FILE_. The default is no log.
    
           **-l, --logpriority=**_LEVEL_
                  Set log priority to _LEVEL_. The default log priority is ER‐
                  ROR. Possible values are : FATAL, ALERT, CRIT, WARN, ERROR,
                  NOTICE, INFO, DEBUG, TRACE.
    
                  Note that this option is setting the priority of the events
                  log in the alternate log file. It do not have effect on the
                  ERROR events log on stderr.
    
           **-n, --name=**_NAME_
                  Use container identifier _NAME_.  The container identifier
                  format is an alphanumeric string.
    
           **--rcfile=**_FILE_
                  Specify the configuration file to configure the virtualiza‐
                  tion and isolation functionalities for the container.
    
                  This configuration file if present will be used even if
                  there is already a configuration file present in the previ‐
                  ously created container (via lxc-create).
    
           **--version**
                  Show the version number.
    


## DIAGNOSTIC



           The container was not found
                  The specified container for destruction was not found. It
                  is probable it does not exists and was already de‐
                  stroyed.You can use the **lxc-ls** command to list the avail‐
                  able containers on the system.
    


* * *
# stg-goto

## NAME



           stg-goto - Go to patch by pushing or popping as necessary
    


## SYNOPSIS



           _stg goto_ [OPTIONS] <patch>
    


## DESCRIPTION



           Go to patch by pushing or popping as necessary
    


## OPTIONS



           -k, --keep
               Keep the local changes
    
           -m, --merged
               Check for patches merged upstream
    
           --committer-date-is-author-date
               Instead of using the current time as the committer date, use
               the author date of the commit as the committer date.
    
           --conflicts[=<policy>]
               Either "allow" or "disallow" pushing a patch with conflicts.
    
               Using **--conflicts=allow**(or just **--conflicts**) allows pushing a
               patch that may result in unresolved merge conflicts. The patch
               will be pushed and files with conflicts will be left with
               conflict markers to be resolved manually; or the operation
               undone with **stg undo --hard**. This is the default behavior and
               also corresponds to the "stgit.push.allow-conflicts" variable
               being set to "true".
    
               Using **--conflicts=disallow** disallows pushing any patch that
               would result in merge conflicts. The operation will stop on
               the last patch that can be pushed without conflicts. This
               behavior can be configured by setting
               "stgit.push.allow-conflicts" to "false".
    


## STGIT



           Part of the StGit suite - see stg(1)
    


* * *
# perfalloc

## NAME



           **perfalloc** - notify pmdaperfevent(1) to disable hardware counter
           allocation.
    


## SYNOPSIS



           **$PCP_PMDAS_DIR/perfevent/perfalloc**[**-D**] [**-d**] [**-f** _lockfile_] [**-h**]
           [**-v**] [_commandline_]
    


## DESCRIPTION



           **perfalloc** is a command that notifies the pmdaperfevent(1) to
           disable hardware counter event collection.  This allow
           unprivileged processes to use the hardware counters.
    
           If the reservation request fails, then perfalloc exits immediately
           with exit code EXIT_FAILURE.  If successful, the perfalloc will
           run until a kill signal is received.  The reservation request
           persists while perfalloc is running.
    
           Note that **pmdaperfevent** is affected by the value of the
           _kernel.perf_event_paranoid_ setting, which can be adjusted by
           sysctl(8).
    
           If a commandline is given, this is executed as a subprocess of the
           agent.  When the command dies, so does the agent.
    
           A brief description of the command line options follows:
    
           **-D** run in the foreground (the default)
    
           **-d** run in the background
    
           **-f FILE**
                use FILE as the lock file (default
                $PCP_PMDAS_DIR/perfevent/perflock)
    
           **-h** display a help message and exit
    
           **-v** output version number and exit
    


## BUGS



           There may be a delay of up to 100 milliseconds between perfalloc
           requesting the hardware counter disabling and the perfevent PMDA
           processing the request.
    
           The perfalloc process does not check the status of the request and
           therefore is not able to provide a positive confirmation that the
           request succeeded and the hardware counters are disabled.
    


* * *
# git-prune-packed

## NAME



           git-prune-packed - Remove extra objects that are already in pack
           files
    


## SYNOPSIS



           _git prune-packed_ [-n | --dry-run] [-q | --quiet]
    


## DESCRIPTION



           This program searches the **$GIT_OBJECT_DIRECTORY** for all objects
           that currently exist in a pack file as well as in the independent
           object directories.
    
           All such extra objects are removed.
    
           A pack is a collection of objects, individually compressed, with
           delta compression applied, stored in a single file, with an
           associated index file.
    
           Packs are used to reduce the load on mirror systems, backup
           engines, disk storage, etc.
    


## OPTIONS



           -n, --dry-run
               Don’t actually remove any objects, only show those that would
               have been removed.
    
           -q, --quiet
               Squelch the progress indicator.
    


## GIT



           Part of the git(1) suite
    


* * *
# mtrace

## NAME



           mtrace - interpret the malloc trace log
    


## SYNOPSIS



           **mtrace**[_option_ ...] [_binary_] _mtracedata_
    


## DESCRIPTION



           **mtrace** is a Perl script used to interpret and provide human
           readable output of the trace log contained in the file _mtracedata_ ,
           whose contents were produced by mtrace(3).  If _binary_ is provided,
           the output of **mtrace** also contains the source file name with line
           number information for problem locations (assuming that _binary_ was
           compiled with debugging information).
    
           For more information about the mtrace(3) function and **mtrace**
           script usage, see mtrace(3).
    


## OPTIONS



           **--help** Print help and exit.
    
           **--version**
                  Print version information and exit.
    


## BUGS



           For bug reporting instructions, please see: 
           ⟨http://www.gnu.org/software/libc/bugs.html⟩.
    


* * *
# pmseries_import

## NAME



           **pmseries_import** - import PCP archive files for historical time
           series querying
    


## SYNOPSIS



           **$PCP_BINADM_DIR/pmseries_import**[**-h**] [**--archives** _path_] [**--json**
           _file_] [**--import-timeout** _time_] [**--noop**] [**--poll-interval** _delta_] [**-p**
           _port_] [**-Z** _TZ_]
    


## DESCRIPTION



           **pmseries_import** monitors a given _path_ for PCP archives, and
           automatically loads the contents into a key server (such as Valkey
           or Redis).  This is then suitable for fast time series querying
           using the pmseries(1) language, as provided by the command line
           tool and PCP REST API services of pmproxy(1).
    
           **pmseries_import** uses a simple polling technique, checking the
           archives directory for new archive files every 10 seconds.
    
           This utility is most commonly used within a container providing an
           automated Grafana dashboard setup for arbitrary PCP archives.
           This approach provides an environment containing a systemd(1)
           server to enable this archive monitoring utility, pre-configured
           **grafana-server**(1), **valkey-server**(1), and pmproxy(1) REST API
           services.
    


## OPTIONS



           **--archives** =_path_
                Specifies an alternate _path_ to poll for new PCP archives.
                Default value is _/archives_.
    
           **--jsonfile** =_file_
                Specifies an alternate JSON format _file_ to update whenever
                the time window boundaries are seen to have changed.  This
                file must contain JSON content, including a JSON map named
                "time" with "start" and "end" fields where string timestamps
                will be written.  The default value is
                _/usr/local/var/lib/grafana/dashboards/pcp-archive-_
                _analysis.json_.
    
           **-h** , **--help**
                Display command usage message and exit.
    
           **--import-timeout** =_timeout_
                Specify a number of seconds to allow for any individual
                archive import to complete, via the **pmseries** load command for
                that archive.  The default _timeout_ value is _600_ seconds (5
                minutes).
    
           **--noop**
                Skips all write operations (for debugging or testing
                purposes), reporting only diagnostic messages instead.
    
           **--poll-interval** =_delta_
                The frequency with which the archive directory will be
                scanned.  Default _delta_ is once every 10 seconds.
    
           **-p** _port_ , **--port** =_port_
                An optional _port_ on which **pmseries** should connect to the key
                server.  The default port is 6379.
    
           **-Z** _TZ_ , **--timezone** =_TZ_
                An optional _TZ_ value indicating the timezone to which
                **pmseries** should convert all archive timestamps when sending
                values to the key server.
    


* * *