-gridmapfilegrid-mapfile
This file must contain FQAN to pool name mappings. It is strongly advised to set this option and
to set it to an absolute path to avoid usage of the wrong file(path). When unset, the plugin will
try to obtain the value from one of the environment variables (see ENVIRONMENT). When those are
also unset, the default depends on whether the plugin runs inside a (setuid-)root application. In
the (setuid-)root case, the default is /etc/grid-security/grid-mapfile. In the non-(setuid-)root
case, the default is <homedir>/.gridmap. In a (setuid-)root application, relative paths are taken
with respect to /etc/grid-security/.
-gridmapdirgridmapdir
A directory used for the mapping database. If this option is unset, the plugin will try to obtain
the value from the environment variable GRIDMAPDIR (see ENVIRONMENT). In a (setuid-)root applica‐
tion, relative paths are taken with respect to /etc/grid-security/.
--do-not-add-primary-gid-from-mapped-account
After the account is mapped, do NOT add the primary Group ID from the passwd-file/LDAP of the
mapped account as a part of the mapping result. Default is NOT to add the primary Group ID, un‐
less --use-account-gid is specified. See also --add-primary-gid-from-mapped-account, --add-prima‐ry-gid-as-secondary-gid-from-mapped-account and --use-account-gid.
--add-primary-gid-from-mapped-account
After the account is mapped, add the primary Group ID from the passwd-file/LDAP of the mapped ac‐
count as a part of the mapping result. Default is NOT to add the primary Group ID, unless --use-account-gid is specified. See also --do-not-add-primary-gid-from-mapped-account, --add-primary-gid-as-secondary-gid-from-mapped-account and --use-account-gid.
--add-primary-gid-as-secondary-gid-from-mapped-account
After the account is mapped, add the primary Group ID from the passwd-file/LDAP of the mapped ac‐
count as a secondary Group ID as a part of the mapping result (possibly in addition to adding it
as a primary Group ID). Default is NOT to add it at all. See also --do-not-add-primary-gid-from-mapped-account, --add-primary-gid-from-mapped-account and --use-account-gid.
--do-not-add-secondary-gids-from-mapped-account
After the account is mapped, do NOT add the secondary Group ID(s) from the groups-file/LDAP of the
mapped account as secondary Group ID(s) as a part of the mapping result. Default is NOT to add
the sGIDs, unless --use-account-gid is specified. See also --add-secondary-gids-from-mapped-ac‐count--use-account-gid.
--add-secondary-gids-from-mapped-account
After the account is mapped, add the secondary Group ID(s) from the groups-file/LDAP of the mapped
account as secondary Group ID(s) as a part of the mapping result. Default is NOT to add the sec‐
ondary Group ID(s), unless --use-account-gid is specified. See also --do-not-add-secondary-gids-from-mapped-account--use-account-gid.
--use-voms-gid|--use_voms_gid|-use_voms_gid
This option has the opposite effect of the option --use-account-gid, instructing the plugin NOT to
add the mapped account group information to the mapping result. This is currently already the de‐
fault and hence this option has no effect. See also --use-account-gid.
--use-account-gid
By default this plugin will NOT add the primary and secondary Group ID(s) from the passwd-
file/groups-file/LDAP of the mapped account as part of the mapping result. Specifying this option
will override that default. Part or all of the group information can still be added or removed by
using the --add-* and --do-not-add-* flags. See also --use-voms-gid.
--require-primary-gid
The group names already present in the LCMAPS mapping store prior to the running of this plugin
will be used to create the (URL encoded) lease name in the gridmapdir. This option can be used to
enforce the existence of a primary Group ID prior to running this plug-in, which can be done by
running other plugins earlier on in the policy. Default is not to require a primary GID.
--do-not-require-primary-gid
This option has the opposite effect of the option --require-primary-gid, instructing the plugin
NOT to enforce the presence of a primary GID prior to its running. This is currently already the
default and hence this option has no effect. See also --require-primary-gid.
--do-not-use-secondary-gids
This option will prevent adding mapped secondary group names to the lease name. Default is: add
secondary group names to the lease name.
-override_inconsistency
Moving a user from one pool to another (because of a VO change) should normally only be done by
changing the grid-mapfile indicating the new pool for this user. If the resulting URL-encoded
lease (hardlink) already exists but points to a different pool account then would result from the
running of this plugin, the plugin would normally fail. This option instructs the plugin to remap
to the new pool account.
-max_mappings_per_credentialmaximumnumberofmappings
This feature is deprecated. It was intended to work together with the Globus Dynamic Account Ser‐
vice/Workspace Service. This value indicates the maximum number of accounts a user, or more
specifically a set of credentials (=DN + FQANS), can be mapped to. Normally this number is 1. But
if each job should run under its own account the number should be increased. Whether LCMAPS will
actually use the mapcounter depends on the LCMAPS interface being used. The lease name (or poolin‐
dex) in the case of mapcounters looks like:
url_encoded(<DN>):gid1[:gid2[:gid3[...]]]:mapcount=<mapnumber>)
-strict_poolprefix_match{yes|no}
If this is set to 'yes', a line in the grid-mapfile like <FQAN>.pool will result in mapping pool
accounts matching only the regexp pool[0-9]+. Otherwise it will be allowed to match the wider
range of pool.* (legacy behaviour).