Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31170 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

WESTCOS-TOOL(1)			 OpenSC tools		       WESTCOS-TOOL(1)

NAME
       westcos-tool - utility for manipulating data structures on westcos
       smart cards

SYNOPSIS
       westcos-tool [OPTIONS]

DESCRIPTION
       The westcos-tool utility is used to manipulate the westcos data
       structures on 2 Ko smart cards. Users can create PINs, keys and
       certificates stored on the token. User PIN authentication is performed
       for those operations that require it.

OPTIONS
       --reader, r num
	   Use the given reader. The default is the first reader with a card.

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

       --generate-key, -g
	   Generate a private key on smart card. The smart card must be not
	   finalized and a PIN must be installed (ie. file for PIN must be
	   created, see option -i). By default key length is 1536 bits. User
	   authentication is required for this operation.

       --overwrite-key, -o
	   Overwrite the key if there is already a key on card.

       --key-length length, -l length
	   Change the length of private key, use with -g.

       --install-pin, -i
	   Install PIN file in token, you must provide PIN value with -x.

       --pin-value value, -x value
	   set value of PIN.

       --puk-value value, -y value
	   set value of PUK (or value of new PIN for change PIN command see
	   -n).

       --change-pin, -n
	   Changes a PIN stored on the token. User authentication is required
	   for this operation.

       --unblock-pin, -u
	   Unblocks a PIN stored on the token. Knowledge of the PIN Unblock
	   Key (PUK) is required for this operation.

       --certificate file, -t file
	   Write certificate file in PEM format to the card. User
	   authentication is required for this operation.

       --finalize, -f
	   Finalize the card. Once finalized the default key is invalidated so
	   PIN and PUK can't be changed anymore without user authentication.
	   Warning, un-finalized are insecure because PIN can be changed
	   without user authentication (knowledge of default key is enough).

       --read-file path, -j path
	   Get the file path the file is written on disk with path name. User
	   authentication is required for this operation.

       --write-file path, -k path
	   Put the file with name path from disk to card the file is written
	   in path. User authentication is required for this operation.

       --help, -h
	   Print help message on screen.

       -v
	   Causes westcos-tool to be more verbose. Specify this flag several
	   times to enable debug output in the OpenSC library.

AUTHORS
       westcos-tool was written by Francois Leblanc
       francois.leblanc@cev-sa.com.

opensc				  07/19/2011		       WESTCOS-TOOL(1)

Vote for polarhome