PORTROACH-CLI(1)

NAME
portroach-cli - query portroach

SYNOPSIS
portroach-cli [-Ujo] [-m maintainer [-p pkgpath]] [-u url]

DESCRIPTION
portroach-cli queries a portroach(1) instance for ports.

It can filter results and prints them on standard output similar to portroach's web interface.

The options are as follows:

-U  Short form of -m “the OpenBSD ports mailing-list <ports@openbsd.org>”, i.e. show unmaintained ports.

-j  Print results in raw JSON format.

-o  Show outdated ports.

-m maintainer
    Show ports whose MAINTAINER value matches the case-insensitive basic regular expression maintainer, see bsd.port.mk(5).

-p pkgpath
    Show ports whose BASE_PKGPATH value matches the case-insensitive basic regular expression pkgpath, see bsd.port.mk(5).

-u url
    Query the portroach instance at url. Default to https://portroach.openbsd.org.

EXAMPLES
Show all ports without specific maintainer for which an update is available:

    $ portroach-cli -U -o

Show all ports maintained by John Doe which are in the “sysutils” category:

    $ portroach-cli -m doe@ -p ^sysutils/

Get all outdated ports in a category but defer processing to an external filter:

    $ portroach-cli -j -o -m. -p ^sysutils/ | jq -s -f ./filter

SEE ALSO
portroach(1), bsd.port.mk(5)

AUTHORS
Klemens Nanni <kn@openbsd.org>