mirror of
https://git.code.sf.net/p/ntfs-3g/ntfs-3g.git
synced 2024-12-03 23:13:39 +08:00
3d7a28bfa5
These tools were originally developed for running on Windows and later ported to libntfs-3g. This patch makes them similar to other ntfsprogs tools, dropping the native Windows interfaces and using libntfs-3g on all platforms. There is no change in usage or supported features, only the command names have changed.
97 lines
3.4 KiB
Groff
97 lines
3.4 KiB
Groff
.\" 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
|
|
A detailed example, with screen displays is available on
|
|
http://jp-andre.pagesperso-orange.fr/ntfsusermap.html
|
|
.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
|
|
http://www.tuxera.com/community/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)
|