224 lines
7.4 KiB
Groff
224 lines
7.4 KiB
Groff
.\" Copyright (c) 2005-2006 Yura Pakhuchiy.
|
|
.\" Copyright (c) 2005 Richard Russon.
|
|
.\" Copyright (c) 2006-2007 Szabolcs Szakacsits.
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
.\"
|
|
.TH NTFS-3G 8 "August 2007" "ntfs-3g @VERSION@"
|
|
.SH NAME
|
|
ntfs-3g \- Third Generation Read/Write NTFS Driver
|
|
.SH SYNOPSIS
|
|
.B ntfs-3g
|
|
.I device mount_point
|
|
\fB[-o \fIoption\fP\fB[,...]]\fR
|
|
.br
|
|
.B mount \-t ntfs-3g
|
|
.I device mount_point
|
|
\fB[-o \fIoption\fP\fB[,...]]\fR
|
|
.SH DESCRIPTION
|
|
\fBntfs-3g\fR is an NTFS driver, which can
|
|
create, remove, rename, move files, directories, hard links, and
|
|
streams; it can read and write files, including
|
|
streams and sparse files; it can handle special files like
|
|
symbolic links, devices, and FIFOs; moreover it can also read
|
|
transparently compressed files.
|
|
.SS Access Handling and Security
|
|
By default, files and directories are owned by the effective
|
|
user and group of the mounting process and everybody has
|
|
full read, write, execution and directory browsing permissions.
|
|
If you want to use permissions handling then use the
|
|
.B uid
|
|
and/or the
|
|
.B gid
|
|
options together with the
|
|
.B umask,
|
|
or
|
|
.B fmask
|
|
and
|
|
.B dmask
|
|
options.
|
|
.PP
|
|
Windows users have full access to the files created by
|
|
.B ntfs-3g.
|
|
.PP
|
|
If
|
|
.B ntfs-3g
|
|
is set setuid-root then non-root users will
|
|
be also able to mount block devices or via /etc/fstab if the 'user'
|
|
or 'users'
|
|
.BR mount (8)
|
|
option is specified. The
|
|
.B ntfs-3g
|
|
process drops the
|
|
root privilege after successful mount and runs unprivileged
|
|
afterwards.
|
|
.SS Windows Filename Compatibility
|
|
NTFS supports several filename namespaces: DOS, Win32 and POSIX. While the
|
|
\fBntfs-3g\fR driver handles all of them, it always creates new files in the
|
|
POSIX namespace for maximum portability and interoperability reasons.
|
|
This means that filenames are case sensitive and all characters are
|
|
allowed except '/' and '\\0'. This is perfectly legal on Windows, though
|
|
some application may get confused. If you find so then please report it
|
|
to the developer of the relevant Windows software.
|
|
.SS Alternate Data Streams (ADS)
|
|
NTFS stores all data in streams. Every file has exactly one unnamed
|
|
data stream and can have many named data streams. The size of a file is the
|
|
size of its unnamed data stream. By default, \fBntfs-3g\fR will only read
|
|
the unnamed data stream.
|
|
.PP
|
|
By using the options "streams_interface=windows", you will be able to read
|
|
any named data streams, simply by specifying the stream's name after a colon.
|
|
For example:
|
|
.RS
|
|
.sp
|
|
cat some.mp3:artist
|
|
.sp
|
|
.RE
|
|
Named data streams act like normals files, so you can read from them, write to
|
|
them and even delete them (using rm). You can list all the named data streams
|
|
a file has by getting the "ntfs.streams.list" extended attribute.
|
|
.SH OPTIONS
|
|
Below is a summary of the options that \fBntfs-3g\fR accepts.
|
|
.TP
|
|
\fBuid=\fP\fIvalue\fP and \fBgid=\fP\fIvalue\fP
|
|
Set the owner and the group of files and directories. The values are numerical.
|
|
The defaults are the uid and gid of the current process.
|
|
.TP
|
|
.BI umask= value
|
|
Set the bitmask of the file and directory permissions that are not
|
|
present. The value is given in octal. The default value is 0 which
|
|
means full access to everybody.
|
|
.TP
|
|
.BI fmask= value
|
|
Set the bitmask of the file permissions that are not present.
|
|
The value is given in octal. The default value is 0 which
|
|
means full access to everybody.
|
|
.TP
|
|
.BI dmask= value
|
|
Set the bitmask of the directory permissions that are not
|
|
present. The value is given in octal. The default value is 0 which
|
|
means full access to everybody.
|
|
.TP
|
|
.B ro
|
|
Mount filesystem read\-only.
|
|
.TP
|
|
.BI locale= value
|
|
This option can be useful if your language specific locale environment
|
|
variables are not set correctly or at all in your operating system.
|
|
In such cases, the national characters can be made visible by using this
|
|
option. Please see more information about this topic at
|
|
http://ntfs-3g.org/support.html#locale
|
|
.TP
|
|
.B force
|
|
Force mount even if the volume is scheduled for consistency check or
|
|
the logfile is unclean. The logfile will be unconditionally cleared
|
|
in the latter case. Use this option with caution and for your own
|
|
responsibility.
|
|
.TP
|
|
.B show_sys_files
|
|
Show the system files in directory listings.
|
|
Otherwise the default behaviour is to hide the system files.
|
|
Please note that even when this option is specified, "$MFT"
|
|
may not be visible due to a glibc bug.
|
|
Furthermore, irrespectively of show_sys_files, all
|
|
files are accessible by name, for example you can always do
|
|
"ls \-l '$UpCase'".
|
|
.TP
|
|
.B allow_other
|
|
This option overrides the security measure restricting file access
|
|
to the user mounting the filesystem. This option is only
|
|
allowed to root, but this restriction can be overridden by
|
|
the 'user_allow_other' option in the /etc/fuse.conf file.
|
|
.TP
|
|
.BI max_read= value
|
|
With this option the maximum size of read operations can be set.
|
|
The default is infinite. Note that the size of read requests is
|
|
limited anyway to 32 pages (which is 128kbyte on i386).
|
|
.TP
|
|
.B silent
|
|
Do nothing on chmod and chown operations, but do not return error.
|
|
This option is on by default.
|
|
.TP
|
|
.B no_def_opts
|
|
By default ntfs-3g acts as "silent,allow_other" was passed to it,
|
|
this option cancel this behaviour.
|
|
.TP
|
|
.BI streams_interface= value
|
|
This option controls how the user can access Alternate Data Streams (ADS)
|
|
or in other words, named data streams. It can be set
|
|
to, one of \fBnone\fR, \fBwindows\fR or \fBxattr\fR. If the option is set to
|
|
\fBnone\fR, the user will have no access to the named data streams. If it's set
|
|
to \fBwindows\fR, then the user can access them just like in Windows (eg. cat
|
|
file:stream). If it's set to \fBxattr\fR, then the named data streams are
|
|
mapped to xattrs and user can manipulate them using \fB{get,set}fattr\fR
|
|
utilities. The default is \fBnone\fR.
|
|
.TP
|
|
.B debug
|
|
Makes ntfs-3g to not detach from terminal and print a lot of debug output from
|
|
libntfs-3g and FUSE.
|
|
.TP
|
|
.B no_detach
|
|
Same as above but with less debug output.
|
|
.SH EXAMPLES
|
|
Mount /dev/hda1 to /mnt/windows:
|
|
.RS
|
|
.sp
|
|
.B ntfs-3g /dev/hda1 /mnt/windows
|
|
.sp
|
|
.RE
|
|
or
|
|
.RS
|
|
.sp
|
|
.B mount -t ntfs-3g /dev/hda1 /mnt/windows
|
|
.sp
|
|
.RE
|
|
Read\-only mount /dev/hda5 to /home/user/mnt and make user with uid 1000
|
|
to be the owner of all files:
|
|
.RS
|
|
.sp
|
|
.B ntfs-3g /dev/hda5 /home/user/mnt \-o ro,uid=1000
|
|
.sp
|
|
.RE
|
|
/etc/fstab entry for the above:
|
|
.RS
|
|
.sp
|
|
.B /dev/hda5 /home/user/mnt ntfs\-3g ro,uid=1000 0 0
|
|
.sp
|
|
.RE
|
|
Unmount /mnt/windows:
|
|
.RS
|
|
.sp
|
|
.B umount /mnt/windows
|
|
.sp
|
|
.RE
|
|
.SH KNOWN ISSUES
|
|
Please see
|
|
.RS
|
|
.sp
|
|
http://ntfs-3g.org/support.html
|
|
.sp
|
|
.RE
|
|
for common questions and known issues.
|
|
If you would find a new one in the latest release of
|
|
the software then please send an email describing it
|
|
in detail. You can contact the
|
|
development team on the ntfs\-3g\-devel@lists.sf.net
|
|
address.
|
|
.SH AUTHORS
|
|
.B ntfs-3g
|
|
was based on and a major improvement to ntfsmount and libntfs which were
|
|
written by Yura Pakhuchiy and the Linux-NTFS team. The improvements were
|
|
made, the ntfs-3g project was initiated and currently led by long time
|
|
Linux-NTFS team developer Szabolcs Szakacsits (szaka@sienet.hu) to revive
|
|
the stalled open source development and project management.
|
|
|
|
.SH THANKS
|
|
Several people made heroic efforts, often over five or more
|
|
years which resulted the ntfs-3g driver. Most importantly they are
|
|
Anton Altaparmakov, Richard Russon, Szabolcs Szakacsits, Yura Pakhuchiy,
|
|
Yuval Fledel, and the author of the groundbreaking FUSE filesystem development
|
|
framework, Miklos Szeredi.
|
|
.SH SEE ALSO
|
|
.BR ntfsprogs (8),
|
|
.BR attr (5),
|
|
.BR getfattr (1)
|