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

FreeBSD Manual Pages

  
 
  

home | help
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 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  in-
		  stalled  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) us-
		  age.

     -i 	  Interactive mode.  Enter jail for interactive testing and  au-
		  tomatically 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  par-
		  allel  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, 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, otherwise the next build will resume
		  from that directory.	Depends on ATOMIC_PACKAGE_REPOSITORY be-
		  ing 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-im-
     age(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.quarterly	December 2, 2025	   POUDRIERE-TESTPORT(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=poudriere-testport&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help