Provided by: ntfsprogs_2.0.0-1ubuntu2_i386 bug

NAME

       ntfsmount - Read/Write userspace NTFS driver.

SYNOPSIS

       ntfsmount device mount_point [-o options]
       mount -t fuse.ntfs device mount_point [-o options]

       /etc/ftsab entry:
       device mount_point fuse.ntfs options 0 0

DESCRIPTION

       ntfsmount is a read/write userspace NTFS filesystem driver. Technically
       it connects FUSE with libntfs.

       ntfsmount features:
              · Create/Delete/Move files and directories.
              · Hard link files.
              · Read and write to normal and sparse files.
              · Read compressed and encrypted files.
              · Access to special Interix files (symlinks, devices, FIFOs).
              · List/Read/Write/Add/Remove named data streams.
              · Supports Linux, FreeBSD, NetBSD and Mac OS X.

OPTIONS

       ntfsmount supports most of options that mount  and  FUSE  accepts  (see
       "man  8 mount" and FUSE documentation for them). Additionally ntfsmount
       have some unique to it options, below is a summary of them.

       silent, nosilent
              silent option makes ntfsmount to do not return "Operation is not
              supported"  error  on chmod and chown operations (this option is
              on by default).  nosilent cancels this.

       locale=value
              You can set locale with  this  option.  It’s  useful  if  locale
              environment   variables  are  not  set  before  partitions  from
              /etc/fstab had been mounted. Try submitting this option  if  you
              are  experience  problems with displaying national characters in
              filenames.

       uid=value, 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, dmask=value, fmask=value
              Set the bitmask of the file and directory permissions  that  are
              not present.  The value is given in octal. Instead of specifying
              umask which applies both to files and directories, fmask applies
              only to files and dmask only to directories.

       case_insensitive
              Make   ntfsmount   treat   filenames  in  POSIX  names  as  case
              insensitive.  See FILENAME NAMESPACES section for details.

       no_def_opts
              By default ntfsmount acts as some useful options were passed  to
              it  (you  can  get  list  of  this  options by running ntfsmount
              without any arguments). Submitting this option will cancel  such
              behaviour.

       noblkdev
              By  default  ntfsmount  tries to mount block devices with blkdev
              FUSE option if it have enough privileges. Submit this option  if
              blkdev mount does not work for you for some reasons.

       force  Force mount even if errors occurred. Use this option only if you
              know what are you doing and don’t cry about data loss.

       relatime, norelatime
              Update inode access times relative to  modify  or  change  time.
              Access  time  is  only  updated  if the previous access time was
              earlier than the current modify  or  change  time.  (Similar  to
              noatime,  but doesn’t break mutt or other applications that need
              to know if a file has been read  since  the  last  time  it  was
              modified.)

       streams_interface=value
              This option controls how the user can access named data streams.
              It can be set to, one  of  none,  windows  or  xattr.  See  DATA
              STREAMS section for details.

       debug  Makes  ntfsmount  to not detach from terminal and print a lot of
              debug output from libntfs and FUSE.

       no_detach
              Same as above but with less debug output.

FILENAME NAMESPACES

       There are exist several namespaces for filenames in  NTFS:  DOS,  Win32
       and POSIX.  Names in DOS and Win32 namespaces are case insensitive, but
       names in POSIX namespace are case sensitive. By default windows creates
       filenames  in DOS and Win32 namespaces (with exception for hard links),
       but ntfsmount always creates files in POSIX namespace.  Note:  you  can
       create  several  files  that differs only in case in one directory with
       ntfsmount, but windows applications may be confused by this.

DATA STREAMS

       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.   Windows  applications
       don’t,  consistently,  allow you to read named data streams, so you are
       recommended to use tools like FAR, or utilities from Cygwin.

       By default or if "streams_interface=none" option was passed,  ntfsmount
       will only read the unnamed data stream.

       By  using  the  option "streams_interface=windows", you will be able to
       read any named data streams, simply by  specifying  the  stream’s  name
       after  a  colon.  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. Some examples:

              cat some.mp3:artist
              rm some.mp3:album
              echo Sympho Black Metal > some.mp3:genre
              getfattr -n ntfs.streams.list some.mp3

       If streams_interface option is  set  to  xattr,  then  the  named  data
       streams  are  mapped  to  xattrs  and  user  can  manipulate them using
       getfattr and setfattr utilities. Eg.:

              setfattr -n user.artist -v "Some Artist" some.mp3
              getfattr -d some.mp3

ALLOWED CHARACTERS

       Win32 does not allow characters like ’<’, ’>’, ’*’, ’?’ and  so  on  in
       the  filenames, but NTFS supports any characters except ’\0’ (NULL) and
       ’/’.  You can create filenames with  any  allowed  by  NTFS  characters
       using  ntfsmount,  but aware, you will not be able to access files with
       denied by Win32 characters from windows.

ACCESS HANDLING AND SECURITY

       By default, files and directories are owned by the 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 ntfsmount.

EXAMPLES

       Mount /dev/hda1 to /mnt/ntfs using ntfsmount submiting locale option:

              ntfsmount /dev/hda1 /mnt/ntfs -o locale=be_BY.UTF-8

       /etc/fstab entry for above:

              /dev/hda1 /mnt/ntfs fuse.ntfs locale=be_BY.UTF-8 0 0

       Umount /mnt/ntfs:

              fusermount -u /mnt/ntfs

BUGS

       If you find a bug please send an email describing the  problem  to  the
       development team:
       linux-ntfs-dev@lists.sourceforge.net

AUTHORS

       ntfsmount  was written by Yura Pakhuchiy, with contributions from Yuval
       Fledel and Szabolcs Szakacsits.

DEDICATION

       With love to Marina Sapego.

THANKS

       Many thanks to Miklos Szeredi for advice and answers about FUSE.

AVAILABILITY

       ntfsmount is part of the ntfsprogs package and is available from:
       http://www.linux-ntfs.org/content/view/19/37

       The manual pages are available online at:
       http://man.linux-ntfs.org/

       Additional up-to-date information can be found furthermore at:
       http://wiki.linux-ntfs.org/doku.php?id=ntfsmount

SEE ALSO

       Read libntfs(8) for details how to access encrypted files.

       libntfs(8), ntfsprogs(8), attr(5), getfattr(1)