~ubuntu-branches/ubuntu/precise/gnupg2/precise-proposed

« back to all changes in this revision

Viewing changes to doc/scdaemon.texi

  • Committer: Bazaar Package Importer
  • Author(s): Eric Dorland
  • Date: 2009-03-08 22:46:47 UTC
  • mfrom: (1.1.11 upstream)
  • Revision ID: james.westby@ubuntu.com-20090308224647-gq17gatcl71lrc2k
Tags: 2.0.11-1
* New upstream release. (Closes: #496663)
* debian/control: Make the description a little more distinctive than
  gnupg v1's. Thanks Jari Aalto. (Closes: #496323)

Show diffs side-by-side

added added

removed removed

Lines of Context:
205
205
dump.  This options enables it and also changes the working directory to
206
206
@file{/tmp} when running in @option{--server} mode.
207
207
 
 
208
@item --debug-log-tid
 
209
@opindex debug-log-tid
 
210
This option appends a thread ID to the PID in the log output.
 
211
 
208
212
 
209
213
@item --no-detach
210
214
@opindex no-detach
252
256
@end smallexample
253
257
 
254
258
 
 
259
@item --card-timeout @var{n}
 
260
@opindex card-timeout
 
261
If @var{n} is not 0 and no client is actively using the card, the card
 
262
will be powered down after @var{n} seconds.  Powering down the card
 
263
avoids a potential risk of damaging a card when used with certain
 
264
cheap readers.  This also allows non Scdaemon aware applications to
 
265
access the card.  The disadvantage of using a card timeout is that
 
266
accessing the card takes longer and that the user needs to enter the
 
267
PIN again after the next power up.
 
268
 
 
269
Note that with the current version of Scdaemon the card is powered
 
270
down immediatley at the next timer tick for any value of @var{n} other
 
271
than 0.
 
272
 
255
273
 
256
274
@item --disable-keypad
257
275
@opindex disable-keypad
258
276
Even if a card reader features a keypad, do not try to use it.
259
277
 
260
278
 
261
 
@item --allow-admin
262
 
@itemx --deny-admin
 
279
@item --deny-admin
 
280
@opindex deny-admin
263
281
@opindex allow-admin
264
 
@opindex deny-admin
265
 
This enables the use of Admin class commands for card applications
266
 
where this is supported.  Currently we support it for the OpenPGP
267
 
card.  Deny is the default.  This commands is useful to inhibit
268
 
accidental access to admin class command which could ultimately lock
269
 
the card through worng PIN numbers.
 
282
This option disables the use of admin class commands for card
 
283
applications where this is supported.  Currently we support it for the
 
284
OpenPGP card. This commands is useful to inhibit accidental access to
 
285
admin class command which could ultimately lock the card through wrong
 
286
PIN numbers.  Note that GnuPG versions older than 2.0.11 featured an
 
287
@option{--allow-admin} command which was required to use such admin
 
288
commands.  This option has no more effect today because the default is
 
289
now to allow admin commands.
270
290
 
271
291
@item --disable-application @var{name}
272
292
@opindex disable-application
291
311
* NKS Card::              The Telesec NetKey card application
292
312
* DINSIG Card::           The DINSIG card application
293
313
* PKCS#15 Card::          The PKCS#15 card application
 
314
* Geldkarte Card::        The Geldkarte application
294
315
@end menu
295
316
 
296
317
@node OpenPGP Card
297
318
@subsection The OpenPGP card application ``openpgp''
298
319
 
299
320
This application is currently only used by @command{gpg} but may in
300
 
future also be useful with @command{gpgsm}. 
 
321
future also be useful with @command{gpgsm}.  Version 1 and version 2 of
 
322
the card is supported. 
301
323
 
302
 
The specification for such a card is available at
303
 
@uref{http://g10code.com/docs/openpgp-card-1.0.pdf}.
 
324
The specifications for these cards are available at
 
325
@uref{http://g10code.com/docs/openpgp-card-1.0.pdf} and
 
326
@uref{http://g10code.com/docs/openpgp-card-2.0.pdf}.
304
327
 
305
328
@node NKS Card
306
329
@subsection The Telesec NetKey card ``nks''
322
345
This is common fraqmework for smart card applications.  It is used by
323
346
@command{gpgsm}.
324
347
 
 
348
@node Geldkarte Card
 
349
@subsection The Geldkarte card application ``geldkarte''
 
350
 
 
351
This is a simple application to display information of a German
 
352
Geldkarte.  The Geldkarte is a small amount debit card application which
 
353
comes with almost all German banking cards.
 
354
 
325
355
 
326
356
@c *******************************************
327
357
@c ***************            ****************
470
500
@subsection Return a certificate
471
501
 
472
502
@example
473
 
 READCERT @var{hexified_certid}
 
503
 READCERT @var{hexified_certid}|@var{keyid}
474
504
@end example
475
505
 
476
506
This function is used to read a certificate identified by
477
 
@var{hexified_certid} from the card.
 
507
@var{hexified_certid} from the card.  With OpenPGP cards the keyid
 
508
@code{OpenPGP.3} may be used to rad the certticate of version 2 cards.
478
509
 
479
510
 
480
511
@node Scdaemon READKEY
580
611
@subsection Change PINs.
581
612
 
582
613
@example
583
 
   PASSWD [--reset] @var{chvno}
 
614
   PASSWD [--reset] [--nullpin] @var{chvno}
584
615
@end example
585
616
  
586
617
Change the PIN or reset the retry counter of the card holder
587
 
verification vector number @var{chvno}.
 
618
verification vector number @var{chvno}.  The option @option{--nullpin}
 
619
is used to initialize the PIN of TCOS cards (6 byte NullPIN only).
588
620
 
589
621
 
590
622
@node Scdaemon CHECKPIN