]>
Commit | Line | Data |
---|---|---|
c5ebfbbe RW |
1 | .\" CDDL HEADER START |
2 | .\" | |
3 | .\" The contents of this file are subject to the terms of the | |
4 | .\" Common Development and Distribution License (the "License"). | |
5 | .\" You may not use this file except in compliance with the License. | |
6 | .\" | |
7 | .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE | |
8 | .\" or http://www.opensolaris.org/os/licensing. | |
9 | .\" See the License for the specific language governing permissions | |
10 | .\" and limitations under the License. | |
11 | .\" | |
12 | .\" When distributing Covered Code, include this CDDL HEADER in each | |
13 | .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE. | |
14 | .\" If applicable, add the following below this CDDL HEADER, with the | |
15 | .\" fields enclosed by brackets "[]" replaced with your own identifying | |
16 | .\" information: Portions Copyright [yyyy] [name of copyright owner] | |
17 | .\" | |
18 | .\" CDDL HEADER END | |
19 | .\" | |
c5ebfbbe RW |
20 | .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. |
21 | .\" Copyright (c) 2012, 2018 by Delphix. All rights reserved. | |
22 | .\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved. | |
23 | .\" Copyright (c) 2017 Datto Inc. | |
24 | .\" Copyright (c) 2018 George Melikov. All Rights Reserved. | |
25 | .\" Copyright 2017 Nexenta Systems, Inc. | |
26 | .\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved. | |
27 | .\" | |
f84fe3fc | 28 | .Dd May 27, 2021 |
c5ebfbbe | 29 | .Dt ZPOOL-ADD 8 |
6706552e | 30 | .Os |
f84fe3fc | 31 | . |
c5ebfbbe | 32 | .Sh NAME |
1e36af8c | 33 | .Nm zpool-add |
f84fe3fc | 34 | .Nd add vdevs to ZFS storage pool |
c5ebfbbe | 35 | .Sh SYNOPSIS |
1e36af8c | 36 | .Nm zpool |
c5ebfbbe RW |
37 | .Cm add |
38 | .Op Fl fgLnP | |
39 | .Oo Fl o Ar property Ns = Ns Ar value Oc | |
f84fe3fc AZ |
40 | .Ar pool vdev Ns … |
41 | . | |
c5ebfbbe | 42 | .Sh DESCRIPTION |
c5ebfbbe RW |
43 | Adds the specified virtual devices to the given pool. |
44 | The | |
45 | .Ar vdev | |
46 | specification is described in the | |
47 | .Em Virtual Devices | |
48 | section of | |
2badb345 | 49 | .Xr zpoolconcepts 7 . |
c5ebfbbe RW |
50 | The behavior of the |
51 | .Fl f | |
52 | option, and the device checks performed are described in the | |
53 | .Nm zpool Cm create | |
54 | subcommand. | |
55 | .Bl -tag -width Ds | |
56 | .It Fl f | |
57 | Forces use of | |
58 | .Ar vdev Ns s , | |
59 | even if they appear in use or specify a conflicting replication level. | |
60 | Not all devices can be overridden in this manner. | |
61 | .It Fl g | |
62 | Display | |
63 | .Ar vdev , | |
f84fe3fc AZ |
64 | GUIDs instead of the normal device names. |
65 | These GUIDs can be used in place of | |
c5ebfbbe RW |
66 | device names for the zpool detach/offline/remove/replace commands. |
67 | .It Fl L | |
68 | Display real paths for | |
69 | .Ar vdev Ns s | |
f84fe3fc AZ |
70 | resolving all symbolic links. |
71 | This can be used to look up the current block | |
72 | device name regardless of the | |
73 | .Pa /dev/disk | |
74 | path used to open it. | |
c5ebfbbe RW |
75 | .It Fl n |
76 | Displays the configuration that would be used without actually adding the | |
77 | .Ar vdev Ns s . | |
78 | The actual pool creation can still fail due to insufficient privileges or | |
79 | device sharing. | |
80 | .It Fl P | |
81 | Display real paths for | |
82 | .Ar vdev Ns s | |
f84fe3fc AZ |
83 | instead of only the last component of the path. |
84 | This can be used in conjunction with the | |
c5ebfbbe RW |
85 | .Fl L |
86 | flag. | |
87 | .It Fl o Ar property Ns = Ns Ar value | |
f84fe3fc AZ |
88 | Sets the given pool properties. |
89 | See the | |
2badb345 | 90 | .Xr zpoolprops 7 |
f84fe3fc AZ |
91 | manual page for a list of valid properties that can be set. |
92 | The only property supported at the moment is | |
93 | .Sy ashift . | |
c5ebfbbe | 94 | .El |
f84fe3fc | 95 | . |
c5ebfbbe | 96 | .Sh SEE ALSO |
c5ebfbbe RW |
97 | .Xr zpool-attach 8 , |
98 | .Xr zpool-import 8 , | |
99 | .Xr zpool-initialize 8 , | |
f84fe3fc AZ |
100 | .Xr zpool-online 8 , |
101 | .Xr zpool-remove 8 |