Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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 argu-
     ments.

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 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, ntfsusermap  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 sys-
     tem  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  development  team   on   the   ntfs-3g-de-
     vel@lists.sf.net address.

AUTHORS
     ntfs-3g.secaudit has been developed by Jean-Pierre AndrA(C).

THANKS
     Several people made heroic efforts, often over five or more years which re-
     sulted  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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ntfsusermap&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help