Bug 215736

Summary:	uri.7: DESCRIPTION: Usage: ldap: Reference to obsolete IETF RFCs 2251, 2253, 2254, and 2255
Product:	Documentation	Reporter:	Alejandro Colomar (alx)
Component:	man-pages	Assignee:	documentation_man-pages (documentation_man-pages)
Status:	NEW ---
Severity:	normal
Priority:	P1
Hardware:	All
OS:	Linux
Kernel Version:		Subsystem:
Regression:	No	Bisected commit-id:

Description Alejandro Colomar 2022-03-24 11:46:52 UTC

uri(7)::DESCRIPTION::Usage::ldap reads as:

```
       ldap - Lightweight Directory Access Protocol

       ldap://hostport
       ldap://hostport/
       ldap://hostport/dn
       ldap://hostport/dn?attributes
       ldap://hostport/dn?attributes?scope
       ldap://hostport/dn?attributes?scope?filter
       ldap://hostport/dn?attributes?scope?filter?extensions

       This scheme supports queries to the Lightweight Directory
       Access  Protocol (LDAP), a protocol for querying a set of
       servers for hierarchically organized information (such as
       people   and   computing   resources).    See    RFC 2255
       <http://www.ietf.org/rfc/rfc2255.txt>   for more informa-
       tion on the LDAP URL scheme.  The components of this  URL
       are:

       [...]
```

It refers to an obsolete RFC[1].  We should update the info there.


[1]: <https://www.rfc-editor.org/rfc/rfc2255>

Comment 1 Alejandro Colomar 2022-03-24 11:49:45 UTC

More references to obsolete RFCs[2][3][4] in the same ldap entry:

```
       dn          the LDAP Distinguished Name, which identifies
                   the  base  object  of  the  LDAP  search (see
                   RFC 2253             <http://www.ietf.org/rfc
                   /rfc2253.txt>  section 3).

       attributes  a  comma-separated  list  of attributes to be
                   returned; see  RFC 2251  section  4.1.5.   If
                   omitted, all attributes should be returned.

       scope       specifies  the scope of the search, which can
                   be one of "base" (for a base object  search),
                   "one" (for a one-level search), or "sub" (for
                   a  subtree  search).   If  scope  is omitted,
                   "base" is assumed.

       filter      specifies the search filter  (subset  of  en-
                   tries  to  return).   If omitted, all entries
                   should    be    returned.     See    RFC 2254
                   <http://www.ietf.org/rfc/rfc2254.txt>    sec-
                   tion 4.
```

[2]: <https://www.rfc-editor.org/rfc/rfc2253>
[3]: <https://www.rfc-editor.org/rfc/rfc2251>
[4]: <https://www.rfc-editor.org/rfc/rfc2254>

Comment 2 Alejandro Colomar 2022-03-24 12:11:59 UTC

Should check the following RFCs that replace them:

2251:
  <https://www.rfc-editor.org/rfc/rfc4510>
  <https://www.rfc-editor.org/rfc/rfc4511>
  <https://www.rfc-editor.org/rfc/rfc4513>
    <https://www.rfc-editor.org/rfc/rfc8996> (updates 4513)
  <https://www.rfc-editor.org/rfc/rfc4512>

2253:
  <https://www.rfc-editor.org/rfc/rfc4510>
  <https://www.rfc-editor.org/rfc/rfc4514>

2254:
  <https://www.rfc-editor.org/rfc/rfc4510>
  <https://www.rfc-editor.org/rfc/rfc4515>

2255:
  <https://www.rfc-editor.org/rfc/rfc4510>
  <https://www.rfc-editor.org/rfc/rfc4516>