Rev 18 | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
2 | magnus | 1 | .\" Hey, EMACS: -*- nroff -*- |
2 | .\" First parameter, NAME, should be all caps |
||
3 | .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection |
||
4 | .\" other parameters are allowed: see man(7), man(1) |
||
18 | magnus | 5 | .TH SEXP\-CONV 1 "June 2007" "nettle 1.15" "Nettle tools" |
2 | magnus | 6 | .\" Please adjust this date whenever revising the manpage. |
7 | .\" |
||
8 | .\" Some roff macros, for reference: |
||
9 | .\" .nh disable hyphenation |
||
10 | .\" .hy enable hyphenation |
||
11 | .\" .ad l left justify |
||
12 | .\" .ad b justify to both left and right margins |
||
13 | .\" .nf disable filling |
||
14 | .\" .fi enable filling |
||
15 | .\" .br insert line break |
||
16 | .\" .sp <n> insert n+1 empty lines |
||
17 | .\" for manpage-specific macros, see man(7) |
||
18 | .SH NAME |
||
18 | magnus | 19 | sexp\-conv \- convert s-expression to a different encoding |
2 | magnus | 20 | .SH SYNOPSIS |
18 | magnus | 21 | Conversion: |
22 | .br |
||
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] |
||
30 | .RI [ OPTION ]... |
||
31 | .RI <\ INPUT-SEXP |
||
2 | magnus | 32 | .SH DESCRIPTION |
33 | This manual page documents briefly the |
||
18 | magnus | 34 | .B sexp\-conv |
2 | magnus | 35 | command. |
36 | This manual page was written for the Debian GNU/Linux distribution |
||
37 | because the original program does not have a manual page. |
||
38 | Instead, it has documentation in the GNU Info format; see below. |
||
39 | .PP |
||
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, |
||
42 | .\" respectively. |
||
18 | magnus | 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 |
||
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. |
||
2 | magnus | 47 | .SH OPTIONS |
48 | This program follows the usual GNU command line syntax, with long |
||
49 | options starting with two dashes (`-'). |
||
50 | A summary of options is included below. |
||
51 | For a complete description, see the Info files. |
||
52 | .TP |
||
53 | .B \-\-hash=\fIalgorithm\fP |
||
18 | magnus | 54 | Output only the hash of the s-expression, using \fIalgorithm\fP (default: sha1). |
2 | magnus | 55 | .TP |
18 | magnus | 56 | .B \-\-raw\-hash |
57 | Alias for \-\-hash, for compatibility with lsh 1.x. |
||
58 | .TP |
||
2 | magnus | 59 | .B \-\-once |
18 | magnus | 60 | Process exactly one s-expression. |
2 | magnus | 61 | .TP |
62 | .B \-\-spki\-hash |
||
18 | magnus | 63 | Output an SPKI hash for the object. \fBNot yet implemented.\fP |
2 | magnus | 64 | .TP |
18 | magnus | 65 | .B \-s, \-\-syntax=\fIformat\fP |
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 |
||
68 | instead of base64). |
||
2 | magnus | 69 | .TP |
18 | magnus | 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. |
||
2 | magnus | 72 | .TP |
73 | .B \-?, \-\-help |
||
74 | Show summary of options. |
||
75 | .TP |
||
18 | magnus | 76 | .B \-V, \-\-version |
2 | magnus | 77 | Show version of program. |
78 | .SH SEE ALSO |
||
79 | .BR ssh-conv (1), |
||
18 | magnus | 80 | .BR lsh (1), |
81 | .BR lshd (8), |
||
82 | http://theworld.com/~cme/spki.txt. |
||
2 | magnus | 83 | .br |
84 | The programs are documented fully by the |
||
85 | .IR "sexp" |
||
86 | section under the |
||
87 | .IR "Getting Started" |
||
88 | header of the lsh info page, available via the Info system. |
||
18 | magnus | 89 | .SH BUGS |
90 | This program should be documented in the nettle manual, not in the lsh manual. |
||
2 | magnus | 91 | .SH AUTHOR |
18 | magnus | 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 |
||
94 | by Magnus Holmgren <magnus@kibibyte.se>. |