source: branches/samba-3.3.x/docs/manpages/idmap_rid.8@ 368

Last change on this file since 368 was 368, checked in by Herwig Bauernfeind, 16 years ago

Update Samba 3.3 to 3.3.10 (docs)

File size: 2.4 KB
Line 
1'\" t
2.\" Title: idmap_rid
3.\" Author: [see the "AUTHOR" section]
4.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5.\" Date: 01/14/2010
6.\" Manual: System Administration tools
7.\" Source: Samba 3.3
8.\" Language: English
9.\"
10.TH "IDMAP_RID" "8" "01/14/2010" "Samba 3\&.3" "System Administration tools"
11.\" -----------------------------------------------------------------
12.\" * set default formatting
13.\" -----------------------------------------------------------------
14.\" disable hyphenation
15.nh
16.\" disable justification (adjust text to left margin only)
17.ad l
18.\" -----------------------------------------------------------------
19.\" * MAIN CONTENT STARTS HERE *
20.\" -----------------------------------------------------------------
21.SH "NAME"
22idmap_rid \- Samba\'s idmap_rid Backend for Winbind
23.SH "DESCRIPTION"
24.PP
25The idmap_rid backend provides a way to use an algorithmic mapping scheme to map UIDs/GIDs and SIDs\&. No database is required in this case as the mapping is deterministic\&.
26.SH "IDMAP OPTIONS"
27.PP
28range = low \- high
29.RS 4
30Defines the available matching uid and gid range for which the backend is authoritative\&. Note that the range acts as a filter\&. If algorithmically determined UID or GID fall outside the range, they are ignored and the corresponding map is discarded\&. It is intended as a way to avoid accidental UID/GID overlaps between local and remotely defined IDs\&.
31.RE
32.PP
33base_rid = INTEGER
34.RS 4
35Defines the base integer used to build SIDs out of an UID or a GID, and to rebase the UID or GID to be obtained from a SID\&. User RIDs by default start at 1000 (512 hexadecimal), this means a good value for base_rid can be 1000 as the resulting ID is calculated this way: ID = RID \- BASE_RID + LOW RANGE ID\&.
36.sp
37Use of this parameter is deprecated\&.
38.RE
39.SH "EXAMPLES"
40.PP
41This example shows how to configure a domain with idmap_rid
42.sp
43.if n \{\
44.RS 4
45.\}
46.nf
47 [global]
48 idmap backend = tdb
49 idmap uid = 1000000\-1999999
50 idmap gid = 1000000\-1999999
51
52 idmap config TRUSTED : backend = rid
53 idmap config TRUSTED : range = 50000 \- 99999
54
55.fi
56.if n \{\
57.RE
58.\}
59.SH "AUTHOR"
60.PP
61The 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\&.
Note: See TracBrowser for help on using the repository browser.