ntfs-3g.usermap(8) [linux man page]

NTFS-3G.USERMAP(8)					      System Manager's Manual						NTFS-3G.USERMAP(8)

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 Andre.

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)

ntfs-3g.usermap 1.1.2						   February 2010						NTFS-3G.USERMAP(8)

NTFS-3G.SECAUDIT(8)					      System Manager's Manual					       NTFS-3G.SECAUDIT(8)

NAME

       ntfs-3g.secaudit - NTFS Security Data Auditing

SYNOPSIS

       ntfs-3g.secaudit [options] args

       Where options is a combination of :
	      -a full auditing of security data (Linux only)
	      -b backup ACLs
	      -e setting extra backed-up parameters (in conjunction with -s)
	      -h displaying hexadecimal security descriptors saved in a file
	      -r recursing in a directory
	      -s setting backed-up ACLs
	      -v verbose (very verbose if set twice)

       and args define the parameters and the set of files acted upon.

       Typing secaudit with no args will display a summary of available options.

DESCRIPTION

       ntfs-3g.secaudit  displays  the ownership and permissions of a set of files on an NTFS file system, and checks their consistency. It can be
       started in terminal mode only (no graphical user interface is available.)

       When a volume is required, it has to be unmounted, and the command has to be issued as root. The volume can be either a block device  (i.e.
       a disk partition) or an image file.

       When  acting  on a directory or volume, the command may produce a lot of information. It is therefore advisable to redirect the output to a
       file or pipe it to a text editor for examination.

OPTIONS

       Below are the valid combinations of options and arguments that ntfs-3g.secaudit accepts. All the indicated arguments are mandatory and must
       be unique (if wildcards are used, they must resolve to a single name.)

       -h file
	      Displays	in  an	human  readable form the hexadecimal security descriptors saved in file. This can be used to turn a verbose output
	      into a very verbose output.

       -a[rv] volume
	      Audits the volume : all the global security data on volume are scanned and errors are displayed. If option -r is present, all  files
	      and directories are also scanned and their relations to global security data are checked. This can produce a lot of data.

	      This option is not effective on volumes formatted for old NTFS versions (pre NTFS 3.0). Such volumes have no global security data.

	      When errors are signalled, it is advisable to repair the volume with an appropriate tool (such as chkdsk on Windows.)

       [-v] volume file
	      Displays	the  security  parameters  of file : its interpreted Linux mode (rwx flags in octal) and Posix ACL[1], its security key if
	      any, and its security descriptor if verbose output.

       -r[v] volume directory
	      displays the security parameters of all files and subdirectories in directory : their interpreted Linux mode (rwx  flags	in  octal)
	      and Posix ACL[1], their security key if any, and their security descriptor if verbose output.

       -b[v] volume [directory]
	      Recursively extracts to standard output the NTFS ACLs of files in volume and directory.

       -s[ev] volume [backup-file]
	      Sets  the  NTFS  ACLS as indicated in backup-file or standard input. The input data must have been created on Linux. With option -e,
	      also sets extra parameters (currently Windows attrib).

       volume perms file
	      Sets the security parameters of file to perms. Perms is the Linux requested mode (rwx flags, expressed in octal form as in chmod) or
	      a Posix ACL[1] (expressed like in setfacl -m). This sets a new ACL which is effective for Linux and Windows.

       -r[v] volume perms directory
	      Sets  the  security  parameters of all files and subdirectories in directory to perms. Perms is the Linux requested mode (rwx flags,
	      expressed in octal form as in chmod), or a Posix ACL[1] (expressed like in setfacl -m.) This sets new ACLs which are  effective  for
	      Linux and Windows.

       [-v] mounted-file
	      Displays	the  security  parameters of mounted-file : its interpreted Linux mode (rwx flags in octal) and Posix ACL[1], its security
	      key if any, and its security descriptor if verbose output. This is a special case which acts on a mounted file  (or  directory)  and
	      does  not  require  being root. The Posix ACL interpretation can only be displayed if the full path to mounted-file from the root of
	      the global file tree is provided.

NOTE

       [1] provided the POSIX ACL option was selected at compile time. A Posix ACL specification looks like "[d:]{ugmo}:[id]:[perms],..." where id
       is a numeric user or group id, and perms an octal digit or a set from the letters r, w and x.
	      Example : "u::7,g::5,o:0,u:510:rwx,g:500:5,d:u:510:7"

EXAMPLES

       Audit the global security data on /dev/sda1

	      ntfs-3g.secaudit -ar /dev/sda1

       Display the ownership and permissions parameters for files in directory /audio/music on device /dev/sda5, excluding sub-directories :

	      ntfs-3g.secaudit /dev/sda5 /audio/music

       Set all files in directory /audio/music on device /dev/sda5 as writeable by owner and read-only for everybody :

	      ntfs-3g.secaudit -r /dev/sda5 644 /audio/music

EXIT CODES

       ntfs-3g.secaudit 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 Andre.

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)

ntfs-3g.secaudit 1.3.8						   February 2010					       NTFS-3G.SECAUDIT(8)