summaryrefslogtreecommitdiff
path: root/docs-xml/manpages-3/idmap_hash.8.xml
blob: 8e452b3c8952def4d80a6b51b2e63b6428c477f6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
<refentry id="idmap_hash.8">

<refmeta>
	<refentrytitle>idmap_hash</refentrytitle>
	<manvolnum>8</manvolnum>
	<refmiscinfo class="source">Samba</refmiscinfo>
	<refmiscinfo class="manual">System Administration tools</refmiscinfo>
	<refmiscinfo class="version">3.2</refmiscinfo>
</refmeta>


<refnamediv>
	<refname>idmap_hash</refname>
	<refpurpose>Samba's idmap_hash Backend for Winbind</refpurpose>
</refnamediv>

<refsynopsisdiv>
	<title>DESCRIPTION</title>
	<para>The idmap_hash plugin implements a hashing algorithm used
	  map SIDs for domain users and groups to a 31-bit uid and gid.
	  This plugin also implements the nss_info API and can be used
	  to support a local name mapping files if enabled via the
	  &quot;winbind normlaize names&quot; and &quot;winbind nss info&quot;
	  parameters in smb.conf.
	</para>
</refsynopsisdiv>

<refsect1>
	<title>IDMAP OPTIONS</title>

	<variablelist>
		<varlistentry>
		<term>name_map</term>
		<listitem><para>
		    Specifies the absolute path to the name mapping
		    file used by the nss_info API.  Entries in the file
		    are of the form &quot;<replaceable>unix name</replaceable>
		    = <replaceable>qualified domain name</replaceable>&quote;.
		    Mapping of both user and group names is supported.
		</para></listitem>
		</varlistentry>
	</variablelist>
</refsect1>

<refsect1>
	<title>EXAMPLES</title>
	<para>The following example utilizes the idmap_hash plugin for
	  the idmap and nss_info information.
	</para>

	<programlisting>
	[global]
	idmap backend = hash
	idmap uid = 1000-4000000000
	idmap gid = 1000-4000000000

	winbind nss info = hash
	winbind normalize names = yes
	idmap_hash:name_map = /etc/samba/name_map.cfg
	</programlisting>
</refsect1>

<refsect1>
	<title>AUTHOR</title>

	<para>
	The original Samba software and related utilities
	were created by Andrew Tridgell. Samba is now developed
	by the Samba Team as an Open Source project similar
	to the way the Linux kernel is developed.
	</para>
</refsect1>

</refentry>