FreeBSD manual

download PDF document: poudriere-ports.8.pdf

POUDRIERE-PORTS(8) FreeBSD System Manager's Manual POUDRIERE-PORTS(8)
NAME poudriere ports - manage ports trees
SYNOPSIS poudriere ports subcommand [options]
DESCRIPTION This command provides management of different ports trees which will be used by poudriere.
One subcommand must be supplied.
SUBCOMMANDS -c Creates a ports tree.
-d Deletes a ports tree.
-l List all available ports trees.
-u Update a ports tree.
OPTIONS Except for -l, all of the subcommands require the -p switch (see below).
-B branch Specifies which branch to checkout when using the git or svn methods.
-F When used with -c, only create the needed file systems (for ZFS) and directories, but do not populate them.
-f filesystem The name of the filesystem to create for the ports tree. If set to "none" then do not create a filesystem. Defaults to "poudriere/ports/default".
-k When used with -d, only unregister the ports tree without removing the files.
-M mountpoint Path to the source of a ports tree.
-m method Specify which method to use to create the ports tree. The default is git+https.
portsnap Uses portsnap(8) (deprecated).
null This option can be used to import an existing directory that already contains a manually managed ports tree. The path must be specified with -M path. The path will be null-mounted during builds.
git[+protocol] Use Git to download the sources.
Sources will be cloned shallowly unless -D is specified.
Output will mostly be hidden unless poudriere -v ports, or -v, are used. The following protocols are supported: git (default), +http, +https, +file, +ssh.
svn[+protocol] Use SVN to download the sources.
Output will mostly be hidden unless poudriere -v ports, or -v, are used.
Use the -B branch parameter to set the branch name.
The SVN host address is derived from the SVN_HOST variable in poudriere.conf. -U url may be used to override that value.
The following protocols are supported: svn (default), +http, +https, +file, +ssh.
-n When combined with -l, only display the name of the ports tree.
-p name Specifies the name of the ports tree to use. (Default: "default")
-q When used with -l, remove the header in the list view.
-U url Specifies which url to checkout from when using the git or svn methods.
-v Show more verbose output.
EXAMPLES Creates a new checkout from Git called default from FreeBSD's official ports tree branch main.
# poudriere ports -c
Creates a new checkout from Git called quarterly from FreeBSD's official ports tree branch 2021Q1.
# poudriere ports -c -p quarterly -B 2021Q1
Updates ports tree named quarterly.
# poudriere ports -u -p quarterly
Import a local manually-managed ports tree named local from /usr/ports.
# poudriere ports -c -p local -m null -M /usr/ports
ENVIRONMENT FETCH_BIND_ADDRESS The bind address used by fetch(1). See fetch(3) for more details.
HTTP_PROXY HTTP_* http_* FTP_PROXY FTP_* http_* SSL_* NO_PROXY no_proxy The proxy configuration for fetch(1). See fetch(3) for other supported proxy environment variables.
SEE ALSO Bryan Drewery <bdrewery@FreeBSD.org>
FreeBSD 14.2-RELEASE April 26, 2021 FreeBSD 14.2-RELEASE