mirror of
https://github.com/nmap/nmap.git
synced 2025-12-06 04:31:29 +00:00
187 lines
8.0 KiB
C++
187 lines
8.0 KiB
C++
|
|
/***************************************************************************
|
|
* MACLookup.cc -- This relatively simple system handles looking up the *
|
|
* vendor registered to a MAC address using the nmap-mac-prefixes *
|
|
* database. *
|
|
* *
|
|
***********************IMPORTANT NMAP LICENSE TERMS************************
|
|
* *
|
|
* The Nmap Security Scanner is (C) 1996-2021 Nmap Software LLC ("The Nmap *
|
|
* Project"). Nmap is also a registered trademark of the Nmap Project. *
|
|
* *
|
|
* This program is distributed under the terms of the Nmap Public Source *
|
|
* License (NPSL). The exact license text applying to a particular Nmap *
|
|
* release or source code control revision is contained in the LICENSE *
|
|
* file distributed with that version of Nmap or source code control *
|
|
* revision. More Nmap copyright/legal information is available from *
|
|
* https://nmap.org/book/man-legal.html, and further information on the *
|
|
* NPSL license itself can be found at https://nmap.org/npsl. This header *
|
|
* summarizes some key points from the Nmap license, but is no substitute *
|
|
* for the actual license text. *
|
|
* *
|
|
* Nmap is generally free for end users to download and use themselves, *
|
|
* including commercial use. It is available from https://nmap.org. *
|
|
* *
|
|
* The Nmap license generally prohibits companies from using and *
|
|
* redistributing Nmap in commercial products, but we sell a special Nmap *
|
|
* OEM Edition with a more permissive license and special features for *
|
|
* this purpose. See https://nmap.org/oem *
|
|
* *
|
|
* If you have received a written Nmap license agreement or contract *
|
|
* stating terms other than these (such as an Nmap OEM license), you may *
|
|
* choose to use and redistribute Nmap under those terms instead. *
|
|
* *
|
|
* The official Nmap Windows builds include the Npcap software *
|
|
* (https://npcap.org) for packet capture and transmission. It is under *
|
|
* separate license terms which forbid redistribution without special *
|
|
* permission. So the official Nmap Windows builds may not be *
|
|
* redistributed without special permission (such as an Nmap OEM *
|
|
* license). *
|
|
* *
|
|
* Source is provided to this software because we believe users have a *
|
|
* right to know exactly what a program is going to do before they run it. *
|
|
* This also allows you to audit the software for security holes. *
|
|
* *
|
|
* Source code also allows you to port Nmap to new platforms, fix bugs, *
|
|
* and add new features. You are highly encouraged to submit your *
|
|
* changes as a Github PR or by email to the dev@nmap.org mailing list *
|
|
* for possible incorporation into the main distribution. Unless you *
|
|
* specify otherwise, it is understood that you are offering us very *
|
|
* broad rights to use your submissions as described in the Nmap Public *
|
|
* Source License Contributor Agreement. This is important because we *
|
|
* fund the project by selling licenses with various terms, and also *
|
|
* because the inability to relicense code has caused devastating *
|
|
* problems for other Free Software projects (such as KDE and NASM). *
|
|
* *
|
|
* The free version of Nmap 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. Warranties, *
|
|
* indemnification and commercial support are all available through the *
|
|
* Npcap OEM program--see https://nmap.org/oem. *
|
|
* *
|
|
***************************************************************************/
|
|
|
|
/* $Id$ */
|
|
|
|
#include "nmap.h"
|
|
|
|
#include <map>
|
|
|
|
/* Character pool memory allocation */
|
|
#include "MACLookup.h"
|
|
#include "NmapOps.h"
|
|
#include "nmap_error.h"
|
|
#include "charpool.h"
|
|
|
|
extern NmapOps o;
|
|
|
|
std::map<int, char *> MacTable;
|
|
|
|
static inline int MacCharPrefix2Key(const u8 *prefix) {
|
|
return (prefix[0] << 16) + (prefix[1] << 8) + prefix[2];
|
|
}
|
|
|
|
static void mac_prefix_init() {
|
|
static int initialized = 0;
|
|
if (initialized) return;
|
|
initialized = 1;
|
|
char filename[256];
|
|
FILE *fp;
|
|
char line[128];
|
|
int pfx;
|
|
char *endptr, *vendor;
|
|
int lineno = 0;
|
|
|
|
/* Now it is time to read in all of the entries ... */
|
|
if (nmap_fetchfile(filename, sizeof(filename), "nmap-mac-prefixes") != 1){
|
|
error("Cannot find nmap-mac-prefixes: Ethernet vendor correlation will not be performed");
|
|
return;
|
|
}
|
|
|
|
fp = fopen(filename, "r");
|
|
if (!fp) {
|
|
gh_perror("Unable to open %s. Ethernet vendor correlation will not be performed ", filename);
|
|
return;
|
|
}
|
|
/* Record where this data file was found. */
|
|
o.loaded_data_files["nmap-mac-prefixes"] = filename;
|
|
|
|
while(fgets(line, sizeof(line), fp)) {
|
|
lineno++;
|
|
if (*line == '#') continue;
|
|
if (!isxdigit((int) (unsigned char) *line)) {
|
|
error("Parse error on line #%d of %s. Giving up parsing.", lineno, filename);
|
|
break;
|
|
}
|
|
/* First grab the prefix */
|
|
pfx = strtol(line, &endptr, 16);
|
|
if (!endptr || !isspace((int) (unsigned char) *endptr)) {
|
|
error("Parse error on line #%d of %s. Giving up parsing.", lineno, filename);
|
|
break;
|
|
}
|
|
/* Now grab the vendor */
|
|
while(*endptr && isspace((int) (unsigned char) *endptr)) endptr++;
|
|
assert(*endptr);
|
|
vendor = endptr;
|
|
while(*endptr && *endptr != '\n' && *endptr != '\r') endptr++;
|
|
*endptr = '\0';
|
|
|
|
if (MacTable.find(pfx) == MacTable.end()) {
|
|
MacTable[pfx] = cp_strdup(vendor);
|
|
} else {
|
|
if (o.debugging > 1)
|
|
error("MAC prefix %06X is duplicated in %s; ignoring duplicates.", pfx, filename);
|
|
}
|
|
|
|
}
|
|
|
|
fclose(fp);
|
|
return;
|
|
}
|
|
|
|
|
|
static const char *findMACEntry(int prefix) {
|
|
std::map<int, char *>::iterator i;
|
|
|
|
i = MacTable.find(prefix);
|
|
if (i == MacTable.end())
|
|
return NULL;
|
|
|
|
return i->second;
|
|
}
|
|
|
|
/* Takes a three byte MAC address prefix (passing the whole MAC is OK
|
|
too) and returns the company which has registered the prefix.
|
|
NULL is returned if no vendor is found for the given prefix or if there
|
|
is some other error. */
|
|
const char *MACPrefix2Corp(const u8 *prefix) {
|
|
if (!prefix) fatal("%s called with a NULL prefix", __func__);
|
|
mac_prefix_init();
|
|
|
|
return findMACEntry(MacCharPrefix2Key(prefix));
|
|
}
|
|
|
|
/* Takes a string and looks through the table for a vendor name which
|
|
contains that string. Sets the first three bytes in mac_data and
|
|
returns true for the first matching entry found. If no entries
|
|
match, leaves mac_data untouched and returns false. Note that this
|
|
is not particularly efficient and so should be rewritten if it is
|
|
called often */
|
|
bool MACCorp2Prefix(const char *vendorstr, u8 *mac_data) {
|
|
std::map<int, char *>::iterator i;
|
|
|
|
if (!vendorstr) fatal("%s: vendorstr is NULL", __func__);
|
|
if (!mac_data) fatal("%s: mac_data is NULL", __func__);
|
|
mac_prefix_init();
|
|
|
|
for (i = MacTable.begin(); i != MacTable.end(); i++) {
|
|
if (strcasestr(i->second, vendorstr)) {
|
|
mac_data[0] = i->first >> 16;
|
|
mac_data[1] = (i->first >> 8) & 0xFF;
|
|
mac_data[2] = i->first & 0xFF;
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
}
|