illumos-gate-beadm Cdiff usr/src/man/man1m/beadm.1m

Print this page

2447 beadm should be more descriptive about some errors


*** 4,61 ****
  .SH NAME
  beadm \- utility for managing zfs boot environments
  .SH SYNOPSIS
  .LP
  .nf
! \fBbeadm\fR create [\fB-a\fR] [\fB-d\fR \fIdescription\fR]
       [\fB-e\fR \fInon-activeBeName\fR | \fIbeName@snapshot\fR]
!      [\fB-o\fR \fIproperty=value\fR] ... [\fB-p\fR \fIzpool\FI] \fIbeName\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBcreate\fR \fIbeName@snapshot\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBdestroy\fR [\fB-fFs\fR] \fIbeName\fR | \fIbeName@snapshot\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBlist\fR [\fB-a\fR | \fB-ds\fR] [\fB-H\fR] [\fIbeName\fR]
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBmount\fR \fIbeName\fR \fImountpoint\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBunmount\fR [\fB-f\fR] \fIbeName\fR | \fImountpoint\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBrename\fR \fIbeName\fR \fInewBeName\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBactivate\fR \fIbeName\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBrollback\fR \fIbeName\fR \fIsnapshot\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBrollback\fR \fIbeName@snapshot\fR
  .fi
  
  .SH DESCRIPTION
  The \fBbeadm\fR command is the user interface for managing zfs Boot
  Environments (BEs). This utility is intended to be used by System
--- 4,62 ----
  .SH NAME
  beadm \- utility for managing zfs boot environments
  .SH SYNOPSIS
  .LP
  .nf
! \fBbeadm\fR \fBcreate\fR [\fB-a\fR] [\fB-d\fR \fIdescription\fR]
       [\fB-e\fR \fInon-activeBeName\fR | \fIbeName@snapshot\fR]
!      [\fB-o\fR \fIproperty=value\fR] ... [\fB-p\fR \fIzpool\fR]
!      [\fB-v\fR] \fIbeName\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBcreate\fR [\fB-v\fR] \fIbeName@snapshot\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBdestroy\fR [\fB-fFsv\fR] \fIbeName\fR | \fIbeName@snapshot\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBlist\fR [\fB-a\fR | \fB-ds\fR] [\fB-H\fR] [\fB-v\fR] [\fIbeName\fR]
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBmount\fR [\fB-v\fR] \fIbeName\fR \fImountpoint\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBunmount\fR [\fB-fv\fR] \fIbeName\fR | \fImountpoint\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBrename\fR [\fB-v\fR] \fIbeName\fR \fInewBeName\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBactivate\fR [\fB-v\fR] \fIbeName\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBrollback\fR [\fB-v\fR] \fIbeName\fR \fIsnapshot\fR
  .fi
  
  .LP
  .nf
! \fBbeadm\fR \fBrollback\fR [\fB-v\fR] \fIbeName@snapshot\fR
  .fi
  
  .SH DESCRIPTION
  The \fBbeadm\fR command is the user interface for managing zfs Boot
  Environments (BEs). This utility is intended to be used by System
*** 158,170 ****
  
  .sp
  .ne 2
  .na
  \fBbeadm\fR \fBcreate\fR [\fB-a\fR] [\fB-d\fR \fIdescription\fR]
! [\fB-e\fR \fInon-activeBeName\fR | \fIbeName@snapshot\fR]
!          [\fB-o\fR
! \fIproperty=value\fR] ... [\fB-p\fR \fIzpool\fR] \fIbeName\fR
  
  .ad
  .sp .6
  .RS 4n
  Creates a new boot environment named \fIbeName\fR.  If the \fB-e\fR option is
--- 159,171 ----
  
  .sp
  .ne 2
  .na
  \fBbeadm\fR \fBcreate\fR [\fB-a\fR] [\fB-d\fR \fIdescription\fR]
!      [\fB-e\fR \fInon-activeBeName\fR | \fIbeName@snapshot\fR]
!      [\fB-o\fR \fIproperty=value\fR] ... [\fB-p\fR \fIzpool\fR]
!      [\fB-v\fR] \fIbeName\fR
  
  .ad
  .sp .6
  .RS 4n
  Creates a new boot environment named \fIbeName\fR.  If the \fB-e\fR option is
*** 237,262 ****
  .RS 4n
  Create the new BE in the specified zpool.  If this is not provided, the
  default
  behavior is to create the new BE in the same pool as as the origin BE.
  .RE
  .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBcreate\fR \fIbeName@snapshot\fR
  .ad
  .sp .6
  .RS 4n
  Creates a snapshot of the existing BE named beName.
  .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBdestroy\fR [\fB-fFs\fR] \fIbeName\fR | \fIbeName@snapshot\fR
  .ad
  .sp .6
  .RS 4n
  Destroys the boot environment named \fIbeName\fR or destroys an existing
  snapshot of
--- 238,281 ----
  .RS 4n
  Create the new BE in the specified zpool.  If this is not provided, the
  default
  behavior is to create the new BE in the same pool as as the origin BE.
  .RE
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBcreate\fR [\fB-v\fR] \fIbeName@snapshot\fR
  .ad
  .sp .6
  .RS 4n
  Creates a snapshot of the existing BE named beName.
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBdestroy\fR [\fB-fFsv\fR] \fIbeName\fR | \fIbeName@snapshot\fR
  .ad
  .sp .6
  .RS 4n
  Destroys the boot environment named \fIbeName\fR or destroys an existing
  snapshot of
*** 292,307 ****
  .sp .6
  .RS 4n
  Destroy all snapshots of the boot
  environment.
  .RE
  .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBlist\fR [\fB-a\fR | \fB-ds\fR] [\fB-H\fR] [\fIbeName\fR]
  .ad
  .sp .6
  .RS 4n
  Lists information about the existing boot environment named \fIbeName\fR, or
  lists
--- 311,335 ----
  .sp .6
  .RS 4n
  Destroy all snapshots of the boot
  environment.
  .RE
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBlist\fR [\fB-a\fR | \fB-ds\fR] [\fB-H\fR] [\fB-v\fR] [\fIbeName\fR]
  .ad
  .sp .6
  .RS 4n
  Lists information about the existing boot environment named \fIbeName\fR, or
  lists
*** 356,382 ****
  .sp .6
  .RS 4n
  Do not list header information.  Each field in the list information is
  separated by a semicolon.
  .RE
  .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBmount\fR \fIbeName\fR \fImountpoint\fR
  .ad
  .sp .6
  .RS 4n
  Mounts a boot environment named beName at mountpoint.  mountpoint must be an
  already existing empty directory.
  .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBunmount\fR [\fB-f\fR] \fIbeName\fR | \fImountpoint\fR
  .ad
  .sp .6
  .RS 4n
  Unmounts the boot environment named beName. The command can also be given a path to a
  beName mount point on the system.
--- 384,428 ----
  .sp .6
  .RS 4n
  Do not list header information.  Each field in the list information is
  separated by a semicolon.
  .RE
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBmount\fR [\fB-v\fR] \fIbeName\fR \fImountpoint\fR
  .ad
  .sp .6
  .RS 4n
  Mounts a boot environment named beName at mountpoint.  mountpoint must be an
  already existing empty directory.
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBunmount\fR [\fB-fv\fR] \fIbeName\fR | \fImountpoint\fR
  .ad
  .sp .6
  .RS 4n
  Unmounts the boot environment named beName. The command can also be given a path to a
  beName mount point on the system.
*** 387,428 ****
  .ad
  .sp .6
  .RS 4n
  Forcefully unmount the boot environment even if its currently busy.
  .RE
  .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBrename\fR \fIbeName\fR \fInewBeName\fR
  .ad
  .sp .6
  .RS 4n
  Renames the boot environment named \fIbeName\fR to \fInewBeName\fR.
  .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBrollback\fR \fIbeName\fR \fIsnapshot\fR | \fIbeName@snapshot\fR
  .ad
  .sp .6
  .RS 4n
  Roll back the boot environment named \fIbeName\fR to existing snapshot
  of the boot environment named \fIbeName@snapshot\fR.
  .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBactivate\fR \fIbeName\fR
  .ad
  .sp .6
  .RS 4n
  Makes beName the active BE on next reboot.
  .RE
  
  .SH ALTERNATE BE LOCATION
  .LP
  The alternate BE location outside rpool/ROOT can be configured
  by modifying the BENAME_STARTS_WITH parameter in /etc/default/be.
--- 433,510 ----
  .ad
  .sp .6
  .RS 4n
  Forcefully unmount the boot environment even if its currently busy.
  .RE
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBrename\fR [\fB-v\fR] \fIbeName\fR \fInewBeName\fR
  .ad
  .sp .6
  .RS 4n
  Renames the boot environment named \fIbeName\fR to \fInewBeName\fR.
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBrollback\fR [\fB-v\fR] \fIbeName\fR \fIsnapshot\fR | \fIbeName@snapshot\fR
  .ad
  .sp .6
  .RS 4n
  Roll back the boot environment named \fIbeName\fR to existing snapshot
  of the boot environment named \fIbeName@snapshot\fR.
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .sp
  .ne 2
  .na
! \fBbeadm\fR \fBactivate\fR [\fB-v\fR] \fIbeName\fR
  .ad
  .sp .6
  .RS 4n
  Makes beName the active BE on next reboot.
+ .sp
+ .ne 2
+ .na
+ \fB-v\fR
+ .ad
+ .sp .6
+ .RS 4n
+ Verbose mode. Displays verbose error messages from \fBbeadm\fR.
  .RE
+ .RE
  
  .SH ALTERNATE BE LOCATION
  .LP
  The alternate BE location outside rpool/ROOT can be configured
  by modifying the BENAME_STARTS_WITH parameter in /etc/default/be.