Penguin
Recent Changes
Annotated edit history of unshar(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 UNSHAR
2 !!!UNSHAR
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SEE ALSO
8 DIAGNOSTICS
9 AUTHORS
10 ----
11 !!NAME
12
13
14 unshar - unpack a shar file
15 !!SYNOPSIS
16
17
18 unshar [[ options ] [[ file ... ]
19 !!DESCRIPTION
20
21
22 Unshar scans mail messages looking for the start of a shell
23 archive. It then passes the archive through a copy of the
24 shell to unpack it. It will accept multiple files. If no
25 files are given, standard input is used.
26 !!OPTIONS
27
28
29 Options have a one letter version starting with - or a long
30 version starting with --. The exception is ''--help'' and
31 ''--version'', which does not have a short
32 version.
33
34
35 ''--version''
36
37
38 Print the version number of the program on standard output,
39 then immediately exits.
40
41
42 ''--help''
43
44
45 Print a help summary on standard output, then immediately
46 exits.
47
48
49 ''-d'' DIRECTORY
50 ''--directory=''DIRECTORY
51
52
53 Change directory to DIRECTORY before unpacking any
54 files.
55
56
57 ''-c --overwrite''
58
59
60 Passed as an option to the shar file. Many shell archive
61 scripts (including those produced by `shar' 3.40 and newer)
62 accepts a ''-c'' argument to indicate that existing files
63 should be overwritten.
64
65
66 ''-e --exit-0''
67
68
69 This option exists mainly for people who collect many shell
70 archives into a single mail folder. With this option,
71 `unshar' isolates each different shell archive from the
72 others which have been put in the same file, unpacking each
73 in turn, from the beginning of the file towards its end. Its
74 proper operation relies on the fact that many shar files are
75 terminated by a `exit 0' at the beginning of a
76 line.
77
78
79 Option ''-e'' is internally equivalent to ''-E''
80 ''
81
82
83 ''-E'' STRING ''--split-at=''STRING
84
85
86 This option works like ''-e'', but it allows you to
87 specify the string that separates archives if `exit 0' isn't
88 appropriate.
89
90
91 For example, noticing that most `.signatures' have a `--' on
92 a line right before them, one can sometimes use
93 `''--split-at''=--' for splitting shell archives which
94 lack the `exit 0' line at end. The signature will then be
95 skipped altogether with the headers of the following
96 message.
97
98
99 ''-f --force''
100
101
102 The same as ''-c''.
103 !!SEE ALSO
104
105
106 shar(1)
107 !!DIAGNOSTICS
108
109
110 Any message from the shell may be displayed.
111 !!AUTHORS
112
113
114 The shar and unshar programs is the collective work of many
115 authors. Many people contributed by reporting problems,
116 suggesting various improvements or submitting actual code. A
117 list of these people is in the THANKS file in the sharutils
118 distribution.
119 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.