Rev 18 | Rev 97 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 18 | Rev 41 | ||
---|---|---|---|
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 2007" "nettle 1.15" "Nettle tools" |
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 |
11 | .\" .ad l left justify |
11 | .\" .ad l left justify |
12 | .\" .ad b justify to both left and right margins |
12 | .\" .ad b justify to both left and right margins |
13 | .\" .nf disable filling |
13 | .\" .nf disable filling |
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: |
21 | Conversion: |
22 | .br |
22 | .br |
23 | .B sexp-conv |
23 | .B sexp-conv |
24 | .RI [ OPTION ]... |
24 | .RI [ OPTION ]... |
25 | .RI <\ INPUT-SEXP |
25 | .RI <\ INPUT-SEXP |
26 | .PP |
26 | .PP |
27 | Fingerprinting: |
27 | Fingerprinting: |
28 | .br |
28 | .br |
29 | .B sexp-conv --hash\fR[\fB=\fP\fIalgorithm\fP] |
29 | .B sexp-conv --hash\fR[\fB=\fP\fIalgorithm\fP] |
30 | .RI [ OPTION ]... |
30 | .RI [ OPTION ]... |
31 | .RI <\ INPUT-SEXP |
31 | .RI <\ INPUT-SEXP |
32 | .SH DESCRIPTION |
32 | .SH DESCRIPTION |
33 | This manual page documents briefly the |
33 | This manual page documents briefly the |
34 | .B sexp\-conv |
34 | .B sexp\-conv |
35 | command. |
35 | command. |
36 | This manual page was written for the Debian GNU/Linux distribution |
36 | This manual page was written for the Debian GNU/Linux distribution |
37 | because the original program does not have a manual page. |
37 | because the original program does not have a manual page. |
38 | Instead, it has documentation in the GNU Info format; see below. |
38 | Instead, it has documentation in the GNU Info format; see below. |
39 | .PP |
39 | .PP |
40 | .\" 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 |
41 | .\" \fI<whatever>\fP escape sequences to invode bold face and italics, |
41 | .\" \fI<whatever>\fP escape sequences to invode bold face and italics, |
42 | .\" respectively. |
42 | .\" respectively. |
43 | \fBsexp\-conv\fP is a program that converts S-expressions. It automatically |
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 |
44 | detects the s-expression syntax variant of the input. It is primarily |
45 | 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 |
46 | 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. |
47 | .SH OPTIONS |
47 | .SH OPTIONS |
48 | This program follows the usual GNU command line syntax, with long |
48 | This program follows the usual GNU command line syntax, with long |
49 | options starting with two dashes (`-'). |
49 | options starting with two dashes (`-'). |
50 | A summary of options is included below. |
50 | A summary of options is included below. |
51 | For a complete description, see the Info files. |
51 | For a complete description, see the Info files. |
52 | .TP |
52 | .TP |
53 | .B \-\-hash=\fIalgorithm\fP |
53 | .B \-\-hash=\fIalgorithm\fP |
54 | Output only the hash of the s-expression, using \fIalgorithm\fP (default: sha1). |
54 | Output only the hash of the s-expression, using \fIalgorithm\fP (default: sha1). |
55 | .TP |
55 | .TP |
56 | .B \-\-raw\-hash |
56 | .B \-\-raw\-hash |
57 | Alias for \-\-hash, for compatibility with lsh 1.x. |
57 | Alias for \-\-hash, for compatibility with lsh 1.x. |
58 | .TP |
58 | .TP |
59 | .B \-\-once |
59 | .B \-\-once |
60 | Process exactly one s-expression. |
60 | Process exactly one s-expression. |
61 | .TP |
61 | .TP |
62 | .B \-\-spki\-hash |
62 | .B \-\-spki\-hash |
63 | Output an SPKI hash for the object. \fBNot yet implemented.\fP |
63 | Output an SPKI hash for the object. \fBNot yet implemented.\fP |
64 | .TP |
64 | .TP |
65 | .B \-s, \-\-syntax=\fIformat\fP |
65 | .B \-s, \-\-syntax=\fIformat\fP |
66 | 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, |
67 | canonical (binary), advanced, and hex (same as advanced, but numbers in hex |
67 | canonical (binary), advanced, and hex (same as advanced, but numbers in hex |
68 | instead of base64). |
68 | instead of base64). |
69 | .TP |
69 | .TP |
70 | .B \-w, \-\-width=\fIwidth\fP |
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. |
71 | Limit output to lines of \fIwidth\fP characters (has no effect on canonical syntax). Zero means no limit. |
72 | .TP |
72 | .TP |
73 | .B \-?, \-\-help |
73 | .B \-?, \-\-help |
74 | Show summary of options. |
74 | Show summary of options. |
75 | .TP |
75 | .TP |
76 | .B \-V, \-\-version |
76 | .B \-V, \-\-version |
77 | Show version of program. |
77 | Show version of program. |
78 | .SH SEE ALSO |
78 | .SH SEE ALSO |
79 | .BR ssh-conv (1), |
79 | .BR ssh-conv (1), |
80 | .BR lsh (1), |
80 | .BR lsh (1), |
81 | .BR lshd (8), |
81 | .BR lshd (8), |
82 | http://theworld.com/~cme/spki.txt. |
82 | http://theworld.com/~cme/spki.txt. |
83 | .br |
83 | .br |
84 | The programs are documented fully by the |
84 | The programs are documented fully by the |
85 | .IR "sexp" |
85 | .IR "sexp" |
86 | section under the |
86 | section under the |
87 | .IR "Getting Started" |
87 | .IR "Getting Started" |
88 | 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 |
89 | .SH BUGS |
90 | This program should be documented in the nettle manual, not in the lsh manual. |
90 | This program should be documented in the nettle manual, not in the lsh manual. |
91 | .SH AUTHOR |
91 | .SH AUTHOR |
92 | This manual page was originally written by Timshel Knoll <timshel@debian.org>, |
92 | This manual page was originally written by Timshel Knoll <timshel@debian.org>, |
93 | 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 |
94 | by Magnus Holmgren <magnus@kibibyte.se>. |
94 | by Magnus Holmgren <magnus@kibibyte.se>. |