AUR-REPO(1)

NAME
aur-repo - manage local repositories

SYNOPSIS
aur repo [--list] [--table] [--upgrades]
aur repo [-c file] [-d name] [-r path] [-F field] [-aqS]

DESCRIPTION
aur-repo helps manage local (file://) pacman(8) repositories. In particular, it serves to parse repository contents (--list, --table), compare package versions to the AUR (--upgrades), and list local repository file paths (--list-path).

If pacman.conf(5) contains only a single local repository, aur-repo selects it automatically. If multiple local repositories are configured, they must specified explicitly with the -d option.

OPERATIONS

--status
    Print status information to a standard output, in the following format:

    repo:<repository name>
    root:<root of repository>
    path:<path of repository>

Unless --missing is specified, root and path must be existing paths. This is the default operation.

-f FORMAT, --format=FORMAT
    Transform the contents of the local repository with aur-format(1).

-F FIELD, --field=FIELD, --attr=FIELD
    List the attribute FIELD for all packages in the local repository. May be one of filename, name, base, version, desc, url, license, arch, builddate, packager, conflicts, provides, depends, makedepends, optdepends, or any other valid fields generated by repo-add(1).

-l, --list
    List the contents of a local repository in the following format:

    pkgname\tpkgver\n

--list-field
    List valid fields in a local repository generated by repo-add(1). See --field.

--list-path
    List the paths of configured local repositories.

    Unless --missing is specified, all paths must exist.

--path
    List the resolved path of the selected pacman(8) repository.

    Unless --missing is specified, the path must exist.

--list-repo
    List the names of configured local repositories.

-t, --table
    List the contents of a local repository in the following format:

    pkgname\tdepends\tpkgbase\tpkgver\n .

    If a package has no dependencies pkgname is used as depends, otherwise missing values are represented by -. See also --table in aur-depends(1)

-u, --upgrades
    Check package updates with aur-vercmp(1)

-J, --json
    Output repository contents as JSON. (aur-repo-parse--json).

--jsonl
    Output repository contents as JSON Lines. (aur-repo-parse--jsonl).

OPTIONS

-c FILE, --config=FILE
    Specify an alternate pacman(8) configuration file.

-d NAME, --database=NAME
    The name of a pacman(8) repository.

    The repository should have a file:// location, or any other location when using --sync.

-r PATH, --root=PATH
    The path to the root of a local pacman(8) repository.

--delim SEP
    The delimiter for expanding arrays with --format.

-s REGEXP, --search=REGEXP
    Limit results to matches specified by PATTERN.

--search-by=FIELD
    The field (see --field) matched on with --search. Defaults to name. If FIELD corresponds to an array value such as depends, at least one value in the array should match.

-i PATTERN, --ignore=PATTERN
    Ignore results with matches specified by PATTERN.

--ignore-by=FIELD
    The field matched on witch --ignore. Defaults to name.

-a, --all
    Use aur-vercmp --all when checking for upgrades. Implies --upgrades.

-q, --quiet
    Only print package names when listing the repository (--list) or checking for upgrades (--upgrades).

-S, --sync
    Query repositories in DBPATH/sync (defaults to /var/lib/pacman/sync) instead of by their file:// path.

-m, --missing
    Do not require paths to exist with --status, --path and --list-path.

EXAMPLES
List information on configured local repositories:

      $ aur repo --repo-list | while read -r repo; do
            printf '[%s]\n' "$repo"
            pacconf --repo="$repo"
        done

ENVIRONMENT

AUR_REPO
    The name of a pacman repository, see -d.

AUR_DBROOT
    The path to the root of a local repository, see -r.

AUR_DBEXT
    The extension of the local repository. Defaults to .db.

SEE ALSO
aur(1), aur-depends(1), aur-vercmp(1), pacman.conf(5), pacman(8)

AUTHORS
Alad Wenter (https://github.com/AladW)