Add more content to the description of "registry shares".
[Samba/bjacke.git] / docs / manpages-3 / idmap_nss.8.xml
blobb5169c95c7c17b8c265e1f813d1f98ded8ed68a6
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">
5 <refmeta>
6         <refentrytitle>idmap_nss</refentrytitle>
7         <manvolnum>8</manvolnum>
8 </refmeta>
11 <refnamediv>
12         <refname>idmap_nss</refname>
13         <refpurpose>Samba's idmap_nss Backend for Winbind</refpurpose>
14 </refnamediv>
16 <refsynopsisdiv>
17         <title>DESCRIPTION</title>
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>
28 <refsect1>
29         <title>EXAMPLES</title>
31         <para>
32         This example shows how to use idmap_nss to check the local accounts for its
33         own domain while using allocation to create new mappings for trusted domains
34         </para>
36         <programlisting>
37         [global]
38             idmap domains = SAMBA TRUSTEDDOMAINS
40             idmap config SAMBA:backend  = nss
41             idmap config SAMBA:readonly = yes
43             idmap config TRUSTEDDOMAINS:default = yes
44             idmap config TRUSTEDDOMAINS:backend = tdb
45             idmap config TRUSTEDDOMAINS:range   = 10000 - 50000
47             idmap alloc backend      = tdb
48             idmap alloc config:range = 10000 - 50000
49         </programlisting>
50 </refsect1>
52 <refsect1>
53         <title>AUTHOR</title>
55         <para>
56         The original Samba software and related utilities
57         were created by Andrew Tridgell. Samba is now developed
58         by the Samba Team as an Open Source project similar
59         to the way the Linux kernel is developed.
60         </para>
61 </refsect1>
63 </refentry>