NAME

poudriere testport — test a given port's build

SYNOPSIS

DESCRIPTION

The specified port will be tested for build and packaging problems. All missing dependencies will first be built in parallel. TRYBROKEN=yes is automatically defined in the environment to test ports marked as BROKEN. 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 resume a previous build and use the same log and URL paths. Resuming a build will not retry built/failed/skipped/ignored 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 second 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 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, otherwise the next build will resume from that directory. Depends 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.

-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 installed 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⟩