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.
39 * Some older versions of Mac OS X ship pcap.h from libpcap 0.6 with a
40 * libpcap based on 0.8. That means it has pcap_findalldevs() but the
41 * header doesn't define pcap_if_t, meaning that we can't actually *use*
44 #ifdef HAVE_PCAP_FINDALLDEVS
45 #ifndef HAVE_PCAP_IF_T
46 #undef HAVE_PCAP_FINDALLDEVS
50 #include "netdissect-stdinc.h"
53 * This must appear after including netdissect-stdinc.h, so that _U_ is
57 static const char copyright
[] _U_
=
58 "@(#) Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000\n\
59 The Regents of the University of California. All rights reserved.\n";
67 #include <openssl/crypto.h>
70 #ifdef HAVE_GETOPT_LONG
73 #include "missing/getopt_long.h"
75 /* Capsicum-specific code requires macros from <net/bpf.h>, which will fail
76 * to compile if <pcap.h> has already been included; including the headers
77 * in the opposite order works fine. For the most part anyway, because in
78 * FreeBSD <pcap/pcap.h> declares bpf_dump() instead of <net/bpf.h>. Thus
79 * interface.h takes care of it later to avoid a compiler warning.
82 #include <sys/capsicum.h>
83 #include <sys/ioccom.h>
87 #include <libcasper.h>
88 #include <casper/cap_dns.h>
90 #endif /* HAVE_CASPER */
91 #endif /* HAVE_CAPSICUM */
94 * We found pcap_open() in the capture library, so we'll be using
95 * the remote capture APIs; define PCAP_REMOTE before we include pcap.h,
96 * so we get those APIs declared, and the types and #defines that they
99 * WinPcap's headers require that PCAP_REMOTE be defined in order to get
100 * remote-capture APIs declared and types and #defines that they use
103 * (Versions of libpcap with those APIs, and thus Npcap, which is based on
104 * those versions of libpcap, don't require it.)
118 #include <sys/time.h>
119 #include <sys/wait.h>
120 #include <sys/resource.h>
126 * Pathname separator.
127 * Use this in pathnames, but do *not* use it in URLs.
130 #define PATH_SEPARATOR '\\'
132 #define PATH_SEPARATOR '/'
135 /* capabilities convenience library */
136 /* If a code depends on HAVE_LIBCAP_NG, it depends also on HAVE_CAP_NG_H.
137 * If HAVE_CAP_NG_H is not defined, undefine HAVE_LIBCAP_NG.
138 * Thus, the later tests are done only on HAVE_LIBCAP_NG.
140 #ifdef HAVE_LIBCAP_NG
144 #undef HAVE_LIBCAP_NG
145 #endif /* HAVE_CAP_NG_H */
146 #endif /* HAVE_LIBCAP_NG */
149 #include <sys/sysctl.h>
150 #endif /* __FreeBSD__ */
152 #include "netdissect-stdinc.h"
153 #include "netdissect.h"
154 #include "interface.h"
155 #include "addrtoname.h"
156 #include "pcap-missing.h"
157 #include "ascii_strcasecmp.h"
161 #include "diag-control.h"
166 #define PATH_MAX 1024
170 #define SIGNAL_REQ_INFO SIGINFO
171 #elif defined(SIGUSR1)
172 #define SIGNAL_REQ_INFO SIGUSR1
175 #if defined(HAVE_PCAP_DUMP_FLUSH) && defined(SIGUSR2)
176 #define SIGNAL_FLUSH_PCAP SIGUSR2
179 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
180 static int Bflag
; /* buffer size */
182 #ifdef HAVE_PCAP_DUMP_FTELL64
183 static int64_t Cflag
; /* rotate dump files after this many bytes */
185 static long Cflag
; /* rotate dump files after this many bytes */
187 static int Cflag_count
; /* Keep track of which file number we're writing */
188 #ifdef HAVE_PCAP_FINDALLDEVS
189 static int Dflag
; /* list available devices and exit */
191 #ifdef HAVE_PCAP_FINDALLDEVS_EX
192 static char *remote_interfaces_source
; /* list available devices from this source and exit */
196 * This is exported because, in some versions of libpcap, if libpcap
197 * is built with optimizer debugging code (which is *NOT* the default
198 * configuration!), the library *imports*(!) a variable named dflag,
199 * under the expectation that tcpdump is exporting it, to govern
200 * how much debugging information to print when optimizing
201 * the generated BPF code.
203 * This is a horrible hack; newer versions of libpcap don't import
204 * dflag but, instead, *if* built with optimizer debugging code,
205 * *export* a routine to set that flag.
208 int dflag
; /* print filter code */
209 static int Gflag
; /* rotate dump files after this many seconds */
210 static int Gflag_count
; /* number of files created with Gflag rotation */
211 static time_t Gflag_time
; /* The last time_t the dump file was rotated. */
212 static int Lflag
; /* list available data link types and exit */
213 static int Iflag
; /* rfmon (monitor) mode */
214 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
215 static int Jflag
; /* list available time stamp types */
216 static int jflag
= -1; /* packet time stamp source */
218 static int lflag
; /* line-buffered output */
219 static int pflag
; /* don't go promiscuous */
220 #ifdef HAVE_PCAP_SETDIRECTION
221 static int Qflag
= -1; /* restrict captured packet by send/receive direction */
223 #ifdef HAVE_PCAP_DUMP_FLUSH
224 static int Uflag
; /* "unbuffered" output of dump files */
226 static int Wflag
; /* recycle output files after this number of files */
227 static int WflagChars
;
228 static char *zflag
= NULL
; /* compress each savefile using a specified command (like gzip or bzip2) */
229 static int timeout
= 1000; /* default timeout = 1000 ms = 1 s */
230 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
231 static int immediate_mode
;
233 static int count_mode
;
235 static int infodelay
;
236 static int infoprint
;
241 static void (*setsignal (int sig
, void (*func
)(int)))(int);
242 static void cleanup(int);
243 static void child_cleanup(int);
244 static void print_version(FILE *);
245 static void print_usage(FILE *);
247 static void print_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
248 static void dump_packet_and_trunc(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
249 static void dump_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
251 #ifdef SIGNAL_REQ_INFO
252 static void requestinfo(int);
255 #ifdef SIGNAL_FLUSH_PCAP
256 static void flushpcap(int);
260 static HANDLE timer_handle
= INVALID_HANDLE_VALUE
;
261 static void CALLBACK
verbose_stats_dump(PVOID param
, BOOLEAN timer_fired
);
263 static void verbose_stats_dump(int sig
);
266 static void info(int);
267 static u_int packets_captured
;
269 #ifdef HAVE_PCAP_FINDALLDEVS
270 static const struct tok status_flags
[] = {
272 { PCAP_IF_UP
, "Up" },
274 #ifdef PCAP_IF_RUNNING
275 { PCAP_IF_RUNNING
, "Running" },
277 { PCAP_IF_LOOPBACK
, "Loopback" },
278 #ifdef PCAP_IF_WIRELESS
279 { PCAP_IF_WIRELESS
, "Wireless" },
286 static pcap_dumper_t
*pdd
= NULL
;
288 static int supports_monitor_mode
;
296 char *CurrentFileName
;
299 netdissect_options
*ndo
;
305 #if defined(HAVE_PCAP_SET_PARSER_DEBUG)
307 * We have pcap_set_parser_debug() in libpcap; declare it (it's not declared
308 * by any libpcap header, because it's a special hack, only available if
309 * libpcap was configured to include it, and only intended for use by
310 * libpcap developers trying to debug the parser for filter expressions).
313 __declspec(dllimport
)
317 void pcap_set_parser_debug(int);
318 #elif defined(HAVE_PCAP_DEBUG) || defined(HAVE_YYDEBUG)
320 * We don't have pcap_set_parser_debug() in libpcap, but we do have
321 * pcap_debug or yydebug. Make a local version of pcap_set_parser_debug()
322 * to set the flag, and define HAVE_PCAP_SET_PARSER_DEBUG.
325 pcap_set_parser_debug(int value
)
327 #ifdef HAVE_PCAP_DEBUG
328 extern int pcap_debug
;
331 #else /* HAVE_PCAP_DEBUG */
335 #endif /* HAVE_PCAP_DEBUG */
338 #define HAVE_PCAP_SET_PARSER_DEBUG
341 #if defined(HAVE_PCAP_SET_OPTIMIZER_DEBUG)
343 * We have pcap_set_optimizer_debug() in libpcap; declare it (it's not declared
344 * by any libpcap header, because it's a special hack, only available if
345 * libpcap was configured to include it, and only intended for use by
346 * libpcap developers trying to debug the optimizer for filter expressions).
349 __declspec(dllimport
)
353 void pcap_set_optimizer_debug(int);
357 exit_tcpdump(const int status
)
364 static void NORETURN
PRINTFLIKE(1, 2)
365 error(FORMAT_STRING(const char *fmt
), ...)
369 (void)fprintf(stderr
, "%s: ", program_name
);
371 (void)vfprintf(stderr
, fmt
, ap
);
376 (void)fputc('\n', stderr
);
378 exit_tcpdump(S_ERR_HOST_PROGRAM
);
383 static void PRINTFLIKE(1, 2)
384 warning(FORMAT_STRING(const char *fmt
), ...)
388 (void)fprintf(stderr
, "%s: WARNING: ", program_name
);
390 (void)vfprintf(stderr
, fmt
, ap
);
395 (void)fputc('\n', stderr
);
399 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
401 show_tstamp_types_and_exit(pcap_t
*pc
, const char *device
)
404 int *tstamp_types
= 0;
405 const char *tstamp_type_name
;
408 n_tstamp_types
= pcap_list_tstamp_types(pc
, &tstamp_types
);
409 if (n_tstamp_types
< 0)
410 error("%s", pcap_geterr(pc
));
412 if (n_tstamp_types
== 0) {
413 fprintf(stderr
, "Time stamp type cannot be set for %s\n",
415 exit_tcpdump(S_SUCCESS
);
417 fprintf(stdout
, "Time stamp types for %s (use option -j to set):\n",
419 for (i
= 0; i
< n_tstamp_types
; i
++) {
420 tstamp_type_name
= pcap_tstamp_type_val_to_name(tstamp_types
[i
]);
421 if (tstamp_type_name
!= NULL
) {
422 (void) fprintf(stdout
, " %s (%s)\n", tstamp_type_name
,
423 pcap_tstamp_type_val_to_description(tstamp_types
[i
]));
425 (void) fprintf(stdout
, " %d\n", tstamp_types
[i
]);
428 pcap_free_tstamp_types(tstamp_types
);
429 exit_tcpdump(S_SUCCESS
);
434 show_dlts_and_exit(pcap_t
*pc
, const char *device
)
438 const char *dlt_name
;
440 n_dlts
= pcap_list_datalinks(pc
, &dlts
);
442 error("%s", pcap_geterr(pc
));
443 else if (n_dlts
== 0 || !dlts
)
444 error("No data link types.");
447 * If the interface is known to support monitor mode, indicate
448 * whether these are the data link types available when not in
449 * monitor mode, if -I wasn't specified, or when in monitor mode,
450 * when -I was specified (the link-layer types available in
451 * monitor mode might be different from the ones available when
452 * not in monitor mode).
454 (void) fprintf(stdout
, "Data link types for ");
455 if (supports_monitor_mode
)
456 (void) fprintf(stdout
, "%s %s",
458 Iflag
? "when in monitor mode" : "when not in monitor mode");
460 (void) fprintf(stdout
, "%s",
462 (void) fprintf(stdout
, " (use option -y to set):\n");
464 for (i
= 0; i
< n_dlts
; i
++) {
465 dlt_name
= pcap_datalink_val_to_name(dlts
[i
]);
466 if (dlt_name
!= NULL
) {
467 (void) fprintf(stdout
, " %s (%s)", dlt_name
,
468 pcap_datalink_val_to_description(dlts
[i
]));
471 * OK, does tcpdump handle that type?
473 if (!has_printer(dlts
[i
]))
474 (void) fprintf(stdout
, " (printing not supported)");
475 fprintf(stdout
, "\n");
477 (void) fprintf(stdout
, " DLT %d (printing not supported)\n",
481 #ifdef HAVE_PCAP_FREE_DATALINKS
482 pcap_free_datalinks(dlts
);
484 exit_tcpdump(S_SUCCESS
);
487 #ifdef HAVE_PCAP_FINDALLDEVS
489 show_devices_and_exit(void)
491 pcap_if_t
*dev
, *devlist
;
492 char ebuf
[PCAP_ERRBUF_SIZE
];
495 if (pcap_findalldevs(&devlist
, ebuf
) < 0)
497 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
498 printf("%d.%s", i
+1, dev
->name
);
499 if (dev
->description
!= NULL
)
500 printf(" (%s)", dev
->description
);
501 if (dev
->flags
!= 0) {
503 printf("%s", bittok2str(status_flags
, "none", dev
->flags
));
504 #ifdef PCAP_IF_WIRELESS
505 if (dev
->flags
& PCAP_IF_WIRELESS
) {
506 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
508 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
509 printf(", Association status unknown");
512 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
513 printf(", Associated");
516 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
517 printf(", Not associated");
520 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
524 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
526 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
527 printf(", Connection status unknown");
530 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
531 printf(", Connected");
534 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
535 printf(", Disconnected");
538 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
547 pcap_freealldevs(devlist
);
548 exit_tcpdump(S_SUCCESS
);
550 #endif /* HAVE_PCAP_FINDALLDEVS */
552 #ifdef HAVE_PCAP_FINDALLDEVS_EX
554 show_remote_devices_and_exit(void)
556 pcap_if_t
*dev
, *devlist
;
557 char ebuf
[PCAP_ERRBUF_SIZE
];
560 if (pcap_findalldevs_ex(remote_interfaces_source
, NULL
, &devlist
,
562 if (strcmp(ebuf
, "not supported") == 0) {
564 * macOS 14's pcap_findalldevs_ex(), which is a
565 * stub that always returns -1 with an error
566 * message of "not supported".
568 * In this case, as we passed it an rpcap://
569 * URL, treat that as meaning "remote capture
572 error("Remote capture not supported");
576 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
577 printf("%d.%s", i
+1, dev
->name
);
578 if (dev
->description
!= NULL
)
579 printf(" (%s)", dev
->description
);
581 printf(" [%s]", bittok2str(status_flags
, "none", dev
->flags
));
584 pcap_freealldevs(devlist
);
585 exit_tcpdump(S_SUCCESS
);
587 #endif /* HAVE_PCAP_FINDALLDEVS */
592 * Note that there we use all letters for short options except for g, k,
593 * o, and P, and those are used by other versions of tcpdump, and we should
594 * only use them for the same purposes that the other versions of tcpdump
597 * macOS tcpdump uses -g to force non--v output for IP to be on one
598 * line, making it more "g"repable;
600 * macOS tcpdump uses -k to specify that packet comments in pcapng files
603 * OpenBSD tcpdump uses -o to indicate that OS fingerprinting should be done
604 * for hosts sending TCP SYN packets;
606 * macOS tcpdump uses -P to indicate that -w should write pcapng rather
609 * macOS tcpdump also uses -Q to specify expressions that match packet
610 * metadata, including but not limited to the packet direction.
611 * The expression syntax is different from a simple "in|out|inout",
612 * and those expressions aren't accepted by macOS tcpdump, but the
613 * equivalents would be "in" = "dir=in", "out" = "dir=out", and
614 * "inout" = "dir=in or dir=out", and the parser could conceivably
615 * special-case "in", "out", and "inout" as expressions for backwards
616 * compatibility, so all is not (yet) lost.
620 * Set up flags that might or might not be supported depending on the
621 * version of libpcap we're using.
623 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
625 #define B_FLAG_USAGE " [ -B size ]"
626 #else /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
629 #endif /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
631 #ifdef HAVE_PCAP_FINDALLDEVS
637 #ifdef HAVE_PCAP_CREATE
639 #else /* HAVE_PCAP_CREATE */
641 #endif /* HAVE_PCAP_CREATE */
643 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
645 #define j_FLAG_USAGE " [ -j tstamptype ]"
647 #else /* PCAP_ERROR_TSTAMP_TYPE_NOTSUP */
651 #endif /* PCAP_ERROR_TSTAMP_TYPE_NOTSUP */
654 #define m_FLAG_USAGE "[ -m module ] ..."
657 #ifdef HAVE_PCAP_SETDIRECTION
659 #define Q_FLAG_USAGE " [ -Q in|out|inout ]"
665 #ifdef HAVE_PCAP_DUMP_FLUSH
671 #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:#"
676 * We do not currently have long options corresponding to all short
677 * options; we should probably pick appropriate option names for them.
679 * However, the short options where the number of times the option is
680 * specified matters, such as -v and -d and -t, should probably not
681 * just map to a long option, as saying
683 * tcpdump --verbose --verbose
685 * doesn't make sense; it should be --verbosity={N} or something such
688 * For long options with no corresponding short options, we define values
689 * outside the range of ASCII graphic characters, make that the last
690 * component of the entry for the long option, and have a case for that
691 * option in the switch statement.
693 #define OPTION_VERSION 128
694 #define OPTION_TSTAMP_PRECISION 129
695 #define OPTION_IMMEDIATE_MODE 130
696 #define OPTION_PRINT 131
697 #define OPTION_LIST_REMOTE_INTERFACES 132
698 #define OPTION_TSTAMP_MICRO 133
699 #define OPTION_TSTAMP_NANO 134
700 #define OPTION_FP_TYPE 135
701 #define OPTION_COUNT 136
702 #define OPTION_PRINT_SAMPLING 137
703 #define OPTION_LENGTHS 138
705 static const struct option longopts
[] = {
706 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
707 { "buffer-size", required_argument
, NULL
, 'B' },
709 { "list-interfaces", no_argument
, NULL
, 'D' },
710 #ifdef HAVE_PCAP_FINDALLDEVS_EX
711 { "list-remote-interfaces", required_argument
, NULL
, OPTION_LIST_REMOTE_INTERFACES
},
713 { "help", no_argument
, NULL
, 'h' },
714 { "interface", required_argument
, NULL
, 'i' },
715 #ifdef HAVE_PCAP_CREATE
716 { "monitor-mode", no_argument
, NULL
, 'I' },
718 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
719 { "time-stamp-type", required_argument
, NULL
, 'j' },
720 { "list-time-stamp-types", no_argument
, NULL
, 'J' },
722 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
723 { "micro", no_argument
, NULL
, OPTION_TSTAMP_MICRO
},
724 { "nano", no_argument
, NULL
, OPTION_TSTAMP_NANO
},
725 { "time-stamp-precision", required_argument
, NULL
, OPTION_TSTAMP_PRECISION
},
727 { "dont-verify-checksums", no_argument
, NULL
, 'K' },
728 { "list-data-link-types", no_argument
, NULL
, 'L' },
729 { "no-optimize", no_argument
, NULL
, 'O' },
730 { "no-promiscuous-mode", no_argument
, NULL
, 'p' },
731 #ifdef HAVE_PCAP_SETDIRECTION
732 { "direction", required_argument
, NULL
, 'Q' },
734 { "snapshot-length", required_argument
, NULL
, 's' },
735 { "absolute-tcp-sequence-numbers", no_argument
, NULL
, 'S' },
736 #ifdef HAVE_PCAP_DUMP_FLUSH
737 { "packet-buffered", no_argument
, NULL
, 'U' },
739 { "linktype", required_argument
, NULL
, 'y' },
740 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
741 { "immediate-mode", no_argument
, NULL
, OPTION_IMMEDIATE_MODE
},
743 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
744 { "debug-filter-parser", no_argument
, NULL
, 'Y' },
746 { "relinquish-privileges", required_argument
, NULL
, 'Z' },
747 { "count", no_argument
, NULL
, OPTION_COUNT
},
748 { "fp-type", no_argument
, NULL
, OPTION_FP_TYPE
},
749 { "number", no_argument
, NULL
, '#' },
750 { "print", no_argument
, NULL
, OPTION_PRINT
},
751 { "print-sampling", required_argument
, NULL
, OPTION_PRINT_SAMPLING
},
752 { "lengths", no_argument
, NULL
, OPTION_LENGTHS
},
753 { "version", no_argument
, NULL
, OPTION_VERSION
},
757 #ifdef HAVE_PCAP_FINDALLDEVS_EX
758 #define LIST_REMOTE_INTERFACES_USAGE " [ --list-remote-interfaces remote-source ]"
760 #define LIST_REMOTE_INTERFACES_USAGE
763 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
764 #define IMMEDIATE_MODE_USAGE " [ --immediate-mode ]"
766 #define IMMEDIATE_MODE_USAGE ""
770 /* Drop root privileges and chroot if necessary */
772 droproot(const char *username
, const char *chroot_dir
)
774 struct passwd
*pw
= NULL
;
776 if (chroot_dir
&& !username
)
777 error("Chroot without dropping root is insecure");
779 pw
= getpwnam(username
);
782 if (chroot(chroot_dir
) != 0 || chdir ("/") != 0)
783 error("Couldn't chroot/chdir to '%.64s': %s",
784 chroot_dir
, pcap_strerror(errno
));
786 #ifdef HAVE_LIBCAP_NG
788 int ret
= capng_change_id(pw
->pw_uid
, pw
->pw_gid
, CAPNG_NO_FLAG
);
790 error("capng_change_id(): return %d\n", ret
);
792 fprintf(stderr
, "dropped privs to %s\n", username
);
795 if (initgroups(pw
->pw_name
, pw
->pw_gid
) != 0 ||
796 setgid(pw
->pw_gid
) != 0 || setuid(pw
->pw_uid
) != 0)
797 error("Couldn't change to '%.32s' uid=%lu gid=%lu: %s",
799 (unsigned long)pw
->pw_uid
,
800 (unsigned long)pw
->pw_gid
,
801 pcap_strerror(errno
));
803 fprintf(stderr
, "dropped privs to %s\n", username
);
805 #endif /* HAVE_LIBCAP_NG */
807 error("Couldn't find user '%.32s'", username
);
808 #ifdef HAVE_LIBCAP_NG
809 /* We don't need CAP_SETUID, CAP_SETGID and CAP_SYS_CHROOT anymore. */
813 CAPNG_EFFECTIVE
| CAPNG_PERMITTED
,
819 capng_apply(CAPNG_SELECT_BOTH
);
820 #endif /* HAVE_LIBCAP_NG */
841 MakeFilename(char *buffer
, char *orig_name
, int cnt
, int max_chars
)
843 char *filename
= malloc(PATH_MAX
+ 1);
844 if (filename
== NULL
)
845 error("%s: malloc", __func__
);
846 if (strlen(orig_name
) == 0)
847 error("an empty string is not a valid file name");
849 /* Process with strftime if Gflag is set. */
853 /* Convert Gflag_time to a usable format */
854 if ((local_tm
= localtime(&Gflag_time
)) == NULL
) {
855 error("%s: localtime", __func__
);
858 /* There's no good way to detect an error in strftime since a return
859 * value of 0 isn't necessarily failure; if orig_name is an empty
860 * string, the formatted string will be empty.
862 * However, the C90 standard says that, if there *is* a
863 * buffer overflow, the content of the buffer is undefined,
864 * so we must check for a buffer overflow.
866 * So we check above for an empty orig_name, and only call
867 * strftime() if it's non-empty, in which case the return
868 * value will only be 0 if the formatted date doesn't fit
871 * (We check above because, even if we don't use -G, we
872 * want a better error message than "tcpdump: : No such
873 * file or directory" for this case.)
875 if (strftime(filename
, PATH_MAX
, orig_name
, local_tm
) == 0) {
876 error("%s: strftime", __func__
);
879 strncpy(filename
, orig_name
, PATH_MAX
);
882 if (cnt
== 0 && max_chars
== 0)
883 strncpy(buffer
, filename
, PATH_MAX
+ 1);
885 if (snprintf(buffer
, PATH_MAX
+ 1, "%s%0*d", filename
, max_chars
, cnt
) > PATH_MAX
)
886 /* Report an error if the filename is too large */
887 error("too many output files or filename is too long (> %d)", PATH_MAX
);
892 get_next_file(FILE *VFile
, char *ptr
)
897 ret
= fgets(ptr
, PATH_MAX
, VFile
);
902 if (len
> 0 && ptr
[len
- 1] == '\n')
909 static cap_channel_t
*
912 cap_channel_t
*capcas
, *capdnsloc
;
913 const char *types
[1];
918 error("unable to create casper process");
919 capdnsloc
= cap_service_open(capcas
, "system.dns");
920 /* Casper capability no longer needed. */
922 if (capdnsloc
== NULL
)
923 error("unable to open system.dns service");
924 /* Limit system.dns to reverse DNS lookups. */
926 if (cap_dns_type_limit(capdnsloc
, types
, 1) < 0)
927 error("unable to limit access to system.dns service");
928 families
[0] = AF_INET
;
929 /* Casper is a feature of FreeBSD, which defines AF_INET6. */
930 families
[1] = AF_INET6
;
931 if (cap_dns_family_limit(capdnsloc
, families
, 2) < 0)
932 error("unable to limit access to system.dns service");
936 #endif /* HAVE_CASPER */
938 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
940 tstamp_precision_from_string(const char *precision
)
942 if (strncmp(precision
, "nano", strlen("nano")) == 0)
943 return PCAP_TSTAMP_PRECISION_NANO
;
945 if (strncmp(precision
, "micro", strlen("micro")) == 0)
946 return PCAP_TSTAMP_PRECISION_MICRO
;
952 tstamp_precision_to_string(int precision
)
956 case PCAP_TSTAMP_PRECISION_MICRO
:
959 case PCAP_TSTAMP_PRECISION_NANO
:
970 * Ensure that, on a dump file's descriptor, we have all the rights
971 * necessary to make the standard I/O library work with an fdopen()ed
972 * FILE * from that descriptor.
974 * A long time ago in a galaxy far, far away, AT&T decided that, instead
975 * of providing separate APIs for getting and setting the FD_ flags on a
976 * descriptor, getting and setting the O_ flags on a descriptor, and
977 * locking files, they'd throw them all into a kitchen-sink fcntl() call
978 * along the lines of ioctl(), the fact that ioctl() operations are
979 * largely specific to particular character devices but fcntl() operations
980 * are either generic to all descriptors or generic to all descriptors for
981 * regular files notwithstanding.
983 * The Capsicum people decided that fine-grained control of descriptor
984 * operations was required, so that you need to grant permission for
985 * reading, writing, seeking, and fcntl-ing. The latter, courtesy of
986 * AT&T's decision, means that "fcntl-ing" isn't a thing, but a motley
987 * collection of things, so there are *individual* fcntls for which
988 * permission needs to be granted.
990 * The FreeBSD standard I/O people implemented some optimizations that
991 * requires that the standard I/O routines be able to determine whether
992 * the descriptor for the FILE * is open append-only or not; as that
993 * descriptor could have come from an open() rather than an fopen(),
994 * that requires that it be able to do an F_GETFL fcntl() to read
997 * tcpdump uses ftell() to determine how much data has been written
998 * to a file in order to, when used with -C, determine when it's time
999 * to rotate capture files. ftell() therefore needs to do an lseek()
1000 * to find out the file offset and must, thanks to the aforementioned
1001 * optimization, also know whether the descriptor is open append-only
1004 * The net result of all the above is that we need to grant CAP_SEEK,
1005 * CAP_WRITE, and CAP_FCNTL with the CAP_FCNTL_GETFL subcapability.
1007 * Perhaps this is the universe's way of saying that either
1009 * 1) there needs to be an fopenat() call and a pcap_dump_openat() call
1010 * using it, so that Capsicum-capable tcpdump wouldn't need to do
1015 * 2) there needs to be a cap_fdopen() call in the FreeBSD standard
1016 * I/O library that knows what rights are needed by the standard
1017 * I/O library, based on the open mode, and assigns them, perhaps
1018 * with an additional argument indicating, for example, whether
1019 * seeking should be allowed, so that tcpdump doesn't need to know
1020 * what the standard I/O library happens to require this week.
1023 set_dumper_capsicum_rights(pcap_dumper_t
*p
)
1025 int fd
= fileno(pcap_dump_file(p
));
1026 cap_rights_t rights
;
1028 cap_rights_init(&rights
, CAP_SEEK
, CAP_WRITE
, CAP_FCNTL
);
1029 if (cap_rights_limit(fd
, &rights
) < 0 && errno
!= ENOSYS
) {
1030 error("unable to limit dump descriptor");
1032 if (cap_fcntls_limit(fd
, CAP_FCNTL_GETFL
) < 0 && errno
!= ENOSYS
) {
1033 error("unable to limit dump descriptor fcntls");
1039 * Copy arg vector into a new buffer, concatenating arguments with spaces.
1042 copy_argv(char **argv
)
1054 len
+= strlen(*p
++) + 1;
1056 buf
= (char *)malloc(len
);
1058 error("%s: malloc", __func__
);
1062 while ((src
= *p
++) != NULL
) {
1063 while ((*dst
++ = *src
++) != '\0')
1073 * On Windows, we need to open the file in binary mode, so that
1074 * we get all the bytes specified by the size we get from "fstat()".
1075 * On UNIX, that's not necessary. O_BINARY is defined on Windows;
1076 * we define it as 0 if it's not defined, so it does nothing.
1083 read_infile(char *fname
)
1090 fd
= open(fname
, O_RDONLY
|O_BINARY
);
1092 error("can't open %s: %s", fname
, pcap_strerror(errno
));
1094 if (our_fstat(fd
, &buf
) < 0)
1095 error("can't stat %s: %s", fname
, pcap_strerror(errno
));
1098 * Reject files whose size doesn't fit into an int; a filter
1099 * *that* large will probably be too big.
1101 if (buf
.st_size
> INT_MAX
)
1102 error("%s is too large", fname
);
1104 cp
= malloc((u_int
)buf
.st_size
+ 1);
1106 error("malloc(%d) for %s: %s", (u_int
)buf
.st_size
+ 1,
1107 fname
, pcap_strerror(errno
));
1108 cc
= read(fd
, cp
, (u_int
)buf
.st_size
);
1110 error("read %s: %s", fname
, pcap_strerror(errno
));
1111 if (cc
!= buf
.st_size
)
1112 error("short read %s (%d != %d)", fname
, (int) cc
,
1116 /* replace "# comment" with spaces */
1117 for (i
= 0; i
< cc
; i
++) {
1119 while (i
< cc
&& cp
[i
] != '\n')
1126 #ifdef HAVE_PCAP_FINDALLDEVS
1128 parse_interface_number(const char *device
)
1135 * Search for a colon, terminating any scheme at the beginning
1138 p
= strchr(device
, ':');
1141 * We found it. Is it followed by "//"?
1143 p
++; /* skip the : */
1144 if (strncmp(p
, "//", 2) == 0) {
1146 * Yes. Search for the next /, at the end of the
1147 * authority part of the URL.
1149 p
+= 2; /* skip the // */
1153 * OK, past the / is the path.
1159 devnum
= strtol(device
, &end
, 10);
1160 if (device
!= end
&& *end
== '\0') {
1162 * It's all-numeric, but is it a valid number?
1166 * No, it's not an ordinal.
1168 error("Invalid adapter index");
1173 * It's not all-numeric; return -1, so our caller
1181 find_interface_by_number(const char *url
1182 #ifndef HAVE_PCAP_FINDALLDEVS_EX
1187 pcap_if_t
*dev
, *devlist
;
1189 char ebuf
[PCAP_ERRBUF_SIZE
];
1191 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1197 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1199 * Search for a colon, terminating any scheme at the beginning
1202 endp
= strchr(url
, ':');
1205 * We found it. Is it followed by "//"?
1207 endp
++; /* skip the : */
1208 if (strncmp(endp
, "//", 2) == 0) {
1210 * Yes. Search for the next /, at the end of the
1211 * authority part of the URL.
1213 endp
+= 2; /* skip the // */
1214 endp
= strchr(endp
, '/');
1220 * OK, everything from device to endp is a URL to hand
1221 * to pcap_findalldevs_ex().
1223 endp
++; /* Include the trailing / in the URL; pcap_findalldevs_ex() requires it */
1224 host_url
= malloc(endp
- url
+ 1);
1225 if (host_url
== NULL
&& (endp
- url
+ 1) > 0)
1226 error("Invalid allocation for host");
1228 memcpy(host_url
, url
, endp
- url
);
1229 host_url
[endp
- url
] = '\0';
1230 status
= pcap_findalldevs_ex(host_url
, NULL
, &devlist
, ebuf
);
1234 status
= pcap_findalldevs(&devlist
, ebuf
);
1238 * Look for the devnum-th entry in the list of devices (1-based).
1240 for (i
= 0, dev
= devlist
; i
< devnum
-1 && dev
!= NULL
;
1241 i
++, dev
= dev
->next
)
1244 error("Invalid adapter index");
1245 device
= strdup(dev
->name
);
1246 pcap_freealldevs(devlist
);
1251 #ifdef HAVE_PCAP_OPEN
1253 * Prefixes for rpcap URLs.
1255 static char rpcap_prefix
[] = "rpcap://";
1256 static char rpcap_ssl_prefix
[] = "rpcaps://";
1260 open_interface(const char *device
, netdissect_options
*ndo
, char *ebuf
)
1263 #ifdef HAVE_PCAP_CREATE
1268 #ifdef HAVE_PCAP_OPEN
1270 * Is this an rpcap URL?
1272 if (strncmp(device
, rpcap_prefix
, sizeof(rpcap_prefix
) - 1) == 0 ||
1273 strncmp(device
, rpcap_ssl_prefix
, sizeof(rpcap_ssl_prefix
) - 1) == 0) {
1275 * Yes. Open it with pcap_open().
1278 pc
= pcap_open(device
, ndo
->ndo_snaplen
,
1279 pflag
? 0 : PCAP_OPENFLAG_PROMISCUOUS
, timeout
, NULL
,
1283 * macOS 14's pcap_pcap_open(), which is a
1284 * stub that always returns NULL with an error
1285 * message of "not supported".
1287 * In this case, as we passed it an rpcap://
1288 * URL, treat that as meaning "remote capture
1291 if (strcmp(ebuf
, "not supported") == 0)
1292 error("Remote capture not supported");
1295 * If this failed with "No such device" or "The system
1296 * cannot find the device specified", that means
1297 * the interface doesn't exist; return NULL, so that
1298 * the caller can see whether the device name is
1299 * actually an interface index.
1301 if (strstr(ebuf
, "No such device") != NULL
||
1302 strstr(ebuf
, "The system cannot find the device specified") != NULL
)
1307 warning("%s", ebuf
);
1310 #endif /* HAVE_PCAP_OPEN */
1312 #ifdef HAVE_PCAP_CREATE
1313 pc
= pcap_create(device
, ebuf
);
1316 * If this failed with "No such device", that means
1317 * the interface doesn't exist; return NULL, so that
1318 * the caller can see whether the device name is
1319 * actually an interface index.
1321 if (strstr(ebuf
, "No such device") != NULL
)
1325 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1327 show_tstamp_types_and_exit(pc
, device
);
1329 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
1330 status
= pcap_set_tstamp_precision(pc
, ndo
->ndo_tstamp_precision
);
1332 error("%s: Can't set %ssecond time stamp precision: %s",
1334 tstamp_precision_to_string(ndo
->ndo_tstamp_precision
),
1335 pcap_statustostr(status
));
1338 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
1339 if (immediate_mode
) {
1340 status
= pcap_set_immediate_mode(pc
, 1);
1342 error("%s: Can't set immediate mode: %s",
1343 device
, pcap_statustostr(status
));
1347 * Is this an interface that supports monitor mode?
1349 if (pcap_can_set_rfmon(pc
) == 1)
1350 supports_monitor_mode
= 1;
1352 supports_monitor_mode
= 0;
1353 if (ndo
->ndo_snaplen
!= 0) {
1355 * A snapshot length was explicitly specified;
1358 status
= pcap_set_snaplen(pc
, ndo
->ndo_snaplen
);
1360 error("%s: Can't set snapshot length: %s",
1361 device
, pcap_statustostr(status
));
1363 status
= pcap_set_promisc(pc
, !pflag
);
1365 error("%s: Can't set promiscuous mode: %s",
1366 device
, pcap_statustostr(status
));
1368 status
= pcap_set_rfmon(pc
, 1);
1370 error("%s: Can't set monitor mode: %s",
1371 device
, pcap_statustostr(status
));
1373 status
= pcap_set_timeout(pc
, timeout
);
1375 error("%s: pcap_set_timeout failed: %s",
1376 device
, pcap_statustostr(status
));
1378 status
= pcap_set_buffer_size(pc
, Bflag
);
1380 error("%s: Can't set buffer size: %s",
1381 device
, pcap_statustostr(status
));
1383 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1385 status
= pcap_set_tstamp_type(pc
, jflag
);
1387 error("%s: Can't set time stamp type: %s",
1388 device
, pcap_statustostr(status
));
1389 else if (status
> 0)
1390 warning("When trying to set timestamp type '%s' on %s: %s",
1391 pcap_tstamp_type_val_to_name(jflag
), device
,
1392 pcap_statustostr(status
));
1395 status
= pcap_activate(pc
);
1398 * pcap_activate() failed.
1400 cp
= pcap_geterr(pc
);
1401 if (status
== PCAP_ERROR
)
1403 else if (status
== PCAP_ERROR_NO_SUCH_DEVICE
) {
1405 * Return an error for our caller to handle.
1407 snprintf(ebuf
, PCAP_ERRBUF_SIZE
, "%s: %s\n(%s)",
1408 device
, pcap_statustostr(status
), cp
);
1409 } else if (status
== PCAP_ERROR_PERM_DENIED
&& *cp
!= '\0')
1410 error("%s: %s\n(%s)", device
,
1411 pcap_statustostr(status
), cp
);
1413 else if (status
== PCAP_ERROR_RFMON_NOTSUP
&&
1414 strncmp(device
, "wlan", 4) == 0) {
1415 char parent
[8], newdev
[8];
1417 size_t s
= sizeof(parent
);
1419 snprintf(sysctl
, sizeof(sysctl
),
1420 "net.wlan.%d.%%parent", atoi(device
+ 4));
1421 sysctlbyname(sysctl
, parent
, &s
, NULL
, 0);
1422 strlcpy(newdev
, device
, sizeof(newdev
));
1423 /* Suggest a new wlan device. */
1424 /* FIXME: incrementing the index this way is not going to work well
1425 * when the index is 9 or greater but the only consequence in this
1426 * specific case would be an error message that looks a bit odd.
1428 newdev
[strlen(newdev
)-1]++;
1429 error("%s is not a monitor mode VAP\n"
1430 "To create a new monitor mode VAP use:\n"
1431 " ifconfig %s create wlandev %s wlanmode monitor\n"
1432 "and use %s as the tcpdump interface",
1433 device
, newdev
, parent
, newdev
);
1437 error("%s: %s", device
,
1438 pcap_statustostr(status
));
1441 } else if (status
> 0) {
1443 * pcap_activate() succeeded, but it's warning us
1444 * of a problem it had.
1446 cp
= pcap_geterr(pc
);
1447 if (status
== PCAP_WARNING
)
1449 else if (status
== PCAP_WARNING_PROMISC_NOTSUP
&&
1451 warning("%s: %s\n(%s)", device
,
1452 pcap_statustostr(status
), cp
);
1454 warning("%s: %s", device
,
1455 pcap_statustostr(status
));
1457 #ifdef HAVE_PCAP_SETDIRECTION
1459 status
= pcap_setdirection(pc
, Qflag
);
1461 error("%s: pcap_setdirection() failed: %s",
1462 device
, pcap_geterr(pc
));
1464 #endif /* HAVE_PCAP_SETDIRECTION */
1465 #else /* HAVE_PCAP_CREATE */
1468 * If no snapshot length was specified, or a length of 0 was
1469 * specified, default to 256KB.
1471 if (ndo
->ndo_snaplen
== 0)
1472 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
1473 pc
= pcap_open_live(device
, ndo
->ndo_snaplen
, !pflag
, timeout
, ebuf
);
1476 * If this failed with "No such device", that means
1477 * the interface doesn't exist; return NULL, so that
1478 * the caller can see whether the device name is
1479 * actually an interface index.
1481 if (strstr(ebuf
, "No such device") != NULL
)
1486 warning("%s", ebuf
);
1487 #endif /* HAVE_PCAP_CREATE */
1493 main(int argc
, char **argv
)
1496 bpf_u_int32 localnet
= 0, netmask
= 0;
1497 char *cp
, *infile
, *cmdbuf
, *device
, *RFileName
, *VFileName
, *WFileName
;
1499 pcap_handler callback
;
1501 const char *dlt_name
;
1502 struct bpf_program fcode
;
1504 void (*oldhandler
)(int);
1506 struct dump_info dumpinfo
;
1507 u_char
*pcap_userdata
;
1508 char ebuf
[PCAP_ERRBUF_SIZE
];
1509 char VFileLine
[PATH_MAX
+ 1];
1510 const char *username
= NULL
;
1512 const char *chroot_dir
= NULL
;
1516 #ifdef HAVE_PCAP_FINDALLDEVS
1522 #ifdef HAVE_CAPSICUM
1523 cap_rights_t rights
;
1525 #endif /* HAVE_CAPSICUM */
1526 int Oflag
= 1; /* run filter code optimizer */
1528 const char *yflag_dlt_name
= NULL
;
1532 netdissect_options Ndo
;
1533 netdissect_options
*ndo
= &Ndo
;
1536 * Initialize the netdissect code.
1538 if (nd_init(ebuf
, sizeof(ebuf
)) == -1)
1541 memset(ndo
, 0, sizeof(*ndo
));
1542 ndo_set_function_pointers(ndo
);
1552 if ((cp
= strrchr(argv
[0], PATH_SEPARATOR
)) != NULL
)
1553 ndo
->program_name
= program_name
= cp
+ 1;
1555 ndo
->program_name
= program_name
= argv
[0];
1557 #if defined(HAVE_PCAP_WSOCKINIT)
1558 if (pcap_wsockinit() != 0)
1559 error("Attempting to initialize Winsock failed");
1560 #elif defined(HAVE_WSOCKINIT)
1561 if (wsockinit() != 0)
1562 error("Attempting to initialize Winsock failed");
1566 * An explicit tzset() call is usually not needed as it happens
1567 * implicitly the first time we call localtime() or mktime(),
1568 * but in some cases (sandboxing, chroot) this may be too late.
1573 (op
= getopt_long(argc
, argv
, SHORTOPTS
, longopts
, NULL
)) != -1)
1577 /* compatibility for old -a */
1588 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
1590 Bflag
= atoi(optarg
)*1024;
1592 error("invalid packet buffer size %s", optarg
);
1594 #endif /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
1599 error("invalid packet count %s", optarg
);
1604 #ifdef HAVE_PCAP_DUMP_FTELL64
1605 Cflag
= strtoint64_t(optarg
, &endp
, 10);
1607 Cflag
= strtol(optarg
, &endp
, 10);
1609 if (endp
== optarg
|| errno
!= 0 || Cflag
<= 0)
1610 error("invalid file size %s", optarg
);
1612 if (*endp
== '\0') {
1614 * There's nothing after the file size,
1615 * so the size is in units of 1 MB
1616 * (1,000,000 bytes).
1618 Cflagmult
= 1000000;
1621 * There's something after the file
1624 * If it's a single letter, then:
1626 * if the letter is k or K, the size
1627 * is in units of 1 KiB (1024 bytes);
1629 * if the letter is m or M, the size
1630 * is in units of 1 MiB (1,048,576 bytes);
1632 * if the letter is g or G, the size
1633 * is in units of 1 GiB (1,073,741,824 bytes).
1635 * Otherwise, it's an error.
1646 Cflagmult
= 1024*1024;
1651 Cflagmult
= 1024*1024*1024;
1655 error("invalid file size %s", optarg
);
1659 * OK, there was a letter that we treat
1660 * as a units indication; was there
1661 * anything after it?
1664 if (*endp
!= '\0') {
1666 error("invalid file size %s", optarg
);
1671 * Will multiplying it by multiplier overflow?
1673 #ifdef HAVE_PCAP_DUMP_FTELL64
1674 if (Cflag
> INT64_T_CONSTANT(0x7fffffffffffffff) / Cflagmult
)
1676 if (Cflag
> LONG_MAX
/ Cflagmult
)
1678 error("file size %s is too large", optarg
);
1686 #ifdef HAVE_PCAP_FINDALLDEVS
1692 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1693 case OPTION_LIST_REMOTE_INTERFACES
:
1694 remote_interfaces_source
= optarg
;
1707 #ifndef HAVE_LIBCRYPTO
1708 warning("crypto code not compiled in");
1710 ndo
->ndo_espsecret
= optarg
;
1722 Gflag
= atoi(optarg
);
1724 error("invalid number of seconds %s", optarg
);
1726 /* We will create one file initially. */
1729 /* Grab the current time for rotation use. */
1730 if ((Gflag_time
= time(NULL
)) == (time_t)-1) {
1731 error("%s: can't get current time: %s",
1732 __func__
, pcap_strerror(errno
));
1737 print_usage(stdout
);
1738 exit_tcpdump(S_SUCCESS
);
1749 #ifdef HAVE_PCAP_CREATE
1753 #endif /* HAVE_PCAP_CREATE */
1755 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1757 jflag
= pcap_tstamp_type_name_to_val(optarg
);
1759 error("invalid time stamp type %s", optarg
);
1770 * _IOLBF is the same as _IOFBF in Microsoft's C
1771 * libraries; the only alternative they offer
1774 * XXX - this should really be checking for MSVC++,
1775 * not _WIN32, if, for example, MinGW has its own
1776 * C library that is more UNIX-compatible.
1778 setvbuf(stdout
, NULL
, _IONBF
, 0);
1780 setvbuf(stdout
, NULL
, _IOLBF
, 0);
1790 if (nd_have_smi_support()) {
1791 if (nd_load_smi_module(optarg
, ebuf
, sizeof(ebuf
)) == -1)
1794 (void)fprintf(stderr
, "%s: ignoring option '-m %s' ",
1795 program_name
, optarg
);
1796 (void)fprintf(stderr
, "(no libsmi support)\n");
1801 /* TCP-MD5 shared secret */
1802 #ifndef HAVE_LIBCRYPTO
1803 warning("crypto code not compiled in");
1805 ndo
->ndo_sigsecret
= optarg
;
1826 ++ndo
->ndo_suppress_default_print
;
1829 #ifdef HAVE_PCAP_SETDIRECTION
1831 if (ascii_strcasecmp(optarg
, "in") == 0)
1833 else if (ascii_strcasecmp(optarg
, "out") == 0)
1835 else if (ascii_strcasecmp(optarg
, "inout") == 0)
1836 Qflag
= PCAP_D_INOUT
;
1838 error("unknown capture direction '%s'", optarg
);
1840 #endif /* HAVE_PCAP_SETDIRECTION */
1847 ndo
->ndo_snaplen
= (int)strtol(optarg
, &end
, 0);
1848 if (optarg
== end
|| *end
!= '\0'
1849 || ndo
->ndo_snaplen
< 0 || ndo
->ndo_snaplen
> MAXIMUM_SNAPLEN
)
1850 error("invalid snaplen %s (must be >= 0 and <= %d)",
1851 optarg
, MAXIMUM_SNAPLEN
);
1863 if (ascii_strcasecmp(optarg
, "vat") == 0)
1864 ndo
->ndo_packettype
= PT_VAT
;
1865 else if (ascii_strcasecmp(optarg
, "wb") == 0)
1866 ndo
->ndo_packettype
= PT_WB
;
1867 else if (ascii_strcasecmp(optarg
, "rpc") == 0)
1868 ndo
->ndo_packettype
= PT_RPC
;
1869 else if (ascii_strcasecmp(optarg
, "rtp") == 0)
1870 ndo
->ndo_packettype
= PT_RTP
;
1871 else if (ascii_strcasecmp(optarg
, "rtcp") == 0)
1872 ndo
->ndo_packettype
= PT_RTCP
;
1873 else if (ascii_strcasecmp(optarg
, "snmp") == 0)
1874 ndo
->ndo_packettype
= PT_SNMP
;
1875 else if (ascii_strcasecmp(optarg
, "cnfp") == 0)
1876 ndo
->ndo_packettype
= PT_CNFP
;
1877 else if (ascii_strcasecmp(optarg
, "tftp") == 0)
1878 ndo
->ndo_packettype
= PT_TFTP
;
1879 else if (ascii_strcasecmp(optarg
, "aodv") == 0)
1880 ndo
->ndo_packettype
= PT_AODV
;
1881 else if (ascii_strcasecmp(optarg
, "carp") == 0)
1882 ndo
->ndo_packettype
= PT_CARP
;
1883 else if (ascii_strcasecmp(optarg
, "radius") == 0)
1884 ndo
->ndo_packettype
= PT_RADIUS
;
1885 else if (ascii_strcasecmp(optarg
, "zmtp1") == 0)
1886 ndo
->ndo_packettype
= PT_ZMTP1
;
1887 else if (ascii_strcasecmp(optarg
, "vxlan") == 0)
1888 ndo
->ndo_packettype
= PT_VXLAN
;
1889 else if (ascii_strcasecmp(optarg
, "pgm") == 0)
1890 ndo
->ndo_packettype
= PT_PGM
;
1891 else if (ascii_strcasecmp(optarg
, "pgm_zmtp1") == 0)
1892 ndo
->ndo_packettype
= PT_PGM_ZMTP1
;
1893 else if (ascii_strcasecmp(optarg
, "lmp") == 0)
1894 ndo
->ndo_packettype
= PT_LMP
;
1895 else if (ascii_strcasecmp(optarg
, "resp") == 0)
1896 ndo
->ndo_packettype
= PT_RESP
;
1897 else if (ascii_strcasecmp(optarg
, "ptp") == 0)
1898 ndo
->ndo_packettype
= PT_PTP
;
1899 else if (ascii_strcasecmp(optarg
, "someip") == 0)
1900 ndo
->ndo_packettype
= PT_SOMEIP
;
1901 else if (ascii_strcasecmp(optarg
, "domain") == 0)
1902 ndo
->ndo_packettype
= PT_DOMAIN
;
1903 else if (ascii_strcasecmp(optarg
, "quic") == 0)
1904 ndo
->ndo_packettype
= PT_QUIC
;
1906 error("unknown packet type '%s'", optarg
);
1913 #ifdef HAVE_PCAP_DUMP_FLUSH
1932 Wflag
= atoi(optarg
);
1934 error("invalid number of output files %s", optarg
);
1935 WflagChars
= getWflagChars(Wflag
);
1940 ++ndo
->ndo_suppress_default_print
;
1945 ++ndo
->ndo_suppress_default_print
;
1949 yflag_dlt_name
= optarg
;
1951 pcap_datalink_name_to_val(yflag_dlt_name
);
1953 error("invalid data link type %s", yflag_dlt_name
);
1956 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
1959 /* Undocumented flag */
1960 pcap_set_parser_debug(1);
1973 ndo
->ndo_packet_number
= 1;
1976 case OPTION_LENGTHS
:
1977 ndo
->ndo_lengths
= 1;
1980 case OPTION_VERSION
:
1981 print_version(stdout
);
1982 exit_tcpdump(S_SUCCESS
);
1985 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
1986 case OPTION_TSTAMP_PRECISION
:
1987 ndo
->ndo_tstamp_precision
= tstamp_precision_from_string(optarg
);
1988 if (ndo
->ndo_tstamp_precision
< 0)
1989 error("unsupported time stamp precision");
1993 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
1994 case OPTION_IMMEDIATE_MODE
:
2003 case OPTION_PRINT_SAMPLING
:
2006 ndo
->ndo_print_sampling
= atoi(optarg
);
2007 if (ndo
->ndo_print_sampling
<= 0)
2008 error("invalid print sampling %s", optarg
);
2011 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2012 case OPTION_TSTAMP_MICRO
:
2013 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_MICRO
;
2016 case OPTION_TSTAMP_NANO
:
2017 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_NANO
;
2021 case OPTION_FP_TYPE
:
2023 * Print out the type of floating-point arithmetic
2024 * we're doing; it's probably IEEE, unless somebody
2025 * tries to run this on a VAX, but the precision
2026 * may differ (e.g., it might be 32-bit, 64-bit,
2029 float_type_check(0x4e93312d);
2037 print_usage(stderr
);
2038 exit_tcpdump(S_ERR_HOST_PROGRAM
);
2042 #ifdef HAVE_PCAP_FINDALLDEVS
2044 show_devices_and_exit();
2046 #ifdef HAVE_PCAP_FINDALLDEVS_EX
2047 if (remote_interfaces_source
!= NULL
)
2048 show_remote_devices_and_exit();
2051 switch (ndo
->ndo_tflag
) {
2053 case 0: /* Default */
2054 case 1: /* No time stamp */
2055 case 2: /* Unix timeval style */
2056 case 3: /* Microseconds/nanoseconds since previous packet */
2057 case 4: /* Date + Default */
2058 case 5: /* Microseconds/nanoseconds since first packet */
2061 default: /* Not supported */
2062 error("only -t, -tt, -ttt, -tttt and -ttttt are supported");
2066 if (ndo
->ndo_fflag
!= 0 && (VFileName
!= NULL
|| RFileName
!= NULL
))
2067 error("-f can not be used with -V or -r");
2069 if (VFileName
!= NULL
&& RFileName
!= NULL
)
2070 error("-V and -r are mutually exclusive.");
2073 * If we're printing dissected packets to the standard output,
2074 * and either the standard output is a terminal or we're doing
2075 * "line" buffering, set the capture timeout to .1 second rather
2076 * than 1 second, as the user's probably expecting to see packets
2077 * pop up immediately shortly after they arrive.
2079 * XXX - would there be some value appropriate for all cases,
2080 * based on, say, the buffer size and packet input rate?
2082 if ((WFileName
== NULL
|| print
) && (isatty(1) || lflag
))
2086 /* if run as root, prepare for chrooting */
2087 if (getuid() == 0 || geteuid() == 0) {
2088 /* future extensibility for cmd-line arguments */
2090 chroot_dir
= WITH_CHROOT
;
2095 /* if run as root, prepare for dropping root privileges */
2096 if (getuid() == 0 || geteuid() == 0) {
2097 /* Run with '-Z root' to restore old behaviour */
2099 username
= WITH_USER
;
2100 else if (strcmp(username
, "root") == 0)
2105 if (RFileName
!= NULL
|| VFileName
!= NULL
) {
2107 * If RFileName is non-null, it's the pathname of a
2108 * savefile to read. If VFileName is non-null, it's
2109 * the pathname of a file containing a list of pathnames
2110 * (one per line) of savefiles to read.
2112 * In either case, we're reading a savefile, not doing
2117 * We don't need network access, so relinquish any set-UID
2118 * or set-GID privileges we have (if any).
2120 * We do *not* want set-UID privileges when opening a
2121 * trace file, as that might let the user read other
2122 * people's trace files (especially if we're set-UID
2125 if (setgid(getgid()) != 0 || setuid(getuid()) != 0 )
2126 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2128 if (VFileName
!= NULL
) {
2129 if (VFileName
[0] == '-' && VFileName
[1] == '\0')
2132 VFile
= fopen(VFileName
, "r");
2135 error("Unable to open file: %s\n", pcap_strerror(errno
));
2137 ret
= get_next_file(VFile
, VFileLine
);
2139 error("Nothing in %s\n", VFileName
);
2140 RFileName
= VFileLine
;
2143 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2144 pd
= pcap_open_offline_with_tstamp_precision(RFileName
,
2145 ndo
->ndo_tstamp_precision
, ebuf
);
2147 pd
= pcap_open_offline(RFileName
, ebuf
);
2152 #ifdef HAVE_CAPSICUM
2153 cap_rights_init(&rights
, CAP_READ
);
2154 if (cap_rights_limit(fileno(pcap_file(pd
)), &rights
) < 0 &&
2156 error("unable to limit pcap descriptor");
2159 dlt
= pcap_datalink(pd
);
2160 dlt_name
= pcap_datalink_val_to_name(dlt
);
2161 fprintf(stderr
, "reading from file %s", RFileName
);
2162 if (dlt_name
== NULL
) {
2163 fprintf(stderr
, ", link-type %u", dlt
);
2165 fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2166 pcap_datalink_val_to_description(dlt
));
2168 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2169 #if defined(DLT_LINUX_SLL2) && defined(__linux__)
2170 if (dlt
== DLT_LINUX_SLL2
)
2171 fprintf(stderr
, "Warning: interface names might be incorrect\n");
2173 } else if (dflag
&& !device
) {
2174 int dump_dlt
= DLT_EN10MB
;
2176 * We're dumping the compiled code without an explicit
2177 * device specification. (If a device is specified, we
2178 * definitely want to open it to use the DLT of that device.)
2179 * Either default to DLT_EN10MB with a warning, or use
2180 * the user-specified value if supplied.
2183 * If no snapshot length was specified, or a length of 0 was
2184 * specified, default to 256KB.
2186 if (ndo
->ndo_snaplen
== 0)
2187 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
2189 * If a DLT was specified with the -y flag, use that instead.
2191 if (yflag_dlt
!= -1)
2192 dump_dlt
= yflag_dlt
;
2194 fprintf(stderr
, "Warning: assuming Ethernet\n");
2195 pd
= pcap_open_dead(dump_dlt
, ndo
->ndo_snaplen
);
2198 * We're doing a live capture.
2200 if (device
== NULL
) {
2202 * No interface was specified. Pick one.
2204 #ifdef HAVE_PCAP_FINDALLDEVS
2206 * Find the list of interfaces, and pick
2207 * the first interface.
2209 if (pcap_findalldevs(&devlist
, ebuf
) == -1)
2211 if (devlist
== NULL
)
2212 error("no interfaces available for capture");
2213 device
= strdup(devlist
->name
);
2214 pcap_freealldevs(devlist
);
2215 #else /* HAVE_PCAP_FINDALLDEVS */
2217 * Use whatever interface pcap_lookupdev()
2220 device
= pcap_lookupdev(ebuf
);
2227 * Try to open the interface with the specified name.
2229 pd
= open_interface(device
, ndo
, ebuf
);
2232 * That failed. If we can get a list of
2233 * interfaces, and the interface name
2234 * is purely numeric, try to use it as
2235 * a 1-based index in the list of
2238 #ifdef HAVE_PCAP_FINDALLDEVS
2239 devnum
= parse_interface_number(device
);
2242 * It's not a number; just report
2243 * the open error and fail.
2249 * OK, it's a number; try to find the
2250 * interface with that index, and try
2253 * find_interface_by_number() exits if it
2254 * couldn't be found.
2256 device
= find_interface_by_number(device
, devnum
);
2257 pd
= open_interface(device
, ndo
, ebuf
);
2260 #else /* HAVE_PCAP_FINDALLDEVS */
2262 * We can't get a list of interfaces; just
2266 #endif /* HAVE_PCAP_FINDALLDEVS */
2270 * Let user own process after capture device has
2274 if (setgid(getgid()) != 0 || setuid(getuid()) != 0)
2275 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2277 #if !defined(HAVE_PCAP_CREATE) && defined(_WIN32)
2279 if(pcap_setbuff(pd
, Bflag
)==-1){
2280 error("%s", pcap_geterr(pd
));
2282 #endif /* !defined(HAVE_PCAP_CREATE) && defined(_WIN32) */
2284 show_dlts_and_exit(pd
, device
);
2285 if (yflag_dlt
>= 0) {
2286 #ifdef HAVE_PCAP_SET_DATALINK
2287 if (pcap_set_datalink(pd
, yflag_dlt
) < 0)
2288 error("%s", pcap_geterr(pd
));
2291 * We don't actually support changing the
2292 * data link type, so we only let them
2293 * set it to what it already is.
2295 if (yflag_dlt
!= pcap_datalink(pd
)) {
2296 error("%s is not one of the DLTs supported by this device\n",
2300 (void)fprintf(stderr
, "%s: data link type %s\n",
2302 pcap_datalink_val_to_name(yflag_dlt
));
2303 (void)fflush(stderr
);
2305 #if defined(DLT_LINUX_SLL2) && defined(HAVE_PCAP_SET_DATALINK)
2308 * Attempt to set default linktype to
2309 * DLT_LINUX_SLL2 when capturing on the
2312 * If the attempt fails, just quietly drive
2313 * on; this may be a non-Linux "any" device
2314 * that doesn't support DLT_LINUX_SLL2.
2316 if (strcmp(device
, "any") == 0) {
2317 DIAG_OFF_WARN_UNUSED_RESULT
2318 (void) pcap_set_datalink(pd
, DLT_LINUX_SLL2
);
2319 DIAG_ON_WARN_UNUSED_RESULT
2323 i
= pcap_snapshot(pd
);
2324 if (ndo
->ndo_snaplen
< i
) {
2325 if (ndo
->ndo_snaplen
!= 0)
2326 warning("snaplen raised from %d to %d", ndo
->ndo_snaplen
, i
);
2327 ndo
->ndo_snaplen
= i
;
2328 } else if (ndo
->ndo_snaplen
> i
) {
2329 warning("snaplen lowered from %d to %d", ndo
->ndo_snaplen
, i
);
2330 ndo
->ndo_snaplen
= i
;
2332 if(ndo
->ndo_fflag
!= 0) {
2333 if (pcap_lookupnet(device
, &localnet
, &netmask
, ebuf
) < 0) {
2334 warning("foreign (-f) flag used but: %s", ebuf
);
2340 cmdbuf
= read_infile(infile
);
2342 cmdbuf
= copy_argv(&argv
[optind
]);
2344 #ifdef HAVE_PCAP_SET_OPTIMIZER_DEBUG
2345 pcap_set_optimizer_debug(dflag
);
2347 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2348 error("%s", pcap_geterr(pd
));
2350 bpf_dump(&fcode
, dflag
);
2353 pcap_freecode(&fcode
);
2354 exit_tcpdump(S_SUCCESS
);
2358 if (!ndo
->ndo_nflag
)
2359 capdns
= capdns_setup();
2360 #endif /* HAVE_CASPER */
2362 init_print(ndo
, localnet
, netmask
);
2365 (void)setsignal(SIGPIPE
, cleanup
);
2366 (void)setsignal(SIGTERM
, cleanup
);
2368 (void)setsignal(SIGINT
, cleanup
);
2369 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2370 (void)setsignal(SIGCHLD
, child_cleanup
);
2372 /* Cooperate with nohup(1) */
2375 * In illumos /usr/include/sys/iso/signal_iso.h causes Clang to
2376 * generate a -Wstrict-prototypes warning here, see [1]. The
2377 * __illumos__ macro is available since at least GCC 11 and Clang 13,
2379 * 1: https://www.illumos.org/issues/16344
2380 * 2: https://www.illumos.org/issues/13726
2383 DIAG_OFF_STRICT_PROTOTYPES
2384 #endif /* __illumos__ */
2385 if ((oldhandler
= setsignal(SIGHUP
, cleanup
)) != SIG_DFL
)
2387 DIAG_ON_STRICT_PROTOTYPES
2388 #endif /* __illumos__ */
2389 (void)setsignal(SIGHUP
, oldhandler
);
2394 * If a user name was specified with "-Z", attempt to switch to
2395 * that user's UID. This would probably be used with sudo,
2396 * to allow tcpdump to be run in a special restricted
2397 * account (if you just want to allow users to open capture
2398 * devices, and can't just give users that permission,
2399 * you'd make tcpdump set-UID or set-GID).
2401 * tcpdump doesn't necessarily write only to one savefile;
2402 * the general only way to allow a -Z instance to write to
2403 * savefiles as the user under whose UID it's run, rather
2404 * than as the user specified with -Z, would thus be to switch
2405 * to the original user ID before opening a capture file and
2406 * then switch back to the -Z user ID after opening the savefile.
2407 * Switching to the -Z user ID only after opening the first
2408 * savefile doesn't handle the general case.
2411 if (getuid() == 0 || geteuid() == 0) {
2412 #ifdef HAVE_LIBCAP_NG
2413 /* Initialize capng */
2414 capng_clear(CAPNG_SELECT_BOTH
);
2416 DIAG_OFF_ASSIGN_ENUM
2419 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2426 DIAG_OFF_ASSIGN_ENUM
2429 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2436 DIAG_OFF_ASSIGN_ENUM
2439 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2444 capng_apply(CAPNG_SELECT_BOTH
);
2445 #endif /* HAVE_LIBCAP_NG */
2446 if (username
|| chroot_dir
)
2447 droproot(username
, chroot_dir
);
2452 if (pcap_setfilter(pd
, &fcode
) < 0)
2453 error("%s", pcap_geterr(pd
));
2454 #ifdef HAVE_CAPSICUM
2455 if (RFileName
== NULL
&& VFileName
== NULL
&& pcap_fileno(pd
) != -1) {
2456 static const unsigned long cmds
[] = { BIOCGSTATS
, BIOCROTZBUF
};
2459 * The various libpcap devices use a combination of
2460 * read (bpf), ioctl (bpf, netmap), poll (netmap)
2461 * so we add the relevant access rights.
2463 cap_rights_init(&rights
, CAP_IOCTL
, CAP_READ
, CAP_EVENT
);
2464 if (cap_rights_limit(pcap_fileno(pd
), &rights
) < 0 &&
2466 error("unable to limit pcap descriptor");
2468 if (cap_ioctls_limit(pcap_fileno(pd
), cmds
,
2469 sizeof(cmds
) / sizeof(cmds
[0])) < 0 && errno
!= ENOSYS
) {
2470 error("unable to limit ioctls on pcap descriptor");
2475 /* Do not exceed the default PATH_MAX for files. */
2476 dumpinfo
.CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
2478 if (dumpinfo
.CurrentFileName
== NULL
)
2479 error("malloc of dumpinfo.CurrentFileName");
2481 /* We do not need numbering for dumpfiles if Cflag isn't set. */
2483 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, WflagChars
);
2485 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, 0);
2487 pdd
= pcap_dump_open(pd
, dumpinfo
.CurrentFileName
);
2488 #ifdef HAVE_LIBCAP_NG
2489 /* Give up CAP_DAC_OVERRIDE capability.
2490 * Only allow it to be restored if the -C or -G flag have been
2491 * set since we may need to create more files later on.
2495 (Cflag
|| Gflag
? 0 : CAPNG_PERMITTED
)
2499 capng_apply(CAPNG_SELECT_BOTH
);
2500 #endif /* HAVE_LIBCAP_NG */
2502 error("%s", pcap_geterr(pd
));
2503 #ifdef HAVE_CAPSICUM
2504 set_dumper_capsicum_rights(pdd
);
2506 if (Cflag
!= 0 || Gflag
!= 0) {
2507 #ifdef HAVE_CAPSICUM
2509 * basename() and dirname() may modify their input buffer
2510 * and they do since FreeBSD 12.0, but they didn't before.
2511 * Hence use the return value only, but always assume the
2512 * input buffer has been modified and would need to be
2513 * reset before the next use.
2515 char *WFileName_copy
;
2517 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2518 error("Unable to allocate memory for file %s",
2521 DIAG_OFF_C11_EXTENSIONS
2522 dumpinfo
.WFileName
= strdup(basename(WFileName_copy
));
2523 DIAG_ON_C11_EXTENSIONS
2524 if (dumpinfo
.WFileName
== NULL
) {
2525 error("Unable to allocate memory for file %s",
2528 free(WFileName_copy
);
2530 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2531 error("Unable to allocate memory for file %s",
2534 DIAG_OFF_C11_EXTENSIONS
2535 char *WFileName_dirname
= dirname(WFileName_copy
);
2536 DIAG_ON_C11_EXTENSIONS
2537 dumpinfo
.dirfd
= open(WFileName_dirname
,
2538 O_DIRECTORY
| O_RDONLY
);
2539 if (dumpinfo
.dirfd
< 0) {
2540 error("unable to open directory %s",
2543 free(WFileName_dirname
);
2544 free(WFileName_copy
);
2546 cap_rights_init(&rights
, CAP_CREATE
, CAP_FCNTL
,
2547 CAP_FTRUNCATE
, CAP_LOOKUP
, CAP_SEEK
, CAP_WRITE
);
2548 if (cap_rights_limit(dumpinfo
.dirfd
, &rights
) < 0 &&
2550 error("unable to limit directory rights");
2552 if (cap_fcntls_limit(dumpinfo
.dirfd
, CAP_FCNTL_GETFL
) < 0 &&
2554 error("unable to limit dump descriptor fcntls");
2556 #else /* !HAVE_CAPSICUM */
2557 dumpinfo
.WFileName
= WFileName
;
2559 callback
= dump_packet_and_trunc
;
2562 pcap_userdata
= (u_char
*)&dumpinfo
;
2564 callback
= dump_packet
;
2565 dumpinfo
.WFileName
= WFileName
;
2568 pcap_userdata
= (u_char
*)&dumpinfo
;
2571 dlt
= pcap_datalink(pd
);
2572 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2575 dumpinfo
.ndo
= NULL
;
2577 #ifdef HAVE_PCAP_DUMP_FLUSH
2579 pcap_dump_flush(pdd
);
2582 dlt
= pcap_datalink(pd
);
2583 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2584 callback
= print_packet
;
2585 pcap_userdata
= (u_char
*)ndo
;
2588 #ifdef SIGNAL_REQ_INFO
2590 * We can't get statistics when reading from a file rather
2591 * than capturing from a device.
2593 if (RFileName
== NULL
)
2594 (void)setsignal(SIGNAL_REQ_INFO
, requestinfo
);
2596 #ifdef SIGNAL_FLUSH_PCAP
2597 (void)setsignal(SIGNAL_FLUSH_PCAP
, flushpcap
);
2600 if (ndo
->ndo_vflag
> 0 && WFileName
&& RFileName
== NULL
&& !print
) {
2602 * When capturing to a file, if "--print" wasn't specified,
2603 *"-v" means tcpdump should, once per second,
2604 * "v"erbosely report the number of packets captured.
2605 * Except when reading from a file, because -r, -w and -v
2606 * together used to make a corner case, in which pcap_loop()
2607 * errored due to EINTR (see GH #155 for details).
2611 * https://blogs.msdn.microsoft.com/oldnewthing/20151230-00/?p=92741
2613 * suggests that this dates back to W2K.
2615 * I don't know what a "long wait" is, but we'll assume
2616 * that printing the stats could be a "long wait".
2618 CreateTimerQueueTimer(&timer_handle
, NULL
,
2619 verbose_stats_dump
, NULL
, 1000, 1000,
2620 WT_EXECUTEDEFAULT
|WT_EXECUTELONGFUNCTION
);
2621 setvbuf(stderr
, NULL
, _IONBF
, 0);
2624 * Assume this is UN*X, and that it has setitimer(); that
2625 * dates back to UNIX 95.
2627 struct itimerval timer
;
2628 (void)setsignal(SIGALRM
, verbose_stats_dump
);
2629 timer
.it_interval
.tv_sec
= 1;
2630 timer
.it_interval
.tv_usec
= 0;
2631 timer
.it_value
.tv_sec
= 1;
2632 timer
.it_value
.tv_usec
= 1;
2633 setitimer(ITIMER_REAL
, &timer
, NULL
);
2637 if (RFileName
== NULL
) {
2639 * Live capture (if -V was specified, we set RFileName
2640 * to a file from the -V file). Print a message to
2641 * the standard error on UN*X.
2643 if (!ndo
->ndo_vflag
&& !WFileName
) {
2644 (void)fprintf(stderr
,
2645 "%s: verbose output suppressed, use -v[v]... for full protocol decode\n",
2648 (void)fprintf(stderr
, "%s: ", program_name
);
2649 dlt
= pcap_datalink(pd
);
2650 dlt_name
= pcap_datalink_val_to_name(dlt
);
2651 (void)fprintf(stderr
, "listening on %s", device
);
2652 if (dlt_name
== NULL
) {
2653 (void)fprintf(stderr
, ", link-type %u", dlt
);
2655 (void)fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2656 pcap_datalink_val_to_description(dlt
));
2658 (void)fprintf(stderr
, ", snapshot length %d bytes\n", ndo
->ndo_snaplen
);
2659 (void)fflush(stderr
);
2662 #ifdef HAVE_CAPSICUM
2663 cansandbox
= (VFileName
== NULL
&& zflag
== NULL
);
2665 cansandbox
= (cansandbox
&& (ndo
->ndo_nflag
|| capdns
!= NULL
));
2667 cansandbox
= (cansandbox
&& ndo
->ndo_nflag
);
2668 #endif /* HAVE_CASPER */
2669 cansandbox
= (cansandbox
&& (pcap_fileno(pd
) != -1 ||
2670 RFileName
!= NULL
));
2672 if (cansandbox
&& cap_enter() < 0 && errno
!= ENOSYS
)
2673 error("unable to enter the capability mode");
2674 #endif /* HAVE_CAPSICUM */
2677 status
= pcap_loop(pd
, cnt
, callback
, pcap_userdata
);
2678 if (WFileName
== NULL
) {
2680 * We're printing packets. Flush the printed output,
2681 * so it doesn't get intermingled with error output.
2685 * We got interrupted, so perhaps we didn't
2686 * manage to finish a line we were printing.
2687 * Print an extra newline, just in case.
2691 (void)fflush(stdout
);
2695 * We got interrupted. If we are reading multiple
2696 * files (via -V) set these so that we stop.
2705 (void)fprintf(stderr
, "%s: pcap_loop: %s\n",
2706 program_name
, pcap_geterr(pd
));
2708 if (RFileName
== NULL
) {
2710 * We're doing a live capture. Report the capture
2716 if (VFileName
!= NULL
) {
2717 ret
= get_next_file(VFile
, VFileLine
);
2721 RFileName
= VFileLine
;
2722 pd
= pcap_open_offline(RFileName
, ebuf
);
2725 #ifdef HAVE_CAPSICUM
2726 cap_rights_init(&rights
, CAP_READ
);
2727 if (cap_rights_limit(fileno(pcap_file(pd
)),
2728 &rights
) < 0 && errno
!= ENOSYS
) {
2729 error("unable to limit pcap descriptor");
2732 new_dlt
= pcap_datalink(pd
);
2733 if (new_dlt
!= dlt
) {
2735 * The new file has a different
2736 * link-layer header type from the
2739 if (WFileName
!= NULL
) {
2741 * We're writing raw packets
2742 * that match the filter to
2743 * a pcap file. pcap files
2744 * don't support multiple
2745 * different link-layer
2746 * header types, so we fail
2749 error("%s: new dlt does not match original", RFileName
);
2753 * We're printing the decoded packets;
2754 * switch to the new DLT.
2756 * To do that, we need to change
2757 * the printer, change the DLT name,
2758 * and recompile the filter with
2762 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2763 /* Free the old filter */
2764 pcap_freecode(&fcode
);
2765 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2766 error("%s", pcap_geterr(pd
));
2770 * Set the filter on the new file.
2772 if (pcap_setfilter(pd
, &fcode
) < 0)
2773 error("%s", pcap_geterr(pd
));
2776 * Report the new file.
2778 dlt_name
= pcap_datalink_val_to_name(dlt
);
2779 fprintf(stderr
, "reading from file %s", RFileName
);
2780 if (dlt_name
== NULL
) {
2781 fprintf(stderr
, ", link-type %u", dlt
);
2783 fprintf(stderr
, ", link-type %s (%s)",
2785 pcap_datalink_val_to_description(dlt
));
2787 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2791 while (ret
!= NULL
);
2793 if (count_mode
&& RFileName
!= NULL
)
2794 fprintf(stdout
, "%u packet%s\n", packets_captured
,
2795 PLURAL_SUFFIX(packets_captured
));
2798 pcap_freecode(&fcode
);
2799 exit_tcpdump(status
== -1 ? S_ERR_HOST_PROGRAM
: S_SUCCESS
);
2806 (*setsignal (int sig
, void (*func
)(int)))(int)
2809 return (signal(sig
, func
));
2811 struct sigaction old
, new;
2813 memset(&new, 0, sizeof(new));
2814 new.sa_handler
= func
;
2815 if ((sig
== SIGCHLD
)
2816 # ifdef SIGNAL_REQ_INFO
2817 || (sig
== SIGNAL_REQ_INFO
)
2819 # ifdef SIGNAL_FLUSH_PCAP
2820 || (sig
== SIGNAL_FLUSH_PCAP
)
2823 new.sa_flags
= SA_RESTART
;
2824 if (sigaction(sig
, &new, &old
) < 0)
2825 /* The same workaround as for SIG_DFL above. */
2827 DIAG_OFF_STRICT_PROTOTYPES
2828 #endif /* __illumos__ */
2831 DIAG_ON_STRICT_PROTOTYPES
2832 #endif /* __illumos__ */
2833 return (old
.sa_handler
);
2837 /* make a clean exit on interrupts */
2839 cleanup(int signo _U_
)
2842 if (timer_handle
!= INVALID_HANDLE_VALUE
) {
2843 DeleteTimerQueueTimer(NULL
, timer_handle
, NULL
);
2844 CloseHandle(timer_handle
);
2845 timer_handle
= INVALID_HANDLE_VALUE
;
2848 struct itimerval timer
;
2850 timer
.it_interval
.tv_sec
= 0;
2851 timer
.it_interval
.tv_usec
= 0;
2852 timer
.it_value
.tv_sec
= 0;
2853 timer
.it_value
.tv_usec
= 0;
2854 setitimer(ITIMER_REAL
, &timer
, NULL
);
2857 #ifdef HAVE_PCAP_BREAKLOOP
2859 * We have "pcap_breakloop()"; use it, so that we do as little
2860 * as possible in the signal handler (it's probably not safe
2861 * to do anything with standard I/O streams in a signal handler -
2862 * the ANSI C standard doesn't say it is).
2867 * We don't have "pcap_breakloop()"; this isn't safe, but
2868 * it's the best we can do. Print the summary if we're
2869 * not reading from a savefile - i.e., if we're doing a
2870 * live capture - and exit.
2872 if (pd
!= NULL
&& pcap_file(pd
) == NULL
) {
2874 * We got interrupted, so perhaps we didn't
2875 * manage to finish a line we were printing.
2876 * Print an extra newline, just in case.
2879 (void)fflush(stdout
);
2882 exit_tcpdump(S_SUCCESS
);
2887 On windows, we do not use a fork, so we do not care less about
2888 waiting a child processes to die
2890 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2892 child_cleanup(int signo _U_
)
2894 while (waitpid(-1, NULL
, WNOHANG
) >= 0);
2896 #endif /* HAVE_FORK && HAVE_VFORK */
2901 struct pcap_stat stats
;
2904 * Older versions of libpcap didn't set ps_ifdrop on some
2905 * platforms; initialize it to 0 to handle that.
2907 stats
.ps_ifdrop
= 0;
2908 if (pcap_stats(pd
, &stats
) < 0) {
2909 (void)fprintf(stderr
, "pcap_stats: %s\n", pcap_geterr(pd
));
2915 fprintf(stderr
, "%s: ", program_name
);
2917 (void)fprintf(stderr
, "%u packet%s captured", packets_captured
,
2918 PLURAL_SUFFIX(packets_captured
));
2920 fputs(", ", stderr
);
2923 (void)fprintf(stderr
, "%u packet%s received by filter", stats
.ps_recv
,
2924 PLURAL_SUFFIX(stats
.ps_recv
));
2926 fputs(", ", stderr
);
2929 (void)fprintf(stderr
, "%u packet%s dropped by kernel", stats
.ps_drop
,
2930 PLURAL_SUFFIX(stats
.ps_drop
));
2931 if (stats
.ps_ifdrop
!= 0) {
2933 fputs(", ", stderr
);
2936 (void)fprintf(stderr
, "%u packet%s dropped by interface\n",
2937 stats
.ps_ifdrop
, PLURAL_SUFFIX(stats
.ps_ifdrop
));
2943 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2945 #define fork_subprocess() fork()
2947 #define fork_subprocess() vfork()
2950 compress_savefile(const char *filename
)
2954 child
= fork_subprocess();
2957 "compress_savefile: fork failed: %s\n",
2958 pcap_strerror(errno
));
2962 /* Parent process. */
2968 * Set to lowest priority so that this doesn't disturb the capture.
2971 setpriority(PRIO_PROCESS
, 0, NZERO
- 1);
2973 setpriority(PRIO_PROCESS
, 0, 19);
2975 if (execlp(zflag
, zflag
, filename
, (char *)NULL
) == -1)
2977 "compress_savefile: execlp(%s, %s) failed: %s\n",
2980 pcap_strerror(errno
));
2982 exit(S_ERR_HOST_PROGRAM
);
2984 _exit(S_ERR_HOST_PROGRAM
);
2987 #else /* HAVE_FORK && HAVE_VFORK */
2989 compress_savefile(const char *filename
)
2992 "compress_savefile failed. Functionality not implemented under your system\n");
2994 #endif /* HAVE_FORK && HAVE_VFORK */
2997 dump_packet_and_trunc(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
2999 struct dump_info
*dump_info
;
3005 dump_info
= (struct dump_info
*)user
;
3008 * XXX - this won't force the file to rotate on the specified time
3009 * boundary, but it will rotate on the first packet received after the
3010 * specified Gflag number of seconds. Note: if a Gflag time boundary
3011 * and a Cflag size boundary coincide, the time rotation will occur
3012 * first thereby cancelling the Cflag boundary (since the file should
3016 /* Check if it is time to rotate */
3019 /* Get the current time */
3020 if ((t
= time(NULL
)) == (time_t)-1) {
3021 error("%s: can't get current_time: %s",
3022 __func__
, pcap_strerror(errno
));
3026 /* If the time is greater than the specified window, rotate */
3027 if (t
- Gflag_time
>= Gflag
) {
3028 #ifdef HAVE_CAPSICUM
3033 /* Update the Gflag_time */
3035 /* Update Gflag_count */
3038 * Close the current file and open a new one.
3040 pcap_dump_close(dump_info
->pdd
);
3043 * Compress the file we just closed, if the user asked for it
3046 compress_savefile(dump_info
->CurrentFileName
);
3049 * Check to see if we've exceeded the Wflag (when
3052 if (Cflag
== 0 && Wflag
> 0 && Gflag_count
>= Wflag
) {
3053 (void)fprintf(stderr
, "Maximum file limit reached: %d\n",
3056 exit_tcpdump(S_SUCCESS
);
3059 if (dump_info
->CurrentFileName
!= NULL
)
3060 free(dump_info
->CurrentFileName
);
3061 /* Allocate space for max filename + \0. */
3062 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3063 if (dump_info
->CurrentFileName
== NULL
)
3064 error("dump_packet_and_trunc: malloc");
3066 * Gflag was set otherwise we wouldn't be here. Reset the count
3067 * so multiple files would end with 1,2,3 in the filename.
3068 * The counting is handled with the -C flow after this.
3073 * This is always the first file in the Cflag
3075 * We also don't need numbering if Cflag is not set.
3078 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0,
3081 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0, 0);
3083 #ifdef HAVE_LIBCAP_NG
3084 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3085 capng_apply(CAPNG_SELECT_BOTH
);
3086 #endif /* HAVE_LIBCAP_NG */
3087 #ifdef HAVE_CAPSICUM
3088 fd
= openat(dump_info
->dirfd
,
3089 dump_info
->CurrentFileName
,
3090 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3092 error("unable to open file %s",
3093 dump_info
->CurrentFileName
);
3095 fp
= fdopen(fd
, "w");
3097 error("unable to fdopen file %s",
3098 dump_info
->CurrentFileName
);
3100 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3101 #else /* !HAVE_CAPSICUM */
3102 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3104 #ifdef HAVE_LIBCAP_NG
3105 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3106 capng_apply(CAPNG_SELECT_BOTH
);
3107 #endif /* HAVE_LIBCAP_NG */
3108 if (dump_info
->pdd
== NULL
)
3109 error("%s", pcap_geterr(pd
));
3110 #ifdef HAVE_CAPSICUM
3111 set_dumper_capsicum_rights(dump_info
->pdd
);
3117 * XXX - this won't prevent capture files from getting
3118 * larger than Cflag - the last packet written to the
3119 * file could put it over Cflag.
3122 #ifdef HAVE_PCAP_DUMP_FTELL64
3123 int64_t size
= pcap_dump_ftell64(dump_info
->pdd
);
3126 * XXX - this only handles a Cflag value > 2^31-1 on
3127 * LP64 platforms; to handle ILP32 (32-bit UN*X and
3128 * Windows) or LLP64 (64-bit Windows) would require
3129 * a version of libpcap with pcap_dump_ftell64().
3131 long size
= pcap_dump_ftell(dump_info
->pdd
);
3135 error("ftell fails on output file");
3137 #ifdef HAVE_CAPSICUM
3143 * Close the current file and open a new one.
3145 pcap_dump_close(dump_info
->pdd
);
3148 * Compress the file we just closed, if the user
3152 compress_savefile(dump_info
->CurrentFileName
);
3156 if (Cflag_count
>= Wflag
)
3159 if (dump_info
->CurrentFileName
!= NULL
)
3160 free(dump_info
->CurrentFileName
);
3161 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3162 if (dump_info
->CurrentFileName
== NULL
)
3163 error("%s: malloc", __func__
);
3164 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, Cflag_count
, WflagChars
);
3165 #ifdef HAVE_LIBCAP_NG
3166 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3167 capng_apply(CAPNG_SELECT_BOTH
);
3168 #endif /* HAVE_LIBCAP_NG */
3169 #ifdef HAVE_CAPSICUM
3170 fd
= openat(dump_info
->dirfd
, dump_info
->CurrentFileName
,
3171 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3173 error("unable to open file %s",
3174 dump_info
->CurrentFileName
);
3176 fp
= fdopen(fd
, "w");
3178 error("unable to fdopen file %s",
3179 dump_info
->CurrentFileName
);
3181 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3182 #else /* !HAVE_CAPSICUM */
3183 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3185 #ifdef HAVE_LIBCAP_NG
3186 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3187 capng_apply(CAPNG_SELECT_BOTH
);
3188 #endif /* HAVE_LIBCAP_NG */
3189 if (dump_info
->pdd
== NULL
)
3190 error("%s", pcap_geterr(pd
));
3191 #ifdef HAVE_CAPSICUM
3192 set_dumper_capsicum_rights(dump_info
->pdd
);
3197 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3198 #ifdef HAVE_PCAP_DUMP_FLUSH
3200 pcap_dump_flush(dump_info
->pdd
);
3203 if (dump_info
->ndo
!= NULL
)
3204 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3212 dump_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3214 struct dump_info
*dump_info
;
3220 dump_info
= (struct dump_info
*)user
;
3222 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3223 #ifdef HAVE_PCAP_DUMP_FLUSH
3225 pcap_dump_flush(dump_info
->pdd
);
3228 if (dump_info
->ndo
!= NULL
)
3229 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3237 print_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3244 pretty_print_packet((netdissect_options
*)user
, h
, sp
, packets_captured
);
3251 #ifdef SIGNAL_REQ_INFO
3253 requestinfo(int signo _U_
)
3262 #ifdef SIGNAL_FLUSH_PCAP
3264 flushpcap(int signo _U_
)
3267 pcap_dump_flush(pdd
);
3272 print_packets_captured (void)
3274 static u_int prev_packets_captured
, first
= 1;
3276 if (infodelay
== 0 && (first
|| packets_captured
!= prev_packets_captured
)) {
3277 fprintf(stderr
, "Got %u\r", packets_captured
);
3279 prev_packets_captured
= packets_captured
;
3284 * Called once each second in verbose mode while dumping to file
3287 static void CALLBACK
verbose_stats_dump(PVOID param _U_
,
3288 BOOLEAN timer_fired _U_
)
3290 print_packets_captured();
3293 static void verbose_stats_dump(int sig _U_
)
3295 print_packets_captured();
3299 DIAG_OFF_DEPRECATION
3301 print_version(FILE *f
)
3303 #ifndef HAVE_PCAP_LIB_VERSION
3304 #ifdef HAVE_PCAP_VERSION
3305 extern char pcap_version
[];
3306 #else /* HAVE_PCAP_VERSION */
3307 static char pcap_version
[] = "unknown";
3308 #endif /* HAVE_PCAP_VERSION */
3309 #endif /* HAVE_PCAP_LIB_VERSION */
3310 const char *smi_version_string
;
3312 (void)fprintf(f
, "%s version " PACKAGE_VERSION
"\n", program_name
);
3313 #ifdef HAVE_PCAP_LIB_VERSION
3314 (void)fprintf(f
, "%s\n", pcap_lib_version());
3315 #else /* HAVE_PCAP_LIB_VERSION */
3316 (void)fprintf(f
, "libpcap version %s\n", pcap_version
);
3317 #endif /* HAVE_PCAP_LIB_VERSION */
3319 #if defined(HAVE_LIBCRYPTO) && defined(SSLEAY_VERSION)
3320 (void)fprintf (f
, "%s\n", SSLeay_version(SSLEAY_VERSION
));
3323 smi_version_string
= nd_smi_version_string();
3324 if (smi_version_string
!= NULL
)
3325 (void)fprintf (f
, "SMI-library: %s\n", smi_version_string
);
3327 #if defined(__SANITIZE_ADDRESS__)
3328 (void)fprintf (f
, "Compiled with AddressSanitizer/GCC.\n");
3329 #elif defined(__has_feature)
3330 # if __has_feature(address_sanitizer)
3331 (void)fprintf (f
, "Compiled with AddressSanitizer/Clang.\n");
3332 # elif __has_feature(memory_sanitizer)
3333 (void)fprintf (f
, "Compiled with MemorySanitizer/Clang.\n");
3335 #endif /* __SANITIZE_ADDRESS__ or __has_feature */
3336 (void)fprintf (f
, "%zu-bit build, %zu-bit time_t\n",
3337 sizeof(void *) * 8, sizeof(time_t) * 8);
3342 print_usage(FILE *f
)
3346 "Usage: %s [-Abd" D_FLAG
"efhH" I_FLAG J_FLAG
"KlLnNOpqStu" U_FLAG
"vxX#]" B_FLAG_USAGE
" [ -c count ] [--count]\n", program_name
);
3348 "\t\t[ -C file_size ] [ -E algo:secret ] [ -F file ] [ -G seconds ]\n");
3350 "\t\t[ -i interface ]" IMMEDIATE_MODE_USAGE j_FLAG_USAGE
"\n");
3352 "\t\t[ --lengths ]" LIST_REMOTE_INTERFACES_USAGE
"\n");
3355 "\t\t" m_FLAG_USAGE
"\n");
3358 "\t\t[ -M secret ] [ --number ] [ --print ]\n");
3360 "\t\t[ --print-sampling nth ]" Q_FLAG_USAGE
" [ -r file ]\n");
3362 "\t\t[ -s snaplen ] [ -T type ] [ --version ]\n");
3364 "\t\t[ -V file ] [ -w file ] [ -W filecount ] [ -y datalinktype ]\n");
3365 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
3367 "\t\t[ --time-stamp-precision precision ] [ --micro ] [ --nano ]\n");
3370 "\t\t[ -z postrotate-command ] [ -Z user ] [ expression ]\n");