Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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.  De-
		    faults 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 ex-
				    isting 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.  (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
     poudriere(8), poudriere-bulk(8), poudriere-distclean(8),
     poudriere-image(8), poudriere-jail(8), poudriere-logclean(8),
     poudriere-options(8), poudriere-pkgclean(8), poudriere-queue(8),
     poudriere-status(8), poudriere-testport(8), poudriere-version(8)

AUTHORS
     Baptiste Daroussin	<bapt@FreeBSD.org>
     Bryan Drewery <bdrewery@FreeBSD.org>

FreeBSD	13.0			April 26, 2021			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | SUBCOMMANDS | OPTIONS | EXAMPLES | ENVIRONMENT | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=poudriere-ports&sektion=8&manpath=FreeBSD+Ports+13.0>

home | help