This repository has been archived by the owner on Dec 14, 2020. It is now read-only.
/
fatdump.html
182 lines (132 loc) · 4.99 KB
/
fatdump.html
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
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
<!-- Creator : groff version 1.21 -->
<!-- CreationDate: Mon Aug 10 14:21:18 2015 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>FATDUMP</title>
</head>
<body>
<h1 align="center">FATDUMP</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#EXIT CODES">EXIT CODES</a><br>
<a href="#EXAMPLES">EXAMPLES</a><br>
<a href="#KNOWN ISSUES">KNOWN ISSUES</a><br>
<a href="#AUTHORS">AUTHORS</a><br>
<a href="#AVAILABILITY">AVAILABILITY</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">fatdump −
Efficiently dump the contents of a FAT volume.</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>fatdump</b>
[<i>options</i>] <i>device|image</i></p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><i><b>fatdump</b></i>
will efficiently extract all relevant metadata and
(optionally) data from an FAT volume and dump it to standard
output. It works at disk sector level and copies only the
used data. Unused disk space becomes zero.</p>
<p style="margin-left:11%; margin-top: 1em"><b>fatdump</b>
can be useful to make backups, an exact snapshot of a FAT
filesystem to restore later on, or for developers to
troubleshoot/investigate users’ issues using the clone
without the risk of destroying the original filesystem.</p>
<h2>OPTIONS
<a name="OPTIONS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Below is a
summary of all the options that <b>fatdump</b> accepts.
Nearly all options have two equivalent names. The short name
is preceded by <b>−</b> and the long name is preceded
by <b>−− . <br>
−m</b>, <b>−−metadata</b></p>
<p style="margin-left:22%;">Clone <b>ONLY METADATA</b> (for
FAT experts). A metadata dump contains all of the FAT volume
structures but none of the user data, i.e. all file content
will be omitted but the directory structure will be
preserved. The output from this command will be relatively
small if compressed.</p>
<p style="margin-left:11%;"><b>−n</b>,
<b>−−ntfsclone-image</b></p>
<p style="margin-left:22%;">Emit an ntfsclone packed image
(special image format) as output. This saves space since all
the non-allocated regions (and in the case of
’−m’ /’−−metadata’
all the non-metadata regions) will not be written out
explicitly, but instead marked as a ’hole’ in
the image.</p>
<p style="margin-left:11%;"><b>−q</b>,
<b>−−quiet</b></p>
<p style="margin-left:22%;">Suppress non-error output on
stderr.</p>
<p style="margin-left:11%;"><b>−f</b>,
<b>−−force</b></p>
<p style="margin-left:22%;">Force a clone, ignoring errors
from cluster accounting.</p>
<h2>EXIT CODES
<a name="EXIT CODES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The exit code
is 0 on success, non−zero otherwise.</p>
<h2>EXAMPLES
<a name="EXAMPLES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Dump FAT file
system on /dev/sda1 to a compressed metadata image:</p>
<p style="margin-left:22%; margin-top: 1em"><b>fatdump
/dev/sda1 | bzip2 > sda1.img.bz2</b></p>
<p style="margin-left:11%; margin-top: 1em">Dump FAT file
system metadata on /dev/sda1 to a compressed metadata
image:</p>
<p style="margin-left:22%; margin-top: 1em"><b>fatdump
−m /dev/sda1 | bzip2 > sda1.img.bz2</b></p>
<p style="margin-left:11%; margin-top: 1em">Dump a FAT
volume to a remote host, using ssh. Please note that ssh may
ask for a password!</p>
<p style="margin-left:22%; margin-top: 1em"><b>fatdump
/dev/sda1 | bzip2 | ssh host ’cat >
sda1.img.bzip2’</b></p>
<h2>KNOWN ISSUES
<a name="KNOWN ISSUES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">There are no
known problems with <b>fatdump</b>. If you think you have
found a problem then please send an email describing it to
fat-support@tuxera.com.</p>
<h2>AUTHORS
<a name="AUTHORS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>fatdump</b>
was written by Sougata Santra, Tuxera Inc.</p>
<h2>AVAILABILITY
<a name="AVAILABILITY"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>fatdump</b>
is part of the <b>Tuxera FAT</b> package.</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>fatdebug</b>(8)</p>
<hr>
</body>
</html>