1IDMAP_HASH(8)             System Administration tools            IDMAP_HASH(8)
2
3
4

NAME

6       idmap_hash - DO NOT USE THIS BACKEND
7

DESCRIPTION

9       DO NOT USE THIS PLUGIN The idmap_hash plugin implements a hashing
10       algorithm used to map SIDs for domain users and groups to 31-bit uids
11       and gids, respectively. This plugin also implements the nss_info API
12       and can be used to support a local name mapping files if enabled via
13       the "winbind normalize names" and "winbind nss info" parameters in
14       /etc/samba/smb.conf. The module divides the range into subranges for
15       each domain that is being handled by the idmap config. The module needs
16       the complete UID and GID range to be able to map all SIDs. The lowest
17       value for the range should be the smallest ID available in the system.
18       This is normally 1000. The highest ID should be set to 2147483647. A
19       smaller range will lead to issues because of the hashing algorithm
20       used. The overall range to map all SIDs is 0 - 2147483647. Any range
21       smaller than 0 - 2147483647 will filter some SIDs. As we can normally
22       only start with 1000, we are not able to map 1000 SIDs. This already
23       can lead to issues. The smaller the range the less SIDs can be mapped.
24       We do not recommend to use this plugin. It will be removed in a future
25       release of Samba.
26

IDMAP OPTIONS

28       name_map
29           Specifies the absolute path to the name mapping file used by the
30           nss_info API. Entries in the file are of the form "unix name =
31           qualified domain name". Mapping of both user and group names is
32           supported.
33

EXAMPLES

35       The following example utilizes the idmap_hash plugin for the idmap and
36       nss_info information.
37
38                [global]
39                idmap config * : backend = hash
40                idmap config * : range = 1000-2147483647
41
42                winbind nss info = hash
43                winbind normalize names = yes
44                idmap_hash:name_map = /etc/samba/name_map.cfg
45
46

AUTHOR

48       The original Samba software and related utilities were created by
49       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
50       Source project similar to the way the Linux kernel is developed.
51
52
53
54Samba 4.19.3                      11/27/2023                     IDMAP_HASH(8)
Impressum