File: shisa.1

package info (click to toggle)
shishi 1.0.0-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 22,144 kB
  • ctags: 7,865
  • sloc: ansic: 61,153; sh: 12,212; yacc: 1,219; makefile: 1,164; perl: 624; sed: 16
file content (139 lines) | stat: -rw-r--r-- 3,504 bytes parent folder | download
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.38.2.
.TH SHISA "1" "May 2010" "shisa 1.0.0" "User Commands"
.SH NAME
shisa \- Shishi database interface
.SH SYNOPSIS
.B shisa
[\fIOPTIONS\fR]... [\fIREALM \fR[\fIPRINCIPAL\fR]]...
.SH DESCRIPTION
shisa 1.0.0
.PP
Manipulate information stored in the Shisa user database.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version and exit
.SS "Operations:"
.TP
\fB\-a\fR, \fB\-\-add\fR
Add realm or principal to database.
.TP
\fB\-d\fR, \fB\-\-dump\fR
Dump entries in database.
.TP
\fB\-n\fR, \fB\-\-key\-add\fR
Add new key to a principal in database.
.TP
\fB\-\-key\-remove\fR
Remove a key from a principal in database.
.TP
\fB\-l\fR, \fB\-\-list\fR
List entries in database.
.TP
\fB\-m\fR, \fB\-\-modify\fR
Modify principal entry in database.
.TP
\fB\-r\fR, \fB\-\-remove\fR
Remove realm or principal from database.
.SS "Parameters:"
.TP
\fB\-f\fR, \fB\-\-force\fR
Allow removal of non\-empty realms.
(default=off)
.TP
\fB\-\-enabled\fR
Only dump or list enabled principals.
(default=off)
.TP
\fB\-\-disabled\fR
Only dump or list disabled principals.
(default=off)
.TP
\fB\-\-keys\fR
Print cryptographic key and password in hostkey
format.  (default=off)
.SS "Values:"
.TP
\fB\-E\fR, \fB\-\-encryption\-type\fR=\fISTRING\fR
Override default key encryption type.  Valid
values include 'aes128', 'aes256', 'aes'
(same as 'aes256'), '3des', 'des\-md5',
\&'des\-md4', 'des\-crc', 'des' (same as
\&'des\-md5'), and 'arcfour'.
.TP
\fB\-\-key\-version\fR=\fINUMBER\fR
Version of key.
.TP
\fB\-\-password\fR[=\fISTRING\fR]
Derive key from this password.
.TP
\fB\-\-priority\fR=\fINUMBER\fR
Specify key priority, used to differentiate
between keys when multiple keys are eligible
for use.  Higher value means higher priority.
.IP
(default is 0, which mean a random key of
.IP
the best etype is chosen)
.TP
\fB\-\-random\fR
Use a random key.  (default)
.TP
\fB\-\-salt\fR=\fISTRING\fR
Use specified salt for deriving key.  Defaults
to concatenation of realm and (unwrapped)
principal name.
.TP
\fB\-\-string\-to\-key\-parameter\fR=\fIHEX\fR
Encryption algorithm specific parameter for
.TP
password derivation.
Currently only the AES
.IP
algorithm can utilize this, where it is
interpreted as the iteration count of the
PKCS#5 PBKDF2 key deriver.
.SS "Other options:"
.HP
\fB\-c\fR, \fB\-\-configuration\-file\fR=\fIFILE\fR Use specified configuration file.
.TP
\fB\-o\fR, \fB\-\-library\-options\fR=\fISTRING\fR
Parse string as configuration file statement.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Produce verbose output.
(default=off)
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Don't produce any diagnostic output.
(default=off)
.PP
Mandatory arguments to long options are mandatory for short options too.
.SH AUTHOR
Written by Simon Josefsson.
.SH "REPORTING BUGS"
Report bugs to: bug\-shishi@gnu.org
.br
GNU Shishi home page: <http://www.gnu.org/software/shishi/>
.br
General help using GNU software: <http://www.gnu.org/gethelp/>
.SH COPYRIGHT
Copyright \(co 2010 Simon Josefsson.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B shisa
is maintained as a Texinfo manual.  If the
.B info
and
.B shisa
programs are properly installed at your site, the command
.IP
.B info shishi
.PP
should give you access to the complete manual.