]> git.proxmox.com Git - pve-docs.git/blobdiff - pve-storage-dir.adoc
totp: fix copy/paste mistake
[pve-docs.git] / pve-storage-dir.adoc
index b8d89f865cdf0202b08b48bad7aee2db2d357bad..3367394cd80827c5c42a1cd8e538d376438e42c0 100644 (file)
@@ -1,7 +1,6 @@
+[[storage_directory]]
 Directory Backend
 -----------------
-include::attributes.txt[]
-
 ifdef::wiki[]
 :pve-toplevel:
 :title: Storage: Directory
@@ -40,28 +39,39 @@ storage backends.
 |ISO images          |`template/iso/`
 |Container templates |`template/cache/`
 |Backup files        |`dump/`
+|Snippets            |`snippets/`
 |===========================================================
 
 
 Configuration
 ~~~~~~~~~~~~~
 
-This backend supports all common storage properties, and adds an
-additional property called `path` to specify the directory. This
-needs to be an absolute file system path.
+This backend supports all common storage properties, and adds two
+additional properties. The `path` property is used to specify the
+directory. This needs to be an absolute file system path.
+
+The optional `content-dirs` property allows for the default layout
+to be changed. It consists of a comma-separated list of identifiers
+in the following format:
+
+ vtype=path
+
+Where `vtype` is one of the allowed content types for the storage, and
+`path` is a path relative to the mountpoint of the storage.
 
 .Configuration Example (`/etc/pve/storage.cfg`)
 ----
 dir: backup
         path /mnt/backup
         content backup
-        maxfiles 7
+        prune-backups keep-last=7
+        max-protected-backups 3
+        content-dirs backup=custom/backup/dir
 ----
 
-Above configuration defines a storage pool called `backup`. That pool
-can be used to store up to 7 backups (`maxfiles 7`) per VM. The real
-path for the backup files is `/mnt/backup/dump/...`.
-
+The above configuration defines a storage pool called `backup`. That pool can be
+used to store up to 7 regular backups (`keep-last=7`) and 3 protected backups
+per VM. The real path for the backup files is `/mnt/backup/custom/backup/dir/...`.
 
 File naming conventions
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -108,8 +118,8 @@ feature to create clones.
 .Storage features for backend `dir`
 [width="100%",cols="m,m,3*d",options="header"]
 |==============================================================================
-|Content types                     |Image formats         |Shared |Snapshots |Clones
-|images rootdir vztempl iso backup |raw qcow2 vmdk subvol |no     |qcow2     |qcow2
+|Content types                              |Image formats         |Shared |Snapshots |Clones
+|images rootdir vztmpl iso backup snippets  |raw qcow2 vmdk subvol |no     |qcow2     |qcow2
 |==============================================================================