Print this page
4220 beadm mount of old BE with zones fails "Read only filesystem"
4235 beadm(1M) mount options undocumented in man page
| 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 -.TH BEADM 1M "Jul 25, 2013"
3 +.TH BEADM 1M "Nov 11, 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
|
↓ open down ↓ |
8 lines elided |
↑ open up ↑ |
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 -\fBbeadm\fR \fBmount\fR [\fB-v\fR] \fIbeName\fR \fImountpoint\fR
32 +\fBbeadm\fR \fBmount\fR [\fB-s\fR \fBro\fR|\fBrw\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
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 242 This option is not supported in non-global zone.
243 243 .RE
244 244 .sp
245 245 .ne 2
246 246 .na
247 247 \fB-v\fR
248 248 .ad
249 249 .sp .6
250 250 .RS 4n
251 251 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
252 252 .RE
253 253 .RE
254 254
255 255 .sp
256 256 .ne 2
257 257 .na
258 258 \fBbeadm\fR \fBcreate\fR [\fB-v\fR] \fIbeName@snapshot\fR
259 259 .ad
260 260 .sp .6
261 261 .RS 4n
262 262 Creates a snapshot of the existing BE named beName.
263 263 .sp
264 264 .ne 2
265 265 .na
266 266 \fB-v\fR
267 267 .ad
268 268 .sp .6
269 269 .RS 4n
270 270 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
271 271 .RE
272 272 .RE
273 273
274 274 .sp
275 275 .ne 2
276 276 .na
277 277 \fBbeadm\fR \fBdestroy\fR [\fB-fFsv\fR] \fIbeName\fR | \fIbeName@snapshot\fR
278 278 .ad
279 279 .sp .6
280 280 .RS 4n
281 281 Destroys the boot environment named \fIbeName\fR or destroys an existing
282 282 snapshot of
283 283 the boot environment named \fIbeName@snapshot\fR. Destroying a
284 284 boot environment
285 285 will also destroy all snapshots of that boot environment. Use
286 286 this command
287 287 with caution.
288 288 .sp
289 289 .ne 2
290 290 .na
291 291 \fB-f\fR
292 292 .ad
293 293 .sp .6
294 294 .RS 4n
295 295 Forcefully unmount the boot environment if it is currently mounted.
296 296 .RE
297 297 .sp
298 298 .ne 2
299 299 .na
300 300 \fB-F\fR
301 301 .ad
302 302 .sp .6
303 303 .RS 4n
304 304 Force the action without prompting to verify the destruction of the boot
305 305 environment.
306 306 .RE
307 307 .sp
308 308 .ne 2
309 309 .na
310 310 \fB-s\fR
311 311 .ad
312 312 .sp .6
313 313 .RS 4n
314 314 Destroy all snapshots of the boot
315 315 environment.
316 316 .RE
317 317 .sp
318 318 .ne 2
319 319 .na
320 320 \fB-v\fR
321 321 .ad
322 322 .sp .6
323 323 .RS 4n
324 324 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
325 325 .RE
326 326 .RE
327 327
328 328 .sp
329 329 .ne 2
330 330 .na
331 331 \fBbeadm\fR \fBlist\fR [\fB-a\fR | \fB-ds\fR] [\fB-H\fR] [\fB-v\fR] [\fIbeName\fR]
332 332 .ad
333 333 .sp .6
334 334 .RS 4n
335 335 Lists information about the existing boot environment named \fIbeName\fR, or
336 336 lists
337 337 information for all boot environments if \fIbeName\fR is not provided.
338 338 The 'Active'
339 339 field indicates whether the boot environment is active now,
340 340 represented
341 341 by 'N'; active on reboot, represented by 'R'; or both, represented
342 342 by 'NR'. In non-global zone the 'Active' field also indicates whether the
343 343 boot environment has a non-active parent BE, represented by 'x'; is active
344 344 on boot in a non-active parent BE, represented by 'b'. Activate, rollback
345 345 and snapshot operations for boot environments from non-active global parent
346 346 BE aren't supported, destroy is allowed if these boot environments aren't
347 347 active on boot.
348 348 .sp
349 349 Each line in the machine parasable output has the boot environment name as the
350 350 first field. The 'Space' field is displayed in bytes and the 'Created' field
351 351 is displayed in UTC format. The \fB-H\fR option used with no other options
352 352 gives
353 353 the boot environment's uuid in the second field. This field will be
354 354 blank if
355 355 the boot environment does not have a uuid. See the EXAMPLES section.
356 356 In non-global zones, this field shows the uuid of the parent BE.
357 357 .sp
358 358 .ne 2
359 359 .na
360 360 \fB-a\fR
361 361 .ad
362 362 .sp .6
363 363 .RS 4n
364 364 Lists all available information about the boot environment. This includes
365 365 subordinate file systems and snapshots.
366 366 .RE
367 367 .sp
368 368 .ne 2
369 369 .na
370 370 \fB-d\fR
371 371 .ad
372 372 .sp .6
373 373 .RS 4n
374 374 Lists information about all subordinate file systems belonging to the boot
375 375 environment.
376 376 .RE
377 377 .sp
378 378 .ne 2
379 379 .na
380 380 \fB-s\fR
381 381 .ad
382 382 .sp .6
383 383 .RS 4n
384 384 Lists information about the snapshots of the boot environment.
385 385 .RE
386 386 .sp
387 387 .ne 2
388 388 .na
389 389 \fB-H\fR
390 390 .ad
391 391 .sp .6
392 392 .RS 4n
393 393 Do not list header information. Each field in the list information is
394 394 separated by a semicolon.
395 395 .RE
396 396 .sp
397 397 .ne 2
398 398 .na
399 399 \fB-v\fR
|
↓ open down ↓ |
357 lines elided |
↑ open up ↑ |
400 400 .ad
401 401 .sp .6
402 402 .RS 4n
403 403 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
404 404 .RE
405 405 .RE
406 406
407 407 .sp
408 408 .ne 2
409 409 .na
410 -\fBbeadm\fR \fBmount\fR [\fB-v\fR] \fIbeName\fR \fImountpoint\fR
410 +\fBbeadm\fR \fBmount\fR [\fB-s\fR \fBro\fR|\fBrw\fR] [\fB-v\fR] \fIbeName\fR \fImountpoint\fR
411 411 .ad
412 412 .sp .6
413 413 .RS 4n
414 414 Mounts a boot environment named beName at mountpoint. mountpoint must be an
415 415 already existing empty directory.
416 416 .sp
417 417 .ne 2
418 +.na
419 +\fB-s\fR \fBro\fR|\fBrw\fR
420 +.ad
421 +.sp .6
422 +.RS 4n
423 +Mount the shared filesystems of the BE in read-only or read-write mode.
424 +.RE
425 +.sp
426 +.ne 2
418 427 .na
419 428 \fB-v\fR
420 429 .ad
421 430 .sp .6
422 431 .RS 4n
423 432 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
424 433 .RE
425 434 .RE
426 435
427 436 .sp
428 437 .ne 2
429 438 .na
430 439 \fBbeadm\fR \fBunmount\fR [\fB-fv\fR] \fIbeName\fR | \fImountpoint\fR
431 440 .ad
432 441 .sp .6
433 442 .RS 4n
434 443 Unmounts the boot environment named beName. The command can also be given a path to a
435 444 beName mount point on the system.
436 445 .sp
437 446 .ne 2
438 447 .na
439 448 \fB-f\fR
440 449 .ad
441 450 .sp .6
442 451 .RS 4n
443 452 Forcefully unmount the boot environment even if its currently busy.
444 453 .RE
445 454 .sp
446 455 .ne 2
447 456 .na
448 457 \fB-v\fR
449 458 .ad
450 459 .sp .6
451 460 .RS 4n
452 461 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
453 462 .RE
454 463 .RE
455 464
456 465 .sp
457 466 .ne 2
458 467 .na
459 468 \fBbeadm\fR \fBrename\fR [\fB-v\fR] \fIbeName\fR \fInewBeName\fR
460 469 .ad
461 470 .sp .6
462 471 .RS 4n
463 472 Renames the boot environment named \fIbeName\fR to \fInewBeName\fR.
464 473 .sp
465 474 .ne 2
466 475 .na
467 476 \fB-v\fR
468 477 .ad
469 478 .sp .6
470 479 .RS 4n
471 480 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
472 481 .RE
473 482 .RE
474 483
475 484 .sp
476 485 .ne 2
477 486 .na
478 487 \fBbeadm\fR \fBrollback\fR [\fB-v\fR] \fIbeName\fR \fIsnapshot\fR | \fIbeName@snapshot\fR
479 488 .ad
480 489 .sp .6
481 490 .RS 4n
482 491 Roll back the boot environment named \fIbeName\fR to existing snapshot
483 492 of the boot environment named \fIbeName@snapshot\fR.
484 493 .sp
485 494 .ne 2
486 495 .na
487 496 \fB-v\fR
488 497 .ad
489 498 .sp .6
490 499 .RS 4n
491 500 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
492 501 .RE
493 502 .RE
494 503
495 504 .sp
496 505 .ne 2
497 506 .na
498 507 \fBbeadm\fR \fBactivate\fR [\fB-v\fR] \fIbeName\fR
499 508 .ad
500 509 .sp .6
501 510 .RS 4n
502 511 Makes beName the active BE on next reboot.
503 512 .sp
504 513 .ne 2
505 514 .na
506 515 \fB-v\fR
507 516 .ad
508 517 .sp .6
509 518 .RS 4n
510 519 Verbose mode. Displays verbose error messages from \fBbeadm\fR.
511 520 .RE
512 521 .RE
513 522
514 523 .SH ALTERNATE BE LOCATION
515 524 .LP
516 525 The alternate BE location outside rpool/ROOT can be configured
517 526 by modifying the BENAME_STARTS_WITH parameter in /etc/default/be.
518 527 For example: BENAME_STARTS_WITH=rootfs
519 528
520 529 .SH EXAMPLES
521 530 .LP
522 531 \fBExample 1\fR: Create a new BE named BE1, by cloning the current live BE.
523 532 .sp
524 533 .in +2
525 534 .nf
526 535 \fB# beadm create BE1\fR
527 536 .fi
528 537 .in -2
529 538 .sp
530 539
531 540 .LP
532 541 \fBExample 2\fR: Create a new BE named BE2, by cloning the existing inactive
533 542 BE
534 543 named BE1.
535 544 .sp
536 545 .in +2
537 546 .nf
538 547 \fB# beadm create -e BE1 BE2\fR
539 548 .fi
540 549 .in -2
541 550 .sp
542 551
543 552 .LP
544 553 \fBExample 3\fR: Create a snapshot named now of the existing BE named BE1.
545 554 .sp
546 555 .in +2
547 556 .nf
548 557 \fB# beadm create BE1@now\fR
549 558 .fi
550 559 .in -2
551 560 .sp
552 561
553 562 .LP
554 563 \fBExample 4\fR: Create a new BE named BE3, by cloning an existing snapshot of
555 564 BE1.
556 565 .sp
557 566 .in +2
558 567 .nf
559 568 \fB# beadm create -e BE1@now BE3\fR
560 569 .fi
561 570 .in -2
562 571 .sp
563 572
564 573 .LP
565 574 \fBExample 5\fR: Create a new BE named BE4 based on the currently running BE.
566 575 Create the new BE in rpool2.
567 576 .sp
568 577 .in +2
569 578 .nf
570 579 \fB# beadm create -p rpool2 BE4\fR
571 580 .fi
572 581 .in -2
573 582 .sp
574 583
575 584 .LP
576 585 \fBExample 6\fR: Create a new BE named BE5 based on the currently running BE.
577 586 Create the new BE in rpool2, and create its datasets with compression turned
578 587 on.
579 588 .sp
580 589 .in +2
581 590 .nf
582 591 \fB# beadm create -p rpool2 -o compression=on BE5\fR
583 592 .fi
584 593 .in -2
585 594 .sp
586 595
587 596 .LP
588 597 \fBExample 7\fR: Create a new BE named BE6 based on the currently running BE
589 598 and provide a description for it.
590 599 .sp
591 600 .in +2
592 601 .nf
593 602 \fB# beadm create -d "BE6 used as test environment" BE6\fR
594 603 .fi
595 604 .in -2
596 605 .sp
597 606
598 607 .LP
599 608 \fBExample 8\fR: Activate an existing, inactive BE named BE3.
600 609 .sp
601 610 .in +2
602 611 .nf
603 612 \fB# beadm activate BE3\fR
604 613 .fi
605 614 .in -2
606 615 .sp
607 616
608 617 .LP
609 618 \fBExample 9\fR: Mount the BE named BE3 at /mnt.
610 619 .sp
611 620 .in +2
612 621 .nf
613 622 \fB# beadm mount BE3 /mnt\fR
614 623 .fi
615 624 .in -2
616 625 .sp
617 626
618 627 .LP
619 628 \fBExample 10\fR: Unmount the mounted BE named BE3.
620 629 .sp
621 630 .in +2
622 631 .nf
623 632 \fB# beadm unmount BE3\fR
624 633 .fi
625 634 .in -2
626 635 .sp
627 636
628 637 .LP
629 638 \fBExample 11\fR: Destroy the BE named BE3 without verification.
630 639 .sp
631 640 .in +2
632 641 .nf
633 642 \fB# beadm destroy -f BE3\fR
634 643 .fi
635 644 .in -2
636 645 .sp
637 646
638 647 .LP
639 648 \fBExample 12\fR: Destroy the snapshot named now of BE1.
640 649 .sp
641 650 .in +2
642 651 .nf
643 652 \fB# beadm destroy BE1@now\fR
644 653 .fi
645 654 .in -2
646 655 .sp
647 656
648 657 .LP
649 658 \fBExample 13\fR: Rename the existing, inactive BE named BE1 to BE3.
650 659 .sp
651 660 .in +2
652 661 .nf
653 662 \fB# beadm rename BE1 BE3\fR
654 663 .fi
655 664 .in -2
656 665 .sp
657 666
658 667 .LP
659 668 \fBExample 14\fR: Roll back the BE named BE1 to snapshot BE1@now.
660 669 .sp
661 670 .in +2
662 671 .nf
663 672 \fB# beadm rollback BE1 BE1@now\fR
664 673 .fi
665 674 .in -2
666 675 .sp
667 676
668 677 .LP
669 678 \fBExample 15\fR: List all existing boot environments.
670 679
671 680 .sp
672 681 .in +2
673 682 .nf
674 683 \fB# beadm list\fR
675 684 BE Active Mountpoint Space Policy Created
676 685 -- ------ ---------- ----- ------ -------
677 686 BE2 - - 72.0K static 2008-05-21 12:26
678 687 BE3 - - 332.0K static 2008-08-26 10:28
679 688 BE4 - - 15.78M static 2008-09-05 18:20
680 689 BE5 NR / 7.25G static 2008-09-09 16:53
681 690 .fi
682 691 .in -2
683 692 .sp
684 693
685 694 .LP
686 695 \fBExample 16\fR: List all existing boot environmets and list all dataset and
687 696 snapshot information about those bootenvironments.
688 697
689 698 .sp
690 699 .in +2
691 700 .nf
692 701 \fB# beadm list -d -s\fR
693 702
694 703 BE/Dataset/Snapshot Active Mountpoint Space Policy Created
695 704 ------------------- ------ ---------- ----- ------ -------
696 705 BE2
697 706 p/ROOT/BE2 - - 36.0K static 2008-05-21 12:26
698 707 p/ROOT/BE2/opt - - 18.0K static 2008-05-21 16:26
699 708 p/ROOT/BE2/opt@now - - 0 static 2008-09-08 22:43
700 709 p/ROOT/BE2@now - - 0 static 2008-09-08 22:43
701 710 BE3
702 711 p/ROOT/BE3 - - 192.0K static 2008-08-26 10:28
703 712 p/ROOT/BE3/opt - - 86.0K static 2008-08-26 10:28
704 713 p/ROOT/BE3/opt/local - - 36.0K static 2008-08-28 10:58
705 714 BE4
706 715 p/ROOT/BE4 - - 15.78M static 2008-09-05 18:20
707 716 BE5
708 717 p/ROOT/BE5 NR / 6.10G static 2008-09-09 16:53
709 718 p/ROOT/BE5/opt - /opt 24.55M static 2008-09-09 16:53
710 719 p/ROOT/BE5/opt@bar - - 18.38M static 2008-09-10 00:59
711 720 p/ROOT/BE5/opt@foo - - 18.38M static 2008-06-10 16:37
712 721 p/ROOT/BE5@bar - - 139.44M static 2008-09-10 00:59
713 722 p/ROOT/BE5@foo - - 912.85M static 2008-06-10 16:37
714 723 .fi
715 724 .in -2
716 725 .sp
717 726
718 727 \fBExample 17\fR: List all dataset and snapshot information about BE5
719 728
720 729 .sp
721 730 .in +2
722 731 .nf
723 732 \fB# beadm list -a BE5\fR
724 733
725 734 BE/Dataset/Snapshot Active Mountpoint Space Policy Created
726 735 ------------------- ------ ---------- ----- ------ -------
727 736 BE5
728 737 p/ROOT/BE5 NR / 6.10G static 2008-09-09 16:53
729 738 p/ROOT/BE5/opt - /opt 24.55M static 2008-09-09 16:53
730 739 p/ROOT/BE5/opt@bar - - 18.38M static 2008-09-10 00:59
731 740 p/ROOT/BE5/opt@foo - - 18.38M static 2008-06-10 16:37
732 741 p/ROOT/BE5@bar - - 139.44M static 2008-09-10 00:59
733 742 p/ROOT/BE5@foo - - 912.85M static 2008-06-10 16:37
734 743 .fi
735 744 .in -2
736 745 .sp
737 746
738 747 .LP
739 748 \fBExample 18\fR: List machine parsable information about all boot
740 749 environments.
741 750
742 751 .sp
743 752 .in +2
744 753 .nf
745 754 \fB# beadm list -H\fR
746 755
747 756 BE2;;;;55296;static;1211397974
748 757 BE3;;;;339968;static;1219771706
749 758 BE4;;;;16541696;static;1220664051
750 759 BE5;215b8387-4968-627c-d2d0-f4a011414bab;NR;/;7786206208;static;1221004384
751 760 .fi
752 761 .in -2
753 762 .sp
754 763
755 764 .SH EXIT STATUS
756 765 .sp
757 766 .LP
758 767 The following exit values are returned:
759 768 .sp
760 769 .ne 2
761 770 .na
762 771 \fB0\fR
763 772 .ad
764 773 .sp .6
765 774 .RS 4n
766 775 Successful completion
767 776 .RE
768 777
769 778 .sp
770 779 .ne 2
771 780 .na
772 781 \fB>0\fR
773 782 .ad
774 783 .sp .6
775 784 .RS 4n
776 785 Failure
777 786 .RE
778 787
779 788
780 789 .SH FILES
781 790 .sp
782 791 .LP
783 792 .sp
784 793 .ne 2
785 794 .na
786 795 \fB/var/log/beadm/<beName>/create.log.<yyyymmdd_hhmmss>\fR
787 796 .ad
788 797 .sp .6
789 798 .RS 4n
790 799 Log used for capturing beadm create output
791 800 .sp
792 801 .nf
793 802 \fIyyyymmdd_hhmmss\fR - 20071130_140558
794 803 \fIyy\fR - year; 2007
795 804 \fImm\fR - month; 11
796 805 \fIdd\fR - day; 30
797 806 \fIhh\fR - hour; 14
798 807 \fImm\fR - minute; 05
799 808 \fIss\fR - second; 58
800 809 .fi
801 810 .in -2
802 811 .sp
803 812 .RE
804 813 .sp
805 814 .LP
806 815 .sp
807 816 .ne 2
808 817 .na
809 818 \fB/etc/default/be\fR
810 819 .ad
811 820 .sp .6
812 821 .RS 4n
813 822 Contains default value for BENAME_STARTS_WITH parameter
814 823 .sp
815 824 .RE
816 825
817 826 .SH ATTRIBUTES
818 827 .sp
819 828 .LP
820 829 See \fBattributes\fR(5) for descriptions of the following attributes:
821 830 .sp
822 831
823 832 .sp
824 833 .TS
825 834 box;
826 835 c | c
827 836 l | l .
828 837 ATTRIBUTE TYPE ATTRIBUTE VALUE
829 838 _
830 839 Interface Stability Uncommitted
831 840 .TE
832 841
833 842
834 843 .SH SEE ALSO
835 844 .sp
836 845 .LP
837 846 .BR zfs (1M)
|
↓ open down ↓ |
410 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX