'\" t
.\"     Title: grid-mapfile-add-entry
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 08/21/2020
.\"    Manual: Grid Community Toolkit Manual
.\"    Source: Grid Community Toolkit 6
.\"  Language: English
.\"
.TH "GRID\-MAPFILE\-ADD\-" "8" "08/21/2020" "Grid Community Toolkit 6" "Grid Community Toolkit Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * 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"
.sp
\fBgrid\-mapfile\-add\-entry\fR [ \-h | \-help | \-usage | \-version | \-versions ]
.sp
\fBgrid\-mapfile\-add\-entry\fR \-dn \fIDISTINGUISHED\-NAME\fR \-ln \fILOCAL\-NAME\fR\&... [\-d | \-dryrun] [ \-f \fIMAPFILE\fR | \-mapfile \fIMAPFILE\fR ] [\-force] [ \-n ] [ \-c ]
.SH "DESCRIPTION"
.sp
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\&.
.sp
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\&.
.sp
By default, \fBgrid\-mapfile\-add\-entry\fR 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 \fI\-mapfile\fR or \fI\-f\fR command\-line options\&.
.sp
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\&.
.sp
The full set of command\-line options to \fBgrid\-mapfile\-add\-entry\fR are:
.PP
\fB\-help, \-usage\fR
.RS 4
Display the command\-line options to
\fBgrid\-mapfile\-add\-entry\fR\&.
.RE
.PP
\fB\-version, \-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\(cqs
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
\fI\-ln\fR
command\-line option\&. If any of the local names are invalid, no changes will be made to the gridmap file (but see force option below)\&.
.RE
.PP
\fB\-d, \-dryrun\fR
.RS 4
Verify local names and display diagnostics about what would be added to the gridmap file, but don\(cqt 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
.PP
\fB\-force\fR
.RS 4
Make modifications even if user does not exist (needed for B2STAGE)\&.
.RE
.PP
\fB\-n\fR
.RS 4
Don\(cqt copy the original file to
\fIMAPFILE\fR\&.old\&.
.RE
.PP
\fB\-c\fR
.RS 4
Don\(cqt check for changes to the gridmap during program execution\&.
.RE
.SH "EXAMPLES"
.sp
Add a mapping between the current user\(cqs certificate to the current user id to a gridmap file in $HOME/\&.gridmap:
.sp
.if n \{\
.RS 4
.\}
.nf
% 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
.fi
.if n \{\
.RE
.\}
.sp
Add a mapping between the a distinguished name and multiple local names:
.sp
.if n \{\
.RS 4
.\}
.nf
% 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
.fi
.if n \{\
.RE
.\}
.SH "ENVIRONMENT"
.sp
The following environment variables affect the execution of \fBgrid\-mapfile\-add\-entry\fR:
.PP
GRIDMAP
.RS 4
Path to the default gridmap to modify
.RE
.SH "FILES"
.sp
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
GRIDMAP
environment variable is not set\&.
.RE
.SH "SEE ALSO"
.sp
grid\-mapfile\-check\-consistency(8), grid\-mapfile\-delete\-entry(8)
.SH "AUTHOR"
.sp
Copyright \(co 1999\-2016 University of Chicago