Man Linux: Main Page and Category List

NAME

       ntfs-3g.usermap - NTFS Building a User Mapping File

SYNOPSIS

       ntfs-3g.usermap windows-system-device [other-ntfs-device...]

       Where windows-system-device is the device containing the Windows system
       whose users are to be mapped to current Linux system.

       And other-ntfs-device is another device containing files which  are  to
       be  accessed  both  by  the  Windows  mentioned above and current Linux
       system.

       the ntfs-3g.usermap command must be started as root, and the designated
       devices must not be mounted.

       Typing  ntfs-3g.usermap  with no args will display a summary of command
       arguments.

DESCRIPTION

       ntfs-3g.usermap creates  the  file  defining  the  mapping  of  Windows
       accounts  to  Linux  logins  for  users  who owns files which should be
       visible from both Windows and Linux.

       It relies on existing files which were created on  Windows,  trying  to
       locate  significant  files  and asking which Linux user or group should
       own them. When a Linux owner or group is requested, the reply may be :

       - the uid or gid (numeric or symbolic) of Linux owner or group  of  the
       file.
              In that situation, no more file with the same Windows owner will
              be selected.
       - or no answer, when not able to define the owner or group.
              In that situation another file owned by the same Windows user or
              group may be selected later so that a mapping can be defined.

       The  mappings  for  standard  Windows users, such as "Administrator" or
       "All Users" are defined implicitly. As a  consequence  a  user  mapping
       should never be defined as Linux root.

       When  there  are  no more significant files, ntfs-3g.usermap create the
       mapping file into the file UserMapping in the current  directory.  This
       file  has  to  be moved to the hidden directory .NTFS-3G in the root of
       all the NTFS file systems to be shared between Windows and Linux.  This
       requires  the  file system to be mounted, but the created file will not
       be taken into account if not present at mount  time,  which  means  the
       file  system  has to be unmounted and mounted again for the new mapping
       file to be taken into account.

OPTIONS

       No option is defined for ntfs-3g.usermap.

EXAMPLES

       Map the users defined on the Windows system present on /dev/sda1 :

              ntfs-3g.usermap /dev/sda1

       A  detailed   example,   with   screen   displays   is   available   on
       http://pagesperso-orange.fr/b.andre/usermap.html

EXIT CODES

       ntfs-3g.usermap exits with a value of 0 when no error was detected, and
       with a value of 1 when an error was detected.

KNOWN ISSUES

       Please see

              http://www.tuxera.com/community/ntfs-3g-faq/

       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.secaudit has been developed by Jean-Pierre André.

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)