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 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 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 2 printers 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 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, 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 various componants. 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 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 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

--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 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 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, 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 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 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: 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. 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 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 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)

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), 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.

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 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 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 -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), 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), 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 me.