This is a direct copy/paste of the output from "man mount.ntfs-3g" in a root terminal.
The material is an appendix to: HowTo Mount your NTFS Filesystem/Partition for Read/Write Access in openSUSE 10.2
NTFS-3G(8)
NTFS-3G(8)
NAME
ntfs-3g - Third Generation Read/Write NTFS Driver
SYNOPSIS
ntfs-3g device mount_point [-o options]
mount -t ntfs-3g device mount_point [-o options]
DESCRIPTION
ntfs-3g 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 compressed files.
Access handling, 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 uid and/or the gid
options together with the umask, or fmask and dmask options.
Windows users have full access to the files created by ntfs-3g.
If 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' mount(8) option is
specified. The ntfs-3g process drops the root privilege after
successful mount and runs unprivileged
afterwards.
Alternate Data Streams (ADS)
All data on
NTFS is stored 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, ntfs-3g will only read the
unnamed data stream.
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:
cat some.mp3:artist
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.
OPTIONS
Below is a summary of the options that ntfs-3g accepts.
uid=value and gid=value
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.
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.
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.
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.
ro Mount filesystem read-only.
locale=value
You can set locale with this option which is often required to make
visible files with national charaters. It's useful if
the locale environment variables are not set before partitions had been
mounted from /etc/fstab.
force Force mount even
if the volume is scheduled for consistency check. Use this option
with caution and preferably with the
ro option.
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'".
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.
large_read
Issue large read requests. This can improve performance for some
filesystems, but can also degrade performance.
This
option is mostly useful on 2.4.X kernels, as on 2.6 kernels requests
size is automatically determined for optimum perfor‐
mance.
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).
silent Do nothing on chmod and
chown operations, but do not return error. This option is on by
default.
no_def_opts
By default ntfs-3g acts as "silent,allow_other" was passed to it, this
option cancel this behaviour.
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 none, windows or xattr. If the option is set to none,
the user will have no access to the named data
streams. If it's set to windows, then the user can
access them just like in Windows (eg. cat file:stream). If it's set
to xattr, then the named data streams are mapped to xattrs and user can
manipulate them using {get,set}fattr utilities.
The default is none.
debug Makes ntfs-3g to not
detach from terminal and print a lot of debug output from libntfs-3g
and FUSE.
no_detach
Same as above but with less debug output.
EXAMPLES
Mount /dev/hda1 to /mnt/windows:
ntfs-3g /dev/hda1 /mnt/windows
or
mount -t ntfs-3g /dev/hda1 /mnt/windows
Read-only mount /dev/hda5 to
/home/user/mnt and make user with uid 1000 to be the owner of all files:
ntfs-3g /dev/hda5 /home/user/mnt -o ro,uid=1000
/etc/fstab entry for the above:
/dev/hda5 /home/user/mnt ntfs-3g ro,uid=1000 0 0
Unmount /mnt/windows:
umount /mnt/windows
You can also unmount /mnt/windows with fusermount:
fusermount -u /mnt/windows
KNOWN ISSUES
Please see
http://www.ntfs-3g.org/support.html
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.
AUTHORS
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.
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.
SEE ALSO
ntfsprogs(8), attr(5), getfattr(1)
ntfs-3g
1.328
March
2007
NTFS-3G(8)
Manual page mount.ntfs-3g(8) line 95/153 (END)