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)