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

FreeBSD Manual Pages


home | help
POUDRIERE-BULK(8)	FreeBSD	System Manager's Manual	     POUDRIERE-BULK(8)

     poudriere-bulk -- build a ready-to-export package tree

     poudriere bulk -a -j name [-CcFIikNnRrSTtvw] [-B name]
	       [-J maxjobs[:prebuildmaxjobs]] [-O overlays] [-p	tree] [-z set]
     poudriere bulk -f file [[-f file2]	...] -j	name [-CcFIikNnRrSTtvw]
	       [-B name] [-J maxjobs[:prebuildmaxjobs]]	[-O overlays]
	       [-p tree] [-z set]
     poudriere bulk -j name [-CcFIikNnRrSTtvw] [-B name]
	       [-J maxjobs[:prebuildmaxjobs]] [-O overlays] [-p	tree] [-z set]
	       origin [origin2 ...]

     This command makes	a ready-to-export package tree,	and fills it with bi-
     nary packages built from a	given list of ports.  During the build,	hit ^T
     to	send SIGINFO and show stats and	progress about the build.

     See the FLAVORS section in	poudriere(8) for supported flavors syntax.

     See the CUSTOMIZATION section in poudriere(8) to learn how	to build bi-
     nary packages with	options	that differ from defaults.

     -a	      Build all	ports in the tree with all flavors.

     -f	file  Build ports listed in the	file.

	      The path to the file has to be absolute.	Ports must be speci-
	      fied in the form of "category/port" and sh(1)-style comments are
	      allowed.	Multiple -f file arguments may be specified at once.

     -B	name  Specify which buildname to use.  By default YYYY-MM-DD_HH:MM:SS
	      will be used.  This can be used to resume	a previous build and
	      use the same log and URL paths.  Resuming	a build	will not retry
	      built/failed/skipped/ignored packages.

     -C	      Clean only the packages specified	on the command line or in the
	      file given by -f file.  Implies -c for -a.

     -c	      Clean all	previously built packages and logs.

     -F	      Fetch only from the original MASTER_SITES.  Skip FreeBSD mir-

     -i	      Interactive mode.

	      Open an interactive shell	session	in the jail after the build is
	      done and before the clean-up.  It	is a convenient	way to do some
	      additional testing.

	      A	local pkg.conf(5) repository configuration will	be installed
	      to ${LOCALBASE}/etc/pkg/repos/local.conf so that pkg(8) can be
	      used with	any existing packages built for	the jail.  The default
	      FreeBSD repository will be disabled by default.

     -j	name  Run the bulk build on the	jail named name.

     -J	maxjobs[:prebuildmaxjobs]
	      Specify the number of jobs that will run in parallel for a bulk
	      build.  The optional second parameter, prebuildmaxjobs, is the
	      number of	jobs used for the steps	before the build, they are
	      more IO bound than CPU bound, so you may want to use a different
	      number.  The default pre-build value is 1.25 times the value of
	      the build	value.

     -I	      Advanced interactive mode.

	      Leave the	jail running with ports	installed after	building and
	      testing.	It is a	convenient way to do some additional testing.
	      See poudriere-jail(8) to learn how to stop a running poudriere

	      Similarly	to -i, the -I flag will	cause pkg.conf(5) to be	in-
	      stalled in the jail.

     -k	      Do not consider failures to be fatal when	using -t.  Do not skip
	      dependent	ports on findings.  This flag is automatically set
	      when using -at.

     -N	      Do not build a package repository	when the build is completed.

     -n	      Dry run.	Show what would	be done, but do	not actually build or
	      delete any packages.

     -O	overlays
	      Specify extra ports trees	to overlay.

     -p	tree  Specify on which ports tree the bulk build will be done.

     -R	      Clean RESTRICTED packages	after building.

     -r	      Recursively test all dependencies	as well.  This flag is auto-
	      matically	set when using -at.

     -S	      Do not recursively rebuild packages affected by other packages
	      requiring	incremental rebuild.  This may result in broken	pack-
	      ages if the ones they depend on are updated, are not ABI-compat-
	      ible, and	were not properly PORTREVISION bumped.

     -T	      Try building BROKEN ports	by defining TRYBROKEN for the build.

     -t	      Add some testing to the specified	ports.	Add -r to recursively
	      test all port dependencies as well.  Currently, the behavior is
	      to uninstall a port, and to disable parallel jobs	for make(1).
	      When used	with -a	then -rk are implied.

     -v	      Enable additional	information to be shown	during the build.
	      Specify twice to enable debug output.

     -w	      Save WRKDIR on build failure.  The WRKDIR	will be	tarred up into

     -z	set   This specifies which SET to use for the build.  See the
	      CUSTOMIZATION section in poudriere(8) for	examples of how	this
	      is used.

     Example 1:	Starting a Bulk	Build

       The following example starts a bulk build of two	ports.

	 # poudriere bulk accessibility/sct www/firefox

     poudriere(8), poudriere-distclean(8), poudriere-image(8),
     poudriere-jail(8),	poudriere-logclean(8), poudriere-options(8),
     poudriere-pkgclean(8), poudriere-ports(8),	poudriere-queue(8),
     poudriere-status(8), poudriere-testport(8), poudriere-version(8)

     Baptiste Daroussin	<>
     Bryan Drewery <>

FreeBSD	13.0		       December	9, 2019			  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help