AUR.PKGLIST(1)

NAME
aur-pkglist - retrieve AUR metadata archives

SYNOPSIS
aur pkglist [-bQiq] [-t ttl]

DESCRIPTION
aur-pkglist retrieves metadata archives from the AUR. This includes plain-text lists of available package names (packages.gz), AUR users (users.gz), package bases (pkgbase.gz), and JSON lists of all available metadata (packages-meta-v1.json, packages-meta-v1-ext.json). The JSON lists either match the output of search or info type requests; see aur-query(1).

OPTIONS

-b, --pkgbase
    Retrieve pkgbases.git/pkgbase.json.

-n, --pkgname
    Retrieve pkgnames.git/pkgname.json. This is the default.

--users
    Retrieve users.git/users.json.

-i, --info
    Retrieve metadata.git/pkgname.json.

--plain
    Print the package list to standard output.

-F, --fixed-strings
    Interpret the given pattern as a list of fixed strings, separated by newlines, any of which is to be matched.

-P, --perl-regexp
    Interpret the given pattern as a Perl-compatible regular expression (PCRE).

  List retrieval options

-q, -u, --quiet
    Update the package list and print its path to standard output.

-Q, --systime
    Use the system clock when verifying the list modification date (see --time). This option should only be used when the clock is synchronized, for example with NTP.

-t, --ttl
    A positive integer specifying the delay in seconds for retrieving list upgrades with --systime. A negative integer skips upgrades, regardless of --systime. Defaults to 600 seconds.

New lists are generated by the AUR every 10 to 15 minutes. Setting smaller intervals with -t will thus not give any new results.

-v, --verify
    Verify checksums of the compressed list with sha256sum(1).

ENVIRONMENT

AUR_LOCATION
    The URI of the AUR endpoint. Defaults to https://aur.archlinux.org.

GIT_HTTP_USER_AGENT
    This variable is set to aurutils.

NOTES
The following threads provide more background on the AUR metadata archives:

RFC for new AUR Metadata Archives format + diffs (https://gitlab.archlinux.org/archlinux/aurweb/-/issues/172),

[aur-general] New AUR Metadata Archives (https://lists.archlinux.org/pipermail/aur-general/2021-November/036659.html),

[aur-dev] Making the package list more useful (https://lists.archlinux.org/pipermail/aur-dev/2016-May/004036.html).

SEE ALSO
aur(1), curl(1), sha256sum(1)

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