UUENVIEW(1)

NAME
uuenview - a powerful encoder for binary files

SYNOPSIS
uuenview [-v] [-u|-x|-b] [-lines] [-o] [-od path]
[-m email] [-p newsgroup] [-s subject]
[-i description-file] [file(s)]

DESCRIPTION
uuenview encodes a binary file into ASCII text for sending over non-8-bit electronic data channels, such as email or the usenet. uuenview is a superset of and fully backwards compatible with the standard uuencode(1) command, featuring more comfort and more flexibility. For example, the file can be mailed or posted directly from uuenview.

Files encoded with uuenview are compatible with virtually all decoders, as long as the encoding method (see below) is supported by the remote side. If the remote side uses uudeview(1), there shouldn't be any problems at all.

OPTIONS

-v  Verbously prints everything the program's trying to do.

-u  Chooses the uuencoding method. This is the default for compatibility with uuencode (1). This encoding scheme is to date widely accepted as being the standard.

-b  Chooses the Base64 encoding method as specified by the MIME standard. This scheme is expected to become the future standard.

-x  Chooses the now obsolete xxencoding method.

The -u, -b, -x options are mutually exclusive.

-lines
    Sets the maximum number of encoded lines per part. The encoded data is automatically split into as many parts as required. Line counts less than 200 are ignored. The uuencoding and xxencoding methods encode 45k, and Base64 encodes 57k of data in 1000 lines. If this option is not specified, the default is unlimited lines per part, resulting in exactly one part.

-o  Specifies that output shall be written into files. These files will have the same base name as the source file and an extension of .001, .002 etc, depending on the number of parts required by the -lines option. The encoded files are written to the current directory.

-od path
    Same as '-o', but the encoded files are written to the given directory instead.

-m email
    Mails the encoded file(s), each one probably split into multiple parts, to the given email address. Multiple recepients can be given as a quoted, comma-separated list.

-p newsgroup
    Posts the encoded file(s), each one probably split into multiple parts, to the given newsgroup. Multiple newsgroups can be given as a quoted, comma-separated list. The inews(1) program is invoked for posting. You may have to set the NNTPSERVER enviroment variable to your news server.

-s subject
    This subject will be used when mailing or posting the file. Be careful to quote subjects of more than one word.

-i description-file
    When mailing or posting, the given text file is read and send as zeroeth part. This is usually done to describe the encoded file.

file(s)
    One or more filenames to be processed. Each file is encoded and then stored in a file, mailed and/or posted according to the -o, -m and -p options. If none of these options is given, the encoded file is sent to standard output. To encode a file from the standard input, use a single hyphen '-' and give a filename to be used by the encoded file as the next parameter.

NOTES
Reading from standard input and writing to standard output enforces certain limitations.

1.  Files read from standard input can only be used once, meaning that either none or exactly one of the -o, -m, -p options may be given.

2.  Output written to standard output cannot be split into multiple parts. In this case, the -lines option is ignored.

uuenview must be correctly configured at compile time in order to make automated mailing and posting work. If it doesn't, consult your system administrator. The program used for posting a file can be set at runtime using the INEWS environment variable. This setting overrides the compile-time configuration.

If you rename, copy or link the program to uuencode, it may act as a smart replacement for the standard, accepting the same command-line syntax. This has not been well-tested yet.

EXAMPLES

uuenview -m 'root,fred@somewhere.com' uudeview.tgz
    Encodes the file uudeview.tgz and mails it to both your local system administrator and to your friend Fred at the Somewhere company.

SEE ALSO
uudeview(1), uuencode(1), uudecode(1), mail(1), inews(1),

The uudeview homepage on the Web,
http://www.uni-frankfurt.de/~fp/uudeview/

BUGS
The MIME standard enforces a CRLF as the end-of-line marker. This causes some uudecode implementations to fail recognising the 'end' line. They will print a warning when decoding a uuenview encoded file, but the file is still decoded properly. Tell the remote party to use uudeview.

The program cannot detect error conditions when mailing or posting.