1999-10-17 11:40:14 +00:00
|
|
|
/* packet-lpd.c
|
1998-09-16 02:39:15 +00:00
|
|
|
* Routines for LPR and LPRng packet disassembly
|
2000-01-22 06:22:44 +00:00
|
|
|
* Gilbert Ramirez <gram@xiexie.org>
|
1998-09-16 02:39:15 +00:00
|
|
|
*
|
Add the "Edit:Protocols..." feature which currently only implements
the following:
It is now possible to enable/disable a particular protocol decoding
(i.e. the protocol dissector is void or not). When a protocol
is disabled, it is displayed as Data and of course, all linked
sub-protocols are disabled as well.
Disabling a protocol could be interesting:
- in case of buggy dissectors
- in case of wrong heuristics
- for performance reasons
- to decode the data as another protocol (TODO)
Currently (if I am not wrong), all dissectors but NFS can be disabled
(and dissectors that do not register protocols :-)
I do not like the way the RPC sub-dissectors are disabled (in the
sub-dissectors) since this could be done in the RPC dissector itself,
knowing the sub-protocol hfinfo entry (this is why, I've not modified
the NFS one yet).
Two functions are added in proto.c :
gboolean proto_is_protocol_enabled(int n);
void proto_set_decoding(int n, gboolean enabled);
and two MACROs which can be used in dissectors:
OLD_CHECK_DISPLAY_AS_DATA(index, pd, offset, fd, tree)
CHECK_DISPLAY_AS_DATA(index, tvb, pinfo, tree)
See also the XXX in proto_dlg.c and proto.c around the new functions.
svn path=/trunk/; revision=2267
2000-08-13 14:09:15 +00:00
|
|
|
* $Id: packet-lpd.c,v 1.22 2000/08/13 14:08:27 deniel Exp $
|
1998-09-16 03:22:19 +00:00
|
|
|
*
|
1998-09-16 02:39:15 +00:00
|
|
|
* Ethereal - Network traffic analyzer
|
2000-01-07 22:05:43 +00:00
|
|
|
* By Gerald Combs <gerald@zing.org>
|
1998-09-16 02:39:15 +00:00
|
|
|
* Copyright 1998 Gerald Combs
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU General Public License
|
|
|
|
* as published by the Free Software Foundation; either version 2
|
|
|
|
* of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
|
|
# include "config.h"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef HAVE_SYS_TYPES_H
|
|
|
|
# include <sys/types.h>
|
|
|
|
#endif
|
|
|
|
|
1999-03-23 03:14:46 +00:00
|
|
|
#include <string.h>
|
1998-09-16 02:39:15 +00:00
|
|
|
|
1999-03-23 03:14:46 +00:00
|
|
|
#include <glib.h>
|
1998-09-27 22:12:47 +00:00
|
|
|
#include "packet.h"
|
1998-09-16 02:39:15 +00:00
|
|
|
|
2000-04-08 07:07:42 +00:00
|
|
|
#define TCP_PORT_PRINTER 515
|
|
|
|
|
1999-10-17 11:40:14 +00:00
|
|
|
static int proto_lpd = -1;
|
|
|
|
static int hf_lpd_response = -1;
|
|
|
|
static int hf_lpd_request = -1;
|
|
|
|
|
1999-11-16 11:44:20 +00:00
|
|
|
static gint ett_lpd = -1;
|
|
|
|
|
1999-12-15 23:47:30 +00:00
|
|
|
enum lpr_type { request, response, unknown };
|
|
|
|
|
|
|
|
static char* find_printer_string(const u_char *pd, int offset, int frame_length);
|
1998-09-16 02:39:15 +00:00
|
|
|
|
2000-04-08 07:07:42 +00:00
|
|
|
static void
|
1999-03-23 03:14:46 +00:00
|
|
|
dissect_lpd(const u_char *pd, int offset, frame_data *fd, proto_tree *tree)
|
1998-09-16 02:39:15 +00:00
|
|
|
{
|
1999-03-23 03:14:46 +00:00
|
|
|
proto_tree *lpd_tree;
|
|
|
|
proto_item *ti;
|
1998-09-16 02:39:15 +00:00
|
|
|
enum lpr_type lpr_packet_type;
|
1999-12-15 23:47:30 +00:00
|
|
|
char *printer;
|
1998-09-16 02:39:15 +00:00
|
|
|
|
|
|
|
/* This information comes from the LPRng HOWTO, which also describes
|
|
|
|
RFC 1179. http://www.astart.com/lprng/LPRng-HOWTO.html */
|
|
|
|
char *lpd_client_code[] = {
|
|
|
|
"Unknown command",
|
2000-04-20 15:24:41 +00:00
|
|
|
"LPC: start print / jobcmd: abort",
|
|
|
|
"LPR: transfer a printer job / jobcmd: receive control file",
|
|
|
|
"LPQ: print short form of queue status / jobcmd: receive data file",
|
1998-09-16 02:39:15 +00:00
|
|
|
"LPQ: print long form of queue status",
|
|
|
|
"LPRM: remove jobs",
|
|
|
|
"LPRng lpc: do control operation",
|
|
|
|
"LPRng lpr: transfer a block format print job",
|
|
|
|
"LPRng lpc: secure command transfer",
|
|
|
|
"LPRng lpq: verbose status information"
|
|
|
|
};
|
|
|
|
char *lpd_server_code[] = {
|
|
|
|
"Success: accepted, proceed",
|
|
|
|
"Queue not accepting jobs",
|
|
|
|
"Queue temporarily full, retry later",
|
|
|
|
"Bad job format, do not retry"
|
|
|
|
};
|
|
|
|
|
Add the "Edit:Protocols..." feature which currently only implements
the following:
It is now possible to enable/disable a particular protocol decoding
(i.e. the protocol dissector is void or not). When a protocol
is disabled, it is displayed as Data and of course, all linked
sub-protocols are disabled as well.
Disabling a protocol could be interesting:
- in case of buggy dissectors
- in case of wrong heuristics
- for performance reasons
- to decode the data as another protocol (TODO)
Currently (if I am not wrong), all dissectors but NFS can be disabled
(and dissectors that do not register protocols :-)
I do not like the way the RPC sub-dissectors are disabled (in the
sub-dissectors) since this could be done in the RPC dissector itself,
knowing the sub-protocol hfinfo entry (this is why, I've not modified
the NFS one yet).
Two functions are added in proto.c :
gboolean proto_is_protocol_enabled(int n);
void proto_set_decoding(int n, gboolean enabled);
and two MACROs which can be used in dissectors:
OLD_CHECK_DISPLAY_AS_DATA(index, pd, offset, fd, tree)
CHECK_DISPLAY_AS_DATA(index, tvb, pinfo, tree)
See also the XXX in proto_dlg.c and proto.c around the new functions.
svn path=/trunk/; revision=2267
2000-08-13 14:09:15 +00:00
|
|
|
OLD_CHECK_DISPLAY_AS_DATA(proto_lpd, pd, offset, fd, tree);
|
|
|
|
|
2000-04-20 15:24:41 +00:00
|
|
|
/* rfc1179 states that all responses are 1 byte long */
|
|
|
|
if (END_OF_FRAME == 1) {
|
1998-09-16 02:39:15 +00:00
|
|
|
lpr_packet_type = response;
|
|
|
|
}
|
|
|
|
else if (pd[offset] <= 9) {
|
|
|
|
lpr_packet_type = request;
|
|
|
|
}
|
|
|
|
else {
|
1999-12-15 23:47:30 +00:00
|
|
|
lpr_packet_type = unknown;
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
|
|
|
|
1998-11-17 04:29:13 +00:00
|
|
|
if (check_col(fd, COL_PROTOCOL))
|
|
|
|
col_add_str(fd, COL_PROTOCOL, "LPD");
|
|
|
|
if (check_col(fd, COL_INFO)) {
|
1998-09-16 02:39:15 +00:00
|
|
|
if (lpr_packet_type == request) {
|
1998-11-17 04:29:13 +00:00
|
|
|
col_add_str(fd, COL_INFO, lpd_client_code[pd[offset]]);
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
1999-12-15 23:47:30 +00:00
|
|
|
else if (lpr_packet_type == response) {
|
1998-11-17 04:29:13 +00:00
|
|
|
col_add_str(fd, COL_INFO, "LPD response");
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
1999-12-15 23:47:30 +00:00
|
|
|
else {
|
|
|
|
col_add_str(fd, COL_INFO, "LPD continuation");
|
|
|
|
}
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if (tree) {
|
2000-05-11 08:18:09 +00:00
|
|
|
ti = proto_tree_add_item(tree, proto_lpd, NullTVB, offset,
|
2000-05-31 05:09:07 +00:00
|
|
|
END_OF_FRAME, FALSE);
|
1999-11-16 11:44:20 +00:00
|
|
|
lpd_tree = proto_item_add_subtree(ti, ett_lpd);
|
1998-09-16 02:39:15 +00:00
|
|
|
|
1999-10-17 11:40:14 +00:00
|
|
|
if (lpr_packet_type == response) {
|
2000-05-31 05:09:07 +00:00
|
|
|
proto_tree_add_boolean_hidden(lpd_tree, hf_lpd_response, NullTVB, 0, 0, TRUE);
|
1999-10-17 11:40:14 +00:00
|
|
|
} else {
|
2000-05-31 05:09:07 +00:00
|
|
|
proto_tree_add_boolean_hidden(lpd_tree, hf_lpd_request, NullTVB, 0, 0, TRUE);
|
1999-10-17 11:40:14 +00:00
|
|
|
}
|
|
|
|
|
1998-09-16 02:39:15 +00:00
|
|
|
if (lpr_packet_type == request) {
|
1999-12-15 23:47:30 +00:00
|
|
|
printer = find_printer_string(pd, offset+1, END_OF_FRAME);
|
|
|
|
|
|
|
|
if (pd[offset] <= 9 && printer) {
|
2000-05-11 08:18:09 +00:00
|
|
|
proto_tree_add_text(lpd_tree, NullTVB, offset, 1,
|
1998-09-16 02:39:15 +00:00
|
|
|
lpd_client_code[pd[offset]]);
|
2000-05-11 08:18:09 +00:00
|
|
|
proto_tree_add_text(lpd_tree, NullTVB, offset+1,
|
1999-12-15 23:47:30 +00:00
|
|
|
strlen(printer), "Printer/options: %s", printer);
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
|
|
|
else {
|
Allow either old-style (pre-tvbuff) or new-style (tvbuffified)
dissectors to be registered as dissectors for particular ports,
registered as heuristic dissectors, and registered as dissectors for
conversations, and have routines to be used both by old-style and
new-style dissectors to call registered dissectors.
Have the code that calls those dissectors translate the arguments as
necessary. (For conversation dissectors, replace
"find_conversation_dissector()", which just returns a pointer to the
dissector, with "old_try_conversation_dissector()" and
"try_conversation_dissector()", which actually call the dissector, so
that there's a single place at which we can do that translation. Also
make "dissector_lookup()" static and, instead of calling it and, if it
returns a non-null pointer, calling that dissector, just use
"old_dissector_try_port()" or "dissector_try_port()", for the same
reason.)
This allows some dissectors that took old-style arguments and
immediately translated them to new-style arguments to just take
new-style arguments; make them do so. It also allows some new-style
dissectors not to have to translate arguments before calling routines to
look up and call dissectors; make them not do so.
Get rid of checks for too-short frames in new-style dissectors - the
tvbuff code does those checks for you.
Give the routines to register old-style dissectors, and to call
dissectors from old-style dissectors, names beginning with "old_", with
the routines for new-style dissectors not having the "old_". Update the
dissectors that use those routines appropriately.
Rename "dissect_data()" to "old_dissect_data()", and
"dissect_data_tvb()" to "dissect_data()".
svn path=/trunk/; revision=2218
2000-08-07 03:21:25 +00:00
|
|
|
old_dissect_data(pd, offset, fd, tree);
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
|
|
|
|
1999-12-15 23:47:30 +00:00
|
|
|
if (printer)
|
|
|
|
g_free(printer);
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
1999-12-15 23:47:30 +00:00
|
|
|
else if (lpr_packet_type == response) {
|
|
|
|
int response = pd[offset];
|
|
|
|
|
|
|
|
if (response <= 3) {
|
2000-05-11 08:18:09 +00:00
|
|
|
proto_tree_add_text(lpd_tree, NullTVB, offset, 1, "Response: %s",
|
1999-12-15 23:47:30 +00:00
|
|
|
lpd_server_code[response]);
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
|
|
|
else {
|
Allow either old-style (pre-tvbuff) or new-style (tvbuffified)
dissectors to be registered as dissectors for particular ports,
registered as heuristic dissectors, and registered as dissectors for
conversations, and have routines to be used both by old-style and
new-style dissectors to call registered dissectors.
Have the code that calls those dissectors translate the arguments as
necessary. (For conversation dissectors, replace
"find_conversation_dissector()", which just returns a pointer to the
dissector, with "old_try_conversation_dissector()" and
"try_conversation_dissector()", which actually call the dissector, so
that there's a single place at which we can do that translation. Also
make "dissector_lookup()" static and, instead of calling it and, if it
returns a non-null pointer, calling that dissector, just use
"old_dissector_try_port()" or "dissector_try_port()", for the same
reason.)
This allows some dissectors that took old-style arguments and
immediately translated them to new-style arguments to just take
new-style arguments; make them do so. It also allows some new-style
dissectors not to have to translate arguments before calling routines to
look up and call dissectors; make them not do so.
Get rid of checks for too-short frames in new-style dissectors - the
tvbuff code does those checks for you.
Give the routines to register old-style dissectors, and to call
dissectors from old-style dissectors, names beginning with "old_", with
the routines for new-style dissectors not having the "old_". Update the
dissectors that use those routines appropriately.
Rename "dissect_data()" to "old_dissect_data()", and
"dissect_data_tvb()" to "dissect_data()".
svn path=/trunk/; revision=2218
2000-08-07 03:21:25 +00:00
|
|
|
old_dissect_data(pd, offset, fd, tree);
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
|
|
|
}
|
1999-12-15 23:47:30 +00:00
|
|
|
else {
|
Allow either old-style (pre-tvbuff) or new-style (tvbuffified)
dissectors to be registered as dissectors for particular ports,
registered as heuristic dissectors, and registered as dissectors for
conversations, and have routines to be used both by old-style and
new-style dissectors to call registered dissectors.
Have the code that calls those dissectors translate the arguments as
necessary. (For conversation dissectors, replace
"find_conversation_dissector()", which just returns a pointer to the
dissector, with "old_try_conversation_dissector()" and
"try_conversation_dissector()", which actually call the dissector, so
that there's a single place at which we can do that translation. Also
make "dissector_lookup()" static and, instead of calling it and, if it
returns a non-null pointer, calling that dissector, just use
"old_dissector_try_port()" or "dissector_try_port()", for the same
reason.)
This allows some dissectors that took old-style arguments and
immediately translated them to new-style arguments to just take
new-style arguments; make them do so. It also allows some new-style
dissectors not to have to translate arguments before calling routines to
look up and call dissectors; make them not do so.
Get rid of checks for too-short frames in new-style dissectors - the
tvbuff code does those checks for you.
Give the routines to register old-style dissectors, and to call
dissectors from old-style dissectors, names beginning with "old_", with
the routines for new-style dissectors not having the "old_". Update the
dissectors that use those routines appropriately.
Rename "dissect_data()" to "old_dissect_data()", and
"dissect_data_tvb()" to "dissect_data()".
svn path=/trunk/; revision=2218
2000-08-07 03:21:25 +00:00
|
|
|
old_dissect_data(pd, offset, fd, tree);
|
1999-12-15 23:47:30 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
static char*
|
|
|
|
find_printer_string(const u_char *pd, int offset, int frame_length)
|
|
|
|
{
|
|
|
|
int i, final_offset;
|
|
|
|
char c;
|
|
|
|
char *string;
|
|
|
|
int bytes;
|
|
|
|
|
|
|
|
final_offset = offset + frame_length;
|
|
|
|
|
|
|
|
/* try to find end of string, either 0x0a or 0x00 */
|
|
|
|
for (i = offset; i < final_offset; i++) {
|
|
|
|
c = pd[i];
|
|
|
|
if (c == '\x00' || c == '\x0a') {
|
|
|
|
bytes = i - offset;
|
|
|
|
string = g_malloc(bytes+1);
|
|
|
|
memcpy(string, &pd[offset], bytes);
|
|
|
|
string[bytes] = 0;
|
|
|
|
return string;
|
|
|
|
}
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
1999-12-15 23:47:30 +00:00
|
|
|
|
|
|
|
return NULL;
|
1998-09-16 02:39:15 +00:00
|
|
|
}
|
|
|
|
|
1999-12-15 23:47:30 +00:00
|
|
|
|
1999-10-17 11:40:14 +00:00
|
|
|
void
|
|
|
|
proto_register_lpd(void)
|
|
|
|
{
|
|
|
|
static hf_register_info hf[] = {
|
|
|
|
{ &hf_lpd_response,
|
|
|
|
{ "Response", "lpd.response",
|
|
|
|
FT_BOOLEAN, BASE_NONE, NULL, 0x0,
|
|
|
|
"TRUE if LPD response" }},
|
|
|
|
|
|
|
|
{ &hf_lpd_request,
|
|
|
|
{ "Request", "lpd.request",
|
|
|
|
FT_BOOLEAN, BASE_NONE, NULL, 0x0,
|
|
|
|
"TRUE if LPD request" }}
|
|
|
|
};
|
1999-11-16 11:44:20 +00:00
|
|
|
static gint *ett[] = {
|
|
|
|
&ett_lpd,
|
|
|
|
};
|
1999-10-17 11:40:14 +00:00
|
|
|
|
|
|
|
proto_lpd = proto_register_protocol("Line Printer Daemon Protocol", "lpd");
|
|
|
|
proto_register_field_array(proto_lpd, hf, array_length(hf));
|
1999-11-16 11:44:20 +00:00
|
|
|
proto_register_subtree_array(ett, array_length(ett));
|
1999-10-17 11:40:14 +00:00
|
|
|
}
|
1999-12-15 23:47:30 +00:00
|
|
|
|
2000-04-08 07:07:42 +00:00
|
|
|
void
|
|
|
|
proto_reg_handoff_lpd(void)
|
|
|
|
{
|
Allow either old-style (pre-tvbuff) or new-style (tvbuffified)
dissectors to be registered as dissectors for particular ports,
registered as heuristic dissectors, and registered as dissectors for
conversations, and have routines to be used both by old-style and
new-style dissectors to call registered dissectors.
Have the code that calls those dissectors translate the arguments as
necessary. (For conversation dissectors, replace
"find_conversation_dissector()", which just returns a pointer to the
dissector, with "old_try_conversation_dissector()" and
"try_conversation_dissector()", which actually call the dissector, so
that there's a single place at which we can do that translation. Also
make "dissector_lookup()" static and, instead of calling it and, if it
returns a non-null pointer, calling that dissector, just use
"old_dissector_try_port()" or "dissector_try_port()", for the same
reason.)
This allows some dissectors that took old-style arguments and
immediately translated them to new-style arguments to just take
new-style arguments; make them do so. It also allows some new-style
dissectors not to have to translate arguments before calling routines to
look up and call dissectors; make them not do so.
Get rid of checks for too-short frames in new-style dissectors - the
tvbuff code does those checks for you.
Give the routines to register old-style dissectors, and to call
dissectors from old-style dissectors, names beginning with "old_", with
the routines for new-style dissectors not having the "old_". Update the
dissectors that use those routines appropriately.
Rename "dissect_data()" to "old_dissect_data()", and
"dissect_data_tvb()" to "dissect_data()".
svn path=/trunk/; revision=2218
2000-08-07 03:21:25 +00:00
|
|
|
old_dissector_add("tcp.port", TCP_PORT_PRINTER, &dissect_lpd);
|
2000-04-08 07:07:42 +00:00
|
|
|
}
|