Subversion Repositories

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

Rev 2 | 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>.