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

FreeBSD Manual Pages

  
 
  

home | help
POUDRIERE-IMAGE(8)	FreeBSD	System Manager's Manual	    POUDRIERE-IMAGE(8)

NAME
     poudriere-image --	build OS filesystem images

SYNOPSIS
     poudriere [poudriere-options] image [options]

DESCRIPTION
     Builds a filesystem image per the specified options.

     WARNING: This feature is still considered ALPHA.

OPTIONS
     -c	overlaydir   This specifies an extra directory whose contents will be
		     copied directly into the final image, starting from the
		     root.

     -f	packagelist  This specifies a list of packages to be pre-installed in
		     the final image.

     -h	hostname     This specifies the	hostname used for the image.  Defaults
		     to	poudriere-image.

     -i	originimage  Path to a previously built	full.img.gz.

     -j	name	     This argument specifies the name of the jail that is
		     used.

     -m	overlaydir   Build a miniroot image as well (for tar type images), and
		     copy this directory into the miniroot image.

     -n	name	     This specifies the	name of	the resulting image.

     -o	outputdir    This argument specifies directory where the resulting im-
		     age will be created.

     -p	tree	     This argument specifies the name of the ports tree	that
		     is	used.

     -s	size	     This specifies the	maximum	size of	the image that is
		     built.

     -S	snapshotname
		     Name of the snapshot for zsnapshot	type.

     -t	type	     This specifies the	type of	image to create:

		     iso	  An ISO 9660 format image.

		     iso+mfs	  An ISO 9660 format image where the root
				  filesystem is	MFS mounted.

		     iso+zmfs	  An ISO 9660 format image where the root
				  filesystem is	LZ77 compressed	and is MFS
				  mounted.

		     usb	  A GPT-layout prepared	UFS2 image containing
				  a UEFI boot loader.

		     usb+mfs	  A GPT-layout prepared	UFS2 image containing
				  a UEFI boot loader where the root filesystem
				  is MFS mounted.

		     usb+zmfs	  A GPT-layout prepared	UFS2 image containing
				  a UEFI boot loader where the root filesystem
				  is LZ77 compressed and is MFS	mounted.

		     rawdisk	  A raw	UFS2, softupdates-enabled, disk	image.

		     zrawdisk	  A raw	ZFS disk image.

		     tar	  An XZ-compressed tarball.

		     firmware	  A NanoBSD style image	with a GPT partitions
				  and a	UEFI boot loader.

		     rawfirmware  A raw	disk image.

		     embedded	  Create a u-boot ready	embedded image.

		     zsnapshot	  Create a zfs snapshot	full and incremental
				  to be	used in	a jail.

     -X	excludefile  This specifies a list of files to exclude from the	final
		     image.

     -z	set	     This specifies which SET to use for the build.

SEE ALSO
     poudriere(8), poudriere-bulk(8), poudriere-distclean(8),
     poudriere-jail(8),	poudriere-logclean(8), poudriere-options(8),
     poudriere-pkgclean(8), poudriere-ports(8),	poudriere-queue(8),
     poudriere-status(8), poudriere-testport(8), poudriere-version(8)

AUTHORS
     Baptiste Daroussin	<bapt@FreeBSD.org>
     Bryan Drewery <bdrewery@FreeBSD.org>

FreeBSD	13.0			 March 8, 2018			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=poudriere-image&sektion=8&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help