Listing Existing Boot Environments and Snapshots
All snapshots, boot environments, and datasets that were created by the beadm command can be displayed with the beadm list subcommand.
Snapshots and boot environments can be created by the beadm command. Snapshots and boot environments can also be created by other utilities. For example, the pkg image-update command automatically creates a clone of a boot environment and upgrades that clone. The beadm list command output also displays boot environments that are created by the pkg image-update command.
How to Display Information About Your Boot Environments, Snapshots, and Datasets
Example 2-1 Viewing Boot Environment Specifications
This example includes the -a option and specifies the BE2 environment as follows:
$ beadm list -a BE2
Sample results are displayed. The BE2 environment will be active on reboot, as indicated by the R in the Active column.
BE/Dataset Active Mountpoint Space Policy Created ---------- ------ ---------- ----- ------ ------- BE2 rpool/ROOT/BE2 R /mnt 89.67M static 2008-09-17 20:17 rpool/ROOT/BE2/opt - /mnt/opt 0 static 2008-09-17 20:17
Two datasets are included in BE2, the dataset, rpool/ROOT/BE2, and the dataset, rpool/ROOT/BE2/opt. The values for the Active column are as follows:
Example 2-2 Viewing Snapshot Specifications
This example includes the -s option, which displays information for any snapshots that exist on the current image. The status of those snapshots is the same list that the zfs(1M) command displays.
$ beadm list -s BE2
Sample results are displayed.
BE/Snapshot Space Policy Created ----------- ----- ------ ------- BE1 [email protected]:53:10 32.00M static 2008-10-13 13:53 BE2 [email protected]:40:09 213.0K static 2008-10-16 09:40 preview2 [email protected] 452.00M static 2008-05-24 14:24 [email protected] 765.37M static 2008-07-11 12:15 [email protected] 438.22M static 2008-08-09 16:22
In this example, the BE1, BE2, and Preview 2 boot environments are listed. BE1 and BE2 each have one snapshot listed, with each snapshot name showing when the snapshot was taken. The Preview 2 boot environment has three snapshots available, with each snapshot name indicating the original image source.