NAME

SYNOPSIS

DESCRIPTION

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

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

-M mountpoint

Path to the source of a ports tree.

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

Use the -B branch parameter to set the branch name. The Git server address is derived from the GIT_PORTSURL variable in poudriere.conf. -U url may be used to override that value.

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.

-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

AUTHORS