source: postlfs/filesystems/ntfs-3g.xml@ cf67717

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since cf67717 was cf67717, checked in by Bruce Dubbs <bdubbs@…>, 10 years ago

Fix man/doc locations for docbook-utils, sgml-common, tripwire
Restore the ed editor
Finish tagging for Post LFS Part of the book

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@12770 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 15.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY ntfs-3g-download-http
8 "http://tuxera.com/opensource/ntfs-3g_ntfsprogs-&ntfs-3g-version;.tgz">
9 <!ENTITY ntfs-3g-download-ftp " ">
10 <!ENTITY ntfs-3g-md5sum "2d6fb47ddf62b51733227126fe9227fe">
11 <!ENTITY ntfs-3g-size "1.2 MB">
12 <!ENTITY ntfs-3g-buildsize "24 MB">
13 <!ENTITY ntfs-3g-time "0.4 SBU">
14]>
15
16<sect1 id="ntfs-3g" xreflabel="ntfs-3g-&ntfs-3g-version;">
17 <?dbhtml filename="ntfs-3g.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>ntfs-3g-&ntfs-3g-version;</title>
25
26 <indexterm zone="ntfs-3g">
27 <primary sortas="a-ntfs-3g">ntfs-3g</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Ntfs-3g</title>
32
33 <para>
34 The <application>Ntfs-3g</application> package contains an open source,
35 driver for Windows NTFS file system. This can mount Windows partitions
36 so that they are writeable and allows you edit or delete Windows files
37 from Linux.
38 </para>
39
40 &lfs75_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&ntfs-3g-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&ntfs-3g-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &ntfs-3g-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &ntfs-3g-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &ntfs-3g-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &ntfs-3g-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Ntfs-3g Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Optional</bridgehead>
79 <para role="optional">
80 <xref linkend="fuse"/>.
81 </para>
82
83 <para condition="html" role="usernotes">
84 User Notes: <ulink url="&blfs-wiki;/ntfs-3g"/>
85 </para>
86 </sect2>
87
88 <sect2 role="kernel" id="ntfs-3g-kernel">
89 <title>Kernel Configuration</title>
90
91 <para>
92 Enable the following options in the kernel configuration and recompile the
93 kernel if necessary:
94 </para>
95
96<screen><literal>File systems ---&gt;
97 [*] FUSE (Filesystem in Userspace) support</literal></screen>
98
99 <indexterm zone="ntfs-3g ntfs-3g-kernel">
100 <primary sortas="d-ntfs-3g">ntfs-3g</primary>
101 </indexterm>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of Ntfs-3g</title>
106
107 <para>
108 Install <application>Ntfs-3g</application> by running the following
109 commands:
110 </para>
111
112<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
113make</userinput></screen>
114
115 <para>
116 This package does not come with a test suite.
117 </para>
118
119 <para>
120 Now, as the <systemitem class="username">root</systemitem> user:
121 </para>
122
123<screen role="root"><userinput>make install &amp;&amp;
124ln -sv ../bin/ntfs-3g /sbin/mount.ntfs &amp;&amp;
125ln -sv /usr/share/man/man8/{ntfs-3g,mount.ntfs}.8</userinput></screen>
126
127 <para>
128 If you want ordinary users to be able to mount NTFS partitions you'll need
129 to set mount.ntfs with the root user ID. Note: it is probably unsafe to do
130 this on a computer that needs to be secure (like a server). As the
131 <systemitem class="username">root</systemitem> user:
132 </para>
133
134<screen role="root"><userinput>chmod -v 4755 /sbin/mount.ntfs</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
142 href="../../xincludes/static-libraries.xml"/>
143
144 <para>
145 <option>--with-fuse=external</option>: Ntfs-3g comes with a version of
146 Fuse which it statically compiles into <command>lowntfs-3g</command> and
147 <command>ntfs-3g</command>. If you have installed <xref linkend="fuse"/>
148 use this <option>--with-fuse=external</option> option to dynamically link
149 <command>lowntfs-3g</command> and <command>ntfs-3g</command> to libfuse.
150 </para>
151
152 <para>
153 <command>ln -sv ../bin/ntfs-3g /sbin/mount.ntfs</command>: Creating
154 /sbin/mount.ntfs makes <command>mount</command> default to using Ntfs-3g
155 to mount NTFS partitions.
156 </para>
157
158 <para>
159 <command>chmod -v 4755 /sbin/mount.ntfs</command>: Making mount.ntfs setuid
160 root allows non root users to mount NTFS partitions.
161 </para>
162
163 </sect2>
164
165 <sect2 role="configuration">
166 <title>Using Ntfs-3g</title>
167
168 <para>
169 To mount a Windows partition at boot time, put a line like this in
170 /etc/fstab:
171 </para>
172
173 <screen>/dev/sda1 /mnt/windows auto defaults 0 0</screen>
174
175 <para>
176 To allow users to mount a usb stick with an NTFS filesystem on it, put a
177 line similar this (change sdc1 to whatever a usb stick would be on your
178 system) in /etc/fstab:
179 </para>
180
181 <screen>/dev/sdc1 /mnt/usb auto user,noauto,umask=0,utf8 0 0</screen>
182
183 <para>
184 For a user to be able to mount the usb stick they will need to be able to
185 write to <filename class="directory">/mnt/usb</filename>, so as the
186 <systemitem class="username">root</systemitem>
187 user:
188 </para>
189
190<screen role="root"><userinput>chmod -v 777 /mnt/usb</userinput></screen>
191
192 </sect2>
193
194 <sect2 role="content">
195 <title>Contents</title>
196
197 <segmentedlist>
198 <segtitle>Installed Programs</segtitle>
199 <segtitle>Installed Library</segtitle>
200 <segtitle>Installed Directories</segtitle>
201
202 <seglistitem>
203 <seg>
204 lowntfs-3g, mkfs.ntfs, mkntfs, mount.lowntfs-3g,
205 mount.ntfs, mount.ntfs-3g, ntfs-3g, ntfs-3g.probe,
206 ntfs-3g.secaudit, ntfs-3g.usermap, ntfscat,
207 ntfsclone, ntfscluster, ntfscmp, ntfscp, ntfsfix,
208 ntfsinfo, ntfslabel, ntfsls, ntfsresize and
209 ntfsundelete
210 </seg>
211 <seg>
212 libntfs-3g.so
213 </seg>
214 <seg>
215 /usr/include/ntfs-3g and
216 /usr/share/doc/ntfs-3g
217 </seg>
218 </seglistitem>
219 </segmentedlist>
220
221 <variablelist>
222 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
223 <?dbfo list-presentation="list"?>
224 <?dbhtml list-presentation="table"?>
225
226 <varlistentry id="lowntfs-3g">
227 <term><command>lowntfs-3g</command></term>
228 <listitem>
229 <para>
230 is similar to ntfs-3g but uses the Fuse low-level interface.
231 </para>
232 <indexterm zone="ntfs-3g lowntfs-3g">
233 <primary sortas="b-lowntfs-3g">lowntfs-3g</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="mkfs.ntfs">
239 <term><command>mkfs.ntfs</command></term>
240 <listitem>
241 <para>
242 is a symlink to mkntfs.
243 </para>
244 <indexterm zone="ntfs-3g mkfs.ntfs">
245 <primary sortas="b-mkfs.ntfs">mkfs.ntfs</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249
250 <varlistentry id="mkntfs">
251 <term><command>mkntfs</command></term>
252 <listitem>
253 <para>
254 creates an NTFS file system.
255 </para>
256 <indexterm zone="ntfs-3g mkntfs">
257 <primary sortas="b-mkntfs">mkntfs</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="mount.lowntfs-3g">
263 <term><command>mount.lowntfs-3g</command></term>
264 <listitem>
265 <para>
266 is a symlink to lowntfs-3g.
267 </para>
268 <indexterm zone="ntfs-3g mount.lowntfs-3g">
269 <primary sortas="b-mount.lowntfs-3g">mount.lowntfs-3g</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="mount.ntfs">
275 <term><command>mount.ntfs</command></term>
276 <listitem>
277 <para>
278 mounts an NTFS filesystem.
279 </para>
280 <indexterm zone="ntfs-3g mount.ntfs">
281 <primary sortas="b-mount.ntfs">mount.ntfs</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="mount.ntfs-3g">
287 <term><command>mount.ntfs-3g</command></term>
288 <listitem>
289 <para>
290 is a symbolic link to ntfs-3g.
291 </para>
292 <indexterm zone="ntfs-3g mount.ntfs-3g">
293 <primary sortas="b-mount.ntfs-3g">mount.ntfs-3g</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="ntfs-3g-prog">
299 <term><command>ntfs-3g</command></term>
300 <listitem>
301 <para>
302 is an NTFS driver, which can create, remove, rename, move
303 files, directories, hard links, and streams; it can read and write
304 files, including streams, sparse files and transparently compressed
305 files; it can handle special files like symbolic links, devices, and
306 FIFOs; moreover it provides standard management of file ownership
307 and permissions, including POSIX ACLs.
308 </para>
309 <indexterm zone="ntfs-3g ntfs-3g-prog">
310 <primary sortas="b-ntfs-3g">ntfs-3g</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314
315 <varlistentry id="ntfs-3g.probe">
316 <term><command>ntfs-3g.probe</command></term>
317 <listitem>
318 <para>
319 tests if an NTFS volume is mountable read only or read-write, and
320 exits with a status value accordingly. The volume can be a block
321 device or image file.
322 </para>
323 <indexterm zone="ntfs-3g ntfs-3g.probe">
324 <primary sortas="b-ntfs-3g.probe">ntfs-3g.probe</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328
329 <varlistentry id="ntfs-3g.secaudit">
330 <term><command>ntfs-3g.secaudit</command></term>
331 <listitem>
332 <para>
333 audits NTFS Security Data.
334 </para>
335 <indexterm zone="ntfs-3g ntfs-3g.secaudit">
336 <primary sortas="b-ntfs-3g.secaudit">ntfs-3g.secaudit</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 <varlistentry id="ntfs-3g.usermap">
342 <term><command>ntfs-3g.usermap</command></term>
343 <listitem>
344 <para>
345 creates the file defining the mapping of Windows accounts to Linux
346 logins for users who owns files which should be visible from both
347 Windows and Linux.
348 </para>
349 <indexterm zone="ntfs-3g ntfs-3g.usermap">
350 <primary sortas="b-ntfs-3g.usermap">ntfs-3g.usermap</primary>
351 </indexterm>
352 </listitem>
353 </varlistentry>
354
355 <varlistentry id="ntfscluster">
356 <term><command>ntfscluster</command></term>
357 <listitem>
358 <para>
359 identifies files in a specified region of an NTFS volume
360 </para>
361 <indexterm zone="ntfs-3g ntfscluster">
362 <primary sortas="b-ntfscluster">ntfscluster</primary>
363 </indexterm>
364 </listitem>
365 </varlistentry>
366
367 <varlistentry id="ntfscp">
368 <term><command>ntfscp</command></term>
369 <listitem>
370 <para>
371 copies a file to an NTFS volume.
372 </para>
373 <indexterm zone="ntfs-3g ntfscp">
374 <primary sortas="b-ntfscp">ntfscp</primary>
375 </indexterm>
376 </listitem>
377 </varlistentry>
378
379 <varlistentry id="ntfsfix">
380 <term><command>ntfsfix</command></term>
381 <listitem>
382 <para>
383 fixes common errors and forces Windows to check an NTFS partition.
384 </para>
385 <indexterm zone="ntfs-3g ntfsfix">
386 <primary sortas="b-ntfsfix">ntfsfix</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="ntfsls">
392 <term><command>ntfsls</command></term>
393 <listitem>
394 <para>
395 lists directory contents on an NTFS filesystem.
396 </para>
397 <indexterm zone="ntfs-3g ntfsls">
398 <primary sortas="b-ntfsls">ntfsls</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 <varlistentry id="ntfscat">
404 <term><command>ntfscat</command></term>
405 <listitem>
406 <para>
407 prints NTFS files and streams on the standard output.
408 </para>
409 <indexterm zone="ntfs-3g ntfscat">
410 <primary sortas="b-ntfscat">ntfscat</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="ntfsclone">
416 <term><command>ntfsclone</command></term>
417 <listitem>
418 <para>
419 clones an NTFS filesystem.
420 </para>
421 <indexterm zone="ntfs-3g ntfsclone">
422 <primary sortas="b-ntfsclone">ntfsclone</primary>
423 </indexterm>
424 </listitem>
425 </varlistentry>
426
427 <varlistentry id="ntfscmp">
428 <term><command>ntfscmp</command></term>
429 <listitem>
430 <para>
431 compares two NTFS filesystems and tells the differences.
432 </para>
433 <indexterm zone="ntfs-3g ntfscmp">
434 <primary sortas="b-ntfscmp">ntfscmp</primary>
435 </indexterm>
436 </listitem>
437 </varlistentry>
438
439 <varlistentry id="ntfsinfo">
440 <term><command>ntfsinfo</command></term>
441 <listitem>
442 <para>
443 dumps a file's attributes.
444 </para>
445 <indexterm zone="ntfs-3g ntfsinfo">
446 <primary sortas="b-ntfsinfo">ntfsinfo</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="ntfslabel">
452 <term><command>ntfslabel</command></term>
453 <listitem>
454 <para>
455 displays or changes the label on an ntfs file system.
456 </para>
457 <indexterm zone="ntfs-3g ntfslabel">
458 <primary sortas="b-ntfslabel">ntfslabel</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462
463 <varlistentry id="ntfsresize">
464 <term><command>ntfsresize</command></term>
465 <listitem>
466 <para>
467 resizes an NTFS filesystem without data loss.
468 </para>
469 <indexterm zone="ntfs-3g ntfsresize">
470 <primary sortas="b-ntfsresize">ntfsresize</primary>
471 </indexterm>
472 </listitem>
473 </varlistentry>
474
475 <varlistentry id="ntfsundelete">
476 <term><command>ntfsundelete</command></term>
477 <listitem>
478 <para>
479 recovers a deleted file from an NTFS volume.
480 </para>
481 <indexterm zone="ntfs-3g ntfsundelete">
482 <primary sortas="b-ntfsundelete">ntfsundelete</primary>
483 </indexterm>
484 </listitem>
485 </varlistentry>
486
487 <varlistentry id="libntfs-3g">
488 <term><filename class="libraryfile">libntfs-3g.so</filename></term>
489 <listitem>
490 <para>
491 contains the Ntfs-3g API functions.
492 </para>
493 <indexterm zone="ntfs-3g libntfs-3g">
494 <primary sortas="c-libntfs-3g">libntfs-3g.so</primary>
495 </indexterm>
496 </listitem>
497 </varlistentry>
498 </variablelist>
499 </sect2>
500</sect1>
Note: See TracBrowser for help on using the repository browser.