'\" t
.\"     Title: grid-cert-info
.\"    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\-CERT\-INFO" "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-cert-info \- Display information about a certificate
.SH "SYNOPSIS"
.HP \w'\fBgrid\-cert\-info\fR\ 'u
\fBgrid\-cert\-info\fR [\-help] [\-usage] [\-version] [\-versions]
.HP \w'\fBgrid\-cert\-info\fR\ 'u
\fBgrid\-cert\-info\fR [\-file\ \fICERTIFICATE\-FILE\fR] [\-rfc2253] [\-all]
.br
[\-subject] | [\-s] 
.br
[\-issuer] | [\-i] 
.br
[\-issuerhash] | [\-ih] 
.br
[\-startdate] | [\-sd] 
.br
[\-endate] | [\-ed] 
.SH "DESCRIPTION"
.PP
The
\fBgrid\-cert\-info\fR
program displays information contained within a certificate file\&. By default it shows a text representation of the entire certificate\&. Specific facts about the certificate can be shown instead by using command\-line options\&. If any of those options are used, then the default display is suppressed\&. This can be added to the output by using the
\fB\-all\fR
command\-line option\&.
.PP
If multiple display options are included on the command\-line, the facts related to those will be displayed on separate lines in the order that they occur\&. If an option is specified multiple time, that fact will be displayed multiple times\&.
.PP
The full set of command\-line options to
\fBgrid\-cert\-info\fR
are:
.PP
\fB\-help\fR, \fB\-usage\fR
.RS 4
Display the command\-line options to
\fBgrid\-cert\-info\fR
and exit\&.
.RE
.PP
\fB\-version\fR, \fB\-versions\fR
.RS 4
Display the version number of the
\fBgrid\-cert\-info\fR
command\&. The second form includes more details\&.
.RE
.PP
\fB\-file \fR\fB\fICERTIFICATE\-FILE\fR\fR
.RS 4
Display information about the first certificate contained in the file named by
\fICERTIFICATE\-FILE\fR
instead of the default user certificate\&.
.RE
.PP
\fB\-rfc2253\fR
.RS 4
Display X\&.509 distinguished names using the string representation defined in RFC 2253 instead of the default OpenSSL oneline format\&.
.RE
.PP
\fB\-all\fR
.RS 4
Display the text representation of the entire certificate in addition to any other facts requested by command\-line options\&. This is the default if no fact\-specific command\-line options are used\&.
.RE
.PP
\fB\-subject\fR, \fB\-s\fR
.RS 4
Display the subject name of the X\&.509 certificate\&.
.RE
.PP
\fB\-issuer\fR, \fB\-i\fR
.RS 4
Display the issuer name of the X\&.509 certificate\&.
.RE
.PP
\fB\-issuerhash\fR, \fB\-ih\fR
.RS 4
Display the default hash of the issuer name of the X\&.509 certificate\&. This can be used to locate which CA certificate in the trusted certificate directory issued the certifcate being inspected\&.
.RE
.PP
\fB\-startdate\fR, \fB\-sd\fR
.RS 4
Display a string representation of the date and time when the certificate is valid from\&. This is displayed in the format used by the OpenSSL
\fBx509\fR
command\&.
.RE
.PP
\fB\-enddate\fR, \fB\-dd\fR
.RS 4
Display a string representation of the date and time when the certificate is valid until\&. This is displayed in the format used by the OpenSSL
\fBx509\fR
command\&.
.RE
.SH "EXAMPLES"
.PP
Display the validity times for the default certificate
.sp
.if n \{\
.RS 4
.\}
.nf
% \fBgrid\-cert\-info\fR \fB\-sd\fR \fB\-ed\fR
Aug 31 12:33:47 2009 GMT
Aug 31 12:33:47 2010 GMT
.fi
.if n \{\
.RE
.\}
.PP
Display the same information about a different certificate specified on the command\-line
.sp
.if n \{\
.RS 4
.\}
.nf
% \fBgrid\-cert\-info\fR \fB\-sd\fR \fB\-ed\fR \fB\-f /etc/grid\-security/hostcert\&.pem\fR
Jan 21 12:24:48 2003 GMT
Jul 15 11:30:57 2020 GMT
.fi
.if n \{\
.RE
.\}
.PP
Display the subject of a certificate in both the default and the RFC 2253 forms\&.
.sp
.if n \{\
.RS 4
.\}
.nf
% \fBgrid\-cert\-info\fR \fB\-subject\fR
/DC=org/DC=example/DC=grid/CN=Joe User
% \fBgrid\-cert\-info\fR \fB\-subject\fR \fB\-rfc2253\fR
CN=Joe User,DC=grid,DC=example,DC=org
.fi
.if n \{\
.RE
.\}
.sp
.SH "ENVIRONMENT VARIABLES"
.PP
The following environment variables affect the execution of
\fBgrid\-cert\-info\fR:
.PP
\fBX509_USER_CERT\fR
.RS 4
Path to the default certificate file to inspect\&.
.RE
.SH "AUTHOR"
.PP
\fBUniversity of Chicago\fR