Provided by: globus-gss-assist-progs_10.15-2_all bug

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