dslpprinter(1M)

dslpprinter -- assign alias to print queue Distinguished Name

Synopsis

dslpprinter [-l location-dn] [-o object-dn] -a alias-name print-queue-dn

dslpprinter -x [-o object-dn] -a aliasname

dslpprinter [-l location-dn] [-o object-dn] -d print-queue-dn

dslpprinter -x -d [-o object-dn]

dslpprinter [-o object-dn] -D print-queue-dn

dslpprinter -x -D [-o object-dn]

Description

The dslpprinter utility is used, by either an administrator or a directory-enabled UNIX user, to assign an alias to a print queue DN. It can also be used to set up default printers for a user, either at a location that is specific to the current directory context, or as an ``anywhere'' default. A default, set for the user's current directory context location, always takes precedence over the ``anywhere'' default. A print queue's alias name can be used instead of its real name.

The print-queue-dn argument is the print queue DN to use for this alias name or default print queue.

The user of this utility must be directory-enabled and have permissions set for write, modify, search and read on the directory object that is being modified.

Options

The following command line options are supported:

-l location-dn: A DN that specifies the location, in terms of directory context DN, for which the alias name is valid. It defaults to the current directory context.
-o object-dn: A DN that specifies the user or container object to which the alias is to be added. Defaults to the current login user.
-a alias-name: The alias name to be allocated to the specified print queue.
-x: Remove the alias name or default print queues from the object.
-d: Set the specified print queue as the default for this location.
-D: Set the default print queue for location ``anywhere''.

Exit codes

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

1: invalid options
2: an invalid DN was specified
3: specified print queue is unknown
4: specified location is unknown
5: specified object (user or container) is unknown
6: specified alias is unknown (on remove)
7: user is not allowed to change this object
8: specified alias name is not unique
9: unable to contact the directory service
10: other error

Examples

To add an alias for a print queue to the current directory-enabled user:

dslpprinter -a printer1 queuename=hplj,ou=mygroup,o=sco

To set a default print queue for the current user:

dslpprinter -D queuename=hpcolor,ou=hr,o=sco

References

dslpaccept(1M), dslpaccess(1M), dslpadmin(1M), dslpenable(1M), dslpprotocol(1M), dslpsearch(1)