AUR-QUERY(1)

NAME
aur-query - send requests to the aurweb RPC interface

SYNOPSIS
aur query [-t type] [-b by] [-n] pkgname [pkgname...]

DESCRIPTION
aur-query retrieves package information from an AUR endpoint by sending HTTP POST requests to the RPC interface (https://aur.archlinux.org/rpc.php) with curl(1).

Arguments are taken from the command-line. If the first argument is - or /dev/stdin, arguments are taken from standard input. JSON responses are delimited by newlines (JSON Lines).

OPTIONS
The request type and arguments must be compatible to the chosen RPC version (see the AUR_QUERY_RPC_VERSION environment variable). The options below assume RPC v5.

-b, --by=<KIND>
    Arguments for package search (--type=search). Can be one of name, name-desc, maintainer, depends, makedepends, optdepends, or checkdepends.

-t, --type=<NAME>
    Type of request. Can be one of search, info, or suggest.

EXIT STATUS
aur-query returns 0 if no errors occurred, 1 if an invalid option or no arguments were supplied, and 2 on a curl(1) error.

ENVIRONMENT

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

AUR_QUERY_RPC
    The URI of the RPC interface. Defaults to $AUR_LOCATION/rpc/?v=5.

AUR_QUERY_RPC_SPLITNO
    The amount of packages in the message body when using HTTP POST for info-type requests. Defaults to 5000. This value should not be set higher than 5000, the maximum amount of package results in an info request.

AUR_QUERY_RPC_VERSION
    The version for the RPC endpoint. Defaults to 5.

AUR_DEBUG
    Display curl(1) command-lines prior to running them.

NOTES
The default set of options for curl(1) are -A aurutils -fgLsSq.

SEE ALSO
aur-depends(1), aur-search(1), aur-vercmp(1), curl(1),

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