b. La fonction
recherche
L'opération de recherche est à la fois l'une des
plus utilisées, et l'une des plus significatives. Connaître son
fonctionnement permet de comprendre comment marche LDAP. Sa description dans la
[rfc2251] est la plus longue parmi celles des neuf opérations. Elle
décrite dans la section 4.5, de la page 25 à la page 31.
La liste des paramètres de cette fonction est donc la
suivante :
|
baseObject
|
Entrée à partir de laquelle la recherche est
effectuée.
|
|
|
scope
|
Profondeur de la recherche. Il y a trois types de profondeur
possible :
|
|
|
|
base
|
La recherche ne s'effectuera que sur le baseObject. La
recherche devient alors l'équivalent d'une lecture, à condition
toutefois que le baseObject réponde positivement au
filtre.
|
|
|
one
|
Tous les enfants directs du baseObject et seulement les
enfants directs sont concernés par la recherche.
|
|
|
sub
|
Tous les descendants de baseObject, ainsi que
baseObject lui même sont concernés par la recherche
|
|
derefAliases
|
Ce paramètre indique comment doivent être
considérés les objets de type alias. Une entrée
de classe alias est une copie d'une autre entrée de l'annuaire,
qui apparaît aussi à plusieurs endroits de l'annuaire. Il y a
trois valeurs possibles :
|
|
|
|
neverDerefAliases
|
La recherche ne va jamais traiter les alias qu'elle rencontrera
au sens où elle n'ira pas effectuer la recherche sur les entrées
originales pointées par les éventuels alias
|
|
|
derefInSearching
|
L'alias est résolu seulement dans les entrées sous
le baseObject, mais pas dans le baseObject lui-même
|
|
|
derefFindingBaseObj
|
L'alias est résolu, l'entrée originale sera lue,
seulement dans le baseObject
|
|
|
derefAlways
|
Les alias seront toujours résolus
|
|
sizeLimit
|
Nombre maximum d'entrées retournées par la
recherche. 0 signifie aucune limite imposée par le client
|
|
|
timeLimit
|
Temps en secondes maximum permis pour l'exécution de la
requête. 0 signifie aucune limite imposée par le
client
|
|
|
typesOnly
|
Booléen indiquant si la recherche doit retourner les
valeurs des attributs, avec leur type ou pas
|
|
|
filter
|
Filtre de recherche. La syntaxe des filtres est explicitée
dans un autre chapitre
|
|
|
attributes
|
Liste des attributs à retourner pour les entrées
récupérées par la recherche. Si ce paramètre
contient une chaîne vide ou bien *, tous les attributs seront
retournés. Certains attributs demandés peuvent ne pas être
retournés si l'utilisateur n'a pas le droit d'accès dessus. Mais
aucun message d'erreur ne sera renvoyé, puisqu'il aura accès aux
autres attributs. Si l'attribut dont l'OID est 1.1 transmis, cela
signifie que le client n'attend aucun attribut
|
|
Tableau 7: paramètre de
la fonction de recherche LDAP
| 
