dslpsearch(1)


dslpsearch -- search directory for print system objects

Synopsis

dslpsearch [-C directory-context] [-q [-p]] | [-P] [-o search-options]

Description

The dslpsearch utility allows users and administrators to search the directory for print system objects. For example, a user could search for any printer that can print color PostScript® files. The main use of this utility will be to search for print queues that match the search-string. The utility returns the Distinguished Name (DN) of any objects that match the search string.

Options

The following command line options are supported by dslpsearch:

-C directory-context
If a directory-context is given, the command searches for objects in that directory context. Otherwise, it only searches in the current directory context. For example "ou=mydept,o=sco".

-q
Search for print queues that match the search options. The search is done on the physical printer objects but the print queues that service those printers are displayed. This is the default search type. The -q option cannot be specified with -P.

-P
Search for physical printers that match the search string. The -P option cannot be specified with -q.

-p
This option is used with the -q option, and causes a list of physical printers servicing the print queue also to be displayed:

dslpsearch -q -p


-o search-options
Multiple search options may form a comma-separated list. Each option may be constructed from the following:

Examples

The following command line searches for any print queues that match the search options in the current directory context:

dslpsearch -q -o search-options

The following searches for any print queues that match the search options in the specified directory context:

dslpsearch -C context-dn -q -o search-options

The following searches for any physical printers that match the search options in the current directory context:

dslpsearch -P -o search-options

The following searches for any physical printers that match the search options in the specified directory context:

dslpsearch -C context-dn -P -o search-options

Exit codes

On success, dslpsearch returns 0, otherwise one of the following exit codes is returned:

1
invalid options

2
search on directory tree failed

3
invalid directory context

4
unable to contact the directory service

References

dslpadmin(1M)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004