WHATSNEW: Prepare release notes for Samba 3.3.9.
[Samba/bb.git] / docs-xml / manpages-3 / idmap_nss.8.xml
blobbe5c2d88cfa91e570c6abd53f5b31d777c9f0187
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         <refmiscinfo class="source">Samba</refmiscinfo>
9         <refmiscinfo class="manual">System Administration tools</refmiscinfo>
10         <refmiscinfo class="version">3.3</refmiscinfo>
11 </refmeta>
14 <refnamediv>
15         <refname>idmap_nss</refname>
16         <refpurpose>Samba's idmap_nss Backend for Winbind</refpurpose>
17 </refnamediv>
19 <refsynopsisdiv>
20         <title>DESCRIPTION</title>
22         <para>The idmap_nss plugin provides a means to map Unix users and groups
23         to Windows accounts and obseletes 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>
31 <refsect1>
32         <title>EXAMPLES</title>
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>
39         <programlisting>
40         [global]
41         idmap backend = tdb
42         idmap uid = 1000000-1999999
43         idmap gid = 1000000-1999999
45         idmap config SAMBA : backend  = nss
46         idmap config SAMBA : range = 1000-999999
47         </programlisting>
48 </refsect1>
50 <refsect1>
51         <title>AUTHOR</title>
53         <para>
54         The original Samba software and related utilities
55         were created by Andrew Tridgell. Samba is now developed
56         by the Samba Team as an Open Source project similar
57         to the way the Linux kernel is developed.
58         </para>
59 </refsect1>
61 </refentry>