From 5929511f70f44f0323a0c1314ab16d42c056d604 Mon Sep 17 00:00:00 2001 From: Georgy Okrokvertskhov Date: Tue, 23 Sep 2014 15:45:35 -0700 Subject: [PATCH] Add documentation for a new storage file permissions option This patch adds a detailed description for filesystem_store_file_perm option which was added in https://review.openstack.org/#/c/119529. Change-Id: Ia567b9d56891940a8170d67d95c1cb318545094e --- doc/source/configuring.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/source/configuring.rst b/doc/source/configuring.rst index 974194702b..17a7ae4c5c 100644 --- a/doc/source/configuring.rst +++ b/doc/source/configuring.rst @@ -418,6 +418,23 @@ the filesystem storage backend will attempt to create this directory if it does not exist. Ensure that the user that ``glance-api`` runs under has write permissions to this directory. +* ``filesystem_store_file_perm=PERM_MODE`` + +Optional. Default: ``0`` + +Can only be specified in configuration files. + +`This option is specific to the filesystem storage backend.` + +The required permission value, in octal representation, for the created image file. +You can use this value to specify the user of the consuming service (such as Nova) as +the only member of the group that owns the created files. To keep the default value, +assign a permission value that is less than or equal to 0. Note that the file owner +must maintain read permission; if this value removes that permission an error message +will be logged and the BadStoreConfiguration exception will be raised. If the Glance +service has insufficient privileges to change file access permissions, a file will still +be saved, but a warning message will appear in the Glance log. + Configuring the Filesystem Storage Backend with multiple stores ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~