FreeBSD manual

download PDF document: poudriere-bulk.8.pdf

POUDRIERE-BULK(8) FreeBSD System Manager's Manual POUDRIERE-BULK(8)
NAME poudriere-bulk - build a ready-to-export package tree
SYNOPSIS poudriere bulk -a -j name [-CcFIikNnRrSTtvw] [-B name] [-J maxjobs[:prebuildmaxjobs]] [-p tree] [-z set] poudriere bulk -f file [[-f file2] ...] -j name [-CcFIikNnRrSTtvw] [-B name] [-J maxjobs[:prebuildmaxjobs]] [-p tree] [-z set] poudriere bulk -j name [-CcFIikNnRrSTtvw] [-B name] [-J maxjobs[:prebuildmaxjobs]] [-p tree] [-z set] origin [origin2 ...]
DESCRIPTION This command makes a ready-to-export package tree, and fills it with binary 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 binary packages with options that differ from defaults.
poudriere will disable make jobs for packages not listed in ALLOW_MAKE_JOBS_PACKAGES, unless ALLOW_MAKE_JOBS is set in poudriere.conf. The number of jobs can be controlled in make.conf with the ports(7) flags MAKE_JOBS_NUMBER and MAKE_JOBS_NUMBER_LIMIT. Beware that there is no global job control so each builder created from -J (or the default PARALLEL_JOBS) will spawn as many jobs as the ports framework allows.
SUBCOMMANDS -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 specified in the form of "category/port" and sh(1)-style comments are allowed. Multiple -f file arguments may be specified at once.
OPTIONS -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 mirrors.
-i Interactive mode.
Open an interactive shell session in the jail after the build is
-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 jail.
Similarly to -i, the -I flag will cause pkg.conf(5) to be installed 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.
-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 automatically set when using -at.
-S Do not recursively rebuild packages affected by other packages requiring incremental rebuild. This may result in broken packages if the ones they depend on are updated, are not ABI- compatible, 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. 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 ${POUDRIERE_DATA}/wrkdirs.
-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.
EXAMPLES 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)
AUTHORS Baptiste Daroussin <bapt@FreeBSD.org> Bryan Drewery <bdrewery@FreeBSD.org>
FreeBSD 14.0-RELEASE-p11 March 10, 2019 FreeBSD 14.0-RELEASE-p11