You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
95 lines
3.3 KiB
95 lines
3.3 KiB
.\" Copyright (c) 2007-2016 Jean-Pierre André.
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
.\"
|
|
.TH NTFSUSERMAP 8 "February 2016" "ntfsusermap 1.2.0"
|
|
.SH NAME
|
|
ntfsusermap \- NTFS Building a User Mapping File
|
|
.SH SYNOPSIS
|
|
.B ntfsusermap
|
|
\fIwindows-system-device\fP
|
|
\fB[\fIother-ntfs-device\fP...\fB]\fR
|
|
.PP
|
|
Where \fIwindows-system-device\fP is the device containing the Windows system
|
|
whose users are to be mapped to current Linux system.
|
|
.PP
|
|
And \fIother-ntfs-device\fP is another device containing files which are
|
|
to be accessed both by the Windows mentioned above and current Linux system.
|
|
.PP
|
|
the ntfsusermap command must be started as root, and the designated devices
|
|
must not be mounted.
|
|
.PP
|
|
Typing ntfsusermap with no args will display a summary of command
|
|
arguments.
|
|
.SH DESCRIPTION
|
|
\fBntfsusermap\fR
|
|
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.
|
|
.PP
|
|
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 :
|
|
.PP
|
|
- the uid or gid (numeric or symbolic) of Linux owner or group of the file.
|
|
.RS
|
|
In that situation, no more file with the same Windows owner will be selected.
|
|
.RE
|
|
- or no answer, when not able to define the owner or group.
|
|
.RS
|
|
In that situation another file owned by the same Windows user or group
|
|
may be selected later so that a mapping can be defined.
|
|
.RE
|
|
.PP
|
|
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.
|
|
.PP
|
|
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 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.
|
|
.SH OPTIONS
|
|
No option is defined for ntfsusermap.
|
|
.SH EXAMPLES
|
|
Map the users defined on the Windows system present on /dev/sda1 :
|
|
.RS
|
|
.sp
|
|
.B ntfsusermap /dev/sda1
|
|
.sp
|
|
.RE
|
|
.PP
|
|
.SH EXIT CODES
|
|
.B ntfsusermap
|
|
exits with a value of 0 when no error was detected, and with a value
|
|
of 1 when an error was detected.
|
|
.SH KNOWN ISSUES
|
|
Please see
|
|
.RS
|
|
.sp
|
|
https://github.com/tuxera/ntfs-3g/wiki/NTFS-3G-FAQ/
|
|
.sp
|
|
.RE
|
|
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.
|
|
.SH AUTHORS
|
|
.B ntfs-3g.secaudit
|
|
has been developed by Jean-Pierre André.
|
|
.SH 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.
|
|
.SH SEE ALSO
|
|
.BR ntfsprogs (8),
|
|
.BR attr (5),
|
|
.BR getfattr (1)
|