1uuencode(1) User Commands uuencode(1)
2
6 uuencode - encode a file into email friendly text
7
9 uuencode [-flags] [-flag [value]] [--option-name[[=| ]value]] [<in-
10 file>] <output-name>
11
14 uuencode is used to create an ASCII representation of a file that can
15 be sent over channels that may otherwise corrupt the data. Specifi‐
16 cally, email cannot handle binary data and will often even insert a
17 character when the six character sequence "0rom " is seen.
18 uuencode will read in-file if provided and otherwise read data from
20 standard in and write the encoded form to standard out. The output
21 will begin with a header line for use by uudecode giving it the result‐
22 ing suggested file output-name and access mode. If the output-name is
23 specifically /dev/stdout, then uudecode will emit the decoded file to
24 standard out.
25 Note: uuencode uses buffered input and assumes that it is not hand
27 typed from a tty. The consequence is that at a tty, you may need to
28 hit Ctl-D several times to terminate input.
29
31 -m, --base64
32 convert using base64.
33 By default, uuencode will encode using the traditional conver‐
35 sion. It is slower and less compact than base64. The encoded
36 form of the file is expanded by 37% for UU encoding and by 35%
37 for base64 encoding (3 bytes become 4 plus control information).
38 -e, --encode-file-name
40 encode the output file name.
41 Since output file names may contain characters that are not han‐
43 dled well by various transmission modes, you may specify that
44 the output-name be base64 encoded as well. (Traditional uuen‐
45 coding of the file name is not supported.)
46 -h, --help
48 Display usage information and exit.
49 -!, --more-help
51 Pass the extended usage information through a pager.
52 -R [cfgfile], --save-opts [=cfgfile]
54 Save the option state to cfgfile. The default is the last con‐
55 figuration file listed in the OPTION PRESETS section, below.
56 The command will exit after updating the config file.
57 -r cfgfile, --load-opts=cfgfile, --no-load-opts
59 Load options from cfgfile. The no-load-opts form will disable
60 the loading of earlier config/rc/ini files. --no-load-opts is
61 handled early, out of order.
62 -v [{v|c|n --version [{v|c|n}]}]
64 Output version of program and exit. The default mode is `v', a
65 simple version. The `c' mode will print copyright information
66 and `n' will print the full copyright notice.
67
69 Any option that is not marked as not presettable may be preset by load‐
70 ing values from configuration ("RC" or ".INI") file(s). The file
71 "$HOME/.sharrc" will be used, if present.
72
74 This implementation is compliant with P1003.2b/D11.
75
77 See OPTION PRESETS for configuration files.
78
80 One of the following exit values will be returned:
81 0 (EXIT_SUCCESS)
83 Successful program execution.
84 1 (EXIT_FAILURE)
86 The operation failed or the command syntax was not valid.
87 66 (EX_NOINPUT)
89 A specified configuration file could not be loaded.
90 70 (EX_SOFTWARE)
92 libopts had an internal operational error. Please report it to
93 autogen-users@lists.sourceforge.net. Thank you.
94
96 uudecode(1), uuencode(5)
97
99 The uuencode command first appeared in BSD 4.0.
100
102 Free Software Foundation, Inc.
103
105 Copyright (C) 1994-2015 Free Software Foundation, Inc. all rights
106 reserved. This program is released under the terms of the GNU General
107 Public License, version 3 or later.
108
110 Please put sharutils in the subject line for emailed bug reports. It
111 helps to spot the message.
112 Please send bug reports to: bug-gnu-utils@gnu.org
114
116 This manual page was AutoGen-erated from the uuencode option defini‐
117 tions.
118GNU sharutils (4.15.2) 30 May 2015 uuencode(1)