string enumeration definitions for bcfg2
Narayan Desai, Argonne National Laboratory
Action entries are external shell commands that are executed
either before bundle installation, after bundle installation
or both.
When the action is run. Actions with "pre" timing are run
after important entries have been installed and before
bundle entries are installed. Actions with "post" timing
are run after bundle entries are installed.
If the action is always run, or is only run when a bundle
has been modified.
Whether or not to check the return code of the action. If
this is "check", then a non-zero return code will result in
the entry being flagged as bad.
Also execute the action in build mode.
The freeform name of the action.
The command to run.
Whether the command string should be executeed within a shell.
If enabled flow control and other shell-specific things can
be used.
Define POSIX ACLs for a Path entry.
ACL type
ACL scope. This is omitted for
:xml:attribute:`ACLType:type` = ``default``.
Permissions for the ACL. This can either be a single octal
digit (e.g., ``6`` would indicate read and write, but not
execute), or a symbolic mode including 'r', 'w', and 'x'.
You can include '-' for operations that are not permitted,
but it's not required. I.e., all of the following are
identical::
perms="5"
perms="rx"
perms="r-x"
User the ACL applies to (with :xml:attribute:`ACLType:scope`
= ``user``).
Group the ACL applies to (with
:xml:attribute:`ACLType:scope` = ``group``).
Manage filesystem paths -- files, directories, symlinks, etc.
Type of path to manage.
Full path.
Type of device.
Major device number (``block`` and ``char`` devices only).
Minor device number (``block`` and ``char`` devices only).
Permissions mode in octal format.
Owner username or UID number
Group name or GID number
SELinux context for the path. This should be a full
context, not just the type. E.g.,
``system_u:object_r:etc_t:s0``, not just ``etc_t``. You can
also specify ``__default__``, which will restore the context
of the file to the default set by policy. See
:ref:`server-selinux` for more information.
Recursively remove files or set permissions, as appropriate.
Remove entries that are not in the Bcfg2 specification from
the directory.
File to link to
The file entry has no content. This must be set as a
safeguard against accidentally empty content.
The VCS backend to checkout contents from.
The revision to checkout.
The VCS URL to checkout.
The name of the encryption passphrase that the text content
of this tag is encrypted with.
Specify additional supplementary groups for the POSIXUser
The name of the supplementary group. This can also be
specified as content of the tag, although that is
deprecated.
The POSIXUser tag allows you to create users on client machines.
Username
User ID number. If this is not specified, each client is
allowed to set the UID.
Name of the user's primary group. If this is not set, the
user's primary group will be the same as the username.
This field is typically used to record general information
about the account or its user(s) such as their real name
and phone number. If this is not set, the GECOS will be
the same as the username.
User's home directory. Default is ``/root`` for the root
user, ``/home/<username>`` otherwise.
User's shell
The POSIXGroup tag allows you to create groups on client
machines.
Username
Group ID number. If this is not specified, each client is
allowed to set the GID.