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

FreeBSD Manual Pages


home | help
ZPOOL-CREATE(8)		FreeBSD	System Manager's Manual	       ZPOOL-CREATE(8)

     zpool-create -- create ZFS	storage	pool

     zpool create [-dfn] [-m mountpoint] [-o property=value]a| [-o
	   feature@feature=value] [-o compatibility=off|legacy|file[,file]a|]
	   [-O file-system-property=value]a| [-R root] [-t tname] pool vdeva|

     Creates a new storage pool	containing the virtual devices specified on
     the command line.	The pool name must begin with a	letter,	and can	only
     contain alphanumeric characters as	well as	the underscore ("_"), dash
     ("-"), colon (":"), space (" "), and period (".").	 The pool names
     mirror, raidz, draid, spare and log are reserved, as are names beginning
     with mirror, raidz, draid,	and spare.  The	vdev specification is de-
     scribed in	the Virtual Devices section of zpoolconcepts(7).

     The command attempts to verify that each device specified is accessible
     and not currently in use by another subsystem.  However this check	is not
     robust enough to detect simultaneous attempts to use a new	device in dif-
     ferent pools, even	if multihost= enabled.	The administrator must ensure,
     that simultaneous invocations of any combination of zpool replace,	zpool
     create, zpool add,	or zpool labelclear, do	not refer to the same device.
     Using the same device in two pools	will result in pool corruption.

     There are some uses, such as being	currently mounted, or specified	as the
     dedicated dump device, that prevents a device from	ever being used	by
     ZFS.  Other uses, such as having a	preexisting UFS	file system, can be
     overridden	with -f.

     The command also checks that the replication strategy for the pool	is
     consistent.  An attempt to	combine	redundant and non-redundant storage in
     a single pool, or to mix disks and	files, results in an error unless -f
     is	specified.  The	use of differently-sized devices within	a single raidz
     or	mirror group is	also flagged as	an error unless	-f is specified.

     Unless the	-R option is specified,	the default mount point	is /pool.  The
     mount point must not exist	or must	be empty, or else the root dataset
     will not be able to be be mounted.	 This can be overridden	with the -m

     By	default	all supported features are enabled on the new pool.  The -d
     option and	the -o compatibility property (e.g -o compatibility=2020) can
     be	used to	restrict the features that are enabled,	so that	the pool can
     be	imported on other releases of ZFS.

     -d	       Do not enable any features on the new pool.  Individual fea-
	       tures can be enabled by setting their corresponding properties
	       to enabled with -o.  See	zpool-features(7) for details about
	       feature properties.

     -f	       Forces use of vdevs, even if they appear	in use or specify a
	       conflicting replication level.  Not all devices can be overrid-
	       den in this manner.

     -m	mountpoint
	       Sets the	mount point for	the root dataset.  The default mount
	       point is	/pool or altroot/pool if altroot is specified.	The
	       mount point must	be an absolute path, legacy, or	none.  For
	       more information	on dataset mount points, see zfsprops(7).

     -n	       Displays	the configuration that would be	used without actually
	       creating	the pool.  The actual pool creation can	still fail due
	       to insufficient privileges or device sharing.

     -o	property=value
	       Sets the	given pool properties.	See zpoolprops(7) for a	list
	       of valid	properties that	can be set.

     -o	compatibility=off|legacy|file[,file]a|
	       Specifies compatibility feature sets.  See zpool-features(7)
	       for more	information about compatibility	feature	sets.

     -o	feature@feature=value
	       Sets the	given pool feature.  See the zpool-features(7) section
	       for a list of valid features that can be	set.  Value can	be ei-
	       ther disabled or	enabled.

     -O	file-system-property=value
	       Sets the	given file system properties in	the root file system
	       of the pool.  See zfsprops(7) for a list	of valid properties
	       that can	be set.

     -R	root   Equivalent to -o	cachefile=none -o altroot=root

     -t	tname  Sets the	in-core	pool name to tname while the on-disk name will
	       be the name specified as	pool.  This will set the default of
	       the cachefile property to none.	This is	intended to handle
	       name space collisions when creating pools for other systems,
	       such as virtual machines	or physical machines whose pools live
	       on network block	devices.

     zpool-destroy(8), zpool-export(8),	zpool-import(8)

FreeBSD	13.0			 June 2, 2021			  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help