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

FreeBSD Manual Pages

  
 
  

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  sys-
       tem.

       the ntfsusermap command must be started as root,	and the	designated de-
       vices 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  map-
       ping 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	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 Andr.

THANKS
       Several people made heroic efforts, often over five or more years which
       resulted	 the  ntfs-3g  driver.	Most  importantly they are Anton Alta-
       parmakov, Richard Russon, Szabolcs Szakacsits,  Yura  Pakhuchiy,	 Yuval
       Fledel,	and  the author	of the groundbreaking FUSE filesystem develop-
       ment 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+14.3.quarterly>

home | help