AUR.PKGLIST(1)

NAME
aur-pkglist - retrieve AUR metadata archives

SYNOPSIS
aur pkglist [-biqsvJFP] [-t ttl] [pattern]

DESCRIPTION
aur-pkglist retrieves metadata archives from the AUR. This includes plain-text lists of available package names (packages.gz), AUR users (users.gz), and package bases (pkgbase.gz) and JSON lists of all available metadata (packages-meta-v1.json, packages-meta-v1-ext.json).

Metadata either matches the output of search or info type requests; see aur-query(1). A pcrepattern(3) may be specified for plain-text lists, and a jq(1) pattern for JSON lists.

If no options are specified, aur-pkglist defaults to retrieving packages.gz.

OPTIONS

-b, --pkgbase
    Retrieve pkgbase.gz instead of packages.gz.

--users
    Retrieve users.gz instead of packages.gz.

-i, --info
    Retrieve AUR metadata from search-type requests.

-s, --search
    Retrieve AUR metadata from info-type requests.

  Pattern options

--plain
    Print the package list to standard output. This is the default for packages.gz, pkgbase.gz, and users.gz.

-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).

-, --json
    Interpret the given pattern as a jq(1) expression. This is the default for --info and --search.

  List retrieval options

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

-t, --ttl
    Set the delay in seconds before a new list is retrieved. Defaults to 300 seconds.

    Note: aur-pkglist checks the HTTP Last-Modified property before retrieval. New lists are generated by the AUR every 5 minutes; setting a lower interval with -t thus has no benefit.

--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.

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

ENVIRONMENT

AUR_METADEST
    The directory used for storing metadata archives. Defaults to $XDG_CACHE_HOME/aurutils/pkglist.

NOTES
See the following threads for more information about the development of AUR metadata archives:

[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), aur-query(1), curl(1), jq(1), pcregrep(1)

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