OPENSC-EXPLORER(1)						   OpenSC tools 						OPENSC-EXPLORER(1)

NAME

       opensc-explorer - generic interactive utility for accessing smart card and similar security token functions

SYNOPSIS

       opensc-explorer [OPTIONS]

DESCRIPTION

       The opensc-explorer utility can be used interactively to perform miscellaneous operations such as exploring the contents of or sending
       arbitrary APDU commands to a smart card or similar security token.

OPTIONS

       The following are the command-line options for opensc-explorer. There are additional interactive commands available once it is running.

       --reader num, -r num
	   Use the given reader number. The default is 0, the first reader in the system.

       --card-driver driver, -c driver
	   Use the given card driver. The default is auto-detected.

       --mf path, -m path
	   Select the file referenced by the given path on startup. The default is the path to the standard master file, 3F00. If path is empty
	   (e.g.  opensc-explorer --mf ""), then no file is explicitly selected.

       --wait, -w
	   Wait for a card to be inserted

       --verbose, -v
	   Causes opensc-explorer to be more verbose. Specify this flag several times to enable debug output in the opensc library.

COMMANDS

       The following commands are supported at the opensc-explorer interactive prompt.

       ls
	   list all files in the current DF

       cd file-id
	   change to another DF specified by file-id

       cat [file-id], cat sfi:sfi-id
	   print the contents of the currently selected EF or the contents of a file specified by file-id or sfi-id.

       info [file-id]
	   display attributes of a file specified by file-id. If file-id is not supplied, the attributes of the current file are printed.

       create file-id size
	   create a new EF.  file-id specifies the id number and size is the size of the new file.

       delete file-id
	   remove the EF or DF specified by file-id

       rm file-id
	   remove the EF or DF specified by file-id

       verify key-typekey-id [key]
	   present a PIN or key to the card. Where key-type can be one of CHV, KEY or PRO.  key-id is a number representing the key or PIN
	   reference.  key is the key or PIN to be verified in hex.

	   If key is omitted, PIN will be verified with PIN-Pad.

	   Example: verify CHV0 31:32:33:34:00:00:00:00

       change CHVid [[old-pin] new-pin]
	   change a PIN, where id is the PIN reference

	   Examples:

	   Change PIN: change CHV2 00:00:00:00:00:00 "foobar"

	   Set PIN: change CHV2 "foobar"

	   Change PIN with pinpad: change CHV2

       put file-id input
	   copy a local file to the card. The local file is specified by input while the card file is specified by file-id.

       get file-id [output]
	   copy an EF to a local file. The local file is specified by output while the card file is specified by file-id.

	   If output is ommited, the name of the output file will be derivated from the full card path to file-id.

       do_put hex-tag input
	   update internal card's 'tagged' data.

	   hex-tag is the tag of the card's data.  input is the filename of the source file or the literal data presented as a sequence of
	   hexadecimal values or '"' enclosed string.

       do_get hex-tag [output]
	   copy the internal card's 'tagged' data into the local file.

	   The local file is specified by output while the tag of the card's data is specified by hex-tag.

	   If output is ommited, the name of the output file will be derivated from hex-tag.

       mkdir file-id size
	   create a DF.  file-id specifies the id number and size is the size of the new file.

       erase
	   erase the card, if the card supports it.

       random count
	   generate random sequence of count bytes.

       update_record file-id rec_nr rec_offs data
	   update record specified by rec_nr of the file specified by file-id with the literal data data starting from offset specified by
	   rec_offs.

	   data can be supplied as a sequence of the hex values or as a '"' encolsed string.

       update_binary file-id offs data
	   binary update of the file specified by file-id with the literal data data starting from offset specified by offs.

	   data can be supplied as a sequence of the hex values or as a '"' encolsed string.

       debug [level]
	   set OpenSC debug level to level.

	   If level is ommited the current debug level will be shown.

       apdu hex_data
	   send a custom APDU command hex_data.

       asn1 file-id
	   parse and print the ASN1 encoded content of the file specified by file-id.

       quit
	   exit the program.

SEE ALSO

       opensc-tool(1)

opensc								    06/03/2012							OPENSC-EXPLORER(1)