NPADMIN(1)NPADMIN(1)NAMEnpadmin - examine network printer information
SYNOPSISnpadmin [-c community] [-n port] [-t timeout] [--version] [--name]
[--vendor] [--model] [--contact] [--netconfig] [--printmib] [--hostmib]
[--memory] [--storage] [--mediapath] [--maxpapersize] [--enginespeed]
[--duplex] [--minpapersize] [--inputtray] [--tabloid] [--a4] [--b4]
[--executive] [--a3] [--b5] [--letter] [--legal] [--protocol]
[--appletalk] [--lpd] [--netware] [--port9100] [--languages] [--pjl]
[--hpgl] [--psprinter] [--autolang] [--pcl] [--postscript] [--marker]
[--pagecount] [--colors] [--resolution] [--minmargin] [--supplies]
[--alerts] [--display] [--covers] [--status] [--community community ]
[--debugsnmp] [--help] [--timeout timeout] printerspec...
DESCRIPTIONnpadmin is a utility to request information from a network connected
printer.
PRINTERSPECS
npadmin can accept any reasonable number of printer specification on
the command line. A printer specification can be any one of the follow‐
ing:
hostname
The printer name or IP address e.g. scv-doc or 10.10.10.10
network/subnetmask
e.g. 10.10.10.0/255.255.255.0 or 10.10.10.0/24
IP address range
e.g. 10.10.10.10-20
If you need to specify different community names for a different
printerspecs then surround them with parenthesis
171.68.205.0/24(private) otherwise the program will use whatever
is specified by the -c option or the defualt community name of
"public".
OPERATIONAL OPTIONS
These options affect the way that the program opperates. They can be
used with any other options.
-c community, --community community
Specify the comunity name
-t timeout, --timeout timeout
Specify the amount of time to wait for a response before assum‐
ing that there is no respones.
--debugsnmp
Logs the snmp packets sent and received to a file called snm‐
plog.xxx.
--version
Print out the version of npadmin and then stop.
--help Print out some help information.
--name This option puts either the name you supplied on the command
line or the ip address of the device you are communicating with,
in front of every line that that is printed out. This option
gets turned on automatically when you have more than 2 printers
specified on the command line. This is so that scripts can fig‐
ure out whose data is whose.
SINGLE LINE OPTIONS
These options output a series of values on one line. They can be mixed
freely.
--vendor
Print out the vendor that made the printer. Returns: vendor
--model
Print out the model of the printer. Returns: model
--contact
Print out the contact information for the printer. This includes
both the contact person and the location of the printer.
Returns: contact, location
--netconfig
Print out the network configuation of the printer. Returns:
ipaddr, hwaddr, gateway, netmask
--printmib
Print out whether this printer support the printer mib RFC 1759.
Returns: printmib
--hostmib
Print out whether this printer support the host mib RFC 1514.
Returns: hostmib
--memory
Print out the amount of memory the printer has installed in it.
Returns: memsize
--maxpapersize
Print out the maximum paper size for the printer. -2 means that
the printer does not know. Returns: maxMediaUnit, maxMediaFeed‐
Dir, maxMediaXFeedDir
--enginespeed
Print out the engine speed for the printer. Note: This number
can be rather decieving, beware. Some vendors report it in
sheets and others report it in impressions. Impressions are the
number of sides a printer prints whereas sheets are double sided
sheets of paper. The tricky part with this is that engine speed
is really based upon the rate at which paper is moved past the
various componants. So if you are printing on a different size
of paper than what the vendor was thinking of when they calcu‐
lated this number, you will not get the same speed as they
report. Also impressions can be rather decieving because to
print both sides of a peice of paper, the printer has to have a
short time where the marker mechanism is not in use. This leads
to a slowdown which means that if you are printing duplex you
will not be able to attain the maximum engine speed. Probably
the most honest measurement is also the least useful for compar‐
ison and that is something like inches per minute or meters per
minute. Returns: maxSpeedUnit, maxSpeed
--duplex
Print out whether this printer does duplex printing. Returns:
duplex
--status
Print out the status of the printer. Returns: status
--minpapersize
Print out the minimum paper size for the printer. -2 means that
the printer does not know. Returns: minMediaUnit,minMediaFeed‐
Dir,minMediaXFeedDir
--appletalk
Print out whether the printer supports appletalk. Returns:
appletalk
--lpd Print out whether the printer supports lpd. Returns: lpd
--netware
Print out whether the printer supports netware. Note: This is
keyed off of the netware print server channel type. There is
also a netware printer channel type but I have yet to find a
printer vendor that uses it. Returns: netware
--port9100
Print out whether the printer supports port 9100 connections.
Note: The people doing RFC 1759 depricated this channel type and
replaced it with a new channel type which is called bidirec‐
tional TCP. The thing is that a printer might have a bidirec‐
tional TCP port that is not on port 9100 and it would set this
flag to true. This option will return true if there is any one
of three channel types are specified, AppSocket (for Tektronix
on port 9100), port 9100, or bidirectional TCP. Returns
port9100
--pjl Print out whether the printer supports pjl. Returns: pjl
--hpgl Print out whether the printer supports hpgl. Returns: hpgl
--autolang
Print out whether the printer can do auto language detection.
Note: Quite a few printer vendors don't have a row in the inter‐
preter table to indicate this feature although they support it.
Returns: autolang
--pcl Print out whether the printer supports pcl. Returns: pcl
--postscript
Print out whether the printer supports PostScript Returns: post‐
script
--marker
Print out the complete marker table. Note: Even though this is
truly a multiline option, I have never come across a printer
with more than one marker in it, so this can probably be used as
a single line option safely. Returns: markerTechnology, coun‐
terUnits, lifeCount, processColorants, addessabiityUnit,
addressabilityFeedDir, addressabilityXFeedDir, northMargin,
southMargin, eastMargin, westMargin, status.
--pagecount
Print out the pagecount for each marker that a printer has. (I
have never seen a printer that has more than one marker and so
you can essentially use this as a single item.) Returns: coun‐
terUnits, pagecount
--colors
Print out the number of process colorants that a printer has. (I
thought this field would be more useful than it is. It basically
states how many different colors of stuff (toner, wax, ink what‐
ever) the marker uses to print its output. Returns: processCol‐
orants
--resolution
Print out the resolution that the marker can address. -2 means
that the printer doesn't know. Returns: addressabilityUnit,
addressabilityFeedDir, addressabilityXFeedDir
--minmargin
Print out the minimum distance from the edge of the paper that
the printer is willing to print. -2 means the printer doesn't
know. Returns: addressabilityUnit, northMargin, southMargin,
eastMargin, westMargin
--cfgsrc
Print out how the printer was configured. Returns: cfgsrc Note:
This currently only works on HP's.
MULTILINE OPTIONS
These options return tables that can potentially have multiple lines in
them. These tables are expected to be parsed line by line. It is not
reccomended that you mix these options with either single line options
or with each other.
--storage
Print out the complete storage table for the printer. Returns:
desc, allocunits, size, used, allocfail
--mediapath
Print out the complete media path table for the printer.
Returns: maxSpeedPrintUnit, mediaSizeUnit, maxSpeed, maxMedi‐
aFeedDir, maxMediaXFeedDir, minMediaFeedDir, minMediaXFeedDir,
type, status
--inputtray
Print out the complete inputtray table. -2 means that the
printer doesn't know. -3 means that there is enough paper in
that try to print at least one more page. Note: The accuracy
with which they measure the amount of paper in the paper trays
is not very good and the way they report back the amount of
paper in a tray is rather suspect. On some printers a paper tray
with some paper in it but not very much might report 0 for the
current level and an error in the status rather than reporting
-3 and an ok. Also they might report that a tray is completly
full when there is much less paper in it. Returns: type, dimU‐
nit, dimFeedDir, dimXFeedDir, capUnit, maxCap, curLevel, status,
mediaName, name, description
--protocol
Print out the channel table. This is basically all the ways that
you can communicate with a printer. It includes not only the
protocols but things like serial ports and IrDA ports. Returns:
type, version, currentJobControlLang, defaultPageDescLang,
state, status
--languages
Print out the complete interpreter table. Returns: langFamily,
langLevel, langVersion, description, version, orientation,
feedAddressability, xFeedAddressability, twoWay
--supplies
Print out the complete marker supplies table. -2 means the
printer doesn't know. -3 means the printer has enough to print
one more page. Note: Unfortunately most printer vendors (even
the ones that provide gas guages for their web based tools) do
not fill in these objects very carefully. Returns: class, type,
desc, supplyunit, maxcap, level
--alerts
Print out the complete alert table. Returns: severityLevel,
trainingLevel, group, groupIndex, location, code, description,
time
--display
Print out what is in the display of the printer. Returns: dis‐
playBufferText
--covers
Print out the complete cover table. Returns: description, sta‐
tus
--reboot
Reboots a printer.
VARIABLE DESCRIPTIONS
vendor A string that represents the company that made the device.
model The model as the printer reports it. Note: This can sometimes
be confusing because some printers don't report exactly what we
think the model is. For example all HP 5si's return LaserJet 5si
no matter if it is a plain 5si, a mopier or a 5si MX.
contact
The textual identification of the contact person for this man‐
aged node, together with information on how to contact this per‐
son. If no contact information is known, the value is the zero-
length string.
location
The physical location of this node (e.g., `telephone closet, 3rd
floor'). If the location is unknown, the value is the zero-
length string.
ipaddr The IP address of the printer.
hwaddr The ethernet address of that network card.
gateway
The default gateway of the printer.
netmask
The netmask for this printer's IP address.
printmib
Set to 'Y' if the printer supports the printer mib RFC 1759 and
'N' if the printer doesn't.
hostmib
Set to 'Y' if the printer supports the host mib RFC 1514 and 'N'
if it doesn't.
memsize
The number of K the printer has installed in it.
desc Used in several tables to indicate the description.
allocunits
The size, in bytes, of the data objects allocated from this
pool. If this entry is monitoring sectors, blocks, buffers, or
packets, for example, this number will commonly be greater than
one. Otherwise this number will typically be one.
size The size of the storage represented by this entry, in units of
allocunits.
used The amount of the storage represented by this entry that is
allocated, in units of allocunits.
allocfail
The number of requests for storage represented by this entry
that could not be honored due to not enough storage.
maxSpeedPrintUnit
The unit of measure used in specifying the speed of all media
paths in the printer. This can be any one of the following: ten‐
ThousandthsOfInchesPerHour(3), micrometersPerHour(4), charac‐
tersPerHour(5), linesPerHour(6), impressionsPerHour(7),
sheetsPerHour(8), dotRowPerHour(9), feetPerHour(16), metersPer‐
Hour(17)
mediaSizeUnit
The units of measure of media size for use in calculating and
relaying dimensional values for all media paths in the printer.
Can be either one of the following: tenThousandthsOfInches(3),
micrometers(4)
maxSpeed
The maximum printing speed of this media path expressed in prt‐
MediaPathMaxSpeedUnit's. A value of (-1) implies 'other'.
maxMediaFeedDir
The maximum physical media size in the feed direction of this
media path expressed in units of measure specified by mediaSize‐
Unit. A value of (-1) implies 'unlimited'. A value of (-2)
implies
maxMediaXFeedDir
The maximum physical media size across the feed direction of
this media path expressed in units of measure specified by medi‐
aSizeUnit. A value of (-2) implies 'unknown'.
minMediaFeedDir
The minimum physical media size in the feed direction of this
media path expressed in units of measure specified by mediaSize‐
Unit. A value of (-2) implies 'unknown'.
minMediaXFeedDir
The minimum physical media size across the feed direction of
this media path expressed in units of measure specified by medi‐
aSizeUnit. A value of (-2) implies 'unknown'.
type (as it applies to media path)
The type of the media path for this media path. Can be any one
of the following: other(1), unknown(2), longEdgeBindingDu‐
plex(3), shortEdgeBindingDuplex(4), simplex(5).
status Status is used in a lot of tables and it has several independant
parts.
Availability: Available and Idle, Available and Standby, Avail‐
able and Active, Available and Busy, Unavailable and OnRequest,
Unavailable because Broken, Unknown.
Non-Critical: No Non-Critical Alerts (not printed), Non-Critical
Alerts
Critical: No Critical Alerts (not printed), Critical Alerts
On-Line: Intended state is On-Line (not printed), Intended state
is Off-Line
Transitioning: At intended state (not printed), Transitioning to
intended state
duplex Is at least one of the media paths a duplex path.
type (as it applies to inputtray)
The type of technology (discriminated primarily according to
feeder mechanism type) employed by the input sub-unit. Note,
the Optional Input Class provides for a descriptor field to fur‐
ther qualify the other choice. Can be any one of the following:
other(1), unknown(2), sheetFeedAutoRemovableTray(3), sheet‐
FeedAutoNonRemovableTray(4), sheetFeedManual(5), continuous‐
Roll(6), continuousFanFold(7)
dimUnit
The unit of measurement for use calculating and relaying dimen‐
sional values for this input sub-unit. Can be either one of the
following: tenThousandthsOfInches(3), micrometers(4)
dimFeedDir
This object provides the value of the declared dimension, in the
feed direction, of the media that is (or, if empty, was or will
be) in this input sub-unit. The feed direction is the direction
in which the media is fed on this sub-unit. This dimension is
measured in input sub-unit dimensional units (dimUnit). The
value (-1) means other and specifically means that this sub-unit
places no restriction on this parameter. The value (-2) indi‐
cates unknown.
dimXFeedDir
This object provides the value of the declared dimension, in the
cross feed direction, of the media that is (or, if empty, was or
will be) in this input sub-unit. The cross feed direction is
ninety degrees relative to the feed direction associated with
this sub-unit. This dimension is measured in input sub-unit
dimensional units (dimUnit). The value (-1) means other and
specifically means that this sub-unit places no restriction on
this parameter. The value (-2) indicates unknown.
capUnit
The unit of measurement for use in calculating and relaying
capacity values for this input sub-unit. Can be any one of the
following: tenThousandthsOfInches(3), micrometers(4), sheets(8),
feet(16), meters(17)
maxCap The maximum capacity of the input sub-unit in input sub-unit
capacity units (CapacityUnit). There is no convention associ‐
ated with the media itself so this value reflects claimed capac‐
ity. The value (-1) means other and specifically indicates that
the sub-unit places no restrictions on this parameter. The
value (-2) means unknown.
curLevel
The current capacity of the input sub-unit in input sub-unit
capacity units (CapacityUnit). The value (-1) means other and
specifically indicates that the sub-unit places no restrictions
on this parameter. The value (-2) means unknown. The value (-3)
means that the printer knows that at least one unit remains.
mediaName
A description of the media contained in this input sub-unit;
This description is intended for display to a human operator.
This description is not processed by the printer. It is used to
provide information not expressible in terms of the other media
attributes (e.g. dimFeedDir, dimXFeedDir, type). An example
would be `legal tender bond paper'.
name (as it applies to inputtray)
The name assigned to this input sub-unit.
description
A free-form text description of this input sub-unit in the cur‐
rent localization.
type (as it applies to protocol)
The type of this print data channel. This object provides the
linkage to ChannelType-specific groups that may (conceptually)
extend the prtChannelTable with additional details about that
channel. The type can be any one of the following: other(1),
SerialPort(3), ParallelPort(4), IEEE1284Port(5), SCSIPort(6),
AppleTalkPAP(7), LPDServer(8), NetwareRPrinter(9), Net‐
warePServer(10), Port9100(11), AppSocket(12), FTP(13), TFTP(14),
DLCLLCPort(15), IBM3270(16), IBM5250(17), Fax(18), IEEE1394(19),
Transport1(20), CPAP(21), PCPrint(26), ServerMessageBlock(27),
PSM(28), SystemObjectManager(31), DECLAT(32), NPAP(33), USB(34),
IRDA(35), PrintXange(36), PortTCP(37), BidirPortTCP(38),
UNPP(39), AppleTalkADSP(40), PortSPX(41), PortHTTP(42), NDPS(43)
currentJobControlLang
The name of this protocol's current job control language.
defaultPageDescLang
The name of this protocol's current page description language.
state The state of this print job delivery channel. The value indi‐
cates whether control information and print data is allowed
through this channel. The state can be any one of the following:
other(1), printDataAccepted(3), noDataAccepted(4)
appletalk
lpd
netware
port9100
langFamily
This enumeration indicates the type of interpreter that is
receiving jobs. It can be any one of the following values:
other(1), unknown(2), PCL(3), HPGL(4), PJL(5), PS(6), IPDS(7),
PPDS(8), EscapeP(9), Epson(10), DDIF(11), Interpress(12),
ISO6429(13), LineData(14), MODCA(15), REGIS(16), SCS(17),
SPDL(18), TEK4014(19), PDS(20), IGP(21), CodeV(22), DSCDSE(23),
WPS(24), LN03(25), CCITT(26), QUIC(27), CPAP(28), DecPPL(29),
SimpleText(30), NPAP(31), DOC(32), imPress(33), Pinwriter(34),
NPDL(35), NEC201PL(36), Automatic(37), Pages(38), LIPS(39),
TIFF(40), Diagnostic(41), PSPrinter(42), CaPSL(43), EXCL(44),
LCDS(45), XES(46), PCLXL(47), ART(48), TIPSI(49), Prescribe(50),
LinePrinter(51), IDP(52), XJCL(53), PDF(54), RPDL(55), Interme‐
cIPL(56), UBIFingerprint(57), UBIDirectProtocol(58)
orientation
A generic representation for printing orientation on a ´page´.
It can be one of the following: other(1), portrait(3), land‐
scape(4)
twoWay Indicates whether or not this interpreter returns information
back to the host.
pjl ´Y´ if the printer supports pjl, ´N´ if it doesn't.
hpgl ´Y´ if the printer supports pjl, ´N´ if it doesn't.
psprinter
´Y´ if the printer supports psprinter, ´N´ if it doesn't.
autolang
´Y´ if the printer supports autolang, ´N´ if it doesn't.
pcl ´Y´ if the printer supports pcl, ´N´ if it doesn't.
postscript
´Y´ if the printer supports postscript, ´N´ if it doesn't.
markerTechnology
The type of marking technology used for this marking sub-unit.
This can be any one of the following: other(1), unknown(2),
electrophotographicLED(3), electrophotographicLaser(4), elec‐
trophotographicOther(5), impactMovingHeadDotMatrix9pin(6),
impactMovingHeadDotMatrix24pin(7), impactMovingHeadDotMa‐
trixOther(8), impactMovingHeadFullyFormed(9), impactBand(10),
impactOther(11), inkjetAqueous(12), inkjetSolid(13), inkje‐
tOther(14), pen(15), thermalTransfer(16), thermalSensitive(17),
thermalDiffusion(18), thermalOther(19), electroerosion(20),
electrostatic(21), photographicMicrofiche(22), photographicIm‐
agesetter(23), photographicOther(24), ionDeposition(25),
eBeam(26), typesetter(27)
counterUnits
The unit that will be used by the printer when reporting counter
values for this marking sub-unit. The time units of measure are
provided for a device like a strip recorder that does not or
cannot track the physical dimensions of the media and does not
use characters, lines or sheets. This can be any one of the fol‐
lowing: tenThousandthsOfInches(3), micrometers(4), charac‐
ters(5), lines(6), impressions(7), sheets(8), dotRow(9),
hours(11), feet(16), meters(17)
lifeCount
The count of the number of units of measure counted during the
life of printer using units of measure as specified by coun‐
terUnit.
proccessColorants
The number of process colors supported by this marker. A process
color of 1 implies monochrome. The value of processColorants
must be 0 or greater.
addressabilityUnit
The units that the addressability is measured in. This can be
either tenThousandthsOfInches(3), micrometers(4)
addressabilityFeedDir
The maximum number of addressable marking positions in the feed
direction per 10000 units of measure specified by addressabili‐
tyUnit. A value of (-1) implies "other" or "infinite" while a
value of (-2) implies "unknown".
addressabilityXFeedDir
The maximum number of addressable marking positions in the cross
feed direction in 10000 units of measure specified by prtMarker‐
AddressabilityUnit. A value of (-1) implies "other" or "infi‐
nite" while a value of (-2) implies "unknown".
northMargin
The margin, in units identified by addressabilityUnit, from the
leading edge of the medium as the medium flows through the mark‐
ing engine with the side to be imaged facing the observer. The
leading edge is the North edge and the other edges are defined
by the normal compass layout of directions with the compass fac‐
ing the observer. Printing within the area bounded by all four
margins is guaranteed for all interpreters. The value (-2)
means unknown.
southMargin
The margin from the South edge (see prtMarkerNorthMargin) of the
medium in units identified by prtMarkerAddressabilityUnit.
Printing within the area bounded by all four margins is guaran‐
teed for all interpreters. The value (-2) means unknown.
eastMargin
The margin from the East edge (see prtMarkerNorthMargin) of the
medium in units identified by prtMarkerAddressabilityUnit.
Printing within the area bounded by all four margins is guaran‐
teed for all interpreters. The value (-2) means unknown.
westMargin
The margin from the West edge (see prtMarkerNorthMargin) of the
medium in units identified by prtMarkerAddressabilityUnit.
Printing within the area bounded by all four margins is guaran‐
teed for all interpreters. The value (-2) means unknown.
pagecount
The count of the number of units of measure counted during the
life of printer using units of measure as specified by coun‐
terUnit.
class Indicates whether this supply entity represents a supply that is
consumed or a receptacle that is filled. This can be any one of
the following: other(1),supplyThatIsConsumed(3), receptacleThat‐
IsFilled(4)
type (as it applies to marker supplies)
The type of this supply. This can be any one of the following:
other(1), unknown(2), toner(3), wasteToner(4), ink(5), inkCar‐
tridge(6), inkRibbon(7), wasteInk(8), opc(9), developer(10),
fuserOil(11), solidWax(12), ribbonWax(13), wasteWax(14),
fuser(15), coronaWire(16), fuserOilWick(17), cleanerUnit(18),
fuserCleaningPad(19), transferUnit(20), tonerCartridge(21),
fuserOiler(22)
supplyUnit
Unit of measure of this marker supply container/receptacle. This
can be any one of the following: tenThousandthsOfInches(3),
micrometers(4), impressions(7), sheets(8), thousandthsO‐
fOunces(12), hours(11), tenthsOfGrams(13), hundrethsOfFlu‐
idOunces(14), tenthsOfMilliliters(15), feet(16), meters(17)
maxcap The maximum capacity of this supply container/receptacle
expressed in prtMarkerSuppliesSupplyUnit. If this supply con‐
tainer/receptacle can reliably sense this value, the value is
reported by the printer and is read-only; otherwise, the value
may be written (by a Remote Control Panel or a Management Appli‐
cation). The value (-1) means other and specifically indicates
that the sub-unit places no restrictions on this parameter. The
value (-2) means unknown.
level The current level if this supply is a container; remaining space
if this supply is a receptacle. If this supply container/recep‐
tacle can reliably sense this value, the value is reported by
the printer and is read- only; otherwise, the value may be writ‐
ten (by a Remote Control Panel or a Management Application). The
value (- 1) means other and specifically indicates that the sub-
unit places no restrictions on this parameter. The value (-2)
means unknown. A value of (-3) means that the printer knows
that there is some supply/remaining space, respectively.
severityLevel
The level of severity of this alert table entry. The printer
determines the severity level assigned to each entry into the
table. It can be any one of the following: other(1), criticalBi‐
naryChangeEvent(3), warningUnaryChangeEvent(4), warningBina‐
ryChangeEvent(5)
trainingLevel
The level of training required to handle this alert, if human
intervention is required. The noInterventionRequired value
should be used if the event does not require any human interven‐
tion. The training level is an enumeration that is determined
and assigned by the printer manufacturer based on the informa‐
tion or the training required to handle this alert. The printer
will break alerts into these different training levels. It is
the responsibility of the management application in the system
to determine how a particular alert is handled and how and to
whom that alert is routed. This value can be any one of the
following: other(1), unknown(2), untrained(3), trained(4),
fieldService(5), management(6), noInterventionRequired(7)
The following are the four training levels of alerts:
FieldService: Alerts that typically require advanced training
and technical knowledge of the printer and its sub-units. An
example of a technical person would be a manufacturer's Field
Service representative, or other person formally trained by the
manufacturer or similar representative.
Trained: Alerts that require an intermediate or moderate level
of knowledge of the printer and its sub-units. A typical exam‐
ples of alerts that a trained operator can handle is replacing
toner cartridges.
Untrained: Alerts that can be fixed without prior training
either because the action to correct the alert is obvious or the
printer can help the untrained person fix the problem. A typical
example of such an alert is reloading paper trays and emptying
output bins on a low end printer.
Management: Alerts that have to do with overall operation of and
configuration of the printer. Examples of management events are
configuration change of sub-units.
group The type of sub-unit within the printer model that this alert is
related. Input, output, and markers are examples of printer
model groups, i.e., examples of types of sub-units. Wherever
possible, these enumerations match the sub-identifier that iden‐
tifies the relevant table in the printmib. It can be any one of
the following: other(1), hostResourcesMIBStorageTable(3),
hostResourcesMIBDeviceTable(4), generalPrinter(5), cover(6),
localization(7), input(8), output(9), marker(10), markerSup‐
plies(11), markerColorant(12), mediaPath(13), channel(14),
interpreter(15), consoleDisplayBuffer(16), consoleLights(17),
alert(18) Note: If also has the possibility of being a a value
of 30 and greater and are for use in other MIBs that augment
tables in the Printer MIB. Therefore, other MIBs may assign
alert codes of 30 or higher to use the alert table from the
Printer MIB without requiring revising and re-publishing this
document.
groupIndex
An index of the row within the principle table in the group
identified by prtAlertGroup that represents the sub-unit of the
printer that caused this alert. The combination of the
prtAlertGroup and the prtAlertGroupIndex defines exactly which
printer sub- unit caused the alert; for example, Input #3, Out‐
put #2, and Marker #1. Every object in this MIB is indexed with
hrDeviceIndex and optionally, another index variable. If this
other index variable is present in the table that generated the
alert, it will be used as the value for this object. Otherwise,
this value shall be -1.
location
The sub-unit location that is defined by the printer manufac‐
turer to further refine the location of this alert within the
designated sub-unit. The location is used in conjunction with
the Group and GroupIndex values; for example, there is an alert
in Input #2 at location number 7. The value (-2) indicates
unknown.
code The code that describes the type of alert for this entry in the
table. It can be any one of the following values: other(1),
unknown(2), coverOpened(3), coverClosed(4), interlockOpened(5),
interlockClosed(6), configurationChanged(7), jammed(8), subunit‐
Missing(9), subunitLifeAlmostOver(10), subunitLifeOver(11), sub‐
unitAlmostEmpty(12), subunitEmpty(13), subunitAlmostFull(14),
subunitFull(15), subunitNearLimit(16), subunitAtLimit(17), sub‐
unitOpened(18), subunitClosed(19), subunitTurnedOn(20), subunit‐
TurnedOff(21), subunitOffline(22), subunitPowerSaver(23), sub‐
unitWarmingUp(24), subunitAdded(25), subunitRemoved(26), subuni‐
tResourceAdded(27), subunitResourceRemoved(28), subunitRecover‐
ableFailure(29), subunitUnrecoverableFailure(30), subunitRecov‐
erableStorageError(31), subunitUnrecoverableStorageError(32),
subunitMotorFailure(33), subunitMemoryExhausted(34), subunitUn‐
derTemperature(35), subunitOverTemperature(36), subunitTiming‐
Failure(37), subunitThermistorFailure(38), doorOpen(501), door‐
Closed(502), poweredUp(503), poweredDown(504), printerNMSRe‐
set(505), printerManualReset(506), printerReadyToPrint(507),
inputMediaTrayMissing(801), inputMediaSizeChanged(802), input‐
MediaWeightChanged(803), inputMediaTypeChanged(804), inputMedia‐
ColorChanged(805), inputMediaFormPartsChange(806), inputMedia‐
SupplyLow(807), inputMediaSupplyEmpty(808), inputMediaChang‐
eRequest(809), inputManualInputRequest(810), inputTrayPosition‐
Failure(811), inputTrayElevationFailure(812), inputCannotFeed‐
SizeSelected(813), outputMediaTrayMissing(901), outputMediaTray‐
AlmostFull(902), outputMediaTrayFull(903), outputMailboxSelect‐
Failure(904), markerFuserUnderTemperature(1001), marker‐
FuserOverTemperature(1002), markerFuserTimingFailure(1003),
markerFuserThermistorFailure(1004), markerAdjustingPrintQual‐
ity(1005), markerTonerEmpty(1101), markerInkEmpty(1102), marker‐
PrintRibbonEmpty(1103), markerTonerAlmostEmpty(1104), mark‐
erInkAlmostEmpty(1105), markerPrintRibbonAlmostEmpty(1106),
markerWasteTonerReceptacleAlmostFull(1107), markerWasteInkRecep‐
tacleAlmostFull(1108), markerWasteTonerReceptacleFull(1109),
markerWasteInkReceptacleFull(1110), markerOpcLifeAl‐
mostOver(1111), markerOpcLifeOver(1112), markerDeveloperAl‐
mostEmpty(1113), markerDeveloperEmpty(1114), markerTonerCar‐
tridgeMissing(1115), mediaPathMediaTrayMissing(1301), mediaPath‐
MediaTrayAlmostFull(1302), mediaPathMediaTrayFull(1303), inter‐
preterMemoryIncreased(1501), interpreterMemoryDecreased(1502),
interpreterCartridgeAdded(1503), interpreterCar‐
tridgeDeleted(1504), interpreterResourceAdded(1505), inter‐
preterResourceDeleted(1506), interpreterResourceUnavail‐
able(1507), interpreterComplexPageEncountered(1509),
alertRemovalOfBinaryChangeEntry(1801)
displayBufferText
The text on that line of the display
description (as it applies to alerts)
A description of this alert entry. The description is provided
by the printer to further elaborate on the enumerated alert or
provide information in the case where the code is classified as
'other' or 'unknown'. The printer is required to return a
description string but the string may be a null string.
time The value of sysUpTime at the time that this alert was gener‐
ated.
description (as it applies to cover)
status (as it applies to cover)
This can be any one of the following: other(1), coverOpen(3),
coverClosed(4), interlockOpen(5), interlockClosed(6)
cfgsrc This is how the printer obtained its IP address.
EXAMPLE
Here is an example invocation to try to discover all the printers on a
small network.
npadmin--model --timeout 6 144.254.42.0/24 2>/tmp/errorlog
When this is done, you might want to check errrorlog for anything
interesting like printers that npadmin doesn't recognise.
BUGS
Very numerous. This program is still under development. Any place the
program asserts out should be considered a bug and reported to the
developers at ( ben@valinux.com )
The code that parses multiple printers specifications into printer
names is pretty green. It probably can be broken easily. Please come up
with new and interesting ways to break and send them to ben@valinux.com
and I will try to come up with ways to insulate npadmin from your mis‐
cheiviousness.
This program has only been tested extensivly on Linux. If you do a port
to another OS. Please email me.
Many printer types are not supported yet. If you have a printer that is
not supported. Please email the output of the command "snmpwalk print‐
ername public .1" to me.
3rd Berkeley Distribution July 30 1999 NPADMIN(1)
