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

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 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 ec64d28 was 6fcb1b9, checked in by Chris Staub <chris@…>, 12 years ago

Text updates

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