]> git.ipfire.org Git - thirdparty/suricata.git/commitdiff
util/proto: Protocol-name functions
authorJeff Lucovsky <jeff@lucovsky.org>
Sat, 12 Feb 2022 14:44:13 +0000 (09:44 -0500)
committerJeff Lucovsky <jeff@lucovsky.org>
Fri, 11 Mar 2022 14:03:33 +0000 (09:03 -0500)
Issue: 5072

This commit adds utility functions handling protocol names.

(cherry picked from commit ff0cf89738d7b947a3d7d8d0c6c5dc7adb95e6af)

src/util-proto-name.c
src/util-proto-name.h

index ddc9967cea1593f3ab3db5f4aa5833eefead79ce..3bca99fabf8b8c70bfe159f9c19d09b2318d2dc6 100644 (file)
@@ -1,4 +1,4 @@
-/* Copyright (C) 2007-2021 Open Information Security Foundation
+/* Copyright (C) 2007-2022 Open Information Security Foundation
  *
  * You can copy, redistribute or modify this Program under the terms of
  * the GNU General Public License version 2 as published by the Free
  */
 
 #include "suricata-common.h"
+#include "util-hash-string.h"
 #include "util-proto-name.h"
 
+#ifdef UNITTESTS
+#include "util-unittest.h"
+#endif
+
 /** Lookup array to hold the information related to known protocol
  *  values
  */
@@ -185,6 +190,260 @@ const char *known_proto[256] = {
                   2021-01-31) */
 };
 
+/*
+ * Protocol name aliases
+ */
+const char *proto_aliases[256] = {
+    "ip",      /* 0x00: 0 - IPv6 Hop-by-Hop Option     RFC 8200 */
+    "icmp",    /* 0x01: 1 - Internet Control Message Protocol  RFC 792 */
+    "igmp",    /* 0x02: 2 - Internet Group Management Protocol RFC 1112 */
+    "ggp",     /* 0x03: 3 - Gateway-to-Gateway Protocol        RFC 823 */
+    "ipencap", /* 0x04: 4 - IP in IP (encapsulation)   RFC 2003 */
+    "st",      /* 0x05: 5 - Internet Stream Protocol   RFC 1190, RFC 1819 */
+    "tcp",     /* 0x06: 6 - Transmission Control Protocol      RFC 793 */
+    NULL,      /* 0x07: 7 - Core-based trees   RFC 2189 */
+    "egp",     /* 0x08: 8 - Exterior Gateway Protocol  RFC 888 */
+    "igp", /* 0x09: 9 - Interior Gateway Protocol (any private interior gateway, for example Cisco's
+         IGRP) */
+    NULL,  /* 0x0A: 10 - BBN RCC Monitoring */
+    NULL,  /* 0x0B: 11 - Network Voice Protocol        RFC 741 */
+    "pup", /* 0x0C: 12 - Xerox PUP */
+    NULL,  /* 0x0D: 13 - ARGUS */
+    NULL,  /* 0x0E: 14 - EMCON */
+    NULL,  /* 0x0F: 15 - Cross Net Debugger    IEN 158[2] */
+    NULL,  /* 0x10: 16 - Chaos */
+    "udp", /* 0x11: 17 - User Datagram Protocol        RFC 768 */
+    NULL,  /* 0x12: 18 - Multiplexing  IEN 90[3] */
+    NULL,  /* 0x13: 19 - DCN Measurement Subsystems */
+    "hmp", /* 0x14: 20 - Host Monitoring Protocol      RFC 869 */
+    NULL,  /* 0x15: 21 - Packet Radio Measurement */
+    "xns-idp",    /* 0x16: 22 - XEROX NS IDP */
+    NULL,         /* 0x17: 23 - Trunk-1 */
+    NULL,         /* 0x18: 24 - Trunk-2 */
+    NULL,         /* 0x19: 25 - Leaf-1 */
+    NULL,         /* 0x1A: 26 - Leaf-2 */
+    "rdp",        /* 0x1B: 27 - Reliable Data Protocol RFC 908 */
+    NULL,         /* 0x1C: 28 - Internet Reliable Transaction Protocol RFC 938 */
+    "iso-tp4",    /* 0x1D: 29 - ISO Transport Protocol Class 4 RFC 905 */
+    NULL,         /* 0x1E: 30 - Bulk Data Transfer Protocol    RFC 998 */
+    NULL,         /* 0x1F: 31 - MFE Network Services Protocol */
+    NULL,         /* 0x20: 32 - MERIT Internodal Protocol */
+    "dccp",       /* 0x21: 33 - Datagram Congestion Control Protocol   RFC 4340 */
+    NULL,         /* 0x22: 34 - Third Party Connect Protocol */
+    NULL,         /* 0x23: 35 - Inter-Domain Policy Routing Protocol   RFC 1479 */
+    "xtp",        /* 0x24: 36 - Xpress Transport Protocol */
+    "ddp",        /* 0x25: 37 - Datagram Delivery Protocol */
+    "idpr-cmtp",  /* 0x26: 38 - IDPR Control Message Transport Protocol */
+    NULL,         /* 0x27: 39 - TP++ Transport Protocol */
+    NULL,         /* 0x28: 40 - IL Transport Protocol */
+    "ipV6",       /* 0x29: 41 - IPv6 Encapsulation     RFC 2473 */
+    NULL,         /* 0x2A: 42 - Source Demand Routing Protocol RFC 1940 */
+    "ipv6-route", /* 0x2B: 43 - Routing Header for IPv6        RFC 8200 */
+    "ipv6-frag",  /* 0x2C: 44 - Fragment Header for IPv6       RFC 8200 */
+    "idrp",       /* 0x2D: 45 - Inter-Domain Routing Protocol */
+    "rsvp",       /* 0x2E: 46 - Resource Reservation Protocol  RFC 2205 */
+    "gre",        /* 0x2F: 47 - Generic Routing Encapsulation  RFC 2784, RFC 2890 */
+    NULL,         /* 0x30: 48 - Dynamic Source Routing Protocol        RFC 4728 */
+    NULL,         /* 0x31: 49 - Burroughs Network Architecture */
+    "esp",        /* 0x32: 50 - Encapsulating Security Payload RFC 4303 */
+    "ah",         /* 0x33: 51 - Authentication Header  RFC 4302 */
+    NULL,         /* 0x34: 52 - Integrated Net Layer Security Protocol TUBA */
+    NULL,         /* 0x35: 53 - SwIPe  RFC 5237 */
+    NULL,         /* 0x36: 54 - NBMA Address Resolution Protocol       RFC 1735 */
+    NULL,         /* 0x37: 55 - IP Mobility (Min Encap)        RFC 2004 */
+    NULL,        /* 0x38: 56 - Transport Layer Security Protocol (using Kryptonet key management) */
+    "skip",      /* 0x39: 57 - Simple Key-Management for Internet Protocol     RFC 2356 */
+    "ipv6-icmp", /* 0x3A: 58 - ICMP for IPv6   RFC 4443, RFC 4884 */
+    "ipv6-nonxt", /* 0x3B: 59 - No Next Header for IPv6        RFC 8200 */
+    "ipv6-opts",  /* 0x3C: 60 - Destination Options for IPv6   RFC 8200 */
+    NULL,         /* 0x3D: 61 - host internal protocol */
+    NULL,         /* 0x3E: 62 - CFTP */
+    NULL,         /* 0x3F: 63 - local network */
+    NULL,         /* 0x40: 64 - SATNET and Backroom EXPAK */
+    NULL,         /* 0x41: 65 - Kryptolan */
+    NULL,         /* 0x42: 66 - MIT Remote Virtual Disk Protocol */
+    NULL,         /* 0x43: 67 - Internet Pluribus Packet Core */
+    NULL,         /* 0x44: 68 - distributed file system */
+    NULL,         /* 0x45: 69 - SATNET Monitoring */
+    NULL,         /* 0x46: 70 - VISA Protocol */
+    NULL,         /* 0x47: 71 - Internet Packet Core Utility */
+    NULL,         /* 0x48: 72 - Computer Protocol Network Executive */
+    "cphb",       /* 0x49: 73 - Computer Protocol Heart Beat */
+    NULL,         /* 0x4A: 74 - Wang Span Network */
+    NULL,         /* 0x4B: 75 - Packet Video Protocol */
+    NULL,         /* 0x4C: 76 - Backroom SATNET Monitoring */
+    NULL,         /* 0x4D: 77 - SUN ND PROTOCOL-Temporary */
+    NULL,         /* 0x4E: 78 - WIDEBAND Monitoring */
+    NULL,         /* 0x4F: 79 - WIDEBAND EXPAK */
+    NULL,         /* 0x50: 80 - International Organization for Standardization Internet Protocol */
+    "vmtp",       /* 0x51: 81 - Versatile Message Transaction Protocol RFC 1045 */
+    NULL,         /* 0x52: 82 - Secure Versatile Message Transaction Protocol  RFC 1045 */
+    NULL,         /* 0x53: 83 - VINES */
+    NULL,         /* 0x54: 84 - TTP */
+    NULL,         /* 0x55: 85 - NSFNET-IGP */
+    NULL,         /* 0x56: 86 - Dissimilar Gateway Protocol */
+    NULL,         /* 0x57: 87 - TCF */
+    "eigrp",      /* 0x58: 88 - EIGRP  Informational RFC 7868 */
+    "ospf",       /* 0x59: 89 - Open Shortest Path First       RFC 2328 */
+    NULL,         /* 0x5A: 90 - Sprite RPC Protocol */
+    NULL,         /* 0x5B: 91 - Locus Address Resolution Protocol */
+    NULL,         /* 0x5C: 92 - Multicast Transport Protocol */
+    "ax.25",      /* 0x5D: 93 - AX.25 */
+    "ipip",       /* 0x5E: 94 - KA9Q NOS compatible IP over IP tunneling */
+    NULL,         /* 0x5F: 95 - Mobile Internetworking Control Protocol */
+    NULL,         /* 0x60: 96 - Semaphore Communications Sec. Pro */
+    "etherip",    /* 0x61: 97 - Ethernet-within-IP Encapsulation       RFC 3378 */
+    "encap",      /* 0x62: 98 - Encapsulation Header   RFC 1241 */
+    NULL,         /* 0x63: 99 - private encryption scheme */
+    "GMTP",       /* 0x64: 100 - GMTP */
+    NULL,         /* 0x65: 101 - Ipsilon Flow Management Protocol */
+    NULL,         /* 0x66: 102 - PNNI over IP */
+    "pim",        /* 0x67: 103 - Protocol Independent Multicast */
+    NULL,         /* 0x68: 104 - IBM's ARIS (Aggregate Route IP Switching) Protocol */
+    NULL,         /* 0x69: 105 - SCPS (Space Communications Protocol Standards)        SCPS-TP[4] */
+    NULL,         /* 0x6A: 106 - QNX */
+    NULL,         /* 0x6B: 107 - Active Networks */
+    "ipcomp",     /* 0x6C: 108 - IP Payload Compression Protocol       RFC 3173 */
+    NULL,         /* 0x6D: 109 - Sitara Networks Protocol */
+    NULL,         /* 0x6E: 110 - Compaq Peer Protocol */
+    NULL,         /* 0x6F: 111 - IPX in IP */
+    "vrrp", /* 0x70: 112 - Virtual Router Redundancy Protocol, Common Address Redundancy Protocol
+            (not IANA assigned)        VRRP:RFC 3768 */
+    NULL,   /* 0x71: 113 - PGM Reliable Transport Protocol     RFC 3208 */
+    NULL,   /* 0x72: 114 - 0-hop protocol */
+    "l2tp", /* 0x73: 115 - Layer Two Tunneling Protocol Version 3      RFC 3931 */
+    NULL,   /* 0x74: 116 - D-II Data Exchange (DDX) */
+    NULL,   /* 0x75: 117 - Interactive Agent Transfer Protocol */
+    NULL,   /* 0x76: 118 - Schedule Transfer Protocol */
+    NULL,   /* 0x77: 119 - SpectraLink Radio Protocol */
+    NULL,   /* 0x78: 120 - Universal Transport Interface Protocol */
+    NULL,   /* 0x79: 121 - Simple Message Protocol */
+    NULL,   /* 0x7A: 122 - Simple Multicast Protocol   draft-perlman-simple-multicast-03 */
+    NULL,   /* 0x7B: 123 - Performance Transparency Protocol */
+    "isis", /* 0x7C: 124 - over IPv4   Intermediate System to Intermediate System (IS-IS) Protocol
+            over IPv4  RFC 1142 and RFC 1195 */
+    NULL,   /* 0x7D: 125 - Flexible Intra-AS Routing Environment */
+    NULL,   /* 0x7E: 126 - Combat Radio Transport Protocol */
+    NULL,   /* 0x7F: 127 - Combat Radio User Datagram */
+    NULL,   /* 0x80: 128 - Service-Specific Connection-Oriented Protocol in a Multilink and
+               Connectionless Environment      ITU-T Q.2111 (1999) */
+    NULL,   /* 0x81: 129 -  */
+    NULL,   /* 0x82: 130 - Secure Packet Shield */
+    NULL,   /* 0x83: 131 - Private IP Encapsulation within IP  Expired I-D
+               draft-petri-mobileip-pipe-00.txt */
+    "sctp", /* 0x84: 132 - Stream Control Transmission Protocol        RFC 4960 */
+    "fc",   /* 0x85: 133 - Fibre Channel */
+    NULL,   /* 0x86: 134 - Reservation Protocol (RSVP) End-to-End Ignore       RFC 3175 */
+    "mobility-header", /* 0x87: 135 - Header   Mobility Extension Header for IPv6      RFC 6275 */
+    "udplite",         /* 0x88: 136 - Lightweight User Datagram Protocol       RFC 3828 */
+    "mpls-in-ip",      /* 0x89: 137 - Multiprotocol Label Switching Encapsulated in IP RFC 4023,
+                                RFC      5332 */
+    NULL,              /* 0x8A: 138 - MANET Protocols  RFC 5498 */
+    "hip",             /* 0x8B: 139 - Host Identity Protocol   RFC 5201 */
+    "shim6",           /* 0x8C: 140 - Site Multihoming by IPv6 Intermediation  RFC 5533 */
+    "wesp",            /* 0x8D: 141 - Wrapped Encapsulating Security Payload   RFC 5840 */
+    "rohc",            /* 0x8E: 142 - Robust Header Compression        RFC 5856 */
+    /* no aliases for 142-255 */
+};
+
+typedef struct ProtoNameHashEntry_ {
+    const char *name;
+    uint8_t number;
+} ProtoNameHashEntry;
+
+static HashTable *proto_ht = NULL;
+
+static uint32_t ProtoNameHashFunc(HashTable *ht, void *data, uint16_t datalen)
+{
+    /*
+     * datalen covers the entire struct -- only the proto name is hashed
+     * as the proto number is not used for lookups
+     */
+    ProtoNameHashEntry *p = (ProtoNameHashEntry *)data;
+    return StringHashDjb2((uint8_t *)p->name, strlen(p->name)) % ht->array_size;
+}
+
+static char ProtoNameHashCompareFunc(void *data1, uint16_t datalen1, void *data2, uint16_t datalen2)
+{
+    ProtoNameHashEntry *p1 = (ProtoNameHashEntry *)data1;
+    ProtoNameHashEntry *p2 = (ProtoNameHashEntry *)data2;
+
+    if (p1 == NULL || p2 == NULL)
+        return 0;
+
+    if (p1->name == NULL || p2->name == NULL)
+        return 0;
+
+    int len1 = strlen(p1->name);
+    int len2 = strlen(p2->name);
+
+    return len1 == len2 && memcmp(p1->name, p2->name, len1) == 0;
+}
+
+static void ProtoNameAddEntry(const char *proto_name, const int proto_number)
+{
+    ProtoNameHashEntry *proto_ent = SCCalloc(1, sizeof(ProtoNameHashEntry));
+    if (!proto_ent) {
+        FatalError(SC_ERR_HASH_TABLE_INIT, "Unable to allocate protocol hash entry");
+    }
+
+    proto_ent->name = SCStrdup(proto_name);
+    if (!proto_ent->name)
+        FatalError(SC_ERR_MEM_ALLOC, "Unable to allocate memory for protocol name entries");
+
+    proto_ent->number = proto_number;
+
+    SCLogDebug("new protocol entry: name: \"%s\"; protocol number: %d", proto_ent->name,
+            proto_ent->number);
+    if (0 != HashTableAdd(proto_ht, proto_ent, 0)) {
+        FatalError(SC_ERR_HASH_ADD,
+                "Unable to add entry to proto hash table for "
+                "name: \"%s\"; number: %d",
+                proto_ent->name, proto_ent->number);
+    }
+    return;
+}
+
+static void ProtoNameHashFreeFunc(void *data)
+{
+    ProtoNameHashEntry *proto_ent = (ProtoNameHashEntry *)data;
+
+    if (proto_ent) {
+        if (proto_ent->name)
+            SCFree((void *)proto_ent->name);
+        SCFree(proto_ent);
+    }
+}
+
+void SCProtoNameInit(void)
+{
+    proto_ht =
+            HashTableInit(256, ProtoNameHashFunc, ProtoNameHashCompareFunc, ProtoNameHashFreeFunc);
+    if (proto_ht == NULL) {
+        FatalError(SC_ERR_HASH_TABLE_INIT, "Unable to initialize protocol name/number table");
+    }
+
+    for (uint32_t i = 0; i < ARRAY_SIZE(known_proto); i++) {
+        if (known_proto[i]) {
+            ProtoNameAddEntry(known_proto[i], i);
+        }
+    }
+
+    for (uint32_t i = 0; i < ARRAY_SIZE(proto_aliases); i++) {
+        if (proto_aliases[i]) {
+            ProtoNameAddEntry(proto_aliases[i], i);
+        }
+    }
+}
+
+void SCProtoNameRelease(void)
+{
+    if (proto_ht != NULL) {
+        HashTableFree(proto_ht);
+        proto_ht = NULL;
+    }
+}
+
 /**
  * \brief   Function to check if the received protocol number is valid and do
  *           we have corresponding name entry for this number or not.
@@ -196,3 +455,53 @@ bool SCProtoNameValid(uint16_t proto)
 {
     return (proto <= 255 && known_proto[proto] != NULL);
 }
+
+/**
+ * \brief   Function to return the protocol number for a named protocol. Note
+ *          that protocol name aliases are honored.
+ *
+ * \param protoname Protocol name (or alias for a protocol name).
+ * \param proto_number Where to return protocol number
+ * \retval ret On success returns the protocol number; else -1
+ */
+bool SCGetProtoByName(const char *protoname, uint8_t *proto_number)
+{
+    if (!protoname || !proto_number) {
+        return false;
+    }
+
+    ProtoNameHashEntry proto;
+    proto.name = protoname;
+
+    ProtoNameHashEntry *proto_ent = HashTableLookup(proto_ht, &proto, sizeof(proto));
+    if (proto_ent) {
+        *proto_number = proto_ent->number;
+        return true;
+    }
+    return false;
+}
+
+#ifdef UNITTESTS
+static int ProtoNameTest01(void)
+{
+    uint8_t proto;
+    FAIL_IF(!SCGetProtoByName("tcp", &proto));
+    FAIL_IF(SCGetProtoByName("TcP", &proto));
+    FAIL_IF(!SCGetProtoByName("TCP", &proto));
+    FAIL_IF(SCGetProtoByName("Invalid", &proto));
+    FAIL_IF(!SCGetProtoByName("Ethernet", &proto));
+
+    /* 'ip' is an alias for 'HOPOPT' */
+    FAIL_IF(!SCGetProtoByName("ip", &proto));
+    FAIL_IF(!SCGetProtoByName("HOPOPT", &proto));
+
+    FAIL_IF(SCGetProtoByName("IP", &proto));
+
+    PASS;
+}
+
+void SCProtoNameRegisterTests(void)
+{
+    UtRegisterTest("ProtoNameTest01", ProtoNameTest01);
+}
+#endif
index 8d5403c87a6eaf980d3ae9b48d5f0adc16d37542..bc5037395a0dd6edf3e5548e90d1fdd2184e9f69 100644 (file)
@@ -1,4 +1,4 @@
-/* Copyright (C) 2007-2021 Open Information Security Foundation
+/* Copyright (C) 2007-2022 Open Information Security Foundation
  *
  * You can copy, redistribute or modify this Program under the terms of
  * the GNU General Public License version 2 as published by the Free
 extern const char *known_proto[256];
 
 bool SCProtoNameValid(uint16_t);
+bool SCGetProtoByName(const char *protoname, uint8_t *proto_number);
+void SCProtoNameInit(void);
+void SCProtoNameRelease(void);
+
+#ifdef UNITTESTS
+void SCProtoNameRegisterTests(void);
+#endif
 
 #endif /* __UTIL_PROTO_NAME_H__ */