<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
       	"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY authors  SYSTEM "authors.sgml">
<!ENTITY bugzilla SYSTEM "bugzilla.sgml">
<!ENTITY license  SYSTEM "license.sgml">
<!ENTITY links    SYSTEM "links.sgml">
]>

<refentry id='vomsproxyinfo1'>
<refmeta>
<refentrytitle>voms-proxy-info</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class='source'>VOMS Client</refmiscinfo>
</refmeta>

<refnamediv id='name'>
<refname>voms-proxy-info</refname>
<refpurpose>prints information about a proxy with VOMS extensions</refpurpose>
</refnamediv>

<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
<command>voms-proxy-info</command>
<arg choice='opt'><arg choice='plain'>options</arg></arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1 id='description'><title>Description</title>

<para>The voms-proxy-info command pritns information about a proxy, including
information about the VOMS extension.</para>

</refsect1>

<refsect1 id='options'><title>Options</title>

<para>Options may be specified indifferently with either a "-" or "--" prefix. The 
options from -help to -out are present for compatibility with
grid-proxy-init, and have the exact same meaning. The meaning of the other
ones is the following.</para>

<para><option>-help</option></para>
<para><option>-usage</option>
Displays usage.</para>

<para><option>-version</option>
Displays version.</para>

<para><option>-debug</option>
Enables extra debug output.  This is for bug reports only.  Users must not
rely on the extra output printed by this option.</para>

<para><option>-file</option> <replaceable>proxyfile</replaceable>
The name of the file containing the proxy, in case it is in a 
non-standard place.</para>

<para><option>-chain</option>
Prints information about the proxy's certificate chain.</para>

<para><option>-subject</option>
Prints the DN of the proxy's subject.</para>

<para><option>-issuer</option>
Prints the DN of the proxy's issuer.</para>

<para><option>-identity</option>
Prints the DN of the iodentity represented by the proxy.  This is synonimous</para>

<para><option>-type</option>
Print the proxy's type (limited or not)</para>

<para><option>-strength</option>
Prints the proxy's strength. I.e. the number of bits in the key.</para>

<para><option>-valid</option>
Print validity times.</para>

<para><option>-timeleft</option>
Prints how much time is left (in seconds) instead of the end time of the proxy. This
option implies -valid</para>

<para><option>-all</option>
Prints everything.</para>

<para><option>-fqan</option>
Prints the VOMS attributes in the FQAN format. Default</para>

<para> <option>-exists</option> <replaceable>-bits N</replaceable> <replaceable>-hours H</replaceable>
Verifies if the proxy is valid for at least other H hours and has a key of at least N bits.</para>

<para> <option>-acexists</option> <replaceable>voname</replaceable>
Verifies if an AC for the VO specified is present in the proxy.</para>

<para><option>-conf</option> <replaceable>file</replaceable>
Read options from <emphasis remap='I'>file</emphasis>.</para>

<para><option>-text</option>
Prints the certificate to standard output.</para>

<para><option>-path</option>
Prints the full path name of the proxy file.</para>

<para><option>-vo</option>
Prints the names of the VOs whose AC are present in the proxy</para>

<para><option>-acsubject</option>
Prints the subject of the owners of the ACs in the proxy.</para>

<para><option>-acissuer</option>
Prints the issuer of the owners of the ACs in the proxy.</para>

<para><option>-actimeleft</option>
Prints how much time is left (in seconds) instead of the end time of the AC.</para>

<para><option>-serial</option>
Prints the serial number of each AC present in the proxy.</para>

<para><option>-dont-verify-ac</option>
Skips the AC verification step.  Warning!  Data printed when this
  option is specified may not be reliable.</para>

<para><option>-targets</option>
Prints the list of hosts to which the AC has been targeted.</para>

<para><option>-included-file</option>
In case the proxy included a user-specified file, this option prints
  it to screen.</para>

<para><option>-uri</option>
Prints the URI of the serve which issued this AC.</para>

<para><option>-keyusage</option>
Print the content of the KeyUsage extension of the certificate.</para>
</refsect1>

&bugzilla;

<refsect1 id='seealso'><title>See also</title>

    <para>voms-proxy-init(1), voms-proxy-destroy(1)</para>

&links;

</refsect1>

&authors;

&license;

</refentry>
