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

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 1647d338 was 1647d338, checked in by DJ Lucas <dj@…>, 7 years ago

Add fuse-3.0.0, fixes #8626. Install only fuse-2.x libs and progs. Use internal fuse for ntfs-3g.

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

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