'\" t
.\"     Title: grid-change-pass-phrase
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/31/2018
.\"    Manual: Grid Community Toolkit Manual
.\"    Source: Grid Community Toolkit 6
.\"  Language: English
.\"
.TH "GRID\-CHANGE\-PASS\-" "1" "03/31/2018" "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-change-pass-phrase \- Change the pass phrase of a private key
.SH "SYNOPSIS"
.sp
\fBgrid\-change\-pass\-phrase\fR \-help | \-usage | \-version | \-versions
.sp
\fBgrid\-change\-pass\-phrase\fR [\-file \fIPRIVATE\-KEY\fR]
.SH "DESCRIPTION"
.sp
The \fBgrid\-change\-pass\-phrase\fR program changes the pass phrase protecting a private key or PKCS12 bundle containing a private key and certificate\&. By default, \fBgrid\-change\-pass\-phrase\fR uses the \fIX509_USER_KEY\fR environment variable to locate the private key\&. If that is not set, then it looks for $HOME/\&.globus/userkey\&.pem and $HOME/\&.globus/usercred\&.p12 in succession\&. The path to a key can be specified by using the \fI\-file\fR command\-line option\&.
.SH "OPTIONS"
.sp
The full set of command\-line options to \fBgrid\-change\-pass\-phrase\fR are:
.PP
\fB\-help, \-usage\fR
.RS 4
Display the command\-line options to
\fBgrid\-change\-pass\-phrase\fR
and exit\&.
.RE
.PP
\fB\-version, \-versions\fR
.RS 4
Display the version number of the
\fBgrid\-change\-pass\-phrase\fR
command\&. The second form includes more details\&.
.RE
.PP
\fB\-file \fR\fB\fIPRIVATE\-KEY\fR\fR
.RS 4
Change the pass phrase of the private key named by
\fIPRIVATE\-KEY\fR
instead of the default\&.
.RE
.SH "EXAMPLES"
.sp
Change the pass phrase of the default private key:
.sp
.if n \{\
.RS 4
.\}
.nf
% grid\-change\-pass\-phrase
Enter pass phrase for /home/juser/\&.globus/userkey\&.pem:
writing RSA key
Enter PEM pass phrase: XXXXXXXX
Verifying \- Enter PEM pass phrase: XXXXXXXX
.fi
.if n \{\
.RE
.\}
.SH "ENVIRONMENT"
.sp
The following environment variables affect the execution of \fBgrid\-change\-pass\-phrase\fR:
.PP
\fBX509_USER_KEY\fR
.RS 4
Path to the default private key file\&.
.RE
.SH "AUTHOR"
.sp
Copyright \(co 1999\-2014 University of Chicago