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

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt 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 d5cc78a was eef74ab, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags for postlfs, general libraries, and programming

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

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