1 '\" te
   2 .\" Copyright 2013 Nexenta Systems, Inc. All rights reserved.
   3 .\" Copyright 2016 Toomas Soome <tsoome@me.com>
   4 .TH BEADM 1M "Feb 21, 2016"
   5 .SH NAME
   6 beadm \- utility for managing zfs boot environments
   7 .SH SYNOPSIS
   8 .nf
   9 \fBbeadm\fR \fBcreate\fR [\fB-a\fR] [\fB-d\fR \fIdescription\fR]
  10      [\fB-e\fR \fInon-activeBeName\fR | \fIbeName@snapshot\fR]
  11      [\fB-o\fR \fIproperty=value\fR] ... [\fB-p\fR \fIzpool\fR]
  12      [\fB-v\fR] \fIbeName\fR
  13 .fi
  14 
  15 .LP
  16 .nf
  17 \fBbeadm\fR \fBcreate\fR [\fB-v\fR] \fIbeName@snapshot\fR
  18 .fi
  19 
  20 .LP
  21 .nf
  22 \fBbeadm\fR \fBdestroy\fR [\fB-fFsv\fR] \fIbeName\fR | \fIbeName@snapshot\fR
  23 .fi
  24 
  25 .LP
  26 .nf
  27 \fBbeadm\fR \fBlist\fR [\fB-a\fR | \fB-ds\fR] [\fB-H\fR]
  28     [\fB-k\fR|\fB-K\fR \fBdate\fR | \fBname\fR | \fBspace\fR] [\fB-v\fR] [\fIbeName\fR]
  29 .fi
  30 
  31 .LP
  32 .nf
  33 \fBbeadm\fR \fBmount\fR [\fB-s\fR \fBro\fR|\fBrw\fR] [\fB-v\fR] \fIbeName\fR \fImountpoint\fR
  34 .fi
  35 
  36 .LP
  37 .nf
  38 \fBbeadm\fR \fBunmount\fR [\fB-fv\fR] \fIbeName\fR | \fImountpoint\fR
  39 .fi
  40 
  41 .LP
  42 .nf
  43 \fBbeadm\fR \fBrename\fR [\fB-v\fR] \fIbeName\fR \fInewBeName\fR
  44 .fi
  45 
  46 .LP
  47 .nf
  48 \fBbeadm\fR \fBactivate\fR [\fB-v\fR] \fIbeName\fR
  49 .fi
  50 
  51 .LP
  52 .nf
  53 \fBbeadm\fR \fBrollback\fR [\fB-v\fR] \fIbeName\fR \fIsnapshot\fR
  54 .fi
  55 
  56 .LP
  57 .nf
  58 \fBbeadm\fR \fBrollback\fR [\fB-v\fR] \fIbeName@snapshot\fR
  59 .fi
  60 
  61 .SH DESCRIPTION
  62 The \fBbeadm\fR command is the user interface for managing zfs Boot
  63 Environments (BEs). This utility is intended to be used by System
  64 Administrators who want to manage multiple Solaris Instances on a single
  65 system.
  66 .sp
  67 The \fBbeadm\fR command supports the following operations:
  68 .RS +4
  69 .TP
  70 .ie t \(bu
  71 .el -
  72 Create a new BE, based on the active BE.
  73 .RE
  74 .RS +4
  75 .TP
  76 .ie t \(bu
  77 .el -
  78 Create a new BE, based on an inactive BE.
  79 .RE
  80 .RS +4
  81 .TP
  82 .ie t \(bu
  83 .el -
  84 Create a snapshot of an existing BE.
  85 .RE
  86 .RS +4
  87 .TP
  88 .ie t \(bu
  89 .el -
  90 Create a new BE, based on an existing snapshot.
  91 .RE
  92 .RS +4
  93 .TP
  94 .ie t \(bu
  95 .el -
  96 Create a new BE, and copy it to a different zpool.
  97 .RE
  98 .RS +4
  99 .TP
 100 .ie t \(bu
 101 .el -
 102 Activate an existing, inactive BE.
 103 .RE
 104 .RS +4
 105 .TP
 106 .ie t \(bu
 107 .el -
 108 Mount a BE.
 109 .RE
 110 .RS +4
 111 .TP
 112 .ie t \(bu
 113 .el -
 114 Unmount a BE.
 115 .RE
 116 .RS +4
 117 .TP
 118 .ie t \(bu
 119 .el -
 120 Destroy a BE.
 121 .RE
 122 .RS +4
 123 .TP
 124 .ie t \(bu
 125 .el -
 126 Destroy a snapshot of a BE.
 127 .RE
 128 .RS +4
 129 .TP
 130 .ie t \(bu
 131 .el -
 132 Rename an existing, inactive BE.
 133 .RE
 134 .RS +4
 135 .TP
 136 .ie t \(bu
 137 .el -
 138 Roll back a BE to an existing snapshot of a BE.
 139 .RE
 140 .RS +4
 141 .TP
 142 .ie t \(bu
 143 .el -
 144 Display information about your snapshots and datasets.
 145 .RE
 146 
 147 .SH SUBCOMMANDS
 148 The \fBbeadm\fR command has the subcommands and options listed
 149 below. Also see
 150 EXAMPLES below.
 151 .sp
 152 .ne 2
 153 .na
 154 \fBbeadm\fR
 155 .ad
 156 .sp .6
 157 .RS 4n
 158 Displays command usage.
 159 .RE
 160 
 161 .sp
 162 .ne 2
 163 .na
 164 \fBbeadm\fR \fBcreate\fR [\fB-a\fR] [\fB-d\fR \fIdescription\fR]
 165      [\fB-e\fR \fInon-activeBeName\fR | \fIbeName@snapshot\fR]
 166      [\fB-o\fR \fIproperty=value\fR] ... [\fB-p\fR \fIzpool\fR]
 167      [\fB-v\fR] \fIbeName\fR
 168 
 169 .ad
 170 .sp .6
 171 .RS 4n
 172 Creates a new boot environment named \fIbeName\fR.  If the \fB-e\fR option is
 173 not
 174 provided, the new boot environment will be created as a clone of the
 175 currently
 176 running boot environment. If the \fB-d\fR option is provided then the
 177 description is
 178 also used as the title for the BE's entry in the boot menu. If the \fB-d\fR
 179 option is not provided, \fIbeName\fR will be used as the title.
 180 .sp
 181 .ne 2
 182 .na
 183 \fB-a\fR
 184 .ad
 185 .sp .6
 186 .RS 4n
 187 Activate the newly created BE upon creation.  The default is to not activate
 188 the newly created BE.
 189 .RE
 190 .sp
 191 .ne 2
 192 .na
 193 \fB-d\fR \fIdescription\fR
 194 .ad
 195 .sp .6
 196 .RS 4n
 197 Create a new BE with a description associated with it.
 198 .RE
 199 .sp
 200 .ne 2
 201 .na
 202 \fB-e\fR \fInon-activeBeName\fR
 203 .ad
 204 .sp .6
 205 .RS 4n
 206 Create a new BE from an existing inactive BE.
 207 .RE
 208 .sp
 209 .ne 2
 210 .na
 211 \fB-e\fR \fIbeName@snapshot\fR
 212 .ad
 213 .sp .6
 214 .RS 4n
 215 Create a new BE from an existing snapshot of the BE named beName.
 216 .RE
 217 .sp
 218 .ne 2
 219 .na
 220 \fB-o\fR \fIproperty=value\fR
 221 .ad
 222 .sp .6
 223 .RS 4n
 224 Create the datasets for new BE with specific ZFS properties.  Multiple
 225 \fB-o\fR
 226 options can be specified.  See \fBzfs\fR(1M) for more information on
 227 the
 228 \fB-o\fR option.
 229 .RE
 230 .sp
 231 .ne 2
 232 .na
 233 \fB-p\fR \fIzpool\fR
 234 .ad
 235 .sp .6
 236 .RS 4n
 237 Create the new BE in the specified zpool.  If this is not provided, the
 238 default
 239 behavior is to create the new BE in the same pool as as the origin BE.
 240 This option is not supported in non-global zone.
 241 .RE
 242 .sp
 243 .ne 2
 244 .na
 245 \fB-v\fR
 246 .ad
 247 .sp .6
 248 .RS 4n
 249 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 250 .RE
 251 .RE
 252 
 253 .sp
 254 .ne 2
 255 .na
 256 \fBbeadm\fR \fBcreate\fR [\fB-v\fR] \fIbeName@snapshot\fR
 257 .ad
 258 .sp .6
 259 .RS 4n
 260 Creates a snapshot of the existing BE named beName.
 261 .sp
 262 .ne 2
 263 .na
 264 \fB-v\fR
 265 .ad
 266 .sp .6
 267 .RS 4n
 268 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 269 .RE
 270 .RE
 271 
 272 .sp
 273 .ne 2
 274 .na
 275 \fBbeadm\fR \fBdestroy\fR [\fB-fFsv\fR] \fIbeName\fR | \fIbeName@snapshot\fR
 276 .ad
 277 .sp .6
 278 .RS 4n
 279 Destroys the boot environment named \fIbeName\fR or destroys an existing
 280 snapshot of
 281 the boot environment named \fIbeName@snapshot\fR.  Destroying a
 282 boot environment
 283 will also destroy all snapshots of that boot environment.  Use
 284 this command
 285 with caution.
 286 .sp
 287 .ne 2
 288 .na
 289 \fB-f\fR
 290 .ad
 291 .sp .6
 292 .RS 4n
 293 Forcefully unmount the boot environment if it is currently mounted.
 294 .RE
 295 .sp
 296 .ne 2
 297 .na
 298 \fB-F\fR
 299 .ad
 300 .sp .6
 301 .RS 4n
 302 Force the action without prompting to verify the destruction of the boot
 303 environment.
 304 .RE
 305 .sp
 306 .ne 2
 307 .na
 308 \fB-s\fR
 309 .ad
 310 .sp .6
 311 .RS 4n
 312 Destroy all snapshots of the boot
 313 environment.
 314 .RE
 315 .sp
 316 .ne 2
 317 .na
 318 \fB-v\fR
 319 .ad
 320 .sp .6
 321 .RS 4n
 322 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 323 .RE
 324 .RE
 325 
 326 .sp
 327 .ne 2
 328 .na
 329 \fBbeadm\fR \fBlist\fR [\fB-a\fR | \fB-ds\fR] [\fB-H\fR]
 330     [\fB-k\fR|\fB-K\fR \fBdate\fR | \fBname\fR | \fBspace\fR] [\fB-v\fR] [\fIbeName\fR]
 331 .ad
 332 .sp .6
 333 .RS 4n
 334 Lists information about the existing boot environment named \fIbeName\fR, or
 335 lists
 336 information for all boot environments if \fIbeName\fR is not provided.
 337 The 'Active'
 338 field indicates whether the boot environment is active now,
 339 represented
 340 by 'N'; active on reboot, represented by 'R'; or both, represented
 341 by 'NR'. In non-global zone the 'Active' field also indicates whether the
 342 boot environment has a non-active parent BE, represented by 'x'; is active
 343 on boot in a non-active parent BE, represented by 'b'. Activate, rollback
 344 and snapshot operations for boot environments from non-active global parent
 345 BE aren't supported, destroy is allowed if these boot environments aren't
 346 active on boot.
 347 .sp
 348 Each line in the machine parsable output has the boot environment name as the
 349 first field.  The 'Space' field is displayed in bytes and the 'Created' field
 350 is displayed in UTC format.  The \fB-H\fR option used with no other options
 351 gives
 352 the boot environment's uuid in the second field.  This field will be
 353 blank if
 354 the boot environment does not have a uuid. See the EXAMPLES section.
 355 In non-global zones, this field shows the uuid of the parent BE.
 356 .sp
 357 .ne 2
 358 .na
 359 \fB-a\fR
 360 .ad
 361 .sp .6
 362 .RS 4n
 363 Lists all available information about the boot environment.  This includes
 364 subordinate file systems and snapshots.
 365 .RE
 366 .sp
 367 .ne 2
 368 .na
 369 \fB-d\fR
 370 .ad
 371 .sp .6
 372 .RS 4n
 373 Lists information about all subordinate file systems belonging to the boot
 374 environment.
 375 .RE
 376 .sp
 377 .ne 2
 378 .na
 379 \fB-s\fR
 380 .ad
 381 .sp .6
 382 .RS 4n
 383 Lists information about the snapshots of the boot environment.
 384 .RE
 385 .sp
 386 .ne 2
 387 .na
 388 \fB-H\fR
 389 .ad
 390 .sp .6
 391 .RS 4n
 392 Do not list header information.  Each field in the list information is
 393 separated by a semicolon.
 394 .RE
 395 .sp
 396 .ne 2
 397 .na
 398 \fB-k\fR \fBdate\fR
 399 .ad
 400 .sp .6
 401 .RS 4n
 402 Sort BEs by date of creation in ascending order. This is default.
 403 .RE
 404 .sp
 405 .ne 2
 406 .na
 407 \fB-k\fR \fBname\fR
 408 .ad
 409 .sp .6
 410 .RS 4n
 411 Lexical sort of BEs by name in ascending order.
 412 .RE
 413 .sp
 414 .ne 2
 415 .na
 416 \fB-k\fR \fBspace\fR
 417 .ad
 418 .sp .6
 419 .RS 4n
 420 Sort BEs by space in ascending order.
 421 .RE
 422 .sp
 423 .ne 2
 424 .na
 425 \fB-K date\fR | \fBname\fR | \fBspace\fR
 426 .ad
 427 .sp .6
 428 .RS 4n
 429 Same as the \fB-k\fR option, but sorts in descending order.
 430 .RE
 431 .sp
 432 .ne 2
 433 .na
 434 \fB-v\fR
 435 .ad
 436 .sp .6
 437 .RS 4n
 438 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 439 .RE
 440 .RE
 441 
 442 .sp
 443 .ne 2
 444 .na
 445 \fBbeadm\fR \fBmount\fR [\fB-s\fR \fBro\fR|\fBrw\fR] [\fB-v\fR] \fIbeName\fR \fImountpoint\fR
 446 .ad
 447 .sp .6
 448 .RS 4n
 449 Mounts a boot environment named beName at mountpoint.  mountpoint must be an
 450 already existing empty directory.
 451 .sp
 452 .ne 2
 453 .na
 454 \fB-s\fR \fBro\fR|\fBrw\fR
 455 .ad
 456 .sp .6
 457 .RS 4n
 458 Mount the shared filesystems of the BE in read-only or read-write mode.
 459 .RE
 460 .sp
 461 .ne 2
 462 .na
 463 \fB-v\fR
 464 .ad
 465 .sp .6
 466 .RS 4n
 467 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 468 .RE
 469 .RE
 470 
 471 .sp
 472 .ne 2
 473 .na
 474 \fBbeadm\fR \fBunmount\fR [\fB-fv\fR] \fIbeName\fR | \fImountpoint\fR
 475 .ad
 476 .sp .6
 477 .RS 4n
 478 Unmounts the boot environment named beName. The command can also be given a path to a
 479 beName mount point on the system.
 480 .sp
 481 .ne 2
 482 .na
 483 \fB-f\fR
 484 .ad
 485 .sp .6
 486 .RS 4n
 487 Forcefully unmount the boot environment even if its currently busy.
 488 .RE
 489 .sp
 490 .ne 2
 491 .na
 492 \fB-v\fR
 493 .ad
 494 .sp .6
 495 .RS 4n
 496 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 497 .RE
 498 .RE
 499 
 500 .sp
 501 .ne 2
 502 .na
 503 \fBbeadm\fR \fBrename\fR [\fB-v\fR] \fIbeName\fR \fInewBeName\fR
 504 .ad
 505 .sp .6
 506 .RS 4n
 507 Renames the boot environment named \fIbeName\fR to \fInewBeName\fR.
 508 .sp
 509 .ne 2
 510 .na
 511 \fB-v\fR
 512 .ad
 513 .sp .6
 514 .RS 4n
 515 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 516 .RE
 517 .RE
 518 
 519 .sp
 520 .ne 2
 521 .na
 522 \fBbeadm\fR \fBrollback\fR [\fB-v\fR] \fIbeName\fR \fIsnapshot\fR | \fIbeName@snapshot\fR
 523 .ad
 524 .sp .6
 525 .RS 4n
 526 Roll back the boot environment named \fIbeName\fR to existing snapshot
 527 of the boot environment named \fIbeName@snapshot\fR.
 528 .sp
 529 .ne 2
 530 .na
 531 \fB-v\fR
 532 .ad
 533 .sp .6
 534 .RS 4n
 535 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 536 .RE
 537 .RE
 538 
 539 .sp
 540 .ne 2
 541 .na
 542 \fBbeadm\fR \fBactivate\fR [\fB-v\fR] \fIbeName\fR
 543 .ad
 544 .sp .6
 545 .RS 4n
 546 Makes beName the active BE on next reboot.
 547 .sp
 548 .ne 2
 549 .na
 550 \fB-v\fR
 551 .ad
 552 .sp .6
 553 .RS 4n
 554 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
 555 .RE
 556 .RE
 557 
 558 .SH ALTERNATE BE LOCATION
 559 The alternate BE location outside rpool/ROOT can be configured
 560 by modifying the BENAME_STARTS_WITH parameter in /etc/default/be.
 561 For example: BENAME_STARTS_WITH=rootfs
 562 
 563 .SH EXAMPLES
 564 \fBExample 1\fR: Create a new BE named BE1, by cloning the current live BE.
 565 .sp
 566 .in +2
 567 .nf
 568 \fB# beadm create BE1\fR
 569 .fi
 570 .in -2
 571 .sp
 572 
 573 .LP
 574 \fBExample 2\fR: Create a new BE named BE2, by cloning the existing inactive
 575 BE
 576 named BE1.
 577 .sp
 578 .in +2
 579 .nf
 580 \fB# beadm create -e BE1 BE2\fR
 581 .fi
 582 .in -2
 583 .sp
 584 
 585 .LP
 586 \fBExample 3\fR: Create a snapshot named now of the existing BE named BE1.
 587 .sp
 588 .in +2
 589 .nf
 590 \fB# beadm create BE1@now\fR
 591 .fi
 592 .in -2
 593 .sp
 594 
 595 .LP
 596 \fBExample 4\fR: Create a new BE named BE3, by cloning an existing snapshot of
 597 BE1.
 598 .sp
 599 .in +2
 600 .nf
 601 \fB# beadm create -e BE1@now BE3\fR
 602 .fi
 603 .in -2
 604 .sp
 605 
 606 .LP
 607 \fBExample 5\fR: Create a new BE named BE4 based on the currently running BE.
 608 Create the new BE in rpool2.
 609 .sp
 610 .in +2
 611 .nf
 612 \fB# beadm create -p rpool2 BE4\fR
 613 .fi
 614 .in -2
 615 .sp
 616 
 617 .LP
 618 \fBExample 6\fR: Create a new BE named BE5 based on the currently running BE.
 619 Create the new BE in rpool2, and create its datasets with compression turned
 620 on.
 621 .sp
 622 .in +2
 623 .nf
 624 \fB# beadm create -p rpool2 -o compression=on BE5\fR
 625 .fi
 626 .in -2
 627 .sp
 628 
 629 .LP
 630 \fBExample 7\fR: Create a new BE named BE6 based on the currently running BE
 631 and provide a description for it.
 632 .sp
 633 .in +2
 634 .nf
 635 \fB# beadm create -d "BE6 used as test environment" BE6\fR
 636 .fi
 637 .in -2
 638 .sp
 639 
 640 .LP
 641 \fBExample 8\fR: Activate an existing, inactive BE named BE3.
 642 .sp
 643 .in +2
 644 .nf
 645 \fB# beadm activate BE3\fR
 646 .fi
 647 .in -2
 648 .sp
 649 
 650 .LP
 651 \fBExample 9\fR: Mount the BE named BE3 at /mnt.
 652 .sp
 653 .in +2
 654 .nf
 655 \fB# beadm mount BE3 /mnt\fR
 656 .fi
 657 .in -2
 658 .sp
 659 
 660 .LP
 661 \fBExample 10\fR: Unmount the mounted BE named BE3.
 662 .sp
 663 .in +2
 664 .nf
 665 \fB# beadm unmount BE3\fR
 666 .fi
 667 .in -2
 668 .sp
 669 
 670 .LP
 671 \fBExample 11\fR: Destroy the BE named BE3 without verification.
 672 .sp
 673 .in +2
 674 .nf
 675 \fB# beadm destroy -f BE3\fR
 676 .fi
 677 .in -2
 678 .sp
 679 
 680 .LP
 681 \fBExample 12\fR: Destroy the snapshot named now of BE1.
 682 .sp
 683 .in +2
 684 .nf
 685 \fB# beadm destroy BE1@now\fR
 686 .fi
 687 .in -2
 688 .sp
 689 
 690 .LP
 691 \fBExample 13\fR: Rename the existing, inactive BE named BE1 to BE3.
 692 .sp
 693 .in +2
 694 .nf
 695 \fB# beadm rename BE1 BE3\fR
 696 .fi
 697 .in -2
 698 .sp
 699 
 700 .LP
 701 \fBExample 14\fR: Roll back the BE named BE1 to snapshot BE1@now.
 702 .sp
 703 .in +2
 704 .nf
 705 \fB# beadm rollback BE1 BE1@now\fR
 706 .fi
 707 .in -2
 708 .sp
 709 
 710 .LP
 711 \fBExample 15\fR: List all existing boot environments.
 712 
 713 .sp
 714 .in +2
 715 .nf
 716 \fB# beadm list\fR
 717 BE  Active Mountpoint Space  Policy Created
 718 --  ------ ---------- -----  ------ -------
 719 BE2 -      -          72.0K  static 2008-05-21 12:26
 720 BE3 -      -          332.0K static 2008-08-26 10:28
 721 BE4 -      -          15.78M static 2008-09-05 18:20
 722 BE5 NR     /          7.25G  static 2008-09-09 16:53
 723 .fi
 724 .in -2
 725 .sp
 726 
 727 .LP
 728 \fBExample 16\fR: List all existing boot environmets and list all dataset and
 729 snapshot information about those bootenvironments.
 730 
 731 .sp
 732 .in +2
 733 .nf
 734 \fB# beadm list -d -s\fR
 735 
 736 BE/Dataset/Snapshot     Active Mountpoint Space   Policy Created
 737 -------------------     ------ ---------- -----   ------ -------
 738 BE2
 739    p/ROOT/BE2           -      -          36.0K   static 2008-05-21 12:26
 740    p/ROOT/BE2/opt       -      -          18.0K   static 2008-05-21 16:26
 741    p/ROOT/BE2/opt@now   -      -          0       static 2008-09-08 22:43
 742    p/ROOT/BE2@now       -      -          0       static 2008-09-08 22:43
 743 BE3
 744    p/ROOT/BE3           -      -          192.0K  static 2008-08-26 10:28
 745    p/ROOT/BE3/opt       -      -          86.0K   static 2008-08-26 10:28
 746    p/ROOT/BE3/opt/local -      -          36.0K   static 2008-08-28 10:58
 747 BE4
 748    p/ROOT/BE4           -      -          15.78M  static 2008-09-05 18:20
 749 BE5
 750    p/ROOT/BE5           NR     /          6.10G   static 2008-09-09 16:53
 751    p/ROOT/BE5/opt       -      /opt       24.55M  static 2008-09-09 16:53
 752    p/ROOT/BE5/opt@bar   -      -          18.38M  static 2008-09-10 00:59
 753    p/ROOT/BE5/opt@foo   -      -          18.38M  static 2008-06-10 16:37
 754    p/ROOT/BE5@bar       -      -          139.44M static 2008-09-10 00:59
 755    p/ROOT/BE5@foo       -      -          912.85M static 2008-06-10 16:37
 756 .fi
 757 .in -2
 758 .sp
 759 
 760 \fBExample 17\fR: List all dataset and snapshot information about BE5
 761 
 762 .sp
 763 .in +2
 764 .nf
 765 \fB# beadm list -a BE5\fR
 766 
 767 BE/Dataset/Snapshot   Active Mountpoint Space   Policy Created
 768 -------------------   ------ ---------- -----   ------ -------
 769 BE5
 770    p/ROOT/BE5         NR     /          6.10G   static 2008-09-09 16:53
 771    p/ROOT/BE5/opt     -      /opt       24.55M  static 2008-09-09 16:53
 772    p/ROOT/BE5/opt@bar -      -          18.38M  static 2008-09-10 00:59
 773    p/ROOT/BE5/opt@foo -      -          18.38M  static 2008-06-10 16:37
 774    p/ROOT/BE5@bar     -      -          139.44M static 2008-09-10 00:59
 775    p/ROOT/BE5@foo     -      -          912.85M static 2008-06-10 16:37
 776 .fi
 777 .in -2
 778 .sp
 779 
 780 .LP
 781 \fBExample 18\fR: List machine parsable information about all boot
 782 environments.
 783 
 784 .sp
 785 .in +2
 786 .nf
 787 \fB# beadm list -H\fR
 788 
 789 BE2;;;;55296;static;1211397974
 790 BE3;;;;339968;static;1219771706
 791 BE4;;;;16541696;static;1220664051
 792 BE5;215b8387-4968-627c-d2d0-f4a011414bab;NR;/;7786206208;static;1221004384
 793 .fi
 794 .in -2
 795 .sp
 796 
 797 .SH EXIT STATUS
 798 The following exit values are returned:
 799 .sp
 800 .ne 2
 801 .na
 802 \fB0\fR
 803 .ad
 804 .sp .6
 805 .RS 4n
 806 Successful completion
 807 .RE
 808 
 809 .sp
 810 .ne 2
 811 .na
 812 \fB>0\fR
 813 .ad
 814 .sp .6
 815 .RS 4n
 816 Failure
 817 .RE
 818 
 819 
 820 .SH FILES
 821 .ne 2
 822 .na
 823 \fB/var/log/beadm/<beName>/create.log.<yyyymmdd_hhmmss>\fR
 824 .ad
 825 .sp .6
 826 .RS 4n
 827 Log used for capturing beadm create output
 828 .sp
 829 .nf
 830 \fIyyyymmdd_hhmmss\fR - 20071130_140558
 831 \fIyy\fR - year; 2007
 832 \fImm\fR - month; 11
 833 \fIdd\fR - day; 30
 834 \fIhh\fR - hour; 14
 835 \fImm\fR - minute; 05
 836 \fIss\fR - second; 58
 837 .fi
 838 .in -2
 839 .sp
 840 .RE
 841 .sp
 842 .LP
 843 .ne 2
 844 .na
 845 \fB/etc/default/be\fR
 846 .ad
 847 .sp .6
 848 .RS 4n
 849 Contains default value for BENAME_STARTS_WITH parameter
 850 .sp
 851 .RE
 852 
 853 .SH ATTRIBUTES
 854 See \fBattributes\fR(5) for descriptions of the  following  attributes:
 855 .sp
 856 
 857 .sp
 858 .TS
 859 box;
 860 c | c
 861 l | l .
 862 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 863 _
 864 Interface Stability     Uncommitted
 865 .TE
 866 
 867 
 868 .SH SEE ALSO
 869 .BR zfs (1M)