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