summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man1/uudecode.1
blob: 8b6d0f52a9c0674c42dcd9fe320bf7bb2b722ca4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
.de1 NOP
.  it 1 an-trap
.  if \\n[.$] \,\\$*\/
..
.ie t \
.ds B-Font [CB]
.ds I-Font [CI]
.ds R-Font [CR]
.el \
.ds B-Font B
.ds I-Font I
.ds R-Font R
.TH uudecode 1 "30 May 2015" "GNU sharutils (4.15.2)" "User Commands"
.\"
.\" DO NOT EDIT THIS FILE (in-mem file)
.\"
.\" It has been AutoGen-ed
.\" From the definitions uudecode-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
\f\*[B-Font]uudecode\fP
\- decode an encoded file
.SH SYNOPSIS
\f\*[B-Font]uudecode\fP
.\" Mixture of short (flag) options and long options
[\f\*[B-Font]\-flags\f[]]
[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]]
[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]]
[<file>...]
.sp \n(Ppu
.ne 2

If no \fIfile\fP(s) are provided, then standard input is decoded.
.SH "DESCRIPTION"
\fIuudecode\fP transforms uuencoded files into their original form.
.sp
The encoded file(s) may be specified on the command line, or one may
be read from standard input.  The output file name is specified in
the encoded file, but may be overridden with the \fB-o\fP option.
It will have the mode of the original file, except that setuid and
execute bits are not retained.  If the output file is specified to
be \fI/dev/stdout\fP or \fI-\fP, the result will be written to
standard output. If there are multiple input files and the second or
subsquent file specifies standard output, the decoded data will be
written to the same file as the previous output.  Don't do that.
.sp
\fIuudecode\fP ignores any leading and trailing lines.  It looks
for a line that starts with "\fBbegin\fP" and proceeds until the
end-of-encoding marker is found.  The program determines from the
header line of the encoded file which of the two supported encoding
schemes was used and whether or not the output file name has been
encoded with base64 encoding.  See \fIuuencode(5)\fP.
.SH "OPTIONS"
.TP
.NOP \f\*[B-Font]\-o\f[] \f\*[I-Font]file\f[], \f\*[B-Font]\-\-output\-file\f[]=\f\*[I-Font]file\f[]
direct output to \fIfile\fP.
.sp
If specified, decoded data are written to this file.  When multiple
inputs are specified on the command line, this option cannot be
specified.  All decoded data must be written to the file name
encoded in the data.
.TP
.NOP \f\*[B-Font]\-c\f[], \f\*[B-Font]\-\-ignore\-chmod\f[]
ignore \fBfchmod(3P)\fP errors.
.sp
By default, if the output file permissions cannot be changed to
the permissions specified in the encoded data, the file will not
be written out and execution stops.  This option will cause that
error to be ignored.  The resulting file will have all the data,
but the incorrect mode settings.
.sp
\fBfchmod()\fP errors are also ignored if
\fBPOSIXLY_CORRECT\fP is set in the environment.  RE:
\fIhttp://austingroupbugs.net/view.php?id=635\fP
.sp
A warning is always emitted when \fBfchmod()\fP fails.
.TP
.NOP \f\*[B-Font]\-h\f[], \f\*[B-Font]\-\-help\f[]
Display usage information and exit.
.TP
.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more\-help\f[]
Pass the extended usage information through a pager.
.TP
.NOP \f\*[B-Font]\-R\f[] [\f\*[I-Font]cfgfile\f[]], \f\*[B-Font]\-\-save\-opts\f[] [=\f\*[I-Font]cfgfile\f[]]
Save the option state to \fIcfgfile\fP.  The default is the \fIlast\fP
configuration file listed in the \fBOPTION PRESETS\fP section, below.
The command will exit after updating the config file.
.TP
.NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-load\-opts\f[]=\f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-no\-load\-opts\f[]
Load options from \fIcfgfile\fP.
The \fIno\-load\-opts\fP form will disable the loading
of earlier config/rc/ini files.  \fI\-\-no\-load\-opts\fP is handled early,
out of order.
.TP
.NOP \f\*[B-Font]\-v\f[] [{\f\*[I-Font]v|c|n\f[] \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}]}]
Output version of program and exit.  The default mode is `v', a simple
version.  The `c' mode will print copyright information and `n' will
print the full copyright notice.
.PP
.sp
.SH "OPTION PRESETS"
Any option that is not marked as \fInot presettable\fP may be preset
by loading values from configuration ("RC" or ".INI") file(s).
The file "\fI$HOME/.sharrc\fP" will be used, if present.
.SH STANDARDS
This implementation is compliant with P1003.2b/D11.
.SH "FILES"
See \fBOPTION PRESETS\fP for configuration files.
.SH "EXIT STATUS"
One of the following exit values will be returned:
.TP
.NOP 0 " (EXIT_SUCCESS)"
Successful program execution.
.TP
.NOP 1 " (EXIT_OPTION_ERROR)"
The command options were misconfigured.
.TP
.NOP 2 " (EXIT_INVALID)"
(warning) One or more input files contained no valid data
.TP
.NOP 4 " (EXIT_NO_INPUT)"
(warning) The specified input file was not found
.TP
.NOP 8 " (EXIT_NO_OUTPUT)"
The specified output file could not be created (error); or else one of the output files could not be written or its access mode could not be changed (warnings).  The accompanying message(s) will distinguish.
.TP
.NOP 9 " (EXIT_NO_MEM)"
No process memory available
.TP
.NOP 66 " (EX_NOINPUT)"
A specified configuration file could not be loaded.
.TP
.NOP 70 " (EX_SOFTWARE)"
libopts had an internal operational error.  Please report
it to autogen-users@lists.sourceforge.net.  Thank you.
.sp \n(Ppu
.ne 2

The exit status codes are (mostly) warning codes.
As such, each code is "or"\-ed into the final exit code as the input
files are processed.  For example, an exit code of '6' is not listed
above.  It is the sum of \fBEXIT_INVALID\fP and \fBEXIT_NO_INPUT\fP.
It would mean that at least one input file contained invalid
data and also at least one input file could not be found at all.
.PP
.SH "SEE ALSO"
uuencode(1), uuencode(5)
.SH "AUTHORS"
Free Software Foundation, Inc.
.SH "COPYRIGHT"
Copyright (C) 1994-2015 Free Software Foundation, Inc. all rights reserved.
This program is released under the terms of the GNU General Public License, version 3 or later.
.SH BUGS
Please put \fBsharutils\fP in the subject line for emailed bug
reports.  It helps to spot the message.
.sp \n(Ppu
.ne 2

If more than one \fIname\fP in the encoded files are the same, or
if the second or following input files specifies standard output
for the output file, then the result is probably not what is expected.
Specifically, standard output will be appended to and named output
files will be replaced.
.sp \n(Ppu
.ne 2

Please send bug reports to: bug-gnu-utils@gnu.org
.SH "NOTES"
This manual page was \fIAutoGen\fP-erated from the \fBuudecode\fP
option definitions.