HP-UX Directory Server 8.1 configuration, command, and file reference

Table 6-10 Additional ldapsearch options (continued)
DescriptionOption
Specifies the file containing the search filters to be used in the search. For example:
-f search_filters
option to supply a search filter directly to the command line.
For more information about search filters, see Appendix B, "Finding Directory Entries", in the HP-UX
Directory Server administrator guide.
-f
Conducts a virtual list view search. This option can set the number of entries before or after the
search target and the index or value of the first entry returned.
For example, a value operation that sorts by surname, -G 20:30:johnson, returns the first entry
with a surname equal to or less than johnson, in addition to 20 entries that come before it and 30
entries that come after it. If there are fewer matching entries in the directory than the before or after
number requested by the search, all available entries before/after the search target that match the
search criteria are returned.
An index operation which sorts by surname, -G 20:30:100:0, returns from the 80th through
130th entries sorted by sn. Use 0 as the fourth value for the count number unless you know how
many entries the VLV index has.
-G
Specifies the characterset to use for command-line input. The default is the characterset specified
in the LANG environment variable. Use this option to perform the conversion from the specified
characterset to UTF8, thus overriding the environment variable setting.
This argument can input the bind DN, base DN, and the search filter pattern in the specified
characterset.
The ldapsearch command converts the input from these arguments before it processes the search
request. For example, -i no indicates that the bind DN, base DN, and search filter are provided
in Norwegian. This argument only affects the command-line input; that is, if a file containing a
search filter (with the -f option) is specified, the ldapsearch command will not convert the data
in the file.
-i
Send an arbitrary control. This option can be used in the following format to retrieve access control
information on a specific entry:
-J control OID:boolean criticality:dn:AuthID
• control OID is the OID for the get effective rights control, 1.3.6.1.4.1.42.2.27.9.5.2.
• boolean criticality specifies whether the search operation should return an error if the
server does not support this control (true) or if it should be ignored and let the search return
as normal (false).
• AuthId is the DN of the user whose rights to check.
-J
Bypasses converting the password to UTF8.
-k
Manages smart referrals. This causes the server not to return the smart referral contained on the
entry but, instead, to return the actual entry containing the referral. Use this option to search for
entries that contain smart referrals. For more information about smart referrals, see the "Configuring
Directory Databases" chapter in the HP-UX Directory Server administrator guide.
-M
Specifies that the search is not actually to be performed, but that the ldapsearch command is to
show what it would do with the specified input.
-n
Specifies the maximum number of referral hops ldapsearch should automatically follow. For
example:
-O 2
-O
Specifies that referrals are not to be followed automatically. By default, referrals are followed
automatically.
-R
200 Command-line utilities