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
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
|
<!DOCTYPE RefEntry PUBLIC "-//Davenport//DTD DocBook V3.0//EN"[
<!entity commonopts
"<arg>--help</arg>
<arg>--version</arg>
<arg>--medium=<replaceable>mountpoint</replaceable></arg>
<arg>--fix-broken</arg>
<arg>--skip-mount</arg>">
]>
<refentry>
<refmeta>
<refentrytitle>apt-zip</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo>Debian GNU/Linux</refmiscinfo>
</refmeta>
<refnamediv>
<refname>apt-zip-list</refname>
<refname>apt-zip-inst</refname>
<refpurpose>Use apt with removable media</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>apt-zip-list</command>
&commonopts;
<arg>--method=<replaceable>method</replaceable></arg>
<arg>--options=<replaceable>option<optional>,option...</optional></replaceable></arg>
</cmdsynopsis>
<cmdsynopsis>
<command>apt-zip-inst</command>
&commonopts;
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<simpara>
The <command>apt-zip-list</command> and
<command>apt-zip-inst</command> commands simplify the upgrade
process of a non-networked Debian machine using
<citerefentry><refentrytitle/apt/<manvolnum/8/</citerefentry>,
by using (preferably high-capacity) removable media, like a
ZIP drive.
</simpara>
<simpara>
<command>apt-zip-list</command> produces a script that can be
used on another host (maybe not running a Debian system) to
fetch packages previously selected in
<citerefentry><refentrytitle/dselect/<manvolnum/8/</citerefentry>.
Various types of scripts can be generated, by specifying a fetch
method supported by the host that will fetch the packages. If
you prefer, the script may generate a tarball containing the
fetched packages.
</simpara>
<simpara>
The name of the script (as well as the name of the tarfile when using the
<option>tar</option> option) contains the name of the Debian
machine for which the packages are to be fetched. Thus you can,
using the same medium, upgrade several machines at the same time,
provided you have enough space on this disk. This should work with or
without the <option>tar</option> option.
</simpara>
<simpara>
The script is written to the removable medium, which is mounted
if necessary, and then restored to the original unmounted state
when applicable. It is the responsibility of the user then to
run the script on a host that will fetch the packages, and to
have them (or the generated archive) copied to the removable
medium.
</simpara>
<simpara>
when back on your Debian machine, you just run <command/apt-zip-inst/,
which will take care of the script-produced files, and call
<citerefentry><refentrytitle/apt/<manvolnum/8/</citerefentry> to
install the packages on your disk.
</simpara>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<refsect2>
<title>Common options</title>
<variablelist>
<varlistentry>
<term>--help, -h</term>
<listitem>
<simpara>Show summary of options.</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>--version, -V</term>
<listitem>
<simpara>Show version of program.</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>--medium, -m</term>
<listitem>
<simpara>Select a removable medium other than the site default.</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>--fix-broken, -f</term>
<listitem>
<simpara>Run <command>apt-get</command> with the
<option>--fix-broken</option> option. See
<citerefentry><refentrytitle/apt-get/<manvolnum/8/</citerefentry>
for more details.</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>--skip-mount</term>
<listitem>
<simpara>Allow specifying a non-mountpoint directory to
the <option>--medium</option> option. This may help on
laptops only getting point-to-point networking without
being routed to. This is also useful while testing the
program, as it allows sending the script into
/tmp.</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>Options for <command>apt-zip-list</command></title>
<variablelist>
<varlistentry>
<term>--method, -M</term>
<listitem>
<simpara>Select a method other than the default one.</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>--options, -o</term>
<listitem>
<simpara>Specifies a set of options to be used while
generating the script. A warning is issued only if an
option is unkown to <command>apt-zip-list</command>, but
all known options may not be supported by all methods.
Currently available options include
<option>tar</option>, which causes the dowloaded files
to be grouped into a tarball.</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>CONFIG FILE</title>
<simpara>
The <filename>/etc/apt/apt-zip.conf</filename> file can be used
to set default method and default removable medium to use. It is
a self-explainatory bourne-shell script snippet. It allows to
provide site defaults for command-line options.
</simpara>
</refsect1>
<refsect1>
<title>LIMITATIONS</title>
<itemizedlist>
<listitem>
<simpara>
Only one disk can be used. If your packages do not fit on
one, you have to deselect some packages using
<citerefentry><refentrytitle/dselect/<manvolnum/8/</citerefentry>.
</simpara>
</listitem>
<listitem>
<simpara>
The files on an Internet distribution site can change rather
frequently. It is up to the user to make sure the site was
not updated between the build of the fetch script by
<command>apt-zip-list</command> and the fetch itself,
otherwise some required files may not be possible to fetch.
</simpara>
</listitem>
</itemizedlist>
</refsect1>
<refsect1>
<title>BUGS</title>
<simplelist>
<member>
Virtually no error-checking is done. Examples of such error
conditions include: - out-of-diskspace on both the removable
medium and in apt archive cache when using <option>tar</option>
option.
</member>
<member>
Somewhat consequently, error-recovery also nears
non-existence. As examples, an interrupted fetch in tar mode
has to be restarted from zero; changes in
<filename>status</filename> file between runs of
<command>apt-zip-list</command> and
<command>apt-zip-inst</command> are not detected and may lead
to failure.
</member>
</simplelist>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<simpara>
The programs were written by <author><firstname/Yann/
<surname/Dirson/</author> <email/dirson@debian.org/ for the
Debian GNU/Linux system.
</simpara>
<simpara>The source for this reference page is an SGML file, which
can be converted to UNIX manpages using
<citerefentry><refentrytitle/docbook2man-spec/<manvolnum/1/</citerefentry></simpara>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<simpara>
<citerefentry><refentrytitle/apt/<manvolnum/8/</citerefentry>,
<citerefentry><refentrytitle/apt-get/<manvolnum/8/</citerefentry>,
<citerefentry><refentrytitle/dselect/<manvolnum/8/</citerefentry>.
</simpara>
</refsect1>
</refentry>
|
