add idmap_nss man page
[tprouty/samba.git] / docs / manpages-3 / 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 </refmeta>
9
10
11 <refnamediv>
12         <refname>idmap_nss</refname>
13         <refpurpose>Samba's idmap_nss Backend for Winbind</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv>
17         <title>DESCRIPTION</title>
18
19         <para>The idmap_nss plugin provides a means to map Unix users and groups
20         to Windows accounts and obseletes the &quot;winbind trusted domains only&quot;
21         smb.conf option.  This provides a simple means of ensuring that the SID
22         for a Unix user named jsmith is reported as the one assigned to 
23         DOMAIN\jsmith which is necessary for reporting ACLs on files and printers
24         stored on a Samba member server.
25         </para>
26 </refsynopsisdiv>
27
28 <refsect1>
29         <title>EXAMPLES</title>
30
31         <para>
32         The follow sets of a LDAP configuration which uses a slave server
33         running on localhost for fetching SID/gid/uid mappings while
34         sending update requests to the directory master server.
35         </para>
36
37         <programlisting>
38         [global]
39             idmap domain = SAMBA TRUSTEDDOMAINS
40
41             idmap config SAMBA:backend  = nss
42             idmap config SAMBA:readonly = yes
43
44             idmap config TRUSTEDDOMAINS:default = yes
45             idmap config TRUSTEDDOMAINS:backend = tdb
46             idmap config TRUSTEDDOMAINS:range   = 10000 - 50000
47
48             idmap alloc backend      = tdb
49             idmap alloc config:range = 10000 - 50000
50         </programlisting>
51 </refsect1>
52
53 <refsect1>
54         <title>AUTHOR</title>
55
56         <para>
57         The original Samba software and related utilities 
58         were created by Andrew Tridgell. Samba is now developed
59         by the Samba Team as an Open Source project similar 
60         to the way the Linux kernel is developed.
61         </para> 
62 </refsect1>
63
64 </refentry>