.Dd May 2023
.Dt PORTZAP 8
.Os
.Sh NAME
.Nm portzap
.Nd manage the HardenedBSD ports tree
.Sh SYNOPSIS
.Nm portzap clone
.Nm portzap pull
.Nm portzap install
.Sh DESCRIPTION
The
.Nm portzap
utility is designed to allow unprivileged users
who are members of the
.B _portzap
group to create and update a
transient copy of the ports tree, which can then be installed
into the
.Pa /usr/ports
directory by root.
.Sh EXAMPLES
The following examples demonstrate the usage of
.Nm portzap
utility:
.Pp
.Nm portzap clone
.br
Clones the ports tree into
.Pa /home/_portzap/ports .
.Pp
.Nm portzap pull
.br
Pulls updates into
.Pa /home/_portzap/ports .
.Pp
.Nm portzap install
.br
Installs
.Pa /home/_portzap/ports
into
.Pa /usr/ports .
.Sh ENVIRONMENT VARIABLES
The following variables can be used:
.Pp
.Bl -tag -width $PORTZAP_PORTS_URL
.It Ev PORTZAP_PORTS_URL
The URL to a git repository.
Defaults to https://git.hardenedbsd.org/hardenedbsd/ports.git.
.It Ev PORTZAP_PORTS_DIR
The directory where the ports collection will be installed.
Defaults to
.Pa /usr/ports.
.Sh AUTHORS
The
.Nm portzap
utility and this manual page were written by
0x1eef <0x1eef@protonmail.com>.