dslpaccept(1M)

dslpaccept, dslpreject -- accept/reject print queue requests

Synopsis

dslpaccept [-C directory-context] print-queue-name

dslpreject [-C directory-context] [-r reason] print-queue-name

Description

The dslpaccept and dslpreject utilities are used to set a print queue so that it will accept or reject print requests being queued for it. Unlike the accept(1M) and reject(1M) utilities, the directory-enabled utilities can control remote print systems, so long as they are directory-enabled. This is because they write directly to the print queue object on the directory server. Print requests that are already queued are not affected by the dslpreject utility.

The print-queue-name parameter is the RDN of the print queue object. If the specified print queue does not exist in the directory context (as set by the -C option), the command fails. Multiple print queue names may form a comma-separated list.

The user of this utility must be directory-enabled and have permissions set for write, modify, search and read on the directory, in the directory context in which they are administrator.

Options

The following command line options are supported by these utilities:

-C directory-context: The directory-context argument specifies the directory context for which the command is valid. For example, the command changes the status of the print queue whose RDN has been specified by the print-queue-name in the directory context. If the -C option is not given, the current directory context is used.
-r reason: Assigns a reason for the rejection. Strings containing whitespace should be double quoted.
This is a string that is displayed by the lpstat(1) command. No default reason is set when one is not specified.

Exit codes

On success, dslpaccept and dslpreject return 0, otherwise one of the following exit codes is returned:

1: invalid options
2: specified print queue is unknown
3: this user does not have modify permissions
4: invalid DN supplied
5: value is already set
6: unable to contact the directory service
7: other error

Examples

To set a print queue in the user's current directory context to accept requests:

dslpaccept hpcolor

To set a print queue to reject requests, and specify a reason:

dslpreject -C ou=mygroup,o=sco -r "no toner" printer1

References

dslpaccess(1M), dslpadmin(1M), dslpenable(1M), dslpprotocol(1M), dslpprinter(1M), dslpsearch(1), lpstat(1)