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