FreeBSD Manual Pages
POUDRIERE-TESTPORT(8) System Manager's Manual POUDRIERE-TESTPORT(8) NAME poudriere testport -- test a given port's build SYNOPSIS poudriere testport [options] [-o] origin DESCRIPTION The specified port will be tested for build and packaging problems. All missing dependencies will first be built in parallel. TRYBROKEN is not automatically defined in the environment to test ports marked as BROKEN as it was in previous versions. Use -T to enable that. See "FLAVORS" in poudriere(8) for supported FLAVORS syntax. One port origin must be specified. poudriere will allow make jobs for the port being tested. See poudriere-bulk(8) for more details on make jobs. OPTIONS -B name Specify which buildname to use. By default YYYY-MM-DD_HH:MM:SS will be used. This can be used to re- sume a previous build and use the same log and URL paths. Resuming a build will not retry built/failed/skipped/ig- nored packages. -b name Specify the name of the binary package branch to use to prefetch packages. Should be "latest", "quarterly", "release_*", or url. See poudriere-bulk(8) for further details. -c Run make config for the given port. -I Advanced Interactive mode. Leaves jail running with port installed after test. When done with the jail you will need to manually shut it down: poudriere jail -k -j JAILNAME. As with -i this will install a pkg.conf(5) file for pkg(8) usage. -i Interactive mode. Enter jail for interactive testing and automatically cleanup when done. 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 FreeBSD repository will be disabled by default. -J number[:number] This argument specifies how many number jobs will run in parallel for building the dependencies. The optional sec- ond number 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. -j name Runs only inside the jail named name. -k Do not consider failures as fatal. Find all failures. -N Do not build package repository when build of dependencies is completed. -NN Do not commit, or publish, the package repository when the build is completed. This can be used to do a full test build but have the opportunity to delete it all rather than publish it. The packages will be stored in a .building directory that can be removed manually, other- wise the next build will resume from that directory. De- pends on ATOMIC_PACKAGE_REPOSITORY being set to yes. -n Dry run. Show what would be done, but do not actually build or delete any packages. -O overlay Specify an extra poudriere-ports(8) tree to use as an overlay. Multiple -O overlay arguments may be specified to stack them. -o origin Specifies an origin in the ports tree. -P Use custom prefix. -p tree Specifies which ports tree to use. (Default: "default") -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 the port, even if marked BROKEN, by defining TRYBROKEN for the build. Dependencies marked BROKEN will not be built. -v This will show more information 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 "CUSTOMIZATION" in poudriere(8) for examples of how this is used. ENVIRONMENT POUDRIERE_INTERACTIVE_NO_INSTALL If specified, the package is not in- stalled in interactive mode. 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-ports(8), poudriere-queue(8), poudriere-status(8), poudriere-version(8) AUTHORS Baptiste Daroussin <bapt@FreeBSD.org> Bryan Drewery <bdrewery@FreeBSD.org> FreeBSD ports 15.1 December 2, 2025 POUDRIERE-TESTPORT(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=poudriere-testport&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports>