ntfs-3g man page on Peanut

Man page or keyword search:  
man Server   7435 pages
apropos Keyword Search (all sections)
Output format
Peanut logo
[printable version]

NTFS-3G(8)							    NTFS-3G(8)

NAME
       ntfs-3g - Third Generation NTFS Driver

SYNOPSIS
       ntfs-3g device mount_point [-o options]

DESCRIPTION
       ntfs-3g	is  a user space NTFS driver, which can create, remove, rename
       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 com‐
       pressed files.

OPTIONS
       Below is a summary of the options that ntfs-3g accepts.

       uid=, gid=, umask=
	      Provide  default	owner,	group,	and  access  mode mask.	 These
	      options work as documented in mount(8).  By default,  the	 files
	      and directories are owned by the user who mounted the volume but
	      everybody has full read, write and executable  access,  moreover
	      browse permission to any directory.  If you want to use the cur‐
	      rently  limited  permission  handling  then  use	these  options
	      together with the default_permissions, fmask and dmask options.

       fmask=, dmask=
	      Instead  of  specifying  umask  which  applies both to files and
	      directories, fmask applies only to files and mask only to direc‐
	      tories.

       ro     Mount filesystem read-only.

       locale=
	      You can set locale with this option. It's useful if locale envi‐
	      ronment variables are not set before partitions had been mounted
	      from /etc/fstab.

       force  Force mount even if errors occurred. Use this option only if you
	      know what are you doing.

       show_sys_files
	      If show_sys_files is specified, show the system files in	direc‐
	      tory  listings.	Otherwise the default behaviour is to hide the
	      system files.  Note that even when show_sys_files is  specified,
	      "$MFT"  may  will not be visible due to bugs in glibc.  Further‐
	      more, note that irrespectively of show_sys_files, all files  are
	      accessible by name, i.e. you can always do "ls -l '$UpCase'" for
	      example to show the system file containing  the  Unicode	upcase
	      table.

       default_permissions
	      By  default  FUSE	 doesn't  check	 file  access permissions, the
	      filesystem is free to implement it's access policy or  leave  it
	      to the underlying file access mechanism (e.g. in case of network
	      filesystems).   This   option   enables	permission   checking,
	      restricting  access  based on file mode.	This option is usually
	      useful together with the 'allow_other' mount option.

       allow_other
	      This option overrides  the  security  measure  restricting  file
	      access  to  the user mounting the filesystem.  This option is by
	      default only allowed  to	root,  but  this  restriction  can  be
	      removed  with  a	configuration option described in the previous
	      section.

       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 performance.

       max_read=
	      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=
	      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.

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.

EXAMPLES
       Mount /dev/hda1 to /mnt/windows:

	      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

       Umount /mnt/windows:

	      fusermount -u /mnt/windows

KNOWN ISSUES
       Please see the README file for all known issues.	 If you would  find  a
       new  one	 in  the  latest  release of this software then please send an
       email describing it to the development team:
       linux-ntfs-dev@lists.sourceforge.net

AUTHORS
       ntfs-3g is an improved ntfsmount which was originally written  by  Yura
       Pakhuchiy,  with contributions from Yuval Fledel. The improvements were
       made by Szabolcs Szakacsits.

DEDICATION
       With love to Marina Sapego.

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

SEE ALSO
       ntfsprogs(8), attr(5), getfattr(1)

ntfs-3g 20070920-BETA		September 2006			    NTFS-3G(8)
[top]

List of man pages available for Peanut

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net