1<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 2 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" 3 [<!ENTITY mdash "—">]> 4<!-- 5 - Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC") 6 - 7 - Permission to use, copy, modify, and/or distribute this software for any 8 - purpose with or without fee is hereby granted, provided that the above 9 - copyright notice and this permission notice appear in all copies. 10 - 11 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH 12 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 13 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, 14 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 15 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 16 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 17 - PERFORMANCE OF THIS SOFTWARE. 18--> 19 20<!-- $Id: pkcs11-list.docbook,v 1.2 2009/10/05 12:07:08 fdupont Exp $ --> 21<refentry id="man.pkcs11-list"> 22 <refentryinfo> 23 <date>Sep 18, 2009</date> 24 </refentryinfo> 25 26 <refmeta> 27 <refentrytitle><application>pkcs11-list</application></refentrytitle> 28 <manvolnum>8</manvolnum> 29 <refmiscinfo>BIND9</refmiscinfo> 30 </refmeta> 31 32 <refnamediv> 33 <refname><application>pkcs11-list</application></refname> 34 <refpurpose>list PKCS#11 objects</refpurpose> 35 </refnamediv> 36 37 <docinfo> 38 <copyright> 39 <year>2009</year> 40 <holder>Internet Systems Consortium, Inc. ("ISC")</holder> 41 </copyright> 42 </docinfo> 43 44 <refsynopsisdiv> 45 <cmdsynopsis> 46 <command>pkcs11-list</command> 47 <arg><option>-P</option></arg> 48 <arg><option>-m <replaceable class="parameter">module</replaceable></option></arg> 49 <arg><option>-s <replaceable class="parameter">slot</replaceable></option></arg> 50 <arg choice="opt">-i <replaceable class="parameter">ID</replaceable></arg> 51 <arg choice="opt">-l <replaceable class="parameter">label</replaceable></arg> 52 <arg><option>-p <replaceable class="parameter">PIN</replaceable></option></arg> 53 </cmdsynopsis> 54 </refsynopsisdiv> 55 56 <refsect1> 57 <title>DESCRIPTION</title> 58 <para> 59 <command>pkcs11-list</command> 60 lists the PKCS#11 objects with <option>ID</option> or 61 <option>label</option> or by default all objects. 62 </para> 63 </refsect1> 64 65 <refsect1> 66 <title>ARGUMENTS</title> 67 <variablelist> 68 <varlistentry> 69 <term>-P</term> 70 <listitem> 71 <para> 72 List only the public objects. (Note that on some PKCS#11 73 devices, all objects are private.) 74 </para> 75 </listitem> 76 </varlistentry> 77 78 <varlistentry> 79 <term>-m <replaceable class="parameter">module</replaceable></term> 80 <listitem> 81 <para> 82 Specify the PKCS#11 provider module. This must be the full 83 path to a shared library object implementing the PKCS#11 API 84 for the device. 85 </para> 86 </listitem> 87 </varlistentry> 88 89 <varlistentry> 90 <term>-s <replaceable class="parameter">slot</replaceable></term> 91 <listitem> 92 <para> 93 Open the session with the given PKCS#11 slot. The default is 94 slot 0. 95 </para> 96 </listitem> 97 </varlistentry> 98 99 <varlistentry> 100 <term>-i <replaceable class="parameter">ID</replaceable></term> 101 <listitem> 102 <para> 103 List only key objects with the given object ID. 104 </para> 105 </listitem> 106 </varlistentry> 107 108 <varlistentry> 109 <term>-l <replaceable class="parameter">label</replaceable></term> 110 <listitem> 111 <para> 112 List only key objects with the given label. 113 </para> 114 </listitem> 115 </varlistentry> 116 117 <varlistentry> 118 <term>-p <replaceable class="parameter">PIN</replaceable></term> 119 <listitem> 120 <para> 121 Specify the PIN for the device. If no PIN is provided on the 122 command line, <command>pkcs11-list</command> will prompt for it. 123 </para> 124 </listitem> 125 </varlistentry> 126 </variablelist> 127 </refsect1> 128 129 <refsect1> 130 <title>SEE ALSO</title> 131 <para> 132 <citerefentry> 133 <refentrytitle>pkcs11-keygen</refentrytitle><manvolnum>3</manvolnum> 134 </citerefentry>, 135 <citerefentry> 136 <refentrytitle>pkcs11-destroy</refentrytitle><manvolnum>3</manvolnum> 137 </citerefentry> 138 </para> 139 </refsect1> 140 141 <refsect1> 142 <title>AUTHOR</title> 143 <para><corpauthor>Internet Systems Consortium</corpauthor> 144 </para> 145 </refsect1> 146 147</refentry><!-- 148 - Local variables: 149 - mode: sgml 150 - End: 151--> 152