2 * Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that: (1) source code distributions
7 * retain the above copyright notice and this paragraph in its entirety, (2)
8 * distributions including binary code include the above copyright notice and
9 * this paragraph in its entirety in the documentation or other materials
10 * provided with the distribution, and (3) all advertising materials mentioning
11 * features or use of this software display the following acknowledgement:
12 * ``This product includes software developed by the University of California,
13 * Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
14 * the University nor the names of its contributors may be used to endorse
15 * or promote products derived from this software without specific prior
17 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
18 * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
19 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
21 * Support for splitting captures into multiple files with a maximum
25 * Seth Webster <swebster@sst.ll.mit.edu>
29 * tcpdump - dump traffic on a network
31 * First written in 1987 by Van Jacobson, Lawrence Berkeley Laboratory.
32 * Mercilessly hacked and occasionally improved since then via the
33 * combined efforts of Van, Steve McCanne and Craig Leres of LBL.
38 #include "netdissect-stdinc.h"
41 * This must appear after including netdissect-stdinc.h, so that _U_ is
45 static const char copyright
[] _U_
=
46 "@(#) Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000\n\
47 The Regents of the University of California. All rights reserved.\n";
55 #include <openssl/crypto.h>
58 #ifdef HAVE_GETOPT_LONG
61 #include "missing/getopt_long.h"
63 /* Capsicum-specific code requires macros from <net/bpf.h>, which will fail
64 * to compile if <pcap.h> has already been included; including the headers
65 * in the opposite order works fine. For the most part anyway, because in
66 * FreeBSD <pcap/pcap.h> declares bpf_dump() instead of <net/bpf.h>. Thus
67 * interface.h takes care of it later to avoid a compiler warning.
70 #include <sys/capsicum.h>
71 #include <sys/ioccom.h>
75 #include <libcasper.h>
76 #include <casper/cap_dns.h>
78 #endif /* HAVE_CASPER */
79 #endif /* HAVE_CAPSICUM */
82 * We found pcap_open() in the capture library, so we'll be using
83 * the remote capture APIs; define PCAP_REMOTE before we include pcap.h,
84 * so we get those APIs declared, and the types and #defines that they
87 * WinPcap's headers require that PCAP_REMOTE be defined in order to get
88 * remote-capture APIs declared and types and #defines that they use
91 * (Versions of libpcap with those APIs, and thus Npcap, which is based on
92 * those versions of libpcap, don't require it.)
106 #include <sys/time.h>
107 #include <sys/wait.h>
108 #include <sys/resource.h>
114 * Pathname separator.
115 * Use this in pathnames, but do *not* use it in URLs.
118 #define PATH_SEPARATOR '\\'
120 #define PATH_SEPARATOR '/'
123 /* capabilities convenience library */
124 /* If a code depends on HAVE_LIBCAP_NG, it depends also on HAVE_CAP_NG_H.
125 * If HAVE_CAP_NG_H is not defined, undefine HAVE_LIBCAP_NG.
126 * Thus, the later tests are done only on HAVE_LIBCAP_NG.
128 #ifdef HAVE_LIBCAP_NG
132 #undef HAVE_LIBCAP_NG
133 #endif /* HAVE_CAP_NG_H */
134 #endif /* HAVE_LIBCAP_NG */
137 #include <sys/sysctl.h>
138 #endif /* __FreeBSD__ */
140 #include "netdissect-stdinc.h"
141 #include "netdissect.h"
142 #include "interface.h"
143 #include "addrtoname.h"
144 #include "pcap-missing.h"
145 #include "ascii_strcasecmp.h"
149 #include "diag-control.h"
154 #define PATH_MAX 1024
158 #define SIGNAL_REQ_INFO SIGINFO
159 #elif defined(SIGUSR1)
160 #define SIGNAL_REQ_INFO SIGUSR1
164 #define SIGNAL_FLUSH_PCAP SIGUSR2
167 static int Bflag
; /* buffer size */
168 #ifdef HAVE_PCAP_DUMP_FTELL64
169 static int64_t Cflag
; /* rotate dump files after this many bytes */
171 static long Cflag
; /* rotate dump files after this many bytes */
173 static int Cflag_count
; /* Keep track of which file number we're writing */
174 static int Dflag
; /* list available devices and exit */
175 #ifdef HAVE_PCAP_FINDALLDEVS_EX
176 static char *remote_interfaces_source
; /* list available devices from this source and exit */
180 * This is exported because, in some versions of libpcap, if libpcap
181 * is built with optimizer debugging code (which is *NOT* the default
182 * configuration!), the library *imports*(!) a variable named dflag,
183 * under the expectation that tcpdump is exporting it, to govern
184 * how much debugging information to print when optimizing
185 * the generated BPF code.
187 * This is a horrible hack; newer versions of libpcap don't import
188 * dflag but, instead, *if* built with optimizer debugging code,
189 * *export* a routine to set that flag.
192 int dflag
; /* print filter code */
193 static int Gflag
; /* rotate dump files after this many seconds */
194 static int Gflag_count
; /* number of files created with Gflag rotation */
195 static time_t Gflag_time
; /* The last time_t the dump file was rotated. */
196 static int Lflag
; /* list available data link types and exit */
197 static int Iflag
; /* rfmon (monitor) mode */
198 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
199 static int Jflag
; /* list available time stamp types */
200 static int jflag
= -1; /* packet time stamp source */
202 static int lflag
; /* line-buffered output */
203 static int pflag
; /* don't go promiscuous */
204 static int Qflag
= -1; /* restrict captured packet by send/receive direction */
205 static int Uflag
; /* "unbuffered" output of dump files */
206 static int Wflag
; /* recycle output files after this number of files */
207 static int WflagChars
;
208 static char *zflag
= NULL
; /* compress each savefile using a specified command (like gzip or bzip2) */
209 static int timeout
= 1000; /* default timeout = 1000 ms = 1 s */
210 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
211 static int immediate_mode
;
213 static int count_mode
;
214 static u_int packets_skipped
;
216 static int infodelay
;
217 static int infoprint
;
222 static void (*setsignal (int sig
, void (*func
)(int)))(int);
223 static void cleanup(int);
224 static void child_cleanup(int);
225 static void print_version(FILE *);
226 static void print_usage(FILE *);
228 static void print_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
229 static void dump_packet_and_trunc(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
230 static void dump_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
232 #ifdef SIGNAL_REQ_INFO
233 static void requestinfo(int);
236 #ifdef SIGNAL_FLUSH_PCAP
237 static void flushpcap(int);
241 static HANDLE timer_handle
= INVALID_HANDLE_VALUE
;
242 static void CALLBACK
verbose_stats_dump(PVOID param
, BOOLEAN timer_fired
);
244 static void verbose_stats_dump(int sig
);
247 static void info(int);
248 static u_int packets_captured
;
250 static const struct tok status_flags
[] = {
252 { PCAP_IF_UP
, "Up" },
254 #ifdef PCAP_IF_RUNNING
255 { PCAP_IF_RUNNING
, "Running" },
257 { PCAP_IF_LOOPBACK
, "Loopback" },
258 #ifdef PCAP_IF_WIRELESS
259 { PCAP_IF_WIRELESS
, "Wireless" },
265 static pcap_dumper_t
*pdd
= NULL
;
267 static int supports_monitor_mode
;
275 char *CurrentFileName
;
278 netdissect_options
*ndo
;
284 #if defined(HAVE_PCAP_SET_PARSER_DEBUG)
286 * We have pcap_set_parser_debug() in libpcap; declare it (it's not declared
287 * by any libpcap header, because it's a special hack, only available if
288 * libpcap was configured to include it, and only intended for use by
289 * libpcap developers trying to debug the parser for filter expressions).
292 __declspec(dllimport
)
296 void pcap_set_parser_debug(int);
297 #elif defined(HAVE_PCAP_DEBUG) || defined(HAVE_YYDEBUG)
299 * We don't have pcap_set_parser_debug() in libpcap, but we do have
300 * pcap_debug or yydebug. Make a local version of pcap_set_parser_debug()
301 * to set the flag, and define HAVE_PCAP_SET_PARSER_DEBUG.
304 pcap_set_parser_debug(int value
)
306 #ifdef HAVE_PCAP_DEBUG
307 extern int pcap_debug
;
310 #else /* HAVE_PCAP_DEBUG */
314 #endif /* HAVE_PCAP_DEBUG */
317 #define HAVE_PCAP_SET_PARSER_DEBUG
318 #endif // HAVE_PCAP_SET_PARSER_DEBUG, HAVE_PCAP_DEBUG, HAVE_YYDEBUG
320 #if defined(HAVE_PCAP_SET_OPTIMIZER_DEBUG)
322 * We have pcap_set_optimizer_debug() in libpcap; declare it (it's not declared
323 * by any libpcap header, because it's a special hack, only available if
324 * libpcap was configured to include it, and only intended for use by
325 * libpcap developers trying to debug the optimizer for filter expressions).
328 __declspec(dllimport
)
332 void pcap_set_optimizer_debug(int);
333 #endif // HAVE_PCAP_SET_OPTIMIZER_DEBUG
336 exit_tcpdump(const int status
)
343 static void NORETURN
PRINTFLIKE(1, 2)
344 error(FORMAT_STRING(const char *fmt
), ...)
348 (void)fprintf(stderr
, "%s: ", program_name
);
350 (void)vfprintf(stderr
, fmt
, ap
);
355 (void)fputc('\n', stderr
);
357 exit_tcpdump(S_ERR_HOST_PROGRAM
);
362 static void PRINTFLIKE(1, 2)
363 warning(FORMAT_STRING(const char *fmt
), ...)
367 (void)fprintf(stderr
, "%s: WARNING: ", program_name
);
369 (void)vfprintf(stderr
, fmt
, ap
);
374 (void)fputc('\n', stderr
);
378 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
380 show_tstamp_types_and_exit(pcap_t
*pc
, const char *device
)
383 int *tstamp_types
= 0;
384 const char *tstamp_type_name
;
387 n_tstamp_types
= pcap_list_tstamp_types(pc
, &tstamp_types
);
388 if (n_tstamp_types
< 0)
389 error("%s", pcap_geterr(pc
));
391 if (n_tstamp_types
== 0) {
392 fprintf(stderr
, "Time stamp type cannot be set for %s\n",
394 exit_tcpdump(S_SUCCESS
);
396 fprintf(stdout
, "Time stamp types for %s (use option -j to set):\n",
398 for (i
= 0; i
< n_tstamp_types
; i
++) {
399 tstamp_type_name
= pcap_tstamp_type_val_to_name(tstamp_types
[i
]);
400 if (tstamp_type_name
!= NULL
) {
401 (void) fprintf(stdout
, " %s (%s)\n", tstamp_type_name
,
402 pcap_tstamp_type_val_to_description(tstamp_types
[i
]));
404 (void) fprintf(stdout
, " %d\n", tstamp_types
[i
]);
407 pcap_free_tstamp_types(tstamp_types
);
408 exit_tcpdump(S_SUCCESS
);
410 #endif // HAVE_PCAP_SET_TSTAMP_TYPE
413 show_dlts_and_exit(pcap_t
*pc
, const char *device
)
417 const char *dlt_name
;
419 n_dlts
= pcap_list_datalinks(pc
, &dlts
);
421 error("%s", pcap_geterr(pc
));
422 else if (n_dlts
== 0 || !dlts
)
423 error("No data link types.");
426 * If the interface is known to support monitor mode, indicate
427 * whether these are the data link types available when not in
428 * monitor mode, if -I wasn't specified, or when in monitor mode,
429 * when -I was specified (the link-layer types available in
430 * monitor mode might be different from the ones available when
431 * not in monitor mode).
433 (void) fprintf(stdout
, "Data link types for ");
434 if (supports_monitor_mode
)
435 (void) fprintf(stdout
, "%s %s",
437 Iflag
? "when in monitor mode" : "when not in monitor mode");
439 (void) fprintf(stdout
, "%s",
441 (void) fprintf(stdout
, " (use option -y to set):\n");
443 for (i
= 0; i
< n_dlts
; i
++) {
444 dlt_name
= pcap_datalink_val_to_name(dlts
[i
]);
445 if (dlt_name
!= NULL
) {
446 (void) fprintf(stdout
, " %s (%s)", dlt_name
,
447 pcap_datalink_val_to_description(dlts
[i
]));
450 * OK, does tcpdump handle that type?
452 if (!has_printer(dlts
[i
]))
453 (void) fprintf(stdout
, " (printing not supported)");
454 fprintf(stdout
, "\n");
456 (void) fprintf(stdout
, " DLT %d (printing not supported)\n",
460 pcap_free_datalinks(dlts
);
461 exit_tcpdump(S_SUCCESS
);
465 show_devices_and_exit(void)
467 pcap_if_t
*dev
, *devlist
;
468 char ebuf
[PCAP_ERRBUF_SIZE
];
471 if (pcap_findalldevs(&devlist
, ebuf
) < 0)
473 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
474 printf("%d.%s", i
+1, dev
->name
);
475 if (dev
->description
!= NULL
)
476 printf(" (%s)", dev
->description
);
477 if (dev
->flags
!= 0) {
479 printf("%s", bittok2str(status_flags
, "none", dev
->flags
));
480 #ifdef PCAP_IF_WIRELESS
481 if (dev
->flags
& PCAP_IF_WIRELESS
) {
482 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
484 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
485 printf(", Association status unknown");
488 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
489 printf(", Associated");
492 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
493 printf(", Not associated");
496 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
500 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
502 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
503 printf(", Connection status unknown");
506 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
507 printf(", Connected");
510 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
511 printf(", Disconnected");
514 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
518 #endif // PCAP_IF_WIRELESS
523 pcap_freealldevs(devlist
);
524 exit_tcpdump(S_SUCCESS
);
527 #ifdef HAVE_PCAP_FINDALLDEVS_EX
529 show_remote_devices_and_exit(void)
531 pcap_if_t
*dev
, *devlist
;
532 char ebuf
[PCAP_ERRBUF_SIZE
];
535 if (pcap_findalldevs_ex(remote_interfaces_source
, NULL
, &devlist
,
537 if (strcmp(ebuf
, "not supported") == 0) {
539 * macOS 14's pcap_findalldevs_ex(), which is a
540 * stub that always returns -1 with an error
541 * message of "not supported".
543 * In this case, as we passed it an rpcap://
544 * URL, treat that as meaning "remote capture
547 error("Remote capture not supported");
551 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
552 printf("%d.%s", i
+1, dev
->name
);
553 if (dev
->description
!= NULL
)
554 printf(" (%s)", dev
->description
);
556 printf(" [%s]", bittok2str(status_flags
, "none", dev
->flags
));
559 pcap_freealldevs(devlist
);
560 exit_tcpdump(S_SUCCESS
);
562 #endif /* HAVE_PCAP_FINDALLDEVS_EX */
567 * Note that there we use all letters for short options except for g, k,
568 * o, and P, and those are used by other versions of tcpdump, and we should
569 * only use them for the same purposes that the other versions of tcpdump
572 * macOS tcpdump uses -g to force non--v output for IP to be on one
573 * line, making it more "g"repable;
575 * macOS tcpdump uses -k to specify that packet comments in pcapng files
578 * OpenBSD tcpdump uses -o to indicate that OS fingerprinting should be done
579 * for hosts sending TCP SYN packets;
581 * macOS tcpdump uses -P to indicate that -w should write pcapng rather
584 * macOS tcpdump also uses -Q to specify expressions that match packet
585 * metadata, including but not limited to the packet direction.
586 * The expression syntax is different from a simple "in|out|inout",
587 * and those expressions aren't accepted by macOS tcpdump, but the
588 * equivalents would be "in" = "dir=in", "out" = "dir=out", and
589 * "inout" = "dir=in or dir=out", and the parser could conceivably
590 * special-case "in", "out", and "inout" as expressions for backwards
591 * compatibility, so all is not (yet) lost.
595 * Set up flags that might or might not be supported depending on the
596 * version of libpcap we're using.
598 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
600 #define j_FLAG_USAGE " [ -j tstamptype ]"
602 #else /* HAVE_PCAP_SET_TSTAMP_TYPE */
606 #endif /* HAVE_PCAP_SET_TSTAMP_TYPE */
609 #define m_FLAG_USAGE "[ -m module ] ..."
612 #define SHORTOPTS "aAbB:c:C:dDeE:fF:G:hHi:I" j_FLAG J_FLAG "KlLm:M:nNOpqQ:r:s:StT:uUvV:w:W:xXy:Yz:Z:#"
617 * We do not currently have long options corresponding to all short
618 * options; we should probably pick appropriate option names for them.
620 * However, the short options where the number of times the option is
621 * specified matters, such as -v and -d and -t, should probably not
622 * just map to a long option, as saying
624 * tcpdump --verbose --verbose
626 * doesn't make sense; it should be --verbosity={N} or something such
629 * For long options with no corresponding short options, we define values
630 * outside the range of ASCII graphic characters, make that the last
631 * component of the entry for the long option, and have a case for that
632 * option in the switch statement.
634 #define OPTION_VERSION 128
635 #define OPTION_TSTAMP_PRECISION 129
636 #define OPTION_IMMEDIATE_MODE 130
637 #define OPTION_PRINT 131
638 #define OPTION_LIST_REMOTE_INTERFACES 132
639 #define OPTION_TSTAMP_MICRO 133
640 #define OPTION_TSTAMP_NANO 134
641 #define OPTION_FP_TYPE 135
642 #define OPTION_COUNT 136
643 #define OPTION_PRINT_SAMPLING 137
644 #define OPTION_LENGTHS 138
645 #define OPTION_TIME_T_SIZE 139
646 #define OPTION_SKIP 140
648 static const struct option longopts
[] = {
649 { "buffer-size", required_argument
, NULL
, 'B' },
650 { "list-interfaces", no_argument
, NULL
, 'D' },
651 #ifdef HAVE_PCAP_FINDALLDEVS_EX
652 { "list-remote-interfaces", required_argument
, NULL
, OPTION_LIST_REMOTE_INTERFACES
},
654 { "help", no_argument
, NULL
, 'h' },
655 { "interface", required_argument
, NULL
, 'i' },
656 { "monitor-mode", no_argument
, NULL
, 'I' },
657 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
658 { "time-stamp-type", required_argument
, NULL
, 'j' },
659 { "list-time-stamp-types", no_argument
, NULL
, 'J' },
661 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
662 { "micro", no_argument
, NULL
, OPTION_TSTAMP_MICRO
},
663 { "nano", no_argument
, NULL
, OPTION_TSTAMP_NANO
},
664 { "time-stamp-precision", required_argument
, NULL
, OPTION_TSTAMP_PRECISION
},
666 { "dont-verify-checksums", no_argument
, NULL
, 'K' },
667 { "list-data-link-types", no_argument
, NULL
, 'L' },
668 { "no-optimize", no_argument
, NULL
, 'O' },
669 { "no-promiscuous-mode", no_argument
, NULL
, 'p' },
670 { "direction", required_argument
, NULL
, 'Q' },
671 { "snapshot-length", required_argument
, NULL
, 's' },
672 { "absolute-tcp-sequence-numbers", no_argument
, NULL
, 'S' },
673 { "packet-buffered", no_argument
, NULL
, 'U' },
674 { "linktype", required_argument
, NULL
, 'y' },
675 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
676 { "immediate-mode", no_argument
, NULL
, OPTION_IMMEDIATE_MODE
},
678 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
679 { "debug-filter-parser", no_argument
, NULL
, 'Y' },
681 { "relinquish-privileges", required_argument
, NULL
, 'Z' },
682 { "count", no_argument
, NULL
, OPTION_COUNT
},
683 { "fp-type", no_argument
, NULL
, OPTION_FP_TYPE
},
684 { "number", no_argument
, NULL
, '#' },
685 { "print", no_argument
, NULL
, OPTION_PRINT
},
686 { "print-sampling", required_argument
, NULL
, OPTION_PRINT_SAMPLING
},
687 { "lengths", no_argument
, NULL
, OPTION_LENGTHS
},
688 { "time-t-size", no_argument
, NULL
, OPTION_TIME_T_SIZE
},
689 { "skip", required_argument
, NULL
, OPTION_SKIP
},
690 { "version", no_argument
, NULL
, OPTION_VERSION
},
694 #ifdef HAVE_PCAP_FINDALLDEVS_EX
695 #define LIST_REMOTE_INTERFACES_USAGE " [ --list-remote-interfaces remote-source ]"
697 #define LIST_REMOTE_INTERFACES_USAGE
700 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
701 #define IMMEDIATE_MODE_USAGE " [ --immediate-mode ]"
703 #define IMMEDIATE_MODE_USAGE ""
707 /* Drop root privileges and chroot if necessary */
709 droproot(const char *username
, const char *chroot_dir
)
711 struct passwd
*pw
= NULL
;
713 if (chroot_dir
&& !username
)
714 error("Chroot without dropping root is insecure");
716 pw
= getpwnam(username
);
719 if (chroot(chroot_dir
) != 0 || chdir ("/") != 0)
720 error("Couldn't chroot/chdir to '%.64s': %s",
721 chroot_dir
, pcap_strerror(errno
));
723 #ifdef HAVE_LIBCAP_NG
725 int ret
= capng_change_id(pw
->pw_uid
, pw
->pw_gid
, CAPNG_NO_FLAG
);
727 error("capng_change_id(): return %d\n", ret
);
729 fprintf(stderr
, "dropped privs to %s\n", username
);
732 if (initgroups(pw
->pw_name
, pw
->pw_gid
) != 0 ||
733 setgid(pw
->pw_gid
) != 0 || setuid(pw
->pw_uid
) != 0)
734 error("Couldn't change to '%.32s' uid=%lu gid=%lu: %s",
736 (unsigned long)pw
->pw_uid
,
737 (unsigned long)pw
->pw_gid
,
738 pcap_strerror(errno
));
740 fprintf(stderr
, "dropped privs to %s\n", username
);
742 #endif /* HAVE_LIBCAP_NG */
744 error("Couldn't find user '%.32s'", username
);
745 #ifdef HAVE_LIBCAP_NG
746 /* We don't need CAP_SETUID, CAP_SETGID and CAP_SYS_CHROOT anymore. */
750 CAPNG_EFFECTIVE
| CAPNG_PERMITTED
,
756 capng_apply(CAPNG_SELECT_BOTH
);
757 #endif /* HAVE_LIBCAP_NG */
778 MakeFilename(char *buffer
, char *orig_name
, int cnt
, int max_chars
)
780 char *filename
= malloc(PATH_MAX
+ 1);
781 if (filename
== NULL
)
782 error("%s: malloc", __func__
);
783 if (strlen(orig_name
) == 0)
784 error("an empty string is not a valid file name");
786 /* Process with strftime if Gflag is set. */
790 /* Convert Gflag_time to a usable format */
791 if ((local_tm
= localtime(&Gflag_time
)) == NULL
) {
792 error("%s: localtime", __func__
);
795 /* There's no good way to detect an error in strftime since a return
796 * value of 0 isn't necessarily failure; if orig_name is an empty
797 * string, the formatted string will be empty.
799 * However, the C90 standard says that, if there *is* a
800 * buffer overflow, the content of the buffer is undefined,
801 * so we must check for a buffer overflow.
803 * So we check above for an empty orig_name, and only call
804 * strftime() if it's non-empty, in which case the return
805 * value will only be 0 if the formatted date doesn't fit
808 * (We check above because, even if we don't use -G, we
809 * want a better error message than "tcpdump: : No such
810 * file or directory" for this case.)
812 if (strftime(filename
, PATH_MAX
, orig_name
, local_tm
) == 0) {
813 error("%s: strftime", __func__
);
816 strncpy(filename
, orig_name
, PATH_MAX
);
819 if (cnt
== 0 && max_chars
== 0)
820 strncpy(buffer
, filename
, PATH_MAX
+ 1);
822 if (snprintf(buffer
, PATH_MAX
+ 1, "%s%0*d", filename
, max_chars
, cnt
) > PATH_MAX
)
823 /* Report an error if the filename is too large */
824 error("too many output files or filename is too long (> %d)", PATH_MAX
);
829 get_next_file(FILE *VFile
, char *ptr
)
834 ret
= fgets(ptr
, PATH_MAX
, VFile
);
839 if (len
> 0 && ptr
[len
- 1] == '\n')
846 static cap_channel_t
*
849 cap_channel_t
*capcas
, *capdnsloc
;
850 const char *types
[1];
855 error("unable to create casper process");
856 capdnsloc
= cap_service_open(capcas
, "system.dns");
857 /* Casper capability no longer needed. */
859 if (capdnsloc
== NULL
)
860 error("unable to open system.dns service");
861 /* Limit system.dns to reverse DNS lookups. */
863 if (cap_dns_type_limit(capdnsloc
, types
, 1) < 0)
864 error("unable to limit access to system.dns service");
865 families
[0] = AF_INET
;
866 /* Casper is a feature of FreeBSD, which defines AF_INET6. */
867 families
[1] = AF_INET6
;
868 if (cap_dns_family_limit(capdnsloc
, families
, 2) < 0)
869 error("unable to limit access to system.dns service");
873 #endif /* HAVE_CASPER */
875 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
877 tstamp_precision_from_string(const char *precision
)
879 if (strncmp(precision
, "nano", strlen("nano")) == 0)
880 return PCAP_TSTAMP_PRECISION_NANO
;
882 if (strncmp(precision
, "micro", strlen("micro")) == 0)
883 return PCAP_TSTAMP_PRECISION_MICRO
;
889 tstamp_precision_to_string(int precision
)
893 case PCAP_TSTAMP_PRECISION_MICRO
:
896 case PCAP_TSTAMP_PRECISION_NANO
:
903 #endif // HAVE_PCAP_SET_TSTAMP_PRECISION
907 * Ensure that, on a dump file's descriptor, we have all the rights
908 * necessary to make the standard I/O library work with an fdopen()ed
909 * FILE * from that descriptor.
911 * A long time ago in a galaxy far, far away, AT&T decided that, instead
912 * of providing separate APIs for getting and setting the FD_ flags on a
913 * descriptor, getting and setting the O_ flags on a descriptor, and
914 * locking files, they'd throw them all into a kitchen-sink fcntl() call
915 * along the lines of ioctl(), the fact that ioctl() operations are
916 * largely specific to particular character devices but fcntl() operations
917 * are either generic to all descriptors or generic to all descriptors for
918 * regular files notwithstanding.
920 * The Capsicum people decided that fine-grained control of descriptor
921 * operations was required, so that you need to grant permission for
922 * reading, writing, seeking, and fcntl-ing. The latter, courtesy of
923 * AT&T's decision, means that "fcntl-ing" isn't a thing, but a motley
924 * collection of things, so there are *individual* fcntls for which
925 * permission needs to be granted.
927 * The FreeBSD standard I/O people implemented some optimizations that
928 * requires that the standard I/O routines be able to determine whether
929 * the descriptor for the FILE * is open append-only or not; as that
930 * descriptor could have come from an open() rather than an fopen(),
931 * that requires that it be able to do an F_GETFL fcntl() to read
934 * tcpdump uses ftell() to determine how much data has been written
935 * to a file in order to, when used with -C, determine when it's time
936 * to rotate capture files. ftell() therefore needs to do an lseek()
937 * to find out the file offset and must, thanks to the aforementioned
938 * optimization, also know whether the descriptor is open append-only
941 * The net result of all the above is that we need to grant CAP_SEEK,
942 * CAP_WRITE, and CAP_FCNTL with the CAP_FCNTL_GETFL subcapability.
944 * Perhaps this is the universe's way of saying that either
946 * 1) there needs to be an fopenat() call and a pcap_dump_openat() call
947 * using it, so that Capsicum-capable tcpdump wouldn't need to do
952 * 2) there needs to be a cap_fdopen() call in the FreeBSD standard
953 * I/O library that knows what rights are needed by the standard
954 * I/O library, based on the open mode, and assigns them, perhaps
955 * with an additional argument indicating, for example, whether
956 * seeking should be allowed, so that tcpdump doesn't need to know
957 * what the standard I/O library happens to require this week.
960 set_dumper_capsicum_rights(pcap_dumper_t
*p
)
962 int fd
= fileno(pcap_dump_file(p
));
965 cap_rights_init(&rights
, CAP_SEEK
, CAP_WRITE
, CAP_FCNTL
);
966 if (cap_rights_limit(fd
, &rights
) < 0 && errno
!= ENOSYS
) {
967 error("unable to limit dump descriptor");
969 if (cap_fcntls_limit(fd
, CAP_FCNTL_GETFL
) < 0 && errno
!= ENOSYS
) {
970 error("unable to limit dump descriptor fcntls");
973 #endif // HAVE_CAPSICUM
976 * Copy arg vector into a new buffer, concatenating arguments with spaces.
979 copy_argv(char **argv
)
991 len
+= strlen(*p
++) + 1;
993 buf
= (char *)malloc(len
);
995 error("%s: malloc", __func__
);
999 while ((src
= *p
++) != NULL
) {
1000 while ((*dst
++ = *src
++) != '\0')
1010 * On Windows, we need to open the file in binary mode, so that
1011 * we get all the bytes specified by the size we get from "fstat()".
1012 * On UNIX, that's not necessary. O_BINARY is defined on Windows;
1013 * we define it as 0 if it's not defined, so it does nothing.
1020 read_infile(char *fname
)
1027 fd
= open(fname
, O_RDONLY
|O_BINARY
);
1029 error("can't open %s: %s", fname
, pcap_strerror(errno
));
1031 if (our_fstat(fd
, &buf
) < 0)
1032 error("can't stat %s: %s", fname
, pcap_strerror(errno
));
1035 * Reject files whose size doesn't fit into an int; a filter
1036 * *that* large will probably be too big.
1038 if (buf
.st_size
> INT_MAX
)
1039 error("%s is too large", fname
);
1041 cp
= malloc((u_int
)buf
.st_size
+ 1);
1043 error("malloc(%d) for %s: %s", (u_int
)buf
.st_size
+ 1,
1044 fname
, pcap_strerror(errno
));
1045 cc
= read(fd
, cp
, (u_int
)buf
.st_size
);
1047 error("read %s: %s", fname
, pcap_strerror(errno
));
1048 if (cc
!= buf
.st_size
)
1049 error("short read %s (%d != %d)", fname
, (int) cc
,
1053 /* replace "# comment" with spaces */
1054 for (i
= 0; i
< cc
; i
++) {
1056 while (i
< cc
&& cp
[i
] != '\n')
1064 parse_interface_number(const char *device
)
1071 * Search for a colon, terminating any scheme at the beginning
1074 p
= strchr(device
, ':');
1077 * We found it. Is it followed by "//"?
1079 p
++; /* skip the : */
1080 if (strncmp(p
, "//", 2) == 0) {
1082 * Yes. Search for the next /, at the end of the
1083 * authority part of the URL.
1085 p
+= 2; /* skip the // */
1089 * OK, past the / is the path.
1095 devnum
= strtol(device
, &end
, 10);
1096 if (device
!= end
&& *end
== '\0') {
1098 * It's all-numeric, but is it a valid number?
1102 * No, it's not an ordinal.
1104 error("Invalid adapter index %s", device
);
1109 * It's not all-numeric; return -1, so our caller
1117 find_interface_by_number(const char *url
1118 #ifndef HAVE_PCAP_FINDALLDEVS_EX
1123 pcap_if_t
*dev
, *devlist
;
1125 char ebuf
[PCAP_ERRBUF_SIZE
];
1127 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1133 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1135 * Search for a colon, terminating any scheme at the beginning
1138 endp
= strchr(url
, ':');
1141 * We found it. Is it followed by "//"?
1143 endp
++; /* skip the : */
1144 if (strncmp(endp
, "//", 2) == 0) {
1146 * Yes. Search for the next /, at the end of the
1147 * authority part of the URL.
1149 endp
+= 2; /* skip the // */
1150 endp
= strchr(endp
, '/');
1156 * OK, everything from device to endp is a URL to hand
1157 * to pcap_findalldevs_ex().
1159 endp
++; /* Include the trailing / in the URL; pcap_findalldevs_ex() requires it */
1160 host_url
= malloc(endp
- url
+ 1);
1161 if (host_url
== NULL
&& (endp
- url
+ 1) > 0)
1162 error("Invalid allocation for host");
1164 memcpy(host_url
, url
, endp
- url
);
1165 host_url
[endp
- url
] = '\0';
1166 status
= pcap_findalldevs_ex(host_url
, NULL
, &devlist
, ebuf
);
1169 #endif // HAVE_PCAP_FINDALLDEVS_EX
1170 status
= pcap_findalldevs(&devlist
, ebuf
);
1174 * Look for the devnum-th entry in the list of devices (1-based).
1176 for (i
= 0, dev
= devlist
; i
< devnum
-1 && dev
!= NULL
;
1177 i
++, dev
= dev
->next
)
1180 pcap_freealldevs(devlist
);
1181 error("Invalid adapter index %ld: only %ld interfaces found",
1184 device
= strdup(dev
->name
);
1185 pcap_freealldevs(devlist
);
1189 #ifdef HAVE_PCAP_OPEN
1191 * Prefixes for rpcap URLs.
1193 static char rpcap_prefix
[] = "rpcap://";
1194 static char rpcap_ssl_prefix
[] = "rpcaps://";
1198 open_interface(const char *device
, netdissect_options
*ndo
, char *ebuf
)
1204 #ifdef HAVE_PCAP_OPEN
1206 * Is this an rpcap URL?
1208 if (strncmp(device
, rpcap_prefix
, sizeof(rpcap_prefix
) - 1) == 0 ||
1209 strncmp(device
, rpcap_ssl_prefix
, sizeof(rpcap_ssl_prefix
) - 1) == 0) {
1211 * Yes. Open it with pcap_open().
1214 pc
= pcap_open(device
, ndo
->ndo_snaplen
,
1215 pflag
? 0 : PCAP_OPENFLAG_PROMISCUOUS
, timeout
, NULL
,
1219 * macOS 14's pcap_pcap_open(), which is a
1220 * stub that always returns NULL with an error
1221 * message of "not supported".
1223 * In this case, as we passed it an rpcap://
1224 * URL, treat that as meaning "remote capture
1227 if (strcmp(ebuf
, "not supported") == 0)
1228 error("Remote capture not supported");
1231 * If this failed with "No such device" or "The system
1232 * cannot find the device specified", that means
1233 * the interface doesn't exist; return NULL, so that
1234 * the caller can see whether the device name is
1235 * actually an interface index.
1237 if (strstr(ebuf
, "No such device") != NULL
||
1238 strstr(ebuf
, "The system cannot find the device specified") != NULL
)
1243 warning("%s", ebuf
);
1246 #endif /* HAVE_PCAP_OPEN */
1248 pc
= pcap_create(device
, ebuf
);
1251 * If this failed with "No such device", that means
1252 * the interface doesn't exist; return NULL, so that
1253 * the caller can see whether the device name is
1254 * actually an interface index.
1256 if (strstr(ebuf
, "No such device") != NULL
)
1260 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1262 show_tstamp_types_and_exit(pc
, device
);
1264 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
1265 status
= pcap_set_tstamp_precision(pc
, ndo
->ndo_tstamp_precision
);
1267 error("%s: Can't set %ssecond time stamp precision: %s",
1269 tstamp_precision_to_string(ndo
->ndo_tstamp_precision
),
1270 pcap_statustostr(status
));
1273 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
1274 if (immediate_mode
) {
1275 status
= pcap_set_immediate_mode(pc
, 1);
1277 error("%s: Can't set immediate mode: %s",
1278 device
, pcap_statustostr(status
));
1282 * Is this an interface that supports monitor mode?
1284 if (pcap_can_set_rfmon(pc
) == 1)
1285 supports_monitor_mode
= 1;
1287 supports_monitor_mode
= 0;
1288 if (ndo
->ndo_snaplen
!= 0) {
1290 * A snapshot length was explicitly specified;
1293 status
= pcap_set_snaplen(pc
, ndo
->ndo_snaplen
);
1295 error("%s: Can't set snapshot length: %s",
1296 device
, pcap_statustostr(status
));
1298 status
= pcap_set_promisc(pc
, !pflag
);
1300 error("%s: Can't set promiscuous mode: %s",
1301 device
, pcap_statustostr(status
));
1303 status
= pcap_set_rfmon(pc
, 1);
1305 error("%s: Can't set monitor mode: %s",
1306 device
, pcap_statustostr(status
));
1308 status
= pcap_set_timeout(pc
, timeout
);
1310 error("%s: pcap_set_timeout failed: %s",
1311 device
, pcap_statustostr(status
));
1313 status
= pcap_set_buffer_size(pc
, Bflag
);
1315 error("%s: Can't set buffer size: %s",
1316 device
, pcap_statustostr(status
));
1318 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1320 status
= pcap_set_tstamp_type(pc
, jflag
);
1322 error("%s: Can't set time stamp type: %s",
1323 device
, pcap_statustostr(status
));
1324 else if (status
> 0)
1325 warning("When trying to set timestamp type '%s' on %s: %s",
1326 pcap_tstamp_type_val_to_name(jflag
), device
,
1327 pcap_statustostr(status
));
1330 status
= pcap_activate(pc
);
1333 * pcap_activate() failed.
1335 cp
= pcap_geterr(pc
);
1336 if (status
== PCAP_ERROR
)
1338 else if (status
== PCAP_ERROR_NO_SUCH_DEVICE
) {
1340 * Return an error for our caller to handle.
1342 snprintf(ebuf
, PCAP_ERRBUF_SIZE
, "%s: %s\n(%s)",
1343 device
, pcap_statustostr(status
), cp
);
1344 } else if (status
== PCAP_ERROR_PERM_DENIED
&& *cp
!= '\0')
1345 error("%s: %s\n(%s)", device
,
1346 pcap_statustostr(status
), cp
);
1348 else if (status
== PCAP_ERROR_RFMON_NOTSUP
&&
1349 strncmp(device
, "wlan", 4) == 0) {
1350 char parent
[8], newdev
[8];
1352 size_t s
= sizeof(parent
);
1354 snprintf(sysctl
, sizeof(sysctl
),
1355 "net.wlan.%d.%%parent", atoi(device
+ 4));
1356 sysctlbyname(sysctl
, parent
, &s
, NULL
, 0);
1357 strlcpy(newdev
, device
, sizeof(newdev
));
1358 /* Suggest a new wlan device. */
1359 /* FIXME: incrementing the index this way is not going to work well
1360 * when the index is 9 or greater but the only consequence in this
1361 * specific case would be an error message that looks a bit odd.
1363 newdev
[strlen(newdev
)-1]++;
1364 error("%s is not a monitor mode VAP\n"
1365 "To create a new monitor mode VAP use:\n"
1366 " ifconfig %s create wlandev %s wlanmode monitor\n"
1367 "and use %s as the tcpdump interface",
1368 device
, newdev
, parent
, newdev
);
1370 #endif // __FreeBSD__
1372 error("%s: %s", device
,
1373 pcap_statustostr(status
));
1376 } else if (status
> 0) {
1378 * pcap_activate() succeeded, but it's warning us
1379 * of a problem it had.
1381 cp
= pcap_geterr(pc
);
1382 if (status
== PCAP_WARNING
)
1384 else if (status
== PCAP_WARNING_PROMISC_NOTSUP
&&
1386 warning("%s: %s\n(%s)", device
,
1387 pcap_statustostr(status
), cp
);
1389 warning("%s: %s", device
,
1390 pcap_statustostr(status
));
1393 status
= pcap_setdirection(pc
, Qflag
);
1395 error("%s: pcap_setdirection() failed: %s",
1396 device
, pcap_geterr(pc
));
1403 main(int argc
, char **argv
)
1406 bpf_u_int32 localnet
= 0, netmask
= 0;
1407 char *cp
, *infile
, *cmdbuf
, *device
, *RFileName
, *VFileName
, *WFileName
;
1409 pcap_handler callback
;
1411 const char *dlt_name
;
1412 struct bpf_program fcode
;
1414 void (*oldhandler
)(int);
1416 struct dump_info dumpinfo
;
1417 u_char
*pcap_userdata
;
1418 char ebuf
[PCAP_ERRBUF_SIZE
];
1419 char VFileLine
[PATH_MAX
+ 1];
1420 const char *username
= NULL
;
1422 const char *chroot_dir
= NULL
;
1430 #ifdef HAVE_CAPSICUM
1431 cap_rights_t rights
;
1433 #endif /* HAVE_CAPSICUM */
1434 int Oflag
= 1; /* run filter code optimizer */
1436 const char *yflag_dlt_name
= NULL
;
1440 netdissect_options Ndo
;
1441 netdissect_options
*ndo
= &Ndo
;
1445 * We need to look for wpcap.dll in \Windows\System32\Npcap first,
1448 * 1) WinPcap isn't installed and Npcap isn't installed in "WinPcap
1449 * API-compatible Mode", so there's no wpcap.dll in
1450 * \Windows\System32, only in \Windows\System32\Npcap;
1452 * 2) WinPcap is installed and Npcap isn't installed in "WinPcap
1453 * API-compatible Mode", so the wpcap.dll in \Windows\System32
1454 * is a WinPcap DLL, but we'd prefer an Npcap DLL (we should
1455 * work with either one if we're configured against WinPcap,
1456 * and we'll probably require Npcap if we're configured against
1457 * it), and that's in \Windows\System32\Npcap;
1459 * 3) Npcap is installed in "WinPcap API-compatible Mode", so both
1460 * \Windows\System32 and \Windows\System32\Npcap have an Npcap
1463 * Unfortunately, Windows has no notion of an rpath, so we can't
1464 * set the rpath to include \Windows\System32\Npcap at link time;
1465 * what we need to do is to link wpcap as a delay-load DLL and
1466 * add \Windows\System32\Npcap to the DLL search path early in
1467 * main() with a call to SetDllDirectory().
1469 * The same applies to packet.dll.
1471 * We add \Windows\System32\Npcap here.
1473 * See https://npcap.com/guide/npcap-devguide.html#npcap-feature-native-dll-implicitly
1475 WCHAR
*dll_directory
= NULL
;
1476 size_t dll_directory_buf_len
= 0; /* units of bytes */
1477 UINT system_directory_buf_len
= 0; /* units of WCHARs */
1478 UINT system_directory_len
; /* units of WCHARs */
1479 static const WCHAR npcap
[] = L
"\\Npcap";
1482 * Get the system directory path, in UTF-16, into a buffer that's
1483 * large enough for that directory path plus "\Npcap".
1485 * String manipulation in C, plus fetching a variable-length
1486 * string into a buffer whose size is fixed at the time of
1487 * the call, with an oddball return value (see below), is just
1488 * a huge bag of fun.
1490 * And it's even more fun when dealing with UTF-16, so that the
1491 * buffer sizes used in GetSystemDirectoryW() are in different
1492 * units from the buffer sizes used in realloc()! We maintain
1493 * all sizes/length in units of bytes, not WCHARs, so that our
1494 * heads don't explode.
1498 * Try to fetch the system directory.
1500 * GetSystemDirectoryW() expects a buffer size in units
1501 * of WCHARs, not bytes, and returns a directory path
1502 * length in units of WCHARs, not bytes.
1504 * For extra fun, if GetSystemDirectoryW() succeeds,
1505 * the return value is the length of the directory
1506 * path in units of WCHARs, *not* including the
1507 * terminating '\0', but if it fails because the
1508 * path string wouldn't fit, the return value is
1509 * the length of the directory path in units of WCHARs,
1510 * *including* the terminating '\0'.
1512 system_directory_len
= GetSystemDirectoryW(dll_directory
,
1513 system_directory_buf_len
);
1514 if (system_directory_len
== 0)
1515 error("GetSystemDirectoryW() failed");
1518 * Did the directory path fit in the buffer?
1520 * As per the above, this means that the return value
1521 * *plus 1*, so that the terminating '\0' is counted,
1522 * is <= the buffer size.
1524 * (If the directory path, complete with the terminating
1525 * '\0', fits *exactly*, the return value would be the
1526 * size of the buffer minus 1, as it doesn't count the
1527 * terminating '\0', so the test below would succeed.
1529 * If everything *but* the terminating '\0' fits,
1530 * the return value would be the size of the buffer + 1,
1531 * i.e., the size that the string in question would
1534 * The astute reader will note that returning the
1535 * size of the buffer is not one of the two cases
1536 * above, and should never happen.)
1538 if ((system_directory_len
+ 1) <= system_directory_buf_len
) {
1540 * No. We have a buffer that's large enough
1547 * Yes. Grow the buffer.
1549 * The space we'll need in the buffer for the system
1550 * directory, in units of WCHARs, is system_directory_len,
1551 * as that's the length of the system directory path
1552 * including the terminating '\0'.
1554 system_directory_buf_len
= system_directory_len
;
1557 * The size of the DLL directory buffer, in *bytes*, must
1558 * be the number of WCHARs taken by the system directory,
1559 * *minus* the terminating '\0' (as we'll overwrite that
1560 * with the "\" of the "\Npcap" string), multiplied by
1561 * sizeof(WCHAR) to convert it to the number of bytes,
1562 * plus the size of the "\Npcap" string, in bytes (which
1563 * will include the terminating '\0', as that will become
1564 * the DLL path's terminating '\0').
1566 dll_directory_buf_len
=
1567 ((system_directory_len
- 1)*sizeof(WCHAR
)) + sizeof npcap
;
1568 dll_directory
= realloc(dll_directory
, dll_directory_buf_len
);
1569 if (dll_directory
== NULL
)
1570 error("Can't allocate string for Npcap directory");
1576 * Now append \Npcap. We add the length of the system directory path,
1577 * in WCHARs, *not* including the terminating '\0' (which, since
1578 * GetSystemDirectoryW() succeeded, is the return value of
1579 * GetSystemDirectoryW(), as per the above), to the pointer to the
1580 * beginning of the path, to go past the end of the system directory
1581 * to point to the terminating '\0'.
1583 memcpy(dll_directory
+ system_directory_len
, npcap
, sizeof npcap
);
1586 * Now add that as a system DLL directory.
1588 if (!SetDllDirectoryW(dll_directory
))
1589 error("SetDllDirectory failed");
1591 free(dll_directory
);
1595 * Initialize the netdissect code.
1597 if (nd_init(ebuf
, sizeof(ebuf
)) == -1)
1600 memset(ndo
, 0, sizeof(*ndo
));
1601 ndo_set_function_pointers(ndo
);
1611 if ((cp
= strrchr(argv
[0], PATH_SEPARATOR
)) != NULL
)
1612 ndo
->program_name
= program_name
= cp
+ 1;
1614 ndo
->program_name
= program_name
= argv
[0];
1616 #if defined(HAVE_PCAP_WSOCKINIT)
1617 if (pcap_wsockinit() != 0)
1618 error("Attempting to initialize Winsock failed");
1619 #elif defined(HAVE_WSOCKINIT)
1620 if (wsockinit() != 0)
1621 error("Attempting to initialize Winsock failed");
1625 * An explicit tzset() call is usually not needed as it happens
1626 * implicitly the first time we call localtime() or mktime(),
1627 * but in some cases (sandboxing, chroot) this may be too late.
1632 (op
= getopt_long(argc
, argv
, SHORTOPTS
, longopts
, NULL
)) != -1)
1636 /* compatibility for old -a */
1648 Bflag
= atoi(optarg
)*1024;
1650 error("invalid packet buffer size %s", optarg
);
1656 error("invalid packet count %s", optarg
);
1661 #ifdef HAVE_PCAP_DUMP_FTELL64
1662 Cflag
= strtoint64_t(optarg
, &endp
, 10);
1664 Cflag
= strtol(optarg
, &endp
, 10);
1666 if (endp
== optarg
|| errno
!= 0 || Cflag
<= 0)
1667 error("invalid file size %s", optarg
);
1669 if (*endp
== '\0') {
1671 * There's nothing after the file size,
1672 * so the size is in units of 1 MB
1673 * (1,000,000 bytes).
1675 Cflagmult
= 1000000;
1678 * There's something after the file
1681 * If it's a single letter, then:
1683 * if the letter is k or K, the size
1684 * is in units of 1 KiB (1024 bytes);
1686 * if the letter is m or M, the size
1687 * is in units of 1 MiB (1,048,576 bytes);
1689 * if the letter is g or G, the size
1690 * is in units of 1 GiB (1,073,741,824 bytes).
1692 * Otherwise, it's an error.
1703 Cflagmult
= 1024*1024;
1708 Cflagmult
= 1024*1024*1024;
1712 error("invalid file size %s", optarg
);
1716 * OK, there was a letter that we treat
1717 * as a units indication; was there
1718 * anything after it?
1721 if (*endp
!= '\0') {
1723 error("invalid file size %s", optarg
);
1728 * Will multiplying it by multiplier overflow?
1730 #ifdef HAVE_PCAP_DUMP_FTELL64
1731 if (Cflag
> INT64_T_CONSTANT(0x7fffffffffffffff) / Cflagmult
)
1733 if (Cflag
> LONG_MAX
/ Cflagmult
)
1735 error("file size %s is too large", optarg
);
1747 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1748 case OPTION_LIST_REMOTE_INTERFACES
:
1749 remote_interfaces_source
= optarg
;
1762 #ifndef HAVE_LIBCRYPTO
1763 warning("crypto code not compiled in");
1765 ndo
->ndo_espsecret
= optarg
;
1777 Gflag
= atoi(optarg
);
1779 error("invalid number of seconds %s", optarg
);
1781 /* We will create one file initially. */
1784 /* Grab the current time for rotation use. */
1785 if ((Gflag_time
= time(NULL
)) == (time_t)-1) {
1786 error("%s: can't get current time: %s",
1787 __func__
, pcap_strerror(errno
));
1792 print_usage(stdout
);
1793 exit_tcpdump(S_SUCCESS
);
1808 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1810 jflag
= pcap_tstamp_type_name_to_val(optarg
);
1812 error("invalid time stamp type %s", optarg
);
1823 * _IOLBF is the same as _IOFBF in Microsoft's C
1824 * libraries; the only alternative they offer
1827 * XXX - this should really be checking for MSVC++,
1828 * not _WIN32, if, for example, MinGW has its own
1829 * C library that is more UNIX-compatible.
1831 setvbuf(stdout
, NULL
, _IONBF
, 0);
1833 setvbuf(stdout
, NULL
, _IOLBF
, 0);
1843 if (nd_have_smi_support()) {
1844 if (nd_load_smi_module(optarg
, ebuf
, sizeof(ebuf
)) == -1)
1847 (void)fprintf(stderr
, "%s: ignoring option '-m %s' ",
1848 program_name
, optarg
);
1849 (void)fprintf(stderr
, "(no libsmi support)\n");
1854 /* TCP-MD5 shared secret */
1855 #ifndef HAVE_LIBCRYPTO
1856 warning("crypto code not compiled in");
1858 ndo
->ndo_sigsecret
= optarg
;
1879 ++ndo
->ndo_suppress_default_print
;
1883 if (ascii_strcasecmp(optarg
, "in") == 0)
1885 else if (ascii_strcasecmp(optarg
, "out") == 0)
1887 else if (ascii_strcasecmp(optarg
, "inout") == 0)
1888 Qflag
= PCAP_D_INOUT
;
1890 error("unknown capture direction '%s'", optarg
);
1898 ndo
->ndo_snaplen
= (int)strtol(optarg
, &end
, 0);
1899 if (optarg
== end
|| *end
!= '\0'
1900 || ndo
->ndo_snaplen
< 0 || ndo
->ndo_snaplen
> MAXIMUM_SNAPLEN
)
1901 error("invalid snaplen %s (must be >= 0 and <= %d)",
1902 optarg
, MAXIMUM_SNAPLEN
);
1914 if (ascii_strcasecmp(optarg
, "vat") == 0)
1915 ndo
->ndo_packettype
= PT_VAT
;
1916 else if (ascii_strcasecmp(optarg
, "wb") == 0)
1917 ndo
->ndo_packettype
= PT_WB
;
1918 else if (ascii_strcasecmp(optarg
, "rpc") == 0)
1919 ndo
->ndo_packettype
= PT_RPC
;
1920 else if (ascii_strcasecmp(optarg
, "rtp") == 0)
1921 ndo
->ndo_packettype
= PT_RTP
;
1922 else if (ascii_strcasecmp(optarg
, "rtcp") == 0)
1923 ndo
->ndo_packettype
= PT_RTCP
;
1924 else if (ascii_strcasecmp(optarg
, "snmp") == 0)
1925 ndo
->ndo_packettype
= PT_SNMP
;
1926 else if (ascii_strcasecmp(optarg
, "cnfp") == 0)
1927 ndo
->ndo_packettype
= PT_CNFP
;
1928 else if (ascii_strcasecmp(optarg
, "tftp") == 0)
1929 ndo
->ndo_packettype
= PT_TFTP
;
1930 else if (ascii_strcasecmp(optarg
, "aodv") == 0)
1931 ndo
->ndo_packettype
= PT_AODV
;
1932 else if (ascii_strcasecmp(optarg
, "carp") == 0)
1933 ndo
->ndo_packettype
= PT_CARP
;
1934 else if (ascii_strcasecmp(optarg
, "radius") == 0)
1935 ndo
->ndo_packettype
= PT_RADIUS
;
1936 else if (ascii_strcasecmp(optarg
, "zmtp1") == 0)
1937 ndo
->ndo_packettype
= PT_ZMTP1
;
1938 else if (ascii_strcasecmp(optarg
, "vxlan") == 0)
1939 ndo
->ndo_packettype
= PT_VXLAN
;
1940 else if (ascii_strcasecmp(optarg
, "pgm") == 0)
1941 ndo
->ndo_packettype
= PT_PGM
;
1942 else if (ascii_strcasecmp(optarg
, "pgm_zmtp1") == 0)
1943 ndo
->ndo_packettype
= PT_PGM_ZMTP1
;
1944 else if (ascii_strcasecmp(optarg
, "lmp") == 0)
1945 ndo
->ndo_packettype
= PT_LMP
;
1946 else if (ascii_strcasecmp(optarg
, "resp") == 0)
1947 ndo
->ndo_packettype
= PT_RESP
;
1948 else if (ascii_strcasecmp(optarg
, "ptp") == 0)
1949 ndo
->ndo_packettype
= PT_PTP
;
1950 else if (ascii_strcasecmp(optarg
, "someip") == 0)
1951 ndo
->ndo_packettype
= PT_SOMEIP
;
1952 else if (ascii_strcasecmp(optarg
, "domain") == 0)
1953 ndo
->ndo_packettype
= PT_DOMAIN
;
1954 else if (ascii_strcasecmp(optarg
, "quic") == 0)
1955 ndo
->ndo_packettype
= PT_QUIC
;
1957 error("unknown packet type '%s'", optarg
);
1981 Wflag
= atoi(optarg
);
1983 error("invalid number of output files %s", optarg
);
1984 WflagChars
= getWflagChars(Wflag
);
1989 ++ndo
->ndo_suppress_default_print
;
1994 ++ndo
->ndo_suppress_default_print
;
1998 yflag_dlt_name
= optarg
;
2000 pcap_datalink_name_to_val(yflag_dlt_name
);
2002 error("invalid data link type %s", yflag_dlt_name
);
2005 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
2008 /* Undocumented flag */
2009 pcap_set_parser_debug(1);
2022 ndo
->ndo_packet_number
= 1;
2025 case OPTION_LENGTHS
:
2026 ndo
->ndo_lengths
= 1;
2029 case OPTION_TIME_T_SIZE
:
2030 printf("%zu\n", sizeof(time_t) * 8);
2033 case OPTION_VERSION
:
2034 print_version(stdout
);
2035 exit_tcpdump(S_SUCCESS
);
2038 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2039 case OPTION_TSTAMP_PRECISION
:
2040 ndo
->ndo_tstamp_precision
= tstamp_precision_from_string(optarg
);
2041 if (ndo
->ndo_tstamp_precision
< 0)
2042 error("unsupported time stamp precision");
2046 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
2047 case OPTION_IMMEDIATE_MODE
:
2056 case OPTION_PRINT_SAMPLING
:
2059 ndo
->ndo_print_sampling
= atoi(optarg
);
2060 if (ndo
->ndo_print_sampling
<= 0)
2061 error("invalid print sampling %s", optarg
);
2066 packets_skipped
= (u_int
)strtoul(optarg
, &end
, 0);
2067 if (optarg
[0] == '-' || optarg
== end
|| *end
!= '\0' ||
2069 error("invalid packet skipped %s", optarg
);
2072 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2073 case OPTION_TSTAMP_MICRO
:
2074 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_MICRO
;
2077 case OPTION_TSTAMP_NANO
:
2078 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_NANO
;
2082 case OPTION_FP_TYPE
:
2084 * Print out the type of floating-point arithmetic
2085 * we're doing; it's probably IEEE, unless somebody
2086 * tries to run this on a VAX, but the precision
2087 * may differ (e.g., it might be 32-bit, 64-bit,
2090 float_type_check(0x4e93312d);
2098 print_usage(stderr
);
2099 exit_tcpdump(S_ERR_HOST_PROGRAM
);
2104 show_devices_and_exit();
2105 #ifdef HAVE_PCAP_FINDALLDEVS_EX
2106 if (remote_interfaces_source
!= NULL
)
2107 show_remote_devices_and_exit();
2110 switch (ndo
->ndo_tflag
) {
2112 case 0: /* Default */
2113 case 1: /* No time stamp */
2114 case 2: /* Unix timeval style */
2115 case 3: /* Microseconds/nanoseconds since previous packet */
2116 case 4: /* Date + Default */
2117 case 5: /* Microseconds/nanoseconds since first packet */
2120 default: /* Not supported */
2121 error("only -t, -tt, -ttt, -tttt and -ttttt are supported");
2125 if (ndo
->ndo_fflag
!= 0 && (VFileName
!= NULL
|| RFileName
!= NULL
))
2126 error("-f can not be used with -V or -r");
2128 if (VFileName
!= NULL
&& RFileName
!= NULL
)
2129 error("-V and -r are mutually exclusive.");
2132 * If we're printing dissected packets to the standard output,
2133 * and either the standard output is a terminal or we're doing
2134 * "line" buffering, set the capture timeout to .1 second rather
2135 * than 1 second, as the user's probably expecting to see packets
2136 * pop up immediately shortly after they arrive.
2138 * XXX - would there be some value appropriate for all cases,
2139 * based on, say, the buffer size and packet input rate?
2141 if ((WFileName
== NULL
|| print
) && (isatty(1) || lflag
))
2145 /* if run as root, prepare for chrooting */
2146 if (getuid() == 0 || geteuid() == 0) {
2147 /* future extensibility for cmd-line arguments */
2149 chroot_dir
= WITH_CHROOT
;
2154 /* if run as root, prepare for dropping root privileges */
2155 if (getuid() == 0 || geteuid() == 0) {
2156 /* Run with '-Z root' to restore old behaviour */
2158 username
= WITH_USER
;
2159 else if (strcmp(username
, "root") == 0)
2164 if (RFileName
!= NULL
|| VFileName
!= NULL
) {
2166 * If RFileName is non-null, it's the pathname of a
2167 * savefile to read. If VFileName is non-null, it's
2168 * the pathname of a file containing a list of pathnames
2169 * (one per line) of savefiles to read.
2171 * In either case, we're reading a savefile, not doing
2176 * We don't need network access, so relinquish any set-UID
2177 * or set-GID privileges we have (if any).
2179 * We do *not* want set-UID privileges when opening a
2180 * trace file, as that might let the user read other
2181 * people's trace files (especially if we're set-UID
2184 if (setgid(getgid()) != 0 || setuid(getuid()) != 0 )
2185 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2187 if (VFileName
!= NULL
) {
2188 if (VFileName
[0] == '-' && VFileName
[1] == '\0')
2191 VFile
= fopen(VFileName
, "r");
2194 error("Unable to open file: %s\n", pcap_strerror(errno
));
2196 ret
= get_next_file(VFile
, VFileLine
);
2198 error("Nothing in %s\n", VFileName
);
2199 RFileName
= VFileLine
;
2202 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2203 pd
= pcap_open_offline_with_tstamp_precision(RFileName
,
2204 ndo
->ndo_tstamp_precision
, ebuf
);
2206 pd
= pcap_open_offline(RFileName
, ebuf
);
2211 #ifdef HAVE_CAPSICUM
2212 cap_rights_init(&rights
, CAP_READ
);
2213 if (cap_rights_limit(fileno(pcap_file(pd
)), &rights
) < 0 &&
2215 error("unable to limit pcap descriptor");
2218 dlt
= pcap_datalink(pd
);
2219 dlt_name
= pcap_datalink_val_to_name(dlt
);
2220 fprintf(stderr
, "reading from file %s", RFileName
);
2221 if (dlt_name
== NULL
) {
2222 fprintf(stderr
, ", link-type %u", dlt
);
2224 fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2225 pcap_datalink_val_to_description(dlt
));
2227 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2228 #if defined(DLT_LINUX_SLL2) && defined(__linux__)
2229 if (dlt
== DLT_LINUX_SLL2
)
2230 fprintf(stderr
, "Warning: interface names might be incorrect\n");
2232 } else if (dflag
&& !device
) {
2233 int dump_dlt
= DLT_EN10MB
;
2235 * We're dumping the compiled code without an explicit
2236 * device specification. (If a device is specified, we
2237 * definitely want to open it to use the DLT of that device.)
2238 * Either default to DLT_EN10MB with a warning, or use
2239 * the user-specified value if supplied.
2242 * If no snapshot length was specified, or a length of 0 was
2243 * specified, default to 256KB.
2245 if (ndo
->ndo_snaplen
== 0)
2246 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
2248 * If a DLT was specified with the -y flag, use that instead.
2250 if (yflag_dlt
!= -1)
2251 dump_dlt
= yflag_dlt
;
2253 fprintf(stderr
, "Warning: assuming Ethernet\n");
2254 pd
= pcap_open_dead(dump_dlt
, ndo
->ndo_snaplen
);
2257 * We're doing a live capture.
2259 if (device
== NULL
) {
2261 * No interface was specified. Pick one.
2264 * Find the list of interfaces, and pick
2265 * the first interface.
2267 if (pcap_findalldevs(&devlist
, ebuf
) == -1)
2269 if (devlist
== NULL
)
2270 error("no interfaces available for capture");
2271 device
= strdup(devlist
->name
);
2272 pcap_freealldevs(devlist
);
2276 * Try to open the interface with the specified name.
2278 pd
= open_interface(device
, ndo
, ebuf
);
2281 * That failed. If we can get a list of
2282 * interfaces, and the interface name
2283 * is purely numeric, try to use it as
2284 * a 1-based index in the list of
2287 devnum
= parse_interface_number(device
);
2290 * It's not a number; just report
2291 * the open error and fail.
2297 * OK, it's a number; try to find the
2298 * interface with that index, and try
2301 * find_interface_by_number() exits if it
2302 * couldn't be found.
2304 device
= find_interface_by_number(device
, devnum
);
2305 pd
= open_interface(device
, ndo
, ebuf
);
2311 * Let user own process after capture device has
2315 if (setgid(getgid()) != 0 || setuid(getuid()) != 0)
2316 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2319 show_dlts_and_exit(pd
, device
);
2320 if (yflag_dlt
>= 0) {
2321 if (pcap_set_datalink(pd
, yflag_dlt
) < 0)
2322 error("%s", pcap_geterr(pd
));
2323 (void)fprintf(stderr
, "%s: data link type %s\n",
2325 pcap_datalink_val_to_name(yflag_dlt
));
2326 (void)fflush(stderr
);
2328 #if defined(DLT_LINUX_SLL2)
2331 * Attempt to set default linktype to
2332 * DLT_LINUX_SLL2 when capturing on the
2335 * If the attempt fails, just quietly drive
2336 * on; this may be a non-Linux "any" device
2337 * that doesn't support DLT_LINUX_SLL2.
2339 if (strcmp(device
, "any") == 0) {
2340 DIAG_OFF_WARN_UNUSED_RESULT
2341 (void) pcap_set_datalink(pd
, DLT_LINUX_SLL2
);
2342 DIAG_ON_WARN_UNUSED_RESULT
2346 i
= pcap_snapshot(pd
);
2347 if (ndo
->ndo_snaplen
< i
) {
2348 if (ndo
->ndo_snaplen
!= 0)
2349 warning("snaplen raised from %d to %d", ndo
->ndo_snaplen
, i
);
2350 ndo
->ndo_snaplen
= i
;
2351 } else if (ndo
->ndo_snaplen
> i
) {
2352 warning("snaplen lowered from %d to %d", ndo
->ndo_snaplen
, i
);
2353 ndo
->ndo_snaplen
= i
;
2355 if(ndo
->ndo_fflag
!= 0) {
2356 if (pcap_lookupnet(device
, &localnet
, &netmask
, ebuf
) < 0) {
2357 warning("foreign (-f) flag used but: %s", ebuf
);
2363 cmdbuf
= read_infile(infile
);
2365 cmdbuf
= copy_argv(&argv
[optind
]);
2367 #ifdef HAVE_PCAP_SET_OPTIMIZER_DEBUG
2368 pcap_set_optimizer_debug(dflag
);
2370 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2371 error("%s", pcap_geterr(pd
));
2373 bpf_dump(&fcode
, dflag
);
2376 pcap_freecode(&fcode
);
2377 exit_tcpdump(S_SUCCESS
);
2381 if (!ndo
->ndo_nflag
)
2382 capdns
= capdns_setup();
2383 #endif /* HAVE_CASPER */
2385 init_print(ndo
, localnet
, netmask
);
2388 (void)setsignal(SIGPIPE
, cleanup
);
2389 (void)setsignal(SIGTERM
, cleanup
);
2391 (void)setsignal(SIGINT
, cleanup
);
2392 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2393 (void)setsignal(SIGCHLD
, child_cleanup
);
2395 /* Cooperate with nohup(1) */
2398 * In illumos /usr/include/sys/iso/signal_iso.h causes Clang to
2399 * generate a -Wstrict-prototypes warning here, see [1]. The
2400 * __illumos__ macro is available since at least GCC 11 and Clang 13,
2402 * 1: https://www.illumos.org/issues/16344
2403 * 2: https://www.illumos.org/issues/13726
2406 DIAG_OFF_STRICT_PROTOTYPES
2407 #endif /* __illumos__ */
2408 if ((oldhandler
= setsignal(SIGHUP
, cleanup
)) != SIG_DFL
)
2410 DIAG_ON_STRICT_PROTOTYPES
2411 #endif /* __illumos__ */
2412 (void)setsignal(SIGHUP
, oldhandler
);
2417 * If a user name was specified with "-Z", attempt to switch to
2418 * that user's UID. This would probably be used with sudo,
2419 * to allow tcpdump to be run in a special restricted
2420 * account (if you just want to allow users to open capture
2421 * devices, and can't just give users that permission,
2422 * you'd make tcpdump set-UID or set-GID).
2424 * tcpdump doesn't necessarily write only to one savefile;
2425 * the general only way to allow a -Z instance to write to
2426 * savefiles as the user under whose UID it's run, rather
2427 * than as the user specified with -Z, would thus be to switch
2428 * to the original user ID before opening a capture file and
2429 * then switch back to the -Z user ID after opening the savefile.
2430 * Switching to the -Z user ID only after opening the first
2431 * savefile doesn't handle the general case.
2434 if (getuid() == 0 || geteuid() == 0) {
2435 #ifdef HAVE_LIBCAP_NG
2436 /* Initialize capng */
2437 capng_clear(CAPNG_SELECT_BOTH
);
2439 DIAG_OFF_ASSIGN_ENUM
2442 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2449 DIAG_OFF_ASSIGN_ENUM
2452 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2459 DIAG_OFF_ASSIGN_ENUM
2462 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2467 capng_apply(CAPNG_SELECT_BOTH
);
2468 #endif /* HAVE_LIBCAP_NG */
2469 if (username
|| chroot_dir
)
2470 droproot(username
, chroot_dir
);
2475 if (pcap_setfilter(pd
, &fcode
) < 0)
2476 error("%s", pcap_geterr(pd
));
2477 #ifdef HAVE_CAPSICUM
2478 if (RFileName
== NULL
&& VFileName
== NULL
&& pcap_fileno(pd
) != -1) {
2479 static const unsigned long cmds
[] = { BIOCGSTATS
, BIOCROTZBUF
};
2482 * The various libpcap devices use a combination of
2483 * read (bpf), ioctl (bpf, netmap), poll (netmap)
2484 * so we add the relevant access rights.
2486 cap_rights_init(&rights
, CAP_IOCTL
, CAP_READ
, CAP_EVENT
);
2487 if (cap_rights_limit(pcap_fileno(pd
), &rights
) < 0 &&
2489 error("unable to limit pcap descriptor");
2491 if (cap_ioctls_limit(pcap_fileno(pd
), cmds
,
2492 sizeof(cmds
) / sizeof(cmds
[0])) < 0 && errno
!= ENOSYS
) {
2493 error("unable to limit ioctls on pcap descriptor");
2498 /* Do not exceed the default PATH_MAX for files. */
2499 dumpinfo
.CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
2501 if (dumpinfo
.CurrentFileName
== NULL
)
2502 error("malloc of dumpinfo.CurrentFileName");
2504 /* We do not need numbering for dumpfiles if Cflag isn't set. */
2506 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, WflagChars
);
2508 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, 0);
2510 pdd
= pcap_dump_open(pd
, dumpinfo
.CurrentFileName
);
2511 #ifdef HAVE_LIBCAP_NG
2512 /* Give up CAP_DAC_OVERRIDE capability.
2513 * Only allow it to be restored if the -C or -G flag have been
2514 * set since we may need to create more files later on.
2518 (Cflag
|| Gflag
? 0 : CAPNG_PERMITTED
)
2522 capng_apply(CAPNG_SELECT_BOTH
);
2523 #endif /* HAVE_LIBCAP_NG */
2525 error("%s", pcap_geterr(pd
));
2526 #ifdef HAVE_CAPSICUM
2527 set_dumper_capsicum_rights(pdd
);
2529 if (Cflag
!= 0 || Gflag
!= 0) {
2530 #ifdef HAVE_CAPSICUM
2532 * basename() and dirname() may modify their input buffer
2533 * and they do since FreeBSD 12.0, but they didn't before.
2534 * Hence use the return value only, but always assume the
2535 * input buffer has been modified and would need to be
2536 * reset before the next use.
2538 char *WFileName_copy
;
2540 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2541 error("Unable to allocate memory for file %s",
2544 DIAG_OFF_C11_EXTENSIONS
2545 dumpinfo
.WFileName
= strdup(basename(WFileName_copy
));
2546 DIAG_ON_C11_EXTENSIONS
2547 if (dumpinfo
.WFileName
== NULL
) {
2548 error("Unable to allocate memory for file %s",
2551 free(WFileName_copy
);
2553 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2554 error("Unable to allocate memory for file %s",
2557 DIAG_OFF_C11_EXTENSIONS
2558 char *WFileName_dirname
= dirname(WFileName_copy
);
2559 DIAG_ON_C11_EXTENSIONS
2560 dumpinfo
.dirfd
= open(WFileName_dirname
,
2561 O_DIRECTORY
| O_RDONLY
);
2562 if (dumpinfo
.dirfd
< 0) {
2563 error("unable to open directory %s",
2566 free(WFileName_dirname
);
2567 free(WFileName_copy
);
2569 cap_rights_init(&rights
, CAP_CREATE
, CAP_FCNTL
,
2570 CAP_FTRUNCATE
, CAP_LOOKUP
, CAP_SEEK
, CAP_WRITE
);
2571 if (cap_rights_limit(dumpinfo
.dirfd
, &rights
) < 0 &&
2573 error("unable to limit directory rights");
2575 if (cap_fcntls_limit(dumpinfo
.dirfd
, CAP_FCNTL_GETFL
) < 0 &&
2577 error("unable to limit dump descriptor fcntls");
2579 #else /* !HAVE_CAPSICUM */
2580 dumpinfo
.WFileName
= WFileName
;
2582 callback
= dump_packet_and_trunc
;
2585 pcap_userdata
= (u_char
*)&dumpinfo
;
2587 callback
= dump_packet
;
2588 dumpinfo
.WFileName
= WFileName
;
2591 pcap_userdata
= (u_char
*)&dumpinfo
;
2594 dlt
= pcap_datalink(pd
);
2595 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2598 dumpinfo
.ndo
= NULL
;
2601 pcap_dump_flush(pdd
);
2603 dlt
= pcap_datalink(pd
);
2604 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2605 callback
= print_packet
;
2606 pcap_userdata
= (u_char
*)ndo
;
2609 #ifdef SIGNAL_REQ_INFO
2611 * We can't get statistics when reading from a file rather
2612 * than capturing from a device.
2614 if (RFileName
== NULL
)
2615 (void)setsignal(SIGNAL_REQ_INFO
, requestinfo
);
2617 #ifdef SIGNAL_FLUSH_PCAP
2618 (void)setsignal(SIGNAL_FLUSH_PCAP
, flushpcap
);
2621 if (ndo
->ndo_vflag
> 0 && WFileName
&& RFileName
== NULL
&& !print
) {
2623 * When capturing to a file, if "--print" wasn't specified,
2624 *"-v" means tcpdump should, once per second,
2625 * "v"erbosely report the number of packets captured.
2626 * Except when reading from a file, because -r, -w and -v
2627 * together used to make a corner case, in which pcap_loop()
2628 * errored due to EINTR (see GH #155 for details).
2632 * https://blogs.msdn.microsoft.com/oldnewthing/20151230-00/?p=92741
2634 * suggests that this dates back to W2K.
2636 * I don't know what a "long wait" is, but we'll assume
2637 * that printing the stats could be a "long wait".
2639 CreateTimerQueueTimer(&timer_handle
, NULL
,
2640 verbose_stats_dump
, NULL
, 1000, 1000,
2641 WT_EXECUTEDEFAULT
|WT_EXECUTELONGFUNCTION
);
2642 setvbuf(stderr
, NULL
, _IONBF
, 0);
2645 * Assume this is UN*X, and that it has setitimer(); that
2646 * dates back to UNIX 95.
2648 struct itimerval timer
;
2649 (void)setsignal(SIGALRM
, verbose_stats_dump
);
2650 timer
.it_interval
.tv_sec
= 1;
2651 timer
.it_interval
.tv_usec
= 0;
2652 timer
.it_value
.tv_sec
= 1;
2653 timer
.it_value
.tv_usec
= 1;
2654 setitimer(ITIMER_REAL
, &timer
, NULL
);
2658 if (RFileName
== NULL
) {
2660 * Live capture (if -V was specified, we set RFileName
2661 * to a file from the -V file). Print a message to
2662 * the standard error on UN*X.
2664 if (!ndo
->ndo_vflag
&& !WFileName
) {
2665 (void)fprintf(stderr
,
2666 "%s: verbose output suppressed, use -v[v]... for full protocol decode\n",
2669 (void)fprintf(stderr
, "%s: ", program_name
);
2670 dlt
= pcap_datalink(pd
);
2671 dlt_name
= pcap_datalink_val_to_name(dlt
);
2672 (void)fprintf(stderr
, "listening on %s", device
);
2673 if (dlt_name
== NULL
) {
2674 (void)fprintf(stderr
, ", link-type %u", dlt
);
2676 (void)fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2677 pcap_datalink_val_to_description(dlt
));
2679 (void)fprintf(stderr
, ", snapshot length %d bytes\n", ndo
->ndo_snaplen
);
2680 (void)fflush(stderr
);
2683 #ifdef HAVE_CAPSICUM
2684 cansandbox
= (VFileName
== NULL
&& zflag
== NULL
);
2686 cansandbox
= (cansandbox
&& (ndo
->ndo_nflag
|| capdns
!= NULL
));
2688 cansandbox
= (cansandbox
&& ndo
->ndo_nflag
);
2689 #endif /* HAVE_CASPER */
2690 cansandbox
= (cansandbox
&& (pcap_fileno(pd
) != -1 ||
2691 RFileName
!= NULL
));
2693 if (cansandbox
&& cap_enter() < 0 && errno
!= ENOSYS
)
2694 error("unable to enter the capability mode");
2695 #endif /* HAVE_CAPSICUM */
2698 status
= pcap_loop(pd
,
2699 cnt
+ (cnt
== -1 ? 0 : packets_skipped
),
2700 callback
, pcap_userdata
);
2701 if (WFileName
== NULL
) {
2703 * We're printing packets. Flush the printed output,
2704 * so it doesn't get intermingled with error output.
2708 * We got interrupted, so perhaps we didn't
2709 * manage to finish a line we were printing.
2710 * Print an extra newline, just in case.
2714 (void)fflush(stdout
);
2718 * We got interrupted. If we are reading multiple
2719 * files (via -V) set these so that we stop.
2728 (void)fprintf(stderr
, "%s: pcap_loop: %s\n",
2729 program_name
, pcap_geterr(pd
));
2731 if (RFileName
== NULL
) {
2733 * We're doing a live capture. Report the capture
2739 if (VFileName
!= NULL
) {
2740 ret
= get_next_file(VFile
, VFileLine
);
2744 RFileName
= VFileLine
;
2745 pd
= pcap_open_offline(RFileName
, ebuf
);
2748 #ifdef HAVE_CAPSICUM
2749 cap_rights_init(&rights
, CAP_READ
);
2750 if (cap_rights_limit(fileno(pcap_file(pd
)),
2751 &rights
) < 0 && errno
!= ENOSYS
) {
2752 error("unable to limit pcap descriptor");
2755 new_dlt
= pcap_datalink(pd
);
2756 if (new_dlt
!= dlt
) {
2758 * The new file has a different
2759 * link-layer header type from the
2762 if (WFileName
!= NULL
) {
2764 * We're writing raw packets
2765 * that match the filter to
2766 * a pcap file. pcap files
2767 * don't support multiple
2768 * different link-layer
2769 * header types, so we fail
2772 error("%s: new dlt does not match original", RFileName
);
2776 * We're printing the decoded packets;
2777 * switch to the new DLT.
2779 * To do that, we need to change
2780 * the printer, change the DLT name,
2781 * and recompile the filter with
2785 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2786 /* Free the old filter */
2787 pcap_freecode(&fcode
);
2788 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2789 error("%s", pcap_geterr(pd
));
2793 * Set the filter on the new file.
2795 if (pcap_setfilter(pd
, &fcode
) < 0)
2796 error("%s", pcap_geterr(pd
));
2799 * Report the new file.
2801 dlt_name
= pcap_datalink_val_to_name(dlt
);
2802 fprintf(stderr
, "reading from file %s", RFileName
);
2803 if (dlt_name
== NULL
) {
2804 fprintf(stderr
, ", link-type %u", dlt
);
2806 fprintf(stderr
, ", link-type %s (%s)",
2808 pcap_datalink_val_to_description(dlt
));
2810 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2814 while (ret
!= NULL
);
2816 if (count_mode
&& RFileName
!= NULL
)
2817 fprintf(stdout
, "%u packet%s\n", packets_captured
,
2818 PLURAL_SUFFIX(packets_captured
));
2821 pcap_freecode(&fcode
);
2822 exit_tcpdump(status
== -1 ? S_ERR_HOST_PROGRAM
: S_SUCCESS
);
2829 (*setsignal (int sig
, void (*func
)(int)))(int)
2832 return (signal(sig
, func
));
2834 struct sigaction old
, new;
2836 memset(&new, 0, sizeof(new));
2837 new.sa_handler
= func
;
2838 if ((sig
== SIGCHLD
)
2839 # ifdef SIGNAL_REQ_INFO
2840 || (sig
== SIGNAL_REQ_INFO
)
2842 # ifdef SIGNAL_FLUSH_PCAP
2843 || (sig
== SIGNAL_FLUSH_PCAP
)
2846 new.sa_flags
= SA_RESTART
;
2847 if (sigaction(sig
, &new, &old
) < 0)
2848 /* The same workaround as for SIG_DFL above. */
2850 DIAG_OFF_STRICT_PROTOTYPES
2851 #endif /* __illumos__ */
2854 DIAG_ON_STRICT_PROTOTYPES
2855 #endif /* __illumos__ */
2856 return (old
.sa_handler
);
2860 /* make a clean exit on interrupts */
2862 cleanup(int signo _U_
)
2865 if (timer_handle
!= INVALID_HANDLE_VALUE
) {
2866 DeleteTimerQueueTimer(NULL
, timer_handle
, NULL
);
2867 CloseHandle(timer_handle
);
2868 timer_handle
= INVALID_HANDLE_VALUE
;
2871 struct itimerval timer
;
2873 timer
.it_interval
.tv_sec
= 0;
2874 timer
.it_interval
.tv_usec
= 0;
2875 timer
.it_value
.tv_sec
= 0;
2876 timer
.it_value
.tv_usec
= 0;
2877 setitimer(ITIMER_REAL
, &timer
, NULL
);
2881 * We have "pcap_breakloop()"; use it, so that we do as little
2882 * as possible in the signal handler (it's probably not safe
2883 * to do anything with standard I/O streams in a signal handler -
2884 * the ANSI C standard doesn't say it is).
2890 On windows, we do not use a fork, so we do not care less about
2891 waiting a child processes to die
2893 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2895 child_cleanup(int signo _U_
)
2897 while (waitpid(-1, NULL
, WNOHANG
) >= 0);
2899 #endif /* HAVE_FORK && HAVE_VFORK */
2904 struct pcap_stat stats
;
2907 * Older versions of libpcap didn't set ps_ifdrop on some
2908 * platforms; initialize it to 0 to handle that.
2910 stats
.ps_ifdrop
= 0;
2911 if (pcap_stats(pd
, &stats
) < 0) {
2912 (void)fprintf(stderr
, "pcap_stats: %s\n", pcap_geterr(pd
));
2918 fprintf(stderr
, "%s: ", program_name
);
2920 (void)fprintf(stderr
, "%u packet%s captured", packets_captured
,
2921 PLURAL_SUFFIX(packets_captured
));
2923 fputs(", ", stderr
);
2926 (void)fprintf(stderr
, "%u packet%s received by filter", stats
.ps_recv
,
2927 PLURAL_SUFFIX(stats
.ps_recv
));
2929 fputs(", ", stderr
);
2932 (void)fprintf(stderr
, "%u packet%s dropped by kernel", stats
.ps_drop
,
2933 PLURAL_SUFFIX(stats
.ps_drop
));
2934 if (stats
.ps_ifdrop
!= 0) {
2936 fputs(", ", stderr
);
2939 (void)fprintf(stderr
, "%u packet%s dropped by interface\n",
2940 stats
.ps_ifdrop
, PLURAL_SUFFIX(stats
.ps_ifdrop
));
2946 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2948 #define fork_subprocess() fork()
2950 #define fork_subprocess() vfork()
2953 compress_savefile(const char *filename
)
2957 child
= fork_subprocess();
2960 "compress_savefile: fork failed: %s\n",
2961 pcap_strerror(errno
));
2965 /* Parent process. */
2971 * Set to lowest priority so that this doesn't disturb the capture.
2974 setpriority(PRIO_PROCESS
, 0, NZERO
- 1);
2976 setpriority(PRIO_PROCESS
, 0, 19);
2978 if (execlp(zflag
, zflag
, filename
, (char *)NULL
) == -1)
2980 "compress_savefile: execlp(%s, %s) failed: %s\n",
2983 pcap_strerror(errno
));
2985 exit(S_ERR_HOST_PROGRAM
);
2987 _exit(S_ERR_HOST_PROGRAM
);
2990 #else /* HAVE_FORK && HAVE_VFORK */
2992 compress_savefile(const char *filename
)
2995 "compress_savefile failed. Functionality not implemented under your system\n");
2997 #endif /* HAVE_FORK && HAVE_VFORK */
3000 close_old_dump_file(struct dump_info
*dump_info
)
3003 * Close the current file and open a new one.
3005 pcap_dump_close(dump_info
->pdd
);
3008 * Compress the file we just closed, if the user asked for it.
3011 compress_savefile(dump_info
->CurrentFileName
);
3015 open_new_dump_file(struct dump_info
*dump_info
)
3017 #ifdef HAVE_CAPSICUM
3022 #ifdef HAVE_LIBCAP_NG
3023 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3024 capng_apply(CAPNG_SELECT_BOTH
);
3025 #endif /* HAVE_LIBCAP_NG */
3026 #ifdef HAVE_CAPSICUM
3027 fd
= openat(dump_info
->dirfd
, dump_info
->CurrentFileName
,
3028 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3030 error("unable to open file %s", dump_info
->CurrentFileName
);
3032 fp
= fdopen(fd
, "w");
3034 error("unable to fdopen file %s", dump_info
->CurrentFileName
);
3036 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3037 #else /* !HAVE_CAPSICUM */
3038 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3040 #ifdef HAVE_LIBCAP_NG
3041 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3042 capng_apply(CAPNG_SELECT_BOTH
);
3043 #endif /* HAVE_LIBCAP_NG */
3044 if (dump_info
->pdd
== NULL
)
3045 error("%s", pcap_geterr(pd
));
3046 #ifdef HAVE_CAPSICUM
3047 set_dumper_capsicum_rights(dump_info
->pdd
);
3052 dump_packet_and_trunc(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3054 struct dump_info
*dump_info
;
3060 dump_info
= (struct dump_info
*)user
;
3062 if (packets_captured
<= packets_skipped
)
3066 * XXX - this won't force the file to rotate on the specified time
3067 * boundary, but it will rotate on the first packet received after the
3068 * specified Gflag number of seconds. Note: if a Gflag time boundary
3069 * and a Cflag size boundary coincide, the time rotation will occur
3070 * first thereby cancelling the Cflag boundary (since the file should
3074 /* Check if it is time to rotate */
3077 /* Get the current time */
3078 if ((t
= time(NULL
)) == (time_t)-1) {
3079 error("%s: can't get current_time: %s",
3080 __func__
, pcap_strerror(errno
));
3084 /* If the time is greater than the specified window, rotate */
3085 if (t
- Gflag_time
>= Gflag
) {
3086 /* Update the Gflag_time */
3088 /* Update Gflag_count */
3091 close_old_dump_file(dump_info
);
3094 * Check to see if we've exceeded the Wflag (when
3097 if (Cflag
== 0 && Wflag
> 0 && Gflag_count
>= Wflag
) {
3098 (void)fprintf(stderr
, "Maximum file limit reached: %d\n",
3101 exit_tcpdump(S_SUCCESS
);
3104 if (dump_info
->CurrentFileName
!= NULL
)
3105 free(dump_info
->CurrentFileName
);
3106 /* Allocate space for max filename + \0. */
3107 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3108 if (dump_info
->CurrentFileName
== NULL
)
3109 error("dump_packet_and_trunc: malloc");
3111 * Gflag was set otherwise we wouldn't be here. Reset the count
3112 * so multiple files would end with 1,2,3 in the filename.
3113 * The counting is handled with the -C flow after this.
3118 * This is always the first file in the Cflag
3120 * We also don't need numbering if Cflag is not set.
3123 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0,
3126 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0, 0);
3128 open_new_dump_file(dump_info
);
3133 * XXX - this won't prevent capture files from getting
3134 * larger than Cflag - the last packet written to the
3135 * file could put it over Cflag.
3138 #ifdef HAVE_PCAP_DUMP_FTELL64
3139 int64_t size
= pcap_dump_ftell64(dump_info
->pdd
);
3142 * XXX - this only handles a Cflag value > 2^31-1 on
3143 * LP64 platforms; to handle ILP32 (32-bit UN*X and
3144 * Windows) or LLP64 (64-bit Windows) would require
3145 * a version of libpcap with pcap_dump_ftell64().
3147 long size
= pcap_dump_ftell(dump_info
->pdd
);
3151 error("ftell fails on output file");
3153 close_old_dump_file(dump_info
);
3157 if (Cflag_count
>= Wflag
)
3160 if (dump_info
->CurrentFileName
!= NULL
)
3161 free(dump_info
->CurrentFileName
);
3162 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3163 if (dump_info
->CurrentFileName
== NULL
)
3164 error("%s: malloc", __func__
);
3165 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, Cflag_count
, WflagChars
);
3167 open_new_dump_file(dump_info
);
3171 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3173 pcap_dump_flush(dump_info
->pdd
);
3175 if (dump_info
->ndo
!= NULL
)
3176 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3184 dump_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3186 struct dump_info
*dump_info
;
3192 dump_info
= (struct dump_info
*)user
;
3194 if (packets_captured
<= packets_skipped
)
3197 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3199 pcap_dump_flush(dump_info
->pdd
);
3201 if (dump_info
->ndo
!= NULL
)
3202 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3210 print_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3216 if (!count_mode
&& packets_captured
> packets_skipped
)
3217 pretty_print_packet((netdissect_options
*)user
, h
, sp
, packets_captured
);
3224 #ifdef SIGNAL_REQ_INFO
3226 requestinfo(int signo _U_
)
3235 #ifdef SIGNAL_FLUSH_PCAP
3237 flushpcap(int signo _U_
)
3240 pcap_dump_flush(pdd
);
3245 print_packets_captured (void)
3247 static u_int prev_packets_captured
, first
= 1;
3249 if (infodelay
== 0 && (first
|| packets_captured
!= prev_packets_captured
)) {
3250 fprintf(stderr
, "Got %u\r", packets_captured
);
3252 prev_packets_captured
= packets_captured
;
3257 * Called once each second in verbose mode while dumping to file
3260 static void CALLBACK
verbose_stats_dump(PVOID param _U_
,
3261 BOOLEAN timer_fired _U_
)
3263 print_packets_captured();
3266 static void verbose_stats_dump(int sig _U_
)
3268 print_packets_captured();
3272 DIAG_OFF_DEPRECATION
3274 print_version(FILE *f
)
3276 const char *smi_version_string
;
3278 (void)fprintf(f
, "%s version " PACKAGE_VERSION
"\n", program_name
);
3279 (void)fprintf(f
, "%s\n", pcap_lib_version());
3281 #if defined(HAVE_LIBCRYPTO) && defined(SSLEAY_VERSION)
3282 (void)fprintf (f
, "%s\n", SSLeay_version(SSLEAY_VERSION
));
3285 smi_version_string
= nd_smi_version_string();
3286 if (smi_version_string
!= NULL
)
3287 (void)fprintf (f
, "SMI-library: %s\n", smi_version_string
);
3289 #if defined(__SANITIZE_ADDRESS__)
3290 (void)fprintf (f
, "Compiled with AddressSanitizer/GCC.\n");
3291 #elif defined(__has_feature)
3292 # if __has_feature(address_sanitizer)
3293 (void)fprintf (f
, "Compiled with AddressSanitizer/Clang.\n");
3294 # elif __has_feature(memory_sanitizer)
3295 (void)fprintf (f
, "Compiled with MemorySanitizer/Clang.\n");
3297 #endif /* __SANITIZE_ADDRESS__ or __has_feature */
3298 (void)fprintf (f
, "%zu-bit build, %zu-bit time_t\n",
3299 sizeof(void *) * 8, sizeof(time_t) * 8);
3304 print_usage(FILE *f
)
3308 "Usage: %s [-AbdDefhHI" J_FLAG
"KlLnNOpqStuUvxX#] [ -B size ] [ -c count ] [--count]\n", program_name
);
3310 "\t\t[ -C file_size ] [ -E algo:secret ] [ -F file ] [ -G seconds ]\n");
3312 "\t\t[ -i interface ]" IMMEDIATE_MODE_USAGE j_FLAG_USAGE
"\n");
3314 "\t\t[ --lengths ]" LIST_REMOTE_INTERFACES_USAGE
"\n");
3317 "\t\t" m_FLAG_USAGE
"\n");
3320 "\t\t[ -M secret ] [ --number ] [ --print ]\n");
3322 "\t\t[ --print-sampling nth ] [ -Q in|out|inout ] [ -r file ]\n");
3324 "\t\t[ -s snaplen ] [ -T type ] [ --version ]\n");
3326 "\t\t[ -V file ] [ -w file ] [ -W filecount ] [ -y datalinktype ]\n");
3327 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
3329 "\t\t[ --time-stamp-precision precision ] [ --micro ] [ --nano ]\n");
3332 "\t\t[ -z postrotate-command ] [ -Z user ] [ expression ]\n");