fixup: s/devies/devices/

[pve-docs.git] / pvesm.1-synopsis.adoc

diff --git a/pvesm.1-synopsis.adoc b/pvesm.1-synopsis.adoc
index 56f697ada3294d05a327c0e388f87dc0895438cc..5a71906311410773811026056d8fab464ad89d78 100644 (file)
--- a/pvesm.1-synopsis.adoc
+++ b/pvesm.1-synopsis.adoc
@@ -4,7 +4,7 @@
 
 Create a new storage.
 
 
 Create a new storage.
 

-`<type>`: `<dir | drbd | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | rbd | sheepdog | zfs | zfspool>` ::
+`<type>`: `<cephfs | cifs | dir | drbd | fake | glusterfs | iscsi | iscsidirect | lvm | lvmthin | nfs | rbd | sheepdog | zfs | zfspool>` ::

 
 Storage type.
 
 
 Storage type.
 


@@ -12,153 +12,182 @@ Storage type.
 
 The storage identifier.
 
 
 The storage identifier.
 

-`-authsupported` `<string>` ::
+`--authsupported` `<string>` ::

 
 Authsupported.
 
 
 Authsupported.
 

-`-base` `<string>` ::
+`--base` `<string>` ::

 
 Base volume. This volume is automatically activated.
 
 
 Base volume. This volume is automatically activated.
 

-`-blocksize` `<string>` ::
+`--blocksize` `<string>` ::

 
 block size
 
 
 block size
 

-`-comstar_hg` `<string>` ::
+`--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
+
+Set bandwidth/io limits various operations.
+
+`--comstar_hg` `<string>` ::

 
 host group for comstar views
 
 
 host group for comstar views
 

-`-comstar_tg` `<string>` ::
+`--comstar_tg` `<string>` ::

 
 target group for comstar views
 
 
 target group for comstar views
 

-`-content` `<string>` ::
+`--content` `<string>` ::

 
 Allowed content types.
 +
 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
 
 
 Allowed content types.
 +
 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
 

-`-disable` `<boolean>` ::
+`--disable` `<boolean>` ::

 
 Flag to disable the storage.
 
 
 Flag to disable the storage.
 

-`-export` `<string>` ::
+`--domain` `<string>` ::
+
+CIFS domain.
+
+`--export` `<string>` ::

 
 NFS export path.
 
 
 NFS export path.
 

-`-format` `<string>` ::
+`--format` `<string>` ::

 
 Default image format.
 
 
 Default image format.
 

-`-is_mountpoint` `<boolean>` ('default =' `no`)::
+`--fuse` `<boolean>` ::

 
 

-Assume the directory is an externally managed mountpoint. If nothing is mounted the storage will be considered offline.
+Mount CephFS through FUSE.

 
 

-`-iscsiprovider` `<string>` ::
+`--is_mountpoint` `<string>` ('default =' `no`)::
+
+Assume the given path is an externally managed mountpoint and consider the storage offline if it is not mounted. Using a boolean (yes/no) value serves as a shortcut to using the target path in this field.
+
+`--iscsiprovider` `<string>` ::

 
 iscsi provider
 
 
 iscsi provider
 

-`-krbd` `<boolean>` ::
+`--krbd` `<boolean>` ::
+
+Always access rbd through krbd kernel module.
+
+`--lio_tpg` `<string>` ::

 
 

-Access rbd through krbd kernel module.
+target portal group for Linux LIO targets

 
 

-`-maxfiles` `<integer> (0 - N)` ::
+`--maxfiles` `<integer> (0 - N)` ::

 
 Maximal number of backup files per VM. Use '0' for unlimted.
 
 
 Maximal number of backup files per VM. Use '0' for unlimted.
 

-`-mkdir` `<boolean>` ('default =' `yes`)::
+`--mkdir` `<boolean>` ('default =' `yes`)::

 
 Create the directory if it doesn't exist.
 
 
 Create the directory if it doesn't exist.
 

-`-monhost` `<string>` ::
+`--monhost` `<string>` ::

 
 

-Monitors daemon ips.
+IP addresses of monitors (for external clusters).

 
 

-`-nodes` `<string>` ::
+`--nodes` `<string>` ::

 
 List of cluster node names.
 
 
 List of cluster node names.
 

-`-nowritecache` `<boolean>` ::
+`--nowritecache` `<boolean>` ::

 
 disable write caching on the target
 
 
 disable write caching on the target
 

-`-options` `<string>` ::
+`--options` `<string>` ::

 
 NFS mount options (see 'man nfs')
 
 
 NFS mount options (see 'man nfs')
 

-`-path` `<string>` ::
+`--password` `<password>` ::
+
+Password for CIFS share.
+
+`--path` `<string>` ::

 
 File system path.
 
 
 File system path.
 

-`-pool` `<string>` ::
+`--pool` `<string>` ::

 
 Pool.
 
 
 Pool.
 

-`-portal` `<string>` ::
+`--portal` `<string>` ::

 
 iSCSI portal (IP or DNS name with optional port).
 
 
 iSCSI portal (IP or DNS name with optional port).
 

-`-redundancy` `<integer> (1 - 16)` ('default =' `2`)::
+`--redundancy` `<integer> (1 - 16)` ('default =' `2`)::

 
 The redundancy count specifies the number of nodes to which the resource should be deployed. It must be at least 1 and at most the number of nodes in the cluster.
 
 
 The redundancy count specifies the number of nodes to which the resource should be deployed. It must be at least 1 and at most the number of nodes in the cluster.
 

-`-saferemove` `<boolean>` ::
+`--saferemove` `<boolean>` ::

 
 Zero-out data when removing LVs.
 
 
 Zero-out data when removing LVs.
 

-`-saferemove_throughput` `<string>` ::
+`--saferemove_throughput` `<string>` ::

 
 Wipe throughput (cstream -t parameter value).
 
 
 Wipe throughput (cstream -t parameter value).
 

-`-server` `<string>` ::
+`--server` `<string>` ::

 
 Server IP or DNS name.
 
 
 Server IP or DNS name.
 

-`-server2` `<string>` ::
+`--server2` `<string>` ::

 
 Backup volfile server IP or DNS name.
 +
 NOTE: Requires option(s): `server`
 
 
 Backup volfile server IP or DNS name.
 +
 NOTE: Requires option(s): `server`
 

-`-shared` `<boolean>` ::
+`--share` `<string>` ::
+
+CIFS share.
+
+`--shared` `<boolean>` ::

 
 Mark storage as shared.
 
 
 Mark storage as shared.
 

-`-sparse` `<boolean>` ::
+`--smbversion` `<2.0 | 2.1 | 3.0>` ::
+
+SMB protocol version
+
+`--sparse` `<boolean>` ::

 
 use sparse volumes
 
 
 use sparse volumes
 

-`-tagged_only` `<boolean>` ::
+`--subdir` `<string>` ::
+
+Subdir to mount.
+
+`--tagged_only` `<boolean>` ::

 
 Only use logical volumes tagged with 'pve-vm-ID'.
 
 
 Only use logical volumes tagged with 'pve-vm-ID'.
 

-`-target` `<string>` ::
+`--target` `<string>` ::

 
 iSCSI target.
 
 
 iSCSI target.
 

-`-thinpool` `<string>` ::
+`--thinpool` `<string>` ::

 
 LVM thin pool LV name.
 
 
 LVM thin pool LV name.
 

-`-transport` `<rdma | tcp | unix>` ::
+`--transport` `<rdma | tcp | unix>` ::

 
 Gluster transport: tcp or rdma
 
 
 Gluster transport: tcp or rdma
 

-`-username` `<string>` ::
+`--username` `<string>` ::

 
 RBD Id.
 
 
 RBD Id.
 

-`-vgname` `<string>` ::
+`--vgname` `<string>` ::

 
 Volume group name.
 
 
 Volume group name.
 

-`-volume` `<string>` ::
+`--volume` `<string>` ::

 
 Glusterfs Volume.
 
 
 Glusterfs Volume.
 

-
-
-

 *pvesm alloc* `<storage> <vmid> <filename> <size>` `[OPTIONS]`
 
 Allocate disk images.
 *pvesm alloc* `<storage> <vmid> <filename> <size>` `[OPTIONS]`
 
 Allocate disk images.


@@ -179,25 +208,51 @@ The name of the file to create.
 
 Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M)
 
 
 Size in kilobyte (1024 bytes). Optional suffixes 'M' (megabyte, 1024K) and 'G' (gigabyte, 1024M)
 

-`-format` `<qcow2 | raw | subvol>` ::
+`--format` `<qcow2 | raw | subvol>` ::

 
 no description available
 +
 NOTE: Requires option(s): `size`
 
 
 no description available
 +
 NOTE: Requires option(s): `size`
 

+*pvesm cifsscan*

 
 

+An alias for 'pvesm scan cifs'.

 
 

+*pvesm export* `<volume> <format> <filename>` `[OPTIONS]`

 
 

-*pvesm extractconfig* `<volume>`
-
-Extract configuration from vzdump backup archive.
+Export a volume.

 
 `<volume>`: `<string>` ::
 
 Volume identifier
 
 
 `<volume>`: `<string>` ::
 
 Volume identifier
 

+`<format>`: `<qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::
+
+Export stream format
+
+`<filename>`: `<string>` ::
+
+Destination file name
+
+`--base` `(?^:[a-z0-9_\-]{1,40})` ::
+
+Snapshot to start an incremental stream from
+
+`--snapshot` `(?^:[a-z0-9_\-]{1,40})` ::
+
+Snapshot to export
+
+`--with-snapshots` `<boolean>` ('default =' `0`)::

 
 

+Whether to include intermediate snapshots in the stream

 
 

+*pvesm extractconfig* `<volume>`
+
+Extract configuration from vzdump backup archive.
+
+`<volume>`: `<string>` ::
+
+Volume identifier

 
 *pvesm free* `<volume>` `[OPTIONS]`
 
 
 *pvesm free* `<volume>` `[OPTIONS]`
 


@@ -207,49 +262,57 @@ Delete volume
 
 Volume identifier
 
 
 Volume identifier
 

-`-storage` `<string>` ::
+`--storage` `<string>` ::

 
 The storage identifier.
 
 
 The storage identifier.
 

+*pvesm glusterfsscan*

 
 

+An alias for 'pvesm scan glusterfs'.

 
 

+*pvesm help* `[OPTIONS]`

 
 

-*pvesm glusterfsscan* `<server>`
-
-Scan remote GlusterFS server.
-
-`<server>`: `<string>` ::
+Get help about specified command.

 
 

-no description available
+`--extra-args` `<array>` ::

 
 

+Shows help for a specific command

 
 

+`--verbose` `<boolean>` ::

 
 

+Verbose output format.

 
 

-*pvesm help* `[<cmd>]` `[OPTIONS]`
+*pvesm import* `<volume> <format> <filename>` `[OPTIONS]`

 
 

-Get help about specified command.
+Import a volume.

 
 

-`<cmd>`: `<string>` ::
+`<volume>`: `<string>` ::

 
 

-Command name
+Volume identifier

 
 

-`-verbose` `<boolean>` ::
+`<format>`: `<qcow2+size | raw+size | tar+size | vmdk+size | zfs>` ::

 
 

-Verbose output format.
+Import stream format

 
 

+`<filename>`: `<string>` ::

 
 

+Source file name

 
 

+`--base` `(?^:[a-z0-9_\-]{1,40})` ::

 
 

-*pvesm iscsiscan* `-portal <string>` `[OPTIONS]`
+Base snapshot of an incremental stream

 
 

-Scan remote iSCSI server.
+`--delete-snapshot` `(?^:[a-z0-9_\-]{1,80})` ::

 
 

-`-portal` `<string>` ::
+A snapshot to delete on success

 
 

-no description available
+`--with-snapshots` `<boolean>` ('default =' `0`)::

 
 

+Whether the stream includes intermediate snapshots

 
 

+*pvesm iscsiscan*

 
 

+An alias for 'pvesm scan iscsi'.

 
 *pvesm list* `<storage>` `[OPTIONS]`
 
 
 *pvesm list* `<storage>` `[OPTIONS]`
 


@@ -259,64 +322,101 @@ List storage content.
 
 The storage identifier.
 
 
 The storage identifier.
 

-`-content` `<string>` ::
+`--content` `<string>` ::

 
 Only list content of this type.
 
 
 Only list content of this type.
 

-`-vmid` `<integer> (1 - N)` ::
+`--vmid` `<integer> (1 - N)` ::

 
 Only list images for this VM
 
 
 Only list images for this VM
 

+*pvesm lvmscan*

 
 

+An alias for 'pvesm scan lvm'.

 
 

+*pvesm lvmthinscan*

 
 

-*pvesm lvmscan*
+An alias for 'pvesm scan lvmthin'.

 
 

-List local LVM volume groups.
+*pvesm nfsscan*

 
 

+An alias for 'pvesm scan nfs'.

 
 

+*pvesm path* `<volume>`

 
 

-*pvesm lvmthinscan* `<vg>`
+Get filesystem path for specified volume

 
 

-List local LVM Thin Pools.
+`<volume>`: `<string>` ::

 
 

-`<vg>`: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` ::
+Volume identifier

 
 

-no description available
+*pvesm remove* `<storage>`
+
+Delete storage configuration.

 
 

+`<storage>`: `<string>` ::

 
 

+The storage identifier.

 
 

-*pvesm nfsscan* `<server>`
+*pvesm scan cifs* `<server>` `[OPTIONS]`

 
 

-Scan remote NFS server.
+Scan remote CIFS server.

 
 `<server>`: `<string>` ::
 
 
 `<server>`: `<string>` ::
 

-no description available
+The server address (name or IP).

 
 

+`--domain` `<string>` ::

 
 

+SMB domain (Workgroup).

 
 

+`--password` `<password>` ::

 
 

-*pvesm path* `<volume>`
+User password.

 
 

-Get filesystem path for specified volume
+`--username` `<string>` ::

 
 

-`<volume>`: `<string>` ::
+User name.

 
 

-Volume identifier
+*pvesm scan glusterfs* `<server>`

 
 

+Scan remote GlusterFS server.

 
 

+`<server>`: `<string>` ::

 
 

+The server address (name or IP).

 
 

-*pvesm remove* `<storage>`
+*pvesm scan iscsi* `<portal>`

 
 

-Delete storage configuration.
+Scan remote iSCSI server.

 
 

-`<storage>`: `<string>` ::
+`<portal>`: `<string>` ::

 
 

-The storage identifier.
+The iSCSI portal (IP or DNS name with optional port).
+
+*pvesm scan lvm*
+
+List local LVM volume groups.
+
+*pvesm scan lvmthin* `<vg>`
+
+List local LVM Thin Pools.
+
+`<vg>`: `[a-zA-Z0-9\.\+\_][a-zA-Z0-9\.\+\_\-]+` ::
+
+no description available
+
+*pvesm scan nfs* `<server>`
+
+Scan remote NFS server.

 
 

+`<server>`: `<string>` ::
+
+The server address (name or IP).

 
 

+*pvesm scan zfs*
+
+Scan zfs pool list on local node.

 
 *pvesm set* `<storage>` `[OPTIONS]`
 
 
 *pvesm set* `<storage>` `[OPTIONS]`
 


@@ -326,144 +426,172 @@ Update storage configuration.
 
 The storage identifier.
 
 
 The storage identifier.
 

-`-blocksize` `<string>` ::
+`--blocksize` `<string>` ::

 
 block size
 
 
 block size
 

-`-comstar_hg` `<string>` ::
+`--bwlimit` `[clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]` ::
+
+Set bandwidth/io limits various operations.
+
+`--comstar_hg` `<string>` ::

 
 host group for comstar views
 
 
 host group for comstar views
 

-`-comstar_tg` `<string>` ::
+`--comstar_tg` `<string>` ::

 
 target group for comstar views
 
 
 target group for comstar views
 

-`-content` `<string>` ::
+`--content` `<string>` ::

 
 Allowed content types.
 +
 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
 
 
 Allowed content types.
 +
 NOTE: the value 'rootdir' is used for Containers, and value 'images' for VMs.
 

-`-delete` `<string>` ::
+`--delete` `<string>` ::

 
 A list of settings you want to delete.
 
 
 A list of settings you want to delete.
 

-`-digest` `<string>` ::
+`--digest` `<string>` ::

 
 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
 
 
 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
 

-`-disable` `<boolean>` ::
+`--disable` `<boolean>` ::

 
 Flag to disable the storage.
 
 
 Flag to disable the storage.
 

-`-format` `<string>` ::
+`--domain` `<string>` ::
+
+CIFS domain.
+
+`--format` `<string>` ::

 
 Default image format.
 
 
 Default image format.
 

-`-is_mountpoint` `<boolean>` ('default =' `no`)::
+`--fuse` `<boolean>` ::

 
 

-Assume the directory is an externally managed mountpoint. If nothing is mounted the storage will be considered offline.
+Mount CephFS through FUSE.

 
 

-`-krbd` `<boolean>` ::
+`--is_mountpoint` `<string>` ('default =' `no`)::

 
 

-Access rbd through krbd kernel module.
+Assume the given path is an externally managed mountpoint and consider the storage offline if it is not mounted. Using a boolean (yes/no) value serves as a shortcut to using the target path in this field.

 
 

-`-maxfiles` `<integer> (0 - N)` ::
+`--krbd` `<boolean>` ::
+
+Always access rbd through krbd kernel module.
+
+`--lio_tpg` `<string>` ::
+
+target portal group for Linux LIO targets
+
+`--maxfiles` `<integer> (0 - N)` ::

 
 Maximal number of backup files per VM. Use '0' for unlimted.
 
 
 Maximal number of backup files per VM. Use '0' for unlimted.
 

-`-mkdir` `<boolean>` ('default =' `yes`)::
+`--mkdir` `<boolean>` ('default =' `yes`)::

 
 Create the directory if it doesn't exist.
 
 
 Create the directory if it doesn't exist.
 

-`-nodes` `<string>` ::
+`--monhost` `<string>` ::
+
+IP addresses of monitors (for external clusters).
+
+`--nodes` `<string>` ::

 
 List of cluster node names.
 
 
 List of cluster node names.
 

-`-nowritecache` `<boolean>` ::
+`--nowritecache` `<boolean>` ::

 
 disable write caching on the target
 
 
 disable write caching on the target
 

-`-options` `<string>` ::
+`--options` `<string>` ::

 
 NFS mount options (see 'man nfs')
 
 
 NFS mount options (see 'man nfs')
 

-`-pool` `<string>` ::
+`--password` `<string>` ::
+
+Password for CIFS share.
+
+`--pool` `<string>` ::

 
 Pool.
 
 
 Pool.
 

-`-redundancy` `<integer> (1 - 16)` ('default =' `2`)::
+`--redundancy` `<integer> (1 - 16)` ('default =' `2`)::

 
 The redundancy count specifies the number of nodes to which the resource should be deployed. It must be at least 1 and at most the number of nodes in the cluster.
 
 
 The redundancy count specifies the number of nodes to which the resource should be deployed. It must be at least 1 and at most the number of nodes in the cluster.
 

-`-saferemove` `<boolean>` ::
+`--saferemove` `<boolean>` ::

 
 Zero-out data when removing LVs.
 
 
 Zero-out data when removing LVs.
 

-`-saferemove_throughput` `<string>` ::
+`--saferemove_throughput` `<string>` ::

 
 Wipe throughput (cstream -t parameter value).
 
 
 Wipe throughput (cstream -t parameter value).
 

-`-server` `<string>` ::
+`--server` `<string>` ::

 
 Server IP or DNS name.
 
 
 Server IP or DNS name.
 

-`-server2` `<string>` ::
+`--server2` `<string>` ::

 
 Backup volfile server IP or DNS name.
 +
 NOTE: Requires option(s): `server`
 
 
 Backup volfile server IP or DNS name.
 +
 NOTE: Requires option(s): `server`
 

-`-shared` `<boolean>` ::
+`--shared` `<boolean>` ::

 
 Mark storage as shared.
 
 
 Mark storage as shared.
 

-`-sparse` `<boolean>` ::
+`--smbversion` `<2.0 | 2.1 | 3.0>` ::
+
+SMB protocol version
+
+`--sparse` `<boolean>` ::

 
 use sparse volumes
 
 
 use sparse volumes
 

-`-tagged_only` `<boolean>` ::
+`--subdir` `<string>` ::
+
+Subdir to mount.
+
+`--tagged_only` `<boolean>` ::

 
 Only use logical volumes tagged with 'pve-vm-ID'.
 
 
 Only use logical volumes tagged with 'pve-vm-ID'.
 

-`-transport` `<rdma | tcp | unix>` ::
+`--transport` `<rdma | tcp | unix>` ::

 
 Gluster transport: tcp or rdma
 
 
 Gluster transport: tcp or rdma
 

-`-username` `<string>` ::
+`--username` `<string>` ::

 
 RBD Id.
 
 
 RBD Id.
 

-
-
-

 *pvesm status* `[OPTIONS]`
 
 Get status for all datastores.
 
 *pvesm status* `[OPTIONS]`
 
 Get status for all datastores.
 

-`-content` `<string>` ::
+`--content` `<string>` ::

 
 Only list stores which support this content type.
 
 
 Only list stores which support this content type.
 

-`-enabled` `<boolean>` ('default =' `0`)::
+`--enabled` `<boolean>` ('default =' `0`)::

 
 Only list stores which are enabled (not disabled in config).
 
 
 Only list stores which are enabled (not disabled in config).
 

-`-storage` `<string>` ::
+`--format` `<boolean>` ('default =' `0`)::

 
 

-Only list status for  specified storage
+Include information about formats

 
 

-`-target` `<string>` ::
-
-If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.
+`--storage` `<string>` ::

 
 

+Only list status for  specified storage

 
 

+`--target` `<string>` ::

 
 

+If target is different to 'node', we only lists shared storages which content is accessible on this 'node' and the specified 'target' node.

 
 *pvesm zfsscan*
 
 
 *pvesm zfsscan*
 

-Scan zfs pool list on local node.
-
-
+An alias for 'pvesm scan zfs'.