.TH POC 1 "March 7, 2001
.SH NAME
GNU POC \- Manage passwords on smartcards
.SH SYNOPSIS
.B poc
[COMMAND] [OPTIONS]
.SH DESCRIPTION
With
.B GNU POC 
you to manage passwords on smartcards (I2C memory cards). Every entry
on the card consits of a password and a description, which gives information
about the password. All data is stored encrypted on the card. Thus it's 
impossible for someone to get the passwords, when he/she finds/steals the card.
.SH COMMANDS
.sp 1
.TP 0.5i
.BI "\-\-backup=" FILE
Make a backup of the card to the file 
.I FILE
.TP 0.5i
.B \-c, \-\-change\-cardkey
Change the key, which is used to en/decrypt the data on the card.
.TP 0.5i
.B \-f, \-\-format\-card
Format a card. The card's memory will be cleared and basic card information
needed by 
.B poc 
will be written.
.TP 0.5i
.BI "\-l" \ \ DESCRIPTION ", \-\-list\-password=" DESCRIPTION
List the password, which description matches the given one. Or if
.I DESCRIPTION
is 
.I all
all passwords. 
.TP 0.5i
.B \-s, \-\-save\-password
Save a password on the card.
.TP 0.5i
.BI "\-r" \ \ DESCRIPTION ", \-\-remove\-password=" DESCRIPTION
Remove the password, which description matches the given one.
.TP 0.5i
.BI "\-\-restore=" FILE
Restore are a backuped card from
.I FILE.
.SH OPTIONS
.sp 1   
.TP 0.5i
.BI "\-\-cipher=" CIPHER
Specify the cipher which will be used for encryption. See
.B CIPHER
for more information.
.TP 0.5i
.BI "\-p" \ \ NUM ", \-\-port=" NUM
Specify at which comport we can find the card reader.
.TP 0.5i
.BI "\-\-security=" LEVEL
Set the security level for encryption. See 
.B SECURITY-LEVEL
for more information.
.TP 0.5i
.B \-v, \-\-verbose
Print more information. (Not really used.)
.SH CIPHER
In this release of 
.B POC
you can choose between:
.RS
.PP
AES (RIJNDAEL)
.TP
BLOWFISH
.PP
.RE
You can choose
.I plaintext
too. If choose plaintext your data is stored 
.B unencrypted
on the card. Hence this flag should
.B only
be used for debugging.
.PP
If no cipher is specified AES will be used. \- If you want to use BLOWFISH
instead of AES, but don't want to specify it every time you invoke
.B POC
, you can set the environment variable
.B POC_CIPHER 
to avoid it.
.SH SECURITY-LEVEL
You can choose between two different security-levels. Namely 
.B 1
and
.B 2.
If you use
.B 1,
a 192 bit key will be used for encryption. And if you choose
.B 2
a 256 bit key will be used. - You can set the environment variable
.B POC_SL
to select a level, without specifiing it on the commandline. (The
default security-level is 1).
.SH BUGS
Report bugs to bug-poc@gnu.org
.SH AUTHOR
Henning Koester <henning@crackinghacking.de>