Changeset View
Changeset View
Standalone View
Standalone View
doc/scdaemon.texi
Context not available. | |||||
@item --help, -h | @item --help, -h | ||||
@opindex help | @opindex help | ||||
Print a usage message summarizing the most usefule command-line options. | Print a usage message summarizing the most useful command-line options. | ||||
Not that you can abbreviate this command. | Not that you can abbreviate this command. | ||||
@item --dump-options | @item --dump-options | ||||
Context not available. | |||||
@item --daemon | @item --daemon | ||||
@opindex daemon | @opindex daemon | ||||
Run the program in the background. This option is required to prevent | Run the program in the background. This option is required to prevent | ||||
it from being accidently running in the background. | it from being accidentally running in the background. | ||||
@end table | @end table | ||||
Context not available. | |||||
PIN again after the next power up. | PIN again after the next power up. | ||||
Note that with the current version of Scdaemon the card is powered | Note that with the current version of Scdaemon the card is powered | ||||
down immediatley at the next timer tick for any value of @var{n} other | down immediately at the next timer tick for any value of @var{n} other | ||||
than 0. | than 0. | ||||
Context not available. | |||||
@node PKCS#15 Card | @node PKCS#15 Card | ||||
@subsection The PKCS#15 card application ``p15'' | @subsection The PKCS#15 card application ``p15'' | ||||
This is common fraqmework for smart card applications. It is used by | This is common framework for smart card applications. It is used by | ||||
@command{gpgsm}. | @command{gpgsm}. | ||||
@node Geldkarte Card | @node Geldkarte Card | ||||
Context not available. | |||||
The SC-Daemon should be started by the system to provide access to | The SC-Daemon should be started by the system to provide access to | ||||
external tokens. Using Smartcards on a multi-user system does not | external tokens. Using Smartcards on a multi-user system does not | ||||
make much sense expcet for system services, but in this case no | make much sense expect for system services, but in this case no | ||||
regular user accounts are hosted on the machine. | regular user accounts are hosted on the machine. | ||||
A client connects to the SC-Daemon by connecting to the socket named | A client connects to the SC-Daemon by connecting to the socket named | ||||
Context not available. | |||||
@var{/etc/scdaemon.conf} | @var{/etc/scdaemon.conf} | ||||
Each connection acts as one session, SC-Daemon takes care of | Each connection acts as one session, SC-Daemon takes care of | ||||
syncronizing access to a token between sessions. | synchronizing access to a token between sessions. | ||||
@menu | @menu | ||||
* Scdaemon SERIALNO:: Return the serial number. | * Scdaemon SERIALNO:: Return the serial number. | ||||
Context not available. | |||||
SERIALNO | SERIALNO | ||||
@end example | @end example | ||||
Return the serial number of the card using a status reponse like: | Return the serial number of the card using a status response like: | ||||
@example | @example | ||||
S SERIALNO D27600000000000000000000 0 | S SERIALNO D27600000000000000000000 0 | ||||
Context not available. | |||||
This function is used to read a certificate identified by | This function is used to read a certificate identified by | ||||
@var{hexified_certid} from the card. With OpenPGP cards the keyid | @var{hexified_certid} from the card. With OpenPGP cards the keyid | ||||
@code{OpenPGP.3} may be used to rad the certticate of version 2 cards. | @code{OpenPGP.3} may be used to rad the certificate of version 2 cards. | ||||
@node Scdaemon READKEY | @node Scdaemon READKEY | ||||
Context not available. | |||||
WRITEKEY [--force] @var{keyid} | WRITEKEY [--force] @var{keyid} | ||||
@end example | @end example | ||||
This command is used to store a secret key on a a smartcard. The | This command is used to store a secret key on a smartcard. The | ||||
allowed keyids depend on the currently selected smartcard | allowed keyids depend on the currently selected smartcard | ||||
application. The actual keydata is requested using the inquiry | application. The actual keydata is requested using the inquiry | ||||
@code{KEYDATA} and need to be provided without any protection. With | @code{KEYDATA} and need to be provided without any protection. With | ||||
Context not available. | |||||
overwritten. The key data is expected to be the usual canonical encoded | overwritten. The key data is expected to be the usual canonical encoded | ||||
S-expression. | S-expression. | ||||
A PIN will be requested in most saes. This however depends on the | A PIN will be requested in most cases. This however depends on the | ||||
actual card application. | actual card application. | ||||
Context not available. | |||||
@end example | @end example | ||||
Using the option @code{--more} handles the card status word MORE_DATA | Using the option @code{--more} handles the card status word MORE_DATA | ||||
(61xx) and concatenate all reponses to one block. | (61xx) and concatenate all responses to one block. | ||||
Using the option @code{--exlen} the returned APDU may use extended | Using the option @code{--exlen} the returned APDU may use extended | ||||
length up to N bytes. If N is not given a default value is used | length up to N bytes. If N is not given a default value is used | ||||
Context not available. |