WebSVN - Diff - Rev 18 and 41 - /trunk/debian/sexp-conv.1


.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH SEXP\-CONV 1 "June 2007" "nettle 1.15"  "Nettle tools"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
sexp\-conv \- convert s-expression to a different encoding
.SH SYNOPSIS
Conversion:
.br
.B sexp-conv
.RI [ OPTION ]... 
.RI <\  INPUT-SEXP
.PP
Fingerprinting:
.br
.B sexp-conv --hash\fR[\fB=\fP\fIalgorithm\fP]
.RI [ OPTION ]...
.RI <\  INPUT-SEXP
.SH DESCRIPTION
This manual page documents briefly the
.B sexp\-conv
command.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
Instead, it has documentation in the GNU Info format; see below.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
\fBsexp\-conv\fP is a program that converts S-expressions. It automatically
detects the s-expression syntax variant of the input. It is primarily
used by the `lsh' packages, which stores keys and most other objects
on disk in that format, but may be of other use as well.
.SH OPTIONS
This program follows the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
For a complete description, see the Info files.
.TP
.B \-\-hash=\fIalgorithm\fP
Output only the hash of the s-expression, using \fIalgorithm\fP (default: sha1).
.TP
.B \-\-raw\-hash
Alias for \-\-hash, for compatibility with lsh 1.x.
.TP
.B \-\-once
Process exactly one s-expression.
.TP
.B \-\-spki\-hash
Output an SPKI hash for the object. \fBNot yet implemented.\fP
.TP
.B \-s, \-\-syntax=\fIformat\fP
Variant of S-expression to output. Valid S-expression formats are: transport,
canonical (binary), advanced, and hex (same as advanced, but numbers in hex
instead of base64).
.TP
.B \-w, \-\-width=\fIwidth\fP
Limit output to lines of \fIwidth\fP characters (has no effect on canonical syntax). Zero means no limit.
.TP
.B \-?, \-\-help
Show summary of options.
.TP
.B \-V, \-\-version
Show version of program.
.SH SEE ALSO
.BR ssh-conv (1),
.BR lsh (1),
.BR lshd (8),
http://theworld.com/~cme/spki.txt.
.br
The programs are documented fully by the
.IR "sexp"
section under the
.IR "Getting Started"
header of the lsh info page, available via the Info system.
.SH BUGS
This program should be documented in the nettle manual, not in the lsh manual.
.SH AUTHOR
This manual page was originally written by Timshel Knoll <timshel@debian.org>,
for the Debian GNU/Linux system (but may be used by others). Edited
by Magnus Holmgren <magnus@kibibyte.se>.

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

Subversion Repositories

(root)/trunk/debian/sexp-conv.1 @ 195 - Rev 18 → 41