chiark / gitweb /
Provide test cases for maxlen functions
[base91.git] / base91.1
1 .TH BASE91 1 "November 2006" "base91 0.6.0" basE91
2 .SH NAME
3 base91, b91enc, b91dec \- basE91 encode/decode data
4 .SH SYNOPSIS
5 .B base91
6 .RI [ OPTION "]... [" FILE ]
7 .SH DESCRIPTION
8 Convert binary data in FILE to plain ASCII text (or vice versa), writing to
9 standard output. With no FILE, or when FILE is \-, read standard input.
10 .TP
11 .BR \-d ", " \-\-decode
12 decode data (default for
13 .BR b91dec );
14 all non\-alphabet characters (such as newlines) are ignored
15 .TP
16 .BI "\-m " SIZE
17 use maximum SIZE bytes of main memory for buffers (default 64K);
18 SIZE may be followed by a multiplicative suffix:
19 .I K
20 1024,
21 .I M
22 1024*1024
23 .TP
24 .BR \-o ", " \-\-output =\fIFILE\fR
25 write result to FILE instead of standard output
26 .TP
27 .BR \-v ", " \-\-verbose
28 run in verbose mode and write some statistics to standard error;
29 use it twice to increase verbosity
30 .TP
31 .BR \-w ", " \-\-wrap =\fICOLS\fR
32 wrap encoded lines after COLS characters (default 76);
33 use 0 to disable line wrapping (default for
34 .BR b91enc )
35 .TP
36 .B \-\-help
37 prints out the available program options
38 .TP
39 .B \-\-version
40 output version information and exit
41 .PP
42 basE91 is an advanced method for encoding binary data as ASCII characters. It
43 is similar to UUencode or base64, but is more efficient. The overhead produced
44 by basE91 depends on the input data. It amounts at most to 23% (versus 33% for
45 base64) and can range down to 14%, which typically occurs on 0\-byte blocks.
46 This makes basE91 very useful for transferring larger files over binary
47 insecure connections like e\-mail or terminal lines.
48 .SH AUTHOR
49 Written by Joachim Henke.
50 .SH "REPORTING BUGS"
51 Report bugs to <j\-o@users.sourceforge.net>.
52 .SH COPYRIGHT
53 Copyright (c) 2000\-2006 Joachim Henke
54 .SH "SEE ALSO"
55 base64(1), uuencode(1)
56
57 http://base91.sourceforge.net/