dslpenable(1M)

dslpenable, dslpdisable -- enable/disable print queue requests

Synopsis

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

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

Description

The dslpenable and dslpdisable utilities are used to enable or disable a print queue from processing print requests that have been queued for it. Unlike the enable(1M) and disable(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.

The print-queue-name parameter is the RDN of the print queue. This could be a list of print queues. If the print queue name does not exist in the directory context (as set by the -C option), the command fails.

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

-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: Assign the reason for disabling the print queue. 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, dslpenable and dslpdisable 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 enable a print queue in the user's current directory context:

dslpenable hpcolor

To disable a print queue, specifying a reason:

dslpdisable -C ou=hr,o=sco -r "routine maintenance" printer1

References

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