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