GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::CUPS (3)

.ds Aq ’

NAME

Net::CUPS - Common Unix Printing System Interface

CONTENTS

SYNOPSIS



  use Net::CUPS;

  my $cups = Net::CUPS->new();

  my $printer = $cups->getDestination( "lj4200dn" );



DESCRIPTION

Net::CUPS is an object oriented interface to the Common Unix Printing System.

METHODS

<B>getDestinationB> my $printer = $cups->getDestination( $printer_name );

This method takes the name of the printer to acquire. If the printer does not exist it will return nothing.

<B>getDestinationsB> my @printers = $cups->getDestinations();

This method will return an array of destinations currently configured on the cups server.

<B>getPasswordB> my $password = $cups->getPassword( $prompt );

Method to retrieve the password from the user via the password callback.

<B>getPPDB> my $ppd = $cups->getPPD( $name );

Returns a Net::CUPS::PPD object for the default printer or for the specified printer or class.

<B>getPPDMakesB> my $makes = $cups->getPPDMakes();

Returns an arrary of scalers holding the names of all the makers (e.g. HP or Lexmark) of PPD files installed on the CUPS server

<B>getAllPPDsB> my $ppds = $cups->getAllPPDs();

Returns an array of scalers with the maker and model of all the PPDs installed on the CUPS server

<B>getPPDFileNameB> $cups->getPPDFileName($ppd_name_and_make);

Returns the file name of the PPD specified by the name and make as found in the array returned by getAllPPDs. The file name is used by addDestination and is relative to where the CUPS server is instructed to look (e.g /usr/share/ppd).

<B>getServerB> my $server_name = $cups->getServer();

A method to return either the hostname or the IP address of the active print server.

<B>getUsernameB> my $username = $cups->getUsername();

This method will return the current username associated with the CUPS transaction.

<B>requestDataB> my $result = $cups->requestData( $request, $resource, $filename );

Send an IPP request to the server. This function is based off the C CUPS function cupsDoRequest and cupsDoRequestFile. The $filename is optional.

<B>setPasswordCBB> $cups->setPasswordCB( $function )

Method to set the callback function to be used by getPassword.

<B>setServerB> $cups->setServer( $server_ip );

This method will change the current cups server to another hosts.

<B>setUsernameB> $cups->setUsername( $username );

A method to change the username associated with CUPS interaction.

<B>deleteDestinationB> $cups->deleteDestination( $destination_name );

A method to delete an existing destination

<B>addDestinationB> $cups->addDestination( $name, $location, $printer_info, $ppd_name, $device_uri) A method to create a new destination. The $ppd_name variable should be the one returned for that printer by the getPPDFileName method. It will be relative to where the CUPS server is configured to look for PPD files (e.g. /usr/share/ppd).

SEE ALSO

Net::CUPS::Destination, Net::CUPS::PPD, Net::CUPS::IPP

SUPPORT

Support for this module and other software developed by Dracken Technology, Inc can be found at http://www.dracken.com/.

AUTHOR

Dracken Technology, Inc. (http://www.dracken.com/)

ACKNOWLEDGEMENTS

Aike Reyer <aike@users.sourceforge.net> supplied the password handling code.

Mark Gannon <mark@truenorth.nu> supplied the code for PPD acquisition, destination creation and destination deletion.

COPYRIGHT AND LICENSE

Copyright (c) 2003-2005 David Hageman

Copyright (c) 2006-2009 Dracken Technology, Inc.

All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

CUPS, the Common UNIX Printing System, the CUPS logo, and ESP Print Pro are the trademark property of Easy Software Products.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::CUPS (3) 2009-08-19

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.