164 lines
4.9 KiB
HTML
164 lines
4.9 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of NTFSUSERMAP</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>NTFSUSERMAP</H1>
|
|
Section: Maintenance Commands (8)<BR>Updated: February 2016<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
ntfsusermap - NTFS Building a User Mapping File
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>ntfsusermap</B>
|
|
|
|
<I>windows-system-device</I>
|
|
<B>[</B><I>other-ntfs-device</I>...<B>]</B>
|
|
<P>
|
|
|
|
Where <I>windows-system-device</I> is the device containing the Windows system
|
|
whose users are to be mapped to current Linux system.
|
|
<P>
|
|
|
|
And <I>other-ntfs-device</I> is another device containing files which are
|
|
to be accessed both by the Windows mentioned above and current Linux system.
|
|
<P>
|
|
|
|
the ntfsusermap command must be started as root, and the designated devices
|
|
must not be mounted.
|
|
<P>
|
|
|
|
Typing ntfsusermap with no args will display a summary of command
|
|
arguments.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>ntfsusermap</B>
|
|
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.
|
|
<P>
|
|
|
|
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 :
|
|
<P>
|
|
|
|
- the uid or gid (numeric or symbolic) of Linux owner or group of the file.
|
|
<DL COMPACT><DT id="1"><DD>
|
|
In that situation, no more file with the same Windows owner will be selected.
|
|
</DL>
|
|
|
|
- or no answer, when not able to define the owner or group.
|
|
<DL COMPACT><DT id="2"><DD>
|
|
In that situation another file owned by the same Windows user or group
|
|
may be selected later so that a mapping can be defined.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
No option is defined for ntfsusermap.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
Map the users defined on the Windows system present on /dev/sda1 :
|
|
<DL COMPACT><DT id="3"><DD>
|
|
<P>
|
|
<B>ntfsusermap /dev/sda1</B>
|
|
|
|
<P>
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
A detailed example, with screen displays is available on
|
|
<A HREF="http://jp-andre.pagesperso-orange.fr/ntfsusermap.html">http://jp-andre.pagesperso-orange.fr/ntfsusermap.html</A>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>EXIT CODES</H2>
|
|
|
|
<B>ntfsusermap</B>
|
|
|
|
exits with a value of 0 when no error was detected, and with a value
|
|
of 1 when an error was detected.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>KNOWN ISSUES</H2>
|
|
|
|
Please see
|
|
<DL COMPACT><DT id="4"><DD>
|
|
<P>
|
|
<A HREF="http://www.tuxera.com/community/ntfs-3g-faq/">http://www.tuxera.com/community/ntfs-3g-faq/</A>
|
|
<P>
|
|
</DL>
|
|
|
|
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 <A HREF="mailto:ntfs-3g-devel@lists.sf.net">ntfs-3g-devel@lists.sf.net</A>
|
|
address.
|
|
<A NAME="lbAI"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
<B>ntfs-3g.secaudit</B>
|
|
|
|
has been developed by Jean-Pierre André.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>THANKS</H2>
|
|
|
|
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.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+ntfsprogs">ntfsprogs</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+attr">attr</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+getfattr">getfattr</A></B>(1)
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="5"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="6"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="7"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="8"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="9"><A HREF="#lbAF">EXAMPLES</A><DD>
|
|
<DT id="10"><A HREF="#lbAG">EXIT CODES</A><DD>
|
|
<DT id="11"><A HREF="#lbAH">KNOWN ISSUES</A><DD>
|
|
<DT id="12"><A HREF="#lbAI">AUTHORS</A><DD>
|
|
<DT id="13"><A HREF="#lbAJ">THANKS</A><DD>
|
|
<DT id="14"><A HREF="#lbAK">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:14 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|