GRID-MAPFILE-ADD-(8) | Grid Community Toolkit Manual | GRID-MAPFILE-ADD-(8) |
grid-mapfile-add-entry - Add an entry to a gridmap file
grid-mapfile-add-entry [ -h | -help | -usage | -version | -versions ]
grid-mapfile-add-entry -dn DISTINGUISHED-NAME -ln LOCAL-NAME... [-d | -dryrun] [ -f MAPFILE | -mapfile MAPFILE ] [-force] [ -n ] [ -c ]
The grid-mapfile-add-entry program adds a new mapping from an X.509 distinguished name to a local POSIX user name to a gridmap file. Gridmap files are used as a simple authorization method for services such as GRAM5 or GridFTP.
The grid-mapfile-add-entry program verifies that the LOCAL-NAME is a valid user name on the system on which it was run, and that the mapping between DISTINGUISHED-NAME and LOCAL-NAME does not already exist in the gridmap file.
By default, grid-mapfile-add-entry will modify the gridmap file named by the GRIDMAP environment variable if present, or the file /etc/grid-security/grid-mapfile if not. This can be changed by the use of the -mapfile or -f command-line options.
If the gridmap file does not exist, grid-mapfile-add-entry will create it. If it already exists, grid-mapfile-add-entry will save the current contents of the file to a new file with the string .old appended to the file name.
The full set of command-line options to grid-mapfile-add-entry are:
-help, -usage
-version, -versions
-dn DISTINGUISHED-NAME
-ln LOCAL-NAME...
-d, -dryrun
-mapfile MAPFILE, -f MAPFILE
-force
-n
-c
Add a mapping between the current user’s certificate to the current user id to a gridmap file in $HOME/.gridmap:
% grid-mapfile-add-entry -f $HOME/.gridmap -dn "`grid-cert-info -subject`" -ln "`id -un`" Modifying /home/juser/.gridmap ... /home/juser/.gridmap does not exist... Attempting to create /home/juser/.gridmap New entry: "/DC=org/DC=example/DC=grid/CN=Joe User" juser (1) entry added
Add a mapping between the a distinguished name and multiple local names:
% grid-mapfile-add-entry -dn "/DC=org/DC=example/DC=grid/CN=Joe User" juser" local1 local2 Modifying /home/juser/.gridmap ... /home/juser/.gridmap does not exist... Attempting to create /home/juser/.gridmap New entry: "/DC=org/DC=example/DC=grid/CN=Joe User" local1,local2 (1) entry added
The following environment variables affect the execution of grid-mapfile-add-entry:
GRIDMAP
The following files affect the execution of grid-mapfile-add-entry:
/etc/grid-security/grid-mapfile
grid-mapfile-check-consistency(8), grid-mapfile-delete-entry(8)
Copyright © 1999-2016 University of Chicago
08/21/2020 | Grid Community Toolkit 6 |