maux
Star on GitHub Buy me a coffee

Manual / uudecode

uudecode(1)

UUDECODE(1) General Commands Manual UUDECODE(1)

uudecode - decode a uuencode(1) file

uudecode [ -o outfile ] [ file ]

Uudecode reads file (or standard input) and skips any text before the first begin or begin-base64 line -- tolerant of banner or mail-header noise ahead of it. Both the historical uuencode alphabet and base64 (RFC 4648) are accepted, distinguished by that header line; the body's trailer (a zero-length line and end, or a line of ====) is required, matching this line of uuencode/uudecode elsewhere.

The decoded bytes are written to the pathname named in the header, unless -o overrides it.

Write the decoded bytes to outfile instead of the header's own pathname. Outfile of /dev/stdout writes to standard output instead of creating a file.

Uudecode accepts EITHER of maux's two text conventions on input: a high-bit maux text file (what this build's own uuencode writes) or plain 7-bit ASCII (what arrives over tip(1), whose line reader strips the high bit before a byte ever reaches a redirected file, docs/SERIAL.md). Every input byte is normalized to 7 bits before use, so the same decode path reads either convention without a flag or a guess.

/usr/man/UUDECODE this page

uuencode(1), tip(1)

Exit status is 0 on success; 1 if no begin line is ever found, if the body ends before its trailer (a short file), if the body contains an invalid character or a misplaced =, or if the output file could not be opened or created; 2 on a usage error.

The header's mode field is read and discarded: this machine has no permission bits to apply to the decoded file.

September 14, 2026 maux