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)

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.0>

home | help