pacwrap/docs/config.md

4.2 KiB

Pacwrap Configuration Directives

This document was generated by the pacwrap binary with version 0.8.4-43de5c7-RELEASE (14/09/2024) of the program.

NAME

pacwrap.yml - pacwrap configuration file.

repositories.conf - pacman repository file.

SYNOPSIS

~/.config/pacwrap/pacwrap.yml

~/.config/pacwrap/repositories.conf

DESCRIPTION

Pacwrap upon invocation will attempt to deserialise pacwrap.yml(2) at the location specified herein compliant with the XDG Directory Specification. Upon activation of libalpm(3), the repositories.conf file will be deserialised by the pacman_conf crate in order to faciliate the population of package repositories and mirrors.

Repository configuration is parsed using pacman.conf(5)'s ini format. All other options related the libalpm(3) as defined by pacman.conf(5) therein are otherwise ignored. At present by default, the repository configuration, as defined, references the mirrorlist defined by your system. This ensures as smooth of an out-of-box experience as humanly possible.

Optionally you may specify environment variables, as specified in pacwrap(1), to override these locations. These options are designated for experienced users only.

EXAMPLE

config:
  logging: Basic
  summary: Table
  progress:
    transact: CondensedForeign
    download: CondensedForeign
alpm:
  ignore_pkg:
  - nvidia-utils
  - lib32-nvidia-utils

SECTIONS

config:

Configuration pertaining to pacwrap(1) are to be declared within this section.

alpm:

Configuration pertaining to libalpm(3) are to be declared within this section.

CONFIG

logging: Basic

Logging verbosity specified here. Available options are Basic, Verbose, and None.

summary: Basic

Transaction summary type. Available options are Basic, BasicForeign, Table, and TableForeign.

Each option suffixed with the Foreign juxtaposition, will take effect only during the juxtaposed transaction type with otherwise the opposite effect.

progress:

Progress types are declared within this subsection.

PROGRESS

transact: CondensedForeign

Progress type for transaction progress is specified with this option. Available values are Basic, Condensed, CondensedForeign, CondensedLocal, and Verbose.

Each option suffixed with the Foreign or Local juxtaposition, will take effect only during the juxtaposed transaction type with otherwise the opposite effect.

download: Verbose

Download type for download progress is specified with this option. Available values are Basic, Condensed, CondensedForeign, CondensedLocal, and Verbose.

Each option suffixed with the Foreign or Local juxtaposition, will take effect only during the juxtaposed transaction type with otherwise the opposite effect.

ALPM

ignore_pkg:

Ignored package(s) are declared herein with a string array.

hold_pkg:

Held package(s) are declared herein with a string array.

sig_level: Required DatabaseOptional

Default global signature level - see pacman.conf(5) for valid options. Options are declared as a singular string value.

sig_level_local: Optional

Default local signature level - see pacman.conf(5) for valid options. Options are declared as a single string value.

check_space: true

Instructs libalpm(3), where applicable, to check if there's available space on disk in order to facilitate a transaction. Value is declared with a bool.

download_timeout: true

Instructs libalpm(3) to timeout downloads from unsatisfactory mirrors. Value is declared with a bool.

parallel_downloads: 1

Instructs libalpm(3) to parallelise the download queue with a maximum queue amount. Specify an integer to declare a maximum value.

disable_sandbox: false

Instructs libalpm(3) to disable the landlock and seccomp sandbox for downloads. Specify a bool to declare a maximum value.

SEE ALSO

pacman.conf(5), libalpm(3)

AUTHOR

Copyright (C) 2023-2024 Xavier Moffett sapphirus@azorium.net

This program may be freely redistributed under the terms of the GNU General Public License v3 only.