'\" t
.\" Title: voms-proxy-info
.\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.76.1
.\" Date: 11/24/2012
.\" Manual: \ \&
.\" Source: \ \&
.\" Language: English
.\"
.TH "VOMS\-PROXY\-INFO" "1" "11/24/2012" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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"
voms-proxy-info \- prints informations about a proxy with VOMS extensions
.SH "SYNOPSIS"
.sp
\fBvoms\-proxy\-info\fR [options]
.SH "DESCRIPTION"
.sp
The voms\-proxy\-info command prints information about a proxy, including information about the VOMS extension\&.
.sp
The default location of the proxy is
.sp
.if n \{\
.RS 4
.\}
.nf
/tmp/x509up_u
.fi
.if n \{\
.RE
.\}
.sp
where user_id is the effective user id of the user running the command\&. A non\-standard location for the proxy can be specified using the \fB\-file\fR option\&.
.SH "OPTIONS"
.sp
Options may be specified indifferently with either a "\-" or "\-\-" prefix\&.
.sp
\fB\-\-acexists \fR
.sp
.if n \{\
.RS 4
.\}
.nf
Returns 0 if AC exists corresponding to voname, 1 otherwise
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-acissuer\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the DN of AC issuer (certificate signer)
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-acsubject\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the distinguished name (DN) of AC subject
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-actimeleft\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints time (in seconds) until AC expires
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-all\fR
.sp
.if n \{\
.RS 4
.\}
.nf
All proxy options in a human readable format
.fi
.if n \{\
.RE
.\}
.sp
\fB\-b,\-\-bits \fR
.sp
.if n \{\
.RS 4
.\}
.nf
[option to \-exists] strength requirement for proxy to be valid
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-chain\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints information about the whole proxy certificate chain (CA excluded)
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-conf \fR
.sp
.if n \{\
.RS 4
.\}
.nf
Read options from
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-debug\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Enables extra debug output
.fi
.if n \{\
.RE
.\}
.sp
\fB\-e,\-\-exists\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Returns 0 if valid proxy exists, 1 otherwise
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-file \fR
.sp
.if n \{\
.RS 4
.\}
.nf
Reads information from file
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-fqan\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints VOMS fully qualified attribute names (FQANs)
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-help\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Displays helps and exits
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-hours \fR
.sp
.if n \{\
.RS 4
.\}
.nf
[option to \-exists] time requirement for proxy to be valid (deprecated, use \-valid instead)
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-identity\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the DN of the identity represented by the proxy
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-issuer\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the proxy issuer DN
.fi
.if n \{\
.RE
.\}
.sp
\fB\-k,\-\-keyusage\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints content of the KeyUsage extension
.fi
.if n \{\
.RE
.\}
.sp
\fB\-p,\-\-path\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the proxy file pathname
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-serial\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the AC serial number
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-strength\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the proxy key size (in bits)
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-subject\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the proxy subject Distinguished name (DN)
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-text\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints all information regarding the certificate
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-timeleft\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints time (in seconds) until proxy expires
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-type\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the proxy type (full or limited)
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-uri\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the URI of the VOMS server that issued the attributes
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-usage\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Displays helps and exits
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-valid \fR
.sp
.if n \{\
.RS 4
.\}
.nf
[option to \-exists] time requirement for proxy to be valid
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-version\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Displays version
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-vo\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Prints the vo name
.fi
.if n \{\
.RE
.\}
.SH "BUGS"
.sp
To report bugs or ask for support, use GGUS: https://ggus\&.eu/pages/home\&.php
.SH "AUTHORS"
.sp
Andrea Ceccanti
.sp
Daniele Andreotti
.sp
Valerio Venturi
.SH "SEE ALSO"
.sp
voms\-proxy\-destroy(1), voms\-proxy\-info(1), vomses(5), vomsdir(5)
.SH "COPYING"
.sp
Copyright 2012 Istituto Nazionale di Fisica Nucleare
.sp
Licensed under the Apache License, Version 2\&.0 (the "License"); you may not use this file except in compliance with the License\&. You may obtain a copy of the License at
.sp
.if n \{\
.RS 4
.\}
.nf
http://www\&.apache\&.org/licenses/LICENSE\-2\&.0
.fi
.if n \{\
.RE
.\}
.sp
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied\&. See the License for the specific language governing permissions and limitations under the License\&.