deb-manila/doc
Mark Sturdevant 8895ea2254 HP 3PAR uses scoped extra-specs to influence share creation options
Add support for share type extra-specs that can be used to influence
share creation options that are specific to 3PAR. These extra-specs
are scoped (use 'hp_3par:' prefix).

CIFS extra-specs include 'smb_abe' (access based enumeration),
'smb_cache' and 'smb_ca' (continuous availability). 'smb_ca' is
ignored until hp3parclient > 3.2.1.

The NFS extra-spec is 'nfs_options'. This value is a comma-separated
string as needed for the 3PAR createfshare -options value in the CLI.
The following values are not allowed because the driver uses
specific settings (for now): (no_)root_squash, (in)secure.
The following values are not allowed per HP 3PAR CLI support
requirements: no_subtree_check, fsid.
'rw' and 'ro' are not allowed because read-only access should be
controlled by Manila and not by extra-specs.
Additional value validation is left to the 3PAR CLI to handle.

Implements Blueprint: hp3par-extra-specs
Change-Id: Ia311cae718bf3998346b068aebb08a64924195de
2015-07-16 10:32:27 -07:00
..
ext py3: use six.moves.range instead of xrange 2014-12-27 18:41:21 +08:00
source HP 3PAR uses scoped extra-specs to influence share creation options 2015-07-16 10:32:27 -07:00
.gitignore Initialize from cinder 2013-08-08 10:34:06 -04:00
find_autodoc_modules.sh docs 2013-09-17 10:57:47 +03:00
generate_autodoc_index.sh modified docs 2013-09-17 12:21:17 +03:00
Makefile docs 2013-09-17 10:57:47 +03:00
README.rst docs 2013-09-17 10:57:47 +03:00

Building the docs

Dependencies

Sphinx

You'll need sphinx (the python one) and if you are using the virtualenv you'll need to install it in the virtualenv specifically so that it can load the manila modules.

pip install Sphinx
Graphviz

Some of the diagrams are generated using the dot language from Graphviz.

sudo apt-get install graphviz

Use make

Just type make:

% make

Look in the Makefile for more targets.

Manually

  1. Generate the code.rst file so that Sphinx will pull in our docstrings:

    % ./generate_autodoc_index.sh > source/code.rst
  2. Run `sphinx_build`:

    % sphinx-build -b html source build/html

The docs have been built

Check out the build directory to find them. Yay!