tcpip.h

/*************************************************************************** * tcpip.h -- Various functions relating to low level TCP/IP handling, * * including sending raw packets, routing, printing packets, reading from * * libpcap, etc. * * * ***********************IMPORTANT NMAP LICENSE TERMS************************ * * * The Nmap Security Scanner is (C) 1996-2004 Insecure.Com LLC. Nmap * * is also a registered trademark of Insecure.Com LLC. This program is * * free software; you may redistribute and/or modify it under the * * terms of the GNU General Public License as published by the Free * * Software Foundation; Version 2. This guarantees your right to use, * * modify, and redistribute this software under certain conditions. If * * you wish to embed Nmap technology into proprietary software, we may be * * willing to sell alternative licenses (contact sales@insecure.com). * * Many security scanner vendors already license Nmap technology such as * * our remote OS fingerprinting database and code, service/version * * detection system, and port scanning code. * * * * Note that the GPL places important restrictions on "derived works", yet * * it does not provide a detailed definition of that term. To avoid * * misunderstandings, we consider an application to constitute a * * "derivative work" for the purpose of this license if it does any of the * * following: * * o Integrates source code from Nmap * * o Reads or includes Nmap copyrighted data files, such as * * nmap-os-fingerprints or nmap-service-probes. * * o Executes Nmap and parses the results (as opposed to typical shell or * * execution-menu apps, which simply display raw Nmap output and so are * * not derivative works.) * * o Integrates/includes/aggregates Nmap into a proprietary executable * * installer, such as those produced by InstallShield. * * o Links to a library or executes a program that does any of the above * * * * The term "Nmap" should be taken to also include any portions or derived * * works of Nmap. This list is not exclusive, but is just meant to * * clarify our interpretation of derived works with some common examples. * * These restrictions only apply when you actually redistribute Nmap. For * * example, nothing stops you from writing and selling a proprietary * * front-end to Nmap. Just distribute it by itself, and point people to * * http://www.insecure.org/nmap/ to download Nmap. * * * * We don't consider these to be added restrictions on top of the GPL, but * * just a clarification of how we interpret "derived works" as it applies * * to our GPL-licensed Nmap product. This is similar to the way Linus * * Torvalds has announced his interpretation of how "derived works" * * applies to Linux kernel modules. Our interpretation refers only to * * Nmap - we don't speak for any other GPL products. * * * * If you have any questions about the GPL licensing restrictions on using * * Nmap in non-GPL works, we would be happy to help. As mentioned above, * * we also offer alternative license to integrate Nmap into proprietary * * applications and appliances. These contracts have been sold to many * * security vendors, and generally include a perpetual license as well as * * providing for priority support and updates as well as helping to fund * * the continued development of Nmap technology. Please email * * sales@insecure.com for further information. * * * * As a special exception to the GPL terms, Insecure.Com LLC grants * * permission to link the code of this program with any version of the * * OpenSSL library which is distributed under a license identical to that * * listed in the included Copying.OpenSSL file, and distribute linked * * combinations including the two. You must obey the GNU GPL in all * * respects for all of the code used other than OpenSSL. If you modify * * this file, you may extend this exception to your version of the file, * * but you are not obligated to do so. * * * * If you received these files with a written license agreement or * * contract stating terms other than the terms above, then that * * alternative license agreement takes precedence over these comments. * * * * 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 (none * * have been found so far). * * * * Source code also allows you to port Nmap to new platforms, fix bugs, * * and add new features. You are highly encouraged to send your changes * * to fyodor@insecure.org for possible incorporation into the main * * distribution. By sending these changes to Fyodor or one the * * Insecure.Org development mailing lists, it is assumed that you are * * offering Fyodor and Insecure.Com LLC the unlimited, non-exclusive right * * to reuse, modify, and relicense the code. Nmap will always be * * available Open Source, but this is important because the inability to * * relicense code has caused devastating problems for other Free Software * * projects (such as KDE and NASM). We also occasionally relicense the * * code to third parties as discussed above. If you wish to specify * * special license conditions of your contributions, just say so when you * * send them. * * * * 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 at * * http://www.gnu.org/copyleft/gpl.html , or in the COPYING file included * * with Nmap. * * * ***************************************************************************//* $Id: tcpip.h 3224 2006-03-25 23:56:48Z fyodor $ */#ifndef TCPIP_H#define TCPIP_H#ifdef HAVE_CONFIG_H#include "config.h"#endif#include "nbase.h"#ifdef WIN32#include "mswin32\winclude.h"#else#ifdef STDC_HEADERS#include <stdlib.h>#elsevoid *malloc();
void *realloc();
#endif#if STDC_HEADERS || HAVE_STRING_H#include <string.h>#if !STDC_HEADERS && HAVE_MEMORY_H#include <memory.h>#endif#endif#if HAVE_STRINGS_H#include <strings.h>#endif#ifdef HAVE_BSTRING_H#include <bstring.h>#endif#include <ctype.h>#include <sys/types.h>#ifdef HAVE_SYS_PARAM_H#include <sys/param.h>/* Defines MAXHOSTNAMELEN on BSD*/#endif/* Linux uses these defines in netinet/ip.h and netinet/tcp.h to use the correct struct ip and struct tcphdr */#ifndef __FAVOR_BSD#define __FAVOR_BSD 1#endif#ifndef __BSD_SOURCE#define __BSD_SOURCE 1#endif#ifndef __USE_BSD#define __USE_BSD 1#endif/* BSDI needs this to insure the correct struct ip */#undef _IP_VHL#include <stdio.h>#if HAVE_NETINET_IN_H#include <netinet/in.h>#endif#ifdef HAVE_RPC_TYPES_H#include <rpc/types.h>#endif#ifdef HAVE_NETDB_H#include <netdb.h>#endif#if HAVE_SYS_SOCKET_H#include <sys/socket.h>#endif#include <arpa/inet.h>#ifndef NETINET_IN_SYSTEM_H /* why the HELL does OpenBSD not do this? */#include <netinet/in_systm.h>/* defines n_long needed for netinet/ip.h */#define NETINET_IN_SYSTEM_H#endif#ifndef NETINET_IP_H /* why the HELL does OpenBSD not do this? */#include <netinet/ip.h>#define NETINET_IP_H#endif#ifndef __FAVOR_BSD#define __FAVOR_BSD#endif#ifndef NETINET_TCP_H /* why the HELL does OpenBSD not do this? */#include <netinet/tcp.h>/*#include <netinet/ip_tcp.h>*/#define NETINET_TCP_H#endif#ifndef NETINET_UDP_H#include <netinet/udp.h>#define NETINET_UDP_H#endif#if HAVE_UNISTD_H#include <unistd.h>#endif#include <fcntl.h>#if TIME_WITH_SYS_TIME# include <sys/time.h># include <time.h>#else# if HAVE_SYS_TIME_H# include <sys/time.h># else# include <time.h># endif#endif#include <sys/ioctl.h>#ifdef __cplusplusextern"C" {
#endif#include <pcap.h>#ifdef __cplusplus}
#endif#if HAVE_SYS_SOCKIO_H#include <sys/sockio.h>/* SIOCGIFCONF for Solaris */#endif#endif /* WIN32 */#include <setjmp.h>#include <errno.h>#include <signal.h>#include <dnet.h>#ifndef WIN32#include <netinet/ip_icmp.h>#endiftypedefenum { devt_ethernet, devt_loopback, devt_p2p, devt_other } devtype;
#include "nmap_error.h"#include "utils.h"#include "nmap.h"#include "global_structures.h"#ifndef DEBUGGING#define DEBUGGING 0#endif#ifndef TCPIP_DEBUGGING#define TCPIP_DEBUGGING 0#endif/* Explicit Congestion Notification (rfc 2481/3168) */#ifndef TH_ECE#define TH_ECE 0x40#endif#ifndef TH_CWR#define TH_CWR 0x80#endif#ifndef INET_ADDRSTRLEN#define INET_ADDRSTRLEN 16#endif/* Used for tracing all packets sent or received (eg the --packet_trace option) */class PacketTrace {
public:
/* static const int SEND=1; static const int RCV=2; */enum pdirection { SENT=1, RCVD=2 };
/* Takes an IP PACKET and prints it if packet tracing is enabled. 'packet' must point to the IPv4 header. The direction must be PacketTrace::SENT or PacketTrace::RCVD . Optional 'now' argument makes this function slightly more efficient by avoiding a gettimeofday() call. */staticvoid trace(pdirection pdir, const u8 *packet, u32 len,
struct timeval *now=NULL);
/* Adds a trace entry when a connect() is attempted if packet tracing is enabled. Pass IPPROTO_TCP or IPPROTO_UDP as the protocol. The sock may be a sockaddr_in or sockaddr_in6. The return code of connect is passed in connectrc. If the return code is -1, get the errno and pass that as connect_errno. */staticvoid traceConnect(u8 proto, conststruct sockaddr *sock,
int socklen, int connectrc, int connect_errno,
conststruct timeval *now);
/* Takes an ARP PACKET (including ethernet header) and prints it if packet tracing is enabled. 'frame' must point to the 14-byte ethernet header (e.g. starting with destination addr). The direction must be PacketTrace::SENT or PacketTrace::RCVD . Optional 'now' argument makes this function slightly more efficient by avoiding a gettimeofday() call. */staticvoid traceArp(pdirection pdir, const u8 *frame, u32 len,
struct timeval *now);
};
class PacketCounter {
public:
PacketCounter() : sendPackets(0), sendBytes(0), recvPackets(0), recvBytes(0) {}
#if WIN32unsigned __int64
#elseunsignedlonglong#endif sendPackets, sendBytes, recvPackets, recvBytes;
};
#define MAX_LINK_HEADERSZ 24struct link_header {
int datalinktype; /* pcap_datalink(), such as DLT_EN10MB */int headerlen; /* 0 if header was too big or unavailaable */
u8 header[MAX_LINK_HEADERSZ];
};
/* Relevant (to Nmap) information about an interface */struct interface_info {
char devname[16];
char devfullname[16]; /* can include alias info, such as eth0:2. */struct sockaddr_storage addr;
u16 netmask_bits; /* CIDR-style. So 24 means class C (255.255.255.0)*/
devtype device_type; /* devt_ethernet, devt_loopback, devt_p2p, devt_other */bool device_up; /* True if the device is up (enabled) */
u8 mac[6]; /* Interface MAC address if device_type is devt_ethernet */
};
struct route_nfo {
struct interface_info ii;
/* true if the target is directly connected on the network (no routing required). */bool direct_connect;
/* This is the source address that should be used by the packets. It may be different than ii.addr if you are using localhost interface to scan the IP of another interface on the machine */struct sockaddr_storage srcaddr;
/* If direct_connect is 0, this is filled in with the next hop required to route to the target */struct sockaddr_storage nexthop;
};
struct sys_route {
struct interface_info *device;
u32 dest;
u32 netmask;
struct in_addr gw; /* gateway - 0 if none */
};
struct eth_nfo {
char srcmac[6];
char dstmac[6];
eth_t *ethsd; // Optional, but improves performance. Set to NULL if unavailchar devname[16]; // Only needed if ethsd is NULL.
};
#ifndef HAVE_STRUCT_IP#define HAVE_STRUCT_IP/* From Linux glibc, which apparently borrowed it from BSD code. Slightly modified for portability --fyodor@insecure.org *//* * Structure of an internet header, naked of options. */struct ip
{
#if WORDS_BIGENDIAN u_int8_t ip_v:4; /* version */
u_int8_t ip_hl:4; /* header length */#else u_int8_t ip_hl:4; /* header length */
u_int8_t ip_v:4; /* version */#endif u_int8_t ip_tos; /* type of service */
u_short ip_len; /* total length */
u_short ip_id; /* identification */
u_short ip_off; /* fragment offset field */#define IP_RF 0x8000 /* reserved fragment flag */#define IP_DF 0x4000 /* dont fragment flag */#define IP_MF 0x2000 /* more fragments flag */#define IP_OFFMASK 0x1fff /* mask for fragmenting bits */
u_int8_t ip_ttl; /* time to live */
u_int8_t ip_p; /* protocol */
u_short ip_sum; /* checksum */struct in_addr ip_src, ip_dst; /* source and dest address */
};
#endif /* HAVE_STRUCT_IP */#ifdef LINUXtypedefstruct udphdr_bsd {
unsignedshort uh_sport; /* source port */unsignedshort uh_dport; /* destination port */unsignedshort uh_ulen; /* udp length */unsignedshort uh_sum; /* udp checksum */
} udphdr_bsd;
#elsetypedefstruct udphdr udphdr_bsd;
#endif #ifndef HAVE_STRUCT_ICMP#define HAVE_STRUCT_ICMP/* From Linux /usr/include/netinet/ip_icmp.h GLIBC *//* * Internal of an ICMP Router Advertisement */struct icmp_ra_addr
{
u_int32_t ira_addr;
u_int32_t ira_preference;
};
struct icmp
{
u_int8_t icmp_type; /* type of message, see below */
u_int8_t icmp_code; /* type sub code */
u_int16_t icmp_cksum; /* ones complement checksum of struct */union
{
struct ih_idseq /* echo datagram */
{
u_int16_t icd_id;
u_int16_t icd_seq;
} ih_idseq;
u_int32_t ih_void;
/* ICMP_UNREACH_NEEDFRAG -- Path MTU Discovery (RFC1191) */struct ih_pmtu
{
u_int16_t ipm_void;
u_int16_t ipm_nextmtu;
} ih_pmtu;
struct ih_rtradv
{
u_int8_t irt_num_addrs;
u_int8_t irt_wpa;
u_int16_t irt_lifetime;
} ih_rtradv;
} icmp_hun;
/* Removed icmp_pptr and icmp_gwaddr from union and #defines because they conflict with dnet */#define icmp_id icmp_hun.ih_idseq.icd_id#define icmp_seq icmp_hun.ih_idseq.icd_seq#define icmp_void icmp_hun.ih_void#define icmp_pmvoid icmp_hun.ih_pmtu.ipm_void#define icmp_nextmtu icmp_hun.ih_pmtu.ipm_nextmtu#define icmp_num_addrs icmp_hun.ih_rtradv.irt_num_addrs#define icmp_wpa icmp_hun.ih_rtradv.irt_wpa#define icmp_lifetime icmp_hun.ih_rtradv.irt_lifetimeunion
{
struct
{
u_int32_t its_otime;
u_int32_t its_rtime;
u_int32_t its_ttime;
} id_ts;
struct
{
struct ip idi_ip;
/* options and then 64 bits of data */
} id_ip;
struct icmp_ra_addr id_radv;
u_int32_t id_mask;
u_int8_t id_data[1];
} icmp_dun;
#define icmp_otime icmp_dun.id_ts.its_otime#define icmp_rtime icmp_dun.id_ts.its_rtime#define icmp_ttime icmp_dun.id_ts.its_ttime#define icmp_ip icmp_dun.id_ip.idi_ip#define icmp_radv icmp_dun.id_radv#define icmp_mask icmp_dun.id_mask#define icmp_data icmp_dun.id_data};
#endif /* HAVE_STRUCT_ICMP *//* Represents a single probe packet, such as a SYN to port 80 or an ICMP netmask request packet. Values are still in network byte order. */class IPProbe {
public:
IPProbe();
~IPProbe();
/* Takes an IP packet and stores _a copy_ of it, in this Probe, adjusting proper header pointers and such */int storePacket(u8 *ippacket, u32 len);
u32 packetbuflen; /* Length of the whole packet */
u8 *packetbuf; /* The packet itself */struct ip *ipv4; /* IP header of packet */struct icmp *icmp; /* icmp, tcp, and udp are NULL if the packet has no such header */struct tcphdr *tcp;
udphdr_bsd *udp;
u8 af; /* AF_INET or AF_INET6 *//* Resets everything to NULL. Frees packetbuf if it is filled. You can reuse a Probe by calling Reset() and then a new storePacket(). */void Reset();
private:
};
/* Handles an *IPv4* Arp probe */class ArpProbe {
public:
ArpProbe();
~ArpProbe();
/* Takes an ARP packet and stores _a copy_ of it, in this Probe, adjusting proper header pointers and such. Then length better equal 42! */int storePacket(u8 *arppacket, u32 len);
u32 packetbuflen; /* Length of the whole packet */
u8 *packetbuf; /* The packet itself */struct in_addr *ipquery; /* IP address this ARP seeks *//* Resets everything to NULL. Frees packetbuf if it is filled. You can reuse a Probe by calling Reset() and then a new storePacket(). */void Reset();
private:
};
/* This ideally should be a port that isn't in use for any protocol on our machine or on the target */#define MAGIC_PORT 49724#define TVAL2LONG(X) X.tv_sec * 1e6 + X.tv_usec#define SA struct sockaddr/* Prototypes *//* Converts an IP address given in a sockaddr_storage to an IPv4 or IPv6 IP address string. Since a static buffer is returned, this is not thread-safe and can only be used once in calls like printf() */constchar *inet_socktop(struct sockaddr_storage *ss);
/* Tries to resolve the given name (or literal IP) into a sockaddr structure. The af should be PF_INET (for IPv4) or PF_INET6. Returns 0 if hostname cannot be resolved. It is OK to pass in a sockaddr_in or sockaddr_in6 casted to a sockaddr_storage as long as you use the matching pf.*/int resolve(char *hostname, struct sockaddr_storage *ss, size_t *sslen,
int pf);
/* LEGACY resolve() function that only supports IPv4 -- see IPv6 version above. Tries to resolve given hostname and stores result in ip . returns 0 if hostname cannot be resolved */int resolve(char *hostname, struct in_addr *ip);
/* Takes a destination address (dst) and tries to determine the source address and interface necessary to route to this address. If no route is found, false is returned and rnfo is undefined. If a route is found, true is returned and rnfo is filled in with all of the routing details. This function takes into account -S and -e options set by user (o.spoofsource, o.device) */bool route_dst(conststruct sockaddr_storage *const dst, struct route_nfo *rnfo);
/* Determines what interface packets destined to 'dest' should be routed through. It can also discover the appropriate next hop (if any) for ethernet routing. If direct_connect is passed in, it will be set to 1 if dst is directly connected on the ifentry network and 0 if it requires routing. If nexthop_ip is not NULL, and routing is required, the next hop is filled into nexthop_ip. This function returns false if no apporpiate interface or route was found and true if it succeeds. */bool routethrough(conststruct sockaddr_storage * const dest,
struct intf_entry *ifentry,
int *direct_connect, struct sockaddr_storage *nexthop_ip);
unsignedshort in_cksum(u16 *ptr,int nbytes);
/* Build and send a raw tcp packet. If TTL is -1, a partially random (but likely large enough) one is chosen */int send_tcp_raw( int sd, struct eth_nfo *eth, conststruct in_addr *source,
conststruct in_addr *victim, int ttl,
u16 sport, u16 dport, u32 seq, u32 ack, u8 flags,
u16 window, u8 *options, int optlen, char *data,
u16 datalen);
int send_udp_raw( int sd, struct eth_nfo *eth, struct in_addr *source,
conststruct in_addr *victim, int ttl, u16 sport,
u16 dport, u16 ipid, char *data, u16 datalen);
int send_ip_raw( int sd, struct eth_nfo *eth, struct in_addr *source,
conststruct in_addr *victim, int ttl, u8 proto,
char *data, u16 datalen);
/* Builds a TCP packet (including an IP header) by packing the fields with the given information. It allocates a new buffer to store the packet contents, and then returns that buffer. The packet is not actually sent by this function. Caller must delete the buffer when finished with the packet. The packet length is returned in packetlen, which must be a valid int pointer. */
u8 *build_tcp_raw(conststruct in_addr *source,
conststruct in_addr *victim, int ttl,
u16 ipid, u16 sport, u16 dport, u32 seq, u32 ack, u8 flags,
u16 window, u8 *options, int optlen, char *data,
u16 datalen, u32 *packetlen);
/* Builds a UDP packet (including an IP header) by packing the fields with the given information. It allocates a new buffer to store the packet contents, and then returns that buffer. The packet is not actually sent by this function. Caller must delete the buffer when finished with the packet. The packet length is returned in packetlen, which must be a valid int pointer. */
u8 *build_udp_raw(struct in_addr *source, conststruct in_addr *victim,
int ttl, u16 sport, u16 dport, u16 ipid, char *data,
u16 datalen, u32 *packetlen);
/* Builds an ICMP packet (including an IP header) by packing the fields with the given information. It allocates a new buffer to store the packet contents, and then returns that buffer. The packet is not actually sent by this function. Caller must delete the buffer when finished with the packet. The packet length is returned in packetlen, which must be a valid int pointer. */
u8 *build_icmp_raw(conststruct in_addr *source, conststruct in_addr *victim,
int ttl, u16 ipid, u16 seq, unsignedshortid, u8 ptype,
u8 pcode, char *data, u16 datalen, u32 *packetlen);
/* Builds an IP packet (including an IP header) by packing the fields with the given information. It allocates a new buffer to store the packet contents, and then returns that buffer. The packet is not actually sent by this function. Caller must delete the buffer when finished with the packet. The packet length is returned in packetlen, which must be a valid int pointer. */
u8 *build_ip_raw(conststruct in_addr *source, conststruct in_addr *victim,
int ttl, u8 proto, u16 ipid, char *data, u16 datalen,
u32 *packetlen);
/* Send a pre-built IPv4 packet */int send_ip_packet(int sd, struct eth_nfo *eth, u8 *packet,
unsignedint packetlen);
/* Decoy versions of the raw packet sending functions ... */int send_tcp_raw_decoys( int sd, struct eth_nfo *eth,
conststruct in_addr *victim, int ttl,
u16 sport, u16 dport, u32 seq, u32 ack, u8 flags,
u16 window, u8 *options, int optlen, char *data,
u16 datalen);
int send_udp_raw_decoys( int sd, struct eth_nfo *eth,
conststruct in_addr *victim, int ttl,
u16 sport, u16 dport, u16 ipid, char *data,
u16 datalen);
/* Calls pcap_open_live and spits out an error (and quits) if the call fails. So a valid pcap_t will always be returned. */
pcap_t *my_pcap_open_live(constchar *device, int snaplen, int promisc,
int to_ms);
// Returns whether the packet receive time value obtaned from libpcap// (and thus by readip_pcap()) should be considered valid. When// invalid (Windows and Amiga), readip_pcap returns the time you called it.bool pcap_recv_timeval_valid();
/* A simple function that caches the eth_t from dnet for one device, to avoid opening, closing, and re-opening it thousands of tims. If you give a different device, this function will close the first one. Thus this should never be used by programs that need to deal with multiple devices at once. In addition, you MUST NEVER eth_close() A DEVICE OBTAINED FROM THIS FUNCTION. Instead, you can call eth_close_cached() to close whichever device (if any) is cached. Returns NULL if it fails to open the device. */
eth_t *eth_open_cached(constchar *device);
/* See the description for eth_open_cached */void eth_close_cached();
/* A simple function I wrote to help in debugging, shows the important fields of a TCP packet*/int readtcppacket(const u8 *packet, int readdata);
int readudppacket(const u8 *packet, int readdata);
/* Convert an IP address to the device (IE ppp0 eth0) using that address. Dev passed in must be at least 32 bytes long */int ipaddr2devname( char *dev, conststruct in_addr *addr );
/* And vice versa */int devname2ipaddr(char *dev, struct in_addr *addr);
/* Looks for an interface assigned to the given IP (ss), and returns the interface_info for the first one found. If non found, returns NULL */struct interface_info *getInterfaceByIP(struct sockaddr_storage *ss);
/* Looks for an interface with the given name (iname), and returns the corresponding interface_info if found. Will accept a match of devname or devfullname. Returns NULL if none found */struct interface_info *getInterfaceByName(char *iname);
/* Where the above 4 functions get their info */struct interface_info *getinterfaces(int *howmany);
/* Parse the system routing table, converting each route into a sys_route entry. Returns an array of sys_routes. numroutes is set to the number of routes in the array. The routing table is only read the first time this is called -- later results are cached. The returned route array is sorted by netmask with the most specific matches first. */struct sys_route *getsysroutes(int *howmany);
void sethdrinclude(int sd);
/* Fill buf (up to buflen -- truncate if necessary but always terminate) with a short representation of the packet stats. Returns buf. Aborts if there is a problem. */char *getFinalPacketStats(char *buf, int buflen);
/* This function tries to determine the target's ethernet MAC address from a received packet as follows: 1) If linkhdr is an ethernet header, grab the src mac (otherwise give up) 2) If overwrite is 0 and a MAC is already set for this target, give up. 3) If the packet source address is not the target, give up. 4) Use the routing table to try to determine rather target is directly connected to the src host running Nmap. If it is, set the MAC. This function returns 0 if it ends up setting the MAC, nonzero otherwise This function assumes that ip has already been verified as containing a complete IP header (or at least the first 20 bytes).*/int setTargetMACIfAvailable(Target *target, struct link_header *linkhdr,
struct ip *ip, int overwrite);
/* This function ensures that the next hop MAC address for a target is filled in. This address is the target's own MAC if it is directly connected, and the next hop mac otherwise. Returns true if the address is set when the function ends, false if not. This function firt checks if it is already set, if not it tries the arp cache, and if that fails it sends an ARP request itself. This should be called after an ARP scan if many directly connected machines are involved. */bool setTargetNextHopMAC(Target *target);
int islocalhost(conststruct in_addr * const addr);
int unblock_socket(int sd);
// Takes a protocol number like IPPROTO_TCP, IPPROTO_UDP, or// IPPROTO_TCP and returns a ascii representation (or "unknown" if it// doesn't recognize the number). If uppercase is true, the returned// value will be in all uppercase letters. You can skip this// parameter to use lowercase.constchar *proto2ascii(u8 proto, bool uppercase=false);
/* Hex dump */int get_link_offset(char *device);
/* If rcvdtime is non-null and a packet is returned, rcvd will be filled with the time that packet was captured from the wire by pcap. If linknfo is not NULL, lnknfo->headerlen and lnkinfo->header will be filled with the appropriate values. */char *readip_pcap(pcap_t *pd, unsignedint *len, long to_usec,
struct timeval *rcvdtime, struct link_header *linknfo);
/* Attempts to read one IPv4/Ethernet ARP reply packet from the pcap descriptor pd. If it receives one, fills in sendermac (must pass in 6 bytes), senderIP, and rcvdtime (can be NULL if you don't care) and returns 1. If it times out and reads no arp requests, returns 0. to_usec is the timeout period in microseconds. Use 0 to avoid blocking to the extent possible, and -1 to block forever. Returns -1 or exits if ther is an error. */int read_arp_reply_pcap(pcap_t *pd, u8 *sendermac, struct in_addr *senderIP,
long to_usec, struct timeval *rcvdtime);
#ifndef HAVE_INET_ATONint inet_aton(registerconstchar *, struct in_addr *);
#endif/* Examines the given tcp packet and obtains the TCP timestamp option information if available. Note that the CALLER must ensure that "tcp" contains a valid header (in particular the th_off must be the true packet length and tcp must contain it). If a valid timestamp option is found in the header, nonzero is returned and the 'timestamp' and 'echots' parameters are filled in with the appropriate value (if non-null). Otherwise 0 is returned and the parameters (if non-null) are filled with 0. Remember that the correct way to check for errors is to look at the return value since a zero ts or echots could possibly be valid. */int gettcpopt_ts(struct tcphdr *tcp, u32 *timestamp, u32 *echots);
/* Maximize the receive buffer of a socket descriptor (up to 500K) */void max_rcvbuf(int sd);
/* Maximize the open file descriptor limit for this process go up to the max allowed */int max_sd();
/* Convert a socket to blocking mode */int block_socket(int sd);
/* Give broadcast permission to a socket */void broadcast_socket(int sd);
/* Do a receive (recv()) on a socket and stick the results (upt to len) into buf . Give up after 'seconds'. Returns the number of bytes read (or -1 in the case of an error. It only does one recv (it will not keep going until len bytes are read). If timedout is not NULL, it will be set to zero (no timeout occured) or 1 (it did). */int recvtime(int sd, char *buf, int len, int seconds, int *timedout);
/* Sets a pcap filter function -- makes SOCK_RAW reads easier */#ifndef WINIP_Htypedef int (*PFILTERFN)(constchar *packet, unsignedint len); /* 1 to keep */void set_pcap_filter(constchar *device, pcap_t *pd, char *bpf, ...);
#endif/* Just accept everything ... TODO: Need a better approach than this flt_ stuff */int flt_all(constchar *packet, unsignedint len);
int flt_icmptcp(constchar *packet, unsignedint len);
int flt_icmptcp_2port(constchar *packet, unsignedint len);
int flt_icmptcp_5port(constchar *packet, unsignedint len);
#endif /*TCPIP_H*/