'\" t
.\"     Title: grid-change-pass-phrase
.\"    Author: University of Chicago
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 03/22/2010
.\"    Manual: Globus Commands
.\"    Source: Globus Toolkit 5.0.1
.\"  Language: English
.\"
.TH "GRID\-CHANGE\-PASS\-" "1" "03/22/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-change-pass-phrase \- Change the passphrase of a private key
.SH "SYNOPSIS"
.HP \w'\fBgrid\-change\-pass\-phrase\fR\ 'u
\fBgrid\-change\-pass\-phrase\fR [\-help] [\-usage] [\-version] [\-versions]
.HP \w'\fBgrid\-change\-pass\-phrase\fR\ 'u
\fBgrid\-change\-pass\-phrase\fR [\-file\ \fIPRIVATE\-KEY\fR]
.SH "DESCRIPTION"
.PP
The
\fBgrid\-change\-pass\-phrase\fR
program changes the passphrase protecting a private key or PKCS12 bundle containing a private key and certificate\&. By default,
\fBgrid\-change\-pass\-phrase\fR
uses the
\fBX509_USER_KEY\fR
environment variable to locate the private key\&. If that is not set, then it looks for
\fB$HOME\fR/\&.globus/userkey\&.pem
and
\fB$HOME\fR/\&.globus/usercred\&.p12
in succession\&. The path to a key can be specified by using the
\fB\-file\fR
command\-line option\&.
.PP
The full set of command\-line options to
\fBgrid\-change\-pass\-phrase\fR
are:
.PP
\fB\-help\fR, \fB\-usage\fR
.RS 4
Display the command\-line options to
\fBgrid\-change\-pass\-phrase\fR
and exit\&.
.RE
.PP
\fB\-version\fR, \fB\-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 passphrase of the private key named by
\fIPRIVATE\-KEY\fR
instead of the default\&.
.RE
.SH "EXAMPLES"
.PP
Change the passphrase of the default private key:
.sp
.if n \{\
.RS 4
.\}
.nf
% \fBgrid\-change\-pass\-phrase\fR 

Enter pass phrase for /home/juser/\&.globus/userkey\&.pem:
writing RSA key
Enter PEM pass phrase:
Verifying \- Enter PEM pass phrase:
.fi
.if n \{\
.RE
.\}
.sp
.SH "ENVIRONMENT VARIABLES"
.PP
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"
.PP
\fBUniversity of Chicago\fR