npadmin home

Documentation
    man page

Bug tracking

FAQ

License

Open Source
Printing

    CEPS
    libppd
    Samba

 


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
 

 

npadmin Copyright © 1998 Cisco Systems.
Copyright © 1999, 2000 Ben Woodard.

npadmin is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 

Web site copyright © 2000 VA Linux Systems.
For mail regarding the web site: Don Marti dmarti@valinux.com
Hosted by Sourceforge