From 74940606f715bfc9d99ded2fb1d1da02d037609a Mon Sep 17 00:00:00 2001 From: Michael Adam Date: Tue, 17 Feb 2009 08:51:39 +0100 Subject: docs: extend the idmap_rid manpage Michael --- docs-xml/manpages-3/idmap_rid.8.xml | 29 ++++++++++++++++++++++++----- 1 file changed, 24 insertions(+), 5 deletions(-) (limited to 'docs-xml/manpages-3/idmap_rid.8.xml') diff --git a/docs-xml/manpages-3/idmap_rid.8.xml b/docs-xml/manpages-3/idmap_rid.8.xml index 5eba356a7d..7e48c11c53 100644 --- a/docs-xml/manpages-3/idmap_rid.8.xml +++ b/docs-xml/manpages-3/idmap_rid.8.xml @@ -42,11 +42,13 @@ base_rid = INTEGER - Defines 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. + Defines the base integer used to build SIDs out of a UID or a GID, + and to rebase the UID or GID to be obtained from a SID. + This means SIDs with a RID less than the base rid are filtered. + The default is not to restrict the allowed rids at all, + i.e. a base_rid value of 0. + A good value for the base_rid can be 1000, since user + RIDs by default start at 1000 (512 hexadecimal). Use of this parameter is deprecated. @@ -55,6 +57,23 @@ + + THE MAPPING FORMULAS + + The Unix ID for a RID is calculated this way: + + ID = RID - BASE_RID + LOW_RANGE_ID. + + + + Correspondingly, the formula for calculationg the RID for a + given Unix ID is this: + + RID = ID + BASE_RID - LOW_RANGE_ID. + + + + EXAMPLES This example shows how to configure a domain with idmap_rid -- cgit