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

FreeBSD Manual Pages

  
 
  

home | help 
ZFSBOOTCFG(8)		    System Manager's Manual		 ZFSBOOTCFG(8)

NAME
       zfsbootcfg -- specify zfsboot options for the next boot

SYNOPSIS
       zfsbootcfg <options>
       zfsbootcfg [-n name] [-k	key] [-p] [-t type] [-v	value] [-z pool]
       zfsbootcfg

DESCRIPTION
       zfsbootcfg  is  used  to	set boot.config(5)-style options to be used by
       zfsboot(8), gptzfsboot(8) or loader(8) the next	time  the  machine  is
       booted.	Once zfsboot(8)	or gptzfsboot(8) or loader(8) reads the	infor-
       mation, it is deleted.  If booting fails, the machine automatically re-
       verts to	the previous boot configuration.  The information is stored in
       a special boot environment area of a ZFS	pool.

       If used without arguments, zfsbootcfg will output the current boot con-
       figuration, if set.

       The following options are supported by zfsbootcfg:

       -k key  Define key for <key, value> pair.

       -n name
	       Update nvlist name.

       -p      Print all information stored in ZFS pool	bootenv	area.

       -t type
	       Set  type  of  value used in <key, value> pair.	Currently sup-
	       ported types are:
	       DATA_TYPE_BYTE
	       DATA_TYPE_INT8
	       DATA_TYPE_UINT8
	       DATA_TYPE_INT16
	       DATA_TYPE_UINT16
	       DATA_TYPE_INT32
	       DATA_TYPE_UINT32
	       DATA_TYPE_INT64
	       DATA_TYPE_UINT64
	       DATA_TYPE_BOOLEAN_VALUE
	       DATA_TYPE_STRING

	       If not specified, the default is	DATA_TYPE_STRING.

       -v value
	       Define value for	<key, value> pair.

       -z pool
	       Operate on pool.

ENVIRONMENT
       vfs.root.mountfrom  The kenv(1) variable	that  identifies  a  pool  for
			   which the options are written.

EXAMPLES
       Try to boot to a	new boot environment without changing the bootfs prop-
       erty of a pool:

	     zfsbootcfg	"zfs:tank/ROOT/newbe:"

       To clear	the boot options:

	     zfsbootcfg	""

SEE ALSO
       boot.config(5), bectl(8), gptzfsboot(8),	loader(8), zfsboot(8)

HISTORY
       zfsbootcfg appeared in FreeBSD 11.1.

AUTHORS
       This manual page	was written by Andriy Gapon <avg@FreeBSD.org>.

FreeBSD	13.2			 July 22, 2020			 ZFSBOOTCFG(8)
NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | EXAMPLES | SEE ALSO | HISTORY | AUTHORS

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

home | help