'\" t
.\"     Title: grid-mapfile-add-entry
.\"    Author: University of Chicago
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 03/19/2010
.\"    Manual: Globus Commands
.\"    Source: Globus Toolkit 5.0.1
.\"  Language: English
.\"
.TH "GRID\-MAPFILE\-ADD\-" "8" "03/19/2010" "Globus Toolkit 5.0.1" "Globus Commands"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
grid-mapfile-add-entry \- Add an entry to a gridmap file
.SH "SYNOPSIS"
.HP \w'\fBgrid\-mapfile\-add\-entry\fR\ 'u
\fBgrid\-mapfile\-add\-entry\fR [\-help] [\-usage] [\-version] [\-versions]
.HP \w'\fBgrid\-mapfile\-add\-entry\fR\ 'u
\fBgrid\-mapfile\-add\-entry\fR {\-dn\ \fIDISTINGUISHED\-NAME\fR} {\-ln\ \fILOCAL\-NAME\fR...}
.br
[[\-d] | [\-dryrun]]
.br
[[\-mapfile\ \fIMAPFILE\fR] | [\-f\ \fIMAPFILE\fR]]
.SH "DESCRIPTION"
.PP
The
\fBgrid\-mapfile\-add\-entry\fR
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\&.
.PP
The
\fBgrid\-mapfile\-add\-entry\fR
program verifies that the
\fILOCAL\-NAME\fR
is a valid user name on the system on which it was run, and that the mapping between
\fIDISTINGUISHED\-NAME\fR
and
\fILOCAL\-NAME\fR
does not already exist in the gridmap file\&.
.PP
By default,
\fBgrid\-mapfile\-add\-entry\fR
will modify the gridmap file named by the
\fBGRIDMAP\fR
environment variable if present, or the file
/etc/grid\-security/grid\-mapfile
if not\&. This can be changed by the use of the
\fB\-mapfile\fR
or
\fB\-f\fR
command\-line options\&.
.PP
If the gridmap file does not exist,
\fBgrid\-mapfile\-add\-entry\fR
will create it\&. If it already exists,
\fBgrid\-mapfile\-add\-entry\fR
will save the current contents of the file to a new file with the string
\&.old
appended to the file name\&.
.PP
The full set of command\-line options to
\fBgrid\-mapfile\-add\-entry\fR
are:
.PP
\fB\-help\fR, \fB\-usage\fR
.RS 4
Display the command\-line options to
\fBgrid\-mapfile\-add\-entry\fR\&.
.RE
.PP
\fB\-version\fR, \fB\-versions\fR
.RS 4
Display the version number of the
\fBgrid\-mapfile\-add\-entry\fR
command\&. The second form includes more details\&.
.RE
.PP
\fB\-dn \fR\fB\fIDISTINGUISHED\-NAME\fR\fR
.RS 4
The X\&.509 distinguished name to add a mapping for\&. The name should be in OpenSSL\'s
oneline
format\&.
.RE
.PP
\fB\-ln \fR\fB\fILOCAL\-NAME\fR\fR\fB\&.\&.\&.\fR
.RS 4
The POSIX user name to map the distinguished name to\&. This name must be a valid username\&. Add multiple
\fILOCAL\-NAME\fR
strings after the
\fB\-ln\fR
command\-line option\&. If any of the local names are invalid, no changes will be made to the gridmap file\&. Note that if multiple occurances of the
\fB\-ln\fR
command\-line option are present, only the the last one will be added\&.
.RE
.PP
\fB\-d\fR, \fB\-dryrun\fR
.RS 4
Verify local names and display diagnostics about what would be added to the gridmap file, but don\'t actually modify the file\&.
.RE
.PP
\fB\-mapfile \fR\fB\fIMAPFILE\fR\fR, \fB\-f \fR\fB\fIMAPFILE\fR\fR
.RS 4
Modify the gridmap file named by
\fIMAPFILE\fR
instead of the default\&.
.RE
.SH "EXAMPLES"
.PP
Add a mapping between the current user\'s certificate to the current user id to a gridmap file in
\fB$HOME\fR/\&.gridmap:
.sp
.if n \{\
.RS 4
.\}
.nf
% \fBgrid\-mapfile\-add\-entry\fR \fB\-f $HOME/\&.gridmap\fR \fB\-dn "`grid\-cert\-info \-subject`"\fR \fB\-ln "`id \-un`"\fR
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
.fi
.if n \{\
.RE
.\}
.PP
Add a mapping between the a distinguished name and multiple local names:
.sp
.if n \{\
.RS 4
.\}
.nf
% \fBgrid\-mapfile\-add\-entry\fR \fB\-dn "/DC=org/DC=example/DC=grid/CN=Joe User" juser"\fR \fBlocal1\fR \fBlocal2\fR
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
.fi
.if n \{\
.RE
.\}
.sp
.SH "ENVIRONMENT VARIABLES"
.PP
The following environment variables affect the execution of
\fBgrid\-mapfile\-add\-entry\fR:
.PP
\fBGRIDMAP\fR
.RS 4
Path to the default gridmap to modify\&.
.RE
.SH "FILES"
.PP
The following files affect the execution of
\fBgrid\-mapfile\-add\-entry\fR:
.PP
/etc/grid\-security/grid\-mapfile
.RS 4
Path to the default gridmap to modify if
\fBGRIDMAP\fR
environment variable is not set\&.
.RE
.SH "SEE ALSO"
.PP

\fBgrid-mapfile-check-consistency\fR(8),
\fBgrid-mapfile-delete-entry\fR(8)
.SH "AUTHOR"
.PP
\fBUniversity of Chicago\fR