/* packet-isis-hello.c * Routines for decoding isis hello packets and their CLVs * * $Id: packet-isis-hello.c,v 1.10 2000/08/13 14:08:19 deniel Exp $ * Stuart Stanley * * Ethereal - Network traffic analyzer * By Gerald Combs * 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 #endif #include #include #include #include "packet.h" #include "packet-osi.h" #include "packet-isis.h" #include "packet-isis-clv.h" #include "packet-isis-hello.h" /* hello packets */ static int proto_isis_hello = -1; static int hf_isis_hello_circuit_reserved = -1; static int hf_isis_hello_source_id = -1; static int hf_isis_hello_holding_timer = -1; static int hf_isis_hello_pdu_length = -1; static int hf_isis_hello_priority_reserved = -1; static int hf_isis_hello_lan_id = -1; static int hf_isis_hello_local_circuit_id = -1; static int hf_isis_hello_clv_ipv4_int_addr = -1; static gint ett_isis_hello = -1; static gint ett_isis_hello_clv_area_addr = -1; static gint ett_isis_hello_clv_is_neighbors = -1; static gint ett_isis_hello_clv_padding = -1; static gint ett_isis_hello_clv_unknown = -1; static gint ett_isis_hello_clv_nlpid = -1; static gint ett_isis_hello_clv_auth = -1; static gint ett_isis_hello_clv_ipv4_int_addr = -1; static const value_string isis_hello_circuit_type_vals[] = { { ISIS_HELLO_TYPE_RESERVED, "Reserved 0 (discard PDU)"}, { ISIS_HELLO_TYPE_LEVEL_1, "Level 1 only"}, { ISIS_HELLO_TYPE_LEVEL_2, "Level 2 only"}, { ISIS_HELLO_TYPE_LEVEL_12, "Level 1 and 2"}, { 0, NULL} }; /* * Predclare dissectors for use in clv dissection. */ static void dissect_hello_area_address_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree); static void dissect_hello_is_neighbors_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree); static void dissect_hello_padding_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree); static void dissect_hello_nlpid_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree); static void dissect_hello_ip_int_addr_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree); static void dissect_hello_auth_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree); static const isis_clv_handle_t clv_l1_hello_opts[] = { { ISIS_CLV_L1H_AREA_ADDRESS, "Area address(es)", &ett_isis_hello_clv_area_addr, dissect_hello_area_address_clv }, { ISIS_CLV_L1H_IS_NEIGHBORS, "IS Neighbor(s)", &ett_isis_hello_clv_is_neighbors, dissect_hello_is_neighbors_clv }, { ISIS_CLV_L1H_PADDING, "Padding", &ett_isis_hello_clv_padding, dissect_hello_padding_clv }, { ISIS_CLV_L1H_NLPID, "NLPID", &ett_isis_hello_clv_nlpid, dissect_hello_nlpid_clv }, { ISIS_CLV_L1H_IP_INTERFACE_ADDR, "IP Interface address(es)", &ett_isis_hello_clv_ipv4_int_addr, dissect_hello_ip_int_addr_clv }, { ISIS_CLV_L1H_AUTHENTICATION_NS, "Authentication(non spec)", &ett_isis_hello_clv_auth, dissect_hello_auth_clv }, { ISIS_CLV_L1H_AUTHENTICATION, "Authentication", &ett_isis_hello_clv_auth, dissect_hello_auth_clv }, { 0, "", NULL, NULL } }; static const isis_clv_handle_t clv_l2_hello_opts[] = { { ISIS_CLV_L2H_AREA_ADDRESS, "Area address(es)", &ett_isis_hello_clv_area_addr, dissect_hello_area_address_clv }, { ISIS_CLV_L2H_IS_NEIGHBORS, "IS Neighbor(s)", &ett_isis_hello_clv_is_neighbors, dissect_hello_is_neighbors_clv }, { ISIS_CLV_L2H_PADDING, "Padding", &ett_isis_hello_clv_padding, dissect_hello_padding_clv }, { ISIS_CLV_L2H_NLPID, "NLPID", &ett_isis_hello_clv_nlpid, dissect_hello_nlpid_clv }, { ISIS_CLV_L2H_IP_INTERFACE_ADDR, "IP Interface address(es)", &ett_isis_hello_clv_ipv4_int_addr, dissect_hello_ip_int_addr_clv }, { ISIS_CLV_L2H_AUTHENTICATION_NS, "Authentication(non spec)", &ett_isis_hello_clv_auth, dissect_hello_auth_clv }, { ISIS_CLV_L2H_AUTHENTICATION, "Authentication", &ett_isis_hello_clv_auth, dissect_hello_auth_clv }, { 0, "", NULL, NULL } }; static const isis_clv_handle_t clv_ptp_hello_opts[] = { { ISIS_CLV_PTP_AREA_ADDRESS, "Area address(es)", &ett_isis_hello_clv_area_addr, dissect_hello_area_address_clv }, { ISIS_CLV_PTP_PADDING, "Padding", &ett_isis_hello_clv_padding, dissect_hello_padding_clv }, { ISIS_CLV_PTP_NLPID, "NLPID", &ett_isis_hello_clv_nlpid, dissect_hello_nlpid_clv }, { ISIS_CLV_PTP_IP_INTERFACE_ADDR, "IP Interface address(es)", &ett_isis_hello_clv_ipv4_int_addr, dissect_hello_ip_int_addr_clv }, { ISIS_CLV_PTP_AUTHENTICATION_NS, "Authentication(non spec)", &ett_isis_hello_clv_auth, dissect_hello_auth_clv }, { ISIS_CLV_PTP_AUTHENTICATION, "Authentication", &ett_isis_hello_clv_auth, dissect_hello_auth_clv }, { 0, "", NULL, NULL } }; /* * Name: dissect_hello_nlpid_clv() * * Description: * Decode for a hello packets NLPID clv. Calls into the * clv common one. * * Input: * u_char * : packet data * int : current offset into packet data * guint : length of this clv * int : length of IDs in packet. * frame_data * : frame data * proto_tree * : proto tree to build on (may be null) * * Output: * void, will modify proto_tree if not null. */ static void dissect_hello_nlpid_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree) { isis_dissect_nlpid_clv(pd, offset, length, fd, tree ); } /* * Name: dissect_hello_ip_int_addr_clv() * * Description: * Decode for a hello packets ip interface addr clv. Calls into the * clv common one. * * Input: * u_char * : packet data * int : current offset into packet data * guint : length of this clv * int : length of IDs in packet. * frame_data * : frame data * proto_tree * : proto tree to build on (may be null) * * Output: * void, will modify proto_tree if not null. */ static void dissect_hello_ip_int_addr_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree) { isis_dissect_ip_int_clv(pd, offset, length, fd, tree, hf_isis_hello_clv_ipv4_int_addr ); } /* * Name: dissect_hello_auth_clv() * * Description: * Decode for a hello packets authenticaion clv. Calls into the * clv common one. An auth inside a hello packet is a perlink * password. * * Input: * u_char * : packet data * int : current offset into packet data * guint : length of this clv * int : length of IDs in packet. * frame_data * : frame data * proto_tree * : proto tree to build on (may be null) * * Output: * void, will modify proto_tree if not null. */ static void dissect_hello_auth_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree) { isis_dissect_authentication_clv(pd, offset, length, fd, tree, "Per Link authentication" ); } /* * Name: dissect_hello_area_address_clv() * * Description: * Decode for a hello packets area address clv. Calls into the * clv common one. * * Input: * u_char * : packet data * int : current offset into packet data * guint : length of this clv * int : length of IDs in packet. * frame_data * : frame data * proto_tree * : proto tree to build on (may be null) * * Output: * void, will modify proto_tree if not null. */ static void dissect_hello_area_address_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree) { isis_dissect_area_address_clv(pd, offset, length, fd, tree ); } /* * Name: isis_dissect_is_neighbors_clv() * * Description: * Take apart a IS neighbor packet. A neighbor is n 6 byte packets. * (they tend to be an 802.3 MAC address, but its not required). * * Input: * u_char * : packet data * int : offset into packet data where we are. * guint : length of clv we are decoding * int : length of IDs in packet. * frame_data * : frame data (complete frame) * proto_tree * : protocol display tree to fill out. May be NULL * gint : tree id to use for proto tree. * * Output: * void, but we will add to proto tree if !NULL. */ void dissect_hello_is_neighbors_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree ) { while ( length > 0 ) { if (length<6) { isis_dissect_unknown(offset, length, tree, fd, "short is neighbor (%d vs 6)", length ); return; } /* * Lets turn the area address into "standard" 0000.0000.etc * format string. */ if ( tree ) { proto_tree_add_text ( tree, NullTVB, offset, 6, "IS Neighbor: %s", print_system_id( pd + offset, 6 ) ); } offset += 6; length -= 6; } } /* * Name: dissect_hello_padding_clv() * * Description: * Decode for a hello packet's padding clv. Padding does nothing, * so we just return. * * Input: * u_char * : packet data * int : current offset into packet data * guint : length of this clv * int : length of IDs in packet. * frame_data * : frame data * proto_tree * : proto tree to build on (may be null) * * Output: * void */ static void dissect_hello_padding_clv(const u_char *pd, int offset, guint length, int id_length, frame_data *fd, proto_tree *tree) { /* nothing to do here! */ } /* * Name: isis_dissect_isis_hello() * * Description: * This procedure rips apart the various types of ISIS hellos. L1H and * L2H's are identical for the most part, while the PTP hello has * a shorter header. * * Input: * int : hello type, a la packet-isis.h ISIS_TYPE_* values * int : header length of packet. * int : length of IDs in packet. * u_char * : packet data * int offset : our offset into packet data. * frame_data * : frame data * proto_tree * : protocol display tree to add to. May be NULL. * * Output: * void, will modify proto_tree if not NULL. */ void isis_dissect_isis_hello(int hello_type, int header_length, int id_length, const u_char *pd, int offset, frame_data *fd, proto_tree *tree){ proto_item *ti; proto_tree *hello_tree = NULL; int len; int hlen; guint16 pdu_length; OLD_CHECK_DISPLAY_AS_DATA(proto_isis_hello, pd, offset, fd, tree); if (hello_type == ISIS_TYPE_PTP_HELLO) { hlen = 1+id_length+2+2+1; } else { hlen = 1+id_length+2+2+1+id_length+1; } if (!BYTES_ARE_IN_FRAME(offset, hlen)) { isis_dissect_unknown(offset, hlen, tree, fd, "not enough capture data for header (%d vs %d)", hlen, END_OF_FRAME); return; } if (tree) { ti = proto_tree_add_item(tree, proto_isis_hello, NullTVB, offset, END_OF_FRAME, FALSE); hello_tree = proto_item_add_subtree(ti, ett_isis_hello); proto_tree_add_uint_format(hello_tree, hf_isis_hello_circuit_reserved, NullTVB, offset, 1, pd[offset], "Circuit type : %s, reserved(0x%02x == 0)", val_to_str(pd[offset]&ISIS_HELLO_CTYPE_MASK, isis_hello_circuit_type_vals, "Unknown (0x%x)"), pd[offset]&ISIS_HELLO_CT_RESERVED_MASK ); } offset += 1; if (tree) { proto_tree_add_bytes_format(hello_tree, hf_isis_hello_source_id, NullTVB, offset, id_length, &pd[offset], "SystemID{ Sender of PDU } : %s", print_system_id( pd + offset, id_length ) ); } offset += id_length; if (tree) { proto_tree_add_uint(hello_tree, hf_isis_hello_holding_timer, NullTVB, offset, 2, pntohs(&pd[offset])); } offset += 2; pdu_length = pntohs(&pd[offset]); if (tree) { proto_tree_add_uint(hello_tree, hf_isis_hello_pdu_length, NullTVB, offset, 2, pdu_length); } offset += 2; if (tree) { proto_tree_add_uint_format(hello_tree, hf_isis_hello_priority_reserved, NullTVB, offset, 1, pd[offset], "Priority : %d, reserved(0x%02x == 0)", pd[offset]&ISIS_HELLO_PRIORITY_MASK, pd[offset]&ISIS_HELLO_P_RESERVED_MASK ); } offset += 1; if (hello_type == ISIS_TYPE_PTP_HELLO) { if (tree) { proto_tree_add_uint(hello_tree, hf_isis_hello_local_circuit_id, NullTVB, offset, 1, pd[offset] ); } offset += 1; } else { if (tree) { proto_tree_add_bytes_format(hello_tree, hf_isis_hello_lan_id, NullTVB, offset, id_length + 1, &pd[offset], "SystemID{ Designated IS } : %s", print_system_id( pd + offset, id_length + 1 ) ); } offset += id_length + 1; } len = pdu_length; len -= header_length; if (len < 0) { isis_dissect_unknown(offset, header_length, tree, fd, "packet header length %d went beyond packet", header_length ); return; } /* * Now, we need to decode our CLVs. We need to pass in * our list of valid ones! */ if (hello_type == ISIS_TYPE_L1_HELLO){ isis_dissect_clvs ( clv_l1_hello_opts, len, id_length, pd, offset, fd, hello_tree, ett_isis_hello_clv_unknown ); } else if (hello_type == ISIS_TYPE_L2_HELLO) { isis_dissect_clvs ( clv_l2_hello_opts, len, id_length, pd, offset, fd, hello_tree, ett_isis_hello_clv_unknown ); } else { isis_dissect_clvs ( clv_ptp_hello_opts, len, id_length, pd, offset, fd, hello_tree, ett_isis_hello_clv_unknown ); } } /* * Name: proto_register_isis_hello() * * Description: * Register our protocol sub-sets with protocol manager. * NOTE: this procedure is autolinked by the makefile process that * builds register.c * * Input: * void * * Output: * void */ void proto_register_isis_hello(void) { static hf_register_info hf[] = { { &hf_isis_hello_circuit_reserved, { "Circuit type ", "isis_hello.circuite_type", FT_UINT8, BASE_HEX, NULL, 0x0, "" }}, { &hf_isis_hello_source_id, { "SystemID{ Sender of PDU } ", "isis_hello.source_id", FT_BYTES, BASE_HEX, NULL, 0x0, "" }}, { &hf_isis_hello_holding_timer, { "Holding timer ", "isis_hello.holding_timer", FT_UINT16, BASE_DEC, NULL, 0x0, "" }}, { &hf_isis_hello_pdu_length, { "PDU length ", "isis_hello.pdu_length", FT_UINT16, BASE_DEC, NULL, 0x0, "" }}, { &hf_isis_hello_priority_reserved, { "Priority ", "isis_hello.priority", FT_UINT8, BASE_DEC, NULL, ISIS_HELLO_P_RESERVED_MASK, "" }}, { &hf_isis_hello_lan_id, { "SystemID{ Designated IS } ", "isis_hello.lan_id", FT_BYTES, BASE_DEC, NULL, 0x0, "" }}, { &hf_isis_hello_local_circuit_id, { "Local circuit ID ", "isis_hello.local_circuit_id", FT_UINT8, BASE_DEC, NULL, 0x0, "" }}, { &hf_isis_hello_clv_ipv4_int_addr, { "IPv4 interface address ", "isis_hello.clv_ipv4_int_addr", FT_IPv4, BASE_NONE, NULL, 0x0, "" }}, }; static gint *ett[] = { &ett_isis_hello, &ett_isis_hello_clv_area_addr, &ett_isis_hello_clv_is_neighbors, &ett_isis_hello_clv_padding, &ett_isis_hello_clv_unknown, &ett_isis_hello_clv_nlpid, &ett_isis_hello_clv_auth, &ett_isis_hello_clv_ipv4_int_addr, }; proto_isis_hello = proto_register_protocol("ISIS HELLO", "isis_hello"); proto_register_field_array(proto_isis_hello, hf, array_length(hf)); proto_register_subtree_array(ett, array_length(ett)); }