Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

grid-mapfile-delete-entry(8) [debian man page]

GRID-MAPFILE-DELET(8)						  Globus Commands					     GRID-MAPFILE-DELET(8)

NAME

       grid-mapfile-delete-entry - Remove entries from a gridmap file

SYNOPSIS

       grid-mapfile-delete-entry [-help] [-usage] [-version] [-versions]

       grid-mapfile-delete-entry {-dn DISTINGUISHED-NAME} {-ln LOCAL-NAME...}
				 [[-d] | [-dryrun]]
				 [[-mapfile MAPFILE] | [-f MAPFILE]]

DESCRIPTION

       The grid-mapfile-delete-entry program deletes mappings from a gridmap file. If both the -dn and -ln> options are specified,
       grid-mapfile-delete-entry removes entries which meet both criteria (remove entries mapping DISTINGUISHED-NAME to LOCAL-NAME for each
       LOCAL-NAME specified). If only -dn or -ln is specified all entries for that DISTINGUISHED-NAME or LOCAL-NAME are removed.

       By default, grid-mapfile-delete-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.

       Prior to modifying a gridmap file, grid-mapfile-delete-entry saves its current contents to a file with the string .old appended to the
       original file name.

       The full set of command-line options to grid-mapfile-delete-entry are:

       -help, -usage
	   Display the command-line options to grid-mapfile-delete-entry.

       -version, -versions
	   Display the version number of the grid-mapfile-delete-entry command. The second form includes more details.

       -dn DISTINGUISHED-NAME
	   The X.509 distinguished name to remove from the gridmap file. If the -ln option is not specified, remove all entries for this name;
	   otherwise, remove entries that match both this name and the local name. The name should be in OpenSSL's oneline format.

       -ln LOCAL-NAME...
	   The POSIX user name to remove from the gridmap file. Include multiple LOCAL-NAME strings after the -ln command-line option to remove
	   multiple names from the gridmap. If the -dn option is not specifeid, remove all entries for these names; otherwise, remove entries that
	   match the DISTINGUISHED-NAME and any of the LOCAL-NAME values.

       -d, -dryrun
	   Display diagnostics about what would be removed from the gridmap file, but don't actually modify the file.

       -mapfile MAPFILE, -f MAPFILE
	   Modify the gridmap file named by MAPFILE instead of the default.

EXAMPLES

       Remove all mappings for a distinguished name:

	   % grid-mapfile-delete-entry "/DC=org/DC=example/DC=grid/CN=Joe User"
	   Modifying /etc/grid-security/grid-mapfile ...
	   Deleting entry: "/DC=org/DC=example/DC=grid/CN=Joe User" juser,juser2
	   (1) entry deleted

       Remove the mapping between a distinguished name and a single local username:

	   % grid-mapfile-delete-entry "/DC=org/DC=example/DC=grid/CN=Joe User" -ln juser2
	   Modifying /etc/grid-security/grid-mapfile ...
	   Current entry: "/DC=org/DC=example/DC=grid/CN=Joe User" juser
	   (1) mapping removed: (juser2), (0) not present and ignored
	   (0) entries deleted

ENVIRONMENT VARIABLES

       The following environment variables affect the execution of grid-mapfile-delete-entry:

       GRIDMAP
	   Path to the default gridmap to modify.

FILES

       The following files affect the execution of grid-mapfile-delete-entry:

       /etc/grid-security/grid-mapfile
	   Path to the default gridmap to modify if GRIDMAP environment variable is not set.

SEE ALSO

       grid-mapfile-add-entry(8), grid-mapfile-check-consistency(8)

AUTHOR

       University of Chicago

Globus Toolkit 5.0.1						    03/19/2010						     GRID-MAPFILE-DELET(8)

Check Out this Related Man Page

GRID-MAPFILE-CHECK(8)						  Globus Commands					     GRID-MAPFILE-CHECK(8)

NAME

       grid-mapfile-check-consistency - Add an entry to a grid map file

SYNOPSIS

       grid-mapfile-check-consistency [-h] [-help] [-usage] [-version]

       grid-mapfile-check-consistency [-mapfile MAPFILE] | [-f MAPFILE]

DESCRIPTION

       The grid-mapfile-check-consistency program performs basic checks for validity of a gridmap file. These checks include checks for existence,
       duplication of entries, and valid local user names. If the gridmap file is valid, grid-mapfile-check-consistency exits with a zero exit
       code, otherwise it exits with a non-zero exit code. In either case, it displays information about its progress as it parses and validates
       the gridmap file.

       By default, grid-mapfile-check-consistency will check the gridmap file named by the GRIDMAP environment variable if present. If that
       variable is not set, it will check the file $HOME/.gridmap for non-root users if present. If that doesn't exist or
       grid-mapfile-check-consistency is run as root, it will then check /etc/grid-security/grid-mapfile. This can be changed by the use of the
       -mapfile or -f command-line options.

       The full set of command-line options to grid-mapfile-check-consistency are:

       -help, -h, -usage
	   Display the command-line options to grid-mapfile-check-consistency.

       -version
	   Display the version number of the grid-mapfile-check-consistency command.

       -mapfile MAPFILE, -f MAPFILE
	   Check the gridmap file named by MAPFILE instead of the default.

EXAMPLES

       Check that the gridmap file in /etc/grid-security is valid:

	   % grid-mapfile-check-consistency -f /etc/grid-security/grid-mapfile
	   Checking /etc/grid-security/grid-mapfile
	   Verifying grid mapfile existence...OK
	   Checking for duplicate entries...OK
	   Checking for valid user names...OK

       Check a gridmap file that has an invalid local user name:

	   % grid-mapfile-check-consistency -f /etc/grid-security/grid-mapfile
	   Checking /etc/grid-security/grid-mapfile
	   Verifying grid mapfile existence...OK
	   Checking for duplicate entries...OK
	   ERROR: baduser is not a valid local username
	   ERROR: Found 1 invalid username(s)

ENVIRONMENT VARIABLES

       The following environment variables affect the execution of grid-mapfile-check-consistency:

       GRIDMAP
	   Path to the default gridmap to check.

FILES

       The following files affect the execution of grid-mapfile-check-consistency:

       $HOME/.gridmap
	   Path to the default gridmap to check if the GRIDMAP environment variable is not set for non-root users.

       /etc/grid-security/grid-mapfile
	   Path to the default gridmap to check if GRIDMAP environment variable is not set and the above file does not exist.

SEE ALSO

       grid-mapfile-add-entry(8), grid-mapfile-delete-entry(8)

AUTHOR

       University of Chicago

Globus Toolkit 5.0.1						    03/19/2010						     GRID-MAPFILE-CHECK(8)
Man Page