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