Resource Type: cups_queue

Defined in:
lib/puppet/type/cups_queue.rb
Providers:
cups

Overview

Installs and manages CUPS queues.

Printers: Minimal manifest examples

  cups_queue { 'MinimalRaw':
    ensure => 'printer',
    uri    => 'lpd://192.168.2.105/binary_p1'
  }

OR

  cups_queue { 'MinimalModel':
    ensure => 'printer',
    model  => 'drv:///sample.drv/generic.ppd',
    uri    => 'lpd://192.168.2.105/binary_p1'
  }

  The command `lpinfo -m` lists all models available on the node.

OR

  cups_queue { 'MinimalPPD':
    ensure => 'printer',
    ppd    => '/usr/share/cups/model/myprinter.ppd',
    uri    => 'lpd://192.168.2.105/binary_p1'
  }

OR

  cups_queue { 'MinimalInterface':
    ensure    => 'printer',
    interface => '/usr/share/cups/model/myprinter.sh',
    uri       => 'lpd://192.168.2.105/binary_p1'
  }

Classes: Providing only the mandatory attributes

cups_queue { 'MinimalClass':
  ensure  => 'class',
  members => ['Office', 'Warehouse']
}

Note that configurable options of a class are those of its first member.

Properties

  • accepting

    Boolean value specifying whether the queue should accept print jobs or reject them.

    Supported values:
    • true
    • false
  • access
  • description

    A short informative description of the queue.

  • enabled

    Boolean value specifying whether the queue should be running or stopped.

    Supported values:
    • true
    • false
  • ensure

    (mandatory) Specifies whether this queue should be a ‘class`, a `printer` or `absent`.

    Supported values:
    • class
    • printer
    • absent
  • held

    A held queue will print all jobs in print or pending, but all new jobs will be held. Setting ‘false` will release them.

    Supported values:
    • true
    • false
  • location

    A short information where to find the hardcopies.

  • make_and_model
  • members
  • options
  • shared (defaults to: false)

    Boolean value specifying whether to share this queue on the network. Default is ‘false`.

    Supported values:
    • true
    • false
  • uri

    (printer-only) The device URI of the printer. Use ‘lpinfo -v` on the node to scan for printer URIs.

Parameters

  • interface
  • model

    (printer-only) A supported printer model. Use ‘lpinfo -m` on the node to list all models available.

  • name (namevar)

    (mandatory) CUPS queue names are case insensitive and may contain any printable character except SPACE, TAB, “/”, or “#”.

  • ppd
  • provider

    The specific backend to use for this ‘cups_queue` resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.