ntfsusermap(8)

1NTFSUSERMAP(8)              System Manager's Manual             NTFSUSERMAP(8)
2
3
4

NAME

6       ntfsusermap - NTFS Building a User Mapping File
7

SYNOPSIS

9       ntfsusermap windows-system-device [other-ntfs-device...]
10
11       Where windows-system-device is the device containing the Windows system
12       whose users are to be mapped to current Linux system.
13
14       And other-ntfs-device is another device containing files which  are  to
15       be  accessed both by the Windows mentioned above and current Linux sys‐
16       tem.
17
18       the ntfsusermap command must be started as root, and the designated de‐
19       vices must not be mounted.
20
21       Typing ntfsusermap with no args will display a summary of command argu‐
22       ments.
23

DESCRIPTION

25       ntfsusermap creates the file defining the mapping of  Windows  accounts
26       to  Linux  logins for users who owns files which should be visible from
27       both Windows and Linux.
28
29       It relies on existing files which were created on  Windows,  trying  to
30       locate  significant  files  and asking which Linux user or group should
31       own them. When a Linux owner or group is requested, the reply may be :
32
33       - the uid or gid (numeric or symbolic) of Linux owner or group  of  the
34       file.
35              In that situation, no more file with the same Windows owner will
36              be selected.
37       - or no answer, when not able to define the owner or group.
38              In that situation another file owned by the same Windows user or
39              group may be selected later so that a mapping can be defined.
40
41       The  mappings  for  standard  Windows users, such as "Administrator" or
42       "All Users" are defined implicitly. As a  consequence  a  user  mapping
43       should never be defined as Linux root.
44
45       When  there  are no more significant files, ntfsusermap create the map‐
46       ping file into the file UserMapping in the current directory. This file
47       has to be moved to the hidden directory .NTFS-3G in the root of all the
48       NTFS file systems to be shared between Windows and Linux. This requires
49       the  file  system to be mounted, but the created file will not be taken
50       into account if not present at mount time, which means the file  system
51       has  to  be  unmounted and mounted again for the new mapping file to be
52       taken into account.
53

OPTIONS

55       No option is defined for ntfsusermap.
56

EXAMPLES

58       Map the users defined on the Windows system present on /dev/sda1 :
59
60              ntfsusermap /dev/sda1
61
62

EXIT CODES

64       ntfsusermap exits with a value of 0 when no  error  was  detected,  and
65       with a value of 1 when an error was detected.
66

KNOWN ISSUES

68       Please see
69
70              https://github.com/tuxera/ntfs-3g/wiki/NTFS-3G-FAQ/
71
72       for  common questions and known issues.  If you would find a new one in
73       the latest release of the software then please send an email describing
74       it  in  detail. You can contact the development team on the ntfs-3g-de‐
75       vel@lists.sf.net address.
76

AUTHORS

78       ntfs-3g.secaudit has been developed by Jean-Pierre André.
79

THANKS

81       Several people made heroic efforts, often over five or more years which
82       resulted  the  ntfs-3g  driver.  Most  importantly they are Anton Alta‐
83       parmakov, Richard Russon, Szabolcs Szakacsits,  Yura  Pakhuchiy,  Yuval
84       Fledel,  and  the author of the groundbreaking FUSE filesystem develop‐
85       ment framework, Miklos Szeredi.
86