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=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 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.

       -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.quarterly	August 9, 2024		 POUDRIERE-TESTPORT(8)

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

home | help