Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
NPADMIN(1)		     General Commands Manual		      NPADMIN(1)

NAME
     npadmin - examine network printer information

SYNOPSIS
     npadmin  [-c community] [-n port] [-t timeout] [--version] [--name] [--ven-
     dor] [--model] [--contact] [--netconfig] [--printmib]  [--hostmib]  [--mem-
     ory]  [--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 time-
     out] 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 "pub-
	    lic".

   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  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 au-
	    tomatically when you have more than 2 printers specified on the com-
	    mand 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.  Re-
	    turns: hostmib

     --memory
	    Print out the amount of memory the printer has installed in it.  Re-
	    turns: memsize

     --maxpapersize
	    Print out the maximum paper size for the printer. -2 means that  the
	    printer does not know.  Returns: maxMediaUnit, maxMediaFeedDir, max-
	    MediaXFeedDir

     --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 pa-
	    per. 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 use-
	    ful 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: du-
	    plex

     --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,min-
	    MediaXFeedDir

     --appletalk
	    Print out whether the  printer  supports  appletalk.   Returns:  ap-
	    pletalk

     --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 net-
	    ware 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 ta-
	    ble to indicate this feature although they support it.  Returns: au-
	    tolang

     --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, counterUnits, life-
	    Count,  processColorants,  addessabiityUnit,  addressabilityFeedDir,
	    addressabilityXFeedDir,  northMargin, southMargin, eastMargin, west-
	    Margin, 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, addressabil-
	    ityFeedDir, 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.  Re-
	    turns:  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  rec-
     comended 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, maxMe-
	    diaXFeedDir, 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,  ver-
	    sion, currentJobControlLang, defaultPageDescLang, state, status

     --languages
	    Print out the complete interpreter table.  Returns: langFamily, lan-
	    gLevel, langVersion, description, version, orientation, feedAddress-
	    ability, 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,  train-
	    ingLevel, group, groupIndex, location, code, description, time

     --display
	    Print  out what is in the display of the printer.  Returns: display-
	    BufferText

     --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. Other-
	    wise this number will typically be one.

     size   The size of the storage represented by this entry, in units of allo-
	    cunits.

     used   The amount of the storage represented by this entry  that  is  allo-
	    cated, 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: tenThousandth-
	    sOfInchesPerHour(3),   micrometersPerHour(4),  charactersPerHour(5),
	    linesPerHour(6), impressionsPerHour(7), sheetsPerHour(8), dotRowPer-
	    Hour(9), feetPerHour(16), metersPerHour(17)

     mediaSizeUnit
	    The units of measure of media size for use in calculating and relay-
	    ing dimensional values for all media paths in the  printer.  Can  be
	    either  one  of  the  following: tenThousandthsOfInches(3), microme-
	    ters(4)

     maxSpeed
	    The maximum printing speed of this media path expressed in prtMedia-
	    PathMaxSpeedUnit'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,	Unavail-
	    able 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 in-
	    tended 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 restric-
	    tion 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),  me-
	    ters(17)

     maxCap
	    The  maximum capacity of the input sub-unit in input sub-unit capac-
	    ity 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  capac-
	    ity  units	(CapacityUnit).  The value (-1) means other and specifi-
	    cally indicates that the sub-unit places no restrictions on this pa-
	    rameter. 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 de-
	    scription 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 link-
	    age 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),  Par-
	    allelPort(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),	SystemObjectMan-
	    ager(31), DECLAT(32), NPAP(33), USB(34),  IRDA(35),  PrintXange(36),
	    PortTCP(37),  BidirPortTCP(38),  UNPP(39),	AppleTalkADSP(40), Port-
	    SPX(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), print-
	    DataAccepted(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),  un-
	    known(2),  PCL(3),	HPGL(4),  PJL(5),  PS(6),  IPDS(7), PPDS(8), Es-
	    capeP(9), Epson(10), DDIF(11),  Interpress(12),  ISO6429(13),  Line-
	    Data(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), Auto-
	    matic(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), electrophoto-
	    graphicLED(3),    electrophotographicLaser(4),    electrophotograph-
	    icOther(5), impactMovingHeadDotMatrix9pin(6), impactMovingHeadDotMa-
	    trix24pin(7),  impactMovingHeadDotMatrixOther(8),  impactMovingHead-
	    FullyFormed(9),  impactBand(10), impactOther(11), inkjetAqueous(12),
	    inkjetSolid(13),  inkjetOther(14),	 pen(15),   thermalTransfer(16),
	    thermalSensitive(17),  thermalDiffusion(18), thermalOther(19), elec-
	    troerosion(20), electrostatic(21), photographicMicrofiche(22),  pho-
	    tographicImagesetter(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 charac-
	    ters, lines or sheets. This can be any one of the  following:  tenT-
	    housandthsOfInches(3),  micrometers(4), characters(5), lines(6), im-
	    pressions(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  di-
	    rection  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  prtMarkerAd-
	    dressabilityUnit.	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),    receptacleThatIs-
	    Filled(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),  fuserCleaning-
	    Pad(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),	microme-
	    ters(4),	impressions(7),    sheets(8),	thousandthsOfOunces(12),
	    hours(11),	tenthsOfGrams(13),  hundrethsOfFluidOunces(14),   tenth-
	    sOfMilliliters(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  re-
	    strictions 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 Con-
	    trol 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 deter-
	    mines the severity level assigned to each entry into the  table.  It
	    can   be   any   one   of  the  following:	other(1),  criticalBina-
	    ryChangeEvent(3),	   warningUnaryChangeEvent(4),	    warningBina-
	    ryChangeEvent(5)

     trainingLevel
	    The level of training required to handle this alert, if human inter-
	    vention 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 re-
	    quired 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),  un-
	    trained(3),  trained(4), fieldService(5), management(6), noInterven-
	    tionRequired(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 represen-
	    tative, or other person formally trained by the manufacturer or sim-
	    ilar 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  car-
	    tridges.

	    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 con-
	    figuration change of sub-units.

     group  The type of sub-unit within the printer model that this alert is re-
	    lated.  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 rel-
	    evant  table  in  the  printmib. It can be any one of the following:
	    other(1),  hostResourcesMIBStorageTable(3),   hostResourcesMIBDevic-
	    eTable(4),	generalPrinter(5),  cover(6), localization(7), input(8),
	    output(9), marker(10), markerSupplies(11), markerColorant(12), medi-
	    aPath(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  identi-
	    fied  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 option-
	    ally, 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 lo-
	    cation number 7. The value (-2) indicates unknown.

     code   The code that describes the type of alert for this entry in the  ta-
	    ble.  It  can  be  any  one  of  the following values: other(1), un-
	    known(2), coverOpened(3), coverClosed(4), interlockOpened(5), inter-
	    lockClosed(6),  configurationChanged(7),   jammed(8),   subunitMiss-
	    ing(9),  subunitLifeAlmostOver(10),  subunitLifeOver(11), subunitAl-
	    mostEmpty(12),  subunitEmpty(13),  subunitAlmostFull(14),	subunit-
	    Full(15),	 subunitNearLimit(16),	  subunitAtLimit(17),	 subuni-
	    tOpened(18), subunitClosed(19), subunitTurnedOn(20),  subunitTurned-
	    Off(21),  subunitOffline(22),  subunitPowerSaver(23), subunitWarmin-
	    gUp(24),	subunitAdded(25),     subunitRemoved(26),     subunitRe-
	    sourceAdded(27), subunitResourceRemoved(28), subunitRecoverableFail-
	    ure(29),   subunitUnrecoverableFailure(30),  subunitRecoverableStor-
	    ageError(31),  subunitUnrecoverableStorageError(32),   subunitMotor-
	    Failure(33),     subunitMemoryExhausted(34),    subunitUnderTempera-
	    ture(35), subunitOverTemperature(36), subunitTimingFailure(37), sub-
	    unitThermistorFailure(38),	doorOpen(501),	 doorClosed(502),   pow-
	    eredUp(503),  poweredDown(504), printerNMSReset(505), printerManual-
	    Reset(506),  printerReadyToPrint(507),   inputMediaTrayMissing(801),
	    inputMediaSizeChanged(802), inputMediaWeightChanged(803), inputMedi-
	    aTypeChanged(804),	  inputMediaColorChanged(805),	 inputMediaForm-
	    PartsChange(806),	   inputMediaSupplyLow(807),	  inputMediaSup-
	    plyEmpty(808),   inputMediaChangeRequest(809),   inputManualInputRe-
	    quest(810),  inputTrayPositionFailure(811),  inputTrayElevationFail-
	    ure(812),	inputCannotFeedSizeSelected(813),   outputMediaTrayMiss-
	    ing(901), outputMediaTrayAlmostFull(902),  outputMediaTrayFull(903),
	    outputMailboxSelectFailure(904),  markerFuserUnderTemperature(1001),
	    markerFuserOverTemperature(1002),	 markerFuserTimingFailure(1003),
	    markerFuserThermistorFailure(1004),        markerAdjustingPrintQual-
	    ity(1005),	markerTonerEmpty(1101),  markerInkEmpty(1102),	 marker-
	    PrintRibbonEmpty(1103),	 markerTonerAlmostEmpty(1104),	   mark-
	    erInkAlmostEmpty(1105), markerPrintRibbonAlmostEmpty(1106),  marker-
	    WasteTonerReceptacleAlmostFull(1107),    markerWasteInkReceptacleAl-
	    mostFull(1108),    markerWasteTonerReceptacleFull(1109),	 marker-
	    WasteInkReceptacleFull(1110),	  markerOpcLifeAlmostOver(1111),
	    markerOpcLifeOver(1112), markerDeveloperAlmostEmpty(1113), markerDe-
	    veloperEmpty(1114), markerTonerCartridgeMissing(1115),  mediaPathMe-
	    diaTrayMissing(1301), mediaPathMediaTrayAlmostFull(1302), mediaPath-
	    MediaTrayFull(1303),  interpreterMemoryIncreased(1501), interpreter-
	    MemoryDecreased(1502), interpreterCartridgeAdded(1503), interpreter-
	    CartridgeDeleted(1504), interpreterResourceAdded(1505), interpreter-
	    ResourceDeleted(1506), interpreterResourceUnavailable(1507),  inter-
	    preterComplexPageEncountered(1509),    alertRemovalOfBinaryChangeEn-
	    try(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), cover-
	    Closed(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 in-
	  teresting like printers that npadmin doesn't recognise.

BUGS
     Very numerous. This program is still under development. Any place the  pro-
     gram  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.

3rd Berkeley Distribution	  July 30 1999			      NPADMIN(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=npadmin&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help