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.
41 * Some older versions of Mac OS X ship pcap.h from libpcap 0.6 with a
42 * libpcap based on 0.8. That means it has pcap_findalldevs() but the
43 * header doesn't define pcap_if_t, meaning that we can't actually *use*
46 #ifdef HAVE_PCAP_FINDALLDEVS
47 #ifndef HAVE_PCAP_IF_T
48 #undef HAVE_PCAP_FINDALLDEVS
52 #include "netdissect-stdinc.h"
55 * This must appear after including netdissect-stdinc.h, so that _U_ is
59 static const char copyright
[] _U_
=
60 "@(#) Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000\n\
61 The Regents of the University of California. All rights reserved.\n";
71 #include <openssl/crypto.h>
74 #ifdef HAVE_GETOPT_LONG
77 #include "missing/getopt_long.h"
79 /* Capsicum-specific code requires macros from <net/bpf.h>, which will fail
80 * to compile if <pcap.h> has already been included; including the headers
81 * in the opposite order works fine. For the most part anyway, because in
82 * FreeBSD <pcap/pcap.h> declares bpf_dump() instead of <net/bpf.h>. Thus
83 * interface.h takes care of it later to avoid a compiler warning.
86 #include <sys/capsicum.h>
87 #include <sys/ioccom.h>
91 #include <libcasper.h>
92 #include <casper/cap_dns.h>
94 #endif /* HAVE_CASPER */
95 #endif /* HAVE_CAPSICUM */
98 * We found pcap_open() in the capture library, so we'll be using
99 * the remote capture APIs; define PCAP_REMOTE before we include pcap.h,
100 * so we get those APIs declared, and the types and #defines that they
103 * WinPcap's headers require that PCAP_REMOTE be defined in order to get
104 * remote-capture APIs declared and types and #defines that they use
107 * (Versions of libpcap with those APIs, and thus Npcap, which is based on
108 * those versions of libpcap, don't require it.)
122 #include <sys/time.h>
123 #include <sys/wait.h>
124 #include <sys/resource.h>
130 * Pathname separator.
131 * Use this in pathnames, but do *not* use it in URLs.
134 #define PATH_SEPARATOR '\\'
136 #define PATH_SEPARATOR '/'
139 /* capabilities convenience library */
140 /* If a code depends on HAVE_LIBCAP_NG, it depends also on HAVE_CAP_NG_H.
141 * If HAVE_CAP_NG_H is not defined, undefine HAVE_LIBCAP_NG.
142 * Thus, the later tests are done only on HAVE_LIBCAP_NG.
144 #ifdef HAVE_LIBCAP_NG
148 #undef HAVE_LIBCAP_NG
149 #endif /* HAVE_CAP_NG_H */
150 #endif /* HAVE_LIBCAP_NG */
153 #include <sys/sysctl.h>
154 #endif /* __FreeBSD__ */
156 #include "netdissect-stdinc.h"
157 #include "netdissect.h"
158 #include "interface.h"
159 #include "addrtoname.h"
161 #include "pcap-missing.h"
162 #include "ascii_strcasecmp.h"
166 #include "diag-control.h"
171 #define PATH_MAX 1024
175 #define SIGNAL_REQ_INFO SIGINFO
176 #elif defined(SIGUSR1)
177 #define SIGNAL_REQ_INFO SIGUSR1
180 #if defined(HAVE_PCAP_DUMP_FLUSH) && defined(SIGUSR2)
181 #define SIGNAL_FLUSH_PCAP SIGUSR2
184 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
185 static int Bflag
; /* buffer size */
187 #ifdef HAVE_PCAP_DUMP_FTELL64
188 static int64_t Cflag
; /* rotate dump files after this many bytes */
190 static long Cflag
; /* rotate dump files after this many bytes */
192 static int Cflag_count
; /* Keep track of which file number we're writing */
193 #ifdef HAVE_PCAP_FINDALLDEVS
194 static int Dflag
; /* list available devices and exit */
196 #ifdef HAVE_PCAP_FINDALLDEVS_EX
197 static char *remote_interfaces_source
; /* list available devices from this source and exit */
201 * This is exported because, in some versions of libpcap, if libpcap
202 * is built with optimizer debugging code (which is *NOT* the default
203 * configuration!), the library *imports*(!) a variable named dflag,
204 * under the expectation that tcpdump is exporting it, to govern
205 * how much debugging information to print when optimizing
206 * the generated BPF code.
208 * This is a horrible hack; newer versions of libpcap don't import
209 * dflag but, instead, *if* built with optimizer debugging code,
210 * *export* a routine to set that flag.
213 int dflag
; /* print filter code */
214 static int Gflag
; /* rotate dump files after this many seconds */
215 static int Gflag_count
; /* number of files created with Gflag rotation */
216 static time_t Gflag_time
; /* The last time_t the dump file was rotated. */
217 static int Lflag
; /* list available data link types and exit */
218 static int Iflag
; /* rfmon (monitor) mode */
219 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
220 static int Jflag
; /* list available time stamp types */
221 static int jflag
= -1; /* packet time stamp source */
223 static int lflag
; /* line-buffered output */
224 static int pflag
; /* don't go promiscuous */
225 #ifdef HAVE_PCAP_SETDIRECTION
226 static int Qflag
= -1; /* restrict captured packet by send/receive direction */
228 #ifdef HAVE_PCAP_DUMP_FLUSH
229 static int Uflag
; /* "unbuffered" output of dump files */
231 static int Wflag
; /* recycle output files after this number of files */
232 static int WflagChars
;
233 static char *zflag
= NULL
; /* compress each savefile using a specified command (like gzip or bzip2) */
234 static int timeout
= 1000; /* default timeout = 1000 ms = 1 s */
235 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
236 static int immediate_mode
;
238 static int count_mode
;
240 static int infodelay
;
241 static int infoprint
;
246 static void (*setsignal (int sig
, void (*func
)(int)))(int);
247 static void cleanup(int);
248 static void child_cleanup(int);
249 static void print_version(FILE *);
250 static void print_usage(FILE *);
252 static void print_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
253 static void dump_packet_and_trunc(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
254 static void dump_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
256 #ifdef SIGNAL_REQ_INFO
257 static void requestinfo(int);
260 #ifdef SIGNAL_FLUSH_PCAP
261 static void flushpcap(int);
265 static HANDLE timer_handle
= INVALID_HANDLE_VALUE
;
266 static void CALLBACK
verbose_stats_dump(PVOID param
, BOOLEAN timer_fired
);
268 static void verbose_stats_dump(int sig
);
271 static void info(int);
272 static u_int packets_captured
;
274 #ifdef HAVE_PCAP_FINDALLDEVS
275 static const struct tok status_flags
[] = {
277 { PCAP_IF_UP
, "Up" },
279 #ifdef PCAP_IF_RUNNING
280 { PCAP_IF_RUNNING
, "Running" },
282 { PCAP_IF_LOOPBACK
, "Loopback" },
283 #ifdef PCAP_IF_WIRELESS
284 { PCAP_IF_WIRELESS
, "Wireless" },
291 static pcap_dumper_t
*pdd
= NULL
;
293 static int supports_monitor_mode
;
301 char *CurrentFileName
;
304 netdissect_options
*ndo
;
310 #if defined(HAVE_PCAP_SET_PARSER_DEBUG)
312 * We have pcap_set_parser_debug() in libpcap; declare it (it's not declared
313 * by any libpcap header, because it's a special hack, only available if
314 * libpcap was configured to include it, and only intended for use by
315 * libpcap developers trying to debug the parser for filter expressions).
318 __declspec(dllimport
)
322 void pcap_set_parser_debug(int);
323 #elif defined(HAVE_PCAP_DEBUG) || defined(HAVE_YYDEBUG)
325 * We don't have pcap_set_parser_debug() in libpcap, but we do have
326 * pcap_debug or yydebug. Make a local version of pcap_set_parser_debug()
327 * to set the flag, and define HAVE_PCAP_SET_PARSER_DEBUG.
330 pcap_set_parser_debug(int value
)
332 #ifdef HAVE_PCAP_DEBUG
333 extern int pcap_debug
;
336 #else /* HAVE_PCAP_DEBUG */
340 #endif /* HAVE_PCAP_DEBUG */
343 #define HAVE_PCAP_SET_PARSER_DEBUG
346 #if defined(HAVE_PCAP_SET_OPTIMIZER_DEBUG)
348 * We have pcap_set_optimizer_debug() in libpcap; declare it (it's not declared
349 * by any libpcap header, because it's a special hack, only available if
350 * libpcap was configured to include it, and only intended for use by
351 * libpcap developers trying to debug the optimizer for filter expressions).
354 __declspec(dllimport
)
358 void pcap_set_optimizer_debug(int);
362 exit_tcpdump(const int status
)
369 static void NORETURN
PRINTFLIKE(1, 2)
370 error(FORMAT_STRING(const char *fmt
), ...)
374 (void)fprintf(stderr
, "%s: ", program_name
);
376 (void)vfprintf(stderr
, fmt
, ap
);
381 (void)fputc('\n', stderr
);
383 exit_tcpdump(S_ERR_HOST_PROGRAM
);
388 static void PRINTFLIKE(1, 2)
389 warning(FORMAT_STRING(const char *fmt
), ...)
393 (void)fprintf(stderr
, "%s: WARNING: ", program_name
);
395 (void)vfprintf(stderr
, fmt
, ap
);
400 (void)fputc('\n', stderr
);
404 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
406 show_tstamp_types_and_exit(pcap_t
*pc
, const char *device
)
409 int *tstamp_types
= 0;
410 const char *tstamp_type_name
;
413 n_tstamp_types
= pcap_list_tstamp_types(pc
, &tstamp_types
);
414 if (n_tstamp_types
< 0)
415 error("%s", pcap_geterr(pc
));
417 if (n_tstamp_types
== 0) {
418 fprintf(stderr
, "Time stamp type cannot be set for %s\n",
420 exit_tcpdump(S_SUCCESS
);
422 fprintf(stdout
, "Time stamp types for %s (use option -j to set):\n",
424 for (i
= 0; i
< n_tstamp_types
; i
++) {
425 tstamp_type_name
= pcap_tstamp_type_val_to_name(tstamp_types
[i
]);
426 if (tstamp_type_name
!= NULL
) {
427 (void) fprintf(stdout
, " %s (%s)\n", tstamp_type_name
,
428 pcap_tstamp_type_val_to_description(tstamp_types
[i
]));
430 (void) fprintf(stdout
, " %d\n", tstamp_types
[i
]);
433 pcap_free_tstamp_types(tstamp_types
);
434 exit_tcpdump(S_SUCCESS
);
439 show_dlts_and_exit(pcap_t
*pc
, const char *device
)
443 const char *dlt_name
;
445 n_dlts
= pcap_list_datalinks(pc
, &dlts
);
447 error("%s", pcap_geterr(pc
));
448 else if (n_dlts
== 0 || !dlts
)
449 error("No data link types.");
452 * If the interface is known to support monitor mode, indicate
453 * whether these are the data link types available when not in
454 * monitor mode, if -I wasn't specified, or when in monitor mode,
455 * when -I was specified (the link-layer types available in
456 * monitor mode might be different from the ones available when
457 * not in monitor mode).
459 (void) fprintf(stdout
, "Data link types for ");
460 if (supports_monitor_mode
)
461 (void) fprintf(stdout
, "%s %s",
463 Iflag
? "when in monitor mode" : "when not in monitor mode");
465 (void) fprintf(stdout
, "%s",
467 (void) fprintf(stdout
, " (use option -y to set):\n");
469 for (i
= 0; i
< n_dlts
; i
++) {
470 dlt_name
= pcap_datalink_val_to_name(dlts
[i
]);
471 if (dlt_name
!= NULL
) {
472 (void) fprintf(stdout
, " %s (%s)", dlt_name
,
473 pcap_datalink_val_to_description(dlts
[i
]));
476 * OK, does tcpdump handle that type?
478 if (!has_printer(dlts
[i
]))
479 (void) fprintf(stdout
, " (printing not supported)");
480 fprintf(stdout
, "\n");
482 (void) fprintf(stdout
, " DLT %d (printing not supported)\n",
486 #ifdef HAVE_PCAP_FREE_DATALINKS
487 pcap_free_datalinks(dlts
);
489 exit_tcpdump(S_SUCCESS
);
492 #ifdef HAVE_PCAP_FINDALLDEVS
494 show_devices_and_exit(void)
496 pcap_if_t
*dev
, *devlist
;
497 char ebuf
[PCAP_ERRBUF_SIZE
];
500 if (pcap_findalldevs(&devlist
, ebuf
) < 0)
502 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
503 printf("%d.%s", i
+1, dev
->name
);
504 if (dev
->description
!= NULL
)
505 printf(" (%s)", dev
->description
);
506 if (dev
->flags
!= 0) {
508 printf("%s", bittok2str(status_flags
, "none", dev
->flags
));
509 #ifdef PCAP_IF_WIRELESS
510 if (dev
->flags
& PCAP_IF_WIRELESS
) {
511 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
513 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
514 printf(", Association status unknown");
517 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
518 printf(", Associated");
521 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
522 printf(", Not associated");
525 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
529 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
531 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
532 printf(", Connection status unknown");
535 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
536 printf(", Connected");
539 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
540 printf(", Disconnected");
543 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
552 pcap_freealldevs(devlist
);
553 exit_tcpdump(S_SUCCESS
);
555 #endif /* HAVE_PCAP_FINDALLDEVS */
557 #ifdef HAVE_PCAP_FINDALLDEVS_EX
559 show_remote_devices_and_exit(void)
561 pcap_if_t
*dev
, *devlist
;
562 char ebuf
[PCAP_ERRBUF_SIZE
];
565 if (pcap_findalldevs_ex(remote_interfaces_source
, NULL
, &devlist
,
567 if (strcmp(ebuf
, "not supported") == 0) {
569 * macOS 14's pcap_findalldevs_ex(), which is a
570 * stub that always returns -1 with an error
571 * message of "not supported".
573 * In this case, as we passed it an rpcap://
574 * URL, treat that as meaning "remote capture
577 error("Remote capture not supported");
581 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
582 printf("%d.%s", i
+1, dev
->name
);
583 if (dev
->description
!= NULL
)
584 printf(" (%s)", dev
->description
);
586 printf(" [%s]", bittok2str(status_flags
, "none", dev
->flags
));
589 pcap_freealldevs(devlist
);
590 exit_tcpdump(S_SUCCESS
);
592 #endif /* HAVE_PCAP_FINDALLDEVS */
597 * Note that there we use all letters for short options except for g, k,
598 * o, and P, and those are used by other versions of tcpdump, and we should
599 * only use them for the same purposes that the other versions of tcpdump
602 * macOS tcpdump uses -g to force non--v output for IP to be on one
603 * line, making it more "g"repable;
605 * macOS tcpdump uses -k to specify that packet comments in pcapng files
608 * OpenBSD tcpdump uses -o to indicate that OS fingerprinting should be done
609 * for hosts sending TCP SYN packets;
611 * macOS tcpdump uses -P to indicate that -w should write pcapng rather
614 * macOS tcpdump also uses -Q to specify expressions that match packet
615 * metadata, including but not limited to the packet direction.
616 * The expression syntax is different from a simple "in|out|inout",
617 * and those expressions aren't accepted by macOS tcpdump, but the
618 * equivalents would be "in" = "dir=in", "out" = "dir=out", and
619 * "inout" = "dir=in or dir=out", and the parser could conceivably
620 * special-case "in", "out", and "inout" as expressions for backwards
621 * compatibility, so all is not (yet) lost.
625 * Set up flags that might or might not be supported depending on the
626 * version of libpcap we're using.
628 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
630 #define B_FLAG_USAGE " [ -B size ]"
631 #else /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
634 #endif /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
636 #ifdef HAVE_PCAP_FINDALLDEVS
642 #ifdef HAVE_PCAP_CREATE
644 #else /* HAVE_PCAP_CREATE */
646 #endif /* HAVE_PCAP_CREATE */
648 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
650 #define j_FLAG_USAGE " [ -j tstamptype ]"
652 #else /* PCAP_ERROR_TSTAMP_TYPE_NOTSUP */
656 #endif /* PCAP_ERROR_TSTAMP_TYPE_NOTSUP */
659 #define m_FLAG_USAGE "[ -m module ] ..."
662 #ifdef HAVE_PCAP_SETDIRECTION
664 #define Q_FLAG_USAGE " [ -Q in|out|inout ]"
670 #ifdef HAVE_PCAP_DUMP_FLUSH
676 #define SHORTOPTS "aAb" B_FLAG "c:C:d" D_FLAG "eE:fF:G:hHi:" I_FLAG j_FLAG J_FLAG "KlLm:M:nNOpq" Q_FLAG "r:s:StT:u" U_FLAG "vV:w:W:xXy:Yz:Z:#"
681 * We do not currently have long options corresponding to all short
682 * options; we should probably pick appropriate option names for them.
684 * However, the short options where the number of times the option is
685 * specified matters, such as -v and -d and -t, should probably not
686 * just map to a long option, as saying
688 * tcpdump --verbose --verbose
690 * doesn't make sense; it should be --verbosity={N} or something such
693 * For long options with no corresponding short options, we define values
694 * outside the range of ASCII graphic characters, make that the last
695 * component of the entry for the long option, and have a case for that
696 * option in the switch statement.
698 #define OPTION_VERSION 128
699 #define OPTION_TSTAMP_PRECISION 129
700 #define OPTION_IMMEDIATE_MODE 130
701 #define OPTION_PRINT 131
702 #define OPTION_LIST_REMOTE_INTERFACES 132
703 #define OPTION_TSTAMP_MICRO 133
704 #define OPTION_TSTAMP_NANO 134
705 #define OPTION_FP_TYPE 135
706 #define OPTION_COUNT 136
707 #define OPTION_PRINT_SAMPLING 137
708 #define OPTION_LENGTHS 138
710 static const struct option longopts
[] = {
711 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
712 { "buffer-size", required_argument
, NULL
, 'B' },
714 { "list-interfaces", no_argument
, NULL
, 'D' },
715 #ifdef HAVE_PCAP_FINDALLDEVS_EX
716 { "list-remote-interfaces", required_argument
, NULL
, OPTION_LIST_REMOTE_INTERFACES
},
718 { "help", no_argument
, NULL
, 'h' },
719 { "interface", required_argument
, NULL
, 'i' },
720 #ifdef HAVE_PCAP_CREATE
721 { "monitor-mode", no_argument
, NULL
, 'I' },
723 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
724 { "time-stamp-type", required_argument
, NULL
, 'j' },
725 { "list-time-stamp-types", no_argument
, NULL
, 'J' },
727 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
728 { "micro", no_argument
, NULL
, OPTION_TSTAMP_MICRO
},
729 { "nano", no_argument
, NULL
, OPTION_TSTAMP_NANO
},
730 { "time-stamp-precision", required_argument
, NULL
, OPTION_TSTAMP_PRECISION
},
732 { "dont-verify-checksums", no_argument
, NULL
, 'K' },
733 { "list-data-link-types", no_argument
, NULL
, 'L' },
734 { "no-optimize", no_argument
, NULL
, 'O' },
735 { "no-promiscuous-mode", no_argument
, NULL
, 'p' },
736 #ifdef HAVE_PCAP_SETDIRECTION
737 { "direction", required_argument
, NULL
, 'Q' },
739 { "snapshot-length", required_argument
, NULL
, 's' },
740 { "absolute-tcp-sequence-numbers", no_argument
, NULL
, 'S' },
741 #ifdef HAVE_PCAP_DUMP_FLUSH
742 { "packet-buffered", no_argument
, NULL
, 'U' },
744 { "linktype", required_argument
, NULL
, 'y' },
745 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
746 { "immediate-mode", no_argument
, NULL
, OPTION_IMMEDIATE_MODE
},
748 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
749 { "debug-filter-parser", no_argument
, NULL
, 'Y' },
751 { "relinquish-privileges", required_argument
, NULL
, 'Z' },
752 { "count", no_argument
, NULL
, OPTION_COUNT
},
753 { "fp-type", no_argument
, NULL
, OPTION_FP_TYPE
},
754 { "number", no_argument
, NULL
, '#' },
755 { "print", no_argument
, NULL
, OPTION_PRINT
},
756 { "print-sampling", required_argument
, NULL
, OPTION_PRINT_SAMPLING
},
757 { "lengths", no_argument
, NULL
, OPTION_LENGTHS
},
758 { "version", no_argument
, NULL
, OPTION_VERSION
},
762 #ifdef HAVE_PCAP_FINDALLDEVS_EX
763 #define LIST_REMOTE_INTERFACES_USAGE " [ --list-remote-interfaces remote-source ]"
765 #define LIST_REMOTE_INTERFACES_USAGE
768 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
769 #define IMMEDIATE_MODE_USAGE " [ --immediate-mode ]"
771 #define IMMEDIATE_MODE_USAGE ""
775 /* Drop root privileges and chroot if necessary */
777 droproot(const char *username
, const char *chroot_dir
)
779 struct passwd
*pw
= NULL
;
781 if (chroot_dir
&& !username
)
782 error("Chroot without dropping root is insecure");
784 pw
= getpwnam(username
);
787 if (chroot(chroot_dir
) != 0 || chdir ("/") != 0)
788 error("Couldn't chroot/chdir to '%.64s': %s",
789 chroot_dir
, pcap_strerror(errno
));
791 #ifdef HAVE_LIBCAP_NG
793 int ret
= capng_change_id(pw
->pw_uid
, pw
->pw_gid
, CAPNG_NO_FLAG
);
795 error("capng_change_id(): return %d\n", ret
);
797 fprintf(stderr
, "dropped privs to %s\n", username
);
800 if (initgroups(pw
->pw_name
, pw
->pw_gid
) != 0 ||
801 setgid(pw
->pw_gid
) != 0 || setuid(pw
->pw_uid
) != 0)
802 error("Couldn't change to '%.32s' uid=%lu gid=%lu: %s",
804 (unsigned long)pw
->pw_uid
,
805 (unsigned long)pw
->pw_gid
,
806 pcap_strerror(errno
));
808 fprintf(stderr
, "dropped privs to %s\n", username
);
810 #endif /* HAVE_LIBCAP_NG */
812 error("Couldn't find user '%.32s'", username
);
813 #ifdef HAVE_LIBCAP_NG
814 /* We don't need CAP_SETUID, CAP_SETGID and CAP_SYS_CHROOT anymore. */
818 CAPNG_EFFECTIVE
| CAPNG_PERMITTED
,
824 capng_apply(CAPNG_SELECT_BOTH
);
825 #endif /* HAVE_LIBCAP_NG */
846 MakeFilename(char *buffer
, char *orig_name
, int cnt
, int max_chars
)
848 char *filename
= malloc(PATH_MAX
+ 1);
849 if (filename
== NULL
)
850 error("%s: malloc", __func__
);
851 if (strlen(orig_name
) == 0)
852 error("an empty string is not a valid file name");
854 /* Process with strftime if Gflag is set. */
858 /* Convert Gflag_time to a usable format */
859 if ((local_tm
= localtime(&Gflag_time
)) == NULL
) {
860 error("%s: localtime", __func__
);
863 /* There's no good way to detect an error in strftime since a return
864 * value of 0 isn't necessarily failure; if orig_name is an empty
865 * string, the formatted string will be empty.
867 * However, the C90 standard says that, if there *is* a
868 * buffer overflow, the content of the buffer is undefined,
869 * so we must check for a buffer overflow.
871 * So we check above for an empty orig_name, and only call
872 * strftime() if it's non-empty, in which case the return
873 * value will only be 0 if the formatted date doesn't fit
876 * (We check above because, even if we don't use -G, we
877 * want a better error message than "tcpdump: : No such
878 * file or directory" for this case.)
880 if (strftime(filename
, PATH_MAX
, orig_name
, local_tm
) == 0) {
881 error("%s: strftime", __func__
);
884 strncpy(filename
, orig_name
, PATH_MAX
);
887 if (cnt
== 0 && max_chars
== 0)
888 strncpy(buffer
, filename
, PATH_MAX
+ 1);
890 if (snprintf(buffer
, PATH_MAX
+ 1, "%s%0*d", filename
, max_chars
, cnt
) > PATH_MAX
)
891 /* Report an error if the filename is too large */
892 error("too many output files or filename is too long (> %d)", PATH_MAX
);
897 get_next_file(FILE *VFile
, char *ptr
)
902 ret
= fgets(ptr
, PATH_MAX
, VFile
);
907 if (len
> 0 && ptr
[len
- 1] == '\n')
914 static cap_channel_t
*
917 cap_channel_t
*capcas
, *capdnsloc
;
918 const char *types
[1];
923 error("unable to create casper process");
924 capdnsloc
= cap_service_open(capcas
, "system.dns");
925 /* Casper capability no longer needed. */
927 if (capdnsloc
== NULL
)
928 error("unable to open system.dns service");
929 /* Limit system.dns to reverse DNS lookups. */
931 if (cap_dns_type_limit(capdnsloc
, types
, 1) < 0)
932 error("unable to limit access to system.dns service");
933 families
[0] = AF_INET
;
934 /* Casper is a feature of FreeBSD, which defines AF_INET6. */
935 families
[1] = AF_INET6
;
936 if (cap_dns_family_limit(capdnsloc
, families
, 2) < 0)
937 error("unable to limit access to system.dns service");
941 #endif /* HAVE_CASPER */
943 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
945 tstamp_precision_from_string(const char *precision
)
947 if (strncmp(precision
, "nano", strlen("nano")) == 0)
948 return PCAP_TSTAMP_PRECISION_NANO
;
950 if (strncmp(precision
, "micro", strlen("micro")) == 0)
951 return PCAP_TSTAMP_PRECISION_MICRO
;
957 tstamp_precision_to_string(int precision
)
961 case PCAP_TSTAMP_PRECISION_MICRO
:
964 case PCAP_TSTAMP_PRECISION_NANO
:
975 * Ensure that, on a dump file's descriptor, we have all the rights
976 * necessary to make the standard I/O library work with an fdopen()ed
977 * FILE * from that descriptor.
979 * A long time ago in a galaxy far, far away, AT&T decided that, instead
980 * of providing separate APIs for getting and setting the FD_ flags on a
981 * descriptor, getting and setting the O_ flags on a descriptor, and
982 * locking files, they'd throw them all into a kitchen-sink fcntl() call
983 * along the lines of ioctl(), the fact that ioctl() operations are
984 * largely specific to particular character devices but fcntl() operations
985 * are either generic to all descriptors or generic to all descriptors for
986 * regular files notwithstanding.
988 * The Capsicum people decided that fine-grained control of descriptor
989 * operations was required, so that you need to grant permission for
990 * reading, writing, seeking, and fcntl-ing. The latter, courtesy of
991 * AT&T's decision, means that "fcntl-ing" isn't a thing, but a motley
992 * collection of things, so there are *individual* fcntls for which
993 * permission needs to be granted.
995 * The FreeBSD standard I/O people implemented some optimizations that
996 * requires that the standard I/O routines be able to determine whether
997 * the descriptor for the FILE * is open append-only or not; as that
998 * descriptor could have come from an open() rather than an fopen(),
999 * that requires that it be able to do an F_GETFL fcntl() to read
1002 * tcpdump uses ftell() to determine how much data has been written
1003 * to a file in order to, when used with -C, determine when it's time
1004 * to rotate capture files. ftell() therefore needs to do an lseek()
1005 * to find out the file offset and must, thanks to the aforementioned
1006 * optimization, also know whether the descriptor is open append-only
1009 * The net result of all the above is that we need to grant CAP_SEEK,
1010 * CAP_WRITE, and CAP_FCNTL with the CAP_FCNTL_GETFL subcapability.
1012 * Perhaps this is the universe's way of saying that either
1014 * 1) there needs to be an fopenat() call and a pcap_dump_openat() call
1015 * using it, so that Capsicum-capable tcpdump wouldn't need to do
1020 * 2) there needs to be a cap_fdopen() call in the FreeBSD standard
1021 * I/O library that knows what rights are needed by the standard
1022 * I/O library, based on the open mode, and assigns them, perhaps
1023 * with an additional argument indicating, for example, whether
1024 * seeking should be allowed, so that tcpdump doesn't need to know
1025 * what the standard I/O library happens to require this week.
1028 set_dumper_capsicum_rights(pcap_dumper_t
*p
)
1030 int fd
= fileno(pcap_dump_file(p
));
1031 cap_rights_t rights
;
1033 cap_rights_init(&rights
, CAP_SEEK
, CAP_WRITE
, CAP_FCNTL
);
1034 if (cap_rights_limit(fd
, &rights
) < 0 && errno
!= ENOSYS
) {
1035 error("unable to limit dump descriptor");
1037 if (cap_fcntls_limit(fd
, CAP_FCNTL_GETFL
) < 0 && errno
!= ENOSYS
) {
1038 error("unable to limit dump descriptor fcntls");
1044 * Copy arg vector into a new buffer, concatenating arguments with spaces.
1047 copy_argv(char **argv
)
1059 len
+= strlen(*p
++) + 1;
1061 buf
= (char *)malloc(len
);
1063 error("%s: malloc", __func__
);
1067 while ((src
= *p
++) != NULL
) {
1068 while ((*dst
++ = *src
++) != '\0')
1078 * On Windows, we need to open the file in binary mode, so that
1079 * we get all the bytes specified by the size we get from "fstat()".
1080 * On UNIX, that's not necessary. O_BINARY is defined on Windows;
1081 * we define it as 0 if it's not defined, so it does nothing.
1088 read_infile(char *fname
)
1095 fd
= open(fname
, O_RDONLY
|O_BINARY
);
1097 error("can't open %s: %s", fname
, pcap_strerror(errno
));
1099 if (our_fstat(fd
, &buf
) < 0)
1100 error("can't stat %s: %s", fname
, pcap_strerror(errno
));
1103 * Reject files whose size doesn't fit into an int; a filter
1104 * *that* large will probably be too big.
1106 if (buf
.st_size
> INT_MAX
)
1107 error("%s is too large", fname
);
1109 cp
= malloc((u_int
)buf
.st_size
+ 1);
1111 error("malloc(%d) for %s: %s", (u_int
)buf
.st_size
+ 1,
1112 fname
, pcap_strerror(errno
));
1113 cc
= read(fd
, cp
, (u_int
)buf
.st_size
);
1115 error("read %s: %s", fname
, pcap_strerror(errno
));
1116 if (cc
!= buf
.st_size
)
1117 error("short read %s (%d != %d)", fname
, (int) cc
,
1121 /* replace "# comment" with spaces */
1122 for (i
= 0; i
< cc
; i
++) {
1124 while (i
< cc
&& cp
[i
] != '\n')
1131 #ifdef HAVE_PCAP_FINDALLDEVS
1133 parse_interface_number(const char *device
)
1140 * Search for a colon, terminating any scheme at the beginning
1143 p
= strchr(device
, ':');
1146 * We found it. Is it followed by "//"?
1148 p
++; /* skip the : */
1149 if (strncmp(p
, "//", 2) == 0) {
1151 * Yes. Search for the next /, at the end of the
1152 * authority part of the URL.
1154 p
+= 2; /* skip the // */
1158 * OK, past the / is the path.
1164 devnum
= strtol(device
, &end
, 10);
1165 if (device
!= end
&& *end
== '\0') {
1167 * It's all-numeric, but is it a valid number?
1171 * No, it's not an ordinal.
1173 error("Invalid adapter index");
1178 * It's not all-numeric; return -1, so our caller
1186 find_interface_by_number(const char *url
1187 #ifndef HAVE_PCAP_FINDALLDEVS_EX
1192 pcap_if_t
*dev
, *devlist
;
1194 char ebuf
[PCAP_ERRBUF_SIZE
];
1196 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1202 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1204 * Search for a colon, terminating any scheme at the beginning
1207 endp
= strchr(url
, ':');
1210 * We found it. Is it followed by "//"?
1212 endp
++; /* skip the : */
1213 if (strncmp(endp
, "//", 2) == 0) {
1215 * Yes. Search for the next /, at the end of the
1216 * authority part of the URL.
1218 endp
+= 2; /* skip the // */
1219 endp
= strchr(endp
, '/');
1225 * OK, everything from device to endp is a URL to hand
1226 * to pcap_findalldevs_ex().
1228 endp
++; /* Include the trailing / in the URL; pcap_findalldevs_ex() requires it */
1229 host_url
= malloc(endp
- url
+ 1);
1230 if (host_url
== NULL
&& (endp
- url
+ 1) > 0)
1231 error("Invalid allocation for host");
1233 memcpy(host_url
, url
, endp
- url
);
1234 host_url
[endp
- url
] = '\0';
1235 status
= pcap_findalldevs_ex(host_url
, NULL
, &devlist
, ebuf
);
1239 status
= pcap_findalldevs(&devlist
, ebuf
);
1243 * Look for the devnum-th entry in the list of devices (1-based).
1245 for (i
= 0, dev
= devlist
; i
< devnum
-1 && dev
!= NULL
;
1246 i
++, dev
= dev
->next
)
1249 error("Invalid adapter index");
1250 device
= strdup(dev
->name
);
1251 pcap_freealldevs(devlist
);
1256 #ifdef HAVE_PCAP_OPEN
1258 * Prefixes for rpcap URLs.
1260 static char rpcap_prefix
[] = "rpcap://";
1261 static char rpcap_ssl_prefix
[] = "rpcaps://";
1265 open_interface(const char *device
, netdissect_options
*ndo
, char *ebuf
)
1268 #ifdef HAVE_PCAP_CREATE
1273 #ifdef HAVE_PCAP_OPEN
1275 * Is this an rpcap URL?
1277 if (strncmp(device
, rpcap_prefix
, sizeof(rpcap_prefix
) - 1) == 0 ||
1278 strncmp(device
, rpcap_ssl_prefix
, sizeof(rpcap_ssl_prefix
) - 1) == 0) {
1280 * Yes. Open it with pcap_open().
1283 pc
= pcap_open(device
, ndo
->ndo_snaplen
,
1284 pflag
? 0 : PCAP_OPENFLAG_PROMISCUOUS
, timeout
, NULL
,
1288 * macOS 14's pcap_pcap_open(), which is a
1289 * stub that always returns NULL with an error
1290 * message of "not supported".
1292 * In this case, as we passed it an rpcap://
1293 * URL, treat that as meaning "remote capture
1296 if (strcmp(ebuf
, "not supported") == 0)
1297 error("Remote capture not supported");
1300 * If this failed with "No such device" or "The system
1301 * cannot find the device specified", that means
1302 * the interface doesn't exist; return NULL, so that
1303 * the caller can see whether the device name is
1304 * actually an interface index.
1306 if (strstr(ebuf
, "No such device") != NULL
||
1307 strstr(ebuf
, "The system cannot find the device specified") != NULL
)
1312 warning("%s", ebuf
);
1315 #endif /* HAVE_PCAP_OPEN */
1317 #ifdef HAVE_PCAP_CREATE
1318 pc
= pcap_create(device
, ebuf
);
1321 * If this failed with "No such device", that means
1322 * the interface doesn't exist; return NULL, so that
1323 * the caller can see whether the device name is
1324 * actually an interface index.
1326 if (strstr(ebuf
, "No such device") != NULL
)
1330 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1332 show_tstamp_types_and_exit(pc
, device
);
1334 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
1335 status
= pcap_set_tstamp_precision(pc
, ndo
->ndo_tstamp_precision
);
1337 error("%s: Can't set %ssecond time stamp precision: %s",
1339 tstamp_precision_to_string(ndo
->ndo_tstamp_precision
),
1340 pcap_statustostr(status
));
1343 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
1344 if (immediate_mode
) {
1345 status
= pcap_set_immediate_mode(pc
, 1);
1347 error("%s: Can't set immediate mode: %s",
1348 device
, pcap_statustostr(status
));
1352 * Is this an interface that supports monitor mode?
1354 if (pcap_can_set_rfmon(pc
) == 1)
1355 supports_monitor_mode
= 1;
1357 supports_monitor_mode
= 0;
1358 if (ndo
->ndo_snaplen
!= 0) {
1360 * A snapshot length was explicitly specified;
1363 status
= pcap_set_snaplen(pc
, ndo
->ndo_snaplen
);
1365 error("%s: Can't set snapshot length: %s",
1366 device
, pcap_statustostr(status
));
1368 status
= pcap_set_promisc(pc
, !pflag
);
1370 error("%s: Can't set promiscuous mode: %s",
1371 device
, pcap_statustostr(status
));
1373 status
= pcap_set_rfmon(pc
, 1);
1375 error("%s: Can't set monitor mode: %s",
1376 device
, pcap_statustostr(status
));
1378 status
= pcap_set_timeout(pc
, timeout
);
1380 error("%s: pcap_set_timeout failed: %s",
1381 device
, pcap_statustostr(status
));
1383 status
= pcap_set_buffer_size(pc
, Bflag
);
1385 error("%s: Can't set buffer size: %s",
1386 device
, pcap_statustostr(status
));
1388 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1390 status
= pcap_set_tstamp_type(pc
, jflag
);
1392 error("%s: Can't set time stamp type: %s",
1393 device
, pcap_statustostr(status
));
1394 else if (status
> 0)
1395 warning("When trying to set timestamp type '%s' on %s: %s",
1396 pcap_tstamp_type_val_to_name(jflag
), device
,
1397 pcap_statustostr(status
));
1400 status
= pcap_activate(pc
);
1403 * pcap_activate() failed.
1405 cp
= pcap_geterr(pc
);
1406 if (status
== PCAP_ERROR
)
1408 else if (status
== PCAP_ERROR_NO_SUCH_DEVICE
) {
1410 * Return an error for our caller to handle.
1412 snprintf(ebuf
, PCAP_ERRBUF_SIZE
, "%s: %s\n(%s)",
1413 device
, pcap_statustostr(status
), cp
);
1414 } else if (status
== PCAP_ERROR_PERM_DENIED
&& *cp
!= '\0')
1415 error("%s: %s\n(%s)", device
,
1416 pcap_statustostr(status
), cp
);
1418 else if (status
== PCAP_ERROR_RFMON_NOTSUP
&&
1419 strncmp(device
, "wlan", 4) == 0) {
1420 char parent
[8], newdev
[8];
1422 size_t s
= sizeof(parent
);
1424 snprintf(sysctl
, sizeof(sysctl
),
1425 "net.wlan.%d.%%parent", atoi(device
+ 4));
1426 sysctlbyname(sysctl
, parent
, &s
, NULL
, 0);
1427 strlcpy(newdev
, device
, sizeof(newdev
));
1428 /* Suggest a new wlan device. */
1429 /* FIXME: incrementing the index this way is not going to work well
1430 * when the index is 9 or greater but the only consequence in this
1431 * specific case would be an error message that looks a bit odd.
1433 newdev
[strlen(newdev
)-1]++;
1434 error("%s is not a monitor mode VAP\n"
1435 "To create a new monitor mode VAP use:\n"
1436 " ifconfig %s create wlandev %s wlanmode monitor\n"
1437 "and use %s as the tcpdump interface",
1438 device
, newdev
, parent
, newdev
);
1442 error("%s: %s", device
,
1443 pcap_statustostr(status
));
1446 } else if (status
> 0) {
1448 * pcap_activate() succeeded, but it's warning us
1449 * of a problem it had.
1451 cp
= pcap_geterr(pc
);
1452 if (status
== PCAP_WARNING
)
1454 else if (status
== PCAP_WARNING_PROMISC_NOTSUP
&&
1456 warning("%s: %s\n(%s)", device
,
1457 pcap_statustostr(status
), cp
);
1459 warning("%s: %s", device
,
1460 pcap_statustostr(status
));
1462 #ifdef HAVE_PCAP_SETDIRECTION
1464 status
= pcap_setdirection(pc
, Qflag
);
1466 error("%s: pcap_setdirection() failed: %s",
1467 device
, pcap_geterr(pc
));
1469 #endif /* HAVE_PCAP_SETDIRECTION */
1470 #else /* HAVE_PCAP_CREATE */
1473 * If no snapshot length was specified, or a length of 0 was
1474 * specified, default to 256KB.
1476 if (ndo
->ndo_snaplen
== 0)
1477 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
1478 pc
= pcap_open_live(device
, ndo
->ndo_snaplen
, !pflag
, timeout
, ebuf
);
1481 * If this failed with "No such device", that means
1482 * the interface doesn't exist; return NULL, so that
1483 * the caller can see whether the device name is
1484 * actually an interface index.
1486 if (strstr(ebuf
, "No such device") != NULL
)
1491 warning("%s", ebuf
);
1492 #endif /* HAVE_PCAP_CREATE */
1498 main(int argc
, char **argv
)
1501 bpf_u_int32 localnet
= 0, netmask
= 0;
1502 char *cp
, *infile
, *cmdbuf
, *device
, *RFileName
, *VFileName
, *WFileName
;
1504 pcap_handler callback
;
1506 const char *dlt_name
;
1507 struct bpf_program fcode
;
1509 void (*oldhandler
)(int);
1511 struct dump_info dumpinfo
;
1512 u_char
*pcap_userdata
;
1513 char ebuf
[PCAP_ERRBUF_SIZE
];
1514 char VFileLine
[PATH_MAX
+ 1];
1515 const char *username
= NULL
;
1517 const char *chroot_dir
= NULL
;
1521 #ifdef HAVE_PCAP_FINDALLDEVS
1527 #ifdef HAVE_CAPSICUM
1528 cap_rights_t rights
;
1530 #endif /* HAVE_CAPSICUM */
1531 int Oflag
= 1; /* run filter code optimizer */
1533 const char *yflag_dlt_name
= NULL
;
1537 netdissect_options Ndo
;
1538 netdissect_options
*ndo
= &Ndo
;
1541 * Initialize the netdissect code.
1543 if (nd_init(ebuf
, sizeof(ebuf
)) == -1)
1546 memset(ndo
, 0, sizeof(*ndo
));
1547 ndo_set_function_pointers(ndo
);
1557 if ((cp
= strrchr(argv
[0], PATH_SEPARATOR
)) != NULL
)
1558 ndo
->program_name
= program_name
= cp
+ 1;
1560 ndo
->program_name
= program_name
= argv
[0];
1562 #if defined(HAVE_PCAP_WSOCKINIT)
1563 if (pcap_wsockinit() != 0)
1564 error("Attempting to initialize Winsock failed");
1565 #elif defined(HAVE_WSOCKINIT)
1566 if (wsockinit() != 0)
1567 error("Attempting to initialize Winsock failed");
1571 * On platforms where the CPU doesn't support unaligned loads,
1572 * force unaligned accesses to abort with SIGBUS, rather than
1573 * being fixed up (slowly) by the OS kernel; on those platforms,
1574 * misaligned accesses are bugs, and we want tcpdump to crash so
1575 * that the bugs are reported.
1577 if (abort_on_misalignment(ebuf
, sizeof(ebuf
)) < 0)
1581 * An explicit tzset() call is usually not needed as it happens
1582 * implicitly the first time we call localtime() or mktime(),
1583 * but in some cases (sandboxing, chroot) this may be too late.
1588 (op
= getopt_long(argc
, argv
, SHORTOPTS
, longopts
, NULL
)) != -1)
1592 /* compatibility for old -a */
1603 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
1605 Bflag
= atoi(optarg
)*1024;
1607 error("invalid packet buffer size %s", optarg
);
1609 #endif /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
1614 error("invalid packet count %s", optarg
);
1619 #ifdef HAVE_PCAP_DUMP_FTELL64
1620 Cflag
= strtoint64_t(optarg
, &endp
, 10);
1622 Cflag
= strtol(optarg
, &endp
, 10);
1624 if (endp
== optarg
|| errno
!= 0 || Cflag
<= 0)
1625 error("invalid file size %s", optarg
);
1627 if (*endp
== '\0') {
1629 * There's nothing after the file size,
1630 * so the size is in units of 1 MB
1631 * (1,000,000 bytes).
1633 Cflagmult
= 1000000;
1636 * There's something after the file
1639 * If it's a single letter, then:
1641 * if the letter is k or K, the size
1642 * is in units of 1 KiB (1024 bytes);
1644 * if the letter is m or M, the size
1645 * is in units of 1 MiB (1,048,576 bytes);
1647 * if the letter is g or G, the size
1648 * is in units of 1 GiB (1,073,741,824 bytes).
1650 * Otherwise, it's an error.
1661 Cflagmult
= 1024*1024;
1666 Cflagmult
= 1024*1024*1024;
1670 error("invalid file size %s", optarg
);
1674 * OK, there was a letter that we treat
1675 * as a units indication; was there
1676 * anything after it?
1679 if (*endp
!= '\0') {
1681 error("invalid file size %s", optarg
);
1686 * Will multiplying it by multiplier overflow?
1688 #ifdef HAVE_PCAP_DUMP_FTELL64
1689 if (Cflag
> INT64_T_CONSTANT(0x7fffffffffffffff) / Cflagmult
)
1691 if (Cflag
> LONG_MAX
/ Cflagmult
)
1693 error("file size %s is too large", optarg
);
1701 #ifdef HAVE_PCAP_FINDALLDEVS
1707 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1708 case OPTION_LIST_REMOTE_INTERFACES
:
1709 remote_interfaces_source
= optarg
;
1722 #ifndef HAVE_LIBCRYPTO
1723 warning("crypto code not compiled in");
1725 ndo
->ndo_espsecret
= optarg
;
1737 Gflag
= atoi(optarg
);
1739 error("invalid number of seconds %s", optarg
);
1741 /* We will create one file initially. */
1744 /* Grab the current time for rotation use. */
1745 if ((Gflag_time
= time(NULL
)) == (time_t)-1) {
1746 error("%s: can't get current time: %s",
1747 __func__
, pcap_strerror(errno
));
1752 print_usage(stdout
);
1753 exit_tcpdump(S_SUCCESS
);
1764 #ifdef HAVE_PCAP_CREATE
1768 #endif /* HAVE_PCAP_CREATE */
1770 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1772 jflag
= pcap_tstamp_type_name_to_val(optarg
);
1774 error("invalid time stamp type %s", optarg
);
1785 * _IOLBF is the same as _IOFBF in Microsoft's C
1786 * libraries; the only alternative they offer
1789 * XXX - this should really be checking for MSVC++,
1790 * not _WIN32, if, for example, MinGW has its own
1791 * C library that is more UNIX-compatible.
1793 setvbuf(stdout
, NULL
, _IONBF
, 0);
1795 #ifdef HAVE_SETLINEBUF
1798 setvbuf(stdout
, NULL
, _IOLBF
, 0);
1809 if (nd_have_smi_support()) {
1810 if (nd_load_smi_module(optarg
, ebuf
, sizeof(ebuf
)) == -1)
1813 (void)fprintf(stderr
, "%s: ignoring option '-m %s' ",
1814 program_name
, optarg
);
1815 (void)fprintf(stderr
, "(no libsmi support)\n");
1820 /* TCP-MD5 shared secret */
1821 #ifndef HAVE_LIBCRYPTO
1822 warning("crypto code not compiled in");
1824 ndo
->ndo_sigsecret
= optarg
;
1845 ++ndo
->ndo_suppress_default_print
;
1848 #ifdef HAVE_PCAP_SETDIRECTION
1850 if (ascii_strcasecmp(optarg
, "in") == 0)
1852 else if (ascii_strcasecmp(optarg
, "out") == 0)
1854 else if (ascii_strcasecmp(optarg
, "inout") == 0)
1855 Qflag
= PCAP_D_INOUT
;
1857 error("unknown capture direction '%s'", optarg
);
1859 #endif /* HAVE_PCAP_SETDIRECTION */
1866 ndo
->ndo_snaplen
= (int)strtol(optarg
, &end
, 0);
1867 if (optarg
== end
|| *end
!= '\0'
1868 || ndo
->ndo_snaplen
< 0 || ndo
->ndo_snaplen
> MAXIMUM_SNAPLEN
)
1869 error("invalid snaplen %s (must be >= 0 and <= %d)",
1870 optarg
, MAXIMUM_SNAPLEN
);
1882 if (ascii_strcasecmp(optarg
, "vat") == 0)
1883 ndo
->ndo_packettype
= PT_VAT
;
1884 else if (ascii_strcasecmp(optarg
, "wb") == 0)
1885 ndo
->ndo_packettype
= PT_WB
;
1886 else if (ascii_strcasecmp(optarg
, "rpc") == 0)
1887 ndo
->ndo_packettype
= PT_RPC
;
1888 else if (ascii_strcasecmp(optarg
, "rtp") == 0)
1889 ndo
->ndo_packettype
= PT_RTP
;
1890 else if (ascii_strcasecmp(optarg
, "rtcp") == 0)
1891 ndo
->ndo_packettype
= PT_RTCP
;
1892 else if (ascii_strcasecmp(optarg
, "snmp") == 0)
1893 ndo
->ndo_packettype
= PT_SNMP
;
1894 else if (ascii_strcasecmp(optarg
, "cnfp") == 0)
1895 ndo
->ndo_packettype
= PT_CNFP
;
1896 else if (ascii_strcasecmp(optarg
, "tftp") == 0)
1897 ndo
->ndo_packettype
= PT_TFTP
;
1898 else if (ascii_strcasecmp(optarg
, "aodv") == 0)
1899 ndo
->ndo_packettype
= PT_AODV
;
1900 else if (ascii_strcasecmp(optarg
, "carp") == 0)
1901 ndo
->ndo_packettype
= PT_CARP
;
1902 else if (ascii_strcasecmp(optarg
, "radius") == 0)
1903 ndo
->ndo_packettype
= PT_RADIUS
;
1904 else if (ascii_strcasecmp(optarg
, "zmtp1") == 0)
1905 ndo
->ndo_packettype
= PT_ZMTP1
;
1906 else if (ascii_strcasecmp(optarg
, "vxlan") == 0)
1907 ndo
->ndo_packettype
= PT_VXLAN
;
1908 else if (ascii_strcasecmp(optarg
, "pgm") == 0)
1909 ndo
->ndo_packettype
= PT_PGM
;
1910 else if (ascii_strcasecmp(optarg
, "pgm_zmtp1") == 0)
1911 ndo
->ndo_packettype
= PT_PGM_ZMTP1
;
1912 else if (ascii_strcasecmp(optarg
, "lmp") == 0)
1913 ndo
->ndo_packettype
= PT_LMP
;
1914 else if (ascii_strcasecmp(optarg
, "resp") == 0)
1915 ndo
->ndo_packettype
= PT_RESP
;
1916 else if (ascii_strcasecmp(optarg
, "ptp") == 0)
1917 ndo
->ndo_packettype
= PT_PTP
;
1918 else if (ascii_strcasecmp(optarg
, "someip") == 0)
1919 ndo
->ndo_packettype
= PT_SOMEIP
;
1920 else if (ascii_strcasecmp(optarg
, "domain") == 0)
1921 ndo
->ndo_packettype
= PT_DOMAIN
;
1922 else if (ascii_strcasecmp(optarg
, "quic") == 0)
1923 ndo
->ndo_packettype
= PT_QUIC
;
1925 error("unknown packet type '%s'", optarg
);
1932 #ifdef HAVE_PCAP_DUMP_FLUSH
1951 Wflag
= atoi(optarg
);
1953 error("invalid number of output files %s", optarg
);
1954 WflagChars
= getWflagChars(Wflag
);
1959 ++ndo
->ndo_suppress_default_print
;
1964 ++ndo
->ndo_suppress_default_print
;
1968 yflag_dlt_name
= optarg
;
1970 pcap_datalink_name_to_val(yflag_dlt_name
);
1972 error("invalid data link type %s", yflag_dlt_name
);
1975 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
1978 /* Undocumented flag */
1979 pcap_set_parser_debug(1);
1992 ndo
->ndo_packet_number
= 1;
1995 case OPTION_LENGTHS
:
1996 ndo
->ndo_lengths
= 1;
1999 case OPTION_VERSION
:
2000 print_version(stdout
);
2001 exit_tcpdump(S_SUCCESS
);
2004 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2005 case OPTION_TSTAMP_PRECISION
:
2006 ndo
->ndo_tstamp_precision
= tstamp_precision_from_string(optarg
);
2007 if (ndo
->ndo_tstamp_precision
< 0)
2008 error("unsupported time stamp precision");
2012 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
2013 case OPTION_IMMEDIATE_MODE
:
2022 case OPTION_PRINT_SAMPLING
:
2025 ndo
->ndo_print_sampling
= atoi(optarg
);
2026 if (ndo
->ndo_print_sampling
<= 0)
2027 error("invalid print sampling %s", optarg
);
2030 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2031 case OPTION_TSTAMP_MICRO
:
2032 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_MICRO
;
2035 case OPTION_TSTAMP_NANO
:
2036 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_NANO
;
2040 case OPTION_FP_TYPE
:
2042 * Print out the type of floating-point arithmetic
2043 * we're doing; it's probably IEEE, unless somebody
2044 * tries to run this on a VAX, but the precision
2045 * may differ (e.g., it might be 32-bit, 64-bit,
2048 float_type_check(0x4e93312d);
2056 print_usage(stderr
);
2057 exit_tcpdump(S_ERR_HOST_PROGRAM
);
2061 #ifdef HAVE_PCAP_FINDALLDEVS
2063 show_devices_and_exit();
2065 #ifdef HAVE_PCAP_FINDALLDEVS_EX
2066 if (remote_interfaces_source
!= NULL
)
2067 show_remote_devices_and_exit();
2070 switch (ndo
->ndo_tflag
) {
2072 case 0: /* Default */
2073 case 1: /* No time stamp */
2074 case 2: /* Unix timeval style */
2075 case 3: /* Microseconds/nanoseconds since previous packet */
2076 case 4: /* Date + Default */
2077 case 5: /* Microseconds/nanoseconds since first packet */
2080 default: /* Not supported */
2081 error("only -t, -tt, -ttt, -tttt and -ttttt are supported");
2085 if (ndo
->ndo_fflag
!= 0 && (VFileName
!= NULL
|| RFileName
!= NULL
))
2086 error("-f can not be used with -V or -r");
2088 if (VFileName
!= NULL
&& RFileName
!= NULL
)
2089 error("-V and -r are mutually exclusive.");
2092 * If we're printing dissected packets to the standard output,
2093 * and either the standard output is a terminal or we're doing
2094 * "line" buffering, set the capture timeout to .1 second rather
2095 * than 1 second, as the user's probably expecting to see packets
2096 * pop up immediately shortly after they arrive.
2098 * XXX - would there be some value appropriate for all cases,
2099 * based on, say, the buffer size and packet input rate?
2101 if ((WFileName
== NULL
|| print
) && (isatty(1) || lflag
))
2105 /* if run as root, prepare for chrooting */
2106 if (getuid() == 0 || geteuid() == 0) {
2107 /* future extensibility for cmd-line arguments */
2109 chroot_dir
= WITH_CHROOT
;
2114 /* if run as root, prepare for dropping root privileges */
2115 if (getuid() == 0 || geteuid() == 0) {
2116 /* Run with '-Z root' to restore old behaviour */
2118 username
= WITH_USER
;
2119 else if (strcmp(username
, "root") == 0)
2124 if (RFileName
!= NULL
|| VFileName
!= NULL
) {
2126 * If RFileName is non-null, it's the pathname of a
2127 * savefile to read. If VFileName is non-null, it's
2128 * the pathname of a file containing a list of pathnames
2129 * (one per line) of savefiles to read.
2131 * In either case, we're reading a savefile, not doing
2136 * We don't need network access, so relinquish any set-UID
2137 * or set-GID privileges we have (if any).
2139 * We do *not* want set-UID privileges when opening a
2140 * trace file, as that might let the user read other
2141 * people's trace files (especially if we're set-UID
2144 if (setgid(getgid()) != 0 || setuid(getuid()) != 0 )
2145 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2147 if (VFileName
!= NULL
) {
2148 if (VFileName
[0] == '-' && VFileName
[1] == '\0')
2151 VFile
= fopen(VFileName
, "r");
2154 error("Unable to open file: %s\n", pcap_strerror(errno
));
2156 ret
= get_next_file(VFile
, VFileLine
);
2158 error("Nothing in %s\n", VFileName
);
2159 RFileName
= VFileLine
;
2162 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2163 pd
= pcap_open_offline_with_tstamp_precision(RFileName
,
2164 ndo
->ndo_tstamp_precision
, ebuf
);
2166 pd
= pcap_open_offline(RFileName
, ebuf
);
2171 #ifdef HAVE_CAPSICUM
2172 cap_rights_init(&rights
, CAP_READ
);
2173 if (cap_rights_limit(fileno(pcap_file(pd
)), &rights
) < 0 &&
2175 error("unable to limit pcap descriptor");
2178 dlt
= pcap_datalink(pd
);
2179 dlt_name
= pcap_datalink_val_to_name(dlt
);
2180 fprintf(stderr
, "reading from file %s", RFileName
);
2181 if (dlt_name
== NULL
) {
2182 fprintf(stderr
, ", link-type %u", dlt
);
2184 fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2185 pcap_datalink_val_to_description(dlt
));
2187 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2188 #ifdef DLT_LINUX_SLL2
2189 if (dlt
== DLT_LINUX_SLL2
)
2190 fprintf(stderr
, "Warning: interface names might be incorrect\n");
2192 } else if (dflag
&& !device
) {
2193 int dump_dlt
= DLT_EN10MB
;
2195 * We're dumping the compiled code without an explicit
2196 * device specification. (If a device is specified, we
2197 * definitely want to open it to use the DLT of that device.)
2198 * Either default to DLT_EN10MB with a warning, or use
2199 * the user-specified value if supplied.
2202 * If no snapshot length was specified, or a length of 0 was
2203 * specified, default to 256KB.
2205 if (ndo
->ndo_snaplen
== 0)
2206 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
2208 * If a DLT was specified with the -y flag, use that instead.
2210 if (yflag_dlt
!= -1)
2211 dump_dlt
= yflag_dlt
;
2213 fprintf(stderr
, "Warning: assuming Ethernet\n");
2214 pd
= pcap_open_dead(dump_dlt
, ndo
->ndo_snaplen
);
2217 * We're doing a live capture.
2219 if (device
== NULL
) {
2221 * No interface was specified. Pick one.
2223 #ifdef HAVE_PCAP_FINDALLDEVS
2225 * Find the list of interfaces, and pick
2226 * the first interface.
2228 if (pcap_findalldevs(&devlist
, ebuf
) == -1)
2230 if (devlist
== NULL
)
2231 error("no interfaces available for capture");
2232 device
= strdup(devlist
->name
);
2233 pcap_freealldevs(devlist
);
2234 #else /* HAVE_PCAP_FINDALLDEVS */
2236 * Use whatever interface pcap_lookupdev()
2239 device
= pcap_lookupdev(ebuf
);
2246 * Try to open the interface with the specified name.
2248 pd
= open_interface(device
, ndo
, ebuf
);
2251 * That failed. If we can get a list of
2252 * interfaces, and the interface name
2253 * is purely numeric, try to use it as
2254 * a 1-based index in the list of
2257 #ifdef HAVE_PCAP_FINDALLDEVS
2258 devnum
= parse_interface_number(device
);
2261 * It's not a number; just report
2262 * the open error and fail.
2268 * OK, it's a number; try to find the
2269 * interface with that index, and try
2272 * find_interface_by_number() exits if it
2273 * couldn't be found.
2275 device
= find_interface_by_number(device
, devnum
);
2276 pd
= open_interface(device
, ndo
, ebuf
);
2279 #else /* HAVE_PCAP_FINDALLDEVS */
2281 * We can't get a list of interfaces; just
2285 #endif /* HAVE_PCAP_FINDALLDEVS */
2289 * Let user own process after capture device has
2293 if (setgid(getgid()) != 0 || setuid(getuid()) != 0)
2294 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2296 #if !defined(HAVE_PCAP_CREATE) && defined(_WIN32)
2298 if(pcap_setbuff(pd
, Bflag
)==-1){
2299 error("%s", pcap_geterr(pd
));
2301 #endif /* !defined(HAVE_PCAP_CREATE) && defined(_WIN32) */
2303 show_dlts_and_exit(pd
, device
);
2304 if (yflag_dlt
>= 0) {
2305 #ifdef HAVE_PCAP_SET_DATALINK
2306 if (pcap_set_datalink(pd
, yflag_dlt
) < 0)
2307 error("%s", pcap_geterr(pd
));
2310 * We don't actually support changing the
2311 * data link type, so we only let them
2312 * set it to what it already is.
2314 if (yflag_dlt
!= pcap_datalink(pd
)) {
2315 error("%s is not one of the DLTs supported by this device\n",
2319 (void)fprintf(stderr
, "%s: data link type %s\n",
2321 pcap_datalink_val_to_name(yflag_dlt
));
2322 (void)fflush(stderr
);
2324 #if defined(DLT_LINUX_SLL2) && defined(HAVE_PCAP_SET_DATALINK)
2327 * Attempt to set default linktype to
2328 * DLT_LINUX_SLL2 when capturing on the
2331 * If the attempt fails, just quietly drive
2332 * on; this may be a non-Linux "any" device
2333 * that doesn't support DLT_LINUX_SLL2.
2335 if (strcmp(device
, "any") == 0) {
2336 DIAG_OFF_WARN_UNUSED_RESULT
2337 (void) pcap_set_datalink(pd
, DLT_LINUX_SLL2
);
2338 DIAG_ON_WARN_UNUSED_RESULT
2342 i
= pcap_snapshot(pd
);
2343 if (ndo
->ndo_snaplen
< i
) {
2344 if (ndo
->ndo_snaplen
!= 0)
2345 warning("snaplen raised from %d to %d", ndo
->ndo_snaplen
, i
);
2346 ndo
->ndo_snaplen
= i
;
2347 } else if (ndo
->ndo_snaplen
> i
) {
2348 warning("snaplen lowered from %d to %d", ndo
->ndo_snaplen
, i
);
2349 ndo
->ndo_snaplen
= i
;
2351 if(ndo
->ndo_fflag
!= 0) {
2352 if (pcap_lookupnet(device
, &localnet
, &netmask
, ebuf
) < 0) {
2353 warning("foreign (-f) flag used but: %s", ebuf
);
2359 cmdbuf
= read_infile(infile
);
2361 cmdbuf
= copy_argv(&argv
[optind
]);
2363 #ifdef HAVE_PCAP_SET_OPTIMIZER_DEBUG
2364 pcap_set_optimizer_debug(dflag
);
2366 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2367 error("%s", pcap_geterr(pd
));
2369 bpf_dump(&fcode
, dflag
);
2372 pcap_freecode(&fcode
);
2373 exit_tcpdump(S_SUCCESS
);
2377 if (!ndo
->ndo_nflag
)
2378 capdns
= capdns_setup();
2379 #endif /* HAVE_CASPER */
2381 init_print(ndo
, localnet
, netmask
);
2384 (void)setsignal(SIGPIPE
, cleanup
);
2385 (void)setsignal(SIGTERM
, cleanup
);
2387 (void)setsignal(SIGINT
, cleanup
);
2388 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2389 (void)setsignal(SIGCHLD
, child_cleanup
);
2391 /* Cooperate with nohup(1) */
2393 if ((oldhandler
= setsignal(SIGHUP
, cleanup
)) != SIG_DFL
)
2394 (void)setsignal(SIGHUP
, oldhandler
);
2399 * If a user name was specified with "-Z", attempt to switch to
2400 * that user's UID. This would probably be used with sudo,
2401 * to allow tcpdump to be run in a special restricted
2402 * account (if you just want to allow users to open capture
2403 * devices, and can't just give users that permission,
2404 * you'd make tcpdump set-UID or set-GID).
2406 * tcpdump doesn't necessarily write only to one savefile;
2407 * the general only way to allow a -Z instance to write to
2408 * savefiles as the user under whose UID it's run, rather
2409 * than as the user specified with -Z, would thus be to switch
2410 * to the original user ID before opening a capture file and
2411 * then switch back to the -Z user ID after opening the savefile.
2412 * Switching to the -Z user ID only after opening the first
2413 * savefile doesn't handle the general case.
2416 if (getuid() == 0 || geteuid() == 0) {
2417 #ifdef HAVE_LIBCAP_NG
2418 /* Initialize capng */
2419 capng_clear(CAPNG_SELECT_BOTH
);
2421 DIAG_OFF_ASSIGN_ENUM
2424 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2431 DIAG_OFF_ASSIGN_ENUM
2434 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2441 DIAG_OFF_ASSIGN_ENUM
2444 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2449 capng_apply(CAPNG_SELECT_BOTH
);
2450 #endif /* HAVE_LIBCAP_NG */
2451 if (username
|| chroot_dir
)
2452 droproot(username
, chroot_dir
);
2457 if (pcap_setfilter(pd
, &fcode
) < 0)
2458 error("%s", pcap_geterr(pd
));
2459 #ifdef HAVE_CAPSICUM
2460 if (RFileName
== NULL
&& VFileName
== NULL
&& pcap_fileno(pd
) != -1) {
2461 static const unsigned long cmds
[] = { BIOCGSTATS
, BIOCROTZBUF
};
2464 * The various libpcap devices use a combination of
2465 * read (bpf), ioctl (bpf, netmap), poll (netmap)
2466 * so we add the relevant access rights.
2468 cap_rights_init(&rights
, CAP_IOCTL
, CAP_READ
, CAP_EVENT
);
2469 if (cap_rights_limit(pcap_fileno(pd
), &rights
) < 0 &&
2471 error("unable to limit pcap descriptor");
2473 if (cap_ioctls_limit(pcap_fileno(pd
), cmds
,
2474 sizeof(cmds
) / sizeof(cmds
[0])) < 0 && errno
!= ENOSYS
) {
2475 error("unable to limit ioctls on pcap descriptor");
2480 /* Do not exceed the default PATH_MAX for files. */
2481 dumpinfo
.CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
2483 if (dumpinfo
.CurrentFileName
== NULL
)
2484 error("malloc of dumpinfo.CurrentFileName");
2486 /* We do not need numbering for dumpfiles if Cflag isn't set. */
2488 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, WflagChars
);
2490 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, 0);
2492 pdd
= pcap_dump_open(pd
, dumpinfo
.CurrentFileName
);
2493 #ifdef HAVE_LIBCAP_NG
2494 /* Give up CAP_DAC_OVERRIDE capability.
2495 * Only allow it to be restored if the -C or -G flag have been
2496 * set since we may need to create more files later on.
2500 (Cflag
|| Gflag
? 0 : CAPNG_PERMITTED
)
2504 capng_apply(CAPNG_SELECT_BOTH
);
2505 #endif /* HAVE_LIBCAP_NG */
2507 error("%s", pcap_geterr(pd
));
2508 #ifdef HAVE_CAPSICUM
2509 set_dumper_capsicum_rights(pdd
);
2511 if (Cflag
!= 0 || Gflag
!= 0) {
2512 #ifdef HAVE_CAPSICUM
2514 * basename() and dirname() may modify their input buffer
2515 * and they do since FreeBSD 12.0, but they didn't before.
2516 * Hence use the return value only, but always assume the
2517 * input buffer has been modified and would need to be
2518 * reset before the next use.
2520 char *WFileName_copy
;
2522 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2523 error("Unable to allocate memory for file %s",
2526 DIAG_OFF_C11_EXTENSIONS
2527 dumpinfo
.WFileName
= strdup(basename(WFileName_copy
));
2528 DIAG_ON_C11_EXTENSIONS
2529 if (dumpinfo
.WFileName
== NULL
) {
2530 error("Unable to allocate memory for file %s",
2533 free(WFileName_copy
);
2535 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2536 error("Unable to allocate memory for file %s",
2539 DIAG_OFF_C11_EXTENSIONS
2540 char *WFileName_dirname
= dirname(WFileName_copy
);
2541 DIAG_ON_C11_EXTENSIONS
2542 dumpinfo
.dirfd
= open(WFileName_dirname
,
2543 O_DIRECTORY
| O_RDONLY
);
2544 if (dumpinfo
.dirfd
< 0) {
2545 error("unable to open directory %s",
2548 free(WFileName_dirname
);
2549 free(WFileName_copy
);
2551 cap_rights_init(&rights
, CAP_CREATE
, CAP_FCNTL
,
2552 CAP_FTRUNCATE
, CAP_LOOKUP
, CAP_SEEK
, CAP_WRITE
);
2553 if (cap_rights_limit(dumpinfo
.dirfd
, &rights
) < 0 &&
2555 error("unable to limit directory rights");
2557 if (cap_fcntls_limit(dumpinfo
.dirfd
, CAP_FCNTL_GETFL
) < 0 &&
2559 error("unable to limit dump descriptor fcntls");
2561 #else /* !HAVE_CAPSICUM */
2562 dumpinfo
.WFileName
= WFileName
;
2564 callback
= dump_packet_and_trunc
;
2567 pcap_userdata
= (u_char
*)&dumpinfo
;
2569 callback
= dump_packet
;
2570 dumpinfo
.WFileName
= WFileName
;
2573 pcap_userdata
= (u_char
*)&dumpinfo
;
2576 dlt
= pcap_datalink(pd
);
2577 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2580 dumpinfo
.ndo
= NULL
;
2582 #ifdef HAVE_PCAP_DUMP_FLUSH
2584 pcap_dump_flush(pdd
);
2587 dlt
= pcap_datalink(pd
);
2588 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2589 callback
= print_packet
;
2590 pcap_userdata
= (u_char
*)ndo
;
2593 #ifdef SIGNAL_REQ_INFO
2595 * We can't get statistics when reading from a file rather
2596 * than capturing from a device.
2598 if (RFileName
== NULL
)
2599 (void)setsignal(SIGNAL_REQ_INFO
, requestinfo
);
2601 #ifdef SIGNAL_FLUSH_PCAP
2602 (void)setsignal(SIGNAL_FLUSH_PCAP
, flushpcap
);
2605 if (ndo
->ndo_vflag
> 0 && WFileName
&& RFileName
== NULL
&& !print
) {
2607 * When capturing to a file, if "--print" wasn't specified,
2608 *"-v" means tcpdump should, once per second,
2609 * "v"erbosely report the number of packets captured.
2610 * Except when reading from a file, because -r, -w and -v
2611 * together used to make a corner case, in which pcap_loop()
2612 * errored due to EINTR (see GH #155 for details).
2616 * https://blogs.msdn.microsoft.com/oldnewthing/20151230-00/?p=92741
2618 * suggests that this dates back to W2K.
2620 * I don't know what a "long wait" is, but we'll assume
2621 * that printing the stats could be a "long wait".
2623 CreateTimerQueueTimer(&timer_handle
, NULL
,
2624 verbose_stats_dump
, NULL
, 1000, 1000,
2625 WT_EXECUTEDEFAULT
|WT_EXECUTELONGFUNCTION
);
2626 setvbuf(stderr
, NULL
, _IONBF
, 0);
2629 * Assume this is UN*X, and that it has setitimer(); that
2630 * dates back to UNIX 95.
2632 struct itimerval timer
;
2633 (void)setsignal(SIGALRM
, verbose_stats_dump
);
2634 timer
.it_interval
.tv_sec
= 1;
2635 timer
.it_interval
.tv_usec
= 0;
2636 timer
.it_value
.tv_sec
= 1;
2637 timer
.it_value
.tv_usec
= 1;
2638 setitimer(ITIMER_REAL
, &timer
, NULL
);
2642 if (RFileName
== NULL
) {
2644 * Live capture (if -V was specified, we set RFileName
2645 * to a file from the -V file). Print a message to
2646 * the standard error on UN*X.
2648 if (!ndo
->ndo_vflag
&& !WFileName
) {
2649 (void)fprintf(stderr
,
2650 "%s: verbose output suppressed, use -v[v]... for full protocol decode\n",
2653 (void)fprintf(stderr
, "%s: ", program_name
);
2654 dlt
= pcap_datalink(pd
);
2655 dlt_name
= pcap_datalink_val_to_name(dlt
);
2656 (void)fprintf(stderr
, "listening on %s", device
);
2657 if (dlt_name
== NULL
) {
2658 (void)fprintf(stderr
, ", link-type %u", dlt
);
2660 (void)fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2661 pcap_datalink_val_to_description(dlt
));
2663 (void)fprintf(stderr
, ", snapshot length %d bytes\n", ndo
->ndo_snaplen
);
2664 (void)fflush(stderr
);
2667 #ifdef HAVE_CAPSICUM
2668 cansandbox
= (VFileName
== NULL
&& zflag
== NULL
);
2670 cansandbox
= (cansandbox
&& (ndo
->ndo_nflag
|| capdns
!= NULL
));
2672 cansandbox
= (cansandbox
&& ndo
->ndo_nflag
);
2673 #endif /* HAVE_CASPER */
2674 cansandbox
= (cansandbox
&& (pcap_fileno(pd
) != -1 ||
2675 RFileName
!= NULL
));
2677 if (cansandbox
&& cap_enter() < 0 && errno
!= ENOSYS
)
2678 error("unable to enter the capability mode");
2679 #endif /* HAVE_CAPSICUM */
2682 status
= pcap_loop(pd
, cnt
, callback
, pcap_userdata
);
2683 if (WFileName
== NULL
) {
2685 * We're printing packets. Flush the printed output,
2686 * so it doesn't get intermingled with error output.
2690 * We got interrupted, so perhaps we didn't
2691 * manage to finish a line we were printing.
2692 * Print an extra newline, just in case.
2696 (void)fflush(stdout
);
2700 * We got interrupted. If we are reading multiple
2701 * files (via -V) set these so that we stop.
2710 (void)fprintf(stderr
, "%s: pcap_loop: %s\n",
2711 program_name
, pcap_geterr(pd
));
2713 if (RFileName
== NULL
) {
2715 * We're doing a live capture. Report the capture
2721 if (VFileName
!= NULL
) {
2722 ret
= get_next_file(VFile
, VFileLine
);
2726 RFileName
= VFileLine
;
2727 pd
= pcap_open_offline(RFileName
, ebuf
);
2730 #ifdef HAVE_CAPSICUM
2731 cap_rights_init(&rights
, CAP_READ
);
2732 if (cap_rights_limit(fileno(pcap_file(pd
)),
2733 &rights
) < 0 && errno
!= ENOSYS
) {
2734 error("unable to limit pcap descriptor");
2737 new_dlt
= pcap_datalink(pd
);
2738 if (new_dlt
!= dlt
) {
2740 * The new file has a different
2741 * link-layer header type from the
2744 if (WFileName
!= NULL
) {
2746 * We're writing raw packets
2747 * that match the filter to
2748 * a pcap file. pcap files
2749 * don't support multiple
2750 * different link-layer
2751 * header types, so we fail
2754 error("%s: new dlt does not match original", RFileName
);
2758 * We're printing the decoded packets;
2759 * switch to the new DLT.
2761 * To do that, we need to change
2762 * the printer, change the DLT name,
2763 * and recompile the filter with
2767 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2768 /* Free the old filter */
2769 pcap_freecode(&fcode
);
2770 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2771 error("%s", pcap_geterr(pd
));
2775 * Set the filter on the new file.
2777 if (pcap_setfilter(pd
, &fcode
) < 0)
2778 error("%s", pcap_geterr(pd
));
2781 * Report the new file.
2783 dlt_name
= pcap_datalink_val_to_name(dlt
);
2784 fprintf(stderr
, "reading from file %s", RFileName
);
2785 if (dlt_name
== NULL
) {
2786 fprintf(stderr
, ", link-type %u", dlt
);
2788 fprintf(stderr
, ", link-type %s (%s)",
2790 pcap_datalink_val_to_description(dlt
));
2792 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2796 while (ret
!= NULL
);
2798 if (count_mode
&& RFileName
!= NULL
)
2799 fprintf(stdout
, "%u packet%s\n", packets_captured
,
2800 PLURAL_SUFFIX(packets_captured
));
2803 pcap_freecode(&fcode
);
2804 exit_tcpdump(status
== -1 ? S_ERR_HOST_PROGRAM
: S_SUCCESS
);
2811 (*setsignal (int sig
, void (*func
)(int)))(int)
2814 return (signal(sig
, func
));
2816 struct sigaction old
, new;
2818 memset(&new, 0, sizeof(new));
2819 new.sa_handler
= func
;
2820 if ((sig
== SIGCHLD
)
2821 # ifdef SIGNAL_REQ_INFO
2822 || (sig
== SIGNAL_REQ_INFO
)
2824 # ifdef SIGNAL_FLUSH_PCAP
2825 || (sig
== SIGNAL_FLUSH_PCAP
)
2828 new.sa_flags
= SA_RESTART
;
2829 if (sigaction(sig
, &new, &old
) < 0)
2831 return (old
.sa_handler
);
2835 /* make a clean exit on interrupts */
2837 cleanup(int signo _U_
)
2840 if (timer_handle
!= INVALID_HANDLE_VALUE
) {
2841 DeleteTimerQueueTimer(NULL
, timer_handle
, NULL
);
2842 CloseHandle(timer_handle
);
2843 timer_handle
= INVALID_HANDLE_VALUE
;
2846 struct itimerval timer
;
2848 timer
.it_interval
.tv_sec
= 0;
2849 timer
.it_interval
.tv_usec
= 0;
2850 timer
.it_value
.tv_sec
= 0;
2851 timer
.it_value
.tv_usec
= 0;
2852 setitimer(ITIMER_REAL
, &timer
, NULL
);
2855 #ifdef HAVE_PCAP_BREAKLOOP
2857 * We have "pcap_breakloop()"; use it, so that we do as little
2858 * as possible in the signal handler (it's probably not safe
2859 * to do anything with standard I/O streams in a signal handler -
2860 * the ANSI C standard doesn't say it is).
2865 * We don't have "pcap_breakloop()"; this isn't safe, but
2866 * it's the best we can do. Print the summary if we're
2867 * not reading from a savefile - i.e., if we're doing a
2868 * live capture - and exit.
2870 if (pd
!= NULL
&& pcap_file(pd
) == NULL
) {
2872 * We got interrupted, so perhaps we didn't
2873 * manage to finish a line we were printing.
2874 * Print an extra newline, just in case.
2877 (void)fflush(stdout
);
2880 exit_tcpdump(S_SUCCESS
);
2885 On windows, we do not use a fork, so we do not care less about
2886 waiting a child processes to die
2888 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2890 child_cleanup(int signo _U_
)
2892 while (waitpid(-1, NULL
, WNOHANG
) >= 0);
2894 #endif /* HAVE_FORK && HAVE_VFORK */
2899 struct pcap_stat stats
;
2902 * Older versions of libpcap didn't set ps_ifdrop on some
2903 * platforms; initialize it to 0 to handle that.
2905 stats
.ps_ifdrop
= 0;
2906 if (pcap_stats(pd
, &stats
) < 0) {
2907 (void)fprintf(stderr
, "pcap_stats: %s\n", pcap_geterr(pd
));
2913 fprintf(stderr
, "%s: ", program_name
);
2915 (void)fprintf(stderr
, "%u packet%s captured", packets_captured
,
2916 PLURAL_SUFFIX(packets_captured
));
2918 fputs(", ", stderr
);
2921 (void)fprintf(stderr
, "%u packet%s received by filter", stats
.ps_recv
,
2922 PLURAL_SUFFIX(stats
.ps_recv
));
2924 fputs(", ", stderr
);
2927 (void)fprintf(stderr
, "%u packet%s dropped by kernel", stats
.ps_drop
,
2928 PLURAL_SUFFIX(stats
.ps_drop
));
2929 if (stats
.ps_ifdrop
!= 0) {
2931 fputs(", ", stderr
);
2934 (void)fprintf(stderr
, "%u packet%s dropped by interface\n",
2935 stats
.ps_ifdrop
, PLURAL_SUFFIX(stats
.ps_ifdrop
));
2941 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2943 #define fork_subprocess() fork()
2945 #define fork_subprocess() vfork()
2948 compress_savefile(const char *filename
)
2952 child
= fork_subprocess();
2955 "compress_savefile: fork failed: %s\n",
2956 pcap_strerror(errno
));
2960 /* Parent process. */
2966 * Set to lowest priority so that this doesn't disturb the capture.
2969 setpriority(PRIO_PROCESS
, 0, NZERO
- 1);
2971 setpriority(PRIO_PROCESS
, 0, 19);
2973 if (execlp(zflag
, zflag
, filename
, (char *)NULL
) == -1)
2975 "compress_savefile: execlp(%s, %s) failed: %s\n",
2978 pcap_strerror(errno
));
2980 exit(S_ERR_HOST_PROGRAM
);
2982 _exit(S_ERR_HOST_PROGRAM
);
2985 #else /* HAVE_FORK && HAVE_VFORK */
2987 compress_savefile(const char *filename
)
2990 "compress_savefile failed. Functionality not implemented under your system\n");
2992 #endif /* HAVE_FORK && HAVE_VFORK */
2995 dump_packet_and_trunc(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
2997 struct dump_info
*dump_info
;
3003 dump_info
= (struct dump_info
*)user
;
3006 * XXX - this won't force the file to rotate on the specified time
3007 * boundary, but it will rotate on the first packet received after the
3008 * specified Gflag number of seconds. Note: if a Gflag time boundary
3009 * and a Cflag size boundary coincide, the time rotation will occur
3010 * first thereby cancelling the Cflag boundary (since the file should
3014 /* Check if it is time to rotate */
3017 /* Get the current time */
3018 if ((t
= time(NULL
)) == (time_t)-1) {
3019 error("%s: can't get current_time: %s",
3020 __func__
, pcap_strerror(errno
));
3024 /* If the time is greater than the specified window, rotate */
3025 if (t
- Gflag_time
>= Gflag
) {
3026 #ifdef HAVE_CAPSICUM
3031 /* Update the Gflag_time */
3033 /* Update Gflag_count */
3036 * Close the current file and open a new one.
3038 pcap_dump_close(dump_info
->pdd
);
3041 * Compress the file we just closed, if the user asked for it
3044 compress_savefile(dump_info
->CurrentFileName
);
3047 * Check to see if we've exceeded the Wflag (when
3050 if (Cflag
== 0 && Wflag
> 0 && Gflag_count
>= Wflag
) {
3051 (void)fprintf(stderr
, "Maximum file limit reached: %d\n",
3054 exit_tcpdump(S_SUCCESS
);
3057 if (dump_info
->CurrentFileName
!= NULL
)
3058 free(dump_info
->CurrentFileName
);
3059 /* Allocate space for max filename + \0. */
3060 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3061 if (dump_info
->CurrentFileName
== NULL
)
3062 error("dump_packet_and_trunc: malloc");
3064 * Gflag was set otherwise we wouldn't be here. Reset the count
3065 * so multiple files would end with 1,2,3 in the filename.
3066 * The counting is handled with the -C flow after this.
3071 * This is always the first file in the Cflag
3073 * We also don't need numbering if Cflag is not set.
3076 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0,
3079 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0, 0);
3081 #ifdef HAVE_LIBCAP_NG
3082 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3083 capng_apply(CAPNG_SELECT_BOTH
);
3084 #endif /* HAVE_LIBCAP_NG */
3085 #ifdef HAVE_CAPSICUM
3086 fd
= openat(dump_info
->dirfd
,
3087 dump_info
->CurrentFileName
,
3088 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3090 error("unable to open file %s",
3091 dump_info
->CurrentFileName
);
3093 fp
= fdopen(fd
, "w");
3095 error("unable to fdopen file %s",
3096 dump_info
->CurrentFileName
);
3098 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3099 #else /* !HAVE_CAPSICUM */
3100 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3102 #ifdef HAVE_LIBCAP_NG
3103 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3104 capng_apply(CAPNG_SELECT_BOTH
);
3105 #endif /* HAVE_LIBCAP_NG */
3106 if (dump_info
->pdd
== NULL
)
3107 error("%s", pcap_geterr(pd
));
3108 #ifdef HAVE_CAPSICUM
3109 set_dumper_capsicum_rights(dump_info
->pdd
);
3115 * XXX - this won't prevent capture files from getting
3116 * larger than Cflag - the last packet written to the
3117 * file could put it over Cflag.
3120 #ifdef HAVE_PCAP_DUMP_FTELL64
3121 int64_t size
= pcap_dump_ftell64(dump_info
->pdd
);
3124 * XXX - this only handles a Cflag value > 2^31-1 on
3125 * LP64 platforms; to handle ILP32 (32-bit UN*X and
3126 * Windows) or LLP64 (64-bit Windows) would require
3127 * a version of libpcap with pcap_dump_ftell64().
3129 long size
= pcap_dump_ftell(dump_info
->pdd
);
3133 error("ftell fails on output file");
3135 #ifdef HAVE_CAPSICUM
3141 * Close the current file and open a new one.
3143 pcap_dump_close(dump_info
->pdd
);
3146 * Compress the file we just closed, if the user
3150 compress_savefile(dump_info
->CurrentFileName
);
3154 if (Cflag_count
>= Wflag
)
3157 if (dump_info
->CurrentFileName
!= NULL
)
3158 free(dump_info
->CurrentFileName
);
3159 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3160 if (dump_info
->CurrentFileName
== NULL
)
3161 error("%s: malloc", __func__
);
3162 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, Cflag_count
, WflagChars
);
3163 #ifdef HAVE_LIBCAP_NG
3164 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3165 capng_apply(CAPNG_SELECT_BOTH
);
3166 #endif /* HAVE_LIBCAP_NG */
3167 #ifdef HAVE_CAPSICUM
3168 fd
= openat(dump_info
->dirfd
, dump_info
->CurrentFileName
,
3169 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3171 error("unable to open file %s",
3172 dump_info
->CurrentFileName
);
3174 fp
= fdopen(fd
, "w");
3176 error("unable to fdopen file %s",
3177 dump_info
->CurrentFileName
);
3179 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3180 #else /* !HAVE_CAPSICUM */
3181 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3183 #ifdef HAVE_LIBCAP_NG
3184 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3185 capng_apply(CAPNG_SELECT_BOTH
);
3186 #endif /* HAVE_LIBCAP_NG */
3187 if (dump_info
->pdd
== NULL
)
3188 error("%s", pcap_geterr(pd
));
3189 #ifdef HAVE_CAPSICUM
3190 set_dumper_capsicum_rights(dump_info
->pdd
);
3195 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3196 #ifdef HAVE_PCAP_DUMP_FLUSH
3198 pcap_dump_flush(dump_info
->pdd
);
3201 if (dump_info
->ndo
!= NULL
)
3202 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3210 dump_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3212 struct dump_info
*dump_info
;
3218 dump_info
= (struct dump_info
*)user
;
3220 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3221 #ifdef HAVE_PCAP_DUMP_FLUSH
3223 pcap_dump_flush(dump_info
->pdd
);
3226 if (dump_info
->ndo
!= NULL
)
3227 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3235 print_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3242 pretty_print_packet((netdissect_options
*)user
, h
, sp
, packets_captured
);
3249 #ifdef SIGNAL_REQ_INFO
3251 requestinfo(int signo _U_
)
3260 #ifdef SIGNAL_FLUSH_PCAP
3262 flushpcap(int signo _U_
)
3265 pcap_dump_flush(pdd
);
3270 print_packets_captured (void)
3272 static u_int prev_packets_captured
, first
= 1;
3274 if (infodelay
== 0 && (first
|| packets_captured
!= prev_packets_captured
)) {
3275 fprintf(stderr
, "Got %u\r", packets_captured
);
3277 prev_packets_captured
= packets_captured
;
3282 * Called once each second in verbose mode while dumping to file
3285 static void CALLBACK
verbose_stats_dump(PVOID param _U_
,
3286 BOOLEAN timer_fired _U_
)
3288 print_packets_captured();
3291 static void verbose_stats_dump(int sig _U_
)
3293 print_packets_captured();
3297 DIAG_OFF_DEPRECATION
3299 print_version(FILE *f
)
3301 #ifndef HAVE_PCAP_LIB_VERSION
3302 #ifdef HAVE_PCAP_VERSION
3303 extern char pcap_version
[];
3304 #else /* HAVE_PCAP_VERSION */
3305 static char pcap_version
[] = "unknown";
3306 #endif /* HAVE_PCAP_VERSION */
3307 #endif /* HAVE_PCAP_LIB_VERSION */
3308 const char *smi_version_string
;
3310 (void)fprintf(f
, "%s version " PACKAGE_VERSION
"\n", program_name
);
3311 #ifdef HAVE_PCAP_LIB_VERSION
3312 (void)fprintf(f
, "%s\n", pcap_lib_version());
3313 #else /* HAVE_PCAP_LIB_VERSION */
3314 (void)fprintf(f
, "libpcap version %s\n", pcap_version
);
3315 #endif /* HAVE_PCAP_LIB_VERSION */
3317 #if defined(HAVE_LIBCRYPTO) && defined(SSLEAY_VERSION)
3318 (void)fprintf (f
, "%s\n", SSLeay_version(SSLEAY_VERSION
));
3321 smi_version_string
= nd_smi_version_string();
3322 if (smi_version_string
!= NULL
)
3323 (void)fprintf (f
, "SMI-library: %s\n", smi_version_string
);
3325 #if defined(__SANITIZE_ADDRESS__)
3326 (void)fprintf (f
, "Compiled with AddressSanitizer/GCC.\n");
3327 #elif defined(__has_feature)
3328 # if __has_feature(address_sanitizer)
3329 (void)fprintf (f
, "Compiled with AddressSanitizer/Clang.\n");
3330 # elif __has_feature(memory_sanitizer)
3331 (void)fprintf (f
, "Compiled with MemorySanitizer/Clang.\n");
3333 #endif /* __SANITIZE_ADDRESS__ or __has_feature */
3338 print_usage(FILE *f
)
3342 "Usage: %s [-Abd" D_FLAG
"efhH" I_FLAG J_FLAG
"KlLnNOpqStu" U_FLAG
"vxX#]" B_FLAG_USAGE
" [ -c count ] [--count]\n", program_name
);
3344 "\t\t[ -C file_size ] [ -E algo:secret ] [ -F file ] [ -G seconds ]\n");
3346 "\t\t[ -i interface ]" IMMEDIATE_MODE_USAGE j_FLAG_USAGE
"\n");
3347 #ifdef HAVE_PCAP_FINDALLDEVS_EX
3349 "\t\t[ --lengths ]" LIST_REMOTE_INTERFACES_USAGE
"\n");
3353 "\t\t" m_FLAG_USAGE
"\n");
3356 "\t\t[ -M secret ] [ --number ] [ --print ]\n");
3358 "\t\t[ --print-sampling nth ]" Q_FLAG_USAGE
" [ -r file ]\n");
3360 "\t\t[ -s snaplen ] [ -T type ] [ --version ]\n");
3362 "\t\t[ -V file ] [ -w file ] [ -W filecount ] [ -y datalinktype ]\n");
3363 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
3365 "\t\t[ --time-stamp-precision precision ] [ --micro ] [ --nano ]\n");
3368 "\t\t[ -z postrotate-command ] [ -Z user ] [ expression ]\n");