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

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 77d57d1 was 77d57d1, checked in by Douglas R. Reno <renodr@…>, 5 years ago

Tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17667 af4574ff-66df-0310-9fd7-8a98e5e911e0

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