Applied 1c7f48dd81
This commit is contained in:
parent
4f5cd6c868
commit
087eb29037
1 changed files with 38 additions and 38 deletions
|
|
@ -1,95 +1,96 @@
|
|||
# Pacwrap User Manual
|
||||
|
||||
This document was generated by the pacwrap binary on 25-10-2023 with version 0.4.1-1a11c7c of the program.
|
||||
This document was generated by the pacwrap binary on 17/11/2023 00:49:30 with version 0.5.0-b9b5ea8 of the program.
|
||||
|
||||
## NAME
|
||||
pacwrap - Command-line application which facilitates the creation, management, and execution of unprivileged,
|
||||
sandboxed containers with bubblewrap and libalpm.
|
||||
|
||||
## SYNOPSIS
|
||||
pacwrap [**OPERATIONS**] [**ARGuMENTS**] [**TARGET(S)**]
|
||||
pacwrap [**OPERATIONS**] [**ARGUMENTS**] [**TARGET(S)**]
|
||||
|
||||
## OPERATIONS
|
||||
|
||||
* -S, --sync**
|
||||
* **-S, --sync**
|
||||
Synchronize package databases and update packages in target containers.
|
||||
|
||||
* -U, --utils**
|
||||
* **-U, --utils**
|
||||
Invoke miscellaneous utilities to manage containers.
|
||||
|
||||
* -P, --process**
|
||||
* **-P, --process**
|
||||
Manage and show status of running container processes.
|
||||
|
||||
* -E, --execute**
|
||||
* **-E, --execute**
|
||||
Executes application in target container using bubblewrap.
|
||||
|
||||
* -h, --help**
|
||||
Invoke a printout of this manual to **stdout**. Specify an option verbatim for further information.
|
||||
* **-h, --help=OPTION**
|
||||
Invoke a printout of this manual to **STDOUT**.
|
||||
|
||||
* -V, --version**
|
||||
* **-V, --version**
|
||||
Display version and copyright information in **STDOUT**.
|
||||
|
||||
## EXECUTE
|
||||
|
||||
* -r, --root**
|
||||
* **-r, --root**
|
||||
Execute operation with fakeroot and fakechroot. Facilitates a command with faked privileges.
|
||||
|
||||
* -s, --shell**
|
||||
* **-s, --shell**
|
||||
Invoke a bash shell
|
||||
|
||||
## SYNCHRONIZATION
|
||||
|
||||
* -y, --refresh**
|
||||
* **-y, --refresh**
|
||||
Synchronize remote package databases. Specify up to 2 times to force a refresh.
|
||||
|
||||
* -u, --upgrade**
|
||||
* **-u, --upgrade**
|
||||
Execute aggregate upgrade routine on all or specified containers. Use **-t, --target=TARGET** to limit
|
||||
package synhronization operations to the specified target containers. Packages applicable to a target **must**
|
||||
be specified only after the target operand. e.g. '-t electron element-desktop -t mozilla firefox thunderbird'
|
||||
package synhronization operations to the specified target containers. Packages applicable to
|
||||
a target **must** be specified only after the target operand.
|
||||
e.g. '-t electron element-desktop -t mozilla firefox thunderbird'
|
||||
|
||||
* -f, --filesystem**
|
||||
* **-f, --filesystem**
|
||||
Force execution of filesystem synchronization target on all or specified containers. In combination
|
||||
with **-o/--target-only**, in addition to no other specified targets, filesystem slices will be
|
||||
synchronized without package synchronization on all applicable containers.
|
||||
|
||||
* -c, --create**
|
||||
* **-c, --create**
|
||||
Create a container with the first specified target. A container type argument is also required.
|
||||
|
||||
* -b, --base**
|
||||
* **-b, --base**
|
||||
Base container type. Specify alongside **-c, --create** to assign this container type during creation.
|
||||
This container type is used as the base layer for all downstream containers. Only one base container
|
||||
dependency per slice or per root is supported. Filesystem and package deduplication via slices and root
|
||||
containers is recommended, but optional.
|
||||
dependency per slice or per root is supported. Filesystem and package deduplication via slices
|
||||
and root containers is recommended, but optional.
|
||||
|
||||
* -d, --slice**
|
||||
* **-d, --slice**
|
||||
Slice container type. Specify alongside **-c, --create** to assign this container type during creation.
|
||||
Requires a base dependency target, and optionally sliced dependency target(s), in order to ascertain
|
||||
foreign packages and influence ordering of downstream synchronization target(s). Container slicing provides
|
||||
the ability to install packages in a lightweight, sliced filesytem, which aid in the deduplication of
|
||||
common downstream package and filesystem dependencies (e.g. graphics drivers, graphical toolkits, fonts,
|
||||
and display server dependencies, etc.).
|
||||
foreign packages and influence ordering of downstream synchronization target(s). Container slicing
|
||||
provides the ability to install packages in a lightweight, sliced filesytem, which aid in the
|
||||
deduplication of common downstream package and filesystem dependencies e.g. graphics drivers,
|
||||
graphical toolkits, fonts, etc..
|
||||
|
||||
* -r, --root**
|
||||
* **-r, --root**
|
||||
Root container type. Specify alongside **-c, --create** to this assign container type during creation.
|
||||
Requires a base dependency target, and optionally sliced dependency targets, in order to ascertain
|
||||
foreign packages and influence ordering of this target. These containers are ideal for installing
|
||||
software in with the least amount of filesystem and package synchronization overhead.
|
||||
|
||||
* -t, --target=TARGET**
|
||||
* **-t, --target=TARGET**
|
||||
Specify a target container for the specified operation.
|
||||
|
||||
* -o, --target-only**
|
||||
* **-o, --target-only**
|
||||
Apply specified operation on the specified target only.
|
||||
|
||||
* --force-foreign**
|
||||
* **--force-foreign**
|
||||
Force synchronization of foreign packages on resident container. Useful for when installing
|
||||
a new package in a root container without all the prerequisite foreign dependencies synchronized
|
||||
to this container's package database.
|
||||
|
||||
* --dbonly**
|
||||
* **--dbonly**
|
||||
Transact on resident containers with a database-only transaction.
|
||||
|
||||
* --noconfirm**
|
||||
* **--noconfirm**
|
||||
Override confirmation prompts and confirm all operations.
|
||||
|
||||
## PROCESS
|
||||
|
|
@ -100,26 +101,25 @@ Override confirmation prompts and confirm all operations.
|
|||
|
||||
## HELP
|
||||
|
||||
* -m, --more**
|
||||
* **-m, --more**
|
||||
When specifying a topic to display, show the default topic in addition to specified options.
|
||||
|
||||
* -f, --format=FORMAT**
|
||||
* **-f, --format=FORMAT**
|
||||
Change output format of help in **STDOUT**. Format options include: 'ansi', 'dumb', 'markdown', and 'man'.
|
||||
This option is for the express purposes of generating documentation at build time, and has little utility
|
||||
outside the context of package maintenance. 'man' option produces troff-formatted documents for man pages.
|
||||
|
||||
|
||||
* -a, --all, --help=all**
|
||||
* **-a, --all, --help=all**
|
||||
Display all help topics.
|
||||
|
||||
## VERSION
|
||||
|
||||
* -v, --version, --version=min**
|
||||
* **-V, --version, --version=min**
|
||||
Sends version information to **STDOUT** with colourful ASCII art.
|
||||
The 'min' option provides a minimalistic output as is provided to non-colour terms.
|
||||
|
||||
This documentation was generated by pacwrap v0.4.1-1a11c7c-DEV (25-10-2023).
|
||||
Please seek relevant documentation if 'pacwrap -v' mismatches with the aforementioned.
|
||||
This documentation was generated by pacwrap v0.5.0-b9b5ea8-DEV (17/11/2023 00:49:30).
|
||||
Please seek relevant documentation if 'pacwrap -V' mismatches with the aforementioned.
|
||||
|
||||
## COPYRIGHT
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue