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

FreeBSD Manual Pages

  
 
  

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]
       [--vendor] [--model] [--contact]	[--netconfig] [--printmib] [--hostmib]
       [--memory]  [--storage]	[--mediapath] [--maxpapersize] [--enginespeed]
       [--duplex] [--minpapersize]  [--inputtray]  [--tabloid]	[--a4]	[--b4]
       [--executive]  [--a3]  [--b5]  [--letter] [--legal] [--protocol]	[--ap-
       pletalk]	 [--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 follow-
       ing:

       hostname
	      The printer name or IP address e.g. scv-doc or 10.10.10.10

       network/subnetmask
	      e.g. 10.10.10.0/255.255.255.0 or 10.10.10.0/24

       IP address range
	      e.g. 10.10.10.10-20

	      If you need to specify different community names for a different
	      printerspecs    then    surround	  them	  with	   parenthesis
	      171.68.205.0/24(private) otherwise the program will use whatever
	      is specified by the -c option or the defualt community  name  of
	      "public".

   OPERATIONAL OPTIONS
       These  options  affect  the way that the	program	opperates. They	can be
       used with any other options.

       -c community, --community community
	      Specify the comunity name

       -t timeout, --timeout timeout
	      Specify the amount of time to wait for a response	before	assum-
	      ing that there is	no respones.

       --debugsnmp
	      Logs  the	 snmp  packets sent and	received to a file called snm-
	      plog.xxx.

       --version
	      Print out	the version of npadmin and then	stop.

       --help Print out	some help information.

       --name This option puts either the name you  supplied  on  the  command
	      line or the ip address of	the device you are communicating with,
	      in front of every	line that that is  printed  out.  This	option
	      gets  turned on automatically when you have more than 2 printers
	      specified	on the command line. This is so	that scripts can  fig-
	      ure out whose data is whose.

   SINGLE LINE OPTIONS
       These  options output a series of values	on one line. They can be mixed
       freely.

       --vendor
	      Print out	the vendor that	made the printer.  Returns: vendor

       --model
	      Print out	the model of the printer.  Returns: model

       --contact
	      Print out	the contact information	for the	printer. This includes
	      both  the	 contact  person and the location of the printer.  Re-
	      turns: contact, location

       --netconfig
	      Print out	the network configuation  of  the  printer.   Returns:
	      ipaddr, hwaddr, gateway, netmask

       --printmib
	      Print out	whether	this printer support the printer mib RFC 1759.
	      Returns: printmib

       --hostmib
	      Print out	whether	this printer support the host  mib  RFC	 1514.
	      Returns: hostmib

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

       --maxpapersize
	      Print out	the maximum paper size for the printer.	-2 means  that
	      the printer does not know.  Returns: maxMediaUnit, maxMediaFeed-
	      Dir, maxMediaXFeedDir

       --enginespeed
	      Print out	the engine speed for the printer.  Note:  This	number
	      can  be  rather  decieving,  beware.  Some  vendors report it in
	      sheets and others	report it in impressions.  Impressions are the
	      number of	sides a	printer	prints whereas sheets are double sided
	      sheets of	paper. The tricky part with this is that engine	 speed
	      is  really  based	upon the rate at which paper is	moved past the
	      various componants. So if	you are	printing on a  different  size
	      of  paper	 than what the vendor was thinking of when they	calcu-
	      lated this number, you will not get the same speed as  they  re-
	      port.  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,minMediaFeed-
	      Dir,minMediaXFeedDir

       --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 netware printer channel type but I	have  yet  to  find  a
	      printer vendor that uses it.  Returns: netware

       --port9100
	      Print  out  whether  the printer supports	port 9100 connections.
	      Note: The	people doing RFC 1759 depricated this channel type and
	      replaced	it  with  a  new channel type which is called bidirec-
	      tional TCP. The thing is that a printer might  have  a  bidirec-
	      tional  TCP  port	that is	not on port 9100 and it	would set this
	      flag to true. This option	will return true if there is  any  one
	      of  three	 channel types are specified, AppSocket	(for Tektronix
	      on  port	9100),	port  9100,  or	 bidirectional	TCP.   Returns
	      port9100

       --pjl  Print out	whether	the printer supports pjl.  Returns: pjl

       --hpgl Print out	whether	the printer supports hpgl.  Returns: hpgl

       --autolang
	      Print  out  whether  the printer can do auto language detection.
	      Note: Quite a few	printer	vendors	don't have a row in the	inter-
	      preter  table to indicate	this feature although they support it.
	      Returns: autolang

       --pcl  Print out	whether	the printer supports pcl.  Returns: pcl

       --postscript
	      Print out	whether	the printer supports PostScript	Returns: post-
	      script

       --marker
	      Print  out the complete marker table.  Note: Even	though this is
	      truly a multiline	option,	I have never  come  across  a  printer
	      with more	than one marker	in it, so this can probably be used as
	      a	single line option safely.  Returns:  markerTechnology,	 coun-
	      terUnits,	 lifeCount,  processColorants,	addessabiityUnit,  ad-
	      dressabilityFeedDir, addressabilityXFeedDir, northMargin,	south-
	      Margin, eastMargin, westMargin, status.

       --pagecount
	      Print  out  the pagecount	for each marker	that a printer has. (I
	      have never seen a	printer	that has more than one marker  and  so
	      you  can essentially use this as a single	item.)	Returns: coun-
	      terUnits,	pagecount

       --colors
	      Print out	the number of process colorants	that a printer has. (I
	      thought this field would be more useful than it is. It basically
	      states how many different	colors of stuff	(toner,	wax, ink what-
	      ever) the	marker uses to print its output.  Returns: processCol-
	      orants

       --resolution
	      Print out	the resolution that the	marker can address.  -2	 means
	      that the printer doesn't know.  Returns: addressabilityUnit, ad-
	      dressabilityFeedDir, 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.   Re-
	      turns: maxSpeedPrintUnit,	mediaSizeUnit, maxSpeed, maxMediaFeed-
	      Dir, 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 pa-
	      per in a tray is rather suspect. On some printers	a  paper  tray
	      with  some  paper	in it but not very much	might report 0 for the
	      current level and	an error in the	status rather  than  reporting
	      -3  and  an  ok. Also they might report that a tray is completly
	      full when	there is much less paper in it.	 Returns: type,	 dimU-
	      nit, dimFeedDir, dimXFeedDir, capUnit, maxCap, curLevel, status,
	      mediaName, name, description

       --protocol
	      Print out	the channel table. This	is basically all the ways that
	      you  can	communicate  with  a printer. It includes not only the
	      protocols	but things like	serial ports and IrDA ports.  Returns:
	      type,   version,	 currentJobControlLang,	  defaultPageDescLang,
	      state, status

       --languages
	      Print out	the complete interpreter table.	 Returns:  langFamily,
	      langLevel,   langVersion,	  description,	version,  orientation,
	      feedAddressability, xFeedAddressability, twoWay

       --supplies
	      Print out	the complete  marker  supplies	table.	-2  means  the
	      printer  doesn't	know. -3 means the printer has enough to print
	      one more page.  Note: Unfortunately most printer	vendors	 (even
	      the  ones	 that provide gas guages for their web based tools) do
	      not fill in these	objects	very carefully.	 Returns: class, type,
	      desc, supplyunit,	maxcap,	level

       --alerts
	      Print  out  the  complete	 alert table.  Returns:	severityLevel,
	      trainingLevel, group, groupIndex,	location,  code,  description,
	      time

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

       --covers
	      Print out	the complete cover table.  Returns: description,  sta-
	      tus

       --reboot
	      Reboots a	printer.

   VARIABLE DESCRIPTIONS
       vendor A	string that represents the company that	made the device.

       model  The  model  as the printer reports it.  Note: This can sometimes
	      be confusing because some	printers don't report exactly what  we
	      think the	model is. For example all HP 5si's return LaserJet 5si
	      no matter	if it is a plain 5si, a	mopier or a 5si	MX.

       contact
	      The textual identification of the	contact	person for  this  man-
	      aged node, together with information on how to contact this per-
	      son.  If no contact information is known,	the value is the zero-
	      length string.

       location
	      The physical location of this node (e.g.,	`telephone closet, 3rd
	      floor'). If the location is unknown,  the	 value	is  the	 zero-
	      length string.

       ipaddr The IP address of	the printer.

       hwaddr The ethernet address of that network card.

       gateway
	      The default gateway of the printer.

       netmask
	      The netmask for this printer's IP	address.

       printmib
	      Set  to 'Y' if the printer supports the printer mib RFC 1759 and
	      'N' if the printer doesn't.

       hostmib
	      Set to 'Y' if the	printer	supports the host mib RFC 1514 and 'N'
	      if it doesn't.

       memsize
	      The number of K the printer has installed	in it.

       desc   Used in several tables to	indicate the description.

       allocunits
	      The  size,  in  bytes,  of  the data objects allocated from this
	      pool.  If	this entry is monitoring sectors, blocks, buffers,  or
	      packets,	for example, this number will commonly be greater than
	      one. Otherwise this number will typically	be one.

       size   The size of the storage represented by this entry, in  units  of
	      allocunits.

       used   The  amount of the storage represented by	this entry that	is al-
	      located, in units	of allocunits.

       allocfail
	      The number of requests for storage  represented  by  this	 entry
	      that could not be	honored	due to not enough storage.

       maxSpeedPrintUnit
	      The  unit	 of  measure used in specifying	the speed of all media
	      paths in the printer. This can be	any one	of the following: ten-
	      ThousandthsOfInchesPerHour(3),   micrometersPerHour(4),  charac-
	      tersPerHour(5),	  linesPerHour(6),	impressionsPerHour(7),
	      sheetsPerHour(8),	 dotRowPerHour(9), feetPerHour(16), metersPer-
	      Hour(17)

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

       maxSpeed
	      The  maximum printing speed of this media	path expressed in prt-
	      MediaPathMaxSpeedUnit's.	A value	of (-1)	implies	'other'.

       maxMediaFeedDir
	      The maximum physical media size in the feed  direction  of  this
	      media path expressed in units of measure specified by mediaSize-
	      Unit.  A value of	(-1) implies 'unlimited'.  A value of (-2) im-
	      plies

       maxMediaXFeedDir
	      The  maximum  physical  media  size across the feed direction of
	      this media path expressed	in units of measure specified by medi-
	      aSizeUnit.  A value of (-2) implies 'unknown'.

       minMediaFeedDir
	      The  minimum  physical  media size in the	feed direction of this
	      media path expressed in units of measure specified by mediaSize-
	      Unit. A value of (-2) implies 'unknown'.

       minMediaXFeedDir
	      The  minimum  physical  media  size across the feed direction of
	      this media path expressed	in units of measure specified by medi-
	      aSizeUnit.  A value of (-2) implies 'unknown'.

       type (as	it applies to media path)
	      The  type	 of the	media path for this media path.	Can be any one
	      of  the  following:  other(1),  unknown(2),   longEdgeBindingDu-
	      plex(3), shortEdgeBindingDuplex(4), simplex(5).

       status Status is	used in	a lot of tables	and it has several independant
	      parts.

	      Availability: Available and Idle,	Available and Standby,	Avail-
	      able  and	Active,	Available and Busy, Unavailable	and OnRequest,
	      Unavailable because Broken, Unknown.

	      Non-Critical: No Non-Critical Alerts (not	printed), Non-Critical
	      Alerts

	      Critical:	No Critical Alerts (not	printed), Critical Alerts

	      On-Line: Intended	state is On-Line (not printed),	Intended state
	      is Off-Line

	      Transitioning: At	intended state (not printed), Transitioning to
	      intended state

       duplex Is at least one of the media paths a duplex path.

       type (as	it applies to inputtray)
	      The  type	 of  technology	 (discriminated	primarily according to
	      feeder mechanism type) employed by the  input  sub-unit.	 Note,
	      the Optional Input Class provides	for a descriptor field to fur-
	      ther qualify the other choice. Can be any	one of the  following:
	      other(1),	  unknown(2),	sheetFeedAutoRemovableTray(3),	sheet-
	      FeedAutoNonRemovableTray(4),   sheetFeedManual(5),   continuous-
	      Roll(6), continuousFanFold(7)

       dimUnit
	      The  unit	of measurement for use calculating and relaying	dimen-
	      sional values for	this input sub-unit. Can be either one of  the
	      following: tenThousandthsOfInches(3), micrometers(4)

       dimFeedDir
	      This object provides the value of	the declared dimension,	in the
	      feed direction, of the media that	is (or,	if empty, was or  will
	      be) in this input	sub-unit.  The feed direction is the direction
	      in which the media is fed	on this	sub-unit.  This	 dimension  is
	      measured	in  input  sub-unit  dimensional  units	(dimUnit). The
	      value (-1) means other and specifically means that this sub-unit
	      places  no  restriction  on this parameter. The value (-2) indi-
	      cates unknown.

       dimXFeedDir
	      This object provides the value of	the declared dimension,	in the
	      cross feed direction, of the media that is (or, if empty,	was or
	      will be) in this input sub-unit.	The cross  feed	 direction  is
	      ninety  degrees  relative	 to the	feed direction associated with
	      this sub-unit. This dimension is measured	in input sub-unit  di-
	      mensional	 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 ca-
	      pacity 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 ca-
	      pacity  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 ca-
	      pacity units (CapacityUnit). The	value  (-1)  means  other  and
	      specifically  indicates that the sub-unit	places no restrictions
	      on this parameter. The value (-2)	means unknown. The value  (-3)
	      means that the printer knows that	at least one unit remains.

       mediaName
	      A	 description  of  the  media contained in this input sub-unit;
	      This description is intended for display to  a  human  operator.
	      This description is not processed	by the printer.	 It is used to
	      provide information not expressible in terms of the other	 media
	      attributes  (e.g.	 dimFeedDir,  dimXFeedDir,  type).  An example
	      would be `legal tender bond paper'.

       name (as	it applies to inputtray)
	      The name assigned	to this	input sub-unit.

       description
	      A	free-form text description of this input sub-unit in the  cur-
	      rent localization.

       type (as	it applies to protocol)
	      The  type	 of this print data channel.  This object provides the
	      linkage to ChannelType-specific groups that  may	(conceptually)
	      extend  the  prtChannelTable  with additional details about that
	      channel. The type	can be any one of the following: other(1), Se-
	      rialPort(3),  ParallelPort(4), IEEE1284Port(5), SCSIPort(6), Ap-
	      pleTalkPAP(7),	LPDServer(8),	  NetwareRPrinter(9),	  Net-
	      warePServer(10), Port9100(11), AppSocket(12), FTP(13), TFTP(14),
	      DLCLLCPort(15), IBM3270(16), IBM5250(17),	Fax(18), IEEE1394(19),
	      Transport1(20),  CPAP(21),  PCPrint(26), ServerMessageBlock(27),
	      PSM(28), SystemObjectManager(31),	DECLAT(32), NPAP(33), USB(34),
	      IRDA(35),	   PrintXange(36),    PortTCP(37),   BidirPortTCP(38),
	      UNPP(39),	AppleTalkADSP(40), PortSPX(41),	PortHTTP(42), NDPS(43)

       currentJobControlLang
	      The name of this protocol's current job control language.

       defaultPageDescLang
	      The name of this protocol's current page description language.

       state  The state	of this	print job delivery channel.  The  value	 indi-
	      cates  whether  control  information  and	 print data is allowed
	      through this channel. The	state can be any one of	the following:
	      other(1),	printDataAccepted(3), noDataAccepted(4)

       appletalk

       lpd

       netware

       port9100

       langFamily
	      This  enumeration	 indicates the type of interpreter that	is re-
	      ceiving jobs. It	can  be	 any  one  of  the  following  values:
	      other(1),	 unknown(2),  PCL(3), HPGL(4), PJL(5), PS(6), IPDS(7),
	      PPDS(8),	EscapeP(9),   Epson(10),   DDIF(11),   Interpress(12),
	      ISO6429(13),   LineData(14),   MODCA(15),	  REGIS(16),  SCS(17),
	      SPDL(18),	TEK4014(19), PDS(20), IGP(21), CodeV(22),  DSCDSE(23),
	      WPS(24),	LN03(25),  CCITT(26),  QUIC(27), CPAP(28), DecPPL(29),
	      SimpleText(30), NPAP(31),	DOC(32),  imPress(33),	Pinwriter(34),
	      NPDL(35),	  NEC201PL(36),	 Automatic(37),	 Pages(38),  LIPS(39),
	      TIFF(40),	Diagnostic(41),	 PSPrinter(42),	 CaPSL(43),  EXCL(44),
	      LCDS(45),	XES(46), PCLXL(47), ART(48), TIPSI(49),	Prescribe(50),
	      LinePrinter(51), IDP(52),	XJCL(53), PDF(54), RPDL(55),  Interme-
	      cIPL(56),	UBIFingerprint(57), UBIDirectProtocol(58)

       orientation
	      A	 generic  representation for printing orientation on a 'page'.
	      It can be	one of the  following:	other(1),  portrait(3),	 land-
	      scape(4)

       twoWay Indicates	 whether  or  not this interpreter returns information
	      back to the host.

       pjl    'Y' if the printer supports pjl, 'N' if it doesn't.

       hpgl   'Y' if the printer supports pjl, 'N' if it doesn't.

       psprinter
	      'Y' if the printer supports psprinter, 'N' if it doesn't.

       autolang
	      'Y' if the printer supports autolang, 'N'	if it doesn't.

       pcl    'Y' if the printer supports pcl, 'N' if it doesn't.

       postscript
	      'Y' if the printer supports postscript, 'N' if it	doesn't.

       markerTechnology
	      The type of marking technology used for this  marking  sub-unit.
	      This  can	 be  any  one  of the following: other(1), unknown(2),
	      electrophotographicLED(3),  electrophotographicLaser(4),	 elec-
	      trophotographicOther(5),	impactMovingHeadDotMatrix9pin(6),  im-
	      pactMovingHeadDotMatrix24pin(7),		impactMovingHeadDotMa-
	      trixOther(8),   impactMovingHeadFullyFormed(9),  impactBand(10),
	      impactOther(11),	inkjetAqueous(12),   inkjetSolid(13),	inkje-
	      tOther(14),  pen(15), thermalTransfer(16), thermalSensitive(17),
	      thermalDiffusion(18),   thermalOther(19),	   electroerosion(20),
	      electrostatic(21),  photographicMicrofiche(22),  photographicIm-
	      agesetter(23),	 photographicOther(24),	    ionDeposition(25),
	      eBeam(26), typesetter(27)

       counterUnits
	      The unit that will be used by the	printer	when reporting counter
	      values for this marking sub-unit.	 The time units	of measure are
	      provided	for  a	device	like a strip recorder that does	not or
	      cannot track the physical	dimensions of the media	and  does  not
	      use characters, lines or sheets. This can	be any one of the fol-
	      lowing:	tenThousandthsOfInches(3),   micrometers(4),   charac-
	      ters(5),	 lines(6),   impressions(7),   sheets(8),   dotRow(9),
	      hours(11), feet(16), meters(17)

       lifeCount
	      The count	of the number of units of measure counted  during  the
	      life  of	printer	 using	units of measure as specified by coun-
	      terUnit.

       proccessColorants
	      The number of process colors supported by	this marker. A process
	      color  of	 1  implies  monochrome. The value of processColorants
	      must be 0	or greater.

       addressabilityUnit
	      The units	that the addressability	is measured in.	 This  can  be
	      either tenThousandthsOfInches(3),	micrometers(4)

       addressabilityFeedDir
	      The  maximum number of addressable marking positions in the feed
	      direction	per 10000 units	of measure specified by	 addressabili-
	      tyUnit.	A  value of (-1) implies "other" or "infinite" while a
	      value of (-2) implies "unknown".

       addressabilityXFeedDir
	      The maximum number of addressable	marking	positions in the cross
	      feed direction in	10000 units of measure specified by prtMarker-
	      AddressabilityUnit.  A value of (-1) implies "other"  or	"infi-
	      nite" while a value of (-2) implies "unknown".

       northMargin
	      The  margin, in units identified by addressabilityUnit, from the
	      leading edge of the medium as the	medium flows through the mark-
	      ing  engine with the side	to be imaged facing the	observer.  The
	      leading edge is the North	edge and the other edges  are  defined
	      by the normal compass layout of directions with the compass fac-
	      ing the observer.	 Printing within the area bounded by all  four
	      margins  is  guaranteed  for  all	 interpreters.	The value (-2)
	      means unknown.

       southMargin
	      The margin from the South	edge (see prtMarkerNorthMargin)	of the
	      medium   in  units  identified  by  prtMarkerAddressabilityUnit.
	      Printing within the area bounded by all four margins is  guaran-
	      teed for all interpreters. The value (-2)	means unknown.

       eastMargin
	      The  margin from the East	edge (see prtMarkerNorthMargin)	of the
	      medium  in  units	 identified  by	  prtMarkerAddressabilityUnit.
	      Printing	within the area	bounded	by all four margins is guaran-
	      teed for all interpreters. The value (-2)	means unknown.

       westMargin
	      The margin from the West edge (see prtMarkerNorthMargin) of  the
	      medium   in  units  identified  by  prtMarkerAddressabilityUnit.
	      Printing within the area bounded by all four margins is  guaran-
	      teed for all interpreters. The value (-2)	means unknown.

       pagecount
	      The  count  of the number	of units of measure counted during the
	      life of printer using units of measure  as  specified  by	 coun-
	      terUnit.

       class  Indicates	whether	this supply entity represents a	supply that is
	      consumed or a receptacle that is filled. This can	be any one  of
	      the following: other(1),supplyThatIsConsumed(3), receptacleThat-
	      IsFilled(4)

       type (as	it applies to marker supplies)
	      The type of this supply. This can	be any one of  the  following:
	      other(1),	 unknown(2),  toner(3),	wasteToner(4), ink(5), inkCar-
	      tridge(6),  inkRibbon(7),	 wasteInk(8),  opc(9),	developer(10),
	      fuserOil(11),    solidWax(12),	ribbonWax(13),	 wasteWax(14),
	      fuser(15),  coronaWire(16),  fuserOilWick(17),  cleanerUnit(18),
	      fuserCleaningPad(19),    transferUnit(20),   tonerCartridge(21),
	      fuserOiler(22)

       supplyUnit
	      Unit of measure of this marker supply container/receptacle. This
	      can  be any one of the following:	tenThousandthsOfInches(3), mi-
	      crometers(4),    impressions(7),	  sheets(8),	 thousandthsO-
	      fOunces(12),   hours(11),	  tenthsOfGrams(13),   hundrethsOfFlu-
	      idOunces(14), tenthsOfMilliliters(15), feet(16), meters(17)

       maxcap The maximum capacity of  this  supply  container/receptacle  ex-
	      pressed  in  prtMarkerSuppliesSupplyUnit.	 If  this  supply con-
	      tainer/receptacle	can reliably sense this	value,	the  value  is
	      reported	by  the	printer	and is read-only; otherwise, the value
	      may be written (by a Remote Control Panel	or a Management	Appli-
	      cation).	The  value (-1)	means other and	specifically indicates
	      that the sub-unit	places no restrictions on this parameter.  The
	      value (-2) means unknown.

       level  The current level	if this	supply is a container; remaining space
	      if this supply is	a receptacle. If this supply  container/recep-
	      tacle  can  reliably  sense this value, the value	is reported by
	      the printer and is read- only; otherwise,	the value may be writ-
	      ten (by a	Remote Control Panel or	a Management Application). The
	      value (- 1) means	other and specifically indicates that the sub-
	      unit  places  no	restrictions on	this parameter.	The value (-2)
	      means unknown.  A	value of (-3) means  that  the	printer	 knows
	      that there is some supply/remaining space, respectively.

       severityLevel
	      The level	of severity of this alert table	entry. The printer de-
	      termines the severity level assigned to each entry into the  ta-
	      ble. 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
	      intervention  is	required.  The	noInterventionRequired	 value
	      should be	used if	the event does not require any human interven-
	      tion. The	training level is an enumeration  that	is  determined
	      and  assigned  by	the printer manufacturer based on the informa-
	      tion or the training required to handle this alert.  The printer
	      will  break  alerts into these different training	levels.	 It is
	      the responsibility of the	management application in  the	system
	      to  determine  how  a particular alert is	handled	and how	and to
	      whom that	alert is routed.  This value can be  any  one  of  the
	      following:   other(1),   unknown(2),  untrained(3),  trained(4),
	      fieldService(5), management(6), noInterventionRequired(7)

	      The following are	the four training levels of alerts:

	      FieldService: Alerts that	typically  require  advanced  training
	      and technical knowledge of the printer and its sub-units.	An ex-
	      ample of a technical person would	be a manufacturer's Field Ser-
	      vice  representative,  or	 other	person formally	trained	by the
	      manufacturer or similar representative.

	      Trained: Alerts that require an intermediate or  moderate	 level
	      of  knowledge  of	the printer and	its sub-units. A typical exam-
	      ples of alerts that a trained operator can handle	 is  replacing
	      toner cartridges.

	      Untrained:  Alerts  that can be fixed without prior training ei-
	      ther because the action to correct the alert is obvious  or  the
	      printer can help the untrained person fix	the problem. A typical
	      example of such an alert is reloading paper trays	 and  emptying
	      output bins on a low end printer.

	      Management: Alerts that have to do with overall operation	of and
	      configuration of the printer. Examples of	management events  are
	      configuration change of sub-units.

       group  The type of sub-unit within the printer model that this alert is
	      related. Input, output, and  markers  are	 examples  of  printer
	      model  groups,  i.e.,  examples  of types	of sub-units. Wherever
	      possible,	these enumerations match the sub-identifier that iden-
	      tifies  the relevant table in the	printmib. It can be any	one of
	      the   following:	 other(1),    hostResourcesMIBStorageTable(3),
	      hostResourcesMIBDeviceTable(4), generalPrinter(5), cover(6), lo-
	      calization(7),  input(8),	 output(9),   marker(10),   markerSup-
	      plies(11),  markerColorant(12),  mediaPath(13), channel(14), in-
	      terpreter(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 ta-
	      bles  in the Printer MIB.	Therefore, other MIBs may assign alert
	      codes of 30 or higher to use the alert table  from  the  Printer
	      MIB without requiring revising and re-publishing this document.

       groupIndex
	      An  index	 of  the  row  within the principle table in the group
	      identified by prtAlertGroup that represents the sub-unit of  the
	      printer	that  caused  this  alert.   The  combination  of  the
	      prtAlertGroup and	the prtAlertGroupIndex defines	exactly	 which
	      printer  sub- unit caused	the alert; for example,	Input #3, Out-
	      put #2, and Marker #1. Every object in this MIB is indexed  with
	      hrDeviceIndex  and  optionally, another index variable.  If this
	      other index variable is present in the table that	generated  the
	      alert, it	will be	used as	the value for this object.  Otherwise,
	      this value shall be -1.

       location
	      The sub-unit location that is defined by	the  printer  manufac-
	      turer  to	 further  refine the location of this alert within the
	      designated sub-unit.  The	location is used in  conjunction  with
	      the  Group and GroupIndex	values;	for example, there is an alert
	      in Input #2 at location number 7.	The value (-2)	indicates  un-
	      known.

       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),  un-
	      known(2),	 coverOpened(3),  coverClosed(4),  interlockOpened(5),
	      interlockClosed(6), configurationChanged(7), jammed(8), subunit-
	      Missing(9), subunitLifeAlmostOver(10), subunitLifeOver(11), sub-
	      unitAlmostEmpty(12),  subunitEmpty(13),	subunitAlmostFull(14),
	      subunitFull(15),	subunitNearLimit(16), subunitAtLimit(17), sub-
	      unitOpened(18), subunitClosed(19), subunitTurnedOn(20), subunit-
	      TurnedOff(21),  subunitOffline(22),  subunitPowerSaver(23), sub-
	      unitWarmingUp(24), subunitAdded(25), subunitRemoved(26), subuni-
	      tResourceAdded(27),  subunitResourceRemoved(28), subunitRecover-
	      ableFailure(29), subunitUnrecoverableFailure(30),	 subunitRecov-
	      erableStorageError(31),	 subunitUnrecoverableStorageError(32),
	      subunitMotorFailure(33), subunitMemoryExhausted(34),  subunitUn-
	      derTemperature(35),  subunitOverTemperature(36),	subunitTiming-
	      Failure(37), subunitThermistorFailure(38), doorOpen(501),	 door-
	      Closed(502),   poweredUp(503),  poweredDown(504),	 printerNMSRe-
	      set(505),	printerManualReset(506), printerReadyToPrint(507), in-
	      putMediaTrayMissing(801),	inputMediaSizeChanged(802), inputMedi-
	      aWeightChanged(803), inputMediaTypeChanged(804),	inputMediaCol-
	      orChanged(805),  inputMediaFormPartsChange(806),	inputMediaSup-
	      plyLow(807),    inputMediaSupplyEmpty(808),     inputMediaChang-
	      eRequest(809),  inputManualInputRequest(810), inputTrayPosition-
	      Failure(811),  inputTrayElevationFailure(812),  inputCannotFeed-
	      SizeSelected(813), outputMediaTrayMissing(901), outputMediaTray-
	      AlmostFull(902), outputMediaTrayFull(903),  outputMailboxSelect-
	      Failure(904),	markerFuserUnderTemperature(1001),     marker-
	      FuserOverTemperature(1002),      markerFuserTimingFailure(1003),
	      markerFuserThermistorFailure(1004),    markerAdjustingPrintQual-
	      ity(1005), markerTonerEmpty(1101), markerInkEmpty(1102), marker-
	      PrintRibbonEmpty(1103),	 markerTonerAlmostEmpty(1104),	 mark-
	      erInkAlmostEmpty(1105),	   markerPrintRibbonAlmostEmpty(1106),
	      markerWasteTonerReceptacleAlmostFull(1107), markerWasteInkRecep-
	      tacleAlmostFull(1108),	 markerWasteTonerReceptacleFull(1109),
	      markerWasteInkReceptacleFull(1110),	      markerOpcLifeAl-
	      mostOver(1111),	markerOpcLifeOver(1112),    markerDeveloperAl-
	      mostEmpty(1113),	 markerDeveloperEmpty(1114),   markerTonerCar-
	      tridgeMissing(1115), mediaPathMediaTrayMissing(1301), mediaPath-
	      MediaTrayAlmostFull(1302),  mediaPathMediaTrayFull(1303),	inter-
	      preterMemoryIncreased(1501),   interpreterMemoryDecreased(1502),
	      interpreterCartridgeAdded(1503),		       interpreterCar-
	      tridgeDeleted(1504),   interpreterResourceAdded(1505),	inter-
	      preterResourceDeleted(1506),	   interpreterResourceUnavail-
	      able(1507),	      interpreterComplexPageEncountered(1509),
	      alertRemovalOfBinaryChangeEntry(1801)

       displayBufferText
	      The text on that line of the display

       description (as it applies to alerts)
	      A	 description of	this alert entry.  The description is provided
	      by the printer to	further	elaborate on the enumerated  alert  or
	      provide  information in the case where the code is classified as
	      'other' or 'unknown'.  The printer is required to	return	a  de-
	      scription	string but the string may be a null string.

       time   The  value  of  sysUpTime	at the time that this alert was	gener-
	      ated.

       description (as it applies to cover)

       status (as it applies to	cover)
	      This can be any one of the  following:  other(1),	 coverOpen(3),
	      coverClosed(4), interlockOpen(5),	interlockClosed(6)

       cfgsrc This is how the printer obtained its IP address.

EXAMPLE
       Here  is	an example invocation to try to	discover all the printers on a
       small network.

	  npadmin --model --timeout 6 144.254.42.0/24 2>/tmp/errorlog

	  When this is done, you might want to check  errrorlog	 for  anything
	  interesting like printers that npadmin doesn't recognise.

BUGS
       Very  numerous.	This program is	still under development. Any place the
       program asserts out should be considered	a bug and reported to the  de-
       velopers	at ( ben@valinux.com )

       The  code  that	parses	multiple  printers specifications into printer
       names is	pretty green. It probably can be broken	easily.	Please come up
       with new	and interesting	ways to	break and send them to ben@valinux.com
       and I will try to come up with ways to insulate npadmin from your  mis-
       cheiviousness.

       This program has	only been tested extensivly on Linux. If you do	a port
       to another OS. Please email me.

       Many printer types are not supported yet. If you	have a printer that is
       not  supported. Please email the	output of the command "snmpwalk	print-
       ername public .1" to me.

3rd Berkeley Distribution	 July 30 1999			    NPADMIN(1)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLE | BUGS

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

home | help