File: README

package info (click to toggle)
muscletools 2.1.0-2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 832 kB
  • ctags: 727
  • sloc: ansic: 4,307; sh: 3,448; yacc: 247; lex: 121; makefile: 88
file content (93 lines) | stat: -rw-r--r-- 3,482 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
******************************************************
Title    : MuscleTool
Authors  : David Corcoran
           Ludovic Rousseau
           Toni Andjelkovic
           Karsten Ohme
License  : See file COPYING
Requires : PC/SC Lite
           MuscleCard
           MCardPlugin
******************************************************

This is a command line tool for MuscleCard
enabled smartcards. The main function is to format a smart
card, but it offers some additional MuscleCard
functionality.
There are key, PIN, object and general related
functions.

There are two versions depending of the compile switch VERSION2.
If VERSION2 is defined some new features are enabled for which
you need the new version 2.0.0 of the MuscleCard library, MuscleCard
Plug-In 2.0.0 and CardEdge Applet in protocol version 1.30.

You can generate keys, list keys, import and export
and use keys for cryptographic operations.
At the moment the import and export commands are only for testing,
because the keys are imported and exported as key blobs, an
internal format of the application on the smart card. You
will need a conversion utility for getting a standard key format.
Maybe a next release will enable with the OpenSSL library a
usable key import and export. The crypto operations does allow also the
encryption of a given file in addition to a supplied user string.
With the new version, you can also delete keys, renumber keys 
and change their ACLs.

You can create, read, write object, delete and list objects.
With the new version you can also rename objects and change the ACL for objects.

You can create, list, change, unblock and verify and PINs.
With the new version you can also delete IDs (PINs or keys).

General commands are the status command, the connect and
release command and maybe very informative the resume command,
which shows the capabilities of your card.
The new version can also set the label and teh serial number of the card.

You can get a short help with the "help".
If you want to have a help for a command call "help commmand".


Installation:

General install instructions are in the file INSTALL.
Installation instructions for Windows are in the file Install.w32

./configure
make
make install

If the configure file is not there you must run the script ./reconf

make install installs the package in the default prefix (/usr/local), so the resulting
muscleTool binary is installed as /usr/local/bin/muscleTool.

For compiling MuscleTool you must have pkg-config installed.
Usually pkg-config looks in the /usr/local/lib/pkgconfig directory.
There should placed a file libmusclecard.pc containing information
about the required libraries, header files and other information.
If pkgconfig fails and your pkgconfig directory is at a
different location you have to set the environment variable
PKG_CONFIG_PATH. E.g. the Debian path for pkgconfig is /usr/lib/pkgconfig.

Optional GNU readline support can be enabled with (Very comfortable, so you
scroll through you input.):

./configure --enable-readline

Other useful options are:

./configure --prefix=/usr Defines the installation target for everything to
    start with /usr instead of the default /usr/local
./configure --help gives you a help of possible options.

To compile the new MuscleTool version enable it with:

./configure VERSION2

For more information please refer to the mailing list
http://lists.drizzle.com/mailman/listinfo/muscle

MUSCLE Smartcard Developers: http://www.musclecard.com