Issue 8132 - Slightly confusing documentation
Summary: Slightly confusing documentation
Status: VERIFIED FIXED
Alias: None
Product: OpenLDAP
Classification: Unclassified
Component: documentation (show other issues)
Version: 2.4.40
Hardware: All All
: --- normal
Target Milestone: 2.5.2
Assignee: Quanah Gibson-Mount
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-05-06 17:22 UTC by elecharny@openldap.org
Modified: 2021-02-26 23:35 UTC (History)
0 users

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this issue.
Description elecharny@openldap.org 2015-05-06 17:22:14 UTC 
Full_Name: Emmanuel Lecharny
Version: 2.4.40
OS: 
URL: ftp://ftp.openldap.org/incoming/
Submission from: (NULL) (2a01:e34:ec0b:b180:cd03:5409:b5fe:aa99)


The slapd-config man page content on the olcServerID parameter is a bit
confusing :

   'Specify an integer ID from 0 to 4095 for this server (limited to
   3  hexadecimal digits).  The ID may also be specified as a hexa‐
   decimal ID by prefixing the value  with  "0x".'...


If it's an integer, like 4095, why is it limited to 3 hexadecimal digits, when 4
digits would be required ? If you have to enter FFF for 4095, then should we add
the 0x prefix ?

All in all, it's hard for me to know if those values are accepted :

  - 4095
  - FFF

also is :

  - 100

considered as 100 (decimal) or 256 (decimal) ?
Comment 1 Quanah Gibson-Mount 2021-02-15 19:15:13 UTC 
100 would clearly be decimal
0x100 would be hex

0xFFF would be 4095

Fairly straight forward, but I've tweaked the man page to fix the wording.
Comment 3 Quanah Gibson-Mount 2021-02-17 18:42:24 UTC 
Commits: 
  • 71213e69 
by Quanah Gibson-Mount at 2021-02-17T17:33:48+00:00 
ITS#8132 - Clarify wording on serverID.