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

FreeBSD Manual Pages

  
 
  

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

NAME
       bectl --	Utility	to manage boot environments on ZFS

SYNOPSIS
       bectl [-h?]
       bectl [-r beroot] activate [-t |	-T] beName
       bectl [-r beroot] check
       bectl  [-r  beroot]  create  [-r]  [-e {nonActiveBe | beName@snapshot}]
	     newBeName
       bectl [-r beroot] create	[-r] beName@snapshot
       bectl [-r beroot] destroy [-Fo] beName[@snapshot]
       bectl [-r beroot] export	sourceBe
       bectl [-r beroot] import	targetBe
       bectl [-r beroot] jail  [-bU]  [{-o  key=value  |  -u  key}]...	beName
	     [utility [argument	...]]
       bectl  [-r  beroot]  list  [-aDHs]  [-c	property]  [-C	property] [{-c
	     property |	-C property}]
       bectl [-r beroot] mount beName [mountpoint]
       bectl [-r beroot] rename	origBeName newBeName
       bectl [-r beroot] {ujail	| unjail} {jailId | jailName | beName}
       bectl [-r beroot] {umount | unmount} [-f] beName

DESCRIPTION
       The bectl command is used to setup and interact with ZFS	boot  environ-
       ments, which are	bootable clones	of datasets.

       A  boot	environment allows the system to be upgraded, while preserving
       the pre-upgrade system environment.

       bectl itself accepts an -r flag specified before	the command  to	 indi-
       cate  the  beroot  that should be used as the boot environment root, or
       the dataset whose children are all boot	environments.	Normally  this
       information  is	derived	 from  the bootfs property of the pool that is
       mounted at /, but it is useful when the system has not been booted into
       a ZFS root or a different pool should be	operated  on.	For  instance,
       booting	into the recovery media	and manually importing a pool from one
       of the system's resident	disks will require the -r flag to work.

   Supported Subcommands and Flags

NAME | SYNOPSIS | DESCRIPTION

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

home | help