klpinfo(1) - Linux man page

Name

klpinfo - Get short printer status using SNMP

Synopsis

klpinfo [<options>]

Description

The program prints a short printer status message. It uses SNMP to retrieve the printer status, the OIDs ''HOST-RESOURCES-MIB::hrDeviceStatus'' and ''HOST-RESOURCES-MIB::hrPrinterStatus'' are retrieved. No snmpyalc.cfg file is needed but in yanolc.cfg we need an ''snmp'' entry for the print queue to find host, SNMP version and SNMP community. A dummy SNMP type name can be used.

Options

-S server

connects to the specified print server host. The server can be specified either by hostname or IP address. If this option is not used and there is no host name given using the -P option the program tries to find a default print host in the following places:

the " PRINTHOST " environment variable,

the "/yalc/print-host" user preference

the "/print-host" registry entry in HKCU/Software/DKrause/Yalc

the "/yalc/print-host" system preference

the "/print-host" registry entry in HKLM/Software/DKrause/Yalc

Alternative option: -H server

Long option: --server=server

-P printer

chooses a print queue. The print queue can be specified as alias, or using queue@host or host%port.

If the -P option is not used the program searches for a printer name in the following places:

the " NGPRINTER ", " NPRINTER ", " LPDEST " and " PRINTER " environment variables,

the "/yalc/default-printer" user preference,

the "/default-printer" registry entry in HKCU/Software/DKrause/Yanolc,

the "/yalc/default-printer" system preference,

the "/default-printer" registry entry in HKLM/Software/DKrause/Yanolc.

If the queue name doest not contain a host information, the print server host information is retrieved from the -S option.

Long option: --printer=printer

-C community

specifies the SNMP community name.

Long option: --community=community

-V protocol

specifies the SNMP protocol, ''1'', ''2'', ''2c'', ''2p'' or ''3''.

Long option: --version=protocol

-i

sets exit status code to 0, no matter if there was an error.

Long option: --ignore-exit-code

-s

enforces silent run (no error messages or warnings shown).

Long option: --silently

-f

forces output. If no status is found, print ''-'' to have at least some non-whitespace in output.

Long option: --force

-l

write device and printer status too.

Long option: --long-output

Return Value

The program returns exit status code 0 on success, any other value indicates an error.

Files

yanolc.conf

see yanolc(1).

See Also

yanolc(1), http://dktools.sourceforge.net/yanolc.html

Author

Dirk Krause

Copyright And License

Copyright © 2001-2008, Dirk Krause All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above
  copyright notice, this list of conditions and the
  following disclaimer.

* Redistributions in binary form must reproduce the above
  copyright notice, this list of conditions and the following
  disclaimer in the documentation and/or other materials
  provided with the distribution.

* Neither the name of the Dirk Krause nor the names of
  contributors may be used to endorse or promote products
  derived from this software without specific prior written
  permission.