From 0d47952611198ef6b1163f366dc03922d20b1475 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 17 Apr 2024 09:42:04 +0200 Subject: Adding upstream version 7.94+git20230807.3be01efb1+dfsg. Signed-off-by: Daniel Baumann --- utils.h | 129 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 utils.h (limited to 'utils.h') diff --git a/utils.h b/utils.h new file mode 100644 index 0000000..35e7192 --- /dev/null +++ b/utils.h @@ -0,0 +1,129 @@ +/*************************************************************************** + * utils.h -- Various miscellaneous utility functions which defy * + * categorization :) * + * * + ***********************IMPORTANT NMAP LICENSE TERMS************************ + * + * The Nmap Security Scanner is (C) 1996-2023 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.com) 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$ */ + +#ifndef UTILS_H +#define UTILS_H + +#ifndef WIN32 +#include +#endif + +#include "nbase.h" +#include + +/* Arithmatic difference modulo 2^32 */ +#ifndef MOD_DIFF +#define MOD_DIFF(a,b) ((u32) (MIN((u32)(a) - (u32 ) (b), (u32 )(b) - (u32) (a)))) +#endif + +/* Arithmatic difference modulo 2^16 */ +#ifndef MOD_DIFF_USHORT +#define MOD_DIFF_USHORT(a,b) ((MIN((unsigned short)((unsigned short)(a) - (unsigned short ) (b)), (unsigned short) ((unsigned short )(b) - (unsigned short) (a))))) +#endif +#ifndef FALSE +#define FALSE 0 +#endif +#ifndef TRUE +#define TRUE 1 +#endif + +#define MAX_PARSE_ARGS 254 /* +1 for integrity checking + 1 for null term */ + +/* Return num if it is between min and max. Otherwise return min or max + (whichever is closest to num). */ +template T box(T bmin, T bmax, T bnum) { + assert(bmin <= bmax); + if (bnum >= bmax) + return bmax; + if (bnum <= bmin) + return bmin; + return bnum; +} + +int wildtest(const char *wild, const char *test); + +void nmap_hexdump(const unsigned char *cp, unsigned int length); + +void genfry(unsigned char *arr, int elem_sz, int num_elem); +void shortfry(unsigned short *arr, int num_elem); +char *chomp(char *string); + +int Send(int sd, const void *msg, size_t len, int flags); + +int arg_parse(const char *command, char ***argv); +void arg_parse_free(char **argv); + +char *cstring_unescape(char *str, unsigned int *len); + +void bintohexstr(char *buf, int buflen, const char *src, int srclen); + +u8 *parse_hex_string(const char *str, size_t *outlen); + +int cpe_get_part(const char *cpe); + +char *mmapfile(char *fname, s64 *length, int openflags); + +#ifdef WIN32 +int win32_munmap(char *filestr, int filelen); +#endif /* WIN32 */ + +#endif /* UTILS_H */ + -- cgit v1.2.3