ACONFMGR(1)

NAME
aconfmgr - a configuration manager for Arch Linux

SYNOPSIS
aconfmgr [OPTIONS] save | apply | check | diff

DESCRIPTION
aconfmgr is a package to track, manage, and restore the configuration of an Arch Linux system. For a detailed description, please see the full documentation: https://github.com/CyberShadow/aconfmgr#readme

ACTIONS

save
    Update the configuration to reflect the current state of the system.

apply
    Update the system to reflect the current contents of the configuration.

check
    Syntax-check and lint the configuration.

diff
    Display a comparison between files in the configuration and the system. This action takes a list of absolute paths, or additional options to pass to diff, as arguments following the action name.

OPTIONS

-h, --help
    Output a usage message and exit.

-c, --config DIR
    Set the path to the configuration directory. This directory will contain the configuration that the save command will write to, and the apply command will read from, respectively. See also FILES below.

--skip-config
    Skip the configuration parsing step, and reuse results from previous run.

--skip-inspection
    Skip the system inspection step, and reuse results from previous run.

--skip-checksums
    Skip the checksum verification of files belonging to installed packages. When enabled, changes to a package's files are still detected through modification time, size and other properties. Enabling this option is generally safe and greatly speeds up execution speed, but can fail to detect changes to a file's contents in exceptional circumstances, such as filesystem corruption, intentional manipulation or badly behaved programs.

--aur-helper HELPER
    Set the AUR helper to use for installing foreign packages. Supported values are aurman, pacaur, yaourt, yay, paru, aura, and makepkg (for which aconfmgr will download, resolve dependencies, and build/install itself).

--color WHEN
    When to use colors in output (always/auto/never). If unset or set to auto, aconfmgr will use color when the output is determined to be a TTY. If set, it is propagated appropriately to invoked programs.

--paranoid
    Always prompt before making any changes to the system. The default is to not prompt when executed commands would themselves show a prompt before performing changes. This option is mutually exclusive with --yes. If set, it is propagated appropriately to invoked programs.

--yes
    Never prompt before making any changes to the system. This option is mutually exclusive with --paranoid. If set, it is propagated appropriately to invoked programs.

-v, --verbose
     Show progress with additional detail.

FILES

~/.config/aconfmgr
    Default location of configuration directory (can be overridden with -c). The default location is affected by the $XDG_CONFIG_HOME and $HOME environment variables. It may be set directly by the $ACONFMGR_CONFIG environment variable.

/tmp/aconfmgr-USER
    Temporary directory, used for intermediary system state and configuration output data, and other temporary files. The location is affected by the $TMPDIR environment variable.

ENVIRONMENT VARIABLES

$HOME
    Affects the default location of the configuration directory.

$PACMAN
    The command that will be used to check for missing dependencies and to install and remove packages. pacman's -Qq, -Rns, -S, -T, and -U operations must be supported by this command. If the variable is not set or empty, aconfmgr will fall back to 'pacman'.

$TMPDIR
    Affects the default location of the temporary directory.

$XDG_CONFIG_HOME
    Affects the default location of the configuration directory.

$ACONFMGR_CONFIG
    Sets the location of the configuration directory.

BUGS
Please report defects and enhancement requests to the GitHub issue tracker: https://github.com/CyberShadow/aconfmgr/issues

AUTHORS
aconfmgr is written by Vladimir Panteleev <aconfmgr@thecybershadow.net> and contributors: https://github.com/CyberShadow/aconfmgr/graphs/contributors