3ebb7ec3dfd9fb23775d1e228fee5b1475403b20
[platform/upstream/mtools.git] / mzip.1
1 '\" t
2 .TH mzip 1 "23Jul21" mtools-4.0.34
3 .SH Name
4 mzip - change protection mode and eject disk on Zip/Jaz drive
5 '\" t
6 .de TQ
7 .br
8 .ns
9 .TP \\$1
10 ..
11
12 .tr \(is'
13 .tr \(if`
14 .tr \(pd"
15
16 .SH Note\ of\ warning
17 This manpage has been automatically generated from mtools's texinfo
18 documentation, and may not be entirely accurate or complete.  See the
19 end of this man page for details.
20 .PP
21 .SH Description
22 .PP
23 The \fR\&\f(CWmzip\fR command is used to issue ZIP disk specific commands on
24 Linux, Solaris or HP-UX. Its syntax is:
25 .PP
26 .ft I
27 .nf
28 \&\fR\&\f(CWmzip\fR [\fR\&\f(CW-epqrwx\fR]
29 .fi
30 .ft R
31  
32 .PP
33 \&\fR\&\f(CWMzip\fR allows the following
34 command line options:
35 .TP
36 \&\fR\&\f(CWe\fR\ 
37 Ejects the disk.
38 .TP
39 \&\fR\&\f(CWf\fR\ 
40 Force eject even if the disk is mounted (must be given in addition to
41 \&\fR\&\f(CW-e\fR).
42 .TP
43 \&\fR\&\f(CWr\fR\ 
44 Write protect the disk.
45 .TP
46 \&\fR\&\f(CWw\fR\ 
47 Remove write protection.
48 .TP
49 \&\fR\&\f(CWp\fR\ 
50 Password write protect.
51 .TP
52 \&\fR\&\f(CWx\fR\ 
53 Password protect
54 .TP
55 \&\fR\&\f(CWu\fR\ 
56 Temporarily unprotect the disk until it is ejected.  The disk becomes
57 writable, and reverts back to its old state when ejected.
58 .TP
59 \&\fR\&\f(CWq\fR\ 
60 Queries the status
61 .PP
62 To remove the password, set it to one of the password-less modes
63 \&\fR\&\f(CW-r\fR or \fR\&\f(CW-w\fR: mzip will then ask you for the password, and
64 unlock the disk.  If you have forgotten the password, you can get rid of
65 it by low-level formatting the disk (using your SCSI adapter's BIOS
66 setup).
67 .PP
68 The ZipTools disk shipped with the drive is also password protected.  On
69 MS-DOS or on a Mac, this password is automatically removed once the
70 ZipTools have been installed.  From various articles posted to Usenet, I
71 learned that the password for the tools disk is
72 \&\fR\&\f(CWAPlaceForYourStuff\fR\fR.  Mzip knows about this
73 password, and tries it first, before prompting you for a password.  Thus
74 \&\fR\&\f(CWmzip -w z:\fR unlocks the tools disk.  The tools disk is
75 formatted in a special way so as to be usable both in a PC and in a Mac.
76 On a PC, the Mac file system appears as a hidden file named
77 \&\fR\&\f(CW\(ifpartishn.mac\(is\fR.  You may erase it to reclaim the 50 Megs of space
78 taken up by the Mac file system.
79 .PP
80 .SH Bugs
81 .PP
82 This command is a big kludge.  A proper implementation would take a
83 rework of significant parts of mtools, but unfortunately I don't have
84 the time for this right now. The main downside of this implementation is
85 that it is inefficient on some architectures (several successive calls
86 to mtools, which defeats mtools' caching).
87 .PP
88 .SH See\ Also
89 Mtools' texinfo doc
90 .SH Viewing\ the\ texi\ doc
91 This manpage has been automatically generated from mtools's texinfo
92 documentation. However, this process is only approximative, and some
93 items, such as crossreferences, footnotes and indices are lost in this
94 translation process.  Indeed, these items have no appropriate
95 representation in the manpage format.  Moreover, not all information has
96 been translated into the manpage version.  Thus I strongly advise you to
97 use the original texinfo doc.  See the end of this manpage for
98 instructions how to view the texinfo doc.
99 .TP
100 * \ \ 
101 To generate a printable copy from the texinfo doc, run the following
102 commands:
103  
104 .nf
105 .ft 3
106 .in +0.3i
107     ./configure; make dvi; dvips mtools.dvi
108 .fi
109 .in -0.3i
110 .ft R
111 .PP
112  
113 \&\fR
114 .TP
115 * \ \ 
116 To generate a html copy,  run:
117  
118 .nf
119 .ft 3
120 .in +0.3i
121     ./configure; make html
122 .fi
123 .in -0.3i
124 .ft R
125 .PP
126  
127 \&\fRA premade html can be found at
128 \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
129 .TP
130 * \ \ 
131 To generate an info copy (browsable using emacs' info mode), run:
132  
133 .nf
134 .ft 3
135 .in +0.3i
136     ./configure; make info
137 .fi
138 .in -0.3i
139 .ft R
140 .PP
141  
142 \&\fR
143 .PP
144 The texinfo doc looks most pretty when printed or as html.  Indeed, in
145 the info version certain examples are difficult to read due to the
146 quoting conventions used in info.
147 .PP