snmpyalc(1) - Linux man page

Name

snmpyalc - Get printer status

Synopsis

snmpyalc [<option>]

Description

The program retrieves printer status using SNMP . A list of OIDs specified in the snmpyalc.cfg file is requested to find suitable output.

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

-T type

specifies the SNMP type.

-C community

specifies the SNMP community name.

Long option: --community=community

-V protcol

specifies the SNMP protocol version, ''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

runs silently (no error messages or warnings are shown).

Long option: --silently

-f

forces output, at least a ''-'' is printed if we can't find any other output.

Long option: --force

Return Value

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

Files

yanolc.conf

snmpyalc.conf

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.