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

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 6cce201 was 6d5683f, checked in by Krejzi <krejzi@…>, 12 years ago

Mark some more packages as LFS 7.2 checked. Fix Xchat build with recent toolchain and remove dependency on libsexy in favor of internal spell checking library.

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