pioattred Command

Purpose

Provides a way to format and edit attributes in a virtual printer.

Syntax

pioattred -q PrintQueueName -d QueueDeviceName [ -o Action] [ -a Attribute]

Description

The pioattred command provides a way to format virtual printer attributes and to edit the attributes. Specifically, attributes in the printer definition file can be formatted and/or edited according to the action specified with the -o flag. Formatted attributes are written to standard output stdout. Attributes are edited with the editor specified in the VISUAL environment variable. The virtual printer definition file is assumed to be in the /var/spool/lpd/pio/@local/custom/* directory.

Flags

Item Description
-a Attribute Specifies the name of the attribute in the virtual printer definition file to format or edit. This flag may be specified many times.
-d QueueDeviceName Specifies the QueueDeviceName spooler of the virtual printer definition to format or edit.
-o Action Specifies the action that the pioattred command should take on the virtual printer definition. If this flag is omitted, the pioattred command assumes a value of 0 (zero).
0
Format the attributes specified. The result goes to stdout.
1
Format and edit the attribute(s) specified; use the editor specified in the VISUAL environment variable. If no editor is specified in the VISUAL environment variable, use the vi editor. If an error is made in editing the attributes, save the erroneous attributes in a temporary file, and return a return code indicating an error.

The following values are used in the event that an error return code was returned after editing the attributes.

2
Edit the attributes again. The virtual printer definition will be the state it was left in when the error occurred.
3
Ignore the error and save the edited attributes in the virtual printer definition.
4
Clean up and leave things in the state they were before the pioattred command was started.
-q PrintQueueName Specifies the PrintQueueName spooler of the virtual printer definition to format or edit.

Examples

  1. To format the ci and sh attributes in the queue: quedev virtual printer definition, enter:
    pioattred -q queue -d quedev -o 0 -a ci -a sh
    OR
    pioattred -q queue -d quedev -a ci -a sh
  2. To format all attributes in the queue: quedev virtual printer definition, enter:
    pioattred -q queue -d quedev -o 0
    OR
    pioattred -q queue -d quedev
  3. To edit the st attribute in the queue: quedev virtual printer definition, enter:
    pioattred -q queue -d quedev -o 1 -a st

Files

Item Description
/usr/sbin/pioattred Contains the pioattred command.