Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

idmap_hash (8)

Name

idmap_hash - DO NOT USE THIS BACKEND

Synopsis

Please see following description for synopsis

Description

System Administration tools                                      IDMAP_HASH(8)



NAME
       idmap_hash - DO NOT USE THIS BACKEND

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

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

EXAMPLES
       The following example utilizes the idmap_hash plugin for the idmap and
       nss_info information.

                [global]
                idmap config * : backend = hash
                idmap config * : range = 1000-2147483647

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


AUTHOR
       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.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | service/network/samba |
       +---------------+-----------------------+
       |Stability      | Volatile              |
       +---------------+-----------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       https://download.samba.org/pub/samba/stable/samba-4.13.17.tar.gz.

       Further information about this software can be found on the open source
       community website at http://www.samba.org/.



Samba 4.13.17                     06/28/2022                     IDMAP_HASH(8)