]> git.proxmox.com Git - pve-docs.git/blobdiff - pve-storage-cifs.adoc
vzdump: drop overly scary & outdated warning about fleecing
[pve-docs.git] / pve-storage-cifs.adoc
index 7c90cbc3747993734db80f1e1b7a2ada5775645a..d5d54e72e4bb6d4b833b711774c9294229930826 100644 (file)
@@ -10,7 +10,7 @@ Storage pool type: `cifs`
 
 The CIFS backend extends the directory backend, so that no manual
 setup of a CIFS mount is needed. Such a storage can be added directly
-through the {pve} API or the WebUI, with all our backend advantages,
+through the {pve} API or the web UI, with all our backend advantages,
 like server heartbeat check or comfortable selection of exported
 shares.
 
@@ -31,8 +31,8 @@ server, or list the server in the local `/etc/hosts` file.
 
 share::
 
-CIFS share to use (get available ones with `pvesm cifsscan` or the WebUI).
-Required.
+CIFS share to use (get available ones with `pvesm scan cifs <address>` or the
+web UI). Required.
 
 username::
 
@@ -42,7 +42,7 @@ password::
 
 The user password. Optional.
 It will be saved in a file only readable by root
-(`/etc/pve/priv/<STORAGE_ID>.cred`).
+(`/etc/pve/priv/storage/<STORAGE-ID>.pw`).
 
 domain::
 
@@ -57,6 +57,22 @@ path::
 
 The local mount point. Optional, defaults to `/mnt/pve/<STORAGE_ID>/`.
 
+content-dirs::
+
+Overrides for the default directory layout. Optional.
+
+options::
+
+Additional CIFS mount options (see `man mount.cifs`). Some options are set
+automatically and shouldn't be set here. {pve} will always set the option
+`soft`. Depending on the configuration, these options are set automatically:
+`username`, `credentials`, `guest`, `domain`, `vers`.
+
+subdir::
+
+The subdirectory of the share to mount. Optional, defaults to the root directory
+of the share.
+
 .Configuration Example (`/etc/pve/storage.cfg`)
 ----
 cifs: backup
@@ -64,8 +80,10 @@ cifs: backup
        server 10.0.0.11
        share VMData
        content backup
+       options noserverino,echo_interval=30
        username anna
        smbversion 3
+       subdir /data
 
 ----
 
@@ -89,7 +107,7 @@ Examples
 You can get a list of exported CIFS shares with:
 
 ----
-# pvesm cifsscan <server> [--username <username>] [--password]
+# pvesm scan cifs <server> [--username <username>] [--password]
 ----
 
 Then you could add this share as a storage to the whole {pve} cluster