npadmin man page
NPADMIN(1) NPADMIN(1)
NAME
npadmin - examine network printer information
SYNOPSIS
npadmin [-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...
DESCRIPTION
npadmin 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 following:
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 parentheses, 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 operates.
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
July 30 1999 1
NPADMIN(1) NPADMIN(1)
before assuming that there is no respones.
--debugsnmp
Logs the snmp packets sent and received to a file
called snmplog.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 one
printer specified on the command line. This is so
that scripts can figure 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 supports the printer
mib RFC 1759. Returns: printmib
--hostmib
Print out whether this printer supports the host
mib RFC 1514. Returns: hostmib
--memory
Print out the amount of memory the printer has, in
kilobytes. Returns: memsize
--maxpapersize
Print out the maximum paper size for the printer.
July 30 1999 2
NPADMIN(1) NPADMIN(1)
-2 means that the printer does not know. Returns:
maxMediaUnit, maxMediaFeedDir, 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 components of the printer.
So if you are printing on a different size of paper
than what the vendor was thinking of when they
calculated this number, you will not get the same
speed as they report. Also impressions can be
rather deceiving because to print both sides of a
piece 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
comparison, 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,minMediaFeedDir,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
July 30 1999 3
NPADMIN(1) NPADMIN(1)
--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 bidirectional TCP.
The thing is that a printer might have a
bidirectional 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 interpreter 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: postscript
--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, counterUnits, 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: counterUnits,
pagecount
--colors
Print out the number of process colorants that a
July 30 1999 4
NPADMIN(1) NPADMIN(1)
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
whatever) the marker uses to print its output.
Returns: processColorants
--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, maxMediaFeedDir,
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
might report 0 for the current level and an error
in the status rather than reporting -3 and an "OK"
status. Also they might report that a tray is
July 30 1999 5
NPADMIN(1) NPADMIN(1)
completly full when there is much less paper in it.
Returns: type, dimUnit, 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: displayBufferText
--covers
Print out the complete cover table. Returns:
description, status
--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
July 30 1999 6
NPADMIN(1) NPADMIN(1)
matter if it is a plain 5si, a mopier or a 5si MX.
contact
The textual identification of the contact person
for this managed node, together with information on
how to contact this person. 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 size of the printer's memory in kilobytes.
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.
July 30 1999 7
NPADMIN(1) NPADMIN(1)
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: tenThousandthsOfInchesPerHour(3),
micrometersPerHour(4), charactersPerHour(5),
linesPerHour(6), impressionsPerHour(7),
sheetsPerHour(8), dotRowPerHour(9),
feetPerHour(16), metersPerHour(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 prtMediaPathMaxSpeedUnit'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 mediaSizeUnit. 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 mediaSizeUnit. 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 mediaSizeUnit. 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 mediaSizeUnit. 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),
longEdgeBindingDuplex(3),
shortEdgeBindingDuplex(4), simplex(5).
status Status is used in a lot of tables and it has
several independant parts.
July 30 1999 8
NPADMIN(1) NPADMIN(1)
Availability: Available and Idle, Available and
Standby, Available 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 further qualify
the other choice. Can be any one of the following:
other(1), unknown(2),
sheetFeedAutoRemovableTray(3),
sheetFeedAutoNonRemovableTray(4),
sheetFeedManual(5), continuousRoll(6),
continuousFanFold(7)
dimUnit
The unit of measurement for use calculating and
relaying dimensional 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)
indicates 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
July 30 1999 9
NPADMIN(1) NPADMIN(1)
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 associated with the media itself so
this value reflects claimed capacity. 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 current 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
July 30 1999 10
NPADMIN(1) NPADMIN(1)
type can be any one of the following: other(1),
SerialPort(3), ParallelPort(4), IEEE1284Port(5),
SCSIPort(6), AppleTalkPAP(7), LPDServer(8),
NetwareRPrinter(9), NetwarePServer(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 indicates 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), IntermecIPL(56),
UBIFingerprint(57), UBIDirectProtocol(58)
July 30 1999 11
NPADMIN(1) NPADMIN(1)
orientation
A generic representation for printing orientation
on a 'page'. It can be one of the following:
other(1), portrait(3), landscape(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),
electrophotographicOther(5),
impactMovingHeadDotMatrix9pin(6),
impactMovingHeadDotMatrix24pin(7),
impactMovingHeadDotMatrixOther(8),
impactMovingHeadFullyFormed(9), impactBand(10),
impactOther(11), inkjetAqueous(12),
inkjetSolid(13), inkjetOther(14), pen(15),
thermalTransfer(16), thermalSensitive(17),
thermalDiffusion(18), thermalOther(19),
electroerosion(20), electrostatic(21),
photographicMicrofiche(22),
photographicImagesetter(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 following: tenThousandthsOfInches(3),
July 30 1999 12
NPADMIN(1) NPADMIN(1)
micrometers(4), characters(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 counterUnit.
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 addressabilityUnit. 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 prtMarkerAddressabilityUnit.
A value of (-1) implies "other" or "infinite" 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 marking
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 facing 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 guaranteed for all interpreters. The
value (-2) means unknown.
July 30 1999 13
NPADMIN(1) NPADMIN(1)
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
guaranteed 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
guaranteed 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 counterUnit.
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),
receptacleThatIsFilled(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), inkCartridge(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),
thousandthsOfOunces(12), hours(11),
tenthsOfGrams(13), hundrethsOfFluidOunces(14),
tenthsOfMilliliters(15), feet(16), meters(17)
maxcap The maximum capacity of this supply
container/receptacle expressed in
prtMarkerSuppliesSupplyUnit. If this supply
container/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
July 30 1999 14
NPADMIN(1) NPADMIN(1)
Application). 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/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
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),
criticalBinaryChangeEvent(3),
warningUnaryChangeEvent(4),
warningBinaryChangeEvent(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 intervention. The
training level is an enumeration that is determined
and assigned by the printer manufacturer based on
the information 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
July 30 1999 15
NPADMIN(1) NPADMIN(1)
representative.
Trained: Alerts that require an intermediate or
moderate level of knowledge of the printer and its
sub-units. A typical examples 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
identifies 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), markerSupplies(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, Output #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
July 30 1999 16
NPADMIN(1) NPADMIN(1)
-1.
location
The sub-unit location that is defined by the
printer manufacturer 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), subunitMissing(9),
subunitLifeAlmostOver(10), subunitLifeOver(11),
subunitAlmostEmpty(12), subunitEmpty(13),
subunitAlmostFull(14), subunitFull(15),
subunitNearLimit(16), subunitAtLimit(17),
subunitOpened(18), subunitClosed(19),
subunitTurnedOn(20), subunitTurnedOff(21),
subunitOffline(22), subunitPowerSaver(23),
subunitWarmingUp(24), subunitAdded(25),
subunitRemoved(26), subunitResourceAdded(27),
subunitResourceRemoved(28),
subunitRecoverableFailure(29),
subunitUnrecoverableFailure(30),
subunitRecoverableStorageError(31),
subunitUnrecoverableStorageError(32),
subunitMotorFailure(33),
subunitMemoryExhausted(34),
subunitUnderTemperature(35),
subunitOverTemperature(36),
subunitTimingFailure(37),
subunitThermistorFailure(38), doorOpen(501),
doorClosed(502), poweredUp(503), poweredDown(504),
printerNMSReset(505), printerManualReset(506),
printerReadyToPrint(507),
inputMediaTrayMissing(801),
inputMediaSizeChanged(802),
inputMediaWeightChanged(803),
inputMediaTypeChanged(804),
inputMediaColorChanged(805),
inputMediaFormPartsChange(806),
inputMediaSupplyLow(807),
inputMediaSupplyEmpty(808),
inputMediaChangeRequest(809),
inputManualInputRequest(810),
inputTrayPositionFailure(811),
inputTrayElevationFailure(812),
inputCannotFeedSizeSelected(813),
outputMediaTrayMissing(901),
July 30 1999 17
NPADMIN(1) NPADMIN(1)
outputMediaTrayAlmostFull(902),
outputMediaTrayFull(903),
outputMailboxSelectFailure(904),
markerFuserUnderTemperature(1001),
markerFuserOverTemperature(1002),
markerFuserTimingFailure(1003),
markerFuserThermistorFailure(1004),
markerAdjustingPrintQuality(1005),
markerTonerEmpty(1101), markerInkEmpty(1102),
markerPrintRibbonEmpty(1103),
markerTonerAlmostEmpty(1104),
markerInkAlmostEmpty(1105),
markerPrintRibbonAlmostEmpty(1106),
markerWasteTonerReceptacleAlmostFull(1107),
markerWasteInkReceptacleAlmostFull(1108),
markerWasteTonerReceptacleFull(1109),
markerWasteInkReceptacleFull(1110),
markerOpcLifeAlmostOver(1111),
markerOpcLifeOver(1112),
markerDeveloperAlmostEmpty(1113),
markerDeveloperEmpty(1114),
markerTonerCartridgeMissing(1115),
mediaPathMediaTrayMissing(1301),
mediaPathMediaTrayAlmostFull(1302),
mediaPathMediaTrayFull(1303),
interpreterMemoryIncreased(1501),
interpreterMemoryDecreased(1502),
interpreterCartridgeAdded(1503),
interpreterCartridgeDeleted(1504),
interpreterResourceAdded(1505),
interpreterResourceDeleted(1506),
interpreterResourceUnavailable(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 generated.
description (as it applies to cover)
status (as it applies to cover)
This can be any one of the following: other(1),
July 30 1999 18
NPADMIN(1) NPADMIN(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
mischeiviousness.
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 printername public .1" to
ben@valinux.com.
July 30 1999 19
npadmin.1