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