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
|
.\" This manpage has been automatically generated by docbook2man-spec
.\" from a DocBook document. docbook2man-spec can be found at:
.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "APT-ZIP" "8" "07 janvier 2000" "Debian GNU/Linux" ""
.SH NAME
apt-zip-list, apt-zip-inst \- Use apt with removable media
.SH SYNOPSIS
.sp
\fBapt-zip-list\fR [ \fB--help\fR ] [ \fB--version\fR ] [ \fB--medium=\fImountpoint\fB\fR ] [ \fB--fix-broken\fR ] [ \fB--skip-mount\fR ] [ \fB--method=\fImethod\fB\fR ] [ \fB--options=\fIoption[,option...]\fB\fR ]
.sp
\fBapt-zip-inst\fR [ \fB--help\fR ] [ \fB--version\fR ] [ \fB--medium=\fImountpoint\fB\fR ] [ \fB--fix-broken\fR ] [ \fB--skip-mount\fR ]
.SH "DESCRIPTION"
.PP
The \fBapt-zip-list\fR and
\fBapt-zip-inst\fR commands simplify the upgrade
process of a non-networked Debian machine using
\fBapt\fR(8),
by using (preferably high-capacity) removable media, like a
ZIP drive.
.PP
\fBapt-zip-list\fR produces a script that can be
used on another host (maybe not running a Debian system) to
fetch packages previously selected in
\fBdselect\fR(8).
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.
.PP
The name of the script (as well as the name of the tarfile when using the
\fBtar\fR 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 \fBtar\fR option.
.PP
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.
.PP
when back on your Debian machine, you just run \fBapt-zip-inst\fR,
which will take care of the script-produced files, and call
\fBapt\fR(8) to
install the packages on your disk.
.SH "OPTIONS"
.SS "COMMON OPTIONS"
.TP
\fB--help, -h\fR
Show summary of options.
.TP
\fB--version, -V\fR
Show version of program.
.TP
\fB--medium, -m\fR
Select a removable medium other than the site default.
.TP
\fB--fix-broken, -f\fR
Run \fBapt-get\fR with the
\fB--fix-broken\fR option. See
\fBapt-get\fR(8)
for more details.
.TP
\fB--skip-mount\fR
Allow specifying a non-mountpoint directory to
the \fB--medium\fR 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.
.SS "OPTIONS FOR APT-ZIP-LIST"
.TP
\fB--method, -M\fR
Select a method other than the default one.
.TP
\fB--options, -o\fR
Specifies a set of options to be used while
generating the script. A warning is issued only if an
option is unkown to \fBapt-zip-list\fR, but
all known options may not be supported by all methods.
Currently available options include
\fBtar\fR, which causes the dowloaded files
to be grouped into a tarball.
.SH "CONFIG FILE"
.PP
The \fI/etc/apt/apt-zip.conf\fR 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.
.SH "LIMITATIONS"
.TP 0.2i
\(bu
Only one disk can be used. If your packages do not fit on
one, you have to deselect some packages using
\fBdselect\fR(8).
.TP 0.2i
\(bu
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
\fBapt-zip-list\fR and the fetch itself,
otherwise some required files may not be possible to fetch.
.SH "BUGS"
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 \fBtar\fR
option.
Somewhat consequently, error-recovery also nears
non-existence. As examples, an interrupted fetch in tar mode
has to be restarted from zero; changes in
\fIstatus\fR file between runs of
\fBapt-zip-list\fR and
\fBapt-zip-inst\fR are not detected and may lead
to failure.
.SH "AUTHOR"
.PP
The programs were written by Yann Dirson <dirson@debian.org> for the
Debian GNU/Linux system.
.PP
The source for this reference page is an SGML file, which
can be converted to UNIX manpages using
\fBdocbook2man-spec\fR(1)
.SH "SEE ALSO"
.PP
\fBapt\fR(8),
\fBapt-get\fR(8),
\fBdselect\fR(8).
|
