303a0f457759ee91166edfb62d066d035e445aa8
[sfrench/samba-autobuild/.git] / docs-xml / manpages / idmap_nss.8.xml
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
3 <refentry id="idmap_nss.8">
4
5 <refmeta>
6         <refentrytitle>idmap_nss</refentrytitle>
7         <manvolnum>8</manvolnum>
8         <refmiscinfo class="source">Samba</refmiscinfo>
9         <refmiscinfo class="manual">System Administration tools</refmiscinfo>
10         <refmiscinfo class="version">4.7</refmiscinfo>
11 </refmeta>
12
13
14 <refnamediv>
15         <refname>idmap_nss</refname>
16         <refpurpose>Samba's idmap_nss Backend for Winbind</refpurpose>
17 </refnamediv>
18
19 <refsynopsisdiv>
20         <title>DESCRIPTION</title>
21
22         <para>The idmap_nss plugin provides a means to map Unix users and groups
23         to Windows accounts and obsoletes the &quot;winbind trusted domains only&quot;
24         smb.conf option.  This provides a simple means of ensuring that the SID
25         for a Unix user named jsmith is reported as the one assigned to
26         DOMAIN\jsmith which is necessary for reporting ACLs on files and printers
27         stored on a Samba member server.
28         </para>
29 </refsynopsisdiv>
30
31 <refsect1>
32         <title>EXAMPLES</title>
33
34         <para>
35         This example shows how to use idmap_nss to check the local accounts for its
36         own domain while using allocation to create new mappings for trusted domains
37         </para>
38
39         <programlisting>
40         [global]
41         idmap config * : backend = tdb
42         idmap config * : range = 1000000-1999999
43
44         idmap config SAMBA : backend  = nss
45         idmap config SAMBA : range = 1000-999999
46         </programlisting>
47 </refsect1>
48
49 <refsect1>
50         <title>AUTHOR</title>
51
52         <para>
53         The original Samba software and related utilities
54         were created by Andrew Tridgell. Samba is now developed
55         by the Samba Team as an Open Source project similar
56         to the way the Linux kernel is developed.
57         </para>
58 </refsect1>
59
60 </refentry>