NTFSUSERMAP(8) System Manager's Manual NTFSUSERMAP(8)
NAME
ntfsusermap - NTFS Building a User Mapping File
SYNOPSIS
ntfsusermap 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 ntfsusermap command must be started as root, and the designated devices must not be
mounted.
Typing ntfsusermap with no args will display a summary of command arguments.
DESCRIPTION
ntfsusermap 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 se-
lected later so that a mapping can be defined.
The mappings for standard Windows users, such as "Administrator" or "All Users" are de-
fined implicitly. As a consequence a user mapping should never be defined as Linux root.
When there are no more significant files, ntfsusermap create the mapping file into the
file UserMapping in the current directory. This file has to be moved to the hidden direc-
tory .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 ntfsusermap.
EXAMPLES
Map the users defined on the Windows system present on /dev/sda1 :
ntfsusermap /dev/sda1
EXIT CODES
ntfsusermap 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
https://github.com/tuxera/ntfs-3g/wiki/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 de-
velopment team on the ntfs-3g-devel AT lists.net address.
AUTHORS
ntfs-3g.secaudit has been developed by Jean-Pierre Andre.
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)
ntfsusermap 1.2.0 February 2016 NTFSUSERMAP(8)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-11-21 18:03 @216.73.216.164 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)