.TH "ctfstool" "1" "0.2" "Martin Preuss <martin@libchipcard.de>" "Chipcard tool"
.SH "NAME"
.LP 
ctfstool \- Tool for manipulation of files on memory chip cards
.SH "SYNTAX"
.LP 
ctfstool <\fIcommand\fP> [\fIoptions\fP]
.br 
.SH "DESCRIPTION"
.LP 
This tool allows manipulation of files on a memory chip card (using LibChipCard's Card File System).
.SH "OPTIONS"
.LP 
.TP 
\fB\-u\fR <\fIuserid\fP>
Specify the user id of the owner of the chip card. This is only needed with encrypted file systems.
.TP 
\fB\-p\fR <\fIpassword\fP>
Specify the password for the chip card. This is only needed with encrypted file systems.
.SH "COMMANDS"
.LP 
.TP 
\fBformat\fR <\fIsize\fP> <\fIname\fP>
Prepare the chip card to be used as a file storage. If options \-u and \-p are given then the file system will be encrypted.
.br 
\fIsize\fP is the size of the memory on the card to be used, \fIname\fP is the name to assign to the card.

.TP 
\fBscratch\fR <\fIsize\fP>
Overwrite all the data on the chip card.
\fIsize\fP is the size of the memory on the card to be used

.TP 
\fBinfo\fR
Show some information about the card.

.TP 
\fBmode\fR <\fImode\fP>
Sets the mode. Currently there are two modes:
.br 
\fIRW\fR set to read\-write mode
.br 
\fIRO\fR set to read\-only mode, thus allowing no changes to be made to the card

.TP 
\fBmd\fR <\fIname\fP>
Create a directory of the \fIname\fP

.TP 
\fBrd\fR <\fIname\fP>
Remove a directory of the \fIname\fP. This directory MUST be empty.

.TP 
\fBls\fR <\fIdir\fP>
List the content of the given \fIdir\fP on the card.

.TP 
\fBcat\fR <\fIfile\fP>
Dump the content of the given \fIfile\fP to stdout.

.TP 
\fBread\fR <\fIsource\fP> <\fIdestination\fP>
Reads a file from the card and stores it locally.

.TP 
\fBwrite\fR <\fIsource\fP> <\fIdestination\fP>
Stores a local file on the chip card.
.br 

.SH "FILES"
.LP 
\fI/etc/libchipcard.conf\fP 
.br 

.SH "EXAMPLES"
.LP 
To create a file system on a 16 KB memory chip card type:
.LP 
ctfstool format 16382 Medium\-16KB\-1 \-u martin \-p secret
.LP 
View some information and statistics about the card with:
.br
ctfstool info \-u martin \-p secret
.br 

.SH "AUTHORS"
.LP 
Martin Preuss <martin@libchipcard.de>
.SH "SEE ALSO"
.LP