RFC 3805
Printer MIB v2
Printer MIB v2 🖨️✨
okay bestie, this is RFC 3805, and it's giving the printer spec 🖨️💅. It's a Standards Track doc from the Network Working Group, published June 2004. Three authors wrote it: R. Bergman (Hitachi Printing Solutions), H. Lewis (IBM Corporation), and I. McDonald (High North Inc.) 🫶. It obsoletes RFC 1759, which means this one replaces the old version. It doesn't update anything else 🎀.
Status of this Memo 📋
okay so this is an Internet standards track protocol for the whole Internet community 🌐. The authors are literally asking for discussion and suggestions to make it better 💖. If you want to know where it stands in standardization, check the current edition of the "Internet Official Protocol Standards" (STD 1) 📚. And distribution of this memo is unlimited, so share it with everyone 🦋.
Copyright Notice ©️
The Internet Society owns the copyright here, and the year is 2004 🧚.
Abstract ✨
so the big picture: this doc defines models and manageable objects for printing environments 🖨️. The objects in this MIB cover both the physical and the logical parts of a printing device, which is so thorough 😭🔥. It also officially obsoletes RFC 1759 💅.
Table of Contents 🗺️
1. Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1. Network Printing Environment. . . . . . . . . . . . . . 4
1.2. Printer Device Overview . . . . . . . . . . . . . . . . 6
1.3. Categories of Printer Information . . . . . . . . . . . 6
1.3.1. Descriptions. . . . . . . . . . . . . . . . . . 6
1.3.2. Status. . . . . . . . . . . . . . . . . . . . . 6
1.3.3. Alerts. . . . . . . . . . . . . . . . . . . . . 6
1.4. The Internet-Standard Management Framework. . . . . . . 7
1.5. Requirement Levels. . . . . . . . . . . . . . . . . . . 7
2. Printer Model . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1. Overview of the Printer Model . . . . . . . . . . . . . 10
2.2. Printer Sub-Units . . . . . . . . . . . . . . . . . . . 10
2.2.1. General Printer . . . . . . . . . . . . . . . . 10
2.2.1.1. International Considerations. . . . . 10
2.2.2. Inputs. . . . . . . . . . . . . . . . . . . . . 11
2.2.3. Media . . . . . . . . . . . . . . . . . . . . . 12
2.2.4. Outputs . . . . . . . . . . . . . . . . . . . . 12
2.2.5. Finishers . . . . . . . . . . . . . . . . . . . 12
2.2.6. Markers . . . . . . . . . . . . . . . . . . . . 13
2.2.7. Media Paths . . . . . . . . . . . . . . . . . . 13
2.2.8. System Controller . . . . . . . . . . . . . . . 14
2.2.9. Interfaces. . . . . . . . . . . . . . . . . . . 14
2.2.10. Print Job Delivery Channels . . . . . . . . . . 14
2.2.11. Interpreters. . . . . . . . . . . . . . . . . . 15
2.2.12. Console . . . . . . . . . . . . . . . . . . . . 15
2.2.13. Alerts. . . . . . . . . . . . . . . . . . . . . 15
2.2.13.1. Status and Alerts . . . . . . . . . . 16
2.2.13.2. Overall Printer Status. . . . . . . . 16
2.2.13.2.1. Host Resources MIB
Printer Status. . . . . . 18
2.2.13.2.2. Sub-unit Status . . . . . 20
2.2.13.3. Alert Tables. . . . . . . . . . . . . 21
2.2.13.4. Alert Table Management. . . . . . . . 21
2.3. Read-Write Objects. . . . . . . . . . . . . . . . . . . 23
2.4. Enumerations. . . . . . . . . . . . . . . . . . . . . . 24
2.4.1. Registering Additional Enumerated Values. . . . 25
3. Groups from other MIB Specifications. . . . . . . . . . . . . 25
3.1. System Group. . . . . . . . . . . . . . . . . . . . . . 25
3.2. System Controller . . . . . . . . . . . . . . . . . . . 25
3.3. Interface Group objects . . . . . . . . . . . . . . . . 26
3.3.1. Interface Types . . . . . . . . . . . . . . . . 26
4. Differences from RFC 1759 . . . . . . . . . . . . . . . . . . 26
5. The IANA Printer MIB. . . . . . . . . . . . . . . . . . . . . 29
6. The Printer MIB . . . . . . . . . . . . . . . . . . . . . . . 56
-- Textual conventions for this MIB module. . . . . . . . . . 59
-- The General Printer Group. . . . . . . . . . . . . . . . . 67
-- The Responsible Party group. . . . . . . . . . . . . . . . 70
-- The Auxiliary Sheet Group. . . . . . . . . . . . . . . . . 73
-- Administrative section (The General V2 Group) . . . . . . 74
-- General alert table section (Alert Table V2 Group). . . . 74
-- The Cover Table. . . . . . . . . . . . . . . . . . . . . . 75
-- The Localization Table . . . . . . . . . . . . . . . . . . 76
-- The System Resources Tables. . . . . . . . . . . . . . . . 78
-- The Input Group. . . . . . . . . . . . . . . . . . . . . . 81
-- The Extended Input Group . . . . . . . . . . . . . . . . . 86
-- The Input Media Group. . . . . . . . . . . . . . . . . . . 87
-- The Input Switching Group. . . . . . . . . . . . . . . . . 89
-- The Output Group . . . . . . . . . . . . . . . . . . . . . 90
-- The Extended Output Group. . . . . . . . . . . . . . . . . 93
-- The Output Dimensions Group. . . . . . . . . . . . . . . . 95
-- The Output Features Group. . . . . . . . . . . . . . . . . 97
-- The Marker Group . . . . . . . . . . . . . . . . . . . . . 98
-- The Marker Supplies Group. . . . . . . . . . . . . . . . . 104
-- The Marker Colorant Group. . . . . . . . . . . . . . . . . 107
-- The Media Path Group . . . . . . . . . . . . . . . . . . . 109
-- The Print Job Delivery Channel Group . . . . . . . . . . . 113
-- The Interpreter Group. . . . . . . . . . . . . . . . . . . 115
-- The Console Group. . . . . . . . . . . . . . . . . . . . . 120
-- The Alerts Group . . . . . . . . . . . . . . . . . . . . . 125
-- Conformance Information. . . . . . . . . . . . . . . . . . 129
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 147
8. Internationalization Considerations . . . . . . . . . . . . . 147
9. Security Considerations . . . . . . . . . . . . . . . . . . . 148
10. References. . . . . . . . . . . . . . . . . . . . . . . . . . 150
10.1. Normative References. . . . . . . . . . . . . . . . . . 150
10.2. Informative References. . . . . . . . . . . . . . . . . 151
Appendix A - Glossary of Terms. . . . . . . . . . . . . . . . . . 153
Appendix B - Media Size Names . . . . . . . . . . . . . . . . . . 156
Appendix C - Media Names. . . . . . . . . . . . . . . . . . . . . 158
Appendix D - Roles of Users . . . . . . . . . . . . . . . . . . . 162
Appendix E - Overall Printer Status Table . . . . . . . . . . . . 165
Appendix F - Participants . . . . . . . . . . . . . . . . . . . . 166
Significant Contributors. . . . . . . . . . . . . . . . . . . . . 168
Authors' Addresses. . . . . . . . . . . . . . . . . . . . . . . . 170
Full Copyright Statement. . . . . . . . . . . . . . . . . . . . . 1711. Introduction 🌸
1.1. Network Printing Environment 🖨️
okay so printing a document on any computer is honestly a whole saga 😭. It splits into two overlapping pieces: managing the printing and managing the printer. Printing covers everything from the file being generated, to picking a printer, choosing print properties, routing, queuing, resource management, scheduling, and the final print (including telling the user) 📄✨. Most of that process is outside what this model covers. This doc only handles managing the printer 💅.
Here's the vibe in Figure 1, one printer's view of the network 👀:
Figure 1 - One Printer's View of the Network
system printer asset user user user
manager operator manager
O O O O O O
/|\ /|\ /|\ /|\ /|\ /|\
/ \ / \ / \ / \ / \ / \
| | | | | |
+---------+ +-------+ +-------+ +-------+ +-----------+ +-----------+
|configur-| |printer| | asset | |printer| | user | | user |
|ator | |manager| |manager| |browser| |application| |application|
+---------+ +-------+ +-------+ +-------+ +-----------+ +-----------+
^ ^ ^ ^ | |
|R/W |R/W |R |R +-----------+ +-----------+
| | | | | spooler | | spooler |
| | | | +-----------+ +-----------+
| | | | | |
| | | | +-----------+ +-----------+
| | | | |supervisor | |supervisor |
| | | | +-----------+ +-----------+
| | | | ^ ^ ^ ^
| | | | |R |R/W |R |R/W
v v | | | | | |
================================================== | ===== |
| print| print|
|SNMP data| data|
+-----+ +-------+ PCL| PCL|
| MIB |<------>| agent | PostScript| PostScript|
+-----+ +-------+ NPAP| NPAP|
|unspecified etc.| etc.|
+=============+ +-----------------+ | |
| |--|channel/interface|<--+ |
| | +-----------------+ |
| PRINTER | |
| | +-----------------+ |
| |--|channel/interface|<----------------+
+=============+ +-----------------+1.2. Printer Device Overview 🧚
so a printer is the physical box that grabs media from an input source, puts marks on it based on a page description or page control language, and sends the result to some output destination, maybe with finishing added 🖨️✨. Printers are seriously complex. They eat supplies, make waste, and sometimes break down 😭. For the physical device, the description, status, and alert info about the printer and its parts needs to reach the management app, so it can be shown to the end user, to operators who need to restock supplies, or to whoever does repairs and maintenance 🛠️. The info needed to manage the physical printer and to manage a print job overlaps a lot, and lots of tasks in each area need the same or similar info 🫶.
1.3. Categories of Printer Information 🗂️
okay so printer info falls into three basic buckets: descriptions, status, and alerts 💖.
That's the first part, bestie! 🌈✨
1.3.1. Descriptions 💖
okay so descriptions are all about the printer's setup and what it can do, and its sub-units too 🖨️ this info is basically static, bestie. it doesn't really change while the system is running, but it CAN change if the printer gets repaired, reconfigured, or upgraded 🔧 descriptions are one piece of the printer's visible state, and state just means how the printer is doing at any given moment ✨
1.3.2. Status 🚦
status is the current operating state of the printer and its sub-units, and it's giving very "is it ready to go?" energy 💅 for example, a management app needs to figure out whether the sub-units are ready to print, or whether they're in some state that's blocking printing or might block it later 👀
1.3.3. Alerts 🚨
an Alert is how a reportable event in the printer gets represented 🔔 and an event is just a change in the printer's state. some of those changes matter to a management app, so they're reportable, and usually these are the ones that mess with the printer's ability to print 🙈 alerts usually pop up asynchronously, meaning they don't wait around for the computer system(s) the printer is hooked up to 😭 for convenience, "alert" gets used for both the event that happens when the printer's state changes AND the representation of that event, so keep up bestie 💜
alerts come in two main flavors, critical and non-critical ⚠️ a critical alert fires when the printer enters a state where it's stopped and can't keep printing until whatever caused it is fixed 🛑 "Out of paper", "toner empty" and "output bin full" are all critical alerts, so iconic of them to be the worst 💀 non-critical alerts fire when the printer enters a state where printing isn't stopped yet. but that state could turn into a stopped one later 👀 examples are "input media low", "toner low" and "output bin nearly full". a non-critical alert can also just share info, like telling you a configuration changed in the printer 🧚
and the description, status and alert info about a printer can be thought of as a database that describes the printer 🗂️ the management app for a printer is gonna want to look at that printer database differently depending on how and why it needs the info 🦋
1.4. The Internet-Standard Management Framework 🌈
if you want the full tea on the docs that describe the current Internet-Standard Management Framework, check out section 7 of RFC 3410 [RFC3410] 📚
managed objects get accessed through a virtual information store called the Management Information Base, or MIB 🧠 MIB objects are usually accessed through the Simple Network Management Protocol (SNMP) 📡 objects in the MIB get defined using the mechanisms in the Structure of Management Information (SMI) 🎀 this memo specifies a MIB module that's compliant with SMIv2, which is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580] 💖
1.5. Requirement Levels 💅
okay bestie, the key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be read as described in [RFC2119] 🫶
compliant implementations have to follow this spec ✨
2. Printer Model 🖨️✨
so, to manage a printer, we need an abstract model of it that represents the sub-units it's built from 🧩 a printer can be described as made up of 13 types of sub-units 🎀 and this is important: the sub-units don't always line up with a physical mechanism you can point at 🙈 sub-units can also be logical processes, like interpreters for page description languages, or command processors that set the printer's various operating modes 🧚
here's the block diagram of the printer and its basic 13 sub-units 👑
Figure 2 - Printer Block Diagram
Physical Connections
|
+-----------+
| |
+-------------+ |
| Interface |-+
| MIB-II |
+-------------+
|
+-----------+
| |
+-------------+ | +-----------+
| Channel |-+ | Operator |
| | | Console |
+-------------+ +-----------+
|
+-----------+ +---------+
| | | |
+-----------+ +-------------+ | +-----------+ |
| General | | Interpreter |-+ | Alerts |-+
| Printer | | | | |
+-----------+ +-------------+ +-----------+
|
+-------------------------------+
| System Controller |
| HOST-RESOURCES-MIB |
+-------------------------------+
+------+ +--------+ +--------+
| | | | | |
+-------+ | +-------+ +---------+ | +-------+ +--------+ |
| Input |-+ +--------+| | Marker |-+ +--------+| | Output |-+
| |===>| |+<==>| |<==>| |+==>| |
+-------+ +--+ +--+ +---------+ +--+ +--+ +--------+
\ | || | || \
\ | || | || \
\ | || | || \
+--------+ | |+-------------------------| || +---------+
| | | +--------------------------+ || | |
+----------+ | | Media Path |+ +----------+ |
| Media |-+ +--------------------------------+ | Finisher |-+
|(optional)| |(optional)|
+----------+ +----------+2.1. Overview of the Printer Model 🦋
the model has three basic parts 💜 (1) the flow of a print file into an interpreter and onto the marker, (2) the flow of media through the marker, and (3) the auxiliary sub-units that control and help out the two flows before them 🎀 the print data comes in through a physical connection that's running some form of transport protocol stack 🔌 the data from the transport protocol (interface) shows up on a channel, which is the input to an interpreter 🧠 the interpreter turns the print data into something that can be marked on the media ✨
the media lives in Input sub-units, where it gets selected and then carried along a Media Path first to a Marking sub-unit and then onto an Output sub-unit, with (optionally) some finishing stuff happening along the way 🧚 the auxiliary sub-units handle controlling the printer, inquiry and control of the operator panel, reporting alerts, and adapting the printer to different natural languages and character sets 🌸 all the software sub-units run on the System Controller, which is the processor, memory and storage of the Printer 💻 we'll go through each sub-unit in more detail below 🫶
every sub-unit except the Alerts only reports state info, either a description or a status 📋 the Alerts sub-unit is the one that reports event info 🚨
2.2. Printer Sub-Units 🧩
a printer is made up of 13 types of sub-units, called groups 💅 the next sections walk through each type 🌈
2.2.1. General Printer 👑
the general printer sub-unit is in charge of the overall control and status of the printer 🫡 there's exactly one general printer sub-unit in a printer, and the General Printer Group in the model represents it 💖 on top of giving the status of the whole printer and letting the printer be reset, this Group also tells you the status of the printer's packaging, especially the covers 🙈 the general printer sub-unit is usually implemented on the system controller 💻
2.2.1.1. International Considerations 🌍
the localization part of the general printer sub-unit is responsible for identifying the natural language, country, and character set that certain character strings are written in within this MIB 🗣️ character sets get identified in this MIB using the IANACharset textual convention, which is imported from the IANA Character Set MIB [CHARMIB] 🎀
there can be one or more localizations per printer, and they're listed in the Localization table 🧚 localization SHOULD only be done on string objects named xxxDescription (sub-unit descriptions) or prtConsoleDisplayBufferText (local console text) 💜
the agent SHALL return all other character strings in coded character sets where code positions 0-127 (decimal) are US-ASCII [ASCII] 🔤 the agent SHOULD return all other character strings in the UTF-8 [RFC3629] transform of ISO 10646 [ISO10646], so it lines up with the IETF Policy on Character Sets and Languages [RFC2277] 🌈 control codes (code positions 0-31 and 127 decimal) SHALL NOT be used unless specifically required in the DESCRIPTION of an object 🙅♀️
the character set part of the general printer Localization table is responsible for the possible character sets for the operator console and for network management requests for display objects 🖥️ there can be one or more character sets per printer 🦋 the default coded character sets for interpreter unit input and output octets are described in the interpreter sub-unit by prtInterpreterDefaultCharSetIn and prtInterpreterDefaultCharSetOut 💅 those input/output character sets can be overridden by commands in the interpreter language itself ✨
2.2.2. Inputs 📥
Input sub-units are the mechanisms that feed the media to be marked on into the printer 🫶 a printer has one or more input sub-units, and the Input Group in the model represents them 🧚 the model doesn't tell fixed input bins apart from removable trays, except that it reports when a removable tray has been removed 👀
there are as many input sub-units as there are distinctly selectable input "addresses" 🎀 for example, if one tray has both a manual and an auto feeding option, that's two input sub-units if those two sources can be (must be) selected separately 💖 but it'd count as one input sub-unit if putting a sheet in the manual feed slot overrides feeding from the tray's contents 🙈 in that second case, there's no way to select or address the manual feed slot separately 💀
2.2.3. Media 📄
an input sub-unit can hold one or more instances of the media that marking is going to be done on 🌸 usually there's a big set of possible media that can be linked to an input 🌈 the Media Group extends the Input Group and represents the media in an input sub-unit 💜 the Media Group only describes what's currently in each input, not what the input sub-unit could hold ✨
2.2.4. Outputs ✨
okay so output sub-units are the mechanisms that receive media after it's been marked on 📄💖 The Output Group in the model stands for all the output mechanisms a printer has. The model doesn't care whether a bin is fixed or removable, except that it reports when a removable bin has been taken out 🫶
There's one output sub-unit for each output "address" you can pick out separately. You can address them in two ways 🦋 (1) as "mailboxes," where you pick one with a mailbox selector like a bin number or a bin name, or (2) as "slots" where multiple copies get collated. Sometimes a printer can do both at once, which is so iconic 👑 The only thing the model cares about is that each output unit can be selected on its own 💅
2.2.5. Finishers
a finisher is a sub-unit that does stuff to the media that isn't marking 🧚 The Finisher Group in the model covers the finisher sub-units. Examples are stapling, punching, binding, inserting, and folding 🎀 Some finishing processes use supplies, and stapling, binding, and punching are the ones that do 📎 A printer can have more than one finishing sub-unit, and each one can be linked to one or more output sub-units 🌸 The finishers get their own full description in the companion Finisher MIB [RFC3806] 💜
the model doesn't pin down the exact interaction and sequencing between an output device and its finisher 🙈 that depends on the kind of finishing and how the printer is actually built. This standard lets you logically connect a finishing process to an output device, but it doesn't put any limits on the exact order or how they interact 💅 The output and finisher sub-units might or might not be separate, identifiable physical parts, depending on the implementation. Also, one output device can be linked to several finishing sub-units, and one finishing sub-unit can be linked to several output devices 🔥
2.2.6. Markers
a marker is the mechanism that actually puts marks on the print media 🖍️✨ The Marker Group in the model covers the marker sub-units and their supplies 🍓 A printer can have one or more marking mechanisms. Examples of multiple markers are a printer with separate markers for normal and magnetic ink, or an image setter that outputs to both a proofing device and final film 🌈 Every marking device can have its own characteristics, like marking technology and resolution 💖
the model treats the marker sub-unit as super generalized, so it covers the whole marking process, start to finish 🧁 For example, in a xerographic process, the marking part and the fusing part both count as the marker 🫶 Because of that big-picture view, one marker sub-unit can have several marking supplies attached. In a xerographic process there's the toner, but there can also be other supplies, like fuser oil, that get used up and replaced separately 🛢️ And a single marker can have multiple toner supplies too, like in a color process 🌈🎨
2.2.7. Media Paths
media paths are the mechanisms that move the media through the printer and tie together all the other media-related sub-units: inputs, outputs, markers, and finishers 🛤️💜 A printer has one or more media paths, and the Media Path Group in the model represents them 🦋 That group has some objects that apply to all paths, plus a table listing each separate media path.
the design of the media paths is what mostly decides the printer's maximum speed and the biggest media size it can handle 🚀 Media paths are complicated and can include lots of sub-mechanisms, like media movement devices, media buffers, duplex units, and interlocks 🎀 Not every path has every sub-mechanism. For example, one path might print on only one side of the media (a simplex path), while another has a sub-mechanism that flips the media over and feeds it through the marker sub-unit again (a duplex path) 🙃 A duplex path can even have a buffer that holds multiple copies of the front side before all the back sides get marked 🥹✨
2.2.8. System Controller
the System Controller is the sub-unit where the printer's software components actually run 🧠💅 The Host Resources MIB [RFC2790] represents the System Controller in the model. That MIB lets you specify the processor(s), memory, disk storage, file system, and other underlying sub-mechanisms of the printer 🖥️ Controllers can be anything from a simple single-processor system to a multiprocessor one, and they can have a full range of resources, like hard disks 💾 The printer is modeled as having exactly one system controller, even if it has more than one processor and a bunch of other resources hooked up to it 👑
2.2.9. Interfaces
an interface is the communications port and the protocols behind it that handle getting data to the printer 🔌💖 A printer has one or more interface sub-units. Interfaces are represented by the Interfaces Group of MIB-II [RFC1213], [RFC2863] 🌸 Examples include serial ports (with little or no protocol) and Ethernet ports, where you might run Internet IP, Novell IPX, and so on 🦋
2.2.10. Print Job Delivery Channels
print job delivery channel sub-units identify the independent sources of print data 📥✨ (print data here means the information used to build printed pages, and it can have both data and control parts 🧩) A printer can have one or more channels, and they're represented by the Print Job Delivery Channel Group in the model 🎀 The electronic path usually identifies each channel and the service protocol used to deliver print data to the printer 🛤️
a channel sub-unit can be enabled (so print data can flow) or disabled (so the flow stops) 🚦 Each channel has a current Control Language, which picks which interpreter handles the print data and lets you query and change the environment variables the interpreters use (and SNMP can do this too) 🫶 There's also a default interpreter that gets used if the Control Language doesn't explicitly pick one 🧚 Print Job Delivery Channel sub-units can, and usually do, sit on top of an underlying interface 🥰
2.2.11. Interpreters
the interpreter sub-units are the ones that turn a description of the intended print instances into the images that get marked on the media 🖼️💜 A printer can have one or more interpreters, and the Interpreter Group in the model represents them 🍓 Each interpreter is usually implemented as software running on the System Controller sub-unit 💻 The Interpreter Table has one entry per interpreter, and the interpreters include both Page Description Language (PDL) Interpreters and Control Language Interpreters 📚✨
2.2.12. Console
lots of printers have a console on the printer itself, the operator console, used to display and change the printer's state 🖥️💅 It can be as simple as a few indicators and switches, or as complicated as full screen displays and keyboards 🌈 There can be at most one such console. The Console Group in the model represents this console sub-unit 🎀 Most of what's shown there is also in the state of the printer as represented by the various Groups, but it's still super useful to query and change the operator console remotely 🥹 For example, a management app might want to show its user the current message on a remote printer's operator console, or the user might want to change that message 💖 Another example: a remote app that puts up a pseudo console on a workstation screen 🦋
here's the tricky part 🙈 the rules for mapping printer state onto the console (and back) aren't standardized, so it's not possible to reproduce the console state or what the console buttons and menus do. That's why the Console Group gives you access to the console instead 🫶 The operator console is usually built on the system controller, plus some extra hardware for input and display 🔧
2.2.13. Alerts
the alert sub-unit is in charge of spotting reportable events and making an entry in the alert table 📋✨ It only starts a trap if, and only if, the event is a critical event 🚨 The one exception is when the "alertRemovalofBinaryChangeEntry" trap gets generated 🙃 The alert sub-unit is represented by the Alerts Group, and specifically by the Alert Table 💜 That table holds the severity, the sub-unit, the detailed location inside that sub-unit, the alert code, and a description for each alert that's currently active on the printer 🌸 Every reportable event causes an entry to be made in the Alert Table 💅
2.2.13.1. Status and Alerts
summary info about the printer's state is reported at three separate levels, bestie 🧚💖
- the status of the printer as a whole is reported in the Host Resources MIB 🖥️
- the status of the various sub-units is reported in the main table of the Group that represents each sub-unit 🎀
- alert codes are reported in the Alert Table 🚨
three levels, all giving you the state from different angles, so it's giving full picture 👑🌈
2.2.13.2. Overall Printer Status ✨
okay so not every printer state is equally dramatic 💅 some of them are super interesting bc they're the ones that make an admin go "wait, what do i do now??" 😭 these states can describe the whole printer, or just one sub-unit of it. the named states are:
- Non Critical Alert Active 🌸: for the printer, this means one or more sub-units have a non-critical alert active. for a sub-unit, it means that sub-unit has a non-critical alert active.
- Critical Alert Active 🚨: for the printer, this means one or more sub-units have a critical alert active. for a sub-unit, it means that sub-unit has a critical alert active.
- Unavailable 💀: the printer or sub-unit can't be used right now (aka "broken" or "down" in other terms). a trained service person is usually needed to make it available again.
- Moving on-line or off-line 🔄: the printer is either off-line, on its way off-line, or on its way back on-line. for example, on printers with motorized hoppers, reloading paper means going off-line to open the paper bin, filling the hopper, and then going back on-line once the bin is repositioned for printing 🍓
- Standby 🫶: the printer or sub-unit isn't immediately available, but it can still accept new instructions.
- Available ✨: the printer or sub-unit is functioning normally.
- Idle 🦋: the printer or sub-unit is immediately available.
- Active 🔥: the printer or sub-unit is doing its main job.
- Busy 🌈: the printer or sub-unit is doing a job (not necessarily its main one) and isn't immediately available for its main job.
the [RFC2790] Host Resources MIB has three status objects you can use to describe a printer's status: (1) hrDeviceStatus in the entry in the hrDeviceTable, (2) hrPrinterStatus in the hrPrinterTable, and (3) hrPrinterDetectedErrorState in the hrPrinterTable. these objects describe lots of the states a printer can be in 🧚 here's how the values of those three printer-related objects line up with the states we just talked about:
Printer hrDeviceStatus hrPrinterStatus hrPrinterDetected-
Status ErrorState
Idle running(2) idle(3) none set
Busy/ running(2) printing(4)
Active
Non Critical warning(3) idle(3) or could be: lowPaper,
Alert Active printing(4) lowToner, or
serviceRequested
Critical down(5) other(1) could be: jammed,
Alert Active noPaper, noToner,
coverOpen, or
serviceRequested
Unavailable down(5) other(1)
Moving off- warning(3) idle(3) or offline
line printing(4)
Off-line down(5) other(1) offline
Moving down(5) warmup(5)
on-line
Standby running(2) other(1)these named states are only a subset of the possible states 🫣 they are NOT a full list of every state a printer can be in. still, a couple of things are worth knowing. when you're using these states, you can't detect when both critical and non-critical alerts are pending. if both are pending, the Critical Alert Active state wins 👑. also, a printer in the Standby state shows up in the Host Resources MIB with a device status of running(2) and a printer status of other(1). that's a combo that doesn't uniquely tell you it's in Standby, which is kinda sad bc Standby is a really important state 😭
detailed status for each sub-unit gets reported in the sub-unit status fields 💖
2.2.13.2.1. Host Resources MIB Printer Status
for completeness 🎀, here are the definitions of the Printer Status objects from the Host Resources MIB [RFC2790]:
hrDeviceStatus OBJECT-TYPE
SYNTAX INTEGER {
unknown(1),
running(2),
warning(3),
testing(4),
down(5)
}
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The current operational state of the device
described by this row of the table. A value
unknown(1) indicates that the current state of the
device is unknown. running(2) indicates that the
device is up and running and that no unusual error
conditions are known. The warning(3) state
indicates that agent has been informed of an
unusual error condition by the operational software
(e.g., a disk device driver) but that the device
is still 'operational'. An example would be high
number of soft errors on a disk. A value of
testing(4), indicates that the device is not
available for use because it is in the testing
state. The state of down(5) is used only when
the agent has been informed that the device is
not available for any use."
::= { hrDeviceEntry 5 }
hrPrinterStatus OBJECT-TYPE
SYNTAX INTEGER {
other(1),
unknown(2),
idle(3),
printing(4),
warmup(5)
}
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The current status of this printer device. When in the
idle(3), printing(4), or warmup(5) state, the corresponding
hrDeviceStatus should be running(2) or warning(3). When in
the unknown(2) state, the corresponding hrDeviceStatus
should be unknown(1)."
::= { hrPrinterEntry 1 }
hrPrinterDetectedErrorState OBJECT-TYPE
SYNTAX OCTET STRING (0..128)
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This object represents any error conditions detected by the
printer. The error conditions are encoded as an OCTET STRING
with the following definitions:
Condition Bit #
lowPaper 0
noPaper 1
lowToner 2
noToner 3
doorOpen 4
jammed 5
offline 6
serviceRequested 7
inputTrayMissing 8
outputTrayMissing 9
markerSupplyMissing 10
outputNearFull 11
outputFull 12
inputTrayEmpty 13
overduePreventMaint 14
Bit # 15 is not assigned.
If multiple conditions are currently detected and the
hrDeviceStatus would not otherwise be unknown(1) or
testing(4), the hrDeviceStatus shall correspond to the worst
state of those indicated, where down(5) is worse than
warning(3), which is worse than running(2).
Bits are numbered starting with the most significant bit of
the first byte being bit 0, the least significant bit of the
first byte being bit 7, the most significant bit of the
second byte being bit 8, and so on. A one bit encodes that
the condition was detected, while a zero bit encodes that
the condition was not detected.
This object is useful for alerting an operator to specific
warning or error conditions that may occur, especially those
requiring human intervention."
::= { hrPrinterEntry 2 }2.2.13.2.2. Sub-unit Status
sub-unit status gets reported in the entries of the principle table in the Group that represents the sub-unit 🧸 for sub-units that report a status, there's a status column in the table, and its value is always an integer built in the following way 🌸
the PrtSubUnitStatusTC is an integer that's the sum of 5 distinct values: Availability, Non-Critical, Critical, On-Line, and Transitioning. here they are 💜
Availability value
Available and Idle 0 000'b
Available and Standby 2 010'b
Available and Active 4 100'b
Available and Busy 6 110'b
Unavailable and OnRequest 1 001'b
Unavailable because Broken 3 011'b
Unknown 5 101'b
Non-Critical
No Non-Critical Alerts 0
Non-Critical Alerts 8
Critical
No Critical Alerts 0
Critical Alerts 16
On-Line
State is On-Line 0
State is Off-Line 32
Transitioning
At intended state 0
Transitioning to intended state 64for example 🙈, an input (tray) that jammed on the next to last page may show a status of 27. that's unavailable because broken (3) + a critical state (16), jammed, and a noncritical state (8), low paper. the math ate, honestly 🍓
2.2.13.3. Alert Tables
the Alert Group is made of a single table where all the active alerts show up 🦋 this section gives you the big-picture overview of the table and how it gets managed. the basic stuff in the alert table is the severity of the alert (critical or non-critical), the Group and entry where a state change caused the alert, extra info about the alert (a more detailed location, an alert code, and a description), and how much training is needed to service the alert 🛠️
the Alert Table has some info that's redundant (like the fact that an event happened), and some info that only lives in the Alert Table (like the extra info) ✨ it's one table bc a single entry in a group can cause more than one alert. paper jams in more than one place in a media path are a good example 🌈 if the extra info was tied to the affected group entry, you'd only get one report. tying it to the alert instead makes multiple reports possible, which is iconic 👑 every time an alert happens, the printer makes one or more entries in the Alert Table. the printer decides whether an event is critical or non-critical. if the alert is "critical", the printer sends a trap or event notification to the host saying the table has changed 🚨 whether or not a trap gets sent, the management application is expected to poll the printer regularly, read and parse the table, and figure out what's changed, so it can give the management application user reliable info 💖
2.2.13.4. Alert Table Management 🎀
okay bestie, the alert tables are sparsely populated 🦋 which means they only hold entries for the alerts that are currently active, so the number of rows (aka entries) is totally dynamic ✨ More than one event can be added or removed from the event tables at a time, depending on the implementation of the printer 💅
There are basically two kinds of events that make alerts: binary change events and unary change events 👑 Binary change events come in pairs: the leading edge event and the trailing edge event. The leading edge event enters a state with only one exit, like going from running to stopped because of a paper jam. The only way out is fixing the paper jam, and it's clear once that's done. The trailing edge event is the one that exits the state the leading edge event entered, so in that example, fixing the jam is the trailing edge event 🧚
Managing binary change events in the Alert Table is pretty straightforward ✨ Only the leading edge event makes an entry in the alert table. That entry sticks around until the trailing edge event happens, and then it gets signaled by removing the leading edge entry from the table. So a trailing edge event doesn't create an entry, it removes the matching leading edge one 🫶 Removing the leading edge entry may cause the unary change event "alertRemovalofBinaryChangeEntry" to be added to the table. With binary change events, you can figure out the maximum number that could happen at the same time and build an Alert Table that holds that many events. That means no table overflow and no info about outstanding events gets lost, iconic 💖
Unfortunately, some events are NOT binary, and that's where things get messy 😭 This other category is the unary change event, and the configuration change event is the perfect example. Here the state of the machine has changed, but to a new state that is (often) just as valid as the one it left, and it doesn't need to go back. For example, an operator might change the paper in the primary input source from letter to legal. Later, the paper could go back to letter, or it could get changed to executive instead. This is the problem 💀 It's not obvious how long unary change event entries should stay in the Alert Table. If they were never removed, the Alert Table would keep growing forever.
The agent needs an algorithm for managing the alert table, especially when combinations of binary and unary alerts would overflow the table's storage capacity 🔥 When the table is full and new alerts need to be added, an old alert to delete should be chosen using these rules:
- Find a non-critical unary alert and delete it. If there are multiple non-critical unary alerts, it is suggested that the oldest one is chosen. If there are no non-critical unary alerts, then,
- Find a non-critical binary alert and delete it. If there are multiple non-critical binary alerts, it is suggested that the oldest one is chosen. If there are no non-critical binary alerts, then,
- Find a critical (binary) alert and delete it. If there are multiple critical alerts, it is suggested that the oldest one be chosen. Agent implementers are encouraged to provide at least enough storage space for the maximum number of critical alerts that could occur simultaneously. Note that all critical alerts are binary.
If a critical binary alert got deleted out of the alert table, then when there's space and the alert condition still exists, the alert should be re-added to the alert table, even if there wasn't a later transition into the associated state 🌸 It is recommended that this be done for non-critical binary alerts too. Heads up: the new alert entry will NOT have the same index as the original entry that got moved out of the table 👀
Also, because the Alert Index is a monotonically increasing integer, there will be gaps in the values in the table whenever an alert gets deleted. If those gaps show up, the management application may want to re-acquire the Printer state and check for state changes it didn't see in the Alert Table 🧚✨
2.3. Read-Write Objects 💜
Some objects in the printer MIB reflect whether a resource exists or how much of it there is 📄 Examples include the size and number of sheets in a paper tray, or whether certain output options exist. Some printers have automatic sensors for these resources, but most don't have sensors for every property of every resource. The management application is allowed to write into objects that hold descriptive or existence values for printers that can't sense those values 🙈 Whether you can change a read-write object's value may depend on the agent's implementation. Lots of objects in the MIB get read-write access, but a printer implementation might only let a management application change the value if the printer can't sense the value itself. Even if some objects spell out how this conditional ability works, any read-write object may act this way 🎀
Generally, an object gets read-write access in the Printer MIB specification if:
- The object involves installing a resource that some printers can't detect by themselves. So external means are needed to tell the printer about the installation. (External means here include using the operator console or a remote management application.) and
- The printer will behave differently if the installation of the resource is reported than it would if the installation weren't reported. In other words, the object is not supposed to be a place to put information the printer doesn't use, i.e., not a "sticky-note". Another way to say it: the printer believes the information it's given and acts as if it's true. For example, on a printer that can't sense the size, if one paper size is loaded but a different size is set into the paper size object, the printer will use the size that was set as its current paper size in its imaging and paper handling 🖨️
- The printer may get hints that it might not know about the existence or properties of certain resources. For example, a paper tray may be removed and re-inserted. When that happens, the printer may either assume that a property, such as the size of paper in the tray, hasn't changed, or it may change the value of the associated object to "unknown", as might be done for the amount of paper in the tray. As long as the printer acts according to the value in the object, either strategy is acceptable ✨
- Whether MIB object values persist across power cycles or cold starts is an implementation-specific matter 🌈 It's especially important that the values of the
prtMarkerLifeCountobject persist throughout the lifetime of the printer. Therefore, if the value of any MIB object persists across power cycles, then theprtMarkerLifeCountobject must also persist 💖
2.4. Enumerations 🦋
Enumerations (enums) are sets of symbolic values defined for use with one or more objects 💅 Commonly used enumeration sets get a symbolic data type name (a textual convention), instead of being specified in the SYNTAX clause of each individual object definition.
Textual conventions defined in the Printer MIB or the companion IANA Printer MIB are extensible by RFC publication or by Designated Expert Review (see the 'IANA Considerations' section of this Printer MIB and the DESCRIPTION clause in MODULE-IDENTITY of IANA Printer MIB). All of these textual conventions are:
- a) used more than once in the Printer MIB itself; or
- b) imported and used in the companion Finisher MIB; or
- c) imported and used in any other, including vendor private, MIB modules.
The Printer MIB has also defined the following special values for use with objects of the syntax Integer32 to define conditions that are outside of the normal numeric range: other(-1), unknown(-2), and partial(-3) 👑 The 'partial' value means that there is some supply remaining (but the amount is indeterminate) or there is some capacity remaining (but the amount is indeterminate). The Integer32 range field indicates which objects these special values are valid for ✨
2.4.1. Registering Additional Enumerated Values 🎀
The Printer MIB and the companion IANA Printer MIB each define one category of textual convention, based on the process used to control adding new enumerations 🧚
Type 1 - All of the legal values are defined in the Printer MIB. Additional enumerated values require the publication of a new Printer MIB.
Type 2 - All of the legal values are registered in the IANA Printer MIB. Additional enumerated values require a Designated Expert Review defined in "Guidelines for Writing an IANA Considerations Section in RFCs" [RFC2434]. The Designated Expert will be selected by the IETF Area Director(s) of the Applications Area 🌸
3. Groups from other MIB Specifications 🌈
This section identifies the groups from other MIBs that shall be supported to supplement and complete a printer MIB implementation 💅 It also describes some of the less obvious characteristics of the Printer MIB structure that are related to including these other MIB groups.
3.1. System Group ✨
All objects in the system group of MIB-II [RFC1213] shall be implemented; however, as described in paragraph 2.4, implementers should carefully consider what constitutes the "system" 🙈
3.2. System Controller 🖨️
The storage and device groups of the Host Resources MIB [RFC2790] shall be implemented to support the printer(s) system controller, and any supporting devices. If the implementer deems it appropriate, other groups of the Host Resources MIB (System, Running Software, Running Software Performance, and Installed Software) may be implemented. Because of the structure of the Host Resources MIB, the devices making up the system controller are at the same level as the printer 🧚
3.3. Interface Group objects 🦋
All objects in the Interfaces Group of MIB-II [RFC1213] shall be implemented for all print information interfaces to the printer, including non-network interfaces 💖
3.3.1. Interface Types 💜
The interfaces group of RFC 1213 [RFC1213] contains only a partial list of interface types that can be specified in the "ifType" object. For a complete list of interface types, refer to the IANA registry at "ftp://ftp.isi.edu/mib/iana.mib/ianaiftype.mib" 👑
4. Differences from RFC 1759 ✨
okay so this doc supersedes and replaces RFC 1759 🎀 but if you already have a compliant RFC 1759 implementation, it's also compliant with this one, so no panic bestie 💖 here's everything that changed (see the printmib REVISION/DESCRIPTION clause for the deets 👀):
- Minor editorial corrections and changes. Updated the cover page and added the "SNMP Management Framework" boilerplate to section 1. 🧹
- Updated figure 2 to use MIB names instead of RFC numbers. 📋
- Updated Coded Character Set description and IANA registration process. 🌍
- Changed
hrPrinterDetectedErrorState"coverOpen" (bit 4) to "doorOpen" per RFC 2790. 🚪 - Added second octet of
hrPrinterDetectedErrorStateas partially described and assigned in the updated Host Resources MIB (RFC 2790). 🆕 - Removed the fixed association of hrDeviceStatus (warning/down) from
hrPrinterDetetctedErrorStateper RFC 2790. 🔓 - Instead of showing bit 15 as "not assigned" in the quote from RFC 2790 in the
hrPrinterDetectedErrorStateobject, removed that from the tabular form and added it as a sentence, because the RFC doesn't show bit 15 in the tabular form. 🙈 - Clarified the international considerations. 🌏
- Added
prtChannelInformationto the Channel Group textual-conventions on a per channel basis to clarify the channel description and enhance interoperability. 🔍 - Deprecated some obsolete channel types. 🗑️
- Extended the Alert Table and
PrtMarkerSuppliesSupplyUnittextual conventions to include values from the Finisher MIB. 🧩 - Clarified alerts based on unary vs. binary change events. 💡
- Added (optional) unary change event
alertRemovalOfBinaryChangeEntry(1801). ✨ - Established a convention for contact information for
prtGeneralCurrentOperatorandprtGeneralServicePerson. 📇 - Added
prtAuxiliarySheetStartupPage(PresentOnOff). 📄 - Added
prtAuxiliarySheetBannerPage(PresentOnOff). 📄 - Added
prtGeneralPrinterName(OCTET STRING). 🖨️ - Added
prtGeneralSerialNumber(OCTET STRING). 🔢 - Added
prtInputNextIndex(Integer32). ➕ - Added the Input Switching Group. 🔀
- Added
prtAlertCriticalEvents(Counter32). 🚨 - Added
prtAlertAllEvents(Counter32). 📣 - Updated PrtAlertCode enums, including generic alert codes. 🔤
- Created five OBJECT-GROUPs (
prtAuxilliarySheetGroup,prtInputSwitchingGroup,prtGeneralV2Group,prtAlertTableV2Group,prtChannelV2Group). Added the nine new objects to them (prtAuxiliarySheetStartupPage,prtAuxiliarySheetBannerPage,prtGeneralPrinterName,prtGeneralSerialNumber,prtAlertCriticalEvents,prtAlertAllEvents,prtInputMediaLoadTimeout,prtInputNextIndex,prtChannelInformation). Created one new NOTIFICATION-GROUP (prtAlertTrapGroup) to containprinterV2Alert. Included the new OBJECT-GROUPs and the NOTIFICATION_GROUP inprtMIBCompliance, all in GROUP (not MANDATORY-GROUP) clauses. The nine new objects are optional, i.e., this document is backward compatible with RFC 1759. 🧁 prtAlertTimeis strongly recommended. ⏰- Deprecated the use of alert codes doorOpen(501) and doorClosed(502), in favor of coverOpened(3) and coverClosed(4). 🚫
- Added the
PrtConsoleDisableTCandPrtMarkerAddressabilityUnitTCtextual conventions, changed thePrtConsoleDisableandPrtMarkerAddressabilityUnitobjects' syntax to use those TCs, and changed thePrtGeneralEntryandPrtMarkerColorantEntrySEQUENCEs to reflect the new syntax. 🧠 - Added textual conventions "PrtLocalizedDescriptionStringTC" and "PrtConsoleDescriptionStringTC" and updated several objects to use them. 📝
- Changed most enumerations to textual conventions, and therefore changed the SYNTAX of many objects from RFC 1759 to specify the appropriate textual conventions. (28 TCs were added.) 🎯
- Changed the TC names "MediaUnit" to "PrtMediaUnitTC", "CapacityUnit" to "PrtCapacityUnitTC", and "SubUnitStatus" to "PrtSubUnitStatusTC". 🏷️
- All objects with a MAX-ACCESS of read-write now have a MIN-ACCESS of read-only. 🔒
- Added 'IANA Considerations' and 'Internationalization Considerations' as top level sections, per IETF guidelines. 📚
- Updated Security and Copyright sections. 🛡️
- Updated references and split them into Normative and Informative groups. 📖
- Added Appendix E - Overall Printer Status Table. 📊
- Updated participant and contact information. 👥
- Removed the CodedCharSet Textual Convention, replaced with an import of the IANACharset. 🔁
- Removed all comment statements that indicated objects or groups are mandatory or optional. This avoids any potential conflicts with the conformance section. 🧹
- Added text to empty description clauses (
prtStorageRefTable,prtDeviceRefTable,prtMarkerTable,prtMediaPathTable,prtChannelTable,prtInterpreterTable,prtConsoleLightTable, andprtAlertTable). 📝 - Added "DEFVAL { unknown }" to
prtInterpreterDefaultCharSetInandprtInterpreterDefaultCharSetOut. 🎀 - Changed "...values are expected to remain stable..." to "...values SHOULD remain stable..." in the description clauses for the index object in all tables. 💜
- Added ranges to all objects with a syntax of Integer32. 📏
- Revised the description clause for
prtAlertGroupIndex. 🔄 - Added additional text to the description clauses for
prtMediaPathEntry,prtChannelEntry,prtInterpreterEntry, andprinterV2Alert. 🪄 - Added text to section 2.4 to explain the usage of textual conventions in this MIB and others. Also added a note defining the common usage of the enumerations 'other(-1)' and 'unknown(-2)'. 🗒️
- Changed the range of
prtStorageRefSeqNumber,prtDeviceRefSeqNumber, andprtConsoleLightIndexfrom (0..65535) to (1..65535), since index values cannot be zero. (Typo in RFC 1759) 🐛 - The PWG Standard for Standardized Media Names is now recommended for the objects
prtInputMediaName,prtInputMediaColor, andprtInputMediaType. 🌈 - Added chSMTP(45) to
prtChannelTypeTC. 📬
5. The IANA Printer MIB 🦋
IANA-PRINTER-MIB DEFINITIONS ::= BEGIN
-- http://www.iana.org/assignments/ianaprinter-mib
IMPORTS
MODULE-IDENTITY,
mib-2
FROM SNMPv2-SMI -- [RFC2578]
TEXTUAL-CONVENTION
FROM SNMPv2-TC; -- [RFC2579]
ianaPrinterMIB MODULE-IDENTITY
LAST-UPDATED "200406020000Z" -- June 2, 2004
ORGANIZATION "IANA"
CONTACT-INFO "Internet Assigned Numbers Authority
Postal: ICANN
4676 Admiralty Way, Suite 330
Marina del Rey, CA 90292
Tel: +1 310 823 9358
E-Mail: iana@iana.org"
DESCRIPTION "This MIB module defines a set of printing-related
TEXTUAL-CONVENTIONs for use in Printer MIB (RFC 3805),
Finisher MIB (RFC 3806), and other MIBs which need to
specify printing mechanism details.
Any additions or changes to the contents of this MIB
module require either publication of an RFC, or
Designated Expert Review as defined in RFC 2434,
Guidelines for Writing an IANA Considerations Section
in RFCs. The Designated Expert will be selected by
the IESG Area Director(s) of the Applications Area.
Copyright (C) The Internet Society (2004). The
initial version of this MIB module was published
in RFC 3805. For full legal notices see the RFC
itself or see:
http://www.ietf.org/copyrights/ianamib.html"
REVISION "200406020000Z" -- June 2, 2004
DESCRIPTION "Original version, published in coordination
with Printer MIB (RFC 3805)."
::= { mib-2 109 }
--
-- Generic TEXTUAL-CONVENTIONs
--
PrtCoverStatusTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtCoverStatus in RFC 1759.
STATUS current
DESCRIPTION
"Values for encoding the state of a particular cover or
access panel on the printer case or enclosure."
SYNTAX INTEGER {
other(1),
coverOpen(3),
coverClosed(4),
interlockOpen(5),
interlockClosed(6)
}
--
-- General Group TEXTUAL-CONVENTIONs
--
PrtGeneralResetTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtGeneralReset in RFC 1759.
STATUS current
DESCRIPTION
"Values for reading and writing the prtGeneralReset object.
If a device does not have NVRAM, the device shall none the
less respond to a SET with the value resetToNVRAM(5) with a
sort of warm reset that resets the device to implementation-
defined state that is preferably under control of the system
administrator by some means outside the scope of the Printer
MIB specification."
SYNTAX INTEGER {
notResetting(3),
powerCycleReset(4), -- Cold Start
resetToNVRAM(5), -- Warm Start
resetToFactoryDefaults(6) -- Reset contents of
-- NVRAM to factory
-- defaults
}
--
-- Channel Group TEXTUAL-CONVENTIONs
--
PrtChannelTypeTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtChannelType in RFC 1759.
STATUS current
DESCRIPTION
"This enumeration indicates the type of channel that is
receiving jobs."
SYNTAX INTEGER {
other(1),
chSerialPort(3),
chParallelPort(4),
chIEEE1284Port(5),
chSCSIPort(6),
chAppleTalkPAP(7),
-- AppleTalk Printer
-- Access Protocol (PAP)
--
-- prtChannelInformation entry:
--
-- Printer Name
-- Keyword: Name
-- Syntax: Name
-- Status: Optional
-- Multiplicity: Single
-- Description: The name of the printer
-- within the AppleTalk naming scope
chLPDServer(8),
-- prtChannelInformation entry:
--
-- Printer queue name
-- Keyword: Queue
-- Syntax: Name
-- Status: Mandatory
-- Multiplicity: Single
-- Description: queue name as
-- defined in [RFC1179].
chNetwareRPrinter(9),
-- Novell, Inc.
-- For each entry of this type, the
-- prtChannelInformation must have a pair of
-- keywords. For Netware 3.x channels this must
-- be a (PServer, Printer) pair. For Netware
-- 4.x channels and for IntranetWare channels
-- this must be a (NDSTree, NDSPrinter) pair.
--
-- prtChannelInformation entries: -- Print Server Name
-- Keyword: PServer
-- Syntax: Name
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The Pserver's SAP name
--
-- Printer Number
-- Keyword: Printer
-- Syntax: Integer
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The printer number
--
-- NDSTree
-- Keyword: NDSTree
-- Syntax: Name
-- Multiplicity: Single
-- Description: The tree's SAP name
--
-- NDS Printer object
-- Keyword: NDSPrinter
-- Syntax: Text (Unicode)
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The fully qualified
-- name of the Printer
--okay so this is the Netware printing setup, and the vibes are giant 🖨️✨ In the Netware 3.x world, the client checks the Bindery object that represents the named PServer 🧚. Then it looks for the queues linked to the numbered printer. In the 4.x and IntraNetware world, it's a totally different move: the client looks up the queues linked to the NDS Printer Object in the named Tree 🌳. Depending on what access rights the client has to those queues, it sends its jobs to the right one. Iconic, honestly 💅
chNetwarePServer(10),
-- Novell,Inc.
-- For each entry of this type, the
-- prtChannelInformation must have a pair
-- of keywords. For Netware 3.x channels
-- this must be a (Server, PServer) pair.
-- For Netware 4.x and IntranetWare
-- channels, this must be a
-- (NDSTree, NDSPServer) pair.
--
-- prtChannelInformation entries:
--
-- Server Name
-- Keyword: Server
-- Syntax: Name
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The SAP name of the
-- server for which the PServer is defined.
--
-- PServer
-- Keyword: PServer
-- Syntax: Name
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The bindery name of
-- the PServer
--
-- NDS Tree
-- Keyword: NDSTree
-- Syntax: Name
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The NDS Tree name
--
-- PServer
-- Keyword: NDSPServer
-- Syntax: Text (Unicode)
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The fully qualified
-- name of the PServer object in the tree.
--🎀 So this entry is the Novell one, and the babe rule is that its prtChannelInformation must carry a pair of keywords. For Netware 3.x, it's a (Server, PServer) pair. For Netware 4.x and IntranetWare, it's an (NDSTree, NDSPServer) pair. Not one more, not one less 🙈
Then in the 3.x world, the client checks the bindery object for the named PServer on the named Server. In the 4.x and IntranetWare world, it checks the NDS object for the named PServer in the named Tree 🌸 Either way, it then checks every queue tied to the PServer object, and depending on the client's access rights to those queues, it submits the jobs to the right one. Main character energy, fr fr 👑
chPort9100(11),
-- DEPRECATED
-- (see chPortTCP - 37; chBidirPortTCP - 38)
chAppSocket(12),
-- A bi-directional, LPD-like, protocol using
-- 9101 for control and 9100 for data.
-- Adobe Systems, Inc.
chFTP(13), -- [RFC959]
chTFTP(14), -- [RFC1350]
chDLCLLCPort(15),
chIBM3270(16), -- IBM Coax
chIBM5250(17), -- IBM Twinax
chFax(18),
chIEEE1394(19),
chTransport1(20),
-- TCP port 35, for reserved TCP port list see
-- [RFC3232]. This RFC should also be
-- referenced for other channel
-- enumerations utilizing TCP port
-- numbers 0 through 1024.
chCPAP(21), -- TCP port 170
-- Digital Equipment Corp.
chDCERemoteProcCall(22), -- OSF
-- DEPRECATED
chONCRemoteProcCall(23), -- SUN Microsystems
-- DEPRECATED
chOLE(24), -- Microsoft
-- DEPRECATED
chNamedPipe(25),
chPCPrint(26), -- Banyan
chServerMessageBlock(27),
-- File/Print sharing protocol used by
-- various network operating systems
-- from IBM 3Com, Microsoft and others
--
-- prtChannelInformation entry:
--
-- Service Name
-- Keyword: Name
-- Syntax: Name
-- Status: Optional
-- Multiplicity: Single
-- Description: The service name of
-- the printer
chDPMF(28), -- IBM Infoprint
chDLLAPI(29), -- Microsoft
-- DEPRECATED
chVxDAPI(30), -- Microsoft
-- DEPRECATED
chSystemObjectManager(31), -- IBM
chDECLAT(32),
-- Digital Equipment Corp.
--
-- prtChannelInformation entries:
--
-- Port Name
-- Keyword: Port
-- Syntax: Name
-- Status: Conditionally
-- Mandatory
-- (see note below)
-- Multiplicity: Single
-- Description: LAT port name
--
-- Service Name
-- Keyword: Service
-- Syntax: Name
-- Status: Conditionally
-- Mandatory
-- Multiplicity: Single
-- Description: LAT service name
--
-- The LAT channel may be
-- identified by either a port or
-- service, so either a
-- Port or Service entry must be
-- specified, but not both.
chNPAP(33),
chUSB(34), -- Not in RFC 1759
-- Universal Serial Bus
chIRDA(35), -- Not in RFC 1759
-- Infrared Data Assoc. Prot.
chPrintXChange(36), -- Not in RFC 1759
-- PrintXChange Protocol
chPortTCP(37), -- Not in RFC 1759
-- A unidirectional "raw" TCP
-- channel that uses an administratively
-- assigned TCP port address.
--
-- prtChannelInformation entry:
--
-- Port Number
-- Keyword: Port
-- Syntax: decimal number
-- Status: Mandatory
-- Multiplicity: Single
-- Description: TCP port number
chBidirPortTCP(38), -- Not in RFC 1759
-- A bi-directional version of chPortTCP
--
-- prtChannelInformation entries:
-- (See chPortTCP)
chUNPP(39), -- Not in RFC 1759
-- Universal Network Printing
-- Protocol(UNPP). A bi-directional,
-- multiport network printing
-- application protocol available on
-- multiple transport protocols.
-- Underscore, Inc.
-- Contact: info@underscore.com
chAppleTalkADSP(40), -- Not in RFC 1759
-- AppleTalk Data Stream Protocol.
-- ADSP is part of the AppleTalk
-- suite of protocols.
-- It is a symmetric, connection-
-- oriented protocol that makes
-- possible the establishment
-- and maintenance of full-duplex
-- streams of data bytes between
-- two sockets in an AppleTalk
-- internet.
-- See [APPLEMAC].
chPortSPX(41), -- Not in RFC 1759
-- Sequenced Packet Exchange (SPX)
-- socket.
-- Novell, Inc. Similar to TCP, a
-- bi-directional data pipe using
-- Novell SPX as a transport.
--
-- prtChannelInformation entries:
--
-- Network Number
-- Keyword: Net
-- Syntax: HexString
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The network number
--
-- Node Number
-- Keyword: Node
-- Syntax: HexString
-- Status: Mandatory
-- Multiplicity: Single
-- Description: The node number
--
-- Socket Number
-- Keyword: Socket
-- Syntax: HexString
-- Status: Mandatory
-- Multiplicity: Single-- Description: The SPX socket number -- -- There must be exactly one "Net" and -- one "Node" and one "Socket" entry. A -- HexString is a binary value -- represented as a string of -- ASCII characters using hexadecimal -- notation. chPortHTTP(42), -- Not in RFC 1759 -- Hypertext Transfer Protocol. See [RFC1945] -- and [RFC2616]. chNDPS(43), -- Not in RFC 1759 -- Novell, Inc.
-- -- prtChannelInformation entry: -- -- Printer Agent Name -- Keyword: PA -- Syntax: Name -- Status: Mandatory -- Multiplicity: Single -- Description: The NDPS Printer -- Agent Name chIPP(44), -- Not in RFC 1759 -- Internet Printing Protocol (IPP), -- (IPP/1.1 - see [RFC2910] and [RFC2911]) -- also applies to all future versions of IPP. -- -- IPP Printer URI -- Keyword: URI -- Syntax: URI (Unicode UTF-8 per -- [RFC2396]) -- Status: Mandatory -- Multiplicity: Single -- Default: not applicable -- Description: URI of this IPP Printer -- within Internet naming scope. Unicode -- UTF-8 [RFC3629] string with -- hexadecimal escapes for any non-ASCII -- characters (per [RFC2396]). -- Conformance: An IPP Printer shall list all -- IPP URI it supports (one per IPP Channel -- entry). If a URI contains the 'http:' -- scheme it must have an explicit port. -- See: [RFC3629], [RFC2396], [RFC2910], -- [RFC2911]. -- -- IPP Printer Client Authentication -- Keyword: Auth -- Syntax: Keyword -- Status: Optional -- Multiplicity: Single -- Default: 'none' -- Description: A client authentication -- mechanism supported for this IPP Printer -- URI: -- 'none' -- no client authentication mechanism -- 'requesting-user-name' -- authenticated user in 'requesting- -- user-name' -- 'basic' -- authenticated user via HTTP Basic -- mechanism -- 'digest' -- authenticated user via HTTP Digest -- mechanism -- 'certificate' -- authenticated user via certificate -- mechanism -- Conformance: An IPP Printer should list -- all IPP client authentication mechanisms -- it supports (one per IPP Channel entry). -- See: [RFC2911] and [RFC2910]. -- -- IPP Printer Security -- Keyword: Security -- Syntax: Keyword -- Status: Optional -- Multiplicity: Single -- Default: 'none' -- Description: A security mechanism -- supported for this IPP Printer URI: -- 'none' -- no security mechanism -- 'ssl3' -- SSL3 secure communications channel -- protocol -- 'tls' -- TLS secure communications channel -- protocol -- Conformance: An IPP Printer should list -- all IPP security mechanisms it supports -- (one per IPP Channel entry). -- See: [RFC2246], [RFC2911]. -- -- IPP Printer Protocol Version -- Keyword: Version -- Syntax: Keyword -- Status: Optional -- Multiplicity: Multiple -- Default: '1.1' -- Description: All of the IPP protocol -- versions (major.minor) supported for -- this IPP Printer URI: -- '1.0' -- IPP/1.0 conforming Printer -- '1.1' -- IPP/1.1 conforming Printer -- Conformance: An IPP Printer should list -- all IPP versions it supports (all listed -- in each IPP Channel entry). An IPP -- Client should select the highest -- numbered version the IPP Client supports -- for use in all IPP Requests (for optimum -- interworking). -- See: [RFC2911]. chSMTP(45) -- Print Job submission via Simple Mail -- Transfer Protocol (SMTP) - see [RFC2821] -- -- prtChannelInformation entry: -- -- Keyword: Mailto -- Syntax: Name -- Status: Mandatory -- Multiplicity: Single -- Default: not applicable -- Description: The SMTP URL of the printer. }
-- -- Interpreter Group TEXTUAL-CONVENTIONs --
PrtInterpreterLangFamilyTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtInterpreterLangFamily in RFC 1759. STATUS current DESCRIPTION "This enumeration indicates the type of interpreter that is receiving jobs." SYNTAX INTEGER { other(1), unknown(2), -- Not in RFC 1759 langPCL(3), -- PCL. Starting with PCL version 5, -- HP-GL/2 is included as part of the -- PCL language. -- PCL and HP-GL/2 are registered -- trademarks of Hewlett-Packard -- Company. langHPGL(4), -- Hewlett-Packard Graphics Language. -- HP-GL is a registered trademark of -- Hewlett-Packard Company. langPJL(5), -- Peripheral Job Language. Appears in -- the data stream between data intended -- for a page description language. -- Hewlett-Packard Co.
okay so the enum keeps going and it is absolutely packed with printer languages 🖨️✨ these are the entries from langPS all the way down to langIDP, bestie 💅
langPS(6), -- PostScript (tm) Language
-- Postscript - a trademark of Adobe
-- Systems Incorporated which may be
-- registered in certain jurisdictions
langIPDS(7), -- Intelligent Printer Data Stream
-- Bi-directional print data stream for
-- documents consisting of data objects
-- (text, image, graphics, bar codes),
-- resources (fonts, overlays) and page,
-- form and finishing instructions.
-- Facilitates system level device
-- control, document tracking and error
-- recovery throughout the print
-- process.
-- IBM Corporation.
langPPDS(8), -- IBM Personal Printer Data Stream.
-- Originally called IBM ASCII, the name
-- was changed to PPDS when the Laser
-- Printer was introduced in 1989.
-- Lexmark International, Inc.
langEscapeP(9), -- Epson Corp.
langEpson(10),
langDDIF(11), -- Digital Document Interchange Format
-- Digital Equipment Corp., Maynard MA
langInterpress(12),
-- Xerox Corp.
langISO6429(13), -- ISO 6429. Control functions for
-- Coded Character Sets (has ASCII
-- control characters, plus additional
-- controls for
-- character imaging devices.)
langLineData(14), -- line-data: Lines of data as
-- separate ASCII or EBCDIC records
-- and containing no control functions
-- (no CR, LF, HT, FF, etc.)
-- For use with traditional line
-- printers. May use CR and/or LF to
-- delimit lines, instead of records.
-- See ISO 10175 Document Printing
-- Application (DPA) [ISO10175].
langMODCA(15), -- Mixed Object Document Content
-- Architecture
-- Definitions that allow the
-- composition, interchange, and
-- presentation of final form
-- documents as a collection of data
-- objects (text, image, graphics, bar
-- codes), resources (fonts, overlays)
-- and page, form and finishing
-- instructions.
-- IBM Corporation.
langREGIS(16), -- Remote Graphics Instruction Set,
-- Digital Equipment Corp., Maynard MA
langSCS(17), -- SNA Character String
-- Bi-directional print data stream for
-- SNA LU-1 mode of communication.
-- IBM
langSPDL(18), -- ISO 10180 Standard Page Description
-- Language
-- ISO Standard
langTEK4014(19), -- Tektronix Corp.
langPDS(20),
langIGP(21), -- Printronix Corp.
langCodeV(22), -- Magnum Code-V, Image and printer
-- control language used to control
-- impact/dot-matrix printers.
-- QMS, Inc., Mobile AL
langDSCDSE(23), -- DSC-DSE: Data Stream Compatible and
-- Emulation Bi-directional print data
-- stream for non-SNA (DSC) and SNA LU-3
-- 3270 controller (DSE) communications
-- IBM
langWPS(24), -- Windows Printing System, Resource
-- based command/data stream used by
-- Microsoft At Work Peripherals.
-- Developed by the Microsoft
-- Corporation.
langLN03(25), -- Early DEC-PPL3, Digital Equipment
-- Corp.
langCCITT(26),
langQUIC(27), -- QUIC (Quality Information Code), Page
-- Description Language for laser
-- printers. Included graphics, printer
-- control capability and emulation of
-- other well-known printer.
-- QMS, Inc.
langCPAP(28), -- Common Printer Access Protocol
-- Digital Equipment Corp.
langDecPPL(29), -- Digital ANSI-Compliant Printing
-- Protocol
-- (DEC-PPL)
-- Digital Equipment Corp.
langSimpleText(30),
-- simple-text: character coded data,
-- including NUL, CR , LF, HT, and FF
-- control characters. See ISO 10175
-- Document Printing Application (DPA)
-- [ISO10175].
langNPAP(31), -- Network Printer Alliance Protocol
-- (NPAP). This protocol has been
-- superseded by the IEEE 1284.1 TIPSI
-- Std (ref. LangTIPSI(49)).
langDOC(32), -- Document Option Commands, Appears in
-- the data stream between data
-- intended for a page description.
-- QMS, Inc.
langimPress(33), -- imPRESS, Page description language
-- originally developed for the
-- ImageServer product line. A binary
-- language providing representations
-- of text, simple graphics, and some
-- large forms (simple
-- bit-map and CCITT group 3/4
-- encoded).The
-- language was intended to be sent over
-- an 8-bit channel and supported early
-- document preparation languages (e.g.,
-- TeX and TROFF).
-- QMS, Inc.
langPinwriter(34),
-- 24 wire dot matrix printer for
-- USA, Europe, and Asia except
-- Japan.
-- More widely used in Germany, and
-- some Asian countries than in US.
-- NEC
langNPDL(35), -- Page printer for Japanese market.
-- NEC
langNEC201PL(36), -- Serial printer language used in
-- the Japanese market.
-- NEC
langAutomatic(37),
-- Automatic PDL sensing. Automatic
-- sensing of the interpreter
-- language family by the printer
-- examining the document content.
-- Which actual interpreter language
-- families are sensed depends on
-- the printer implementation.
langPages(38), -- Page printer Advanced Graphic
-- Escape Set
-- IBM Japan
langLIPS(39), -- LBP Image Processing System
langTIFF(40), -- Tagged Image File Format (Aldus)
langDiagnostic(41),
-- A hex dump of the input to the
-- interpreter
langPSPrinter(42),
-- The PostScript Language used for
-- control (with any PDLs)
-- Adobe Systems Incorporated
langCaPSL(43), -- Canon Print Systems Language
langEXCL(44), -- Extended Command Language
-- Talaris Systems Inc.
langLCDS(45), -- Line Conditioned Data Stream
-- Xerox Corporation
langXES(46), -- Xerox Escape Sequences
-- Xerox Corporation
langPCLXL(47), -- Not in RFC 1759
-- Printer Control Language. Extended
-- language features for printing, and
-- printer control.
-- Hewlett-Packard Co.
langART(48), -- Not in RFC 1759
-- Advanced Rendering Tools (ART).
-- Page Description language
-- originally developed for the Laser
-- Press printers.
-- Technical reference manual: "ART IV
-- Reference Manual", No F33M.
-- Fuji Xerox Co., Ltd.
langTIPSI(49), -- Not in RFC 1759
-- Transport Independent Printer
-- System Interface (ref. IEEE Std.
-- 1284.1)
langPrescribe(50), -- Not in RFC 1759
-- Page description and printer
-- control language. It can be
-- described with ordinary ASCII
-- Technical reference manual:
-- "PRESCRIBE II Programming Manual"
langLinePrinter(51), -- Not in RFC 1759
-- A simple-text character stream which
-- supports the control codes LF, VT,
-- FF, and plus Centronics or
-- Dataproducts Vertical Format Unit
-- (VFU) language is commonly used on
-- many older model line and matrix
-- printers.
langIDP(52), -- Not in RFC 1759
-- Imaging Device Protocol
-- Apple Computer.ngl the vibe here is pure "every printer language ever" energy 🖨️💜 the ones marked "Not in RFC 1759" are the newer additions, and the TIPSI one shows up twice because NPAP points right at it 🫶
langXJCL(53), -- Not in RFC 1759 -- Xerox Job Control Language (JCL). -- A Job Control language originally -- developed for the LaserPress printers -- and is capable of switching PDLs. -- Technical reference manual: -- "ART IV Reference Manual", No F33M. -- Fuji Xerox Co., Ltd. langPDF(54), -- Not in RFC 1759 -- Adobe Portable Document Format -- Adobe Systems, Inc. langRPDL(55), -- Not in RFC 1759 -- Ricoh Page Description Language for -- printers. -- Technical manual "RPDL command -- reference" No.307029 -- RICOH, Co. LTD langIntermecIPL(56), -- Not in RFC 1759 -- Intermec Printer Language for label -- printers. -- Technical Manual: "IPL Programmers -- Reference Manual" -- Intermec Corporation langUBIFingerprint(57), -- Not in RFC 1759 -- An intelligent basic-like programming -- language for label printers. -- Reference Manual: "UBI Fingerprint -- 7.1", No. 1-960434-00 -- United Barcode Industries langUBIDirectProtocol(58), -- Not in RFC 1759 -- An intelligent control language for -- label printers. -- Programmers guide: " UBI Direct -- Protocol", No. 1-960419-00 -- United Barcode Industries langFujitsu(59), -- Not in RFC 1759 -- Fujitsu Printer Language -- Reference Manual: -- "FM Printer Sequence" No. 80HP-0770 -- FUJITSU LIMITED langCGM(60), -- Not in RFC 1759 -- Computer Graphics Metafile -- MIME type 'image/cgm' langJPEG(61), -- Not in RFC 1759 -- Joint Photographic Experts Group -- MIME type 'image/jpeg' langCALS1(62), -- Not in RFC 1759 -- US DOD CALS1 (see MIL-STD-1840) -- MIME type 'application/cals-1840' langCALS2(63), -- Not in RFC 1759 -- US DOD CALS2 (see MIL-STD-1840) -- MIME type 'application/cals-1840' langNIRS(64), -- Not in RFC 1759 -- US DOD NIRS (see MIL-STD-1840) -- MIME type 'application/cals-1840' langC4(65) -- Not in RFC 1759 -- US DOD C4 (see MIL-STD-1840) -- MIME type 'application/cals-1840' }
-- -- Input/Output Group TEXTUAL-CONVENTIONs --
PrtInputTypeTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtInputType in RFC 1759. STATUS current DESCRIPTION "The type of technology (discriminated primarily according to feeder mechanism type) employed by a specific component or components." SYNTAX INTEGER { other(1), unknown(2), sheetFeedAutoRemovableTray(3), sheetFeedAutoNonRemovableTray(4), sheetFeedManual(5), continuousRoll(6), continuousFanFold(7) }
PrtOutputTypeTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtOutputType in RFC 1759. STATUS current DESCRIPTION "The Type of technology supported by this output subunit." SYNTAX INTEGER { other(1), unknown(2), removableBin(3), unRemovableBin(4), continuousRollDevice(5), mailBox(6), continuousFanFold(7) }
-- -- Marker Group TEXTUAL-CONVENTIONs --
PrtMarkerMarkTechTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtMarkerMarkTech in RFC 1759. STATUS current DESCRIPTION "The type of marking technology used for this marking subunit." SYNTAX INTEGER { 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) }
PrtMarkerSuppliesTypeTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtMarkerSuppliesType in RFC 1759. STATUS current DESCRIPTION "The type of this supply." SYNTAX INTEGER { other(1), unknown(2),
-- Values for Printer MIB toner(3), wasteToner(4), ink(5), inkCartridge(6), inkRibbon(7), wasteInk(8), opc(9), -- photo conductor developer(10), fuserOil(11), solidWax(12), ribbonWax(13), wasteWax(14), fuser(15), -- Not in RFC 1759 coronaWire(16), -- Not in RFC 1759 fuserOilWick(17), -- Not in RFC 1759 cleanerUnit(18), -- Not in RFC 1759 fuserCleaningPad(19), -- Not in RFC 1759 transferUnit(20), -- Not in RFC 1759 tonerCartridge(21), -- Not in RFC 1759 fuserOiler(22), -- Not in RFC 1759 -- End of values for Printer MIB -- Values for Finisher MIB water(23), -- Not in RFC 1759 wasteWater(24), -- Not in RFC 1759 glueWaterAdditive(25),-- Not in RFC 1759 wastePaper(26), -- Not in RFC 1759 bindingSupply(27), -- Not in RFC 1759 bandingSupply(28), -- Not in RFC 1759 stitchingWire(29), -- Not in RFC 1759 shrinkWrap(30), -- Not in RFC 1759 paperWrap(31), -- Not in RFC 1759 staples(32), -- Not in RFC 1759 inserts(33), -- Not in RFC 1759 covers(34) -- Not in RFC 1759 -- End of values for Finisher MIB }
-- -- Media Path TEXTUAL-CONVENTIONs --
PrtMediaPathTypeTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtMediaPathType in RFC 1759. STATUS current DESCRIPTION "The type of the media path for this media path." SYNTAX INTEGER {
other(1), unknown(2), longEdgeBindingDuplex(3), shortEdgeBindingDuplex(4), simplex(5) }
-- -- Console Group TEXTUAL-CONVENTIONs --
PrtConsoleColorTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtConsoleColor in RFC 1759. STATUS current DESCRIPTION "The color of this light." SYNTAX INTEGER { other(1), unknown(2), white(3), red(4), green(5), blue(6), cyan(7), magenta(8), yellow(9), orange(10) -- Not in RFC 1759 }
PrtConsoleDisableTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtConsoleDisable in RFC 1759. STATUS current DESCRIPTION "This value indicates whether or not input is accepted from the operator console. A value of 'enabled' indicates that input is accepted from the console, and a value of 'disabled' indicates that input is not accepted from the console. " SYNTAX INTEGER { enabled(3), disabled(4) }
-- -- Alert Group TEXTUAL-CONVENTIONs --
PrtAlertTrainingLevelTC ::= TEXTUAL-CONVENTION -- This TC was extracted from prtAlertTrainingLevel in RFC 1759.
STATUS current DESCRIPTION "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 training required to handle this alert. The printer will break alerts into these different training levels. It is the responsibility of a management application in the system to determine how a particular alert is handled and how and to whom that alert is routed. The following are the four training levels of alerts:
Field Service - Alerts that typically require advanced training and technical knowledge of the printer and its subunits. An example of a technical person would be a manufacturer's Field Service representative, or other person formally trained by the manufacturer or similar representative. Trained - Alerts that require an intermediate or moderate knowledge of the printer and its subunits. A typical example of such an alert is replacing a toner cartridge. 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 or 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 such management events are configuration change of subunits." SYNTAX INTEGER { other(1), unknown(2), untrained(3), trained(4), fieldService(5), management(6), noInterventionRequired(7) -- Not in RFC 1759 }
PrtAlertGroupTC ::= TEXTUAL-CONVENTION
-- Values in the range 1 to 29 must not be IANA-assigned without
-- re-publishing Printer MIB.
-- Values of 30 and greater are for use in MIBs that augment
-- the Printer MIB, such as the Finisher MIB.
-- This TC extracted from prtAlertGroup in RFC 1759.
STATUS current
DESCRIPTION
"The type of subunit 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 subunits.
Wherever possible, the enumerations match the sub-identifier
that identifies the relevant table in the Printer MIB.
NOTE: Alert type codes have been added for the Host Resources
MIB storage table and device table. These additional types
are for situations in which the printer's storage and device
objects must generate alerts (and possibly traps for critical
alerts)."
SYNTAX INTEGER {
other(1),
-- (2) is reserved for conformance information
-- Values for Host Resources MIB
hostResourcesMIBStorageTable(3),
hostResourcesMIBDeviceTable(4),
-- Values for Printer MIB
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), -- Not in RFC 1759
-- Values (5) to (29) reserved for Printer MIB
-- Values for Finisher MIB
finDevice(30), -- Not in RFC 1759
finSupply(31), -- Not in RFC 1759
finSupplyMediaInput(32), -- Not in RFC 1759
finAttribute(33) -- Not in RFC 1759
-- Values (30) to (39) reserved for Finisher MIB
}okay so this one is the alert group type, bestie 💜 It's basically a little menu of which part of the printer an alert is about, like input trays, output, markers, and so on. The numbers 5 through 29 are locked up for the Printer MIB, and 30 and up are for the Finisher MIB 🎀 ✨
okay bestie, we're picking up with the alert code textual convention 🚨✨ This one is the big master list of alert codes, so I'm keeping the whole definition exactly as written 💅
PrtAlertCodeTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtAlertCode in RFC 1759.
STATUS current
DESCRIPTION
"The code that describes the type of alert for this entry in
the table. Binary change event alerts describe states of the
subunit while unary change event alerts describe a single
event. The same alert code can be used for a binary change
event or a unary change event, depending on implementation.
Also, the same alert code can be used to indicate a critical
or non-critical (warning) alert, depending on implementation.
The value of prtAlertSeverityLevel specifies binary vs. unary
and critical vs. non-critical for each event for the
implementation.
While there are some specific codes for many subunits, the
generic codes should be used for most subunit alerts. The
network management station can then query the subunit
specified by prtAlertGroup to determine further subunit
status and other subunit information.
An agent shall not add two entries to the alert table for the
same event, one containing a generic event code and the other
containing a specific event code; the agent shall add only
one entry in the alert table for each event; either generic
(preferred) or specific, not both.
Implementation of the unary change event
alertRemovalOfBinaryChangeEntry(1801) is optional. When
implemented, this alert code shall indicate to network
management stations that the trailing edge of a binary change
event has occurred and the corresponding alert entry has been
removed from the alert table. As with all events, the
alertRemovalOfBinaryChangeEntry(1801) alert shall be placed
at the end of the alert table. Such an alert table entry
shall specify the following information:
prtAlertSeverityLevel warningUnaryChangeEvent(4)
prtAlertTrainingLevel noInterventionRequired(7)
prtAlertGroup alert(18)
prtAlertGroupIndex the index of the row in the
alert table of the binary
change event that this event
has removed.
prtAlertLocation unknown (-2)
prtAlertCode alertRemovalOfBinaryChangeEntry(1801)
prtAlertDescription <description or null string>
prtAlertTime the value of sysUpTime at
the time of the removal of the
binary change event from the
alert table.
Optionally, the agent may generate a trap coincident with
removing the binary change event and placing the unary change
event alertRemovalOfBinaryChangeEntry(1801) in the alert
table. For such a trap, the prtAlertIndex sent with the above
trap parameters shall be the index of the
alertRemovalOfBinaryChangeEvent row that was added to the
prtAlertTable; not the index of the row that was removed from
the prtAlertTable."
SYNTAX INTEGER {
other(1),
-- an event that is not represented
-- by one of the alert codes
-- specified below.
unknown(2),
-- The following generic codes are common to
-- multiple groups. The NMS may examine the
-- prtAlertGroup object to determine what group
-- to query for further information.
coverOpen(3),
coverClosed(4),
interlockOpen(5),
interlockClosed(6),
configurationChange(7),
jam(8),
subunitMissing(9), -- Not in RFC 1759
-- The subunit tray, bin, etc.
-- has been removed.
subunitLifeAlmostOver(10), -- Not in RFC 1759
subunitLifeOver(11), -- Not in RFC 1759
subunitAlmostEmpty(12), -- Not in RFC 1759
subunitEmpty(13), -- Not in RFC 1759
subunitAlmostFull(14), -- Not in RFC 1759
subunitFull(15), -- Not in RFC 1759
subunitNearLimit(16), -- Not in RFC 1759
subunitAtLimit(17), -- Not in RFC 1759
subunitOpened(18), -- Not in RFC 1759
subunitClosed(19), -- Not in RFC 1759
subunitTurnedOn(20), -- Not in RFC 1759
subunitTurnedOff(21), -- Not in RFC 1759
subunitOffline(22), -- Not in RFC 1759
subunitPowerSaver(23), -- Not in RFC 1759
subunitWarmingUp(24), -- Not in RFC 1759
subunitAdded(25), -- Not in RFC 1759
subunitRemoved(26), -- Not in RFC 1759
subunitResourceAdded(27), -- Not in RFC 1759
subunitResourceRemoved(28), -- Not in RFC 1759
subunitRecoverableFailure(29),
-- Not in RFC 1759
subunitUnrecoverableFailure(30),
-- Not in RFC 1759
subunitRecoverableStorageError(31),
-- Not in RFC 1759
subunitUnrecoverableStorageError(32),
-- Not in RFC 1759
subunitMotorFailure(33), -- Not in RFC 1759
subunitMemoryExhausted(34), -- Not in RFC 1759
subunitUnderTemperature(35), -- Not in RFC 1759
subunitOverTemperature(36), -- Not in RFC 1759
subunitTimingFailure(37), -- Not in RFC 1759
subunitThermistorFailure(38), -- Not in RFC 1759
-- General Printer group
doorOpen(501), -- DEPRECATED
-- Use coverOpened(3)
doorClosed(502), -- DEPRECATED
-- Use coverClosed(4)
powerUp(503),
powerDown(504),
printerNMSReset(505), -- Not in RFC 1759
-- The printer has been reset by some
-- network management station(NMS)
-- writing into 'prtGeneralReset'.
printerManualReset(506), -- Not in RFC 1759
-- The printer has been reset manually.
printerReadyToPrint(507), -- Not in RFC 1759
-- The printer is ready to print. (i.e.,
-- not warming up, not in power save
-- state, not adjusting print quality,
-- etc.).
-- Input Group
inputMediaTrayMissing(801),
inputMediaSizeChange(802),
inputMediaWeightChange(803),
inputMediaTypeChange(804),
inputMediaColorChange(805),
inputMediaFormPartsChange(806),
inputMediaSupplyLow(807),
inputMediaSupplyEmpty(808),
inputMediaChangeRequest(809), -- Not in RFC 1759
-- An interpreter has detected that a
-- different medium is need in this input
-- tray subunit. The prtAlertDescription may
-- be used to convey a human readable
-- description of the medium required to
-- satisfy the request.
inputManualInputRequest(810), -- Not in RFC 1759
-- An interpreter has detected that manual
-- input is required in this subunit. The
-- prtAlertDescription may be used to convey
-- a human readable description of the medium
-- required to satisfy the request.
inputTrayPositionFailure(811), -- Not in RFC 1759
-- The input tray failed to position correctly.
inputTrayElevationFailure(812),
-- Not in RFC 1759
inputCannotFeedSizeSelected(813),
-- Not in RFC 1759
-- Output Group
outputMediaTrayMissing(901),
outputMediaTrayAlmostFull(902),
outputMediaTrayFull(903),
outputMailboxSelectFailure(904),
-- Not in RFC 1759
-- Marker group
markerFuserUnderTemperature(1001),
markerFuserOverTemperature(1002),
markerFuserTimingFailure(1003),
-- Not in RFC 1759
markerFuserThermistorFailure(1004),
-- Not in RFC 1759
markerAdjustingPrintQuality(1005),
-- Not in RFC 1759
-- Marker Supplies group
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),
-- Not in RFC 1759
-- Media Path Device Group
mediaPathMediaTrayMissing(1301),
mediaPathMediaTrayAlmostFull(1302),
mediaPathMediaTrayFull(1303),
mediaPathCannotDuplexMediaSelected(1304),
-- Not in RFC 1759
-- Interpreter Group
interpreterMemoryIncrease(1501),
interpreterMemoryDecrease(1502),
interpreterCartridgeAdded(1503),
interpreterCartridgeDeleted(1504),
interpreterResourceAdded(1505),
interpreterResourceDeleted(1506),
interpreterResourceUnavailable(1507),
interpreterComplexPageEncountered(1509),
-- Not in RFC 1759
-- The interpreter has encountered a page
-- that is too complex for the resources that
-- are available.
-- Alert Group
alertRemovalOfBinaryChangeEntry(1801)
-- Not in RFC 1759
-- A binary change event entry has been
-- removed from the alert table. This unary
-- change alert table entry is added to the
-- end of the alert table.
}
ENDphew, that's the whole alert code list 🫶 more coming up next, so stay tuned 🦋
okay bestie, we're finally in the actual Printer MIB module 🖨️✨ this is where the IMPORTS list pulls in all the building blocks we need, and then the module identity tells you who made it and what changed from RFC 1759 💖
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Counter32, Integer32, TimeTicks,
NOTIFICATION-TYPE, OBJECT-IDENTITY,
mib-2 FROM SNMPv2-SMI -- [RFC2578]
TEXTUAL-CONVENTION FROM SNMPv2-TC -- [RFC2579]
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
FROM SNMPv2-CONF -- [RFC2580]
hrDeviceIndex, hrStorageIndex FROM HOST-RESOURCES-MIB -- [RFC2790]
InterfaceIndexOrZero FROM IF-MIB -- [RFC2863]
PrtCoverStatusTC, PrtGeneralResetTC, PrtChannelTypeTC,
PrtInterpreterLangFamilyTC, PrtInputTypeTC, PrtOutputTypeTC,
PrtMarkerMarkTechTC, PrtMarkerSuppliesTypeTC, PrtConsoleColorTC,
PrtConsoleDisableTC, PrtMediaPathTypeTC, PrtAlertGroupTC,
PrtAlertTrainingLevelTC, PrtAlertCodeTC
FROM IANA-PRINTER-MIB
IANACharset FROM IANA-CHARSET-MIB;
printmib MODULE-IDENTITY
LAST-UPDATED "200406020000Z"
ORGANIZATION "PWG IEEE/ISTO Printer Working Group"
CONTACT-INFO
"Harry Lewis
IBM
Phone (303) 924-5337
Email: harryl@us.ibm.com
http://www.pwg.org/index.html
Send comments to the printmib WG using the Printer MIB
Project (PMP) Mailing List: pmp@pwg.org
For further information, access the PWG web page under 'Printer
MIB': http://www.pwg.org/
Implementers of this specification are encouraged to join the
pmp mailing list in order to participate in discussions on any
clarifications needed and registration proposals being reviewed
in order to achieve consensus."
DESCRIPTION
"The MIB module for management of printers.
Copyright (C) The Internet Society (2004). This
version of this MIB module was published
in RFC 3805. For full legal notices see the RFC itself."
REVISION "200406020000Z"
DESCRIPTION
"Printer MIB v2.
Moved all enum groups to be maintained by IANA into new TCs
within the ianaPrinterMIB, which is contained in this
document.
New TCs created from enums defined within RFC 1759 Objects:
PrtPrintOrientationTC, PrtLocalizedDescriptionStringTC,
PrtConsoleDescriptionStringTC, PrtChannelStateTC,
PrtOutputStackingOrderTC, PrtOutputPageDeliveryOrientationTC,
PrtMarkerCounterUnitTC, PrtMarkerSuppliesSupplyUnitTC,
PrtMarkerSuppliesClassTC, PrtMarkerAddressabilityUnitTC,
PrtMarkerColorantRoleTC, PrtMediaPathMaxSpeedPrintUnitTC,
PrtInterpreterTwoWayTC, and PrtAlertSeverityLevelTC.
The following four TCs have been deprecated:
MediaUnit (replaced by PrtMediaUnitTC),
CapacityUnit (replaced by PrtCapacityUnitTC),
SubUnitStatus (replaced by PrtSubUnitStatusTC),
CodedCharSet (replaced by IANACharset in IANA Charset MIB)
Five new OBJECT-GROUPs: prtAuxilliarySheetGroup,
prtInputSwitchingGroup, prtGeneralV2Group,
prtAlertTableV2Group, prtChannelV2Group.
Nine new objects added to those groups:
prtAuxiliarySheetStartupPage, prtAuxiliarySheetBannerPage,
prtGeneralPrinterName, prtGeneralSerialNumber,
prtAlertCriticalEvents, prtAlertAllEvents,
prtInputMediaLoadTimeout, prtInputNextIndex,
prtChannelInformation.
SYNTAX range changed from (0..65535) to (1..65535) for the
index objects prtStorageRefSeqNumber, prtDeviceRefSeqNumber,
and prtConsoleLightIndex.
SYNTAX range changed from (0..65535) to (0..2147483647) for the
objects prtStorageRefIndex and prtDeviceRefIndex to agree
with the Host Resources MIB.
Defined a range for the objects with a SYNTAX of Integer32:
prtOutputDefaultIndex, prtInputMediaDimFeedDirDeclared,
prtInputMediaDimXFeedDirDeclared, prtInputMaxCapacity,
prtInputCurrentLevel, prtInputMediaDimFeedDirChosen,
prtInputMediaDimXFeedDirChosen, prtInputMediaWeight,
prtInputMediaFormParts, prtOutputIndex,
prtOutputMaxCapacity, prtOutputRemainingCapacity,
prtOutputMaxDimFeedDir, prtOutputMaxDimXFeedDir,
prtOutputMinDimFeedDir, prtOutputMinDimXFeedDir,
prtMarkerAddressibilityFeedDir,
prtMarkerAddressibilityXFeedDir, prtMarkerNorthMargin,
prtMarkerSouthMargin, prtMarkerWestMargin,
prtMarkerEastMargin, prtMarkerSuppliesMaxCapacity,
prtMarkerSuppliesLevel, prtMarkerColorantTonality,
prtMediaPathMaxSpeed, prtMediaPathMaxMediaFeedDir,
prtMediaPathMaxMediaXFeedDir, prtMediaPathMinMediaFeedDir,
prtMediaPathMinMediaXFeedDir, prtChannelIndex,
prtChannelCurrentJobCntlLangIndex, prtInterpreterIndex,
prtChannelDefaultPageDescLangIndex, prtConsoleOnTime,
prtInterpreterFeedAddressibility, prtConsoleOffTime,
prtInterpreterXFeedAddressibility, prtAlertIndex,
prtAlertGroupIndex, prtAlertLocation.
Changed SYNTAX from Integer32 to InterfaceIndexOrZero for
prtChannelIfIndex.
Changed MAX-ACCESS of prtAlertIndex from not-accessible to
Read-only and added a compliance statement to allow a
MIN-ACCESS of accessible-for-notify.
One new NOTIFICATION-GROUP: prtAlertTrapGroup which contains
printerV2Alert.
In MODULE-COMPLIANCE prtMIBCompliance, new OBJECT-GROUPs and
the NOTIFICATION_GROUP, all in GROUP (not MANDATORY-GROUP)
clauses. The nine new objects are optional, i.e., this
document is backward compatible with RFC 1759."
REVISION "199411250000Z"
DESCRIPTION
"The original version of this MIB, published as RFC1759."
::= { mib-2 43 }that's the module header done ✨ it tells you which objects got new ranges, which ones got renamed, and the super important bit at the end: this whole thing is still backward compatible with RFC 1759 🥹🎀 now let's look at the textual conventions, which are basically the reusable types everything else borrows from 💅
-- TEXTUAL-CONVENTIONs for this MIB module
--
-- Generic unspecific TEXTUAL-CONVENTIONs
--
PrtMediaUnitTC ::= TEXTUAL-CONVENTION
-- Replaces MediaUnit in RFC 1759.
STATUS current
DESCRIPTION
"Units of measure for media dimensions."
SYNTAX INTEGER {
tenThousandthsOfInches(3), -- .0001
micrometers(4)
}
MediaUnit ::= TEXTUAL-CONVENTION
-- Replaced by PrtMediaUnitTC.
STATUS deprecated
DESCRIPTION
"Units of measure for media dimensions."
SYNTAX INTEGER {
tenThousandthsOfInches(3), -- .0001
micrometers(4)
}
PrtCapacityUnitTC ::= TEXTUAL-CONVENTION
-- Replaces CapacityUnit in RFC 1759.
STATUS current
DESCRIPTION
"Units of measure for media capacity."
SYNTAX INTEGER {
other(1), -- New, not in RFC 1759
unknown(2), -- New, not in RFC 1759
tenThousandthsOfInches(3), -- .0001
micrometers(4),
sheets(8),
feet(16),
meters(17),
-- Values for Finisher MIB
items(18), -- New, not in RFC 1759
percent(19) -- New, not in RFC 1759
}
CapacityUnit ::= TEXTUAL-CONVENTION
-- Replaced by PrtCapacityUnitTC.
STATUS deprecated
DESCRIPTION
"Units of measure for media capacity."
SYNTAX INTEGER {
tenThousandthsOfInches(3), -- .0001
micrometers(4),
sheets(8),
feet(16),
meters(17)
}
PrtPrintOrientationTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtInterpreterDefaultOrientation in
-- RFC 1759.
STATUS current
DESCRIPTION
"A generic representation for printing orientation on a
'page'."
SYNTAX INTEGER {
other(1),
portrait(3),
landscape(4)
}notice the deprecated status on the old MediaUnit and CapacityUnit TCs 👀 the new Prt...TC versions are the ones to use going forward, bestie, the old ones are just hanging around for compatibility 🌸
PrtSubUnitStatusTC ::= TEXTUAL-CONVENTION
-- Replaces SubUnitStatus in RFC 1759.
STATUS current
DESCRIPTION
"Status of a printer sub-unit.
The SubUnitStatus is an integer that is the sum of 5 distinct
values, Availability, Non-Critical, Critical, On-line, and
Transitioning. These values are:
Availability Value
Available and Idle 0 0000'b
Available and Standby 2 0010'b
Available and Active 4 0100'b
Available and Busy 6 0110'b
Unavailable and OnRequest 1 0001'b
Unavailable because Broken 3 0011'b
Unknown 5 0101'b
Non-Critical
No Non-Critical Alerts 0 0000'b
Non-Critical Alerts 8 1000'b
Critical
No Critical Alerts 0 0000'b
Critical Alerts 16 1 0000'b
On-Line
State is On-Line 0 0000'b
State is Off-Line 32 10 0000'b
Transitioning
At intended state 0 0000'b
Transitioning to intended state 64 100 0000'b"
SYNTAX INTEGER (0..126)
SubUnitStatus ::= TEXTUAL-CONVENTION
-- Replaced by PrtSubUnitStatusTC.
STATUS deprecated
DESCRIPTION
"Status of a printer sub-unit.
The SubUnitStatus is an integer that is the sum of 5 distinct
values, Availability, Non-Critical, Critical, On-line, and
Transitioning. These values are:
Availability Value
Available and Idle 0 0000'b
Available and Standby 2 0010'b
Available and Active 4 0100'b
Available and Busy 6 0110'b
Unavailable and OnRequest 1 0001'b
Unavailable because Broken 3 0011'b
Unknown 5 0101'b
Non-Critical
No Non-Critical Alerts 0 0000'b
Non-Critical Alerts 8 1000'b
Critical
No Critical Alerts 0 0000'b
Critical Alerts 16 1 0000'b
On-Line
State is On-Line 0 0000'b
State is Off-Line 32 10 0000'b
Transitioning
At intended state 0 0000'b
Transitioning to intended state 64 100 0000'b"
SYNTAX INTEGER (0..126)
PresentOnOff ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"Presence and configuration of a device or feature."
SYNTAX INTEGER {
other(1),
on(3),
off(4),
notPresent(5)
}
PrtLocalizedDescriptionStringTC ::= TEXTUAL-CONVENTION
-- This TC did not appear in RFC 1759.
STATUS current
DESCRIPTION
"An object MUST use this TEXTUAL-CONVENTION when its
'charset' is controlled by the value of
prtGeneralCurrentLocalization."
SYNTAX OCTET STRING (SIZE(0..255))
PrtConsoleDescriptionStringTC ::= TEXTUAL-CONVENTION
-- This TC did not appear in RFC 1759.
STATUS current
DESCRIPTION
"An object MUST use this TEXTUAL-CONVENTION when its
'charset' is controlled by the value of
prtConsoleLocalization."
SYNTAX OCTET STRING (SIZE(0..255))the SubUnitStatus bit-math is giving pure binary puzzle 🧩💜 each state is just a value you add together, so a sub-unit can be "Non-Critical Alerts" plus "State is Off-Line" in one number 🦋 and the two MUST lines up top are the one spot in this chunk where the RFC is telling you exactly what has to happen 💖
Okay so the CodedCharSet one is deprecated 🥀 but it still gets a seat at the table, so let's look at it 💅
CodedCharSet ::= TEXTUAL-CONVENTION
-- Replaced by IANACharset TEXTUAL-CONVENTION in IANA Charset MIB.
STATUS deprecated
DESCRIPTION
"The original description clause from RFC 1759 [RFC1759] was
technically inaccurate and therefore has been deleted."
SYNTAX INTEGER {
other(1) -- used if the designated coded
-- character set is not currently in
-- the enumeration
}Now the Channel Group, which is giving organised and tidy 🎀
--
-- Channel Group TEXTUAL-CONVENTIONs
--
PrtChannelStateTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtChannelState in RFC 1759.
STATUS current
DESCRIPTION
"The state of this print job delivery channel. The value
determines whether print data is allowed through this channel."
SYNTAX INTEGER {
other(1),
printDataAccepted(3),
noDataAccepted(4)
}The Input/Output group is where the stacking and page-delivery drama happens 📄✨
--
-- Input/Output Group TEXTUAL-CONVENTIONs
--
PrtOutputStackingOrderTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtOutputStackingOrder in RFC 1759.
STATUS current
DESCRIPTION
"The current state of the stacking order for the associated
output sub-unit. 'firstToLast' means that as pages are output,
the front of the next page is placed against the back of the
previous page. 'lastToFirst' means that as pages are output,
the back of the next page is placed against the front of the
previous page."
SYNTAX INTEGER {
unknown(2),
firstToLast(3),
lastToFirst(4)
}
PrtOutputPageDeliveryOrientationTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtOutputPageDeliveryOrientation
-- in RFC 1759.
STATUS current
DESCRIPTION
"The reading surface that will be 'up' when pages are delivered
to the associated output sub-unit. Values are Face-Up and Face
Down (Note: interpretation of these values is, in general,
context-dependent based on locale; presentation of these values
to an end-user should be normalized to the expectations of the
user."
SYNTAX INTEGER {
faceUp(3),
faceDown(4)
}Marker Group next, and ngl it has the most TCs of the bunch 🦋
--
-- Marker Group TEXTUAL-CONVENTIONs
--
PrtMarkerCounterUnitTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtMarkerCounterUnit in RFC 1759.
STATUS current
DESCRIPTION
"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."
SYNTAX INTEGER {
tenThousandthsOfInches(3), -- .0001
micrometers(4),
characters(5),
lines(6),
impressions(7),
sheets(8),
dotRow(9),
hours(11),
feet(16),
meters(17)
}
PrtMarkerSuppliesSupplyUnitTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtMarkerSuppliesSupplyUnit
-- in RFC 1759.
STATUS current
DESCRIPTION
"Unit of this marker supply container/receptacle."
SYNTAX INTEGER {
other(1), -- New, not in RFC 1759
unknown(2), -- New, not in RFC 1759
tenThousandthsOfInches(3), -- .0001
micrometers(4),
impressions(7), -- New, not in RFC 1759
sheets(8), -- New, not in RFC 1759
hours(11), -- New, not in RFC 1759
thousandthsOfOunces(12),
tenthsOfGrams(13),
hundrethsOfFluidOunces(14),
tenthsOfMilliliters(15),
feet(16), -- New, not in RFC 1759
meters(17), -- New, not in RFC 1759
-- Values for Finisher MIB
items(18), -- e.g., #staples. New, not in RFC 1759
percent(19) -- New, not in RFC 1759
}
PrtMarkerSuppliesClassTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtMarkerSuppliesClass in RFC 1759.
STATUS current
DESCRIPTION
"Indicates whether this supply entity represents a supply
that is consumed or a receptacle that is filled."
SYNTAX INTEGER {
other(1),
supplyThatIsConsumed(3),
receptacleThatIsFilled(4)
}
PrtMarkerColorantRoleTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtMarkerColorantRole in RFC 1759.
STATUS current
DESCRIPTION
"The role played by this colorant."
SYNTAX INTEGER { -- Colorant Role
other(1),
process(3),
spot(4)
}
PrtMarkerAddressabilityUnitTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtMarkerAddressabilityUnit
-- in RFC 1759.
STATUS current
DESCRIPTION
"The unit of measure of distances, as applied to the marker's
resolution."
SYNTAX INTEGER {
tenThousandthsOfInches(3), -- .0001
micrometers(4)
}Media Path is up next, and it's all about speed 🏃♀️💨
--
-- Media Path TEXTUAL-CONVENTIONs
--
PrtMediaPathMaxSpeedPrintUnitTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtMediaPathMaxSpeedPrintUnit
-- in RFC 1759.
STATUS current
DESCRIPTION
"The unit of measure used in specifying the speed of all
media paths in the printer."
SYNTAX INTEGER {
tenThousandthsOfInchesPerHour(3),-- .0001/hour
micrometersPerHour(4),
charactersPerHour(5),
linesPerHour(6),
impressionsPerHour(7),
sheetsPerHour(8),
dotRowPerHour(9),
feetPerHour(16),
metersPerHour(17)
}Interpreter group, short and sweet 🍓
--
-- Interpreter Group TEXTUAL-CONVENTIONs
--
PrtInterpreterTwoWayTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtInterpreterTwoWay in RFC 1759.
STATUS current
DESCRIPTION
"Indicates whether or not this interpreter returns information
back to the host."
SYNTAX INTEGER {
yes(3),
no(4)
}The Alert group is where the drama lives, so pay attention 🚨👀
--
-- Alert Group TEXTUAL-CONVENTIONs
--
PrtAlertSeverityLevelTC ::= TEXTUAL-CONVENTION
-- This TC was extracted from prtAlertSeverityLevel in RFC 1759.
STATUS current
DESCRIPTION
"The level of severity of this alert table entry. The printer
determines the severity level assigned to each entry in the
table. A critical alert is binary by nature and definition. A
warning is defined to be a non-critical alert. The original and
most common warning is unary. The binary warning was added later
and given a more distinguished name."
SYNTAX INTEGER {
other(1),
critical(3),
warning(4),
warningBinaryChangeEvent(5) -- New, not in RFC 1759
}And finally the General Printer Group, the boss of the whole printer 👑🖨️
-- The General Printer Group
--
-- The general printer sub-unit is responsible for the overall
-- control and status of the printer. There is exactly one
-- general printer sub-unit in a printer.
prtGeneral OBJECT IDENTIFIER ::= { printmib 5 }
prtGeneralTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtGeneralEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of general information per printer.
Objects in this table are defined in various
places in the MIB, nearby the groups to
which they apply. They are all defined
here to minimize the number of tables that would
otherwise need to exist."
::= { prtGeneral 1 }
prtGeneralEntry OBJECT-TYPE
SYNTAX PrtGeneralEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry exists in this table for each device entry in the
host resources MIB device table with a device type of
'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex }
::= { prtGeneralTable 1 }
PrtGeneralEntry ::= SEQUENCE {
-- Note that not all of the objects in this sequence are in
-- the general printer group. The group to which an
-- object belongs is tagged with a label "General", "Input"
-- "Output", etc. after each entry in the following sequence.
--
prtGeneralConfigChanges Counter32, -- General
prtGeneralCurrentLocalization Integer32, -- General
prtGeneralReset PrtGeneralResetTC,
-- General
prtGeneralCurrentOperator OCTET STRING,
-- Responsible Party
prtGeneralServicePerson OCTET STRING,
-- Responsible Party
prtInputDefaultIndex Integer32, -- Input
prtOutputDefaultIndex Integer32, -- Output
prtMarkerDefaultIndex Integer32, -- Marker
prtMediaPathDefaultIndex Integer32, -- Media Path
prtConsoleLocalization Integer32, -- Console
prtConsoleNumberOfDisplayLines Integer32, -- Console
prtConsoleNumberOfDisplayChars Integer32, -- Console
prtConsoleDisable PrtConsoleDisableTC,
-- Console,
prtAuxiliarySheetStartupPage PresentOnOff,
-- AuxiliarySheet
prtAuxiliarySheetBannerPage PresentOnOff,
-- AuxiliarySheet
prtGeneralPrinterName OCTET STRING,
-- General V2
prtGeneralSerialNumber OCTET STRING,
-- General V2
prtAlertCriticalEvents Counter32, -- Alert V2
prtAlertAllEvents Counter32 -- Alert V2
}Okay bestie, this is where the General group gets its config-change counter, its operator contact info, and its default index pointers. Let's go 💅✨
prtGeneralConfigChanges OBJECT-TYPE is the counter that tells management apps when their cached printer info is stale 🧠💜
prtGeneralConfigChanges OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Counts configuration changes within the printer. A
configuration change is defined to be an action that results in
a change to any MIB object other than those that reflect status
or level, or those that act as counters or gauges. In addition,
any action that results in a row being added or deleted from
any table in the Printer MIB is considered a configuration
change. Such changes will often affect the capability of the
printer to service certain types of print jobs. Management
applications may cache infrequently changed configuration
information about sub units within the printer. This object
should be incremented whenever the agent wishes to notify
management applications that any cached configuration
information for this device is to be considered 'stale'. At
this point, the management application should flush any
configuration information cached about this device and fetch
new configuration information.
The following are examples of actions that would cause the
prtGeneralConfigChanges object to be incremented:
- Adding an output bin
- Changing the media in a sensing input tray
- Changing the value of prtInputMediaType
Note that the prtGeneralConfigChanges counter would not be
incremented when an input tray is temporarily removed to load
additional paper or when the level of an input device changes.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtGeneralEntry 1 }
prtGeneralCurrentLocalization OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of the prtLocalizationIndex corresponding to the
current language, country, and character set to be used for
localized string values that are identified as being dependent
on the value of this object. Note that this object does not
apply to localized strings in the prtConsole group or to any
object that is not explicitly identified as being localized
according to prtGeneralCurrentLocalization. When an object's
'charset' is controlled by the value of
prtGeneralCurrentLocalization, it MUST specify
PrtLocalizedDescriptionStringTC as its syntax.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtGeneralEntry 2 }
prtGeneralReset OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly defined
-- by this object.
SYNTAX PrtGeneralResetTC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Setting this value to 'powerCycleReset', 'resetToNVRAM', or
'resetToFactoryDefaults' will result in the resetting of the
printer. When read, this object will always have the value
'notResetting(3)', and a SET of the value 'notResetting' shall
have no effect on the printer. Some of the defined values are
optional. However, every implementation must support at least
the values 'notResetting' and 'resetToNVRAM'."
::= { prtGeneralEntry 3 }
-- The Responsible Party group
prtGeneralCurrentOperator OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..127))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The name of the person who is responsible for operating
this printer. It is suggested that this string include
information that would enable other humans to reach the
operator, such as a phone number. As a convention to
facilitate automatic notification of the operator by the
agent or network management station, the phone number,
fax number or email address should be indicated by the
URL schemes 'tel:', 'fax:' and 'mailto:', respectively.
If either the phone, fax, or email information is not
available, then a line should not be included for this
information.
NOTE: For interoperability purposes, it is advisable to
use email addresses formatted according to [RFC2822]
requirements.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtGeneralEntry 4 }
prtGeneralServicePerson OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..127))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The name of the person responsible for servicing this
printer. It is suggested that this string include
information that would enable other humans to reach the
service person, such as a phone number. As a convention
to facilitate automatic notification of the operator by
the agent or network management station, the phone
number, fax number or email address should be indicated
by the URL schemes 'tel:', 'fax:' and 'mailto:',
respectively. If either the phone, fax, or email
information is not available, then a line should not
be included for this information.
NOTE: For interoperability purposes, it is advisable to use
email addresses formatted per [RFC2822] requirements.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtGeneralEntry 5 }
-- Default indexes section
--
-- The following four objects are used to specify the indexes of
-- certain subunits used as defaults during the printing process.
prtInputDefaultIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of prtInputIndex corresponding to the default input
sub-unit: that is, this object selects the default source of
input media."
::= { prtGeneralEntry 6 }
prtOutputDefaultIndex OBJECT-TYPE
-- A range has been added to the SYNTAX clause that was not in
-- RFC 1759. Although this violates SNMP compatibility rules,
-- it provides a more reasonable guide for SNMP managers.
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of prtOutputIndex corresponding to the default
output sub-unit; that is, this object selects the default
output destination."
::= { prtGeneralEntry 7 }
prtMarkerDefaultIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of prtMarkerIndex corresponding to the
default marker sub-unit; that is, this object selects the
default marker."
::= { prtGeneralEntry 8 }
prtMediaPathDefaultIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of prtMediaPathIndex corresponding to
the default media path; that is, the selection of the
default media path."
::= { prtGeneralEntry 9 }
-- Console general section
--
-- The following four objects describe overall parameters of the
-- printer console subsystem.
prtConsoleLocalization OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of the prtLocalizationIndex corresponding to
the language, country, and character set to be used for the
console. This localization applies both to the actual display
on the console as well as the encoding of these console objects
in management operations. When an object's 'charset' is
controlled by the value of prtConsoleLocalization, it MUST
specify PrtConsoleDescriptionStringTC as its syntax.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtGeneralEntry 10 }
prtConsoleNumberOfDisplayLines OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of lines on the printer's physical
display. This value is 0 if there are no lines on the
physical display or if there is no physical display"
::= { prtGeneralEntry 11 }
prtConsoleNumberOfDisplayChars OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of characters per line displayed on the physical
display. This value is 0 if there are no lines on the physical
display or if there is no physical display"
::= { prtGeneralEntry 12 }
prtConsoleDisable OBJECT-TYPE
-- In RFC 1759, the enumeration values were implicitly defined
-- by this object.
SYNTAX PrtConsoleDisableTC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This value indicates how input is (or is not) accepted from
the operator console.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtGeneralEntry 13 }
-- The Auxiliary Sheet Group
--
-- The auxiliary sheet group allows the administrator to control
-- the production of auxiliary sheets by the printer. This group
-- contains only the "prtAuxiliarySheetStartupPage" and
-- "prtAuxiliarySheetBannerPage" objects.
prtAuxiliarySheetStartupPage OBJECT-TYPE
SYNTAX PresentOnOff
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Used to enable or disable printing a startup page. If enabled,
a startup page will be printed shortly after power-up, when the
device is ready. Typical startup pages include test patterns
and/or printer configuration information."
::= { prtGeneralEntry 14 }
prtAuxiliarySheetBannerPage OBJECT-TYPE
SYNTAX PresentOnOff
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Used to enable or disable printing banner pages at the
beginning of jobs. This is a master switch which applies to all
jobs, regardless of interpreter."
::= { prtGeneralEntry 15 }
-- Administrative section (The General V2 Group)
--
-- The following two objects are used to specify administrative
-- information assigned to the printer.
prtGeneralPrinterName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..127))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"An administrator-specified name for this printer. Depending
upon implementation of this printer, the value of this object
may or may not be same as the value for the MIB-II 'SysName'
object."
::= { prtGeneralEntry 16 }
prtGeneralSerialNumber OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..255))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A recorded serial number for this device that indexes some
type device catalog or inventory. This value is usually set by
the device manufacturer but the MIB supports the option of
writing for this object for site-specific administration of
device inventory or tracking."
::= { prtGeneralEntry 17 }
-- General alert table section (Alert Table V2 Group)
--
-- The following two objects are used to specify counters
-- associated with the Alert Table.
prtAlertCriticalEvents OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A running counter of the number of critical alert events that
have been recorded in the alert table. The value of this object
is RESET in the event of a power cycle operation (i.e., the
value is not persistent."
::= { prtGeneralEntry 18 }prtAlertAllEvents is the running total of every alert, critical and non-critical, so the counter keeps climbing as entries get recorded 💖
prtAlertAllEvents OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A running counter of the total number of alert event entries
(critical and non-critical) that have been recorded in the
alert table"
::= { prtGeneralEntry 19 }The Cover Table ✨
okay so the cover table is all about the covers and interlocks on the printer 🎀 there's one row for each cover and each interlock, and it's giving very organized energy 💅
-- The Cover Table
--
-- The cover portion of the General print sub-unit describes the
-- covers and interlocks of the printer. The Cover Table has an
-- entry for each cover and interlock.
prtCover OBJECT IDENTIFIER ::= { printmib 6 }
prtCoverTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtCoverEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of the covers and interlocks of the printer."
::= { prtCover 1 }
prtCoverEntry OBJECT-TYPE
SYNTAX PrtCoverEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a cover or interlock.
Entries may exist in the table for each device
index with a device type of 'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtCoverIndex }
::= { prtCoverTable 1 }
PrtCoverEntry ::= SEQUENCE {
prtCoverIndex Integer32,
prtCoverDescription PrtLocalizedDescriptionStringTC,
prtCoverStatus PrtCoverStatusTC
}
prtCoverIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this Cover sub
unit. Although these values may change due to a major
reconfiguration of the device (e.g., the addition of new cover
sub-units to the printer), values SHOULD remain stable across
successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtCoverEntry 1 }
prtCoverDescription OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtLocalizedDescriptionStringTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The manufacturer provided cover sub-mechanism name in the
localization specified by prtGeneralCurrentLocalization."
::= { prtCoverEntry 2 }
prtCoverStatus OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly defined
-- by this object and are now defined in the IANA-PRINTER-MIB. The
-- new TC has defined "coverOpen" and "coverClosed" to replace
-- "doorOpen" and "doorClosed" in RFC 1759. A name change is not
-- formally allowed per SMI rules, but was agreed to by the WG group
-- since a door has a more restrictive meaning than a cover and
-- Cover group is intended to support doors as a subset of covers.
SYNTAX PrtCoverStatusTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The status of this cover sub-unit."
::= { prtCoverEntry 3 }The Localization Table 🌸
the localization bit is where the printer says which natural language, country and character set its strings use 🌈 a printer can support more than one localization, and this table lists them all 🫶
-- The Localization Table
--
-- The localization portion of the General printer sub-unit is
-- responsible for identifying the natural language, country, and
-- character set in which character strings are expressed. There
-- may be one or more localizations supported per printer. The
-- available localizations are represented by the Localization
-- table.
prtLocalization OBJECT IDENTIFIER ::= { printmib 7 }
prtLocalizationTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtLocalizationEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The available localizations in this printer."
::= { prtLocalization 1 }
prtLocalizationEntry OBJECT-TYPE
SYNTAX PrtLocalizationEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A description of a localization.
Entries may exist in the table for each device
index with a device type of 'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtLocalizationIndex }
::= { prtLocalizationTable 1 }
PrtLocalizationEntry ::= SEQUENCE {
prtLocalizationIndex Integer32,
prtLocalizationLanguage OCTET STRING,
prtLocalizationCountry OCTET STRING,
prtLocalizationCharacterSet IANACharset
}
prtLocalizationIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this
localization entry. Although these values may change due to a
major reconfiguration of the device (e.g., the addition of new
localization data to the printer), values SHOULD remain
stable across successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtLocalizationEntry 1 }
prtLocalizationLanguage OBJECT-TYPE
-- Note: The size is fixed, was incorrectly 0..2 in RFC 1759.
SYNTAX OCTET STRING (SIZE(2))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A two character language code from ISO 639. Examples en,
es, fr, de. NOTE: These examples were shown as upper case in
RFC 1759 and are now shown as lower case to agree with ISO 639."
::= { prtLocalizationEntry 2 }
prtLocalizationCountry OBJECT-TYPE
-- Note: The size is fixed, was incorrectly 0..2 in RFC 1759.
SYNTAX OCTET STRING (SIZE(2))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A two character country code from ISO 3166, a blank string
(two space characters) shall indicate that the country is not
defined. Examples: US, GB, FR, DE, ..."
::= { prtLocalizationEntry 3 }
prtLocalizationCharacterSet OBJECT-TYPE
SYNTAX IANACharset
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The coded character set used for this localization."
::= { prtLocalizationEntry 4 }The System Resources Tables 🧚
this part is where the Printer MIB borrows from the Host Resources MIB 💜 it uses the storage and device groups to show which system resources belong to which printer, and when one agent is looking after several printers, these tables keep track of who owns what 👑
-- The System Resources Tables
--
-- The Printer MIB makes use of the Host Resources MIB to
-- define system resources by referencing the storage
-- and device groups of the print group.
prtStorageRefTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtStorageRefEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table defines which printer, amongst multiple printers
serviced by one agent, owns which storage units.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtGeneral 2 }
prtStorageRefEntry OBJECT-TYPE
SYNTAX PrtStorageRefEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table will have an entry for each entry in the Host
Resources MIB storage table that represents storage associated
with a printer managed by this agent.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrStorageIndex, prtStorageRefSeqNumber }
::= { prtStorageRefTable 1 }
PrtStorageRefEntry ::= SEQUENCE {
prtStorageRefSeqNumber Integer32,
prtStorageRefIndex Integer32
}
prtStorageRefSeqNumber OBJECT-TYPE
-- NOTE: The range has been changed from RFC 1759, which allowed a
-- minumum value of zero. This was incorrect, since zero is not a
-- valid index.
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This value will be unique amongst all entries with a common
value of hrStorageIndex. This object allows a storage entry to
point to the multiple printer devices with which it is
associated."
::= { prtStorageRefEntry 1 }
prtStorageRefIndex OBJECT-TYPE
-- NOTE: The range has been changed from RFC 1759 to be compatible
-- with the defined range of hrDeviceIndex.
SYNTAX Integer32 (0..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the hrDeviceIndex of the printer device that this
storageEntry is associated with."
::= { prtStorageRefEntry 2 }
prtDeviceRefTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtDeviceRefEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table defines which printer, amongst multiple printers
serviced by one agent, is associated with which devices.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtGeneral 3 }
prtDeviceRefEntry OBJECT-TYPE
SYNTAX PrtDeviceRefEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table will have an entry for each entry in the Host
Resources MIB device table that represents a device associated
with a printer managed by this agent.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtDeviceRefSeqNumber }
::= { prtDeviceRefTable 1 }
PrtDeviceRefEntry ::= SEQUENCE {
prtDeviceRefSeqNumber Integer32,
prtDeviceRefIndex Integer32
}
prtDeviceRefSeqNumber OBJECT-TYPE
-- NOTE: The range has been changed from RFC 1759, which allowed a
-- minumum value of zero. This was incorrect, since zero is not a
-- valid index.
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This value will be unique amongst all entries with a common
value of hrDeviceIndex. This object allows a device entry to
point to the multiple printer devices with which it is
associated."
::= { prtDeviceRefEntry 1 }
prtDeviceRefIndex OBJECT-TYPE
-- NOTE: The range has been changed from RFC 1759 to be compatible
-- with the defined range of hrDeviceIndex.
SYNTAX Integer32 (0..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the hrDeviceIndex of the printer device that this
deviceEntry is associated with."
::= { prtDeviceRefEntry 2 }The Input Group 🦋
input sub-units are the devices that can feed media into the printing process 📄 they get managed as an indexed table, and each one can have a location, a type, an identifier, media size constraints, and maybe a status or capacity reading ✨
-- The Input Group
--
-- Input sub-units are managed as a tabular, indexed collection
-- of possible devices capable of providing media for input to
-- the printing process. Input sub-units typically have a
-- location, a type, an identifier, a set of constraints on
-- possible media sizes and potentially other media
-- characteristics, and may be capable of indicating current
-- status or capacity.
prtInput OBJECT IDENTIFIER ::= { printmib 8 }
prtInputTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtInputEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of the devices capable of providing media for input to
the printing process."
::= { prtInput 2 }
prtInputEntry OBJECT-TYPE
SYNTAX PrtInputEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Attributes of a device capable of providing media for input to
the printing process. Entries may exist in the table for each
device index with a device type of 'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtInputIndex }
::= { prtInputTable 1 }Okay bestie, the input table entry is where the real drama starts 💅 Every column here is a little knob for one input tray, so let's look at the whole sequence first ✨
PrtInputEntry ::= SEQUENCE {
prtInputIndex Integer32,
prtInputType PrtInputTypeTC,
prtInputDimUnit PrtMediaUnitTC,
prtInputMediaDimFeedDirDeclared Integer32,
prtInputMediaDimXFeedDirDeclared Integer32,
prtInputMediaDimFeedDirChosen Integer32,
prtInputMediaDimXFeedDirChosen Integer32,
prtInputCapacityUnit PrtCapacityUnitTC,
prtInputMaxCapacity Integer32,
prtInputCurrentLevel Integer32,
prtInputStatus PrtSubUnitStatusTC,
prtInputMediaName OCTET STRING,
prtInputName OCTET STRING,
prtInputVendorName OCTET STRING,
prtInputModel OCTET STRING,
prtInputVersion OCTET STRING,
prtInputSerialNumber OCTET STRING,
prtInputDescription PrtLocalizedDescriptionStringTC,
prtInputSecurity PresentOnOff,
prtInputMediaWeight Integer32,
prtInputMediaType OCTET STRING,
prtInputMediaColor OCTET STRING,
prtInputMediaFormParts Integer32,
prtInputMediaLoadTimeout Integer32,
prtInputNextIndex Integer32
}Now the first column, prtInputIndex 🎀 It's the printer's own name tag for each input sub-unit, and it's a number from 1 to 65535 (wild, right?) 🦋
prtInputIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this input
sub-unit. Although these values may change due to a major
reconfiguration of the device (e.g., the addition of new input
sub-units to the printer), values SHOULD remain stable across
successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtInputEntry 1 }Next up is prtInputType 🌸 It tells you what kind of feeder tech the tray uses, mostly by feeder mechanism. The Input Class has a descriptor field to add more detail, so the type alone isn't the whole story 🧚
prtInputType OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtInputTypeTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of technology (discriminated primarily according to
feeder mechanism type) employed by the input sub-unit. Note,
the Input Class provides for a descriptor field to further
qualify the other choice."
::= { prtInputEntry 2 }prtInputDimUnit 📏 is the measuring stick for all the dimension values in this entry 💜
prtInputDimUnit OBJECT-TYPE
SYNTAX PrtMediaUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The unit of measurement for use calculating and relaying
dimensional values for this input sub-unit."
::= { prtInputEntry 3 }Now the dimension quartet, which is iconic 🍓 Start with the declared feed direction, prtInputMediaDimFeedDirDeclared ✨ The value -1 means "other" (no restriction), and -2 means unknown. If the tray can sense the value reliably, the printer senses it and management can't change it 🙈
prtInputMediaDimFeedDirDeclared OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"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
(controlled by prtInputDimUnit, which uses PrtMediaUnitTC). If
this input sub-unit can reliably sense this value, the value is
sensed by the printer and may not be changed by management
requests. Otherwise, the value may be changed. The value (-1)
means other and specifically means that this sub-unit places no
restriction on this parameter. The value (-2) indicates
unknown."
::= { prtInputEntry 4 }Its cross-feed sibling is prtInputMediaDimXFeedDirDeclared 🦋 Same vibe, just turned ninety degrees from the feed direction 🌈
prtInputMediaDimXFeedDirDeclared OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object provides the value of the declared dimension, in
the cross feed direction, of the media that is (or, if empty,
was or will be) in this input sub-unit. The cross feed
direction is ninety degrees relative to the feed direction
associated with this sub-unit. This dimension is measured in
input sub-unit dimensional units (controlled by
prtInputDimUnit,which uses PrtMediaUnitTC). If this input sub-
unit can reliably sense this value, the value is sensed by the
printer and may not be changed by management requests.
Otherwise, the value may be changed. The value (-1) means other
and specifically means that this sub-unit places no restriction
on this parameter. The value (-2) indicates unknown."
::= { prtInputEntry 5 }prtInputMediaDimFeedDirChosen is read-only and it's the value the printer actually acts on 👑 Even if the tray is empty, this value still gets used 💀 If the printer supports the declared dimension, the granted one matches it. If not, the printer grants the closest size it supports 🫶
prtInputMediaDimFeedDirChosen OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The printer will act as if media of the chosen dimension (in
the feed direction) is present in this input source. Note that
this value will be used even if the input tray is empty. Feed
dimension measurements are taken relative to the feed direction
associated with that sub-unit and are in input sub-unit
dimensional units (controlled by prtInputDimUnit, which uses
PrtMediaUnitTC). If the printer supports the declared
dimension,the granted dimension is the same as the declared
dimension. If not, the granted dimension is set to the closest
dimension that the printer supports when the declared dimension
is set. The value (-1) means other and specifically indicates
that this sub-unit places no restriction on this parameter. The
value (-2)indicates unknown."
::= { prtInputEntry 6 }Last of the dimension crew is prtInputMediaDimXFeedDirChosen 💖 Same granted-size logic, just in the cross feed direction ✨
prtInputMediaDimXFeedDirChosen OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The printer will act as if media of the chosen dimension (in
the cross feed direction) is present in this input source. Note
that this value will be used even if the input tray is empty.
The cross feed direction is ninety degrees relative to the feed
direction associated with this sub-unit. This dimension is
measured in input sub-unit dimensional units (controlled by
prtInputDimUnit, which uses PrtMediaUnitTC). If the printer
supports the declare dimension, the granted dimension is the
same as the declared dimension. If not, the granted dimension
is set to the closest dimension that the printer supports when
the declared dimension is set. The value (-1) means other and
specifically indicates that this sub-unit places no restriction
on this parameter. The value (-2) indicates unknown."
::= { prtInputEntry 7 }Capacity time 🧁 prtInputCapacityUnit says what unit the capacity numbers are counted in 💅
prtInputCapacityUnit OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtCapacityUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The unit of measurement for use in calculating and relaying
capacity values for this input sub-unit."
::= { prtInputEntry 8 }prtInputMaxCapacity is the claimed maximum for the tray. The RFC is careful to say there's no convention tying it to the media itself, so it's the claimed number 🙃 It can be sensed by the printer, or written by a control panel or management app if it can't be sensed. -1 means no restriction and -2 means unknown 🔥
prtInputMaxCapacity OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The maximum capacity of the input sub-unit in input sub-unit
capacity units (PrtCapacityUnitTC). There is no convention
associated with the media itself so this value reflects claimed
capacity. If this input sub-unit can reliably sense this value,
the value is sensed by the printer and may not be changed by
management requests; 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."
::= { prtInputEntry 9 }prtInputCurrentLevel is how full the tray is right now 📄 It has its own special -3 value, which means at least one unit remains 😭
prtInputCurrentLevel OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-3..2147483647) -- in capacity units
-- (PrtCapacityUnitTC).
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The current capacity of the input sub-unit in input sub-unit
capacity units (PrtCapacityUnitTC). If this input sub-unit can
reliably sense this value, the value is sensed by the printer
and may not be changed by management requests; 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. The value (-3) means
that the printer knows that at least one unit remains."
::= { prtInputEntry 10 }Here's the ASCII diagram that shows how MaxCapacity and CurrentLevel line up with the sheets in the tray 🎨 Isn't that cute 🦋
-- INPUT MEASUREMENT
--
-- _______ | |
-- ^ | |
-- | | | |
-- | |_ _ _ _ _ _ _ _| _______________ |direction
-- | | | ^ v
-- MaxCapacity | Sheets | |
-- | | left | CurrentLevel
-- | | in | |
-- v | tray | v
-- _______ +_______________+ _______prtInputStatus is the tray's current status 🌟 Simple and to the point 💅
prtInputStatus OBJECT-TYPE
SYNTAX PrtSubUnitStatusTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current status of this input sub-unit."
::= { prtInputEntry 11 }Now the string era 🎀 prtInputMediaName is a human-friendly description of what's in the tray, up to 63 octets 🧚 It's for clients to format and localize for display, and the printer doesn't process it. The REFERENCE clause points to the PWG Standardized Media Names specification and to Appendix C of this RFC for ISO/IEC 10175 names 📚
prtInputMediaName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A description of the media contained in this input sub-unit;
This description is to be used by a client to format and
Localize a string 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., prtInputMediaDimFeedDirChosen,
prtInputMediaDimXFeedDirChosen, prtInputMediaWeight,
prtInputMediaType)."
-- The following reference was not included in RFC 1759.
REFERENCE
"The PWG Standardized Media Names specification [PWGMEDIA]
contains the recommended values for this object. See also
RFC 3805 Appendix C,'Media Names', which lists the values
Of standardized media names defined in ISO/IEC 10175."
::= { prtInputEntry 12 }Next is "The Extended Input Group" 🌈 It's the naming and identity bit, starting with prtInputName 🦋
-- The Extended Input Group
prtInputName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The name assigned to this input sub-unit."
::= { prtInputEntry 13 }Then the hardware identity crew: prtInputVendorName, prtInputModel, and prtInputVersion, all read-only and all up to 63 octets 🎀
prtInputVendorName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The vendor name of this input sub-unit."
::= { prtInputEntry 14 }
prtInputModel OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The model name of this input sub-unit."
::= { prtInputEntry 15 }
prtInputVersion OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The version of this input sub-unit."
::= { prtInputEntry 16 }Last in this part is prtInputSerialNumber 🔢 It's read-only and holds up to 32 octets 🫶
prtInputSerialNumber OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..32))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The serial number assigned to this input sub-unit."
::= { prtInputEntry 17 }Okay so, first up is the description and security pair for the input sub-units 🎀
prtInputDescription OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtLocalizedDescriptionStringTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A free-form text description of this input sub-unit in the
localization specified by prtGeneralCurrentLocalization."
::= { prtInputEntry 18 }
prtInputSecurity OBJECT-TYPE
SYNTAX PresentOnOff
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Indicates if this input sub-unit has some security associated
with it."
::= { prtInputEntry 19 }The Input Media Group 💜
The Input Media Group is where we keep track of the media that's installed or available on the printer. Each medium gets a name plus a bunch of attributes that can be used for picking and managing it. Every column here is optional, so a minimal implementation can skip media reporting if it can't do it 🥺
-- The Input Media Group
--
-- The Input Media Group supports identification of media
-- installed or available for use on a printing device.
-- Medium resources are identified by name, and include a
-- collection of characteristic attributes that may further be
-- used for selection and management of them.
-- The Input Media group consists of a set of optional
-- "columns" in the Input Table. In this manner, a minimally
-- conforming implementation may choose to not support reporting
-- of media resources if it cannot do so.
prtInputMediaWeight OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The weight of the medium associated with this input sub-unit
in grams / per meter squared. The value (-2) means unknown."
::= { prtInputEntry 20 }
prtInputMediaType OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The name of the type of medium associated with this input sub
unit. This name need not be processed by the printer; it might
simply be displayed to an operator.
NOTE: The above description has been modified from RFC 1759."
-- The following reference was not included in RFC 1759.
REFERENCE
"The PWG Standardized Media Names specification [PWGMEDIA],
section 3 Media Type Names, contains the recommended values for
this object. Implementers may add additional string values.
The naming conventions in ISO 9070 are recommended in order to
avoid potential name clashes."
::= { prtInputEntry 21 }
prtInputMediaColor OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The name of the color of the medium associated with
this input sub-unit using standardized string values.
NOTE: The above description has been modified from RFC 1759."
-- The following reference was not included in RFC 1759.
REFERENCE
"The PWG Standardized Media Names specification [PWGMEDIA],
section 4 Media Color Names, contains the recommended values
for this object. Implementers may add additional string values.
The naming conventions in ISO 9070 are recommended in order to
avoid potential name clashes."
::= { prtInputEntry 22 }
prtInputMediaFormParts OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The number of parts associated with the medium
associated with this input sub-unit if the medium is a
multi-part form. The value (-1) means other and
specifically indicates that the device places no
restrictions on this parameter. The value (-2) means
unknown."
::= { prtInputEntry 23 }The Input Switching Group 🦋
This group is the boss of timeouts and auto-switching. It lets the admin set how long the printer waits when an input sub-unit runs empty, and control whether it switches to another input on its own 👑
-- The Input Switching Group
--
-- The input switching group allows the administrator to set the
-- input subunit time-out for the printer and to control the
-- automatic input subunit switching by the printer when an input
-- subunit becomes empty.
prtInputMediaLoadTimeout OBJECT-TYPE
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"When the printer is not able to print due to a subunit being
empty or the requested media must be manually loaded, the
printer will wait for the duration (in seconds) specified by
this object. Upon expiration of the time-out, the printer will
take the action specified by prtInputNextIndex.
The event which causes the printer to enter the waiting state
is product specific. If the printer is not waiting for manually
fed media, it may switch from an empty subunit to a different
subunit without waiting for the time-out to expire.
A value of (-1) implies 'other' or 'infinite' which translates
to 'wait forever'. The action which causes printing to continue
is product specific. A value of (-2) implies 'unknown'."
::= { prtInputEntry 24 }
prtInputNextIndex OBJECT-TYPE
SYNTAX Integer32 (-3..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of prtInputIndex corresponding to the input subunit
which will be used when this input subunit is emptied and the
time-out specified by prtInputMediaLoadTimeout expires. A value
of zero(0) indicates that auto input switching will not occur
when this input subunit is emptied. If the time-out specified
by prtInputLoadMediaTimeout expires and this value is zero(0),
the job will be aborted. A value of (-1) means other. The
value (-2)means 'unknown' and specifically indicates that an
implementation specific method will determine the next input
subunit to use at the time this subunit is emptied and the time
out expires. The value(-3) means input switching is not
supported for this subunit."
::= { prtInputEntry 25 }The Output Group 🌈
Output sub-units are a tabular, indexed crowd of devices that receive the media coming out of the printing process. They usually have a location, a type, an identifier, some media size constraints, and maybe a status or capacity readout ✨
-- The Output Group
--
-- Output sub-units are managed as a tabular, indexed collection
-- of possible devices capable of receiving media delivered from
-- the printing process. Output sub-units typically have a
-- location, a type, an identifier, a set of constraints on
-- possible media sizes and potentially other characteristics,
-- and may be capable of indicating current status or capacity.
prtOutput OBJECT IDENTIFIER ::= { printmib 9 }
prtOutputTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtOutputEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of the devices capable of receiving media delivered
from the printing process."
::= { prtOutput 2 }
prtOutputEntry OBJECT-TYPE
SYNTAX PrtOutputEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Attributes of a device capable of receiving media delivered
from the printing process. Entries may exist in the table for
each device index with a device type of 'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtOutputIndex }
::= { prtOutputTable 1 }
PrtOutputEntry ::= SEQUENCE {
prtOutputIndex Integer32,
prtOutputType PrtOutputTypeTC,
prtOutputCapacityUnit PrtCapacityUnitTC,
prtOutputMaxCapacity Integer32,
prtOutputRemainingCapacity Integer32,
prtOutputStatus PrtSubUnitStatusTC,
prtOutputName OCTET STRING,
prtOutputVendorName OCTET STRING,
prtOutputModel OCTET STRING,
prtOutputVersion OCTET STRING,
prtOutputSerialNumber OCTET STRING,
prtOutputDescription PrtLocalizedDescriptionStringTC,
prtOutputSecurity PresentOnOff,
prtOutputDimUnit PrtMediaUnitTC,
prtOutputMaxDimFeedDir Integer32,
prtOutputMaxDimXFeedDir Integer32,
prtOutputMinDimFeedDir Integer32,
prtOutputMinDimXFeedDir Integer32,
prtOutputStackingOrder PrtOutputStackingOrderTC,
prtOutputPageDeliveryOrientation
PrtOutputPageDeliveryOrientationTC,
prtOutputBursting PresentOnOff,
prtOutputDecollating PresentOnOff,
prtOutputPageCollated PresentOnOff,
prtOutputOffsetStacking PresentOnOff
}
prtOutputIndex OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by this printer to identify this output
sub-unit. Although these values may change due to a major
reconfiguration of the sub-unit (e.g., the addition of new
output devices to the printer), values SHOULD remain stable
across successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtOutputEntry 1 }
prtOutputType OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly defined
-- by this object.
SYNTAX PrtOutputTypeTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of technology supported by this output sub-unit."
::= { prtOutputEntry 2 }
prtOutputCapacityUnit OBJECT-TYPE
SYNTAX PrtCapacityUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The unit of measurement for use in calculating and relaying
capacity values for this output sub-unit."
::= { prtOutputEntry 3 }
prtOutputMaxCapacity OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The maximum capacity of this output sub-unit in output sub-
unit capacity units (PrtCapacityUnitTC). There is no convention
associated with the media itself so this value essentially
reflects claimed capacity. If this output sub-unit can reliably
sense this value, the value is sensed by the printer and may
not be changed by management requests; 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."
::= { prtOutputEntry 4 }
prtOutputRemainingCapacity OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-3..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The remaining capacity of the possible output sub-unit
capacity in output sub-unit capacity units
(PrtCapacityUnitTC)of this output sub-unit. If this output sub-
unit can reliably sense this value, the value is sensed by the
printer and may not be modified by management requests;
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. The value
(-3) means that the printer knows that there remains capacity
for at least one unit."
::= { prtOutputEntry 5 }
prtOutputStatus OBJECT-TYPE
SYNTAX PrtSubUnitStatusTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current status of this output sub-unit."
::= { prtOutputEntry 6 }
-- OUTPUT MEASUREMENTThe Extended Output Group ✨
okay bestie, the output world is getting so detailed 🎀 this little diagram shows the sheets sitting in the output tray, with MaxCapacity and RemainingCapacity marked on it
-- _______ | | ________
-- ^ | | ^
-- | | | |
-- | | |RemainingCapacity
-- MaxCapacity| | |
-- | | | v ^
-- | |_ _ _ _ _ _ _ _ | _______________ |direction
-- | | Sheets | |
-- | | in |
-- v | Output |
-- _______ +________________+the extended output group is where the identity stuff lives 💅
-- The Extended Output Group
prtOutputName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The name assigned to this output sub-unit."
::= { prtOutputEntry 7 }
prtOutputVendorName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The vendor name of this output sub-unit."
::= { prtOutputEntry 8 }
prtOutputModel OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The model name assigned to this output sub-unit.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtOutputEntry 9 }
prtOutputVersion OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The version of this output sub-unit."
::= { prtOutputEntry 10 }
prtOutputSerialNumber OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The serial number assigned to this output sub-unit."
::= { prtOutputEntry 11 }
prtOutputDescription OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtLocalizedDescriptionStringTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A free-form text description of this output sub-unit in the
localization specified by prtGeneralCurrentLocalization."
::= { prtOutputEntry 12 }
prtOutputSecurity OBJECT-TYPE
SYNTAX PresentOnOff
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Indicates if this output sub-unit has some security associated
with it and if that security is enabled or not."
::= { prtOutputEntry 13 }The Output Dimensions Group 📐
this part is all about sizes, and it's giving very precise vibes 💖 the (-1) and (-2) values are the ones to watch, because they each mean something different
-- The Output Dimensions Group
prtOutputDimUnit OBJECT-TYPE
SYNTAX PrtMediaUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The unit of measurement for use in calculating and relaying
dimensional values for this output sub-unit."
::= { prtOutputEntry 14 }
prtOutputMaxDimFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The maximum dimensions supported by this output sub-unit
for measurements taken parallel relative to the feed
direction associated with that sub-unit in output
sub-unit dimensional units (controlled by prtOutputDimUnit,
which uses PrtMediaUnitTC). If this output sub-unit can
reliably sense this value, the value is sensed by the printer
and may not be changed with management protocol operations.
The value (-1) means other and specifically indicates that the
sub-unit places no restrictions on this parameter. The value
(-2) means unknown.
NOTE: The above description has been modified from RFC 1759
for clarification and to explain the purpose of (-1) and (-2)."
::= { prtOutputEntry 15 }
prtOutputMaxDimXFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The maximum dimensions supported by this output sub-unit
for measurements taken ninety degrees relative to the
feed direction associated with that sub-unit in output
sub-unit dimensional units (controlled by prtOutputDimUnit,
which uses PrtMediaUnitTC). If this output sub-unit can
reliably sense this value, the value is sensed by the printer
and may not be changed with management protocol operations.
The value (-1) means other and specifically indicates that the
sub-unit places no restrictions on this parameter. The value
(-2) means unknown.
NOTE: The above description has been modified from RFC 1759
for clarification and to explain the purpose of (-1) and (-2)."
::= { prtOutputEntry 16 }
prtOutputMinDimFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The minimum dimensions supported by this output sub-unit
for measurements taken parallel relative to the feed
direction associated with that sub-unit in output
sub-unit dimensional units (controlled by prtOutputDimUnit,
which uses PrtMediaUnitTC). If this output sub-unit can
reliably sense this value, the value is sensed by the printer
and may not be changed with management protocol operations.
The value (-1) means other and specifically indicates that the
sub-unit places no restrictions on this parameter. The value
(-2) means unknown.
NOTE: The above description has been modified from RFC 1759
for clarification and to explain the purpose of (-1) and (-2)."
::= { prtOutputEntry 17 }
prtOutputMinDimXFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The minimum dimensions supported by this output sub-unit
for measurements taken ninety degrees relative to the
feed direction associated with that sub-unit in output
sub-unit dimensional units (controlled by prtOutputDimUnit,
which uses PrtMediaUnitTC). If this output sub-unit can
reliably sense this value, the value is sensed by the printer
and may not be changed with management protocol operations.
The value (-1) means other and specifically indicates that the
sub-unit places no restrictions on this parameter. The value
(-2) means unknown.
NOTE: The above description has been modified from RFC 1759
for clarification and to explain the purpose of (-1) and (-2)."
::= { prtOutputEntry 18 }The Output Features Group 🦋
stacking, bursting, decollating, collating, offset stacking... the output features are giving main character energy 👑 the glossary in RFC 3805 Appendix A is where the collation and offset stacking definitions live, so you know where to look 🍓
-- The Output Features Group
prtOutputStackingOrder OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtOutputStackingOrderTC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The current state of the stacking order for the
associated output sub-unit. 'FirstToLast' means
that as pages are output the front of the next page is
placed against the back of the previous page.
'LasttoFirst' means that as pages are output the back
of the next page is placed against the front of the
previous page."
::= { prtOutputEntry 19 }
prtOutputPageDeliveryOrientation OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtOutputPageDeliveryOrientationTC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The reading surface that will be 'up' when pages are
delivered to the associated output sub-unit. Values are
faceUp and faceDown. (Note: interpretation of these
values is in general context-dependent based on locale;
presentation of these values to an end-user should be
normalized to the expectations of the user)."
::= { prtOutputEntry 20 }
prtOutputBursting OBJECT-TYPE
SYNTAX PresentOnOff
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object indicates that the outputting sub-unit supports
bursting, and if so, whether the feature is enabled. Bursting
is the process by which continuous media is separated into
individual sheets, typically by bursting along pre-formed
perforations."
::= { prtOutputEntry 21 }
prtOutputDecollating OBJECT-TYPE
SYNTAX PresentOnOff
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object indicates that the output supports decollating,
and if so, whether the feature is enabled. Decollating is the
process by which the individual parts within a multi-part form
are separated and sorted into separate stacks for each part."
::= { prtOutputEntry 22 }
prtOutputPageCollated OBJECT-TYPE
SYNTAX PresentOnOff
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object indicates that the output sub-unit supports page
collation, and if so, whether the feature is enabled. See RFC
3805 Appendix A, Glossary Of Terms, for definition of how this
document defines collation.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtOutputEntry 23 }
prtOutputOffsetStacking OBJECT-TYPE
SYNTAX PresentOnOff
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object indicates that the output supports offset
stacking,and if so, whether the feature is enabled. See RFC
3805 Appendix A, Glossary Of Terms, for how Offset Stacking is
defined by this document.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtOutputEntry 24 }The Marker Group 🖌️
okay now we're entering the marker zone 🌈 a marker is the thing that actually makes the marks on the media, and a printer can have one or more of them, which is so iconic
-- The Marker Group
--
-- A marker is the mechanism that produces marks on the print
-- media. The marker sub-units and their associated supplies are
-- represented by the Marker Group in the model. A printer can
-- contain one or more marking mechanisms. Some examples of
-- multiple marker sub-units are: a printer
-- with separate markers for normal and magnetic ink or an
-- imagesetter that can output to both a proofing device and
-- final film. Each marking device can have its own set of
-- characteristics associated with it, such as marking technology
-- and resolution.
prtMarker OBJECT IDENTIFIER ::= { printmib 10 }
-- The printable area margins as listed below define an area of
-- the print media which is guaranteed to be printable for all
-- combinations of input, media paths, and interpreters for this
-- marker.
prtMarkerTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtMarkerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The marker table provides a description of each marker
sub-unit contained within the printer.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarker 2 }
prtMarkerEntry OBJECT-TYPE
SYNTAX PrtMarkerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries in this table define the characteristics and status
of each marker sub-unit in the printer.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtMarkerIndex }
::= { prtMarkerTable 1 }PrtMarkerEntry ::= SEQUENCE {
prtMarkerIndex Integer32,
prtMarkerMarkTech PrtMarkerMarkTechTC,
prtMarkerCounterUnit PrtMarkerCounterUnitTC,
prtMarkerLifeCount Counter32,
prtMarkerPowerOnCount Counter32,
prtMarkerProcessColorants Integer32,
prtMarkerSpotColorants Integer32,
prtMarkerAddressabilityUnit PrtMarkerAddressabilityUnitTC,
prtMarkerAddressabilityFeedDir Integer32,
prtMarkerAddressabilityXFeedDir Integer32,
prtMarkerNorthMargin Integer32,
prtMarkerSouthMargin Integer32,
prtMarkerWestMargin Integer32,
prtMarkerEastMargin Integer32,
prtMarkerStatus PrtSubUnitStatusTC
}okay so this is the full row for each marker 💅✨ every column is one property of the marking sub-unit, and it's giving organised. bestie, the order here is the order, no cap 🎀
prtMarkerIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this marking
SubUnit. Although these values may change due to a major
reconfiguration of the device (e.g., the addition of new marking
sub-units to the printer), values SHOULD remain stable across
successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerEntry 1 }
prtMarkerMarkTech OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMarkerMarkTechTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of marking technology used for this marking
sub-unit."
::= { prtMarkerEntry 2 }
prtMarkerCounterUnit OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMarkerCounterUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { prtMarkerEntry 3 }the index is basically the printer's nametag for each marking sub-unit 🏷️ it's a bit of a recommendation to keep those IDs steady across power cycles (lowkey important!), and the marker technology and counter unit are read-only vibes 🔒 the counter unit thing even has a whole strip-recorder moment 📜🌸
prtMarkerLifeCount OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The count of the number of units of measure counted during the
life of printer using units of measure as specified by
prtMarkerCounterUnit.
Note: This object should be implemented as a persistent object
with a reliable value throughout the lifetime of the printer."
::= { prtMarkerEntry 4 }
prtMarkerPowerOnCount OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The count of the number of units of measure counted since the
equipment was most recently powered on using units of measure
as specified by prtMarkerCounterUnit."
::= { prtMarkerEntry 5 }so the life count is the whole career 🧚 it's meant to be persistent and reliable for the printer's entire lifetime, which is so iconic of it. the power-on count only starts over when the machine gets switched on again 🔌🥹
prtMarkerProcessColorants OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of process colors supported by this marker. A
process color of 1 implies monochrome. The value of this
object and prtMarkerSpotColorants cannot both be 0. The value
of prtMarkerProcessColorants must be 0 or greater.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerEntry 6 }
prtMarkerSpotColorants OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of spot colors supported by this marker. The value
of this object and prtMarkerProcessColorants cannot both be 0.
Must be 0 or greater.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerEntry 7 }colour check 🌈 process colours, spot colours, and the rule that the two of them can't both be zero (no empty palettes allowed, sorry 🙈). a process colour count of 1 just means monochrome, which is honestly a whole mood 🖤
prtMarkerAddressabilityUnit OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMarkerAddressabilityUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The unit of measure of distances, as applied to the marker's
resolution.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerEntry 8 }
prtMarkerAddressabilityFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum number of addressable marking positions in the
feed direction per 10000 units of measure specified by
prtMarkerAddressabilityUnit. A value of (-1) implies 'other'
or 'infinite' while a value of (-2) implies 'unknown'.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerEntry 9 }
prtMarkerAddressabilityXFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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'.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerEntry 10 }addressability is all about how many marking positions fit, measured in the unit from prtMarkerAddressabilityUnit 📐 feed direction and cross feed direction are the two axes, and -1 means "other" or "infinite" while -2 means "unknown" (the -2 is giving mystery, I'm obsessed 🔮)
prtMarkerNorthMargin OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The margin, in units identified by prtMarkerAddressabilityUnit,
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."
::= { prtMarkerEntry 11 }
prtMarkerSouthMargin OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { prtMarkerEntry 12 }
prtMarkerWestMargin OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { prtMarkerEntry 13 }
prtMarkerEastMargin OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { prtMarkerEntry 14 }
prtMarkerStatus OBJECT-TYPE
SYNTAX PrtSubUnitStatusTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current status of this marker sub-unit."
::= { prtMarkerEntry 15 }the four margins are the compass crew 🧭 north is the leading edge of the medium, and the rest follow the normal compass layout with the compass facing the observer. the bit that makes me scream: printing inside the box formed by all four margins is guaranteed for every interpreter 😭🫶 and -2 means unknown again, because the vibes are consistent
-- The Marker Supplies Group
prtMarkerSupplies OBJECT IDENTIFIER ::= { printmib 11 }
prtMarkerSuppliesTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtMarkerSuppliesEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of the marker supplies available on this printer."
::= { prtMarkerSupplies 1 }
prtMarkerSuppliesEntry OBJECT-TYPE
SYNTAX PrtMarkerSuppliesEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Attributes of a marker supply. Entries may exist in the table
for each device index with a device type of 'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtMarkerSuppliesIndex }
::= { prtMarkerSuppliesTable 1 }
PrtMarkerSuppliesEntry ::= SEQUENCE {
prtMarkerSuppliesIndex Integer32,
prtMarkerSuppliesMarkerIndex Integer32,
prtMarkerSuppliesColorantIndex Integer32,
prtMarkerSuppliesClass PrtMarkerSuppliesClassTC,
prtMarkerSuppliesType PrtMarkerSuppliesTypeTC,
prtMarkerSuppliesDescription PrtLocalizedDescriptionStringTC,
prtMarkerSuppliesSupplyUnit PrtMarkerSuppliesSupplyUnitTC,
prtMarkerSuppliesMaxCapacity Integer32,
prtMarkerSuppliesLevel Integer32
}ooh, new group alert 🚨 the supplies group is its own table with its own little family tree 🌳 each entry lives under a device index with a device type of 'printer', and the index is a combo of hrDeviceIndex plus prtMarkerSuppliesIndex, so it's a whole couple moment 💜
prtMarkerSuppliesIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this marker
supply. Although these values may change due to a major
reconfiguration of the device (e.g., the addition of new marker
supplies to the printer), values SHOULD remain stable across
successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerSuppliesEntry 1 }
prtMarkerSuppliesMarkerIndex OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of prtMarkerIndex corresponding to the marking sub
unit with which this marker supply sub-unit is associated."
::= { prtMarkerSuppliesEntry 2 }
prtMarkerSuppliesColorantIndex OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of prtMarkerColorantIndex corresponding to the
colorant with which this marker supply sub-unit is associated.
This value shall be 0 if there is no colorant table or if this
supply does not depend on a single specified colorant.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerSuppliesEntry 3 }
prtMarkerSuppliesClass OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMarkerSuppliesClassTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates whether this supply entity represents a supply that
is consumed or a receptacle that is filled.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerSuppliesEntry 4 }
prtMarkerSuppliesType OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMarkerSuppliesTypeTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of this supply."
::= { prtMarkerSuppliesEntry 5 }Okay, so we're picking up right where the supplies stuff left off 💅 and the marker supplies description is literally the first thing on the list ✨
prtMarkerSuppliesDescription OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtLocalizedDescriptionStringTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The description of this supply container/receptacle in the
localization specified by prtGeneralCurrentLocalization."
::= { prtMarkerSuppliesEntry 6 }
prtMarkerSuppliesSupplyUnit OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMarkerSuppliesSupplyUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Unit of measure of this marker supply container/receptacle.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerSuppliesEntry 7 }
prtMarkerSuppliesMaxCapacity OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The maximum capacity of this supply container/receptacle
expressed in prtMarkerSuppliesSupplyUnit. If this supply
container/receptacle can reliably sense this value, the value
is reported by the printer and is read-only; otherwise, the
value may be written (by a Remote Control Panel or a Management
Application). The value (-1) means other and specifically
indicates that the sub-unit places no restrictions on this
parameter. The value (-2) means unknown."
::= { prtMarkerSuppliesEntry 8 }
prtMarkerSuppliesLevel OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-3..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The current level if this supply is a container; the 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."
::= { prtMarkerSuppliesEntry 9 }
-- The Marker Colorant Group
prtMarkerColorant OBJECT IDENTIFIER ::= { printmib 12 }
prtMarkerColorantTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtMarkerColorantEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of all of the colorants available on the printer."
::= { prtMarkerColorant 1 }
prtMarkerColorantEntry OBJECT-TYPE
SYNTAX PrtMarkerColorantEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Attributes of a colorant available on the printer. Entries may
exist in the table for each device index with a device type of
'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtMarkerColorantIndex }
::= { prtMarkerColorantTable 1 }
PrtMarkerColorantEntry ::= SEQUENCE {
prtMarkerColorantIndex Integer32,
prtMarkerColorantMarkerIndex Integer32,
prtMarkerColorantRole PrtMarkerColorantRoleTC,
prtMarkerColorantValue OCTET STRING,
prtMarkerColorantTonality Integer32
}
prtMarkerColorantIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this colorant.
Although these values may change due to a major reconfiguration
of the device (e.g., the addition of new colorants to the
printer) , values SHOULD remain stable across successive
printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMarkerColorantEntry 1 }
prtMarkerColorantMarkerIndex OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of prtMarkerIndex corresponding to the marker sub
unit with which this colorant entry is associated."
::= { prtMarkerColorantEntry 2 }
prtMarkerColorantRole OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMarkerColorantRoleTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The role played by this colorant."
::= { prtMarkerColorantEntry 3 }
prtMarkerColorantValue OBJECT-TYPE
-- NOTE: The string length range has been increased from RFC 1759.
SYNTAX OCTET STRING (SIZE(0..255))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of the color of this colorant using standardized
string names from ISO 10175 (DPA) and ISO 10180 (SPDL) such as:
other
unknown
white
red
green
blue
cyan
magenta
yellow
black
Implementers may add additional string values. The naming
conventions in ISO 9070 are recommended in order to avoid
potential name clashes"
::= { prtMarkerColorantEntry 4 }
prtMarkerColorantTonality OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The distinct levels of tonality realizable by a marking sub
unit when using this colorant. This value does not include the
number of levels of tonal difference that an interpreter can
obtain by techniques such as half toning. This value must be at
least 2."
::= { prtMarkerColorantEntry 5 }
-- The Media Path Group
--
-- The media paths encompass the mechanisms in the printer that
-- move the media through the printer and connect all other media
-- related sub-units: inputs, outputs, markers and finishers. A
-- printer contains one or more media paths. These are
-- represented by the Media Path Group in the model.
prtMediaPath OBJECT IDENTIFIER ::= { printmib 13 }
prtMediaPathTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtMediaPathEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The media path table includes both physical and logical paths
within the printer.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMediaPath 4 }
prtMediaPathEntry OBJECT-TYPE
SYNTAX PrtMediaPathEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries may exist in the table for each device index with a
device type of 'printer' Each entry defines the physical
characteristics of and the status of the media path. The data
provided indicates the maximum throughput and the media
size limitations of these subunits.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtMediaPathIndex }
::= { prtMediaPathTable 1 }
PrtMediaPathEntry ::= SEQUENCE {
prtMediaPathIndex Integer32,
prtMediaPathMaxSpeedPrintUnit PrtMediaPathMaxSpeedPrintUnitTC,
prtMediaPathMediaSizeUnit PrtMediaUnitTC,
prtMediaPathMaxSpeed Integer32,
prtMediaPathMaxMediaFeedDir Integer32,
prtMediaPathMaxMediaXFeedDir Integer32,
prtMediaPathMinMediaFeedDir Integer32,
prtMediaPathMinMediaXFeedDir Integer32,
prtMediaPathType PrtMediaPathTypeTC,
prtMediaPathDescription PrtLocalizedDescriptionStringTC,
prtMediaPathStatus PrtSubUnitStatusTC
}
prtMediaPathIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this media
path. Although these values may change due to a major
reconfiguration of the device (e.g., the addition of new media
paths to the printer), values SHOULD remain stable across
successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMediaPathEntry 1 }
prtMediaPathMaxSpeedPrintUnit OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMediaPathMaxSpeedPrintUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The unit of measure used in specifying the speed of all media
paths in the printer."
::= { prtMediaPathEntry 2 }
prtMediaPathMediaSizeUnit OBJECT-TYPE
SYNTAX PrtMediaUnitTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The units of measure of media size for use in calculating and
relaying dimensional values for all media paths in the
printer."
::= { prtMediaPathEntry 3 }
prtMediaPathMaxSpeed OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum printing speed of this media path expressed in
prtMediaPathMaxSpeedUnit's. A value of (-1) implies 'other'."
::= { prtMediaPathEntry 4 }
prtMediaPathMaxMediaFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum physical media size in the feed direction of this
media path expressed in units of measure specified by
PrtMediaPathMediaSizeUnit. A value of (-1) implies 'unlimited'
a value of (-2) implies 'unknown'.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMediaPathEntry 5 }
prtMediaPathMaxMediaXFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum physical media size across the feed direction of
this media path expressed in units of measure specified by
prtMediaPathMediaSizeUnit. A value of (-2) implies 'unknown'.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMediaPathEntry 6 }
prtMediaPathMinMediaFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum physical media size in the feed direction of this
media path expressed in units of measure specified by
prtMediaPathMediaSizeUnit. A value of (-2) implies 'unknown'.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMediaPathEntry 7 }
prtMediaPathMinMediaXFeedDir OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum physical media size across the feed direction of
this media path expressed in units of measure specified by
prtMediaPathMediaSizeUnit. A value of (-2) implies 'unknown'.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtMediaPathEntry 8 }the colorant and media path stuff is giving full main character energy 🦋 every object gets its own little number so the MIB knows exactly where it lives 🎀
okay bestie, we're still in the media path era, and then the print job delivery channels roll in 🎀✨
prtMediaPathType OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtMediaPathTypeTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of the media path for this media path."
::= { prtMediaPathEntry 9 }
prtMediaPathDescription OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtLocalizedDescriptionStringTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The manufacturer-provided description of this media path in
the localization specified by prtGeneralCurrentLocalization."
::= { prtMediaPathEntry 10 }
prtMediaPathStatus OBJECT-TYPE
SYNTAX PrtSubUnitStatusTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current status of this media path."
::= { prtMediaPathEntry 11 }
-- The Print Job Delivery Channel Group
--
-- Print Job Delivery Channels are independent sources of print
-- data. Here, print data is the term used for the information
-- that is used to construct printed pages and may have both data
-- and control aspects. The output of a channel is in a form
-- suitable for input to one of the interpreters as a
-- stream. A channel may be independently enabled (allowing
-- print data to flow) or disabled (stopping the flow of
-- print data). A printer may have one or more channels.
--
-- The Print Job Delivery Channel table describes the
-- capabilities of the printer and not what is currently being
-- performed by the printer
--
-- Basically, the print job delivery channel abstraction
-- describes the final processing step of getting the print data
-- to an interpreter. It might include some level of
-- decompression or decoding of print stream data.
-- channel. All of these aspects are hidden in the channel
-- abstraction.
--
-- There are many kinds of print job delivery channels; some of
-- which are based on networks and others which are not. For
-- example, a channel can be a serial (or parallel) connection;
-- it can be a service, such as the UNIX Line Printer Daemon
-- (LPD), offering services over a network connection; or
-- it could be a disk drive into which a floppy disk with
-- the print data is inserted. Each print job delivery channel is
-- identified by the electronic path and/or service protocol
-- used to deliver print data to a print data interpreter.
--
-- Channel example Implementation
--
-- serial port channel bi-directional data channel
-- parallel port channel often uni-directional channel
-- IEEE 1284 port channel bi-directional channel
-- SCSI port channel bi-directional
-- Apple PAP channel may be based on LocalTalk,
-- Ethernet or Tokentalk
-- LPD Server channel TCP/IP based, port 515
-- Netware Remote Printer SPX/IPX based channel
-- Netware Print Server SPX/IPX based channel
--
-- It is easy to note that this is a mixed bag. There are
-- some physical connections over which no (or very meager)
-- protocols are run (e.g., the serial or old parallel ports)
-- and there are services which often have elaborate
-- protocols that run over a number of protocol stacks. In
-- the end, what is important is the delivery of print data
-- through the channel.
--
-- The print job delivery channel sub-units are represented by
-- the Print Job Delivery Channel Group in the Model. It has a
-- current print job control language, which can be used to
-- specify which interpreter is to be used for the print data and
-- to query and change environment variables used by the
-- interpreters (and Management Applications). There is also a
-- default interpreter that is to be used if an interpreter is
-- not explicitly specified using the Control Language.
-- The first seven items in the Print Job Delivery Channel Table
-- define the "channel" itself. A channel typically depends on
-- other protocols and interfaces to provide the data that flows
-- through the channel.
--
-- Control of a print job delivery channel is largely limited to
-- enabling or disabling the entire channel itself. It is likely
-- that more control of the process of accessing print data
-- will be needed over time. Thus, the ChannelType will
-- allow type-specific data to be associated with each
-- channel (using ChannelType specific groups in a fashion
-- analogous to the media specific MIBs that are associated
-- with the IANAIfType in the Interfaces Table). As a first
-- step in this direction, each channel will identify the
-- underlying Interface on which it is based. This is the
-- eighth object in each row of the table.
-- The Print Job Delivery Channel Table
prtChannel OBJECT IDENTIFIER ::= { printmib 14 }
prtChannelTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtChannelEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The channel table represents the set of input data sources
which can provide print data to one or more of the
interpreters available on a printer.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtChannel 1 }
prtChannelEntry OBJECT-TYPE
SYNTAX PrtChannelEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries may exist in the table for each device index with a
device type of 'printer'. Each channel table entry is
characterized by a unique protocol stack and/or addressing.
The channel may also have printer dependent features that are
associated with a printing language.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtChannelIndex }
::= { prtChannelTable 1 }
PrtChannelEntry ::= SEQUENCE {
prtChannelIndex Integer32,
prtChannelType PrtChannelTypeTC,
prtChannelProtocolVersion OCTET STRING,
prtChannelCurrentJobCntlLangIndex Integer32,
prtChannelDefaultPageDescLangIndex Integer32,
prtChannelState PrtChannelStateTC,
prtChannelIfIndex InterfaceIndexOrZero,
prtChannelStatus PrtSubUnitStatusTC,
prtChannelInformation OCTET STRING
}
prtChannelIndex OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this data
channel. Although these values may change due to a major
reconfiguration of the device (e.g., the addition of new data
channels to the printer), values SHOULD remain stable across
successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtChannelEntry 1 }
prtChannelType OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtChannelTypeTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { prtChannelEntry 2 }
prtChannelProtocolVersion OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..63))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The version of the protocol used on this channel. The format
used for version numbering depends on prtChannelType."
::= { prtChannelEntry 3 }
prtChannelCurrentJobCntlLangIndex OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of prtInterpreterIndex corresponding to the Control
Language Interpreter for this channel. This interpreter defines
the syntax used for control functions, such as querying or
changing environment variables and identifying job boundaries
(e.g., PJL, PostScript, NPAP). A value of zero indicates that
there is no current Job Control Language Interpreter for this
channel.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtChannelEntry 4 }
prtChannelDefaultPageDescLangIndex OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of prtInterpreterIndex corresponding to the Page
Description Language Interpreter for this channel. This
interpreter defines the default Page Description Language
interpreter to be used for the print data unless the Control
Language is used to select a specific interpreter (e.g., PCL,
PostScript Language, auto-sense). A value of zero indicates
that there is no default page description language interpreter
for this channel.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtChannelEntry 5 }
prtChannelState OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtChannelStateTC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The state of this print data channel. The value determines
whether control information and print data is allowed through
this channel or not."
::= { prtChannelEntry 6 }
prtChannelIfIndex OBJECT-TYPE
SYNTAX InterfaceIndexOrZero -- Was Integer32 in RFC 1759.
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The value of ifIndex in the ifTable; see the Interfaces Group
MIB [RFC2863] which corresponds to this channel.
When more than one row of the ifTable is relevant, this is the
index of the row representing the topmost layer in the
interface hierarchy. A value of zero indicates that no
interface is associated with this channel.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtChannelEntry 7 }
prtChannelStatus OBJECT-TYPE
SYNTAX PrtSubUnitStatusTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current status of the channel."
::= { prtChannelEntry 8 }the channel stuff is lowkey a whole mood, the way it's all about getting print data to an interpreter 💅🖨️
Okay bestie, this one is a whole vibe 💅 The prtChannelInformation object is a read-only OCTET STRING of up to 255 octets 🎀. It's basically a little cheat sheet that helps an app bootstrap its use of a channel 🦋. It's not a full channel description, and it's not meant to repeat stuff you can already see once the channel is in use ✨.
Then we're moving into the Interpreter Group 🧚, which covers the sub-units that turn a print job into marks on the media 🖨️ A printer can have lots of interpreters, and the table gets one entry per interpreter, both PDL and control language ones 💜.
prtChannelInformation OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..255))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Auxiliary information to allow a printing application to use
the channel for data submission to the printer. An application
capable of using a specific PrtChannelType should be able to
use the combined information from the prtChannelInformation and
other channel and interface group objects to 'bootstrap' its
use of the channel. prtChannelInformation is not intended to
provide a general channel description, nor to provide
information that is available once the channel is in use.
The encoding and interpretation of the prtChannelInformation
object is specific to channel type. The description of each
PrtChannelType enum value for which prtChannelInformation is
defined specifies the appropriate encoding and interpretation,
including interaction with other objects. For channel types
that do not specify a prtChannelInformation value, its value
shall be null (0 length).
When a new PrtChannelType enumeration value is registered, its
accompanying description must specify the encoding and
interpretation of the prtChannelInformation value for the
channel type. prtChannelInformation semantics for an existing
PrtChannelType may be added or amended in the same manner as
described in section 2.4.1 for type 2 enumeration values.
The prtChannelInformation specifies values for a collection of
channel attributes, represented as text according to the
following rules:
1. The prtChannelInformation is not affected by localization.
2. The prtChannelInformation is a list of entries representing
the attribute values. Each entry consists of the following
items, in order:
a. A keyword, composed of alphabetic characters (A-Z, a-z)
represented by their NVT ASCII [RFC854] codes, that
identifies a channel attribute,
b. The NVT ASCII code for an Equals Sign (=) (code 61) to
delimit the keyword,
c. A data value encoded using rules specific to the
PrtChannelType to with the prtChannelInformation applies which
must in no case allow an octet with value 10 (the NVT ASCII
Line Feed code),
d. the NVT ASCII code for a Line Feed character (code 10) to
delimit the data value.
No other octets shall be present.
Keywords are case-sensitive. Conventionally, keywords are
capitalized (including each word of a multi-word keyword) and
since they occupy space in the prtChannelInformation, they are
kept short.
3. If a channel attribute has multiple values, it is
represented by multiple entries with the same keyword, each
specifying one value. Otherwise, there shall be at most one
entry for each attribute.
4. By default, entries may appear in any order. If there are
ordering constraints for particular entries, these must be
specified in their definitions.
5. The prtChannelInformation value by default consists of text
represented by NVT ASCII graphics character codes. However,
other representations may be specified:
a. In cases where the prtChannelInformation value contains
information not normally coded in textual form, whatever
symbolic representation is conventionally used for the
information should be used for encoding the
prtChannelInformation value. (For instance, a binary port value
might be represented as a decimal number using NVT ASCII
codes.) Such encoding must be specified in the definition of
the value.
b. The value may contain textual information in a character set
other than NVT ASCII graphics characters. (For instance, an
identifier might consist of ISO 10646 text encoded using the
UTF-8 encoding scheme.) Such a character set and its encoding
must be specified in the definition of the value.
6. For each PrtChannelType for which prtChannelInformation
entries are defined, the descriptive text associated with the
PrtChannelType enumeration value shall specify the following
information for each entry:
Title: Brief description phrase, e.g.: 'Port name',
'Service Name', etc.
Keyword: The keyword value, e.g.: 'Port' or 'Service'
Syntax: The encoding of the entry value if it cannot be
directly represented by NVT ASCII.
Status: 'Mandatory', 'Optional', or 'Conditionally
Mandatory'
Multiplicity: 'Single' or 'Multiple' to indicate whether the
entry may be present multiple times.
Description: Description of the use of the entry, other
information required to complete the definition
(e.g.: ordering constraints, interactions between
entries).
Applications that interpret prtChannelInformation should ignore
unrecognized entries, so they are not affected if new entry
types are added."
::= { prtChannelEntry 9 }
-- The Interpreter Group
--
-- The interpreter sub-units are responsible for the conversion
-- of a description of intended print instances into images that
-- are to be marked on the media. A printer may have one or more
-- interpreters. The interpreter sub-units are represented by the
-- Interpreter Group in the Model. Each interpreter is generally
-- implemented with software running on the System Controller
-- sub-unit. The Interpreter Table has one entry per interpreter
-- where the interpreters include both Page Description Language
-- (PDL) Interpreters and Control Language Interpreters.
prtInterpreter OBJECT IDENTIFIER ::= { printmib 15 }
-- Interpreter Table
prtInterpreterTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtInterpreterEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The interpreter table is a table representing the
interpreters in the printer. An entry shall be placed in the
interpreter table for each interpreter on the printer.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtInterpreter 1 }
prtInterpreterEntry OBJECT-TYPE
SYNTAX PrtInterpreterEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries may exist in the table for each device index with a
device type of 'printer'. Each table entry provides a complete
description of the interpreter, including version information,
rendering resolutions, default character sets, output
orientation, and communication capabilities.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtInterpreterIndex }
::= { prtInterpreterTable 1 }
PrtInterpreterEntry ::= SEQUENCE {
prtInterpreterIndex Integer32,
prtInterpreterLangFamily PrtInterpreterLangFamilyTC,
prtInterpreterLangLevel OCTET STRING,
prtInterpreterLangVersion OCTET STRING,
prtInterpreterDescription PrtLocalizedDescriptionStringTC,
prtInterpreterVersion OCTET STRING,
prtInterpreterDefaultOrientation PrtPrintOrientationTC,
prtInterpreterFeedAddressability Integer32,
prtInterpreterXFeedAddressability Integer32,
prtInterpreterDefaultCharSetIn IANACharset,
prtInterpreterDefaultCharSetOut IANACharset,
prtInterpreterTwoWay PrtInterpreterTwoWayTC
}
prtInterpreterIndex OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value for each PDL or control language for which
there exists an interpreter or emulator in the printer. The
value is used to identify this interpreter. Although these
values may change due to a major reconfiguration of the device
(e.g., the addition of new interpreters to the printer), values
SHOULD remain stable across successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtInterpreterEntry 1 }
prtInterpreterLangFamily OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtInterpreterLangFamilyTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The family name of a Page Description Language (PDL) or
control language which this interpreter in the printer can
interpret or emulate.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtInterpreterEntry 2 }
prtInterpreterLangLevel OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..31))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The level of the language which this interpreter is
interpreting or emulating. This might contain a value like
'5e'for an interpreter which is emulating level 5e of the PCL
language. It might contain '2' for an interpreter which is
emulating level 2 of the PostScript language. Similarly it
might contain '2' for an interpreter which is emulating level 2
of the HPGL language."
::= { prtInterpreterEntry 3 }
prtInterpreterLangVersion OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..31))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The date code or version of the language which this
interpreter is interpreting or emulating."
::= { prtInterpreterEntry 4 }
prtInterpreterDescription OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtLocalizedDescriptionStringTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A string to identify this interpreter in the localization
specified by prtGeneralCurrentLocalization as opposed to the
language which is being interpreted. It is anticipated that
this string will allow manufacturers to unambiguously identify
their interpreters."
::= { prtInterpreterEntry 5 }
prtInterpreterVersion OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..31))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The date code, version number, or other product specific
information tied to this interpreter. This value is associated
with the interpreter, rather than with the version of the
language which is being interpreted or emulated."
::= { prtInterpreterEntry 6 }
prtInterpreterDefaultOrientation OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtPrintOrientationTC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The current orientation default for this interpreter. This
value may be overridden for a particular job (e.g., by a
command in the input data stream)."
::= { prtInterpreterEntry 7 }Bestie, the interpreter stuff is next and it's giving main character energy 👑 Stay with me 🫶
okay so the interpreter stuff keeps going 💖 and then we get to the console group 🖥️ which is basically the printer's own little control panel ✨ some are just a few lights and switches, others are full screen displays and keyboards 👀
prtInterpreterFeedAddressability OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum interpreter addressability in the feed
direction in 10000 prtMarkerAddressabilityUnits (as specified
by prtMarkerDefaultIndex) for this interpreter. The
value (-1) means other and specifically indicates that the
sub-unit places no restrictions on this parameter. The value
(-2) means unknown.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtInterpreterEntry 8 }
prtInterpreterXFeedAddressability OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum interpreter addressability in the cross feed
direction in 10000 prtMarkerAddressabilityUnits (as specified
by prtMarkerDefaultIndex) for this interpreter. The
value (-1) means other and specifically indicates that the
sub-unit places no restrictions on this parameter. The value
(-2) means unknown.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtInterpreterEntry 9 }
prtInterpreterDefaultCharSetIn OBJECT-TYPE
SYNTAX IANACharset
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The default coded character set for input octets encountered
outside a context in which the Page Description Language
established the interpretation of the octets. (Input octets are
presented to the interpreter through a path defined in the
channel group.)"
::= { prtInterpreterEntry 10 }
prtInterpreterDefaultCharSetOut OBJECT-TYPE
SYNTAX IANACharset
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The default character set for data coming from this
interpreter through the printer's output channel (i.e. the
'backchannel')."
::= { prtInterpreterEntry 11 }
prtInterpreterTwoWay OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtInterpreterTwoWayTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates whether or not this interpreter returns information
back to the host."
::= { prtInterpreterEntry 12 }
-- The Console Group
--
-- Many printers have a console on the printer, the operator
-- console, that is used to display and modify the state of the
-- printer. The console can be as simple as a few indicators and
-- switches or as complicated as full screen displays and
-- keyboards. There can be at most one such console.
-- The Display Buffer Table
prtConsoleDisplayBuffer OBJECT IDENTIFIER ::= { printmib 16 }
prtConsoleDisplayBufferTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtConsoleDisplayBufferEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Physical display buffer for printer console display or
operator panel
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtConsoleDisplayBuffer 5 }
prtConsoleDisplayBufferEntry OBJECT-TYPE
SYNTAX PrtConsoleDisplayBufferEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains one entry for each physical line on
the display. Lines cannot be added or deleted. Entries may
exist in the table for each device index with a device type of
'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtConsoleDisplayBufferIndex }
::= { prtConsoleDisplayBufferTable 1 }
PrtConsoleDisplayBufferEntry ::= SEQUENCE {
prtConsoleDisplayBufferIndex Integer32,
prtConsoleDisplayBufferText PrtConsoleDescriptionStringTC
}
prtConsoleDisplayBufferIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value for each console line in the printer. The value
is used to identify this console line. Although these values
may change due to a major reconfiguration of the device (e.g.,
the addition of new console lines to the printer). Values
SHOULD remain stable across successive printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtConsoleDisplayBufferEntry 1 }
prtConsoleDisplayBufferText OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtConsoleDescriptionStringTC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The content of a line in the logical display buffer of
the operator's console of the printer. When a write
operation occurs, normally a critical message, to one of
the LineText strings, the agent should make that line
displayable if a physical display is present. Writing a zero
length string clears the line. It is an implementation-
specific matter as to whether the agent allows a line to be
overwritten before it has been cleared. Printer generated
strings shall be in the localization specified by
prtConsoleLocalization.Management Application generated strings
should be localized by the Management Application."
::= { prtConsoleDisplayBufferEntry 2 }
-- The Console Light Table
prtConsoleLights OBJECT IDENTIFIER ::= { printmib 17 }
prtConsoleLightTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtConsoleLightEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The console light table provides a description and state
information for each light present on the printer console.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtConsoleLights 6 }
prtConsoleLightEntry OBJECT-TYPE
SYNTAX PrtConsoleLightEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries may exist in the table for each device index with a
device type of 'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtConsoleLightIndex }
::= { prtConsoleLightTable 1 }
PrtConsoleLightEntry ::= SEQUENCE {
prtConsoleLightIndex Integer32,
prtConsoleOnTime Integer32,
prtConsoleOffTime Integer32,
prtConsoleColor PrtConsoleColorTC,
prtConsoleDescription PrtConsoleDescriptionStringTC
}
prtConsoleLightIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535) -- Lower limit invalid in RFC 1759
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique value used by the printer to identify this light.
Although these values may change due to a major
reconfiguration of the device (e.g., the addition of new lights
to the printer). Values SHOULD remain stable across successive
printer power cycles.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtConsoleLightEntry 1 }
prtConsoleOnTime OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (0..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object, in conjunction with prtConsoleOffTime, defines
the current status of the light. If both prtConsoleOnTime and
prtConsoleOffTime are non-zero, the lamp is blinking and the
values presented define the on time and off time, respectively,
in milliseconds. If prtConsoleOnTime is zero and
prtConsoleOffTime is non-zero, the lamp is off. If
prtConsoleOffTime is zero and prtConsoleOnTime is non-zero, the
lamp is on. If both values are zero the lamp is off.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtConsoleLightEntry 2 }
prtConsoleOffTime OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (0..2147483647)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object, in conjunction with prtConsoleOnTime, defines the
current status of the light. If both prtConsoleOnTime and
prtConsoleOffTime are non-zero, the lamp is blinking and the
values presented define the on time and off time, respectively,
in milliseconds. If prtConsoleOnTime is zero and
prtConsoleOffTime is non-zero, the lamp is off. If
prtConsoleOffTime is zero and prtConsoleOnTime is non-zero, the
lamp is on. If both values are zero the lamp is off.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtConsoleLightEntry 3 }
prtConsoleColor OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtConsoleColorTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The color of this light."
::= { prtConsoleLightEntry 4 }
prtConsoleDescription OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtConsoleDescriptionStringTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The vendor description or label of this light in the
localization specified by prtConsoleLocalization."
::= { prtConsoleLightEntry 5 }
-- The Alerts Group
--
-- The table contains information on the severity, component,
-- detail location within the component, alert code and
-- description of each critical alert that is currently active
-- within the printer. See 2.2.13 for a more complete
-- description of the alerts table and its management.
--
-- Each parameter in the Trap PDU is a full OID which itself is
-- indexed by the host resources MIB "hrDeviceIndex" object. In
-- order for a management station to obtain the correct
-- "hrDeviceIndex" associated with a particular Trap PDU, the
-- "hrDeviceIndex" value can be extracted from the returned OID
-- value in the Trap PDU when the PDU is received by the
-- Management station.
prtAlert OBJECT IDENTIFIER ::= { printmib 18 }
prtAlertTable OBJECT-TYPE
SYNTAX SEQUENCE OF PrtAlertEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The prtAlertTable lists all the critical and non-critical
alerts currently active in the printer. A critical alert is
one that stops the printer from printing immediately and
printing can not continue until the critical alert condition
is eliminated. Non-critical alerts are those items that do
not stop printing but may at some future time.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtAlert 1 }
prtAlertEntry OBJECT-TYPE
SYNTAX PrtAlertEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entries may exist in the table for each device
index with a device type of 'printer'.
NOTE: The above description has been modified from RFC 1759
for clarification."
INDEX { hrDeviceIndex, prtAlertIndex }
::= { prtAlertTable 1 }Okay bestie, so the alert table is basically the printer's little diary of things going wrong 📋 Here's the row layout, and every single entry gets its own number 🎀
PrtAlertEntry ::= SEQUENCE {
prtAlertIndex Integer32,
prtAlertSeverityLevel PrtAlertSeverityLevelTC,
prtAlertTrainingLevel PrtAlertTrainingLevelTC,
prtAlertGroup PrtAlertGroupTC,
prtAlertGroupIndex Integer32,
prtAlertLocation Integer32,
prtAlertCode PrtAlertCodeTC,
prtAlertDescription PrtLocalizedDescriptionStringTC,
prtAlertTime TimeTicks
}
prtAlertIndex OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined. The MAX-ACCESS has
-- been changed from not accessible to allow the object to be
-- included (as originally in RFC 1759) in the trap bindings.
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The index value used to determine which alerts have been added
or removed from the alert table. This is an incrementing
integer initialized to 1 when the printer is reset. (i.e., The
first event placed in the alert table after a reset of the
printer shall have an index value of 1.) When the printer adds
an alert to the table, that alert is assigned the next higher
integer value from the last item entered into the table. If
the index value reaches its maximum value, the next index value
used must be 1.
NOTE: The management application will read the alert table when
a trap or event notification occurs or at a periodic rate and
then parse the table to determine if any new entries were added
by comparing the last known index value with the current
highest index value. The management application will then
update its copy of the alert table. When the printer discovers
that an alert is no longer active, the printer shall remove the
row for that alert from the table and shall reduce the number
of rows in the table. The printer may add or delete any number
of rows from the table at any time. The management station can
detect when binary change alerts have been deleted by
requesting an attribute of each alert, and noting alerts as
deleted when that retrieval is not possible. The objects
'prtAlertCriticalEvents'and 'prtAlertAllEvents' in the
'prtGeneralTable' reduce the need for management applications
to scan the 'prtAlertTable'.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtAlertEntry 1 }
prtAlertSeverityLevel OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtAlertSeverityLevelTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The level of severity of this alert table entry. The printer
determines the severity level assigned to each entry into the
table."
::= { prtAlertEntry 2 }
prtAlertTrainingLevel OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtAlertTrainingLevelTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"See TEXTUAL-CONVENTION PrtAlertTrainingLevelTC.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtAlertEntry 3 }
prtAlertGroup OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtAlertGroupTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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."
::= { prtAlertEntry 4 }Next up, the group index tells you exactly which sub-unit caused the alert, and the location narrows it down even further 🔍✨
prtAlertGroupIndex OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The low-order index of the row within the table identified
by prtAlertGroup that represents the sub-unit of the printer
that caused this alert, or -1 if not applicable. The
combination of the prtAlertGroup and the prtAlertGroupIndex
defines exactly which printer sub-unit caused the alert; for
example, Input #3, Output#2, and Marker #1. Every object in
this MIB is indexed with hrDeviceIndex and optionally, another
index variable. If this other index variable is present in the
table that generated the alert, it will be used as the value
for this object. Otherwise, this value shall be -1.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtAlertEntry 5 }
prtAlertLocation OBJECT-TYPE
-- NOTE: In RFC 1759, the range was not defined.
SYNTAX Integer32 (-2..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtAlertEntry 6 }
prtAlertCode OBJECT-TYPE
-- NOTE: In RFC 1759, the enumeration values were implicitly
-- defined by this object.
SYNTAX PrtAlertCodeTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"See associated TEXTUAL-CONVENTION PrtAlertCodeTC.
NOTE: The above description has been modified from RFC 1759
for clarification."
::= { prtAlertEntry 7 }
prtAlertDescription OBJECT-TYPE
-- In RFC 1759, the SYNTAX was OCTET STRING. This has been changed
-- to a TC to better support localization of the object.
SYNTAX PrtLocalizedDescriptionStringTC
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A description of this alert entry in the localization
specified by prtGeneralCurrentLocalization. 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."
::= { prtAlertEntry 8 }
prtAlertTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime at the time that this alert was
generated."
::= { prtAlertEntry 9 }Now the trap bits 🔔 This is where the alerts get shouted out to the management station, with a little SNMPv1 translation twist 🦋
printerV1Alert OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The value of the enterprise-specific OID in an SNMPv1 trap
sent signaling a critical event in the prtAlertTable."
::= { prtAlert 2 }
printerV2AlertPrefix OBJECT IDENTIFIER ::= { printerV1Alert 0 }
printerV2Alert NOTIFICATION-TYPE
OBJECTS { prtAlertIndex, prtAlertSeverityLevel, prtAlertGroup,
prtAlertGroupIndex, prtAlertLocation, prtAlertCode }
STATUS current
DESCRIPTION
"This trap is sent whenever a critical event is added to the
prtAlertTable.
NOTE: The prtAlertIndex object was redundantly included in the
bindings of the 'printerV2Alert' notification in RFC 1759, even
though the value exists in the instance qualifier of all the
other bindings. This object has been retained to provide
compatiblity with existing RFC 1759 implementaions."
::= { printerV2AlertPrefix 1 }
-- Note that the SNMPv2 to SNMPv1 translation rules dictate that
-- the preceding structure will result in SNMPv1 traps of the
-- following form:
--
-- printerAlert TRAP-TYPE
-- ENTERPRISE printerV1Alert
-- VARIABLES { prtAlertIndex, prtAlertSeverityLevel,
-- prtAlertGroup, prtAlertGroupIndex,
-- prtAlertLocation, prtAlertCode }
-- DESCRIPTION
-- "This trap is sent whenever a critical event is added
-- to the prtAlertTable."
-- ::= 1
-- Conformance Information
prtMIBConformance OBJECT IDENTIFIER ::= { printmib 2 }
-- compliance statements
prtMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for agents that implement the
printer MIB as defined by RFC 1759."
MODULE -- this module
MANDATORY-GROUPS { prtGeneralGroup, prtInputGroup,
prtOutputGroup,
prtMarkerGroup, prtMediaPathGroup,
prtChannelGroup, prtInterpreterGroup,
prtConsoleGroup, prtAlertTableGroup }
OBJECT prtGeneralReset
SYNTAX INTEGER {
notResetting(3),
resetToNVRAM(5)
}
DESCRIPTION
"It is conformant to implement just these two states in this
object. Any additional states are optional."
OBJECT prtConsoleOnTime
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtConsoleOffTime
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
::= { prtMIBConformance 1 }okay so this is the compliance checklist, the part where the MIB says what an agent has to do to count as "yes, I speak Printer MIB V2" 🖨️💖 the MANDATORY-GROUPS list is the core crew, and everything marked GROUP is the optional extras 🎀
prtMIB2Compliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for agents that implement the
printer MIB V2."
-- The changes from RFC 1759 fall into 2 categories:
-- 1. New objects plus existing objects with a MIN-ACCESS of
-- read-only are included. Existing objects have been added
-- to this category due to feedback from implementers and
-- interoperability testing. This allows products to be
-- be designed with a higher degree of SNMP security.
-- 2. New object groups have been added to include all new
-- objects in this MIB. All new object groups are optional.
-- Any MIB that is compliant with RFC 1759 will also be
-- compliant with this version of the MIB.
MODULE -- this module
MANDATORY-GROUPS { prtGeneralGroup, prtInputGroup,
prtOutputGroup,
prtMarkerGroup, prtMediaPathGroup,
prtChannelGroup, prtInterpreterGroup,
prtConsoleGroup, prtAlertTableGroup }
OBJECT prtGeneralReset
SYNTAX INTEGER {
notResetting(3),
resetToNVRAM(5)
}
DESCRIPTION
"It is conformant to implement just these two states in this
object. Any additional states are optional."
OBJECT prtGeneralCurrentLocalization
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtGeneralCurrentOperator
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtGeneralServicePerson
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtGeneralPrinterName
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtGeneralSerialNumber
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputDefaultIndex
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputMediaDimFeedDirDeclared
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputMaxCapacity
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputCurrentLevel
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputMediaName
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputName
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputSecurity
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputMediaWeight
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputMediaType
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputMediaColor
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputMediaFormParts
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputDefaultIndex
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputMaxCapacity
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputRemainingCapacity
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputName
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputSecurity
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputMaxDimFeedDir
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputMaxDimXFeedDir
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputMinDimFeedDir
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputMinDimXFeedDir
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputStackingOrder
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputPageDeliveryOrientation
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputBursting
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputDecollating
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputPageCollated
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtOutputOffsetStacking
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtMarkerDefaultIndex
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtMarkerSuppliesMaxCapacity
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtMarkerSuppliesLevel
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtMediaPathDefaultIndex
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtChannelCurrentJobCntlLangIndex
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtChannelDefaultPageDescLangIndex
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtChannelState
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtChannelIfIndex
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInterpreterDefaultOrientation
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInterpreterDefaultCharSetIn
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInterpreterDefaultCharSetOut
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtConsoleLocalization
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtConsoleDisable
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtConsoleDisplayBufferText
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtConsoleOnTime
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtConsoleOffTime
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtAlertIndex
MIN-ACCESS accessible-for-notify
DESCRIPTION
"It is conformant to implement this object as
accessible-for-notify "
GROUP prtResponsiblePartyGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtExtendedInputGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtInputMediaGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtExtendedOutputGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtOutputDimensionsGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtOutputFeaturesGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtMarkerSuppliesGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtMarkerColorantGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtAlertTimeGroup
DESCRIPTION
"This group is unconditionally optional."
-- the prtResponsiblePartyGroup, prtExtendedInputGroup,
-- prtInputMediaGroup, prtExtendedOutputGroup,
-- prtOutputDimensionsGroup, prtOutputFeaturesGroup,
-- prtMarkerSuppliesGroup, prtMarkerColorantGroup, and the
-- prtAlertTimeGroup are completely optional. However, it is
-- strongly RECOMMENDED that the prtAlertTimeGroup be implemented.
-- New to version 2 of this printer MIB:
OBJECT prtAuxiliarySheetStartupPage
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtAuxiliarySheetBannerPage
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputMediaLoadTimeout
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
OBJECT prtInputNextIndex
MIN-ACCESS read-only
DESCRIPTION
"It is conformant to implement this object as read-only"
GROUP prtAuxiliarySheetGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtInputSwitchingGroup
DESCRIPTION
"This group is unconditionally optional."
GROUP prtGeneralV2Group
DESCRIPTION
"This group is unconditionally optional."
GROUP prtAlertTableV2Group
DESCRIPTION
"This group is unconditionally optional."
GROUP prtChannelV2Group
DESCRIPTION
"This group is unconditionally optional."
GROUP prtAlertTrapGroup
DESCRIPTION
"This group is unconditionally optional."
::= { prtMIBConformance 3 }
prtMIBGroups OBJECT IDENTIFIER ::= { prtMIBConformance 2 }
-- These groups are from RFC 1759 and are applicable to Printer MIB V2
prtGeneralGroup OBJECT-GROUP
OBJECTS { prtGeneralConfigChanges,
prtGeneralCurrentLocalization,
prtGeneralReset, prtCoverDescription,
prtCoverStatus,
prtLocalizationLanguage, prtLocalizationCountry,
prtLocalizationCharacterSet, prtStorageRefIndex,
prtDeviceRefIndex }
STATUS current
DESCRIPTION
"The general printer group."
::= { prtMIBGroups 1 }
prtResponsiblePartyGroup OBJECT-GROUP
OBJECTS { prtGeneralCurrentOperator, prtGeneralServicePerson }
STATUS current
DESCRIPTION
"The responsible party group contains contact information for
humans responsible for the printer."
::= { prtMIBGroups 2 }next up: the group definitions keep rolling, bestie 🧚💜
Okay so the groups keep coming, and every single one is a little bundle of objects that belong together 🎀 Input, output, marker, media path... it's giving organized closet energy 🧚
prtInputGroup OBJECT-GROUP
OBJECTS { prtInputDefaultIndex, prtInputType, prtInputDimUnit,
prtInputMediaDimFeedDirDeclared,
prtInputMediaDimXFeedDirDeclared,
prtInputMediaDimFeedDirChosen,
prtInputMediaDimXFeedDirChosen, prtInputCapacityUnit,
prtInputMaxCapacity, prtInputCurrentLevel, prtInputStatus,
prtInputMediaName }
STATUS current
DESCRIPTION
"The input group."
::= { prtMIBGroups 3 }
prtExtendedInputGroup OBJECT-GROUP
OBJECTS { prtInputName, prtInputVendorName, prtInputModel,
prtInputVersion, prtInputSerialNumber,
prtInputDescription, prtInputSecurity }
STATUS current
DESCRIPTION
"The extended input group."
::= { prtMIBGroups 4 }
prtInputMediaGroup OBJECT-GROUP
OBJECTS { prtInputMediaWeight, prtInputMediaType,
prtInputMediaColor, prtInputMediaFormParts }
STATUS current
DESCRIPTION
"The input media group."
::= { prtMIBGroups 5 }
prtOutputGroup OBJECT-GROUP
OBJECTS { prtOutputDefaultIndex, prtOutputType,
prtOutputCapacityUnit, prtOutputMaxCapacity,
prtOutputRemainingCapacity, prtOutputStatus }
STATUS current
DESCRIPTION
"The output group."
::= { prtMIBGroups 6 }
prtExtendedOutputGroup OBJECT-GROUP
OBJECTS { prtOutputName, prtOutputVendorName, prtOutputModel,
prtOutputVersion, prtOutputSerialNumber,
prtOutputDescription, prtOutputSecurity }
STATUS current
DESCRIPTION
"The extended output group."
::= { prtMIBGroups 7 }
prtOutputDimensionsGroup OBJECT-GROUP
OBJECTS { prtOutputDimUnit, prtOutputMaxDimFeedDir,
prtOutputMaxDimXFeedDir, prtOutputMinDimFeedDir,
prtOutputMinDimXFeedDir }
STATUS current
DESCRIPTION
"The output dimensions group"
::= { prtMIBGroups 8 }
prtOutputFeaturesGroup OBJECT-GROUP
OBJECTS { prtOutputStackingOrder,
prtOutputPageDeliveryOrientation, prtOutputBursting,
prtOutputDecollating, prtOutputPageCollated,
prtOutputOffsetStacking }
STATUS current
DESCRIPTION
"The output features group."
::= { prtMIBGroups 9 }
prtMarkerGroup OBJECT-GROUP
OBJECTS { prtMarkerDefaultIndex, prtMarkerMarkTech,
prtMarkerCounterUnit, prtMarkerLifeCount,
prtMarkerPowerOnCount, prtMarkerProcessColorants,
prtMarkerSpotColorants, prtMarkerAddressabilityUnit,
prtMarkerAddressabilityFeedDir,
prtMarkerAddressabilityXFeedDir, prtMarkerNorthMargin,
prtMarkerSouthMargin, prtMarkerWestMargin,
prtMarkerEastMargin, prtMarkerStatus }
STATUS current
DESCRIPTION
"The marker group."
::= { prtMIBGroups 10 }
prtMarkerSuppliesGroup OBJECT-GROUP
OBJECTS { prtMarkerSuppliesMarkerIndex,
prtMarkerSuppliesColorantIndex, prtMarkerSuppliesClass,
prtMarkerSuppliesType, prtMarkerSuppliesDescription,
prtMarkerSuppliesSupplyUnit,
prtMarkerSuppliesMaxCapacity, prtMarkerSuppliesLevel }
STATUS current
DESCRIPTION
"The marker supplies group."
::= { prtMIBGroups 11 }
prtMarkerColorantGroup OBJECT-GROUP
OBJECTS { prtMarkerColorantMarkerIndex, prtMarkerColorantRole,
prtMarkerColorantValue, prtMarkerColorantTonality }
STATUS current
DESCRIPTION
"The marker colorant group."
::= { prtMIBGroups 12 }
prtMediaPathGroup OBJECT-GROUP
OBJECTS { prtMediaPathDefaultIndex, prtMediaPathMaxSpeedPrintUnit,
prtMediaPathMediaSizeUnit, prtMediaPathMaxSpeed,
prtMediaPathMaxMediaFeedDir,
prtMediaPathMaxMediaXFeedDir,
prtMediaPathMinMediaFeedDir,
prtMediaPathMinMediaXFeedDir, prtMediaPathType,
prtMediaPathDescription, prtMediaPathStatus}
STATUS current
DESCRIPTION
"The media path group."
::= { prtMIBGroups 13 }
prtChannelGroup OBJECT-GROUP
OBJECTS { prtChannelType, prtChannelProtocolVersion,
prtChannelCurrentJobCntlLangIndex,
prtChannelDefaultPageDescLangIndex, prtChannelState,
prtChannelIfIndex, prtChannelStatus
}
STATUS current
DESCRIPTION
"The channel group."
::= { prtMIBGroups 14 }
prtInterpreterGroup OBJECT-GROUP
OBJECTS { prtInterpreterLangFamily, prtInterpreterLangLevel,
prtInterpreterLangVersion, prtInterpreterDescription,
prtInterpreterVersion, prtInterpreterDefaultOrientation,
prtInterpreterFeedAddressability,
prtInterpreterXFeedAddressability,
prtInterpreterDefaultCharSetIn,
prtInterpreterDefaultCharSetOut, prtInterpreterTwoWay }
STATUS current
DESCRIPTION
"The interpreter group."
::= { prtMIBGroups 15 }
prtConsoleGroup OBJECT-GROUP
OBJECTS { prtConsoleLocalization, prtConsoleNumberOfDisplayLines,
prtConsoleNumberOfDisplayChars, prtConsoleDisable,
prtConsoleDisplayBufferText, prtConsoleOnTime,
prtConsoleOffTime, prtConsoleColor,
prtConsoleDescription }
STATUS current
DESCRIPTION
"The console group."
::= { prtMIBGroups 16 }
prtAlertTableGroup OBJECT-GROUP
OBJECTS { prtAlertSeverityLevel, prtAlertTrainingLevel,
prtAlertGroup, prtAlertGroupIndex, prtAlertLocation,
prtAlertCode, prtAlertDescription }
STATUS current
DESCRIPTION
"The alert table group."
::= { prtMIBGroups 17 }
prtAlertTimeGroup OBJECT-GROUP
OBJECTS { prtAlertTime }
STATUS current
DESCRIPTION
"The alert time group. Implementation of prtAlertTime is
strongly RECOMMENDED."
::= { prtMIBGroups 18 }
prtMIB2Groups OBJECT IDENTIFIER ::= { prtMIBConformance 4 }
-- These groups are unique to Printer MIB V2
prtAuxiliarySheetGroup OBJECT-GROUP
OBJECTS { prtAuxiliarySheetStartupPage,
prtAuxiliarySheetBannerPage }
STATUS current
DESCRIPTION
"The auxiliary sheet group."
::= { prtMIBGroups 19 }
prtInputSwitchingGroup OBJECT-GROUP
OBJECTS { prtInputMediaLoadTimeout, prtInputNextIndex }
STATUS current
DESCRIPTION
"The input switching group."
::= { prtMIBGroups 20 }
prtGeneralV2Group OBJECT-GROUP
OBJECTS { prtGeneralPrinterName, prtGeneralSerialNumber }
STATUS current
DESCRIPTION
"The general printer group with new v2 objects."
::= { prtMIBGroups 21 }
prtAlertTableV2Group OBJECT-GROUP
OBJECTS { prtAlertIndex, prtAlertCriticalEvents, prtAlertAllEvents }
STATUS current
DESCRIPTION
"The alert table group with new v2 objects and prtAlertIndex
changed to MAX-ACCESS of 'read-only' for inclusion in the trap
bindings (as originally defined in RFC 1759)."
::= { prtMIBGroups 22 }
prtChannelV2Group OBJECT-GROUP
OBJECTS { prtChannelInformation }
STATUS current
DESCRIPTION
"The channel group with a new v2 object."
::= { prtMIBGroups 23 }
prtAlertTrapGroup NOTIFICATION-GROUP
NOTIFICATIONS { printerV2Alert }
STATUS current
DESCRIPTION
"The alert trap group."
::= { prtMIBGroups 24 }
END7. IANA Considerations ✨
Okay, bestie, this bit is all about who looks after the IANA Printer MIB 🦋 The first version of the IANA Printer MIB, the one defined in section 5 of this document, gets archived by IANA 📚 After that, IANA keeps it up to date following the Process described in section 2.4.1 of this document 💅
The most current and authoritative version lives at http://www.iana.org/assignments/ianaprinter-mib 🌸
8. Internationalization Considerations 🌈
Quick one, promise 🫶 For the international stuff, just head to section 2.2.1.1, 'International Considerations' 🍓
9. Security Considerations 💀
okay bestie, this section is dead serious, so I'm keeping the drama but making sure you actually get it 😭. This MIB module has a bunch of management objects with a MAX-ACCESS clause of read-write and/or read-create. Those objects can be sensitive or vulnerable in some network environments. Supporting SET operations in a non-secure environment without proper protection can totally mess with network operations. Here are the tables and objects and how sensitive or vulnerable each one is:
prtGeneralTable:
prtGeneralCurrentLocalization - Possible data loss
prtGeneralReset - Possible data loss
prtGeneralCurrentOperator - Possible severe inconvenience
prtGeneralServicePerson - Possible severe inconvenience
prtInputDefaultIndex - Possible data loss
prtOutputDefaultIndex - Possible minor inconvenience
prtMarkerDefaultIndex - Possible minor inconvenience
prtMediaPathDefaultIndex - Possible minor inconvenience
prtConsoleLocalization - Possible severe inconvenience
prtConsoleDisable - Possible severe inconvenience
prtAuxiliarySheetStartupPage - Possible minor inconvenience
prtAuxiliarySheetBannerPage - Possible minor inconvenience
prtGeneralPrinterName - Possible severe inconvenience
prtGeneralSerialNumber - Possible severe inconvenience
prtInputTable:
prtInputMediaDimFeedDirDeclared - Possible data loss
prtInputMediaDimXFeedDirDeclared - Possible data loss
prtInputMaxCapacity - Possible minor inconvenience
prtInputCurrentLevel - Possible minor inconvenience
prtInputMediaName - Possible minor inconvenience
prtInputName - Possible minor inconvenience
prtInputSecurity - Possible minor inconvenience
prtInputMediaWeight - Possible minor inconvenience
prtInputMediaType - Possible minor inconvenience
prtInputMediaColor - Possible minor inconvenience
prtInputMediaFormParts - Possible minor inconvenience
prtInputMediaLoadTimeout - Possible minor inconvenience
prtInputNextIndex - Possible minor inconvenience
prtOutputTable
prtOutputMaxCapacity - Possible minor inconvenience
prtOutputRemainingCapacity - Possible minor inconvenience
prtOutputName - Possible minor inconvenience
prtOutputSecurity - Possible minor inconvenience
prtOutputMaxDimFeedDir - Possible minor inconvenience
prtOutputMaxDimXFeedDir - Possible minor inconvenience
prtOutputMinDimFeedDir - Possible minor inconvenience
prtOutputMinDimXFeedDir - Possible minor inconvenience
prtOutputStackingOrder - Possible minor inconvenience
prtOutputPageDeliveryOrientation - Possible minor inconvenience
prtOutputBursting - Possible minor inconvenience
prtOutputDecollating - Possible minor inconvenience
prtOutputPageCollated - Possible minor inconvenience
prtOutputOffsetStacking - Possible minor inconvenience
prtMarkerSuppliesTable
prtMarkerSuppliesMaxCapacity - Possible minor inconvenience
prtMarkerSuppliesLevel - Possible minor inconvenience
prtChannelTable
prtChannelCurrentJobCntlLangIndex - Possible data loss
prtChannelDefaultPageDescLangIndex - Possible data loss
prtChannelState - Possible minor inconvenience
prtChannelIfIndex - Possible minor inconvenience
prtInterpreterTable
prtInterpreterDefaultOrientation - Possible data loss
prtInterpreterDefaultCharSetIn - Possible data loss
prtInterpreterDefaultCharSetOut - Possible minor inconvenience
prtConsoleDisplayBufferTable
prtConsoleDisplayBufferText - Possible minor inconvenience
prtConsoleLightTable
prtConsoleOnTime - Possible minor inconvenience
prtConsoleOffTime - Possible minor inconvenienceSNMP versions before SNMPv3 did not include adequate security 🙈. Even if the network itself is secure (for example, by using IPSec), there's still no control over who on that secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB module. Not okay.
It is RECOMMENDED that implementers consider the security features provided by the SNMPv3 framework (see [RFC3410], section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy). That's the glow-up you want ✨.
Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator responsibility to ensure that the SNMP entity giving access to an instance of this MIB module is properly configured to give access to the objects only to those principals (users) that have legitimate rights to indeed GET or SET (change/create/delete) them. Access control is literally the bouncer at the club 🧚.
Where the operational capability of the printing device is especially vulnerable or difficult to administer, certain objects within this MIB have been tagged as READ-ONLY, which prevents modification. Further, for all READ-WRITE objects within the MIB, the working group has included specific conformance guidelines stating that vendors are free to implement these objects as READ-ONLY. This conformance allowance should cover cases where specific vendor vulnerabilities may differ from product to product. (See the conformance section with regards to MIN-ACCESS clauses.) Vendors get wiggle room, and that's iconic 💅.
10. References 📚
10.1. Normative References
Here's the whole normative list, copied word for word so nothing gets lost 🦋:
[ASCII] ANSI, "Coded Character Set - 7-bit American Standard Code
for Information Interchange", ANSI X3.4-1986.
[CHARSET] IANA Character Set Registry:
http://www.iana.org/assignments/character-sets
[CHARMIB] IANA Character Set MIB:
http://www.iana.org/assignments/ianacharset-mib
[ISO10175] ISO, "Document Printing Application (DPA)", ISO 10175,
1996.
[ISO10646] ISO, "Universal Multiple-Octet Coded Character Set (UCS) -
Part 1: Architecture and Basic Multilingual Plane", ISO
10646-1, September 2000. ISO, "Universal Multiple-Octet
Coded Character Set (UCS) - Part 2: Supplemental Planes",
ISO 10646-2, January 2001.
[PWGMEDIA] IEEE-ISTO PWG "The Printer Working Group Standard for
Media Standardized Names", IEEE-ISTO PWG 5101.1-2002.
[RFC1213] McCloghrie, K. and M. Rose, "Management Information Base
for Network Management of TCP/IP-based internets: MIB-II",
STD 17, RFC 1213, March 1991.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2277] Alvestrand, H., "IETF Policy on Character Sets and
Languages", BCP 18, RFC 2277, January 1998.
[RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO
10646", RFC 3629, November 2003.
[RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an
IANA Considerations Section in RFCs", BCP 26, RFC 2434,
October 1998.
[RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Structure of Management Information Version 2 (SMIv2)",
STD 58, RFC 2578, April 1999.
[RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Textual Conventions for SMIv2", STD 58, RFC 2579, April
1999.
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999.
[RFC2790] Waldbusser, S. and P. Grillo, "Host Resources MIB", RFC
2790, March 2000.
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
MIB", RFC 2863, June 2000.
[RFC3806] Bergman, R., Lewis, H., and I. McDonald, "Printer
Finishing MIB", RFC 3806, June 2004.10.2. Informative References
And the informative ones, also verbatim 🌸:
[APPLEMAC] Apple staff, "Inside MacIntosh: Networking", 1994.
[RFC854] Postel, J. and J. Reynolds, "Telnet Protocol
Specification", STD 8, RFC 854, May 1983.
[RFC959] Postel, J. and J. Reynolds, "File Transfer Protocol", STD
9, RFC 959, October 1985.
[RFC1179] McLaughlin, L., "Line printer daemon protocol", RFC 1179,
August 1990.
[RFC1350] Sollins, K., "The TFTP Protocol (Revision 2)", STD 33, RFC
1350, July 1992.
[RFC1945] Berners-Lee, T., Fielding, R., and H. Frystyk, "Hypertext
Transfer Protocol - HTTP/1.0", RFC 1945, May 1996.
[RFC2246] Dierks, T. and C. Allen, "The TLS Protocol Version 1.0",
RFC 2246, 1999.
[RFC2396] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform
Resource Identifiers (URI): Generic Syntax", RFC 2396,
August 1998.
[RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H.,
Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext
Transfer Protocol - HTTP/1.1", RFC 2616, June 1999.
[RFC2821] Klensin, J., Ed., "Simple Mail Transfer Protocol", RFC
2821, April 2001.
[RFC2822] Resnick, P., Ed., "Internet Message Format", RFC 2822,
April 2001.
[RFC2910] Herriot, R., Ed., Butler, S., Moore, P., Turner, R., and
J. Wenn, "Internet Printing Protocol/1.1: Encoding and
Transport", RFC 2910, September 2000.
[RFC2911] Hastings, T., Ed., Herriot, R., deBry, R., Isaacson, S.,
and P. Powell, "Internet Printing Protocol/1.1: Model and
Semantics", RFC 2911, September 2000.
[RFC2978] Freed, N. and J. Postel, "IANA Charset Registration
Procedures", BCP 19, RFC 2978, October 2000.
[RFC3232] Reynolds, J., Ed., "Assigned Numbers: RFC 1700 is
Replaced by an On-line Database", RFC 3232, January 2002.
[RFC3285] Gahrns, M. and T. Hain, "Using Microsoft Word to create
Internet Drafts and RFCs", RFC 3285, May 2002.
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.Appendix A - Glossary of Terms 💅
okay bestie, here's the glossary 🎀 every term defined so we're all on the same page ✨
- Addressability - On the marker, the number of distinct marking units (pels) per unit of addressability unit that can be set. For example, 300 dots per inch is written as 300 per 1000 Thousandths Of Inches, and 4 dots per millimeter is 4 per 1000 Micrometers. Addressability is not resolution, because marks that are one addressability position apart may not be independently resolvable by the eye, due to things like gain in the area of marks so they overlap or nearly touch 👀
- Alert - A reportable event that has an entry in the alert table 🚨
- Bin - An output sub-unit that may or may not be removable 📦
- Binary Change Event - An event that comes in pairs: the leading edge event and the trailing edge event. The leading edge event enters a state that has only one exit. A binary change event may be critical or non-critical. See unary change event 🔁
- Bursting - The process where continuous media gets separated into individual sheets, usually by bursting along pre-formed perforations 🧻
- Channel - A term for a single source of data that gets presented to a printer. The model we use allows for an arbitrary number of channels, and multiple channels can exist on the same physical port. This is super common over Ethernet ports, where EtherTalk, TCP/IP, and SPX/IPX protocols can all be supplying different data streams to one printer on the same port at the same time 🌈
- Collation - In multiple copy output, putting the pages from separate copies into separate ordered sets, ready for binding 📚
- Control Language - A data syntax or language for controlling the printer through the print data channel 🎛️
- Critical Alert - An alert triggered by an event that leads to a state where printing is no longer possible, so the printer is stopped 🛑
- Decollating - The process of separating the individual parts within a multi-part form and sorting them into separate stacks for each part 🗂️
- Description - Information about the configuration and capabilities of the printer and its various sub-units 📝
- DPA - ISO 10175 Document Printing Application standard. It's a standard for a client server protocol for a print system, covering (1) submitting print jobs to and (2) managing print jobs in a spooler 🖨️
- Event - A state change in the printer ⚡
- Group - A collection of objects that represent a type of sub-unit of the printer 🧺
- Host Resources MIB - See [RFC2790] 🫶
- IANA - Internet Assigned Numbers Authority. See [RFC3232] 🔢
- Idempotent - Idempotence is the property of an operation that results in the same state no matter how many times it is executed (at least once). It's a property shared by true databases, where operations on data items only change the state of the data item and don't have other side effects. Because the SNMP data model is that of operations on a database, SNMP MIB objects should be assumed to be idempotent. If a MIB object is defined in a non-idempotent way, the this data model can break in subtle ways when faced with packet loss, multiple managers, and other common conditions 🙈
In order to fulfill the common need for actions to result from SNMP Set operations, SNMP MIB objects can be modeled so that the change in state from one state to another has the side effect of causing an action. It's important to note that with this model, an SNMP operation that sets a value equal to its current value will cause no action. This keeps the idempotence of a single command, while still letting actions get initiated by SNMP SET requests 🧠
- Input - A tray or bin that media instances are obtained from and fed into the Media Path 📥
- Interpreter - The embodiment of an algorithm that processes a data stream made up of a Page Description Language (PDL) and/or a Control Language 🧩
- Localization - The specification of human language, country, and character set needed to present information to people in their native languages 🌍
- Management Application (a.k.a. Manager) - A program that queries and controls one or more managed nodes 🧑💻
- Management Station - A physical computer on which one or more management applications can run 💻
- Media Path - The mechanisms that transport instances of the media from an input, through the marker, possibly through media buffers and duplex pathways, out to the output with optional finishing applied. The inputs and outputs are not part of the Media Path 🛤️
- Non-critical Alert - An alert triggered by a reportable event that does not lead to a state where printing is no longer possible. It may lead to a state from which printing may no longer be possible in the future, like the low toner state, or it may be purely informational, like a configuration change at the printer 🪫
- Output - A bin or stacker that accepts instances of media that have been processed by a printer 📤
- Page Description Language (PDL) - A data syntax or language for the electronic representation of a document as a sequence of page images 📄
- Printer - A physical device that takes media from an input source, produces marks on that media according to some page description or page control language, and puts the result in some output destination, possibly with finishing applied 🖨️✨
- Printing - The entire process of producing a printed document, from generating the file to be printed, choosing printing properties, selecting a printer, routing, queuing, resource management, scheduling, and finally printing, including notifying the user 🎉
- Reportable event - An event that is deemed of interest to a management station watching the printer 👀
- Status - Information about the current operating state of the printer and its various sub-units. It's an abstraction of the exact physical condition of the printer 🚦
- Sub-mechanism - A distinguishable part of a sub-unit 🔧
- Sub-unit - A part of the printer that may be a physical part, like one of the input sources, or a logical part, like an interpreter 🧚
- Tray - An input sub-unit that is typically removable 🍓
- Unary Change Event - An event that indicates a change of state of the printer, but to a state that is (often) just as valid as the state that was left, and from which no return is necessary. See binary change event 🦋
- Visible state - The portion of the state of the printer that a management application can examine 🔍
- Warning - A non-critical alert. See non-critical alert ⚠️
Appendix B - Media Size Names 🌸
okay so this one is all about media size names 📏 The PWG Standardized Media Names specification [PWGMEDIA], section 5 Self Describing Names, has the currently recommended media size names. This appendix lists the standardized media size names from ISO/IEC 10175 Document Printing Application (DPA), [ISO10175], as presented in RFC 1759. Management applications are encouraged to use the names from the PWG standard. However, lots of legacy systems use the DPA names, so they're presented here for the convenience of developers 🫶
A printer implementing the Printer MIB has no knowledge of these names, though. All media sizes in the MIB are given in terms of media dimensions as the values of prtInputMediaDimFeedDirChosen and prtInputMediaDimXFeedDirChosen 🧠
String name Description
other
unknown
na-letter or letter North American letter size: 8.5 by 11 inches
na-legal or legal North American legal size: 8.5 by 14 inches
na-10x13-envelope North American 10x13 envelope
size: 10 by 13 inches
na-9x12-envelope North American 9x12 envelope
size: 9 by 12 inches
na-number-10-envelope North American number 10 business envelope
size: 4.125 by 9.5 inches
na-7x9-envelope North American 7x9 size: 7 by 9 inches
na-9x11-envelope North American 9x11 size: 9 by 11 inches
na-10x14-envelope North American 10x14 envelope
size: 10 by 14 inches
na-number-9-envelope North American number 9 business envelope
size: 3.875 by 8.875 inches
na-6x9-envelope North American 6x9 envelope
size: 6 by 9 inches
na-10x15-envelope North American 10x15 envelope
size: 10 by 15 inches
a engineering A size 8.5 inches by 11 inches
b engineering B size 11 inches by 17 inches
c engineering C size 17 inches by 22 inches
d engineering D size 22 inches by 34 inches
e engineering E size 34 inches by 44 inches
iso-a0 ISO A0 size: 841 mm by 1189 mm
iso-a1 ISO A1 size: 594 mm by 841 mm
iso-a2 ISO A2 size: 420 mm by 594 mm
iso-a3 ISO A3 size: 297 mm by 420 mm
iso-a4 ISO A4 size: 210 mm by 297 mm
iso-a5 ISO A5 size: 148 mm by 210 mm
iso-a6 ISO A6 size: 105 mm by 148 mm
iso-a7 ISO A7 size: 74 mm by 105 mm
iso-a8 ISO A8 size: 52 mm by 74 mm
iso-a9 ISO A9 size: 37 mm by 52 mm
iso-a10 ISO A10 size: 26 mm by 37 mm
iso-b0 ISO B0 size: 1000 mm by 1414 mm
iso-b1 ISO B1 size: 707 mm by 1000 mm
iso-b2 ISO B2 size: 500 mm by 707 mm
iso-b3 ISO B3 size: 353 mm by 500 mm
iso-b4 ISO B4 size: 250 mm by 353 mm
iso-b5 ISO B5 size: 176 mm by 250 mm
iso-b6 ISO B6 size: 125 mm by 176 mm
iso-b7 ISO B7 size: 88 mm by 125 mm
iso-b8 ISO B8 size: 62 mm by 88 mm
iso-b9 ISO B9 size: 44 mm by 62 mm
iso-b10 ISO B10 size: 31 mm by 44 mm
iso-c0 ISO C0 size: 917 mm by 1297 mm
iso-c1 ISO C1 size: 648 mm by 917 mm
iso-c2 ISO C2 size: 458 mm by 648 mm
iso-c3 ISO C3 size: 324 mm by 458 mm
iso-c4 ISO C4 size: 229 mm by 324 mm
iso-c5 ISO C5 size: 162 mm by 229 mm
iso-c6 ISO C6 size: 114 mm by 162 mm
iso-c7 ISO C7 size: 81 mm by 114 mm
iso-c8 ISO C8 size: 57 mm by 81 mm
iso-designated ISO Designated Long
size: 110 mm by 220 mm
jis-b0 JIS B0 size 1030 mm by 1456 mm
jis-b1 JIS B1 size 728 mm by 1030 mm
jis-b2 JIS B2 size 515 mm by 728 mm
jis-b3 JIS B3 size 364 mm by 515 mm
jis-b4 JIS B4 size 257 mm by 364 mm
jis-b5 JIS B5 size 182 mm by 257 mm
jis-b6 JIS B6 size 128 mm by 182 mm
jis-b7 JIS B7 size 91 mm by 128 mm
jis-b8 JIS B8 size 64 mm by 91 mm
jis-b9 JIS B9 size 45 mm by 64 mm
jis-b10 JIS B10 size 32 mm by 45 mmAppendix C - Media Names ✨
Hey device-wrangling devs 💻🎀, this appendix is your cheat sheet! It lists the standardized media names from ISO/IEC 10175 Document Printing Application (DPA), [ISO10175]. If your management app shows a dialogue for picking media, you may wish to use these names instead of separately specifying size, color, and/or type. You can even make brand-new names using this format plus the names in the PWG Standardized Media Names specification [PWGMEDIA] 🌈.
Using standard media names is iconic for consistency 💅. A single management application handling printers from different vendors and under different system managers will tend to use the same names for the same media, so everyone's on the same page 📄✨.
Heads up: if you select media by name, the size, type, or color implied by that name must be explicitly mapped to the right objects in the MIB:prtInputMediaDimFeedDirDeclared,prtInputMediaDimXFeedDirDeclared,prtInputMediaType, andprtInputMediaColor. The name alone won't do it for you 🙈.
Also, prtInputMediaName is just for showing to an operator. It's purely descriptive 🦋. The printer doesn't interpret that value, so picking a standard name won't change any of the other media attributes, and it won't trigger an alert if the media in the input sub-unit doesn't match the name. Main character energy for the label, zero side effects 💜.
Here's the first batch of standard names, with the ones for "other" and "unknown" up top 🌸:
Simple Name Descriptor Text
other
unknown
iso-a4-white Specifies the ISO A4 white medium with
size: 210 mm by 297 mm as defined in ISO 216
iso-a4-coloured Specifies the ISO A4 colored medium with
size: 210 mm by 297 mm as defined in ISO 216
iso-a4-transparent Specifies the ISO A4 transparent medium with
size: 210 mm by 297 mm as defined in ISO 216
iso-a3-white Specifies the ISO A3 white medium with
size: 297 mm by 420 mm as defined in ISO 216
iso-a3-coloured Specifies the ISO A3 colored medium with
size: 297 mm by 420 mm as defined in ISO 216
iso-a5-white Specifies the ISO A5 white medium with
size: 148 mm by 210 mm as defined in ISO 216
iso-a5-coloured Specifies the ISO A5 colored medium with
size: 148 mm by 210 mm as defined in ISO 216
iso-b4-white Specifies the ISO B4 white medium with
size: 250 mm by 353 mm as defined in ISO 216
iso-b4-coloured Specifies the ISO B4 colored medium with
size: 250 mm by 353 mm as defined in ISO 216
iso-b5-white Specifies the ISO B5 white medium with
size: 176 mm by 250 mm as defined in ISO 216
iso-b5-coloured Specifies the ISO B5 colored medium with
size: 176 mm by 250 mm as defined in ISO 216
jis-b4-white Specifies the JIS B4 white medium with
size: 257 mm by 364 mm as defined in JIS P0138
jis-b4-coloured Specifies the JIS B4 colored medium with
size: 257 mm by 364 mm as defined in JIS P0138
jis-b5-white Specifies the JIS B5 white medium with
size: 182 mm by 257 mm as defined in JIS P0138
jis-b5-coloured Specifies the JIS B5 colored medium with
size: 182 mm by 257 mm as defined in JIS P0138Next up, the North American crew 🇺🇸🦅. The following standard values are defined for North American media:
na-letter-white Specifies the North American letter white
medium with size: 8.5 inches by 11 inches
na-letter-coloured Specifies the North American letter colored
medium with size: 8.5 inches by 11 inches
na-letter-transparent
Specifies the North American letter
transparent medium with size: 8.5 inches
by 11 inches
na-legal-white Specifies the North American legal white
medium with size: 8.5 inches by 14 inches
na-legal-coloured Specifies the North American legal colored
medium with size: 8.5 inches by 14 inchesNow for the envelopes ✉️💖. The following standard values are defined for envelopes:
iso-b5-envelope Specifies the ISO B5 envelope medium
with size: 176 mm by 250 mm
as defined in ISO 216 and ISO 269
iso-b4-envelope Specifies the ISO B4 envelope medium
with size: 250 mm by 353 mm
as defined in ISO 216
iso-c4-envelope Specifies the ISO C4 envelope medium
with size: 229 mm by 324 mm
as defined in ISO 216 and ISO 269
iso-c5-envelope Specifies the ISO C5 envelope medium
with size: 162 mm by 229 mm
as defined in ISO 269
iso-designated-long-envelope
Specifies the ISO Designated Long envelope
medium with size: 110 mm by 220 mm
as defined in ISO 269
na-10x13-envelope Specifies the North American 10x13 envelope
medium with size: 10 inches by 13 inches
na-9x12-envelope Specifies the North American 9x12 envelope
medium with size: 9 inches by 12 inches
na-number-10-envelope
Specifies the North American number 10
business envelope medium with size: 4.125
inches by 9.5 inches
na-7x9-envelope Specifies the North American 7x9 inch envelope
na-9x11-envelope Specifies the North American 9x11 inch envelope
na-10x14-envelope Specifies the North American 10x14 inch envelope
na-number-9-envelope
Specifies the North American number 9
business envelope 3.875 by 8.875 inches
na-6x9-envelope Specifies the North American 6x9 inch envelope
na-10x15-envelope Specifies the North American 10x15 inch envelopeLast but not least, the less commonly used media 🧚. These standard values are defined for the less commonly used media, and they're white-only ⭐:
iso-a0-white Specifies the ISO A0 white medium
with size: 841 mm by 1189 mm
as defined in ISO 216
iso-a1-white Specifies the ISO A1 white medium
with size: 594 mm by 841 mm
as defined in ISO 216
iso-a2-white Specifies the ISO A2 white medium
with size: 420 mm by 594 mm
as defined in ISO 216
iso-a6-white Specifies the ISO A6 white medium
with size: 105 mm by 148 mm
as defined in ISO 216
iso-a7-white Specifies the ISO A7 white medium
with size: 74 mm by 105 mm
as defined in ISO 216
iso-a8-white Specifies the ISO A8 white medium
with size: 52 mm by 74 mm
as defined in ISO 216
iso-a9-white Specifies the ISO A9 white medium
with size: 39 mm by 52 mm
as defined in ISO 216
iso-a10-white Specifies the ISO A10 white medium
with size: 26 mm by 37 mm
as defined in ISO 216
iso-b0-white Specifies the ISO B0 white medium
with size: 1000 mm by 1414 mm
as defined in ISO 216
iso-b1-white Specifies the ISO B1 white medium
with size: 707 mm by 1000 mm
as defined in ISO 216
iso-b2-white Specifies the ISO B2 white medium
with size: 500 mm by 707 mm
as defined in ISO 216
iso-b3-white Specifies the ISO B3 white medium
with size: 353 mm by 500 mm
as defined in ISO 216
iso-b6-white Specifies the ISO B6 white medium
with size: 125 mm by 176 mm i
as defined in ISO 216
iso-b7-white Specifies the ISO B7 white medium
with size: 88 mm by 125 mm
as defined in ISO 216
iso-b8-white Specifies the ISO B8 white medium
with size: 62 mm by 88 mm
as defined in ISO 216
iso-b9-white Specifies the ISO B9 white medium
with size: 44 mm by 62 mm
as defined in ISO 216
iso-b10-white Specifies the ISO B10 white medium
with size: 31 mm by 44 mm
as defined in ISO 216
jis-b0-white Specifies the JIS B0 white medium with size:
1030 mm by 1456 mm
jis-b1-white Specifies the JIS B1 white medium with size:
728 mm by 1030 mm
jis-b2-white Specifies the JIS B2 white medium with size:
515 mm by 728 mm
jis-b3-white Specifies the JIS B3 white medium with size:
364 mm by 515 mm
jis-b6-white Specifies the JIS B6 white medium with size:
257 mm by 364 mm
jis-b7-white Specifies the JIS B7 white medium with size:
182 mm by 257 mm
jis-b8-white Specifies the JIS B8 white medium with size:
128 mm by 182 mm
jis-b9-white Specifies the JIS B9 white medium with size:
91 mm by 128 mm
jis-b10-white Specifies the JIS B10 white medium with size:
64 mm by 91 mmAnd finally, the engineering media 📐🫶. The following standard values are defined for engineering media:
a Specifies the engineering A size medium with
size: 8.5 inches by 11 inches
b Specifies the engineering B size medium with
size: 11 inches by 17 inches
c Specifies the engineering C size medium with
size: 17 inches by 22 inches
d Specifies the engineering D size medium with
size: 22 inches by 34 inches
e Specifies the engineering E size medium with
size: 34 inches by 44 inchesAppendix D - Roles of Users 🎀
Background
okay so the whole reason "Role Models" exist is that people kept arguing about whether a proposed object was actually needed for the MIB 🙈 Every time, the debate ended with someone describing how a "live" person would use the object while printing something. 💅
That happened so often that the group needed a more formal model for it, so it could be analyzed consistently. The model that sorts human-oriented tasks into categories is called "Role Models" in this document. ✨
To build the Role Models, the group first had to figure out the common, primary tasks that humans usually deal with when they work with a printer and its related printing system(s). The idea was that certain kinds of tasks would help identify each Role Model. 🧚
The section goes in order: first the "Common Print System Tasks," then the Role Model definitions, and last a simple matrix that cross-compares Role Models and Tasks. 🦋
Common Print System Tasks
After researching all the tasks humans run into with printers and printing systems, these were found to be pervasive in any operating environment: 🌸
- Printer job state - Determine the status of a job without a printer.
- Printer capabilities - Determine the current capabilities of a printer, for example, the available media sizes, two-sided printing, a particular type of interpreter, etc.
- Printer job submission - Submit a print job to a printer.
- Printer job removal - Remove a job from a printer.
- Notification of events - Receive notification of the existence of a defined printer event. An event can be of many types, including warnings, errors, job stage completion (e.g., "job done"), etc.
- Printer configuration - Query the current configuration of a printer.
- Printer consumables - Determine the current state of any and all consumables within a printer.
- Print job identification - Determine the identification of a job within a printer.
- Internal printer status - Determine the current status of the printer.
- Printer identification - Determine the identity of a printer.
- Printer location - Determine the physical location of a printer.
- Local system configuration - Determine various aspects of the current configuration of the local system involved with the operation of a printer.
These "tasks" cover a large spectrum of requirements for operating a printer in a network environment. This list is the basis for defining the Role Models below. 💜
Proposed Role Models
Here's the list of "Role Models" used to evaluate the requirements for any given Printer MIB object. The keyword in parentheses is the abbreviation for each Role Model in the matrix later in this document. 🫶
- User (
USER) - A person or application that submits print jobs to the printer; typically viewed as the "end user" within the overall printing environment. - Operator (
OP) - A person responsible for maintaining a printer on a day-to-day basis, including such tasks as filling empty media trays, emptying full output trays, replacing toner cartridges, clearing simple paper jams, etc. - Technician (
TECH) - A person responsible for repairing a malfunctioning printer, performing routine preventive maintenance, and other tasks that typically require advanced training on the printer internals. An example of a "technician" would be a manufacturer's Field Service representative, or other person formally trained by the manufacturer or similar representative. - System Manager (
MGR) - A person responsible for configuration and troubleshooting of components involved in the overall printing environment, including printers, print queues and network connectivity issues. This person is typically responsible for ensuring the overall operational integrity of the print system components, and is typically viewed as the central point of coordination among all other Role Models. 👑 - Help Desk (
HELP) - A person responsible for supporting Users in their printing needs, including training Users and troubleshooting Users' printing problems. - Asset Manager (
AM) - A person responsible for managing an organization's printing system assets (primarily printers). Such a person needs to be able to identify and track the location of printing assets on an ongoing basis. - Capacity Planner (
CP) - A person responsible for tracking the usage of printing resources on an ongoing basis for the purpose of planning printer acquisitions and/or placement of printers based on usage trends. - Installer (
INST) - A person or application responsible for installing or configuring printing system components on a local system. - Accountant (
ACCT) - A person responsible for tracking the usage of printing resources on an ongoing basis for the purpose of charging Users for resources used.
Matrix of Common Print System Tasks and Role Models
Now for the matrix that shows how the "Common Print System Tasks" and the "Role Models" connect. 🌈
Lots of tasks will look like they apply to many Role Models. But when you think about the actual context of a task, the Role Model can change, and that's the important part. 💅
For example, it's obvious that a "System Manager" must be able to submit print jobs to a printer. But when a System Manager submits a print job, they're operating in the context of a "User", so job submission isn't listed as a requirement for System Manager. 🙈
On the flip side, a "User" must be able to remove a job they previously submitted, while an "Operator" is often expected to remove any print job from any printer. So print job removal is a (subtly different) requirement for both the "User" and "Operator" Role Models. ✨
Role Models
-----------
Requirement Area USER OP TECH MGR HELP AM CP INST ACCT
Print job status xx xx xx xx xx
Printer capabilities xx xx xx
Print job submission xx
Print job removal xx xx
Notification of events xx xx
Printer configuration xx xx
Printer consumables xx xx xx
Print job identification xx xx xx xx xx
Internal printer status xx xx xx
Printer identification xx xx xx xx xx xx xx
Printer location xx
Local system configuration xx xxAppendix E - Overall Printer Status Table 🦋
The Status Table sets up a convention for the top 25 printer errors. ✨ It suggests how various printer states relate to the variables hrDeviceStatus, hrPrinterStatus, hrPrinterDetectedErrorState, prtAlertGroup, prtAlertCode, and the sub-unit status variables (prtInputStatus, prtOutputStatus, prtMarkerStatus, prtMediaPathStatus and prtChannelStatus). 💜
This table is the recommended implementation of these variables. It's there to guide implementors of this MIB and users of the MIB by giving a sample set of states and the variable values that are expected to result from each state. It supplements the information in Section 2.2.13.2 "Overall Printer Status". It is not an exhaustive list, just a guideline. 🌸
The definition of PrtSubUnitStatusTC says that SubUnitStatus is an integer that is the sum of 5 distinct values/states: Availability, Critical, Non-Critical, On-line and Transitioning. So when non-critical alert(s) are present, the values for Availability, On-Line and Transitioning get summed with the Non-Critical Alerts (8) value. 🧮
The table was generated in landscape format and lives at ftp://ftp.pwg.org/pub/pwg/pmp/contributions/Top25Errors.pdf. 🍓
Appendix F - Participants 🌈
The Printer MIB Working Group wants to give a huge thank you to the following individuals, who put in serious effort reviewing this document and giving tons of suggestions for improvement. 🫶
- David Harrington - Enterasys Networks
- Juergen Schoenwaelder - TU Braunschweig
- Bert Wijnen - Lucent Technologies and IETF Op & Mngmt, Area Director
This version of the Printer MIB would not exist without the earlier work that became RFC 1759. The authors of Printer MIB version 2 want to acknowledge the following people for developing the base for this document. Steve Waldbusser also gets special recognition for providing major technical guidance on the architecture of the Printer MIB. 👑
- Joel Gyllenskog - Microworks
- Tom Hastings - Xerox
- Jay Martin - Underscore, Inc.
- Ron Smith - Texas Instruments
- Steve Waldbusser - Lucent Technologies
- Don Wright - Lexmark
- Steve Zilles - Adobe
The following people attended at least one meeting of the Printer MIB Working Group for version 2. Many of them went to most meetings. 🎀
- Ron Bergman - Hitachi Printing Solutions
- Luis Cubero - Hewlett-Packard
- Jay Cummings - Novell
- Andy Davidson - Tektronix
- Lee Farrell - Canon
- Tom Hastings - Xerox
- Scott Isaacson - Novell
- Binnur Al-Kazily - Hewlett-Packard
- Rick Landau - Digital Equipment Corporation
- David Kellerman - Northlake Software
- Harry Lewis - IBM
- Pete Loya - Hewlett-Packard
- Jay Martin - Underscore, Inc.
- Bob Pentecost - Hewlett-Packard
- Dave Roach - Unisys
- Stuart Rowley - Kyocera
- Bob Setterbo - Adobe
- Mike Timperman - Lexmark
- Randy Turner - 2Wire, Inc.
- Bill Wagner - NETsilicon, Inc.
- Chris Wellens - Interworking Labs
- Craig Whittle - Sharp Labs
- Don Wright - Lexmark
- Lloyd Young - Lexmark
- Atsushi Yuki - Kyocera
- Steve Zilles - Adobe
Significant Contributors ✨
okay bestie, this is the squad 🫶 these are the people who really showed up for this doc, so I'm giving them the spotlight they deserve 👑
Ray Casterline Lighthouse Solutions, LLC Phone: (716) 218-9910 EMail: RayCasterline@lhsolutions.com
Gary Gocek Phone: (585) 223-3826 EMail: gary@gocek.org
Thomas N. Hastings Xerox Corporation Phone: (310) 333-6413 EMail: hastings@cp10.es.xerox.com
Scott Isaacson Novell Phone: (801) 861-7366 EMail: sisaacson@novell.com
Binnur Al-Kazily Hewlett-Packard, Inc. Phone: (208) 396-6372 EMail: binnur_al-kazily@hp.com
David Kellerman Northlake Software Phone: (503) 228-3383 EMail: kellerman@nls.com
Matt King Lexmark International Phone: (859) 232-6907 EMail: emking@lexmark.com
Jay Martin Underscore, Inc. Phone: (603) 889-7000 EMail: jkm@underscore.com
Mike McKay Novell, Inc.
Bob Pentecost Hewlett-Packard Phone: (208) 396-3312 EMail: bpenteco@boi.hp.com
Stuart Rowley Kyocera Phone: (510) 299-7206 EMail: stuart.rowley@kyocera.com
Gail Songer Peerless Systems Networking Phone: (650) 569-4414 EMail: gsonger@peerless.com
Randy Turner 2Wire, Inc. Phone (408) 895-1216 EMail: rturner@2wire.com
William Wagner NETsilicon, Inc. Phone: (781) 398-4588 EMail: WWagner@NetSilicon.com
Chris Wellens Interworking Labs Phone: (408) 685-3190 EMail: chrisw@iwl.com
F.D. Wright Lexmark International Phone: (859) 232-4808 EMail: don@lexmark.com
Lloyd Young Lexmark International Phone: (859) 232-5150 EMail: lpyoung@lexmark.com
Stephen N. Zilles Adobe Systems, Inc. Phone: (415) 962-4766 EMail: szilles@adobe.com
Authors' Addresses 💌
and now the people who actually wrote the thing and are, honestly, the reason this exists 🧚
Ron Bergman (Chairman) Hitachi Printing Solutions America 2635 Park Center Drive Simi Valley, CA 93065-6209 Phone: (805) 578-4421 EMail: Ron.Bergman@hitachi-ps.us
Harry Lewis IBM 6300 Diagonal Hwy. Boulder, CO 80301 Phone (303) 924-5337 EMail: harryl@us.ibm.com
Ira McDonald High North Inc P.O. Box 221 Grand Marais, MI 49839 Phone: (906) 494-2434 or (906) 494-2697 EMail: imcdonald@sharplabs.com
Full Copyright Statement 🔐
okay, the legal bit, but make it quick 💅
Copyright (C) The Internet Society (2004). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.
This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property 🦋
the IETF is staying neutral on the rights stuff here, so no promises from them 🙈
The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org.
Acknowledgement 🌈
one last shoutout 🎀
Funding for the RFC Editor function is currently provided by the Internet Society. 💜
📦 where this page comes from
- ietf: rfc3805 2004-06
- 💖 girlified by claude-haiku-5-5 on : a language model's rewrite of the original, under its terms