Subversion Repositories

?revision_form?Rev ?revision_input??revision_submit??revision_endform?

Rev 16 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 16 Rev 19
Line 1... Line 1...
1 
.\"                                      Hey, EMACS: -*- nroff -*-
1 
.\"                                      Hey, EMACS: -*- nroff -*-
2 
.\" First parameter, NAME, should be all caps
2 
.\" First parameter, NAME, should be all caps
3 
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
3 
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4 
.\" other parameters are allowed: see man(7), man(1)
4 
.\" other parameters are allowed: see man(7), man(1)
5 
.TH SEXP-CONV 1 "June 6, 2007" sexp-conv "Nettle Manuals"
5 
.TH SEXP\-CONV 1 "June 2007" "nettle 1.15"  "Nettle tools"
6 
.\" Please adjust this date whenever revising the manpage.
6 
.\" Please adjust this date whenever revising the manpage.
7 
.\"
7 
.\"
8 
.\" Some roff macros, for reference:
8 
.\" Some roff macros, for reference:
9 
.\" .nh        disable hyphenation
9 
.\" .nh        disable hyphenation
10 
.\" .hy        enable hyphenation
10 
.\" .hy        enable hyphenation
Line 14... Line 14...
14 
.\" .fi        enable filling
14 
.\" .fi        enable filling
15 
.\" .br        insert line break
15 
.\" .br        insert line break
16 
.\" .sp <n>    insert n+1 empty lines
16 
.\" .sp <n>    insert n+1 empty lines
17 
.\" for manpage-specific macros, see man(7)
17 
.\" for manpage-specific macros, see man(7)
18 
.SH NAME
18 
.SH NAME
19 
sexp-conv \- convert s-expression to a different encoding
19 
sexp\-conv \- convert s-expression to a different encoding
20 
.SH SYNOPSIS
20 
.SH SYNOPSIS
- 
 
 21 
Conversion:
- 
 
 22 
.br
21 
.B sexp-conv
23 
.B sexp-conv
- 
 
 24 
.RI [ OPTION ]...
- 
 
 25 
.RI <\  INPUT-SEXP
- 
 
 26 
.PP
- 
 
 27 
Fingerprinting:
- 
 
 28 
.br
- 
 
 29 
.B sexp-conv --hash\fR[\fB=\fP\fIalgorithm\fP]
22 
.RI [ options ]
30 
.RI [ OPTION ]...
- 
 
 31 
.RI <\  INPUT-SEXP
23 
.SH DESCRIPTION
32 
.SH DESCRIPTION
24 
This manual page documents briefly the
33 
This manual page documents briefly the
25 
.B sexp-conv
34 
.B sexp\-conv
26 
command.
35 
command.
27 
This manual page was written for the Debian GNU/Linux distribution
36 
This manual page was written for the Debian GNU/Linux distribution
28 
because the original program does not have a manual page.
37 
because the original program does not have a manual page.
29 
Instead, it has documentation in the GNU Info format; see below.
38 
Instead, it has documentation in the GNU Info format; see below.
30 
.PP
39 
.PP
31 
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
40 
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
32 
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
41 
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
33 
.\" respectively.
42 
.\" respectively.
34 
\fBsexp-conv\fP is a program that converts S-expressions. It is primarily
43 
\fBsexp\-conv\fP is a program that converts S-expressions. It automatically
- 
 
 44 
detects the s-expression syntax variant of the input. It is primarily
35 
used by the `lsh' packages, which stores keys and most other objects
45 
used by the `lsh' packages, which stores keys and most other objects
36 
store on disk in that format, but may be of other use as well.
46 
on disk in that format, but may be of other use as well.
37 
.SH OPTIONS
47 
.SH OPTIONS
38 
This program follows the usual GNU command line syntax, with long
48 
This program follows the usual GNU command line syntax, with long
39 
options starting with two dashes (`-').
49 
options starting with two dashes (`-').
40 
A summary of options is included below.
50 
A summary of options is included below.
41 
For a complete description, see the Info files.
51 
For a complete description, see the Info files.
42 
.TP
52 
.TP
43 
.B \-\-hash=\fIalgorithm\fP
53 
.B \-\-hash=\fIalgorithm\fP
44 
Hash algorithm (default: sha1).
54 
Output only the hash of the s-expression, using \fIalgorithm\fP (default: sha1).
45 
.TP
- 
 
46 
.B \-\-once
- 
 
47 
Process at most one s-expression.
- 
 
48 
.TP
55 
.TP
49 
.B \-\-raw\-hash
56 
.B \-\-raw\-hash
50 
Output the hash for the canonical representation of the object, in hexadecimal.
- 
 
51 
.TP
- 
 
52 
.B \-\-spki\-hash
- 
 
53 
Output an SPKI hash for the object.
57 
Alias for \-\-hash, for compatibility with lsh 1.x.
54 
.TP
58 
.TP
55 
.B \-\-debug
- 
 
56 
Print huge amounts of debug information.
- 
 
57 
.TP
- 
 
58 
.B \-q, \-\-quiet
- 
 
59 
Supress all warnings and diagnostic messages.
- 
 
60 
.TP
- 
 
61 
.B \-\-trace
59 
.B \-\-once
62 
Detailed trace.
- 
 
63 
.TP
- 
 
64 
.B \-v, \-\-verbose
- 
 
65 
Verbose diagnostic messages.
60 
Process exactly one s-expression.
66 
.TP
61 
.TP
67 
.B \-i, \-\-input\-format=\fIformat\fP
62 
.B \-\-spki\-hash
68 
Variant of S-expression to accept. Valid S-expression formats are: transport,
63 
Output an SPKI hash for the object. \fBNot yet implemented.\fP
69 
canonical, advanced and international.
- 
 
70 
.TP
64 
.TP
71 
.B \-o, \-\-output\-format=\fIformat\fP
65 
.B \-s, \-\-syntax=\fIformat\fP
72 
Variant of S-expression to output. Valid S-expression formats are: transport,
66 
Variant of S-expression to output. Valid S-expression formats are: transport,
73 
canonical, advanced and international.
67 
canonical (binary), advanced, and hex (same as advanced, but numbers in hex
- 
 
 68 
instead of base64).
- 
 
 69 
.TP
- 
 
 70 
.B \-w, \-\-width=\fIwidth\fP
- 
 
 71 
Limit output to lines of \fIwidth\fP characters (has no effect on canonical syntax). Zero means no limit.
74 
.TP
72 
.TP
75 
.B \-?, \-\-help
73 
.B \-?, \-\-help
76 
Show summary of options.
74 
Show summary of options.
77 
.TP
75 
.TP
78 
.B \-\-usage
- 
 
79 
Give a short usage message.
- 
 
80 
.TP
- 
 
81 
.B \-v, \-\-version
76 
.B \-V, \-\-version
82 
Show version of program.
77 
Show version of program.
83 
.SH SEE ALSO
78 
.SH SEE ALSO
84 
.BR ssh-conv (1),
79 
.BR ssh-conv (1),
85 
.BR lsh (1),
80 
.BR lsh (1),
86 
.BR lshd (8).
81 
.BR lshd (8),
- 
 
 82 
http://theworld.com/~cme/spki.txt.
87 
.br
83 
.br
88 
The programs are documented fully by the
84 
The programs are documented fully by the
89 
.IR "sexp"
85 
.IR "sexp"
90 
section under the
86 
section under the
91 
.IR "Getting Started"
87 
.IR "Getting Started"
92 
header of the lsh info page, available via the Info system.
88 
header of the lsh info page, available via the Info system.
- 
 
 89 
.SH BUGS
- 
 
 90 
This program should be documented in the nettle manual, not in the lsh manual.
93 
.SH AUTHOR
91 
.SH AUTHOR
94 
This manual page was written by Timshel Knoll <timshel@debian.org>,
92 
This manual page was originally written by Timshel Knoll <timshel@debian.org>,
95 
for the Debian GNU/Linux system (but may be used by others). Edited
93 
for the Debian GNU/Linux system (but may be used by others). Edited
96 
by Magnus Holmgren <magnus@kibibyte.se>.
94 
by Magnus Holmgren <magnus@kibibyte.se>.