2 * Routines for IPP packet disassembly
4 * Guy Harris <guy@alum.mit.edu>
6 * $Id: packet-ipp.c,v 1.30 2002/03/31 22:12:45 guy Exp $
8 * Ethereal - Network traffic analyzer
9 * By Gerald Combs <gerald@ethereal.com>
10 * Copyright 1998 Gerald Combs
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version 2
15 * of the License, or (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
31 #ifdef HAVE_SYS_TYPES_H
32 #include <sys/types.h>
39 #include <epan/packet.h>
40 #include <epan/strutil.h>
41 #include "packet-http.h"
43 static int proto_ipp = -1;
45 static gint ett_ipp = -1;
46 static gint ett_ipp_as = -1;
47 static gint ett_ipp_attr = -1;
49 static dissector_handle_t data_handle;
51 #define PRINT_JOB 0x0002
52 #define PRINT_URI 0x0003
53 #define VALIDATE_JOB 0x0004
54 #define CREATE_JOB 0x0005
55 #define SEND_DOCUMENT 0x0006
56 #define SEND_URI 0x0007
57 #define CANCEL_JOB 0x0008
58 #define GET_JOB_ATTRIBUTES 0x0009
59 #define GET_JOBS 0x000A
60 #define GET_PRINTER_ATTRIBUTES 0x000B
62 static const value_string operation_vals[] = {
63 { PRINT_JOB, "Print-Job" },
64 { PRINT_URI, "Print-URI" },
65 { VALIDATE_JOB, "Validate-Job" },
66 { CREATE_JOB, "Create-Job" },
67 { SEND_DOCUMENT, "Send-Document" },
68 { SEND_URI, "Send-URI" },
69 { CANCEL_JOB, "Cancel-Job" },
70 { GET_JOB_ATTRIBUTES, "Get-Job-Attributes" },
71 { GET_JOBS, "Get-Jobs" },
72 { GET_PRINTER_ATTRIBUTES, "Get-Printer-Attributes" },
76 #define STATUS_SUCCESSFUL 0x0000
77 #define STATUS_INFORMATIONAL 0x0100
78 #define STATUS_REDIRECTION 0x0200
79 #define STATUS_CLIENT_ERROR 0x0400
80 #define STATUS_SERVER_ERROR 0x0500
82 #define STATUS_TYPE_MASK 0xFF00
84 #define SUCCESSFUL_OK 0x0000
85 #define SUCCESSFUL_OK_IGN_OR_SUB_ATTR 0x0001
86 #define SUCCESSFUL_OK_CONFLICTING_ATTR 0x0002
88 #define CLIENT_ERROR_BAD_REQUEST 0x0400
89 #define CLIENT_ERROR_FORBIDDEN 0x0401
90 #define CLIENT_ERROR_NOT_AUTHENTICATED 0x0402
91 #define CLIENT_ERROR_NOT_AUTHORIZED 0x0403
92 #define CLIENT_ERROR_NOT_POSSIBLE 0x0404
93 #define CLIENT_ERROR_TIMEOUT 0x0405
94 #define CLIENT_ERROR_NOT_FOUND 0x0406
95 #define CLIENT_ERROR_GONE 0x0407
96 #define CLIENT_ERROR_REQ_ENTITY_TOO_LRG 0x0408
97 #define CLIENT_ERROR_REQ_VALUE_TOO_LONG 0x0409
98 #define CLIENT_ERROR_DOC_FMT_NOT_SUPP 0x040A
99 #define CLIENT_ERROR_ATTR_OR_VAL_NOT_SUPP 0x040B
100 #define CLIENT_ERROR_URI_SCHEME_NOT_SUPP 0x040C
101 #define CLIENT_ERROR_CHARSET_NOT_SUPP 0x040D
102 #define CLIENT_ERROR_CONFLICTING_ATTRS 0x040E
104 #define SERVER_ERROR_INTERNAL_ERROR 0x0500
105 #define SERVER_ERROR_OPERATION_NOT_SUPP 0x0501
106 #define SERVER_ERROR_SERVICE_UNAVAIL 0x0502
107 #define SERVER_ERROR_VERSION_NOT_SUPP 0x0503
108 #define SERVER_ERROR_DEVICE_ERROR 0x0504
109 #define SERVER_ERROR_TEMPORARY_ERROR 0x0505
110 #define SERVER_ERROR_NOT_ACCEPTING_JOBS 0x0506
111 #define SERVER_ERROR_BUSY 0x0507
112 #define SERVER_ERROR_JOB_CANCELED 0x0508
114 static const value_string status_vals[] = {
115 { SUCCESSFUL_OK, "Successful-OK" },
116 { SUCCESSFUL_OK_IGN_OR_SUB_ATTR, "Successful-OK-Ignored-Or-Substituted-Attributes" },
117 { SUCCESSFUL_OK_CONFLICTING_ATTR, "Successful-OK-Conflicting-Attributes" },
118 { CLIENT_ERROR_BAD_REQUEST, "Client-Error-Bad-Request" },
119 { CLIENT_ERROR_FORBIDDEN, "Client-Error-Forbidden" },
120 { CLIENT_ERROR_NOT_AUTHENTICATED, "Client-Error-Not-Authenticated" },
121 { CLIENT_ERROR_NOT_AUTHORIZED, "Client-Error-Not-Authorized" },
122 { CLIENT_ERROR_NOT_POSSIBLE, "Client-Error-Not-Possible" },
123 { CLIENT_ERROR_TIMEOUT, "Client-Error-Timeout" },
124 { CLIENT_ERROR_NOT_FOUND, "Client-Error-Not-Found" },
125 { CLIENT_ERROR_GONE, "Client-Error-Gone" },
126 { CLIENT_ERROR_REQ_ENTITY_TOO_LRG, "Client-Error-Request-Entity-Too-Large" },
127 { CLIENT_ERROR_REQ_VALUE_TOO_LONG, "Client-Error-Request-Value-Too-Long" },
128 { CLIENT_ERROR_DOC_FMT_NOT_SUPP, "Client-Error-Document-Format-Not-Supported" },
129 { CLIENT_ERROR_ATTR_OR_VAL_NOT_SUPP, "Client-Error-Attributes-Or-Values-Not-Supported" },
130 { CLIENT_ERROR_URI_SCHEME_NOT_SUPP, "Client-Error-URI-Scheme-Not-Supported" },
131 { CLIENT_ERROR_CHARSET_NOT_SUPP, "Client-Error-Charset-Not-Supported" },
132 { CLIENT_ERROR_CONFLICTING_ATTRS, "Client-Error-Conflicting-Attributes" },
133 { SERVER_ERROR_INTERNAL_ERROR, "Server-Error-Internal-Error" },
134 { SERVER_ERROR_OPERATION_NOT_SUPP, "Server-Error-Operation-Not-Supported" },
135 { SERVER_ERROR_SERVICE_UNAVAIL, "Server-Error-Service-Unavailable" },
136 { SERVER_ERROR_VERSION_NOT_SUPP, "Server-Error-Version-Not-Supported" },
137 { SERVER_ERROR_DEVICE_ERROR, "Server-Error-Device-Error" },
138 { SERVER_ERROR_TEMPORARY_ERROR, "Server-Error-Temporary-Error" },
139 { SERVER_ERROR_NOT_ACCEPTING_JOBS, "Server-Error-Not-Accepting-Jobs" },
140 { SERVER_ERROR_BUSY, "Server-Error-Busy" },
141 { SERVER_ERROR_JOB_CANCELED, "Server-Error-Job-Canceled" },
145 static int parse_attributes(tvbuff_t *tvb, int offset, proto_tree *tree);
146 static proto_tree *add_integer_tree(proto_tree *tree, tvbuff_t *tvb,
147 int offset, int name_length, int value_length);
148 static void add_integer_value(gchar *tag_desc, proto_tree *tree,
149 tvbuff_t *tvb, int offset, int name_length, int value_length);
150 static proto_tree *add_octetstring_tree(proto_tree *tree, tvbuff_t *tvb,
151 int offset, int name_length, int value_length);
152 static void add_octetstring_value(gchar *tag_desc, proto_tree *tree,
153 tvbuff_t *tvb, int offset, int name_length, int value_length);
154 static proto_tree *add_charstring_tree(proto_tree *tree, tvbuff_t *tvb,
155 int offset, int name_length, int value_length);
156 static void add_charstring_value(gchar *tag_desc, proto_tree *tree,
157 tvbuff_t *tvb, int offset, int name_length, int value_length);
158 static int add_value_head(gchar *tag_desc, proto_tree *tree, tvbuff_t *tvb,
159 int offset, int name_length, int value_length);
162 dissect_ipp(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
164 proto_tree *ipp_tree;
167 gboolean is_request = (pinfo->destport == 631);
171 if (check_col(pinfo->cinfo, COL_PROTOCOL))
172 col_set_str(pinfo->cinfo, COL_PROTOCOL, "IPP");
173 if (check_col(pinfo->cinfo, COL_INFO)) {
175 col_set_str(pinfo->cinfo, COL_INFO, "IPP request");
177 col_set_str(pinfo->cinfo, COL_INFO, "IPP response");
181 ti = proto_tree_add_item(tree, proto_ipp, tvb, offset, -1,
183 ipp_tree = proto_item_add_subtree(ti, ett_ipp);
185 proto_tree_add_text(ipp_tree, tvb, offset, 2, "Version: %u.%u",
186 tvb_get_guint8(tvb, offset),
187 tvb_get_guint8(tvb, offset + 1));
191 proto_tree_add_text(ipp_tree, tvb, offset, 2, "Operation-id: %s",
192 val_to_str(tvb_get_ntohs(tvb, offset), operation_vals,
193 "Unknown (0x%04x)"));
195 status_code = tvb_get_ntohs(tvb, offset);
196 switch (status_code & STATUS_TYPE_MASK) {
198 case STATUS_SUCCESSFUL:
199 status_fmt = "Successful (0x%04x)";
202 case STATUS_INFORMATIONAL:
203 status_fmt = "Informational (0x%04x)";
206 case STATUS_REDIRECTION:
207 status_fmt = "Redirection (0x%04x)";
210 case STATUS_CLIENT_ERROR:
211 status_fmt = "Client error (0x%04x)";
214 case STATUS_SERVER_ERROR:
215 status_fmt = "Server error (0x%04x)";
219 status_fmt = "Unknown (0x%04x)";
222 proto_tree_add_text(ipp_tree, tvb, offset, 2, "Status-code: %s",
223 val_to_str(status_code, status_vals, status_fmt));
227 proto_tree_add_text(ipp_tree, tvb, offset, 4, "Request ID: %u",
228 tvb_get_ntohl(tvb, offset));
231 offset = parse_attributes(tvb, offset, ipp_tree);
233 if (tvb_offset_exists(tvb, offset))
234 call_dissector(data_handle,tvb_new_subset(tvb, offset,-1,tvb_reported_length_remaining(tvb,offset)), pinfo, ipp_tree);
238 #define TAG_TYPE(tag) ((tag) & 0xF0)
239 #define TAG_TYPE_DELIMITER 0x00
240 #define TAG_TYPE_INTEGER 0x20
241 #define TAG_TYPE_OCTETSTRING 0x30
242 #define TAG_TYPE_CHARSTRING 0x40
244 #define TAG_END_OF_ATTRIBUTES 0x03
246 #define TAG_INTEGER 0x21
247 #define TAG_BOOLEAN 0x22
248 #define TAG_ENUM 0x23
250 #define TAG_OCTETSTRING 0x30
251 #define TAG_DATETIME 0x31
252 #define TAG_RESOLUTION 0x32
253 #define TAG_RANGEOFINTEGER 0x33
254 #define TAG_TEXTWITHLANGUAGE 0x35
255 #define TAG_NAMEWITHLANGUAGE 0x36
257 #define TAG_TEXTWITHOUTLANGUAGE 0x41
258 #define TAG_NAMEWITHOUTLANGUAGE 0x42
259 #define TAG_KEYWORD 0x44
261 #define TAG_URISCHEME 0x46
262 #define TAG_CHARSET 0x47
263 #define TAG_NATURALLANGUAGE 0x48
264 #define TAG_MIMEMEDIATYPE 0x49
266 static const value_string tag_vals[] = {
268 { 0x01, "Operation attributes" },
269 { 0x02, "Job attributes" },
270 { TAG_END_OF_ATTRIBUTES, "End of attributes" },
271 { 0x04, "Printer attributes" },
272 { 0x05, "Unsupported attributes" },
275 { 0x10, "Unsupported" },
277 { 0x13, "No value" },
278 { TAG_INTEGER, "Integer" },
279 { TAG_BOOLEAN, "Boolean" },
280 { TAG_ENUM, "Enum" },
281 { TAG_OCTETSTRING, "Octet string" },
282 { TAG_DATETIME, "Date/Time" },
283 { TAG_RESOLUTION, "Resolution" },
284 { TAG_RANGEOFINTEGER, "Range of integer" },
285 { TAG_TEXTWITHLANGUAGE, "Text with language" },
286 { TAG_NAMEWITHLANGUAGE, "Name with language" },
287 { TAG_TEXTWITHOUTLANGUAGE, "Text without language" },
288 { TAG_NAMEWITHOUTLANGUAGE, "Name without language" },
289 { TAG_KEYWORD, "Keyword" },
291 { TAG_URISCHEME, "URI scheme" },
292 { TAG_CHARSET, "Character set" },
293 { TAG_NATURALLANGUAGE, "Natural language" },
294 { TAG_MIMEMEDIATYPE, "MIME media type" },
299 parse_attributes(tvbuff_t *tvb, int offset, proto_tree *tree)
303 int name_length, value_length;
304 proto_tree *as_tree = tree;
305 proto_item *tas = NULL;
306 int start_offset = offset;
307 proto_tree *attr_tree = tree;
309 while (tvb_offset_exists(tvb, offset)) {
310 tag = tvb_get_guint8(tvb, offset);
311 tag_desc = val_to_str(tag, tag_vals, "Reserved (0x%02x)");
312 if (TAG_TYPE(tag) == TAG_TYPE_DELIMITER) {
314 * If we had an attribute sequence we were
315 * working on, we're done with it; set its
316 * length to the length of all the stuff
320 proto_item_set_len(tas, offset - start_offset);
323 * This tag starts a new attribute sequence;
324 * create a new tree under this tag when we see
325 * a non-delimiter tag, under which to put
332 * Remember the offset at which this attribute
333 * sequence started, so we can use it to compute
334 * its length when it's finished.
336 start_offset = offset;
339 * Now create a new item for this tag.
341 tas = proto_tree_add_text(tree, tvb, offset, 1,
344 if (tag == TAG_END_OF_ATTRIBUTES) {
346 * No more attributes.
352 * Value tag - get the name length.
354 name_length = tvb_get_ntohs(tvb, offset + 1);
357 * OK, get the value length.
359 value_length = tvb_get_ntohs(tvb, offset + 1 + 2 + name_length);
362 * OK, does the value run past the end of the
365 if (as_tree == NULL) {
367 * OK, there's an attribute to hang
368 * under a delimiter tag, but we don't
369 * have a tree for that tag yet; create
372 as_tree = proto_item_add_subtree(tas,
377 switch (TAG_TYPE(tag)) {
379 case TAG_TYPE_INTEGER:
380 if (name_length != 0) {
382 * This is an attribute, not
383 * an additional value, so
384 * start a tree for it.
386 attr_tree = add_integer_tree(as_tree,
387 tvb, offset, name_length,
390 add_integer_value(tag_desc, attr_tree, tvb,
391 offset, name_length, value_length);
394 case TAG_TYPE_OCTETSTRING:
395 if (name_length != 0) {
397 * This is an attribute, not
398 * an additional value, so
399 * start a tree for it.
401 attr_tree = add_octetstring_tree(as_tree,
402 tvb, offset, name_length,
405 add_octetstring_value(tag_desc, attr_tree, tvb,
406 offset, name_length, value_length);
409 case TAG_TYPE_CHARSTRING:
410 if (name_length != 0) {
412 * This is an attribute, not
413 * an additional value, so
414 * start a tree for it.
416 attr_tree = add_charstring_tree(as_tree,
417 tvb, offset, name_length,
420 add_charstring_value(tag_desc, attr_tree, tvb,
421 offset, name_length, value_length);
424 offset += 1 + 2 + name_length + 2 + value_length;
432 add_integer_tree(proto_tree *tree, tvbuff_t *tvb, int offset,
433 int name_length, int value_length)
437 if (value_length != 4) {
438 ti = proto_tree_add_text(tree, tvb, offset,
439 1 + 2 + name_length + 2 + value_length,
440 "%.*s: Invalid integer (length is %u, should be 4)",
442 tvb_get_ptr(tvb, offset + 1 + 2, name_length),
445 ti = proto_tree_add_text(tree, tvb, offset,
446 1 + 2 + name_length + 2 + value_length,
449 tvb_get_ptr(tvb, offset + 1 + 2, name_length),
450 tvb_get_ntohl(tvb, offset + 1 + 2 + name_length + 2));
452 return proto_item_add_subtree(ti, ett_ipp_attr);
456 add_integer_value(gchar *tag_desc, proto_tree *tree, tvbuff_t *tvb,
457 int offset, int name_length, int value_length)
459 offset = add_value_head(tag_desc, tree, tvb, offset, name_length,
461 if (value_length == 4) {
462 proto_tree_add_text(tree, tvb, offset, value_length,
463 "Value: %u", tvb_get_ntohl(tvb, offset));
468 add_octetstring_tree(proto_tree *tree, tvbuff_t *tvb, int offset,
469 int name_length, int value_length)
473 ti = proto_tree_add_text(tree, tvb, offset,
474 1 + 2 + name_length + 2 + value_length,
477 tvb_get_ptr(tvb, offset + 1 + 2, name_length),
478 tvb_bytes_to_str(tvb, offset + 1 + 2 + name_length + 2, value_length));
479 return proto_item_add_subtree(ti, ett_ipp_attr);
483 add_octetstring_value(gchar *tag_desc, proto_tree *tree, tvbuff_t *tvb,
484 int offset, int name_length, int value_length)
486 offset = add_value_head(tag_desc, tree, tvb, offset, name_length,
488 proto_tree_add_text(tree, tvb, offset, value_length,
489 "Value: %s", tvb_bytes_to_str(tvb, offset, value_length));
493 add_charstring_tree(proto_tree *tree, tvbuff_t *tvb, int offset,
494 int name_length, int value_length)
498 ti = proto_tree_add_text(tree, tvb, offset,
499 1 + 2 + name_length + 2 + value_length,
502 tvb_get_ptr(tvb, offset + 1 + 2, name_length),
504 tvb_get_ptr(tvb, offset + 1 + 2 + name_length + 2, value_length));
505 return proto_item_add_subtree(ti, ett_ipp_attr);
509 add_charstring_value(gchar *tag_desc, proto_tree *tree, tvbuff_t *tvb,
510 int offset, int name_length, int value_length)
512 offset = add_value_head(tag_desc, tree, tvb, offset, name_length,
514 proto_tree_add_text(tree, tvb, offset, value_length,
515 "Value: %.*s", value_length, tvb_get_ptr(tvb, offset, value_length));
519 add_value_head(gchar *tag_desc, proto_tree *tree, tvbuff_t *tvb, int offset,
520 int name_length, int value_length)
522 proto_tree_add_text(tree, tvb, offset, 1, "Tag: %s", tag_desc);
524 proto_tree_add_text(tree, tvb, offset, 2, "Name length: %u",
527 if (name_length != 0) {
528 proto_tree_add_text(tree, tvb, offset, name_length,
529 "Name: %.*s", name_length,
530 tvb_get_ptr(tvb, offset, name_length));
532 offset += name_length;
533 proto_tree_add_text(tree, tvb, offset, 2, "Value length: %u",
540 proto_register_ipp(void)
542 /* static hf_register_info hf[] = {
544 { "Name", "ipp.abbreviation", TYPE, VALS_POINTER }},
546 static gint *ett[] = {
552 proto_ipp = proto_register_protocol("Internet Printing Protocol",
554 /* proto_register_field_array(proto_ipp, hf, array_length(hf));*/
555 proto_register_subtree_array(ett, array_length(ett));
559 proto_reg_handoff_ipp(void)
561 dissector_handle_t ipp_handle;
564 * Register ourselves as running atop HTTP and using port 631.
566 ipp_handle = create_dissector_handle(dissect_ipp, proto_ipp);
567 http_dissector_add(631, ipp_handle);
568 data_handle = find_dissector("data");