1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>idmap_tdb2</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="idmap_tdb2.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>idmap_tdb2 — Samba's idmap_tdb2 Backend for Winbind</p></div><div class="refsynopsisdiv"><h2>DESCRIPTION</h2><p> 2 The idmap_tdb2 plugin is a substitute for the default idmap_tdb 3 backend used by winbindd for storing SID/uid/gid mapping tables 4 in clustered environments with Samba and CTDB. 5 </p><p> 6 In contrast to read only backends like idmap_rid, it is an allocating 7 backend: This means that it needs to allocate new user and group IDs in 8 order to create new mappings. The allocator can be provided by the 9 idmap_tdb2 backend itself or by any other allocating backend like 10 idmap_tdb or idmap_ldap. This is configured with the 11 parameter <em class="parameter"><code>idmap alloc backend</code></em>. 12 </p><p> 13 Note that in order for this (or any other allocating) backend to 14 function at all, the default backend needs to be writeable. 15 The ranges used for uid and gid allocation are the default ranges 16 configured by "idmap uid" and "idmap gid". 17 </p><p> 18 Furthermore, since there is only one global allocating backend 19 responsible for all domains using writeable idmap backends, 20 any explicitly configured domain with idmap backend tdb2 21 should have the same range as the default range, since it needs 22 to use the global uid / gid allocator. See the example below. 23 </p></div><div class="refsect1" lang="en"><a name="id2522933"></a><h2>IDMAP OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">range = low - high</span></dt><dd><p> 24 Defines the available matching uid and gid range for which the 25 backend is authoritative. 26 If the parameter is absent, Winbind fails over to use 27 the "idmap uid" and "idmap gid" options 28 from smb.conf. 29 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2483328"></a><h2>IDMAP SCRIPT</h2><p> 30 The tdb2 idmap backend supports a script for performing id mappings 31 through the smb.conf option <em class="parameter"><code>idmap : script</code></em>. 32 The script should accept the following command line options. 33 </p><pre class="programlisting"> 34 SIDTOID S-1-xxxx 35 IDTOSID UID xxxx 36 IDTOSID GID xxxx 37 </pre><p> 38 And it should return one of the following responses as a single line of 39 text. 40 </p><pre class="programlisting"> 41 UID:yyyy 42 GID:yyyy 43 SID:yyyy 44 ERR:yyyy 45 </pre><p> 46 Note that the script should cover the complete range of SIDs 47 that can be passed in for SID to Unix ID mapping, since otherwise 48 SIDs unmapped by the script might get mapped to IDs that had 49 previously been mapped by the script. 50 </p></div><div class="refsect1" lang="en"><a name="id2483371"></a><h2>EXAMPLES</h2><p> 51 This example shows how tdb2 is used as a the default idmap backend. 52 It configures the idmap range through the global options for all 53 domains encountered. This same range is used for uid/gid allocation. 54 </p><pre class="programlisting"> 55 [global] 56 idmap backend = tdb2 57 idmap uid = 1000000-2000000 58 idmap gid = 1000000-2000000 59 </pre></div><div class="refsect1" lang="en"><a name="id2483519"></a><h2>AUTHOR</h2><p> 60 The original Samba software and related utilities 61 were created by Andrew Tridgell. Samba is now developed 62 by the Samba Team as an Open Source project similar 63 to the way the Linux kernel is developed. 64 </p></div></div></body></html> 65