← Back to branch summary

~ubuntu-branches/ubuntu/raring/gnupg2/raring-proposed

« back to all changes in this revision

Viewing changes to doc/scdaemon.texi

  • Committer: Bazaar Package Importer
  • Author(s): Eric Dorland
  • Date: 2009-09-07 20:38:23 UTC
  • mfrom: (1.1.13 upstream)
  • Revision ID: james.westby@ubuntu.com-20090907203823-d7hsk7lnfqoc4yom
Tags: 2.0.13-1
* New upstream release.
* debian/control: Depend instead of Recommend gnupg-agent. (Closes:
  #538947)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/scdaemon.texi
69
69
 
70
70
@item --help, -h
71
71
@opindex help
72
 
Print a usage message summarizing the most usefule command-line options.
 
72
Print a usage message summarizing the most useful command-line options.
73
73
Not that you can abbreviate this command.
74
74
 
75
75
@item --dump-options
91
91
@item --daemon
92
92
@opindex daemon
93
93
Run the program in the background.  This option is required to prevent
94
 
it from being accidently running in the background.
 
94
it from being accidentally running in the background.
95
95
 
96
96
@end table
97
97
 
267
267
PIN again after the next power up.
268
268
 
269
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
 
270
down immediately at the next timer tick for any value of @var{n} other
271
271
than 0.
272
272
 
273
273
 
342
342
@node PKCS#15 Card
343
343
@subsection The PKCS#15 card application ``p15''
344
344
 
345
 
This is common fraqmework for smart card applications.  It is used by
 
345
This is common framework for smart card applications.  It is used by
346
346
@command{gpgsm}.
347
347
 
348
348
@node Geldkarte Card
413
413
 
414
414
The SC-Daemon should be started by the system to provide access to
415
415
external tokens.  Using Smartcards on a multi-user system does not
416
 
make much sense expcet for system services, but in this case no
 
416
make much sense expect for system services, but in this case no
417
417
regular user accounts are hosted on the machine.
418
418
 
419
419
A client connects to the SC-Daemon by connecting to the socket named
421
421
@var{/etc/scdaemon.conf}
422
422
 
423
423
Each connection acts as one session, SC-Daemon takes care of
424
 
syncronizing access to a token between sessions.
 
424
synchronizing access to a token between sessions.
425
425
 
426
426
@menu
427
427
* Scdaemon SERIALNO::     Return the serial number.
457
457
  SERIALNO
458
458
@end example
459
459
 
460
 
Return the serial number of the card using a status reponse like:
 
460
Return the serial number of the card using a status response like:
461
461
 
462
462
@example
463
463
  S SERIALNO D27600000000000000000000 0
505
505
 
506
506
This function is used to read a certificate identified by
507
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.
 
508
@code{OpenPGP.3} may be used to rad the certificate of version 2 cards.
509
509
 
510
510
 
511
511
@node Scdaemon READKEY
584
584
  WRITEKEY [--force] @var{keyid}
585
585
@end example
586
586
 
587
 
This command is used to store a secret key on a a smartcard.  The
 
587
This command is used to store a secret key on a smartcard.  The
588
588
allowed keyids depend on the currently selected smartcard
589
589
application. The actual keydata is requested using the inquiry
590
590
@code{KEYDATA} and need to be provided without any protection.  With
592
592
overwritten.  The key data is expected to be the usual canonical encoded
593
593
S-expression.
594
594
 
595
 
A PIN will be requested in most saes.  This however depends on the
 
595
A PIN will be requested in most cases.  This however depends on the
596
596
actual card application.
597
597
 
598
598
 
687
687
@end example
688
688
 
689
689
Using the option @code{--more} handles the card status word MORE_DATA
690
 
(61xx) and concatenate all reponses to one block.
 
690
(61xx) and concatenate all responses to one block.
691
691
 
692
692
Using the option @code{--exlen} the returned APDU may use extended
693
693
length up to N bytes.  If N is not given a default value is used