- Documentation for desktop utils command module - Split authorship and license sections in manual - Cleaned up and reformatted some parameters in manual output - Don't include symbolic containers with queue in filesystem module - Tidy-up refactor of a few different functions across the library
683 lines
19 KiB
Groff
683 lines
19 KiB
Groff
.nh
|
|
.TH pacwrap 1 "10/04/2024" "pacwrap version_string_placeholder" "User Manual"
|
|
|
|
.SH
|
|
NAME\fR
|
|
pacwrap
|
|
|
|
.SH
|
|
SYNOPSIS\fR
|
|
pacwrap [\fBOPERATION\fR | \fBVERB\fR] [\fBARGUMENTS\fR] [\fBTARGETS\fR]
|
|
|
|
.SH
|
|
DESCRIPTION\fR
|
|
.PP
|
|
A package management front-end which utilises libalpm to facilitate the creation of unprivileged,
|
|
namespace containers with parallelised, filesystem-agnostic deduplication. These containers
|
|
are constructed with bubblewrap to execute package transactions and launch applications.
|
|
|
|
.PP
|
|
This application is designed to allow for the creation and execution of secure, replicable
|
|
containerised environments for general-purpose use. CLI and GUI applications are all supported.
|
|
Once a container environment is configured, it can be re-established or replicated on any system.
|
|
|
|
.PP
|
|
Each long-option parameter can also be specified herein as a command verb for a matter of convenience.
|
|
Additional command verb shortcuts are available and are documented alongside their relevancy.
|
|
|
|
.SH
|
|
OPERATIONS\fR
|
|
.TP
|
|
\fB-E, --exec, run\fR
|
|
Invoke a container to execute the provided command sequence.
|
|
|
|
.TP
|
|
\fB-S, --sync\fR
|
|
Synchronize package databases and containers in aggregate.
|
|
|
|
.TP
|
|
\fB-R, --remove\fR
|
|
Remove packages from target containers in aggregate.
|
|
|
|
.TP
|
|
\fB-C, --compose\fR
|
|
Compose a container from configuration.
|
|
|
|
.TP
|
|
\fB-Q, --query\fR
|
|
Query package information from target container.
|
|
|
|
.TP
|
|
\fB-P, --process\fR
|
|
Manage and show status of running container processes.
|
|
|
|
.TP
|
|
\fB-L, --list\fR
|
|
List available containers managed by pacwrap.
|
|
|
|
.TP
|
|
\fB-U, --utils\fR
|
|
Engage miscellaneous utilities to manage containers.
|
|
|
|
.TP
|
|
\fB-V, --version\fR
|
|
Display version banner or information.
|
|
|
|
.TP
|
|
\fB-h, --help\fR <\fBOPERATION\fR | \fBVERB\fR | \fBTOPIC\fR>
|
|
Print the help manual to \fBSTDOUT\fR.
|
|
|
|
.SH
|
|
EXECUTE\fR
|
|
.PP
|
|
Invoke a container to execute the provided command sequence. Command verb \fB`run`\fR provides a
|
|
shortcut to this module.
|
|
|
|
.TP
|
|
\fB<CONTAINER> <CMD>\fR
|
|
Container name to spawn an instance of, along with the proceeding command-line sequence to execute.
|
|
execute. All command-line parameters after the container name are passed through to execute inside
|
|
of the container environment.
|
|
|
|
.TP
|
|
\fB-s, --shell\fR
|
|
Invoke a bash shell in the target container. Command verb \fB`shell`\fR provides a shortcut
|
|
to this module with this option.
|
|
|
|
.TP
|
|
\fB-r, --root\fR
|
|
Execute the provided command sequence with fakeroot and fakechroot.
|
|
|
|
.SS
|
|
EXAMPLES\fR
|
|
.TP
|
|
`$ pacwrap run firefox firefox`
|
|
Launch firefox inside an instance of the firefox container.
|
|
|
|
.TP
|
|
`$ pacwrap shell -r base`
|
|
Open a fakeroot bash shell inside an instance of the base container.
|
|
|
|
.SH
|
|
SYNCHRONIZATION\fR
|
|
.PP
|
|
Provides the facilities required to be able to synchronize and create containers in aggregate.
|
|
|
|
.TP
|
|
\fB-y, --refresh\fR
|
|
Synchronize remote package databases. Specify up to 2 times to force a refresh.
|
|
|
|
.TP
|
|
\fB-u, --upgrade\fR
|
|
Execute aggregate upgrade routine on all or specified containers. Use \fB`-t, --target[=CONTAINER]`\fR followed
|
|
by a list of packages to specify package targets. Packages applicable to a target \fBmust\fR only be specified
|
|
after the target operand.
|
|
|
|
.TP
|
|
\fB-c, --create\fR
|
|
Create a container with the first specified target. A container type argument is also required. Command verb
|
|
\fB`init`\fR provides a shortcut to the synchronization module, equivalent to specifying the options \fB`-Syuc`\fR.
|
|
|
|
.TP
|
|
\fB-b, --base\fR
|
|
Base container type. Specify alongside \fB`-c, --create`\fR 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 aggregate is supported. Filesystem and package deduplication via slices and
|
|
aggregate containers are recommended, but optional. This container type is not dependant.
|
|
|
|
.TP
|
|
\fB-s, --slice\fR
|
|
Slice container type. Specify alongside \fB`-c, --create`\fR to assign this container type during creation.
|
|
|
|
Requires a base dependency, and optionally one or more sliced dependencies, 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.
|
|
|
|
Useful for graphics drivers, graphical toolkits, fonts, etc.; these are not meant for applications.
|
|
|
|
.TP
|
|
\fB-a, --aggegrate\fR
|
|
Aggregate container type. Specify alongside \fB`-c, --create`\fR to this assign container type during creation.
|
|
|
|
Requires a base dependency, and optionally one or more sliced dependencies, in order to acertain foreign
|
|
packages and amalgamate the target. These containers are ideal for installing software with the aid of
|
|
filesystem and package deduplication.
|
|
|
|
Useful for all general purpose applications, browsers, e-mail clients, or even terminal user interface
|
|
applications such as IRC clients. It is recommended to base your containers on aggregate type containers.
|
|
|
|
.TP
|
|
\fB-t, --target\fR <\fBCONTAINER\fR> <..\fBPACKAGE\fR>
|
|
Declare a target container for the specified operation, followed by a list of package target(s).
|
|
|
|
.TP
|
|
\fB-f, --filesystem\fR
|
|
Force execution of filesystem synchronization target on all or specified containers. In combination
|
|
with \fB-o/--target-only\fR, in addition to no other specified targets, filesystems will be synchronized
|
|
without package synhcronization on on all applicable containers. This operation is useful for propagation
|
|
of manual filesystem changes to all aggregate containers.
|
|
|
|
.TP
|
|
\fB-o, --target-only\fR
|
|
Apply specified operation on the specified target(s) only.
|
|
|
|
.TP
|
|
\fB-d, --dep\fR <\fBCONTAINER\fR>
|
|
Specify dependencies for a container create operation.
|
|
|
|
.TP
|
|
\fB-p, --preview\fR
|
|
Perform a dryrun operation on existing containers to preview changes applicable or otherwise specified.
|
|
Only applicable to pre-existing targets and not create operations.
|
|
|
|
.TP
|
|
\fB--force-foreign\fR
|
|
Force synchronization of foreign packages on resident container. Useful for when installing
|
|
a new package in an aggregate container without all the prerequisite foreign dependencies
|
|
synchronized to the resident container's package database.
|
|
|
|
.TP
|
|
\fB--dbonly\fR
|
|
Transact on resident containers with a database-only transaction.
|
|
|
|
.TP
|
|
\fB--noconfirm\fR
|
|
Override confirmation prompts and confirm all operations.
|
|
|
|
.SS
|
|
EXAMPLES\fR
|
|
.TP
|
|
`$ pacwrap init --base --target base`
|
|
Synchronize remotes and create a base-type container named `base` with no additional packages.
|
|
|
|
.TP
|
|
`$ pacwrap -Syucst common gtk3 qt6-base --dep=base -st nvidia nvidia-utils --dep=base,common`
|
|
Synchronize remote databases, create two sliced containers, one named `common` with the packages
|
|
`gtk3`, `qt6-base`, and another named `nvidia` with the package `nvidia-utils`.
|
|
|
|
.TP
|
|
`$ pacwrap -Syucat mozilla firefox --dep=base,common,nvidia`
|
|
Synchronize remote databases and upgrade container dependencies, then create aggregate container
|
|
named `mozilla` with the package `firefox`.
|
|
|
|
.TP
|
|
`$ pacwrap -Sot mozilla thunderbird`
|
|
Install `thunderbird` in the target container `mozilla`.
|
|
|
|
.TP
|
|
`$ pacwrap -Sof`
|
|
Synchronize filesystem state of all associated containers present in the data directory.
|
|
|
|
.SH
|
|
REMOVE\fR
|
|
.PP
|
|
Remove packages from specified containers.
|
|
|
|
.TP
|
|
\fB-s, --recursive\fR
|
|
Recursively remove all target packages with the associated target container. This does
|
|
not apply to packages upstream of a downstream container.
|
|
|
|
.TP
|
|
\fB-c, --cascade\fR
|
|
Remove all target packages with the associated target container, including all their
|
|
associated dependencies, provided they are not required by other packages, and are not
|
|
marked as being upstream of the target container.
|
|
|
|
.TP
|
|
\fB-t, --target\fR <\fBCONTAINER\fR>
|
|
Specify a target container for the specified operation. At least one container target is
|
|
is required for package removal operations.
|
|
|
|
.TP
|
|
\fB--force-foreign\fR
|
|
Force the removal of foreign packages on target container. Useful for cleaning up
|
|
the package database of foreign, upstream dependencies synchronized to the target
|
|
container's package database.
|
|
|
|
.TP
|
|
\fB-m, --delete\fR
|
|
Delete root filesystem(s) of specified targets. Shortcout to \fB-Ur\fR.
|
|
|
|
.TP
|
|
\fB-p, --preview\fR
|
|
Preview operation and perform no transaction.
|
|
|
|
.TP
|
|
\fB--dbonly\fR
|
|
Transact on resident containers with a database-only transaction.
|
|
|
|
.TP
|
|
\fB--noconfirm\fR
|
|
Override confirmation prompts and confirm all operations.
|
|
|
|
.SS
|
|
EXAMPLES\fR
|
|
.TP
|
|
`$ pacwrap -Rt firefox firefox`
|
|
Remove the target package firefox from target container firefox.
|
|
|
|
.TP
|
|
`$ pacwrap rm firefox`
|
|
Delete the root filesystem for the firefox container.
|
|
|
|
.SH
|
|
COMPOSE\fR
|
|
Compose containers from container configuration files. This functionality provides a way
|
|
to deterministically compose containers from an established configuration.
|
|
|
|
.TP
|
|
\fB<FILE_PATH>\fR
|
|
Compose a container from the specified configuration file on disk. Unless a target is
|
|
otherwise specified, the container will be initialized with a name derived from the
|
|
filename provided.
|
|
|
|
.TP
|
|
\fB-r, --reinitialize\fR
|
|
Compose an available, existing container for composition. The pre-existing container root
|
|
will be deleted and the container will be composited from the configuration data enumerated.
|
|
|
|
.TP
|
|
\fB-t, --target=\fR <\fBCONTAINER\fR>
|
|
Specify a target container for the specified operation.
|
|
|
|
.TP
|
|
\fB-f, --force\fR
|
|
Disable sanity checks and force removal of container filesystem(s).
|
|
|
|
.TP
|
|
\fB--reinitialize-all\fR
|
|
Queues all available, existing containers for composition. All pre-existing container roots
|
|
will be deleted and composited from the available configuration data enumerated.
|
|
|
|
.TP
|
|
\fB--from-config\fR
|
|
Instruct pacwrap to populate configuration data from uninitialized containers. Under normal
|
|
circumstances, configuration data will only be populated from containers with configuration
|
|
data and an associative container root present. This option engages an alternate enuermation
|
|
pathway to allow composition of dormant, uninitialized container configurations.
|
|
|
|
.TP
|
|
\fB--noconfirm\fR
|
|
Override confirmation prompts and confirm all operations.
|
|
|
|
.SS
|
|
EXAMPLES\fR
|
|
.TP
|
|
`$ pacwrap compose -rt element element.yml`
|
|
Reinitialize an existing container named element with its configuration derived
|
|
from the file 'element.yml'.
|
|
|
|
.TP
|
|
`$ pacwrap compose --reinitialize-all --from-config`
|
|
Reinitialize all container configurations available in '\fB$PACWRAP_CONFIG_DIR\fR/container/'.
|
|
|
|
.SH
|
|
QUERY\fR
|
|
.PP
|
|
Query package list on target container.
|
|
|
|
.TP
|
|
\fB-q, --quiet\fR
|
|
Quiet the output by truncating the package string.
|
|
|
|
.TP
|
|
\fB-t, --target\fR <\fBCONTAINER\fR>
|
|
Specify a target container for the specified operation.
|
|
|
|
.TP
|
|
\fB-e, --explicit\fR
|
|
Filter output to explicitly-marked packages.
|
|
|
|
.SS
|
|
EXAMPLE\fR
|
|
.TP
|
|
`$ pacwrap -Qqe base`
|
|
Print a list of explicit packages from the \fBbase\fR container to \fBSTDOUT\fR.
|
|
|
|
.SH
|
|
PROCESS\fR
|
|
.PP
|
|
Table a process list of running containers. Containers may be filtered on target and process depth.
|
|
|
|
.TP
|
|
\fB-s, --summary\fR
|
|
Enumerate a process summary of containers instantiated by pacwrap.
|
|
|
|
.TP
|
|
\fB-i, --id-list\fR
|
|
Enumerate a process id list of containers instantiated by pacwrap.
|
|
|
|
.TP
|
|
\fB-k, --kill\fR
|
|
Kill target containers and their associated processes.
|
|
|
|
.TP
|
|
\fB-a, --all\fR
|
|
Target all containers and enumerate their associated processes.
|
|
|
|
.TP
|
|
\fB-d, --depth\fR
|
|
Enumerate all processes at the specified depth associated with running containers.
|
|
|
|
.TP
|
|
\fB-t, --target\fR <\fBCONTAINER\fR>
|
|
Specify a target container for the specified operation.
|
|
|
|
.TP
|
|
\fB--noconfirm\fR
|
|
Override confirmation prompts and confirm all operations.
|
|
|
|
.SS
|
|
EXAMPLES\fR
|
|
.TP
|
|
`$ pacwrap -Psaxc`
|
|
Print table enumerating all container processes to \fBSTDOUT\fR with process arguments
|
|
and execution path split into separate columns.
|
|
|
|
.TP
|
|
`$ ps up "$(pacwrap -Pia)"`
|
|
Enumerate container processes with `ps` via encapsulating an enumeration of pids from all instances
|
|
into a space-delimited bash string.
|
|
|
|
.SH
|
|
LIST\fR
|
|
.PP
|
|
List all initialized containers presently managed by pacwrap.
|
|
|
|
.PP
|
|
This command module is a shortcut to \fB-Ul\fR. Command verb \fB`ls`\fR also is a
|
|
shortcut to this command module.
|
|
|
|
.TP
|
|
\fB-t, --total\fR
|
|
Display a total column.
|
|
|
|
.TP
|
|
\fB-o, --on-disk\fR
|
|
Display a size on disk column.
|
|
|
|
.TP
|
|
\fB-b, --bytes\fR
|
|
Toggle byte unit display.
|
|
|
|
.SS
|
|
EXAMPLES\fR
|
|
.TP
|
|
`$ pacwrap -Ld`
|
|
Print container tabulation out to \fBSTDOUT\fR with two total columns, one listing the
|
|
container name, and the other detailing the total size-on-disk consumption displayed with byteunits.
|
|
|
|
.TP
|
|
`$ pacwrap ls -btbts`
|
|
Print container tabulation to \fBSTDOUT\fR with three total columns, first listing the
|
|
container name, second the total amount of bytes, and the last showing the total with byteunits.
|
|
Then print a summation of total, actual consumption below.
|
|
|
|
.SH
|
|
UTILITIES\fR
|
|
.PP
|
|
Miscellaneous utilities which provide helpful auxiliary functionality to aid in configuration and
|
|
maintenance of containers. Each utility is considered a command module and therefore can be shortcuted
|
|
with a command verb.
|
|
|
|
.TP
|
|
\fB-d, --desktop\fR
|
|
Create desktop file to launch application inside of a pacwrap container.
|
|
|
|
.TP
|
|
\fB-v, --view\fR
|
|
Invoke \fB$EDITOR\fR to view file associated with pacwrap.
|
|
|
|
.TP
|
|
\fB-e, --edit\fR
|
|
Invoke \fB$EDITOR\fR to edit file associated with pacwrap.
|
|
|
|
.TP
|
|
\fB-o, --open\fR
|
|
Invoke default file viewer on specified target's home or root directory.
|
|
|
|
.TP
|
|
\fB-l, --list\fR
|
|
Print a list of containers and basic metrics.
|
|
|
|
.TP
|
|
\fB-s, --symlink\fR
|
|
Create a symbolic container.
|
|
|
|
.TP
|
|
\fB-r, --remove\fR
|
|
Delete a container(s) root filesystem.
|
|
|
|
.SS
|
|
DESKTOP OPTIONS\fR
|
|
.PP
|
|
Create and manage desktop files to launch applications in pacwrap from your favourite applications menu.
|
|
|
|
.TP
|
|
\fB-c, --create\fR <\fBCONTAINER\fR> <\fBAPPLICATION\fR>
|
|
Create desktop file associated with application at `$HOME/.local/share/applications/` launching an
|
|
application in pacwrap.
|
|
|
|
.TP
|
|
\fB-l, --list\fR <\fBCONTAINER\fR>
|
|
List available desktop files in the container root located at `/usr/share/applications/`.
|
|
|
|
.TP
|
|
\fB-r, --remove\fR <\fBAPPLICATION\fR>
|
|
Remove desktop file associated with application from `$HOME/.local/share/applications/`.
|
|
|
|
.SS
|
|
EDITOR OPTIONS\fR
|
|
.PP
|
|
These options are associated with the \fB--edit\fR and \fB--view\fR utility command modules.
|
|
|
|
.TP
|
|
\fB-c, --config\fR <\fBCONTAINER\fR>
|
|
Edit specified container configuration located in the pacwrap data directory. Defaults to
|
|
the primary configuration file: '\fB$PACWRAP_CONFIG_DIR\fR/pacwrap.yml' if no option is otherwise
|
|
specified.
|
|
|
|
.TP
|
|
\fB-d, --desktop\fR <\fBAPPLICATION\fR>
|
|
Edit specified desktop file associated with a pacwrap container.
|
|
|
|
.TP
|
|
\fB-r, --repo\fR
|
|
Edit repositories configuration file: `$PACWRAP_CONFIG_DIR/repositories.conf`.
|
|
|
|
.TP
|
|
\fB-l, --log\fR
|
|
View 'pacwrap.log'. This file contains transaction log iformation.
|
|
|
|
.SS
|
|
OPEN OPTIONS\fR
|
|
.PP
|
|
These options are associated with the \fB--open\fR utility command module.
|
|
|
|
.TP
|
|
\fB-h, --home\fR <\fBCONTAINER\fR>
|
|
Specified container's home filesystem.
|
|
|
|
.TP
|
|
\fB-r, --root\fR <\fBCONTAINER\fR>
|
|
Specified container's root filesystem.
|
|
|
|
.TP
|
|
\fB-t, --target\fR <\fBCONTAINER\fR>
|
|
Target container to perform the operation.
|
|
|
|
.SS
|
|
LIST\fR
|
|
.PP
|
|
These options are associated with the \fB--list\fR utility command module.
|
|
|
|
.TP
|
|
\fB-t, --total\fR
|
|
Display a total column.
|
|
|
|
.TP
|
|
\fB-d, --on-disk\fR
|
|
Display a size on disk column.
|
|
|
|
.TP
|
|
\fB-s, --summary\fR
|
|
Print out a summary table to \fBSTDOUT\fR.
|
|
|
|
.TP
|
|
\fB-b, --bytes\fR
|
|
Toggle byte unit display for the proceeding item.
|
|
|
|
.SS
|
|
REMOVE OPTIONS\fR
|
|
.PP
|
|
These options are associated with the \fB--remove\fR utility command module.
|
|
|
|
.TP
|
|
\fB-t, --target\fR <\fBCONTAINER\fR>
|
|
Target container to perform the operation.
|
|
|
|
.TP
|
|
\fB--noconfirm\fR
|
|
Peform the operation without confirmation.
|
|
|
|
.TP
|
|
\fB--force\fR
|
|
Disable sanity checks and force removal of conatiner filesystem.
|
|
|
|
.SS
|
|
SYMBOLIC\fR
|
|
.PP
|
|
These options are associated with the \fB--symlink\fR utility command module.
|
|
|
|
.TP
|
|
\fB<TARGET> <DEST>\fR
|
|
Create a symbolic container of target at destination.
|
|
|
|
.TP
|
|
\fB-n, --new\fR
|
|
Create a fresh configuration rather than derive it from the target.
|
|
|
|
.SS
|
|
EXAMPLES\fR
|
|
.TP
|
|
`$ pacwrap -Uoh firefox`
|
|
Open firefox's home directory in the default file manager.
|
|
|
|
.TP
|
|
`$ pacwrap -Uvl`
|
|
View `\fB$PACWRAP_DATA_DIR\fR/pacwrap.log` with \fB$EDITOR\fR.
|
|
|
|
.TP
|
|
`$ pacwrap -Uec firefox`
|
|
Edit `$PACWRAP_CONFIG_DIR\fR/container/firefox.yml` with \fB$EDITOR\fR.
|
|
|
|
.TP
|
|
`$ pacwrap utils -dc firefox firefox`
|
|
Create desktop file `$HOME/.local/share/applications/pacwrap.firefox.desktop` derived from
|
|
`/usr/share/applications/firefox.desktop` in the root of the firefox container.
|
|
|
|
.TP
|
|
`$ pacwrap utils symlink java runelite`
|
|
Create a symbolic container called `runelite` of `java`.
|
|
|
|
.TP
|
|
`$ pacwrap -Uld`
|
|
Print container tabulation out to \fBSTDOUT\fR with two total columns, one listing the
|
|
container name, and the other detailing the total size-on-disk consumption displayed with byteunits.
|
|
|
|
.TP
|
|
`$ pacwrap utils -lbtbts`
|
|
Print container tabulation to \fBSTDOUT\fR with three total columns, first listing the
|
|
container name, second the total amount of bytes, and the last showing the total with byteunits.
|
|
Then print a summation of total, actual consumption below.
|
|
|
|
.SH
|
|
VERSION\fR
|
|
.TP
|
|
\fB-V, --version, --version=min\fR
|
|
Sends version information to \fBSTDOUT\fR with colourful ASCII art.
|
|
The 'min' option provides a minimalistic output as is provided to non-colour terms.
|
|
|
|
.SH
|
|
HELP\fR
|
|
.TP
|
|
\fB-h, --help\fR <\fBTOPIC\fR>
|
|
Print the specified topic to \fBSTDOUT\fR.
|
|
|
|
.TP
|
|
\fB-m, --more\fR
|
|
When specifying a topic to display, show the default topic in addition to specified options.
|
|
|
|
.TP
|
|
\fB-f, --format\fR <\fBFORMAT\fR>
|
|
Change output format of help in \fBSTDOUT\fR. 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.
|
|
|
|
.TP
|
|
\fB-a, --all, --help=all\fR
|
|
Display all help topics.
|
|
|
|
.SH
|
|
ENVIRONMENT\fR
|
|
.PP
|
|
Provided herein are environment variables of which can be used to configure pacwrap's runtime parameters.
|
|
All environment variables listed are case sensitive.
|
|
|
|
.PP
|
|
Use with care: These variables if used improperly could result in undesired behaviour.
|
|
|
|
.TP
|
|
\fBPACWRAP_CONFIG_DIR\fR <\fBDIR\fR>
|
|
Set path of the configuration directory, overriding the default location.
|
|
|
|
.TP
|
|
\fBPACWRAP_DATA_DIR\fR <\fBDIR\fR>
|
|
Set path of the data directory, overriding the default location.
|
|
|
|
.TP
|
|
\fBPACWRAP_CACHE_DIR\fR <\fBDIR\fR>
|
|
Set path of the cache directory, overriding the default location.
|
|
|
|
.TP
|
|
\fBPACWRAP_HOME\fR <\fBDIR\fR>
|
|
Upon container invocation, mount the set path provided when engaging the \fB`home`\fR filesystem module.
|
|
|
|
.TP
|
|
\fBPACWRAP_ROOT\fR <\fBDIR\fR>
|
|
Upon container invocation, mount the set path provided when engaging the \fB`root`\fR filesystem module.
|
|
|
|
.TP
|
|
\fBPACWRAP_VERBOSE\fR <\fB0\fR | \fB1\fR>
|
|
Toggle verbose output during a transaction. Valid options are `1` for enablement and `0` for
|
|
disablement of verbosity.
|
|
|
|
.SS
|
|
DEFAULT\fR
|
|
.PP
|
|
For the following environment variables, contained herein are default runtime values. Any variables not
|
|
included here in this subsection are to be assumed to have inert values by default.
|
|
|
|
.TP
|
|
\fBPACWRAP_CACHE_DIR\fR
|
|
`$HOME/.cache/pacwrap`: Default cache directory.
|
|
|
|
.TP
|
|
\fBPACWRAP_CONFIG_DIR\fR
|
|
`$HOME/.config/pacwrap`: Default configuration directory.
|
|
|
|
.TP
|
|
\fBPACWRAP_DATA_DIR\fR
|
|
`$HOME/.local/share/pacwrap`: Default data directory.
|
|
|
|
.SH
|
|
AUTHOR\fR
|
|
Copyright (C) 2023-2024 Xavier R.M. <sapphirus@azorium.net>
|
|
|
|
.SH
|
|
LICENSE\fR
|
|
This program may be freely redistributed under the terms of the GNU General Public License v3 only.
|
|
|