Imported Upstream version 4.0.40
[platform/upstream/mtools.git] / mcat.1
1 '\" t
2 .TH mcat 1 "04Jun22" mtools-4.0.40
3 .SH Name
4 mcat - dump raw disk image
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(CWmcat\fR command is used to copy an entire disk image from or
24 to the floppy device. It uses the following syntax:
25 .PP
26 \&\fR\&\f(CWmcat\fR [\fR\&\f(CW-w\fR] \fIdrive\fR\fR\&\f(CW:\fR
27 .PP
28 \&\fR\&\f(CWMcat\fR performs the same task as the Unix \fR\&\f(CWcat\fR command. It
29 is included into the mtools package, since \fR\&\f(CWcat\fR cannot access
30 remote floppy devices offered by the mtools floppy daemon.
31 Now it is possible to create boot floppies remotely.
32 .PP
33 The default operation is reading. The output is written to stdout.
34 .PP
35 If the \fR\&\f(CW-w\fR option is specified, mcat reads a disk-image from 
36 stdin and writes it to the given device. 
37 \&\fBUse this carefully!\fR Because of the low-level nature of this 
38 command, it will happily destroy any data written before on the
39 disk without warning!
40 .PP
41 .SH See\ Also
42 Mtools' texinfo doc
43 .SH Viewing\ the\ texi\ doc
44 This manpage has been automatically generated from mtools's texinfo
45 documentation. However, this process is only approximative, and some
46 items, such as crossreferences, footnotes and indices are lost in this
47 translation process.  Indeed, these items have no appropriate
48 representation in the manpage format.  Moreover, not all information has
49 been translated into the manpage version.  Thus I strongly advise you to
50 use the original texinfo doc.  See the end of this manpage for
51 instructions how to view the texinfo doc.
52 .TP
53 * \ \ 
54 To generate a printable copy from the texinfo doc, run the following
55 commands:
56  
57 .nf
58 .ft 3
59 .in +0.3i
60     ./configure; make dvi; dvips mtools.dvi
61 .fi
62 .in -0.3i
63 .ft R
64 .PP
65  
66 \&\fR
67 .TP
68 * \ \ 
69 To generate a html copy,  run:
70  
71 .nf
72 .ft 3
73 .in +0.3i
74     ./configure; make html
75 .fi
76 .in -0.3i
77 .ft R
78 .PP
79  
80 \&\fRA premade html can be found at
81 \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
82 .TP
83 * \ \ 
84 To generate an info copy (browsable using emacs' info mode), run:
85  
86 .nf
87 .ft 3
88 .in +0.3i
89     ./configure; make info
90 .fi
91 .in -0.3i
92 .ft R
93 .PP
94  
95 \&\fR
96 .PP
97 The texinfo doc looks most pretty when printed or as html.  Indeed, in
98 the info version certain examples are difficult to read due to the
99 quoting conventions used in info.
100 .PP