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  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 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 14.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+14.3.quarterly>

home | help