docs: document 'dirs' parameter for directory storage

Signed-off-by: Leo Nunner <l.nunner@proxmox.com>
This commit is contained in:
Leo Nunner 2023-01-02 17:04:38 +01:00 committed by Wolfgang Bumiller
parent 3bd81d8da2
commit 432750f71e
3 changed files with 22 additions and 5 deletions

View File

@ -57,6 +57,10 @@ path::
The local mount point. Optional, defaults to `/mnt/pve/<STORAGE_ID>/`. The local mount point. Optional, defaults to `/mnt/pve/<STORAGE_ID>/`.
dirs::
Overrides for the default directory layout. Optional.
.Configuration Example (`/etc/pve/storage.cfg`) .Configuration Example (`/etc/pve/storage.cfg`)
---- ----
cifs: backup cifs: backup

View File

@ -46,9 +46,18 @@ storage backends.
Configuration Configuration
~~~~~~~~~~~~~ ~~~~~~~~~~~~~
This backend supports all common storage properties, and adds an This backend supports all common storage properties, and adds two
additional property called `path` to specify the directory. This additional properties. The `path` property is used to specify the
needs to be an absolute file system path. directory. This needs to be an absolute file system path.
The optional `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 an absolute file system path.
.Configuration Example (`/etc/pve/storage.cfg`) .Configuration Example (`/etc/pve/storage.cfg`)
---- ----
@ -57,12 +66,12 @@ dir: backup
content backup content backup
prune-backups keep-last=7 prune-backups keep-last=7
max-protected-backups 3 max-protected-backups 3
dirs backup:/custom/backup/dir
---- ----
The above configuration defines a storage pool called `backup`. That pool can be 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 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/dump/...`. per VM. The real path for the backup files is `/mnt/backup/custom/backup/dir/...`.
File naming conventions File naming conventions
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -40,6 +40,10 @@ path::
The local mount point (defaults to `/mnt/pve/<STORAGE_ID>/`). The local mount point (defaults to `/mnt/pve/<STORAGE_ID>/`).
dirs::
Overrides for the default directory layout. Optional.
options:: options::
NFS mount options (see `man nfs`). NFS mount options (see `man nfs`).