git.sur5r.net Git - openldap/blob - contrib/whois++/helpfiles/english/search

   1 There are 4 different search styles possible when using a whois++ server.
   2
   3 The first of these styles is the familiar whois style query, where your
   4 client supplies a number of tokens and these tokens are converted into a
   5 LDAP search query for processing by the X.500 Directory system.
   6
   7 Example queries
   8 a. ng =>
   9         (|(sn=ng)(userid=ng)(l=ng)(ou=ng)(&(cn=ng)(!(objectClass=person))))
  10
  11 b. Snoke, Robert Lee =>
  12         (&(sn=Snoke)(|(l=Robert Lee Snoke)(ou=Robert Lee Snoke)\
  13                 (preferredName=Robert Lee Snoke)(cn=*Robert * Lee * Snoke)))
  14
  15 c. mrp@ =>
  16         (|(mail=mrp@*)(userid=mrp))
  17
  18 As you can see no attribute information was supplied by the client and so
  19 the server must "guess" what information is required. X.500 uses the
  20 attribute cn (commonName) fairly generically to name entries so this is used
  21 in constructing queries. It is assumed that most queries will relate to a
  22 search for a person so the query is composed in such a way to emphasise this
  23 assumption. If only one token is supplied this is assumed to be a family
  24 name whereas if more than one token is supplied this assumed to be the full
  25 name, in order to distinguish the family name you may use the "," syntax as
  26 per example (b).
  27
  28 E-mail lookups as described in the original whois RFC (RFC954) are also
  29 supported however wildcard style searches may be constrained by the X.500
  30 Directory service.
  31
  32 The other search styles involve the use of attributes, where the client
  33 specifies the type of the data that it wishes to search for.