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

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 f71807c2 was f71807c2, checked in by DJ Lucas <dj@…>, 7 years ago

Update to ntfs-3g-2017.3.23. Fixes #9057.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18553 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">Recommended</bridgehead>
82 <para role="recommended">
83 <xref linkend="fuse"/>
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=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 /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=external</parameter>: This switch dynamically
157 links <command>lowntfs-3g</command> and <command>ntfs-3g</command> to
158 external libfuse. Omit it if you have not installed <xref
159 linkend="fuse"/> or if you want to use internal statically compiled
160 libfuse.
161 </para>
162
163 <para>
164 <option>--disable-ntfsprogs</option>: Disables installation of various
165 utilities used to manipulate NTFS partitions.
166 </para>
167
168 <para>
169 <command>ln -sv ../bin/ntfs-3g /sbin/mount.ntfs</command>: Creating
170 /sbin/mount.ntfs makes <command>mount</command> default to using Ntfs-3g
171 to mount NTFS partitions.
172 </para>
173
174 <para>
175 <command>chmod -v 4755 /bin/ntfs-3g</command>: Making mount.ntfs setuid
176 root allows non root users to mount NTFS partitions.
177 </para>
178
179 </sect2>
180
181 <sect2 role="configuration">
182 <title>Using Ntfs-3g</title>
183
184 <para>
185 To mount a Windows partition at boot time, put a line like this in
186 /etc/fstab:
187 </para>
188
189 <screen>/dev/sda1 /mnt/windows auto defaults 0 0</screen>
190
191 <para>
192 To allow users to mount a usb stick with an NTFS filesystem on it, put a
193 line similar to this (change sdc1 to whatever a usb stick would be on your
194 system) in /etc/fstab:
195 </para>
196
197 <screen>/dev/sdc1 /mnt/usb auto user,noauto,umask=0,utf8 0 0</screen>
198
199 <para>
200 In order for a user to be able to mount the usb stick, they will need
201 to be able to write to <filename class="directory">/mnt/usb</filename>,
202 so as the <systemitem class="username">root</systemitem> user:
203 </para>
204
205<screen role="root"><userinput>chmod -v 777 /mnt/usb</userinput></screen>
206
207 </sect2>
208
209 <sect2 role="content">
210 <title>Contents</title>
211
212 <segmentedlist>
213 <segtitle>Installed Programs</segtitle>
214 <segtitle>Installed Library</segtitle>
215 <segtitle>Installed Directories</segtitle>
216
217 <seglistitem>
218 <seg>
219 lowntfs-3g, mkfs.ntfs, mkntfs, mount.lowntfs-3g,
220 mount.ntfs, mount.ntfs-3g, ntfs-3g, ntfs-3g.probe,
221 ntfs-3g.secaudit, ntfs-3g.usermap, ntfscat,
222 ntfsclone, ntfscluster, ntfscmp, ntfscp, ntfsfix,
223 ntfsinfo, ntfslabel, ntfsls, ntfsresize and
224 ntfsundelete
225 </seg>
226 <seg>
227 libntfs-3g.so
228 </seg>
229 <seg>
230 /usr/include/ntfs-3g and
231 /usr/share/doc/ntfs-3g
232 </seg>
233 </seglistitem>
234 </segmentedlist>
235
236 <variablelist>
237 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
238 <?dbfo list-presentation="list"?>
239 <?dbhtml list-presentation="table"?>
240
241 <varlistentry id="lowntfs-3g">
242 <term><command>lowntfs-3g</command></term>
243 <listitem>
244 <para>
245 is similar to ntfs-3g but uses the Fuse low-level interface.
246 </para>
247 <indexterm zone="ntfs-3g lowntfs-3g">
248 <primary sortas="b-lowntfs-3g">lowntfs-3g</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="mkfs.ntfs">
254 <term><command>mkfs.ntfs</command></term>
255 <listitem>
256 <para>
257 is a symlink to mkntfs.
258 </para>
259 <indexterm zone="ntfs-3g mkfs.ntfs">
260 <primary sortas="b-mkfs.ntfs">mkfs.ntfs</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="mkntfs">
266 <term><command>mkntfs</command></term>
267 <listitem>
268 <para>
269 creates an NTFS file system.
270 </para>
271 <indexterm zone="ntfs-3g mkntfs">
272 <primary sortas="b-mkntfs">mkntfs</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 <varlistentry id="mount.lowntfs-3g">
278 <term><command>mount.lowntfs-3g</command></term>
279 <listitem>
280 <para>
281 is a symlink to lowntfs-3g.
282 </para>
283 <indexterm zone="ntfs-3g mount.lowntfs-3g">
284 <primary sortas="b-mount.lowntfs-3g">mount.lowntfs-3g</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="mount.ntfs">
290 <term><command>mount.ntfs</command></term>
291 <listitem>
292 <para>
293 mounts an NTFS filesystem.
294 </para>
295 <indexterm zone="ntfs-3g mount.ntfs">
296 <primary sortas="b-mount.ntfs">mount.ntfs</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="mount.ntfs-3g">
302 <term><command>mount.ntfs-3g</command></term>
303 <listitem>
304 <para>
305 is a symbolic link to ntfs-3g.
306 </para>
307 <indexterm zone="ntfs-3g mount.ntfs-3g">
308 <primary sortas="b-mount.ntfs-3g">mount.ntfs-3g</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="ntfs-3g-prog">
314 <term><command>ntfs-3g</command></term>
315 <listitem>
316 <para>
317 is an NTFS driver, which can create, remove, rename, move
318 files, directories, hard links, and streams. It can also read and write
319 files, including streams, sparse files and transparently compressed
320 files. It can also handle special files like symbolic links, devices, and
321 FIFOs; moreover it provides standard management of file ownership
322 and permissions, including POSIX ACLs.
323 </para>
324 <indexterm zone="ntfs-3g ntfs-3g-prog">
325 <primary sortas="b-ntfs-3g">ntfs-3g</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 <varlistentry id="ntfs-3g.probe">
331 <term><command>ntfs-3g.probe</command></term>
332 <listitem>
333 <para>
334 tests if an NTFS volume is mountable read only or read-write, and
335 exits with a status value accordingly. The volume can be a block
336 device or image file.
337 </para>
338 <indexterm zone="ntfs-3g ntfs-3g.probe">
339 <primary sortas="b-ntfs-3g.probe">ntfs-3g.probe</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343
344 <varlistentry id="ntfs-3g.secaudit">
345 <term><command>ntfs-3g.secaudit</command></term>
346 <listitem>
347 <para>
348 audits NTFS Security Data.
349 </para>
350 <indexterm zone="ntfs-3g ntfs-3g.secaudit">
351 <primary sortas="b-ntfs-3g.secaudit">ntfs-3g.secaudit</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="ntfs-3g.usermap">
357 <term><command>ntfs-3g.usermap</command></term>
358 <listitem>
359 <para>
360 creates the file defining the mapping of Windows accounts to Linux
361 logins for users who owns files which should be visible from both
362 Windows and Linux.
363 </para>
364 <indexterm zone="ntfs-3g ntfs-3g.usermap">
365 <primary sortas="b-ntfs-3g.usermap">ntfs-3g.usermap</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369
370 <varlistentry id="ntfscluster">
371 <term><command>ntfscluster</command></term>
372 <listitem>
373 <para>
374 identifies files in a specified region of an NTFS volume
375 </para>
376 <indexterm zone="ntfs-3g ntfscluster">
377 <primary sortas="b-ntfscluster">ntfscluster</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="ntfscp">
383 <term><command>ntfscp</command></term>
384 <listitem>
385 <para>
386 copies a file to an NTFS volume.
387 </para>
388 <indexterm zone="ntfs-3g ntfscp">
389 <primary sortas="b-ntfscp">ntfscp</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="ntfsfix">
395 <term><command>ntfsfix</command></term>
396 <listitem>
397 <para>
398 fixes common errors and forces Windows to check an NTFS partition.
399 </para>
400 <indexterm zone="ntfs-3g ntfsfix">
401 <primary sortas="b-ntfsfix">ntfsfix</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="ntfsls">
407 <term><command>ntfsls</command></term>
408 <listitem>
409 <para>
410 lists directory contents on an NTFS filesystem.
411 </para>
412 <indexterm zone="ntfs-3g ntfsls">
413 <primary sortas="b-ntfsls">ntfsls</primary>
414 </indexterm>
415 </listitem>
416 </varlistentry>
417
418 <varlistentry id="ntfscat">
419 <term><command>ntfscat</command></term>
420 <listitem>
421 <para>
422 prints NTFS files and streams on the standard output.
423 </para>
424 <indexterm zone="ntfs-3g ntfscat">
425 <primary sortas="b-ntfscat">ntfscat</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry id="ntfsclone">
431 <term><command>ntfsclone</command></term>
432 <listitem>
433 <para>
434 clones an NTFS filesystem.
435 </para>
436 <indexterm zone="ntfs-3g ntfsclone">
437 <primary sortas="b-ntfsclone">ntfsclone</primary>
438 </indexterm>
439 </listitem>
440 </varlistentry>
441
442 <varlistentry id="ntfscmp">
443 <term><command>ntfscmp</command></term>
444 <listitem>
445 <para>
446 compares two NTFS filesystems and tells the differences.
447 </para>
448 <indexterm zone="ntfs-3g ntfscmp">
449 <primary sortas="b-ntfscmp">ntfscmp</primary>
450 </indexterm>
451 </listitem>
452 </varlistentry>
453
454 <varlistentry id="ntfsinfo">
455 <term><command>ntfsinfo</command></term>
456 <listitem>
457 <para>
458 dumps a file's attributes.
459 </para>
460 <indexterm zone="ntfs-3g ntfsinfo">
461 <primary sortas="b-ntfsinfo">ntfsinfo</primary>
462 </indexterm>
463 </listitem>
464 </varlistentry>
465
466 <varlistentry id="ntfslabel">
467 <term><command>ntfslabel</command></term>
468 <listitem>
469 <para>
470 displays or changes the label on an ntfs file system.
471 </para>
472 <indexterm zone="ntfs-3g ntfslabel">
473 <primary sortas="b-ntfslabel">ntfslabel</primary>
474 </indexterm>
475 </listitem>
476 </varlistentry>
477
478 <varlistentry id="ntfsresize">
479 <term><command>ntfsresize</command></term>
480 <listitem>
481 <para>
482 resizes an NTFS filesystem without data loss.
483 </para>
484 <indexterm zone="ntfs-3g ntfsresize">
485 <primary sortas="b-ntfsresize">ntfsresize</primary>
486 </indexterm>
487 </listitem>
488 </varlistentry>
489
490 <varlistentry id="ntfsundelete">
491 <term><command>ntfsundelete</command></term>
492 <listitem>
493 <para>
494 recovers a deleted file from an NTFS volume.
495 </para>
496 <indexterm zone="ntfs-3g ntfsundelete">
497 <primary sortas="b-ntfsundelete">ntfsundelete</primary>
498 </indexterm>
499 </listitem>
500 </varlistentry>
501
502 <varlistentry id="libntfs-3g">
503 <term><filename class="libraryfile">libntfs-3g.so</filename></term>
504 <listitem>
505 <para>
506 contains the Ntfs-3g API functions.
507 </para>
508 <indexterm zone="ntfs-3g libntfs-3g">
509 <primary sortas="c-libntfs-3g">libntfs-3g.so</primary>
510 </indexterm>
511 </listitem>
512 </varlistentry>
513 </variablelist>
514 </sect2>
515</sect1>
Note: See TracBrowser for help on using the repository browser.