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"
160 #include "pcap-missing.h"
161 #include "ascii_strcasecmp.h"
165 #include "diag-control.h"
170 #define PATH_MAX 1024
174 #define SIGNAL_REQ_INFO SIGINFO
175 #elif defined(SIGUSR1)
176 #define SIGNAL_REQ_INFO SIGUSR1
179 #if defined(HAVE_PCAP_DUMP_FLUSH) && defined(SIGUSR2)
180 #define SIGNAL_FLUSH_PCAP SIGUSR2
183 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
184 static int Bflag
; /* buffer size */
186 #ifdef HAVE_PCAP_DUMP_FTELL64
187 static int64_t Cflag
; /* rotate dump files after this many bytes */
189 static long Cflag
; /* rotate dump files after this many bytes */
191 static int Cflag_count
; /* Keep track of which file number we're writing */
192 #ifdef HAVE_PCAP_FINDALLDEVS
193 static int Dflag
; /* list available devices and exit */
195 #ifdef HAVE_PCAP_FINDALLDEVS_EX
196 static char *remote_interfaces_source
; /* list available devices from this source and exit */
200 * This is exported because, in some versions of libpcap, if libpcap
201 * is built with optimizer debugging code (which is *NOT* the default
202 * configuration!), the library *imports*(!) a variable named dflag,
203 * under the expectation that tcpdump is exporting it, to govern
204 * how much debugging information to print when optimizing
205 * the generated BPF code.
207 * This is a horrible hack; newer versions of libpcap don't import
208 * dflag but, instead, *if* built with optimizer debugging code,
209 * *export* a routine to set that flag.
212 int dflag
; /* print filter code */
213 static int Gflag
; /* rotate dump files after this many seconds */
214 static int Gflag_count
; /* number of files created with Gflag rotation */
215 static time_t Gflag_time
; /* The last time_t the dump file was rotated. */
216 static int Lflag
; /* list available data link types and exit */
217 static int Iflag
; /* rfmon (monitor) mode */
218 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
219 static int Jflag
; /* list available time stamp types */
220 static int jflag
= -1; /* packet time stamp source */
222 static int lflag
; /* line-buffered output */
223 static int pflag
; /* don't go promiscuous */
224 #ifdef HAVE_PCAP_SETDIRECTION
225 static int Qflag
= -1; /* restrict captured packet by send/receive direction */
227 #ifdef HAVE_PCAP_DUMP_FLUSH
228 static int Uflag
; /* "unbuffered" output of dump files */
230 static int Wflag
; /* recycle output files after this number of files */
231 static int WflagChars
;
232 static char *zflag
= NULL
; /* compress each savefile using a specified command (like gzip or bzip2) */
233 static int timeout
= 1000; /* default timeout = 1000 ms = 1 s */
234 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
235 static int immediate_mode
;
237 static int count_mode
;
239 static int infodelay
;
240 static int infoprint
;
245 static void (*setsignal (int sig
, void (*func
)(int)))(int);
246 static void cleanup(int);
247 static void child_cleanup(int);
248 static void print_version(FILE *);
249 static void print_usage(FILE *);
251 static void print_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
252 static void dump_packet_and_trunc(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
253 static void dump_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
255 #ifdef SIGNAL_REQ_INFO
256 static void requestinfo(int);
259 #ifdef SIGNAL_FLUSH_PCAP
260 static void flushpcap(int);
264 static HANDLE timer_handle
= INVALID_HANDLE_VALUE
;
265 static void CALLBACK
verbose_stats_dump(PVOID param
, BOOLEAN timer_fired
);
267 static void verbose_stats_dump(int sig
);
270 static void info(int);
271 static u_int packets_captured
;
273 #ifdef HAVE_PCAP_FINDALLDEVS
274 static const struct tok status_flags
[] = {
276 { PCAP_IF_UP
, "Up" },
278 #ifdef PCAP_IF_RUNNING
279 { PCAP_IF_RUNNING
, "Running" },
281 { PCAP_IF_LOOPBACK
, "Loopback" },
282 #ifdef PCAP_IF_WIRELESS
283 { PCAP_IF_WIRELESS
, "Wireless" },
290 static pcap_dumper_t
*pdd
= NULL
;
292 static int supports_monitor_mode
;
300 char *CurrentFileName
;
303 netdissect_options
*ndo
;
309 #if defined(HAVE_PCAP_SET_PARSER_DEBUG)
311 * We have pcap_set_parser_debug() in libpcap; declare it (it's not declared
312 * by any libpcap header, because it's a special hack, only available if
313 * libpcap was configured to include it, and only intended for use by
314 * libpcap developers trying to debug the parser for filter expressions).
317 __declspec(dllimport
)
321 void pcap_set_parser_debug(int);
322 #elif defined(HAVE_PCAP_DEBUG) || defined(HAVE_YYDEBUG)
324 * We don't have pcap_set_parser_debug() in libpcap, but we do have
325 * pcap_debug or yydebug. Make a local version of pcap_set_parser_debug()
326 * to set the flag, and define HAVE_PCAP_SET_PARSER_DEBUG.
329 pcap_set_parser_debug(int value
)
331 #ifdef HAVE_PCAP_DEBUG
332 extern int pcap_debug
;
335 #else /* HAVE_PCAP_DEBUG */
339 #endif /* HAVE_PCAP_DEBUG */
342 #define HAVE_PCAP_SET_PARSER_DEBUG
345 #if defined(HAVE_PCAP_SET_OPTIMIZER_DEBUG)
347 * We have pcap_set_optimizer_debug() in libpcap; declare it (it's not declared
348 * by any libpcap header, because it's a special hack, only available if
349 * libpcap was configured to include it, and only intended for use by
350 * libpcap developers trying to debug the optimizer for filter expressions).
353 __declspec(dllimport
)
357 void pcap_set_optimizer_debug(int);
361 exit_tcpdump(const int status
)
368 static void NORETURN
PRINTFLIKE(1, 2)
369 error(FORMAT_STRING(const char *fmt
), ...)
373 (void)fprintf(stderr
, "%s: ", program_name
);
375 (void)vfprintf(stderr
, fmt
, ap
);
380 (void)fputc('\n', stderr
);
382 exit_tcpdump(S_ERR_HOST_PROGRAM
);
387 static void PRINTFLIKE(1, 2)
388 warning(FORMAT_STRING(const char *fmt
), ...)
392 (void)fprintf(stderr
, "%s: WARNING: ", program_name
);
394 (void)vfprintf(stderr
, fmt
, ap
);
399 (void)fputc('\n', stderr
);
403 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
405 show_tstamp_types_and_exit(pcap_t
*pc
, const char *device
)
408 int *tstamp_types
= 0;
409 const char *tstamp_type_name
;
412 n_tstamp_types
= pcap_list_tstamp_types(pc
, &tstamp_types
);
413 if (n_tstamp_types
< 0)
414 error("%s", pcap_geterr(pc
));
416 if (n_tstamp_types
== 0) {
417 fprintf(stderr
, "Time stamp type cannot be set for %s\n",
419 exit_tcpdump(S_SUCCESS
);
421 fprintf(stdout
, "Time stamp types for %s (use option -j to set):\n",
423 for (i
= 0; i
< n_tstamp_types
; i
++) {
424 tstamp_type_name
= pcap_tstamp_type_val_to_name(tstamp_types
[i
]);
425 if (tstamp_type_name
!= NULL
) {
426 (void) fprintf(stdout
, " %s (%s)\n", tstamp_type_name
,
427 pcap_tstamp_type_val_to_description(tstamp_types
[i
]));
429 (void) fprintf(stdout
, " %d\n", tstamp_types
[i
]);
432 pcap_free_tstamp_types(tstamp_types
);
433 exit_tcpdump(S_SUCCESS
);
438 show_dlts_and_exit(pcap_t
*pc
, const char *device
)
442 const char *dlt_name
;
444 n_dlts
= pcap_list_datalinks(pc
, &dlts
);
446 error("%s", pcap_geterr(pc
));
447 else if (n_dlts
== 0 || !dlts
)
448 error("No data link types.");
451 * If the interface is known to support monitor mode, indicate
452 * whether these are the data link types available when not in
453 * monitor mode, if -I wasn't specified, or when in monitor mode,
454 * when -I was specified (the link-layer types available in
455 * monitor mode might be different from the ones available when
456 * not in monitor mode).
458 (void) fprintf(stdout
, "Data link types for ");
459 if (supports_monitor_mode
)
460 (void) fprintf(stdout
, "%s %s",
462 Iflag
? "when in monitor mode" : "when not in monitor mode");
464 (void) fprintf(stdout
, "%s",
466 (void) fprintf(stdout
, " (use option -y to set):\n");
468 for (i
= 0; i
< n_dlts
; i
++) {
469 dlt_name
= pcap_datalink_val_to_name(dlts
[i
]);
470 if (dlt_name
!= NULL
) {
471 (void) fprintf(stdout
, " %s (%s)", dlt_name
,
472 pcap_datalink_val_to_description(dlts
[i
]));
475 * OK, does tcpdump handle that type?
477 if (!has_printer(dlts
[i
]))
478 (void) fprintf(stdout
, " (printing not supported)");
479 fprintf(stdout
, "\n");
481 (void) fprintf(stdout
, " DLT %d (printing not supported)\n",
485 #ifdef HAVE_PCAP_FREE_DATALINKS
486 pcap_free_datalinks(dlts
);
488 exit_tcpdump(S_SUCCESS
);
491 #ifdef HAVE_PCAP_FINDALLDEVS
493 show_devices_and_exit(void)
495 pcap_if_t
*dev
, *devlist
;
496 char ebuf
[PCAP_ERRBUF_SIZE
];
499 if (pcap_findalldevs(&devlist
, ebuf
) < 0)
501 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
502 printf("%d.%s", i
+1, dev
->name
);
503 if (dev
->description
!= NULL
)
504 printf(" (%s)", dev
->description
);
505 if (dev
->flags
!= 0) {
507 printf("%s", bittok2str(status_flags
, "none", dev
->flags
));
508 #ifdef PCAP_IF_WIRELESS
509 if (dev
->flags
& PCAP_IF_WIRELESS
) {
510 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
512 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
513 printf(", Association status unknown");
516 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
517 printf(", Associated");
520 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
521 printf(", Not associated");
524 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
528 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
530 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
531 printf(", Connection status unknown");
534 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
535 printf(", Connected");
538 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
539 printf(", Disconnected");
542 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
551 pcap_freealldevs(devlist
);
552 exit_tcpdump(S_SUCCESS
);
554 #endif /* HAVE_PCAP_FINDALLDEVS */
556 #ifdef HAVE_PCAP_FINDALLDEVS_EX
558 show_remote_devices_and_exit(void)
560 pcap_if_t
*dev
, *devlist
;
561 char ebuf
[PCAP_ERRBUF_SIZE
];
564 if (pcap_findalldevs_ex(remote_interfaces_source
, NULL
, &devlist
,
566 if (strcmp(ebuf
, "not supported") == 0) {
568 * macOS 14's pcap_findalldevs_ex(), which is a
569 * stub that always returns -1 with an error
570 * message of "not supported".
572 * In this case, as we passed it an rpcap://
573 * URL, treat that as meaning "remote capture
576 error("Remote capture not supported");
580 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
581 printf("%d.%s", i
+1, dev
->name
);
582 if (dev
->description
!= NULL
)
583 printf(" (%s)", dev
->description
);
585 printf(" [%s]", bittok2str(status_flags
, "none", dev
->flags
));
588 pcap_freealldevs(devlist
);
589 exit_tcpdump(S_SUCCESS
);
591 #endif /* HAVE_PCAP_FINDALLDEVS */
596 * Note that there we use all letters for short options except for g, k,
597 * o, and P, and those are used by other versions of tcpdump, and we should
598 * only use them for the same purposes that the other versions of tcpdump
601 * macOS tcpdump uses -g to force non--v output for IP to be on one
602 * line, making it more "g"repable;
604 * macOS tcpdump uses -k to specify that packet comments in pcapng files
607 * OpenBSD tcpdump uses -o to indicate that OS fingerprinting should be done
608 * for hosts sending TCP SYN packets;
610 * macOS tcpdump uses -P to indicate that -w should write pcapng rather
613 * macOS tcpdump also uses -Q to specify expressions that match packet
614 * metadata, including but not limited to the packet direction.
615 * The expression syntax is different from a simple "in|out|inout",
616 * and those expressions aren't accepted by macOS tcpdump, but the
617 * equivalents would be "in" = "dir=in", "out" = "dir=out", and
618 * "inout" = "dir=in or dir=out", and the parser could conceivably
619 * special-case "in", "out", and "inout" as expressions for backwards
620 * compatibility, so all is not (yet) lost.
624 * Set up flags that might or might not be supported depending on the
625 * version of libpcap we're using.
627 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
629 #define B_FLAG_USAGE " [ -B size ]"
630 #else /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
633 #endif /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
635 #ifdef HAVE_PCAP_FINDALLDEVS
641 #ifdef HAVE_PCAP_CREATE
643 #else /* HAVE_PCAP_CREATE */
645 #endif /* HAVE_PCAP_CREATE */
647 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
649 #define j_FLAG_USAGE " [ -j tstamptype ]"
651 #else /* PCAP_ERROR_TSTAMP_TYPE_NOTSUP */
655 #endif /* PCAP_ERROR_TSTAMP_TYPE_NOTSUP */
658 #define m_FLAG_USAGE "[ -m module ] ..."
661 #ifdef HAVE_PCAP_SETDIRECTION
663 #define Q_FLAG_USAGE " [ -Q in|out|inout ]"
669 #ifdef HAVE_PCAP_DUMP_FLUSH
675 #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:#"
680 * We do not currently have long options corresponding to all short
681 * options; we should probably pick appropriate option names for them.
683 * However, the short options where the number of times the option is
684 * specified matters, such as -v and -d and -t, should probably not
685 * just map to a long option, as saying
687 * tcpdump --verbose --verbose
689 * doesn't make sense; it should be --verbosity={N} or something such
692 * For long options with no corresponding short options, we define values
693 * outside the range of ASCII graphic characters, make that the last
694 * component of the entry for the long option, and have a case for that
695 * option in the switch statement.
697 #define OPTION_VERSION 128
698 #define OPTION_TSTAMP_PRECISION 129
699 #define OPTION_IMMEDIATE_MODE 130
700 #define OPTION_PRINT 131
701 #define OPTION_LIST_REMOTE_INTERFACES 132
702 #define OPTION_TSTAMP_MICRO 133
703 #define OPTION_TSTAMP_NANO 134
704 #define OPTION_FP_TYPE 135
705 #define OPTION_COUNT 136
706 #define OPTION_PRINT_SAMPLING 137
707 #define OPTION_LENGTHS 138
709 static const struct option longopts
[] = {
710 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
711 { "buffer-size", required_argument
, NULL
, 'B' },
713 { "list-interfaces", no_argument
, NULL
, 'D' },
714 #ifdef HAVE_PCAP_FINDALLDEVS_EX
715 { "list-remote-interfaces", required_argument
, NULL
, OPTION_LIST_REMOTE_INTERFACES
},
717 { "help", no_argument
, NULL
, 'h' },
718 { "interface", required_argument
, NULL
, 'i' },
719 #ifdef HAVE_PCAP_CREATE
720 { "monitor-mode", no_argument
, NULL
, 'I' },
722 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
723 { "time-stamp-type", required_argument
, NULL
, 'j' },
724 { "list-time-stamp-types", no_argument
, NULL
, 'J' },
726 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
727 { "micro", no_argument
, NULL
, OPTION_TSTAMP_MICRO
},
728 { "nano", no_argument
, NULL
, OPTION_TSTAMP_NANO
},
729 { "time-stamp-precision", required_argument
, NULL
, OPTION_TSTAMP_PRECISION
},
731 { "dont-verify-checksums", no_argument
, NULL
, 'K' },
732 { "list-data-link-types", no_argument
, NULL
, 'L' },
733 { "no-optimize", no_argument
, NULL
, 'O' },
734 { "no-promiscuous-mode", no_argument
, NULL
, 'p' },
735 #ifdef HAVE_PCAP_SETDIRECTION
736 { "direction", required_argument
, NULL
, 'Q' },
738 { "snapshot-length", required_argument
, NULL
, 's' },
739 { "absolute-tcp-sequence-numbers", no_argument
, NULL
, 'S' },
740 #ifdef HAVE_PCAP_DUMP_FLUSH
741 { "packet-buffered", no_argument
, NULL
, 'U' },
743 { "linktype", required_argument
, NULL
, 'y' },
744 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
745 { "immediate-mode", no_argument
, NULL
, OPTION_IMMEDIATE_MODE
},
747 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
748 { "debug-filter-parser", no_argument
, NULL
, 'Y' },
750 { "relinquish-privileges", required_argument
, NULL
, 'Z' },
751 { "count", no_argument
, NULL
, OPTION_COUNT
},
752 { "fp-type", no_argument
, NULL
, OPTION_FP_TYPE
},
753 { "number", no_argument
, NULL
, '#' },
754 { "print", no_argument
, NULL
, OPTION_PRINT
},
755 { "print-sampling", required_argument
, NULL
, OPTION_PRINT_SAMPLING
},
756 { "lengths", no_argument
, NULL
, OPTION_LENGTHS
},
757 { "version", no_argument
, NULL
, OPTION_VERSION
},
761 #ifdef HAVE_PCAP_FINDALLDEVS_EX
762 #define LIST_REMOTE_INTERFACES_USAGE " [ --list-remote-interfaces remote-source ]"
764 #define LIST_REMOTE_INTERFACES_USAGE
767 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
768 #define IMMEDIATE_MODE_USAGE " [ --immediate-mode ]"
770 #define IMMEDIATE_MODE_USAGE ""
774 /* Drop root privileges and chroot if necessary */
776 droproot(const char *username
, const char *chroot_dir
)
778 struct passwd
*pw
= NULL
;
780 if (chroot_dir
&& !username
)
781 error("Chroot without dropping root is insecure");
783 pw
= getpwnam(username
);
786 if (chroot(chroot_dir
) != 0 || chdir ("/") != 0)
787 error("Couldn't chroot/chdir to '%.64s': %s",
788 chroot_dir
, pcap_strerror(errno
));
790 #ifdef HAVE_LIBCAP_NG
792 int ret
= capng_change_id(pw
->pw_uid
, pw
->pw_gid
, CAPNG_NO_FLAG
);
794 error("capng_change_id(): return %d\n", ret
);
796 fprintf(stderr
, "dropped privs to %s\n", username
);
799 if (initgroups(pw
->pw_name
, pw
->pw_gid
) != 0 ||
800 setgid(pw
->pw_gid
) != 0 || setuid(pw
->pw_uid
) != 0)
801 error("Couldn't change to '%.32s' uid=%lu gid=%lu: %s",
803 (unsigned long)pw
->pw_uid
,
804 (unsigned long)pw
->pw_gid
,
805 pcap_strerror(errno
));
807 fprintf(stderr
, "dropped privs to %s\n", username
);
809 #endif /* HAVE_LIBCAP_NG */
811 error("Couldn't find user '%.32s'", username
);
812 #ifdef HAVE_LIBCAP_NG
813 /* We don't need CAP_SETUID, CAP_SETGID and CAP_SYS_CHROOT anymore. */
817 CAPNG_EFFECTIVE
| CAPNG_PERMITTED
,
823 capng_apply(CAPNG_SELECT_BOTH
);
824 #endif /* HAVE_LIBCAP_NG */
845 MakeFilename(char *buffer
, char *orig_name
, int cnt
, int max_chars
)
847 char *filename
= malloc(PATH_MAX
+ 1);
848 if (filename
== NULL
)
849 error("%s: malloc", __func__
);
850 if (strlen(orig_name
) == 0)
851 error("an empty string is not a valid file name");
853 /* Process with strftime if Gflag is set. */
857 /* Convert Gflag_time to a usable format */
858 if ((local_tm
= localtime(&Gflag_time
)) == NULL
) {
859 error("%s: localtime", __func__
);
862 /* There's no good way to detect an error in strftime since a return
863 * value of 0 isn't necessarily failure; if orig_name is an empty
864 * string, the formatted string will be empty.
866 * However, the C90 standard says that, if there *is* a
867 * buffer overflow, the content of the buffer is undefined,
868 * so we must check for a buffer overflow.
870 * So we check above for an empty orig_name, and only call
871 * strftime() if it's non-empty, in which case the return
872 * value will only be 0 if the formatted date doesn't fit
875 * (We check above because, even if we don't use -G, we
876 * want a better error message than "tcpdump: : No such
877 * file or directory" for this case.)
879 if (strftime(filename
, PATH_MAX
, orig_name
, local_tm
) == 0) {
880 error("%s: strftime", __func__
);
883 strncpy(filename
, orig_name
, PATH_MAX
);
886 if (cnt
== 0 && max_chars
== 0)
887 strncpy(buffer
, filename
, PATH_MAX
+ 1);
889 if (snprintf(buffer
, PATH_MAX
+ 1, "%s%0*d", filename
, max_chars
, cnt
) > PATH_MAX
)
890 /* Report an error if the filename is too large */
891 error("too many output files or filename is too long (> %d)", PATH_MAX
);
896 get_next_file(FILE *VFile
, char *ptr
)
901 ret
= fgets(ptr
, PATH_MAX
, VFile
);
906 if (len
> 0 && ptr
[len
- 1] == '\n')
913 static cap_channel_t
*
916 cap_channel_t
*capcas
, *capdnsloc
;
917 const char *types
[1];
922 error("unable to create casper process");
923 capdnsloc
= cap_service_open(capcas
, "system.dns");
924 /* Casper capability no longer needed. */
926 if (capdnsloc
== NULL
)
927 error("unable to open system.dns service");
928 /* Limit system.dns to reverse DNS lookups. */
930 if (cap_dns_type_limit(capdnsloc
, types
, 1) < 0)
931 error("unable to limit access to system.dns service");
932 families
[0] = AF_INET
;
933 /* Casper is a feature of FreeBSD, which defines AF_INET6. */
934 families
[1] = AF_INET6
;
935 if (cap_dns_family_limit(capdnsloc
, families
, 2) < 0)
936 error("unable to limit access to system.dns service");
940 #endif /* HAVE_CASPER */
942 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
944 tstamp_precision_from_string(const char *precision
)
946 if (strncmp(precision
, "nano", strlen("nano")) == 0)
947 return PCAP_TSTAMP_PRECISION_NANO
;
949 if (strncmp(precision
, "micro", strlen("micro")) == 0)
950 return PCAP_TSTAMP_PRECISION_MICRO
;
956 tstamp_precision_to_string(int precision
)
960 case PCAP_TSTAMP_PRECISION_MICRO
:
963 case PCAP_TSTAMP_PRECISION_NANO
:
974 * Ensure that, on a dump file's descriptor, we have all the rights
975 * necessary to make the standard I/O library work with an fdopen()ed
976 * FILE * from that descriptor.
978 * A long time ago in a galaxy far, far away, AT&T decided that, instead
979 * of providing separate APIs for getting and setting the FD_ flags on a
980 * descriptor, getting and setting the O_ flags on a descriptor, and
981 * locking files, they'd throw them all into a kitchen-sink fcntl() call
982 * along the lines of ioctl(), the fact that ioctl() operations are
983 * largely specific to particular character devices but fcntl() operations
984 * are either generic to all descriptors or generic to all descriptors for
985 * regular files notwithstanding.
987 * The Capsicum people decided that fine-grained control of descriptor
988 * operations was required, so that you need to grant permission for
989 * reading, writing, seeking, and fcntl-ing. The latter, courtesy of
990 * AT&T's decision, means that "fcntl-ing" isn't a thing, but a motley
991 * collection of things, so there are *individual* fcntls for which
992 * permission needs to be granted.
994 * The FreeBSD standard I/O people implemented some optimizations that
995 * requires that the standard I/O routines be able to determine whether
996 * the descriptor for the FILE * is open append-only or not; as that
997 * descriptor could have come from an open() rather than an fopen(),
998 * that requires that it be able to do an F_GETFL fcntl() to read
1001 * tcpdump uses ftell() to determine how much data has been written
1002 * to a file in order to, when used with -C, determine when it's time
1003 * to rotate capture files. ftell() therefore needs to do an lseek()
1004 * to find out the file offset and must, thanks to the aforementioned
1005 * optimization, also know whether the descriptor is open append-only
1008 * The net result of all the above is that we need to grant CAP_SEEK,
1009 * CAP_WRITE, and CAP_FCNTL with the CAP_FCNTL_GETFL subcapability.
1011 * Perhaps this is the universe's way of saying that either
1013 * 1) there needs to be an fopenat() call and a pcap_dump_openat() call
1014 * using it, so that Capsicum-capable tcpdump wouldn't need to do
1019 * 2) there needs to be a cap_fdopen() call in the FreeBSD standard
1020 * I/O library that knows what rights are needed by the standard
1021 * I/O library, based on the open mode, and assigns them, perhaps
1022 * with an additional argument indicating, for example, whether
1023 * seeking should be allowed, so that tcpdump doesn't need to know
1024 * what the standard I/O library happens to require this week.
1027 set_dumper_capsicum_rights(pcap_dumper_t
*p
)
1029 int fd
= fileno(pcap_dump_file(p
));
1030 cap_rights_t rights
;
1032 cap_rights_init(&rights
, CAP_SEEK
, CAP_WRITE
, CAP_FCNTL
);
1033 if (cap_rights_limit(fd
, &rights
) < 0 && errno
!= ENOSYS
) {
1034 error("unable to limit dump descriptor");
1036 if (cap_fcntls_limit(fd
, CAP_FCNTL_GETFL
) < 0 && errno
!= ENOSYS
) {
1037 error("unable to limit dump descriptor fcntls");
1043 * Copy arg vector into a new buffer, concatenating arguments with spaces.
1046 copy_argv(char **argv
)
1058 len
+= strlen(*p
++) + 1;
1060 buf
= (char *)malloc(len
);
1062 error("%s: malloc", __func__
);
1066 while ((src
= *p
++) != NULL
) {
1067 while ((*dst
++ = *src
++) != '\0')
1077 * On Windows, we need to open the file in binary mode, so that
1078 * we get all the bytes specified by the size we get from "fstat()".
1079 * On UNIX, that's not necessary. O_BINARY is defined on Windows;
1080 * we define it as 0 if it's not defined, so it does nothing.
1087 read_infile(char *fname
)
1094 fd
= open(fname
, O_RDONLY
|O_BINARY
);
1096 error("can't open %s: %s", fname
, pcap_strerror(errno
));
1098 if (our_fstat(fd
, &buf
) < 0)
1099 error("can't stat %s: %s", fname
, pcap_strerror(errno
));
1102 * Reject files whose size doesn't fit into an int; a filter
1103 * *that* large will probably be too big.
1105 if (buf
.st_size
> INT_MAX
)
1106 error("%s is too large", fname
);
1108 cp
= malloc((u_int
)buf
.st_size
+ 1);
1110 error("malloc(%d) for %s: %s", (u_int
)buf
.st_size
+ 1,
1111 fname
, pcap_strerror(errno
));
1112 cc
= read(fd
, cp
, (u_int
)buf
.st_size
);
1114 error("read %s: %s", fname
, pcap_strerror(errno
));
1115 if (cc
!= buf
.st_size
)
1116 error("short read %s (%d != %d)", fname
, (int) cc
,
1120 /* replace "# comment" with spaces */
1121 for (i
= 0; i
< cc
; i
++) {
1123 while (i
< cc
&& cp
[i
] != '\n')
1130 #ifdef HAVE_PCAP_FINDALLDEVS
1132 parse_interface_number(const char *device
)
1139 * Search for a colon, terminating any scheme at the beginning
1142 p
= strchr(device
, ':');
1145 * We found it. Is it followed by "//"?
1147 p
++; /* skip the : */
1148 if (strncmp(p
, "//", 2) == 0) {
1150 * Yes. Search for the next /, at the end of the
1151 * authority part of the URL.
1153 p
+= 2; /* skip the // */
1157 * OK, past the / is the path.
1163 devnum
= strtol(device
, &end
, 10);
1164 if (device
!= end
&& *end
== '\0') {
1166 * It's all-numeric, but is it a valid number?
1170 * No, it's not an ordinal.
1172 error("Invalid adapter index");
1177 * It's not all-numeric; return -1, so our caller
1185 find_interface_by_number(const char *url
1186 #ifndef HAVE_PCAP_FINDALLDEVS_EX
1191 pcap_if_t
*dev
, *devlist
;
1193 char ebuf
[PCAP_ERRBUF_SIZE
];
1195 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1201 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1203 * Search for a colon, terminating any scheme at the beginning
1206 endp
= strchr(url
, ':');
1209 * We found it. Is it followed by "//"?
1211 endp
++; /* skip the : */
1212 if (strncmp(endp
, "//", 2) == 0) {
1214 * Yes. Search for the next /, at the end of the
1215 * authority part of the URL.
1217 endp
+= 2; /* skip the // */
1218 endp
= strchr(endp
, '/');
1224 * OK, everything from device to endp is a URL to hand
1225 * to pcap_findalldevs_ex().
1227 endp
++; /* Include the trailing / in the URL; pcap_findalldevs_ex() requires it */
1228 host_url
= malloc(endp
- url
+ 1);
1229 if (host_url
== NULL
&& (endp
- url
+ 1) > 0)
1230 error("Invalid allocation for host");
1232 memcpy(host_url
, url
, endp
- url
);
1233 host_url
[endp
- url
] = '\0';
1234 status
= pcap_findalldevs_ex(host_url
, NULL
, &devlist
, ebuf
);
1238 status
= pcap_findalldevs(&devlist
, ebuf
);
1242 * Look for the devnum-th entry in the list of devices (1-based).
1244 for (i
= 0, dev
= devlist
; i
< devnum
-1 && dev
!= NULL
;
1245 i
++, dev
= dev
->next
)
1248 error("Invalid adapter index");
1249 device
= strdup(dev
->name
);
1250 pcap_freealldevs(devlist
);
1255 #ifdef HAVE_PCAP_OPEN
1257 * Prefixes for rpcap URLs.
1259 static char rpcap_prefix
[] = "rpcap://";
1260 static char rpcap_ssl_prefix
[] = "rpcaps://";
1264 open_interface(const char *device
, netdissect_options
*ndo
, char *ebuf
)
1267 #ifdef HAVE_PCAP_CREATE
1272 #ifdef HAVE_PCAP_OPEN
1274 * Is this an rpcap URL?
1276 if (strncmp(device
, rpcap_prefix
, sizeof(rpcap_prefix
) - 1) == 0 ||
1277 strncmp(device
, rpcap_ssl_prefix
, sizeof(rpcap_ssl_prefix
) - 1) == 0) {
1279 * Yes. Open it with pcap_open().
1282 pc
= pcap_open(device
, ndo
->ndo_snaplen
,
1283 pflag
? 0 : PCAP_OPENFLAG_PROMISCUOUS
, timeout
, NULL
,
1287 * macOS 14's pcap_pcap_open(), which is a
1288 * stub that always returns NULL with an error
1289 * message of "not supported".
1291 * In this case, as we passed it an rpcap://
1292 * URL, treat that as meaning "remote capture
1295 if (strcmp(ebuf
, "not supported") == 0)
1296 error("Remote capture not supported");
1299 * If this failed with "No such device" or "The system
1300 * cannot find the device specified", that means
1301 * the interface doesn't exist; return NULL, so that
1302 * the caller can see whether the device name is
1303 * actually an interface index.
1305 if (strstr(ebuf
, "No such device") != NULL
||
1306 strstr(ebuf
, "The system cannot find the device specified") != NULL
)
1311 warning("%s", ebuf
);
1314 #endif /* HAVE_PCAP_OPEN */
1316 #ifdef HAVE_PCAP_CREATE
1317 pc
= pcap_create(device
, ebuf
);
1320 * If this failed with "No such device", that means
1321 * the interface doesn't exist; return NULL, so that
1322 * the caller can see whether the device name is
1323 * actually an interface index.
1325 if (strstr(ebuf
, "No such device") != NULL
)
1329 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1331 show_tstamp_types_and_exit(pc
, device
);
1333 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
1334 status
= pcap_set_tstamp_precision(pc
, ndo
->ndo_tstamp_precision
);
1336 error("%s: Can't set %ssecond time stamp precision: %s",
1338 tstamp_precision_to_string(ndo
->ndo_tstamp_precision
),
1339 pcap_statustostr(status
));
1342 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
1343 if (immediate_mode
) {
1344 status
= pcap_set_immediate_mode(pc
, 1);
1346 error("%s: Can't set immediate mode: %s",
1347 device
, pcap_statustostr(status
));
1351 * Is this an interface that supports monitor mode?
1353 if (pcap_can_set_rfmon(pc
) == 1)
1354 supports_monitor_mode
= 1;
1356 supports_monitor_mode
= 0;
1357 if (ndo
->ndo_snaplen
!= 0) {
1359 * A snapshot length was explicitly specified;
1362 status
= pcap_set_snaplen(pc
, ndo
->ndo_snaplen
);
1364 error("%s: Can't set snapshot length: %s",
1365 device
, pcap_statustostr(status
));
1367 status
= pcap_set_promisc(pc
, !pflag
);
1369 error("%s: Can't set promiscuous mode: %s",
1370 device
, pcap_statustostr(status
));
1372 status
= pcap_set_rfmon(pc
, 1);
1374 error("%s: Can't set monitor mode: %s",
1375 device
, pcap_statustostr(status
));
1377 status
= pcap_set_timeout(pc
, timeout
);
1379 error("%s: pcap_set_timeout failed: %s",
1380 device
, pcap_statustostr(status
));
1382 status
= pcap_set_buffer_size(pc
, Bflag
);
1384 error("%s: Can't set buffer size: %s",
1385 device
, pcap_statustostr(status
));
1387 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1389 status
= pcap_set_tstamp_type(pc
, jflag
);
1391 error("%s: Can't set time stamp type: %s",
1392 device
, pcap_statustostr(status
));
1393 else if (status
> 0)
1394 warning("When trying to set timestamp type '%s' on %s: %s",
1395 pcap_tstamp_type_val_to_name(jflag
), device
,
1396 pcap_statustostr(status
));
1399 status
= pcap_activate(pc
);
1402 * pcap_activate() failed.
1404 cp
= pcap_geterr(pc
);
1405 if (status
== PCAP_ERROR
)
1407 else if (status
== PCAP_ERROR_NO_SUCH_DEVICE
) {
1409 * Return an error for our caller to handle.
1411 snprintf(ebuf
, PCAP_ERRBUF_SIZE
, "%s: %s\n(%s)",
1412 device
, pcap_statustostr(status
), cp
);
1413 } else if (status
== PCAP_ERROR_PERM_DENIED
&& *cp
!= '\0')
1414 error("%s: %s\n(%s)", device
,
1415 pcap_statustostr(status
), cp
);
1417 else if (status
== PCAP_ERROR_RFMON_NOTSUP
&&
1418 strncmp(device
, "wlan", 4) == 0) {
1419 char parent
[8], newdev
[8];
1421 size_t s
= sizeof(parent
);
1423 snprintf(sysctl
, sizeof(sysctl
),
1424 "net.wlan.%d.%%parent", atoi(device
+ 4));
1425 sysctlbyname(sysctl
, parent
, &s
, NULL
, 0);
1426 strlcpy(newdev
, device
, sizeof(newdev
));
1427 /* Suggest a new wlan device. */
1428 /* FIXME: incrementing the index this way is not going to work well
1429 * when the index is 9 or greater but the only consequence in this
1430 * specific case would be an error message that looks a bit odd.
1432 newdev
[strlen(newdev
)-1]++;
1433 error("%s is not a monitor mode VAP\n"
1434 "To create a new monitor mode VAP use:\n"
1435 " ifconfig %s create wlandev %s wlanmode monitor\n"
1436 "and use %s as the tcpdump interface",
1437 device
, newdev
, parent
, newdev
);
1441 error("%s: %s", device
,
1442 pcap_statustostr(status
));
1445 } else if (status
> 0) {
1447 * pcap_activate() succeeded, but it's warning us
1448 * of a problem it had.
1450 cp
= pcap_geterr(pc
);
1451 if (status
== PCAP_WARNING
)
1453 else if (status
== PCAP_WARNING_PROMISC_NOTSUP
&&
1455 warning("%s: %s\n(%s)", device
,
1456 pcap_statustostr(status
), cp
);
1458 warning("%s: %s", device
,
1459 pcap_statustostr(status
));
1461 #ifdef HAVE_PCAP_SETDIRECTION
1463 status
= pcap_setdirection(pc
, Qflag
);
1465 error("%s: pcap_setdirection() failed: %s",
1466 device
, pcap_geterr(pc
));
1468 #endif /* HAVE_PCAP_SETDIRECTION */
1469 #else /* HAVE_PCAP_CREATE */
1472 * If no snapshot length was specified, or a length of 0 was
1473 * specified, default to 256KB.
1475 if (ndo
->ndo_snaplen
== 0)
1476 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
1477 pc
= pcap_open_live(device
, ndo
->ndo_snaplen
, !pflag
, timeout
, ebuf
);
1480 * If this failed with "No such device", that means
1481 * the interface doesn't exist; return NULL, so that
1482 * the caller can see whether the device name is
1483 * actually an interface index.
1485 if (strstr(ebuf
, "No such device") != NULL
)
1490 warning("%s", ebuf
);
1491 #endif /* HAVE_PCAP_CREATE */
1497 main(int argc
, char **argv
)
1500 bpf_u_int32 localnet
= 0, netmask
= 0;
1501 char *cp
, *infile
, *cmdbuf
, *device
, *RFileName
, *VFileName
, *WFileName
;
1503 pcap_handler callback
;
1505 const char *dlt_name
;
1506 struct bpf_program fcode
;
1508 void (*oldhandler
)(int);
1510 struct dump_info dumpinfo
;
1511 u_char
*pcap_userdata
;
1512 char ebuf
[PCAP_ERRBUF_SIZE
];
1513 char VFileLine
[PATH_MAX
+ 1];
1514 const char *username
= NULL
;
1516 const char *chroot_dir
= NULL
;
1520 #ifdef HAVE_PCAP_FINDALLDEVS
1526 #ifdef HAVE_CAPSICUM
1527 cap_rights_t rights
;
1529 #endif /* HAVE_CAPSICUM */
1530 int Oflag
= 1; /* run filter code optimizer */
1532 const char *yflag_dlt_name
= NULL
;
1536 netdissect_options Ndo
;
1537 netdissect_options
*ndo
= &Ndo
;
1540 * Initialize the netdissect code.
1542 if (nd_init(ebuf
, sizeof(ebuf
)) == -1)
1545 memset(ndo
, 0, sizeof(*ndo
));
1546 ndo_set_function_pointers(ndo
);
1556 if ((cp
= strrchr(argv
[0], PATH_SEPARATOR
)) != NULL
)
1557 ndo
->program_name
= program_name
= cp
+ 1;
1559 ndo
->program_name
= program_name
= argv
[0];
1561 #if defined(HAVE_PCAP_WSOCKINIT)
1562 if (pcap_wsockinit() != 0)
1563 error("Attempting to initialize Winsock failed");
1564 #elif defined(HAVE_WSOCKINIT)
1565 if (wsockinit() != 0)
1566 error("Attempting to initialize Winsock failed");
1570 * An explicit tzset() call is usually not needed as it happens
1571 * implicitly the first time we call localtime() or mktime(),
1572 * but in some cases (sandboxing, chroot) this may be too late.
1577 (op
= getopt_long(argc
, argv
, SHORTOPTS
, longopts
, NULL
)) != -1)
1581 /* compatibility for old -a */
1592 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
1594 Bflag
= atoi(optarg
)*1024;
1596 error("invalid packet buffer size %s", optarg
);
1598 #endif /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
1603 error("invalid packet count %s", optarg
);
1608 #ifdef HAVE_PCAP_DUMP_FTELL64
1609 Cflag
= strtoint64_t(optarg
, &endp
, 10);
1611 Cflag
= strtol(optarg
, &endp
, 10);
1613 if (endp
== optarg
|| errno
!= 0 || Cflag
<= 0)
1614 error("invalid file size %s", optarg
);
1616 if (*endp
== '\0') {
1618 * There's nothing after the file size,
1619 * so the size is in units of 1 MB
1620 * (1,000,000 bytes).
1622 Cflagmult
= 1000000;
1625 * There's something after the file
1628 * If it's a single letter, then:
1630 * if the letter is k or K, the size
1631 * is in units of 1 KiB (1024 bytes);
1633 * if the letter is m or M, the size
1634 * is in units of 1 MiB (1,048,576 bytes);
1636 * if the letter is g or G, the size
1637 * is in units of 1 GiB (1,073,741,824 bytes).
1639 * Otherwise, it's an error.
1650 Cflagmult
= 1024*1024;
1655 Cflagmult
= 1024*1024*1024;
1659 error("invalid file size %s", optarg
);
1663 * OK, there was a letter that we treat
1664 * as a units indication; was there
1665 * anything after it?
1668 if (*endp
!= '\0') {
1670 error("invalid file size %s", optarg
);
1675 * Will multiplying it by multiplier overflow?
1677 #ifdef HAVE_PCAP_DUMP_FTELL64
1678 if (Cflag
> INT64_T_CONSTANT(0x7fffffffffffffff) / Cflagmult
)
1680 if (Cflag
> LONG_MAX
/ Cflagmult
)
1682 error("file size %s is too large", optarg
);
1690 #ifdef HAVE_PCAP_FINDALLDEVS
1696 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1697 case OPTION_LIST_REMOTE_INTERFACES
:
1698 remote_interfaces_source
= optarg
;
1711 #ifndef HAVE_LIBCRYPTO
1712 warning("crypto code not compiled in");
1714 ndo
->ndo_espsecret
= optarg
;
1726 Gflag
= atoi(optarg
);
1728 error("invalid number of seconds %s", optarg
);
1730 /* We will create one file initially. */
1733 /* Grab the current time for rotation use. */
1734 if ((Gflag_time
= time(NULL
)) == (time_t)-1) {
1735 error("%s: can't get current time: %s",
1736 __func__
, pcap_strerror(errno
));
1741 print_usage(stdout
);
1742 exit_tcpdump(S_SUCCESS
);
1753 #ifdef HAVE_PCAP_CREATE
1757 #endif /* HAVE_PCAP_CREATE */
1759 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1761 jflag
= pcap_tstamp_type_name_to_val(optarg
);
1763 error("invalid time stamp type %s", optarg
);
1774 * _IOLBF is the same as _IOFBF in Microsoft's C
1775 * libraries; the only alternative they offer
1778 * XXX - this should really be checking for MSVC++,
1779 * not _WIN32, if, for example, MinGW has its own
1780 * C library that is more UNIX-compatible.
1782 setvbuf(stdout
, NULL
, _IONBF
, 0);
1784 #ifdef HAVE_SETLINEBUF
1787 setvbuf(stdout
, NULL
, _IOLBF
, 0);
1798 if (nd_have_smi_support()) {
1799 if (nd_load_smi_module(optarg
, ebuf
, sizeof(ebuf
)) == -1)
1802 (void)fprintf(stderr
, "%s: ignoring option '-m %s' ",
1803 program_name
, optarg
);
1804 (void)fprintf(stderr
, "(no libsmi support)\n");
1809 /* TCP-MD5 shared secret */
1810 #ifndef HAVE_LIBCRYPTO
1811 warning("crypto code not compiled in");
1813 ndo
->ndo_sigsecret
= optarg
;
1834 ++ndo
->ndo_suppress_default_print
;
1837 #ifdef HAVE_PCAP_SETDIRECTION
1839 if (ascii_strcasecmp(optarg
, "in") == 0)
1841 else if (ascii_strcasecmp(optarg
, "out") == 0)
1843 else if (ascii_strcasecmp(optarg
, "inout") == 0)
1844 Qflag
= PCAP_D_INOUT
;
1846 error("unknown capture direction '%s'", optarg
);
1848 #endif /* HAVE_PCAP_SETDIRECTION */
1855 ndo
->ndo_snaplen
= (int)strtol(optarg
, &end
, 0);
1856 if (optarg
== end
|| *end
!= '\0'
1857 || ndo
->ndo_snaplen
< 0 || ndo
->ndo_snaplen
> MAXIMUM_SNAPLEN
)
1858 error("invalid snaplen %s (must be >= 0 and <= %d)",
1859 optarg
, MAXIMUM_SNAPLEN
);
1871 if (ascii_strcasecmp(optarg
, "vat") == 0)
1872 ndo
->ndo_packettype
= PT_VAT
;
1873 else if (ascii_strcasecmp(optarg
, "wb") == 0)
1874 ndo
->ndo_packettype
= PT_WB
;
1875 else if (ascii_strcasecmp(optarg
, "rpc") == 0)
1876 ndo
->ndo_packettype
= PT_RPC
;
1877 else if (ascii_strcasecmp(optarg
, "rtp") == 0)
1878 ndo
->ndo_packettype
= PT_RTP
;
1879 else if (ascii_strcasecmp(optarg
, "rtcp") == 0)
1880 ndo
->ndo_packettype
= PT_RTCP
;
1881 else if (ascii_strcasecmp(optarg
, "snmp") == 0)
1882 ndo
->ndo_packettype
= PT_SNMP
;
1883 else if (ascii_strcasecmp(optarg
, "cnfp") == 0)
1884 ndo
->ndo_packettype
= PT_CNFP
;
1885 else if (ascii_strcasecmp(optarg
, "tftp") == 0)
1886 ndo
->ndo_packettype
= PT_TFTP
;
1887 else if (ascii_strcasecmp(optarg
, "aodv") == 0)
1888 ndo
->ndo_packettype
= PT_AODV
;
1889 else if (ascii_strcasecmp(optarg
, "carp") == 0)
1890 ndo
->ndo_packettype
= PT_CARP
;
1891 else if (ascii_strcasecmp(optarg
, "radius") == 0)
1892 ndo
->ndo_packettype
= PT_RADIUS
;
1893 else if (ascii_strcasecmp(optarg
, "zmtp1") == 0)
1894 ndo
->ndo_packettype
= PT_ZMTP1
;
1895 else if (ascii_strcasecmp(optarg
, "vxlan") == 0)
1896 ndo
->ndo_packettype
= PT_VXLAN
;
1897 else if (ascii_strcasecmp(optarg
, "pgm") == 0)
1898 ndo
->ndo_packettype
= PT_PGM
;
1899 else if (ascii_strcasecmp(optarg
, "pgm_zmtp1") == 0)
1900 ndo
->ndo_packettype
= PT_PGM_ZMTP1
;
1901 else if (ascii_strcasecmp(optarg
, "lmp") == 0)
1902 ndo
->ndo_packettype
= PT_LMP
;
1903 else if (ascii_strcasecmp(optarg
, "resp") == 0)
1904 ndo
->ndo_packettype
= PT_RESP
;
1905 else if (ascii_strcasecmp(optarg
, "ptp") == 0)
1906 ndo
->ndo_packettype
= PT_PTP
;
1907 else if (ascii_strcasecmp(optarg
, "someip") == 0)
1908 ndo
->ndo_packettype
= PT_SOMEIP
;
1909 else if (ascii_strcasecmp(optarg
, "domain") == 0)
1910 ndo
->ndo_packettype
= PT_DOMAIN
;
1911 else if (ascii_strcasecmp(optarg
, "quic") == 0)
1912 ndo
->ndo_packettype
= PT_QUIC
;
1914 error("unknown packet type '%s'", optarg
);
1921 #ifdef HAVE_PCAP_DUMP_FLUSH
1940 Wflag
= atoi(optarg
);
1942 error("invalid number of output files %s", optarg
);
1943 WflagChars
= getWflagChars(Wflag
);
1948 ++ndo
->ndo_suppress_default_print
;
1953 ++ndo
->ndo_suppress_default_print
;
1957 yflag_dlt_name
= optarg
;
1959 pcap_datalink_name_to_val(yflag_dlt_name
);
1961 error("invalid data link type %s", yflag_dlt_name
);
1964 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
1967 /* Undocumented flag */
1968 pcap_set_parser_debug(1);
1981 ndo
->ndo_packet_number
= 1;
1984 case OPTION_LENGTHS
:
1985 ndo
->ndo_lengths
= 1;
1988 case OPTION_VERSION
:
1989 print_version(stdout
);
1990 exit_tcpdump(S_SUCCESS
);
1993 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
1994 case OPTION_TSTAMP_PRECISION
:
1995 ndo
->ndo_tstamp_precision
= tstamp_precision_from_string(optarg
);
1996 if (ndo
->ndo_tstamp_precision
< 0)
1997 error("unsupported time stamp precision");
2001 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
2002 case OPTION_IMMEDIATE_MODE
:
2011 case OPTION_PRINT_SAMPLING
:
2014 ndo
->ndo_print_sampling
= atoi(optarg
);
2015 if (ndo
->ndo_print_sampling
<= 0)
2016 error("invalid print sampling %s", optarg
);
2019 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2020 case OPTION_TSTAMP_MICRO
:
2021 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_MICRO
;
2024 case OPTION_TSTAMP_NANO
:
2025 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_NANO
;
2029 case OPTION_FP_TYPE
:
2031 * Print out the type of floating-point arithmetic
2032 * we're doing; it's probably IEEE, unless somebody
2033 * tries to run this on a VAX, but the precision
2034 * may differ (e.g., it might be 32-bit, 64-bit,
2037 float_type_check(0x4e93312d);
2045 print_usage(stderr
);
2046 exit_tcpdump(S_ERR_HOST_PROGRAM
);
2050 #ifdef HAVE_PCAP_FINDALLDEVS
2052 show_devices_and_exit();
2054 #ifdef HAVE_PCAP_FINDALLDEVS_EX
2055 if (remote_interfaces_source
!= NULL
)
2056 show_remote_devices_and_exit();
2059 switch (ndo
->ndo_tflag
) {
2061 case 0: /* Default */
2062 case 1: /* No time stamp */
2063 case 2: /* Unix timeval style */
2064 case 3: /* Microseconds/nanoseconds since previous packet */
2065 case 4: /* Date + Default */
2066 case 5: /* Microseconds/nanoseconds since first packet */
2069 default: /* Not supported */
2070 error("only -t, -tt, -ttt, -tttt and -ttttt are supported");
2074 if (ndo
->ndo_fflag
!= 0 && (VFileName
!= NULL
|| RFileName
!= NULL
))
2075 error("-f can not be used with -V or -r");
2077 if (VFileName
!= NULL
&& RFileName
!= NULL
)
2078 error("-V and -r are mutually exclusive.");
2081 * If we're printing dissected packets to the standard output,
2082 * and either the standard output is a terminal or we're doing
2083 * "line" buffering, set the capture timeout to .1 second rather
2084 * than 1 second, as the user's probably expecting to see packets
2085 * pop up immediately shortly after they arrive.
2087 * XXX - would there be some value appropriate for all cases,
2088 * based on, say, the buffer size and packet input rate?
2090 if ((WFileName
== NULL
|| print
) && (isatty(1) || lflag
))
2094 /* if run as root, prepare for chrooting */
2095 if (getuid() == 0 || geteuid() == 0) {
2096 /* future extensibility for cmd-line arguments */
2098 chroot_dir
= WITH_CHROOT
;
2103 /* if run as root, prepare for dropping root privileges */
2104 if (getuid() == 0 || geteuid() == 0) {
2105 /* Run with '-Z root' to restore old behaviour */
2107 username
= WITH_USER
;
2108 else if (strcmp(username
, "root") == 0)
2113 if (RFileName
!= NULL
|| VFileName
!= NULL
) {
2115 * If RFileName is non-null, it's the pathname of a
2116 * savefile to read. If VFileName is non-null, it's
2117 * the pathname of a file containing a list of pathnames
2118 * (one per line) of savefiles to read.
2120 * In either case, we're reading a savefile, not doing
2125 * We don't need network access, so relinquish any set-UID
2126 * or set-GID privileges we have (if any).
2128 * We do *not* want set-UID privileges when opening a
2129 * trace file, as that might let the user read other
2130 * people's trace files (especially if we're set-UID
2133 if (setgid(getgid()) != 0 || setuid(getuid()) != 0 )
2134 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2136 if (VFileName
!= NULL
) {
2137 if (VFileName
[0] == '-' && VFileName
[1] == '\0')
2140 VFile
= fopen(VFileName
, "r");
2143 error("Unable to open file: %s\n", pcap_strerror(errno
));
2145 ret
= get_next_file(VFile
, VFileLine
);
2147 error("Nothing in %s\n", VFileName
);
2148 RFileName
= VFileLine
;
2151 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2152 pd
= pcap_open_offline_with_tstamp_precision(RFileName
,
2153 ndo
->ndo_tstamp_precision
, ebuf
);
2155 pd
= pcap_open_offline(RFileName
, ebuf
);
2160 #ifdef HAVE_CAPSICUM
2161 cap_rights_init(&rights
, CAP_READ
);
2162 if (cap_rights_limit(fileno(pcap_file(pd
)), &rights
) < 0 &&
2164 error("unable to limit pcap descriptor");
2167 dlt
= pcap_datalink(pd
);
2168 dlt_name
= pcap_datalink_val_to_name(dlt
);
2169 fprintf(stderr
, "reading from file %s", RFileName
);
2170 if (dlt_name
== NULL
) {
2171 fprintf(stderr
, ", link-type %u", dlt
);
2173 fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2174 pcap_datalink_val_to_description(dlt
));
2176 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2177 #ifdef DLT_LINUX_SLL2
2178 if (dlt
== DLT_LINUX_SLL2
)
2179 fprintf(stderr
, "Warning: interface names might be incorrect\n");
2181 } else if (dflag
&& !device
) {
2182 int dump_dlt
= DLT_EN10MB
;
2184 * We're dumping the compiled code without an explicit
2185 * device specification. (If a device is specified, we
2186 * definitely want to open it to use the DLT of that device.)
2187 * Either default to DLT_EN10MB with a warning, or use
2188 * the user-specified value if supplied.
2191 * If no snapshot length was specified, or a length of 0 was
2192 * specified, default to 256KB.
2194 if (ndo
->ndo_snaplen
== 0)
2195 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
2197 * If a DLT was specified with the -y flag, use that instead.
2199 if (yflag_dlt
!= -1)
2200 dump_dlt
= yflag_dlt
;
2202 fprintf(stderr
, "Warning: assuming Ethernet\n");
2203 pd
= pcap_open_dead(dump_dlt
, ndo
->ndo_snaplen
);
2206 * We're doing a live capture.
2208 if (device
== NULL
) {
2210 * No interface was specified. Pick one.
2212 #ifdef HAVE_PCAP_FINDALLDEVS
2214 * Find the list of interfaces, and pick
2215 * the first interface.
2217 if (pcap_findalldevs(&devlist
, ebuf
) == -1)
2219 if (devlist
== NULL
)
2220 error("no interfaces available for capture");
2221 device
= strdup(devlist
->name
);
2222 pcap_freealldevs(devlist
);
2223 #else /* HAVE_PCAP_FINDALLDEVS */
2225 * Use whatever interface pcap_lookupdev()
2228 device
= pcap_lookupdev(ebuf
);
2235 * Try to open the interface with the specified name.
2237 pd
= open_interface(device
, ndo
, ebuf
);
2240 * That failed. If we can get a list of
2241 * interfaces, and the interface name
2242 * is purely numeric, try to use it as
2243 * a 1-based index in the list of
2246 #ifdef HAVE_PCAP_FINDALLDEVS
2247 devnum
= parse_interface_number(device
);
2250 * It's not a number; just report
2251 * the open error and fail.
2257 * OK, it's a number; try to find the
2258 * interface with that index, and try
2261 * find_interface_by_number() exits if it
2262 * couldn't be found.
2264 device
= find_interface_by_number(device
, devnum
);
2265 pd
= open_interface(device
, ndo
, ebuf
);
2268 #else /* HAVE_PCAP_FINDALLDEVS */
2270 * We can't get a list of interfaces; just
2274 #endif /* HAVE_PCAP_FINDALLDEVS */
2278 * Let user own process after capture device has
2282 if (setgid(getgid()) != 0 || setuid(getuid()) != 0)
2283 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2285 #if !defined(HAVE_PCAP_CREATE) && defined(_WIN32)
2287 if(pcap_setbuff(pd
, Bflag
)==-1){
2288 error("%s", pcap_geterr(pd
));
2290 #endif /* !defined(HAVE_PCAP_CREATE) && defined(_WIN32) */
2292 show_dlts_and_exit(pd
, device
);
2293 if (yflag_dlt
>= 0) {
2294 #ifdef HAVE_PCAP_SET_DATALINK
2295 if (pcap_set_datalink(pd
, yflag_dlt
) < 0)
2296 error("%s", pcap_geterr(pd
));
2299 * We don't actually support changing the
2300 * data link type, so we only let them
2301 * set it to what it already is.
2303 if (yflag_dlt
!= pcap_datalink(pd
)) {
2304 error("%s is not one of the DLTs supported by this device\n",
2308 (void)fprintf(stderr
, "%s: data link type %s\n",
2310 pcap_datalink_val_to_name(yflag_dlt
));
2311 (void)fflush(stderr
);
2313 #if defined(DLT_LINUX_SLL2) && defined(HAVE_PCAP_SET_DATALINK)
2316 * Attempt to set default linktype to
2317 * DLT_LINUX_SLL2 when capturing on the
2320 * If the attempt fails, just quietly drive
2321 * on; this may be a non-Linux "any" device
2322 * that doesn't support DLT_LINUX_SLL2.
2324 if (strcmp(device
, "any") == 0) {
2325 DIAG_OFF_WARN_UNUSED_RESULT
2326 (void) pcap_set_datalink(pd
, DLT_LINUX_SLL2
);
2327 DIAG_ON_WARN_UNUSED_RESULT
2331 i
= pcap_snapshot(pd
);
2332 if (ndo
->ndo_snaplen
< i
) {
2333 if (ndo
->ndo_snaplen
!= 0)
2334 warning("snaplen raised from %d to %d", ndo
->ndo_snaplen
, i
);
2335 ndo
->ndo_snaplen
= i
;
2336 } else if (ndo
->ndo_snaplen
> i
) {
2337 warning("snaplen lowered from %d to %d", ndo
->ndo_snaplen
, i
);
2338 ndo
->ndo_snaplen
= i
;
2340 if(ndo
->ndo_fflag
!= 0) {
2341 if (pcap_lookupnet(device
, &localnet
, &netmask
, ebuf
) < 0) {
2342 warning("foreign (-f) flag used but: %s", ebuf
);
2348 cmdbuf
= read_infile(infile
);
2350 cmdbuf
= copy_argv(&argv
[optind
]);
2352 #ifdef HAVE_PCAP_SET_OPTIMIZER_DEBUG
2353 pcap_set_optimizer_debug(dflag
);
2355 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2356 error("%s", pcap_geterr(pd
));
2358 bpf_dump(&fcode
, dflag
);
2361 pcap_freecode(&fcode
);
2362 exit_tcpdump(S_SUCCESS
);
2366 if (!ndo
->ndo_nflag
)
2367 capdns
= capdns_setup();
2368 #endif /* HAVE_CASPER */
2370 init_print(ndo
, localnet
, netmask
);
2373 (void)setsignal(SIGPIPE
, cleanup
);
2374 (void)setsignal(SIGTERM
, cleanup
);
2376 (void)setsignal(SIGINT
, cleanup
);
2377 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2378 (void)setsignal(SIGCHLD
, child_cleanup
);
2380 /* Cooperate with nohup(1) */
2382 if ((oldhandler
= setsignal(SIGHUP
, cleanup
)) != SIG_DFL
)
2383 (void)setsignal(SIGHUP
, oldhandler
);
2388 * If a user name was specified with "-Z", attempt to switch to
2389 * that user's UID. This would probably be used with sudo,
2390 * to allow tcpdump to be run in a special restricted
2391 * account (if you just want to allow users to open capture
2392 * devices, and can't just give users that permission,
2393 * you'd make tcpdump set-UID or set-GID).
2395 * tcpdump doesn't necessarily write only to one savefile;
2396 * the general only way to allow a -Z instance to write to
2397 * savefiles as the user under whose UID it's run, rather
2398 * than as the user specified with -Z, would thus be to switch
2399 * to the original user ID before opening a capture file and
2400 * then switch back to the -Z user ID after opening the savefile.
2401 * Switching to the -Z user ID only after opening the first
2402 * savefile doesn't handle the general case.
2405 if (getuid() == 0 || geteuid() == 0) {
2406 #ifdef HAVE_LIBCAP_NG
2407 /* Initialize capng */
2408 capng_clear(CAPNG_SELECT_BOTH
);
2410 DIAG_OFF_ASSIGN_ENUM
2413 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2420 DIAG_OFF_ASSIGN_ENUM
2423 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2430 DIAG_OFF_ASSIGN_ENUM
2433 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2438 capng_apply(CAPNG_SELECT_BOTH
);
2439 #endif /* HAVE_LIBCAP_NG */
2440 if (username
|| chroot_dir
)
2441 droproot(username
, chroot_dir
);
2446 if (pcap_setfilter(pd
, &fcode
) < 0)
2447 error("%s", pcap_geterr(pd
));
2448 #ifdef HAVE_CAPSICUM
2449 if (RFileName
== NULL
&& VFileName
== NULL
&& pcap_fileno(pd
) != -1) {
2450 static const unsigned long cmds
[] = { BIOCGSTATS
, BIOCROTZBUF
};
2453 * The various libpcap devices use a combination of
2454 * read (bpf), ioctl (bpf, netmap), poll (netmap)
2455 * so we add the relevant access rights.
2457 cap_rights_init(&rights
, CAP_IOCTL
, CAP_READ
, CAP_EVENT
);
2458 if (cap_rights_limit(pcap_fileno(pd
), &rights
) < 0 &&
2460 error("unable to limit pcap descriptor");
2462 if (cap_ioctls_limit(pcap_fileno(pd
), cmds
,
2463 sizeof(cmds
) / sizeof(cmds
[0])) < 0 && errno
!= ENOSYS
) {
2464 error("unable to limit ioctls on pcap descriptor");
2469 /* Do not exceed the default PATH_MAX for files. */
2470 dumpinfo
.CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
2472 if (dumpinfo
.CurrentFileName
== NULL
)
2473 error("malloc of dumpinfo.CurrentFileName");
2475 /* We do not need numbering for dumpfiles if Cflag isn't set. */
2477 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, WflagChars
);
2479 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, 0);
2481 pdd
= pcap_dump_open(pd
, dumpinfo
.CurrentFileName
);
2482 #ifdef HAVE_LIBCAP_NG
2483 /* Give up CAP_DAC_OVERRIDE capability.
2484 * Only allow it to be restored if the -C or -G flag have been
2485 * set since we may need to create more files later on.
2489 (Cflag
|| Gflag
? 0 : CAPNG_PERMITTED
)
2493 capng_apply(CAPNG_SELECT_BOTH
);
2494 #endif /* HAVE_LIBCAP_NG */
2496 error("%s", pcap_geterr(pd
));
2497 #ifdef HAVE_CAPSICUM
2498 set_dumper_capsicum_rights(pdd
);
2500 if (Cflag
!= 0 || Gflag
!= 0) {
2501 #ifdef HAVE_CAPSICUM
2503 * basename() and dirname() may modify their input buffer
2504 * and they do since FreeBSD 12.0, but they didn't before.
2505 * Hence use the return value only, but always assume the
2506 * input buffer has been modified and would need to be
2507 * reset before the next use.
2509 char *WFileName_copy
;
2511 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2512 error("Unable to allocate memory for file %s",
2515 DIAG_OFF_C11_EXTENSIONS
2516 dumpinfo
.WFileName
= strdup(basename(WFileName_copy
));
2517 DIAG_ON_C11_EXTENSIONS
2518 if (dumpinfo
.WFileName
== NULL
) {
2519 error("Unable to allocate memory for file %s",
2522 free(WFileName_copy
);
2524 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2525 error("Unable to allocate memory for file %s",
2528 DIAG_OFF_C11_EXTENSIONS
2529 char *WFileName_dirname
= dirname(WFileName_copy
);
2530 DIAG_ON_C11_EXTENSIONS
2531 dumpinfo
.dirfd
= open(WFileName_dirname
,
2532 O_DIRECTORY
| O_RDONLY
);
2533 if (dumpinfo
.dirfd
< 0) {
2534 error("unable to open directory %s",
2537 free(WFileName_dirname
);
2538 free(WFileName_copy
);
2540 cap_rights_init(&rights
, CAP_CREATE
, CAP_FCNTL
,
2541 CAP_FTRUNCATE
, CAP_LOOKUP
, CAP_SEEK
, CAP_WRITE
);
2542 if (cap_rights_limit(dumpinfo
.dirfd
, &rights
) < 0 &&
2544 error("unable to limit directory rights");
2546 if (cap_fcntls_limit(dumpinfo
.dirfd
, CAP_FCNTL_GETFL
) < 0 &&
2548 error("unable to limit dump descriptor fcntls");
2550 #else /* !HAVE_CAPSICUM */
2551 dumpinfo
.WFileName
= WFileName
;
2553 callback
= dump_packet_and_trunc
;
2556 pcap_userdata
= (u_char
*)&dumpinfo
;
2558 callback
= dump_packet
;
2559 dumpinfo
.WFileName
= WFileName
;
2562 pcap_userdata
= (u_char
*)&dumpinfo
;
2565 dlt
= pcap_datalink(pd
);
2566 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2569 dumpinfo
.ndo
= NULL
;
2571 #ifdef HAVE_PCAP_DUMP_FLUSH
2573 pcap_dump_flush(pdd
);
2576 dlt
= pcap_datalink(pd
);
2577 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2578 callback
= print_packet
;
2579 pcap_userdata
= (u_char
*)ndo
;
2582 #ifdef SIGNAL_REQ_INFO
2584 * We can't get statistics when reading from a file rather
2585 * than capturing from a device.
2587 if (RFileName
== NULL
)
2588 (void)setsignal(SIGNAL_REQ_INFO
, requestinfo
);
2590 #ifdef SIGNAL_FLUSH_PCAP
2591 (void)setsignal(SIGNAL_FLUSH_PCAP
, flushpcap
);
2594 if (ndo
->ndo_vflag
> 0 && WFileName
&& RFileName
== NULL
&& !print
) {
2596 * When capturing to a file, if "--print" wasn't specified,
2597 *"-v" means tcpdump should, once per second,
2598 * "v"erbosely report the number of packets captured.
2599 * Except when reading from a file, because -r, -w and -v
2600 * together used to make a corner case, in which pcap_loop()
2601 * errored due to EINTR (see GH #155 for details).
2605 * https://blogs.msdn.microsoft.com/oldnewthing/20151230-00/?p=92741
2607 * suggests that this dates back to W2K.
2609 * I don't know what a "long wait" is, but we'll assume
2610 * that printing the stats could be a "long wait".
2612 CreateTimerQueueTimer(&timer_handle
, NULL
,
2613 verbose_stats_dump
, NULL
, 1000, 1000,
2614 WT_EXECUTEDEFAULT
|WT_EXECUTELONGFUNCTION
);
2615 setvbuf(stderr
, NULL
, _IONBF
, 0);
2618 * Assume this is UN*X, and that it has setitimer(); that
2619 * dates back to UNIX 95.
2621 struct itimerval timer
;
2622 (void)setsignal(SIGALRM
, verbose_stats_dump
);
2623 timer
.it_interval
.tv_sec
= 1;
2624 timer
.it_interval
.tv_usec
= 0;
2625 timer
.it_value
.tv_sec
= 1;
2626 timer
.it_value
.tv_usec
= 1;
2627 setitimer(ITIMER_REAL
, &timer
, NULL
);
2631 if (RFileName
== NULL
) {
2633 * Live capture (if -V was specified, we set RFileName
2634 * to a file from the -V file). Print a message to
2635 * the standard error on UN*X.
2637 if (!ndo
->ndo_vflag
&& !WFileName
) {
2638 (void)fprintf(stderr
,
2639 "%s: verbose output suppressed, use -v[v]... for full protocol decode\n",
2642 (void)fprintf(stderr
, "%s: ", program_name
);
2643 dlt
= pcap_datalink(pd
);
2644 dlt_name
= pcap_datalink_val_to_name(dlt
);
2645 (void)fprintf(stderr
, "listening on %s", device
);
2646 if (dlt_name
== NULL
) {
2647 (void)fprintf(stderr
, ", link-type %u", dlt
);
2649 (void)fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2650 pcap_datalink_val_to_description(dlt
));
2652 (void)fprintf(stderr
, ", snapshot length %d bytes\n", ndo
->ndo_snaplen
);
2653 (void)fflush(stderr
);
2656 #ifdef HAVE_CAPSICUM
2657 cansandbox
= (VFileName
== NULL
&& zflag
== NULL
);
2659 cansandbox
= (cansandbox
&& (ndo
->ndo_nflag
|| capdns
!= NULL
));
2661 cansandbox
= (cansandbox
&& ndo
->ndo_nflag
);
2662 #endif /* HAVE_CASPER */
2663 cansandbox
= (cansandbox
&& (pcap_fileno(pd
) != -1 ||
2664 RFileName
!= NULL
));
2666 if (cansandbox
&& cap_enter() < 0 && errno
!= ENOSYS
)
2667 error("unable to enter the capability mode");
2668 #endif /* HAVE_CAPSICUM */
2671 status
= pcap_loop(pd
, cnt
, callback
, pcap_userdata
);
2672 if (WFileName
== NULL
) {
2674 * We're printing packets. Flush the printed output,
2675 * so it doesn't get intermingled with error output.
2679 * We got interrupted, so perhaps we didn't
2680 * manage to finish a line we were printing.
2681 * Print an extra newline, just in case.
2685 (void)fflush(stdout
);
2689 * We got interrupted. If we are reading multiple
2690 * files (via -V) set these so that we stop.
2699 (void)fprintf(stderr
, "%s: pcap_loop: %s\n",
2700 program_name
, pcap_geterr(pd
));
2702 if (RFileName
== NULL
) {
2704 * We're doing a live capture. Report the capture
2710 if (VFileName
!= NULL
) {
2711 ret
= get_next_file(VFile
, VFileLine
);
2715 RFileName
= VFileLine
;
2716 pd
= pcap_open_offline(RFileName
, ebuf
);
2719 #ifdef HAVE_CAPSICUM
2720 cap_rights_init(&rights
, CAP_READ
);
2721 if (cap_rights_limit(fileno(pcap_file(pd
)),
2722 &rights
) < 0 && errno
!= ENOSYS
) {
2723 error("unable to limit pcap descriptor");
2726 new_dlt
= pcap_datalink(pd
);
2727 if (new_dlt
!= dlt
) {
2729 * The new file has a different
2730 * link-layer header type from the
2733 if (WFileName
!= NULL
) {
2735 * We're writing raw packets
2736 * that match the filter to
2737 * a pcap file. pcap files
2738 * don't support multiple
2739 * different link-layer
2740 * header types, so we fail
2743 error("%s: new dlt does not match original", RFileName
);
2747 * We're printing the decoded packets;
2748 * switch to the new DLT.
2750 * To do that, we need to change
2751 * the printer, change the DLT name,
2752 * and recompile the filter with
2756 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2757 /* Free the old filter */
2758 pcap_freecode(&fcode
);
2759 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2760 error("%s", pcap_geterr(pd
));
2764 * Set the filter on the new file.
2766 if (pcap_setfilter(pd
, &fcode
) < 0)
2767 error("%s", pcap_geterr(pd
));
2770 * Report the new file.
2772 dlt_name
= pcap_datalink_val_to_name(dlt
);
2773 fprintf(stderr
, "reading from file %s", RFileName
);
2774 if (dlt_name
== NULL
) {
2775 fprintf(stderr
, ", link-type %u", dlt
);
2777 fprintf(stderr
, ", link-type %s (%s)",
2779 pcap_datalink_val_to_description(dlt
));
2781 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2785 while (ret
!= NULL
);
2787 if (count_mode
&& RFileName
!= NULL
)
2788 fprintf(stdout
, "%u packet%s\n", packets_captured
,
2789 PLURAL_SUFFIX(packets_captured
));
2792 pcap_freecode(&fcode
);
2793 exit_tcpdump(status
== -1 ? S_ERR_HOST_PROGRAM
: S_SUCCESS
);
2800 (*setsignal (int sig
, void (*func
)(int)))(int)
2803 return (signal(sig
, func
));
2805 struct sigaction old
, new;
2807 memset(&new, 0, sizeof(new));
2808 new.sa_handler
= func
;
2809 if ((sig
== SIGCHLD
)
2810 # ifdef SIGNAL_REQ_INFO
2811 || (sig
== SIGNAL_REQ_INFO
)
2813 # ifdef SIGNAL_FLUSH_PCAP
2814 || (sig
== SIGNAL_FLUSH_PCAP
)
2817 new.sa_flags
= SA_RESTART
;
2818 if (sigaction(sig
, &new, &old
) < 0)
2820 return (old
.sa_handler
);
2824 /* make a clean exit on interrupts */
2826 cleanup(int signo _U_
)
2829 if (timer_handle
!= INVALID_HANDLE_VALUE
) {
2830 DeleteTimerQueueTimer(NULL
, timer_handle
, NULL
);
2831 CloseHandle(timer_handle
);
2832 timer_handle
= INVALID_HANDLE_VALUE
;
2835 struct itimerval timer
;
2837 timer
.it_interval
.tv_sec
= 0;
2838 timer
.it_interval
.tv_usec
= 0;
2839 timer
.it_value
.tv_sec
= 0;
2840 timer
.it_value
.tv_usec
= 0;
2841 setitimer(ITIMER_REAL
, &timer
, NULL
);
2844 #ifdef HAVE_PCAP_BREAKLOOP
2846 * We have "pcap_breakloop()"; use it, so that we do as little
2847 * as possible in the signal handler (it's probably not safe
2848 * to do anything with standard I/O streams in a signal handler -
2849 * the ANSI C standard doesn't say it is).
2854 * We don't have "pcap_breakloop()"; this isn't safe, but
2855 * it's the best we can do. Print the summary if we're
2856 * not reading from a savefile - i.e., if we're doing a
2857 * live capture - and exit.
2859 if (pd
!= NULL
&& pcap_file(pd
) == NULL
) {
2861 * We got interrupted, so perhaps we didn't
2862 * manage to finish a line we were printing.
2863 * Print an extra newline, just in case.
2866 (void)fflush(stdout
);
2869 exit_tcpdump(S_SUCCESS
);
2874 On windows, we do not use a fork, so we do not care less about
2875 waiting a child processes to die
2877 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2879 child_cleanup(int signo _U_
)
2881 while (waitpid(-1, NULL
, WNOHANG
) >= 0);
2883 #endif /* HAVE_FORK && HAVE_VFORK */
2888 struct pcap_stat stats
;
2891 * Older versions of libpcap didn't set ps_ifdrop on some
2892 * platforms; initialize it to 0 to handle that.
2894 stats
.ps_ifdrop
= 0;
2895 if (pcap_stats(pd
, &stats
) < 0) {
2896 (void)fprintf(stderr
, "pcap_stats: %s\n", pcap_geterr(pd
));
2902 fprintf(stderr
, "%s: ", program_name
);
2904 (void)fprintf(stderr
, "%u packet%s captured", packets_captured
,
2905 PLURAL_SUFFIX(packets_captured
));
2907 fputs(", ", stderr
);
2910 (void)fprintf(stderr
, "%u packet%s received by filter", stats
.ps_recv
,
2911 PLURAL_SUFFIX(stats
.ps_recv
));
2913 fputs(", ", stderr
);
2916 (void)fprintf(stderr
, "%u packet%s dropped by kernel", stats
.ps_drop
,
2917 PLURAL_SUFFIX(stats
.ps_drop
));
2918 if (stats
.ps_ifdrop
!= 0) {
2920 fputs(", ", stderr
);
2923 (void)fprintf(stderr
, "%u packet%s dropped by interface\n",
2924 stats
.ps_ifdrop
, PLURAL_SUFFIX(stats
.ps_ifdrop
));
2930 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2932 #define fork_subprocess() fork()
2934 #define fork_subprocess() vfork()
2937 compress_savefile(const char *filename
)
2941 child
= fork_subprocess();
2944 "compress_savefile: fork failed: %s\n",
2945 pcap_strerror(errno
));
2949 /* Parent process. */
2955 * Set to lowest priority so that this doesn't disturb the capture.
2958 setpriority(PRIO_PROCESS
, 0, NZERO
- 1);
2960 setpriority(PRIO_PROCESS
, 0, 19);
2962 if (execlp(zflag
, zflag
, filename
, (char *)NULL
) == -1)
2964 "compress_savefile: execlp(%s, %s) failed: %s\n",
2967 pcap_strerror(errno
));
2969 exit(S_ERR_HOST_PROGRAM
);
2971 _exit(S_ERR_HOST_PROGRAM
);
2974 #else /* HAVE_FORK && HAVE_VFORK */
2976 compress_savefile(const char *filename
)
2979 "compress_savefile failed. Functionality not implemented under your system\n");
2981 #endif /* HAVE_FORK && HAVE_VFORK */
2984 dump_packet_and_trunc(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
2986 struct dump_info
*dump_info
;
2992 dump_info
= (struct dump_info
*)user
;
2995 * XXX - this won't force the file to rotate on the specified time
2996 * boundary, but it will rotate on the first packet received after the
2997 * specified Gflag number of seconds. Note: if a Gflag time boundary
2998 * and a Cflag size boundary coincide, the time rotation will occur
2999 * first thereby cancelling the Cflag boundary (since the file should
3003 /* Check if it is time to rotate */
3006 /* Get the current time */
3007 if ((t
= time(NULL
)) == (time_t)-1) {
3008 error("%s: can't get current_time: %s",
3009 __func__
, pcap_strerror(errno
));
3013 /* If the time is greater than the specified window, rotate */
3014 if (t
- Gflag_time
>= Gflag
) {
3015 #ifdef HAVE_CAPSICUM
3020 /* Update the Gflag_time */
3022 /* Update Gflag_count */
3025 * Close the current file and open a new one.
3027 pcap_dump_close(dump_info
->pdd
);
3030 * Compress the file we just closed, if the user asked for it
3033 compress_savefile(dump_info
->CurrentFileName
);
3036 * Check to see if we've exceeded the Wflag (when
3039 if (Cflag
== 0 && Wflag
> 0 && Gflag_count
>= Wflag
) {
3040 (void)fprintf(stderr
, "Maximum file limit reached: %d\n",
3043 exit_tcpdump(S_SUCCESS
);
3046 if (dump_info
->CurrentFileName
!= NULL
)
3047 free(dump_info
->CurrentFileName
);
3048 /* Allocate space for max filename + \0. */
3049 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3050 if (dump_info
->CurrentFileName
== NULL
)
3051 error("dump_packet_and_trunc: malloc");
3053 * Gflag was set otherwise we wouldn't be here. Reset the count
3054 * so multiple files would end with 1,2,3 in the filename.
3055 * The counting is handled with the -C flow after this.
3060 * This is always the first file in the Cflag
3062 * We also don't need numbering if Cflag is not set.
3065 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0,
3068 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0, 0);
3070 #ifdef HAVE_LIBCAP_NG
3071 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3072 capng_apply(CAPNG_SELECT_BOTH
);
3073 #endif /* HAVE_LIBCAP_NG */
3074 #ifdef HAVE_CAPSICUM
3075 fd
= openat(dump_info
->dirfd
,
3076 dump_info
->CurrentFileName
,
3077 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3079 error("unable to open file %s",
3080 dump_info
->CurrentFileName
);
3082 fp
= fdopen(fd
, "w");
3084 error("unable to fdopen file %s",
3085 dump_info
->CurrentFileName
);
3087 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3088 #else /* !HAVE_CAPSICUM */
3089 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3091 #ifdef HAVE_LIBCAP_NG
3092 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3093 capng_apply(CAPNG_SELECT_BOTH
);
3094 #endif /* HAVE_LIBCAP_NG */
3095 if (dump_info
->pdd
== NULL
)
3096 error("%s", pcap_geterr(pd
));
3097 #ifdef HAVE_CAPSICUM
3098 set_dumper_capsicum_rights(dump_info
->pdd
);
3104 * XXX - this won't prevent capture files from getting
3105 * larger than Cflag - the last packet written to the
3106 * file could put it over Cflag.
3109 #ifdef HAVE_PCAP_DUMP_FTELL64
3110 int64_t size
= pcap_dump_ftell64(dump_info
->pdd
);
3113 * XXX - this only handles a Cflag value > 2^31-1 on
3114 * LP64 platforms; to handle ILP32 (32-bit UN*X and
3115 * Windows) or LLP64 (64-bit Windows) would require
3116 * a version of libpcap with pcap_dump_ftell64().
3118 long size
= pcap_dump_ftell(dump_info
->pdd
);
3122 error("ftell fails on output file");
3124 #ifdef HAVE_CAPSICUM
3130 * Close the current file and open a new one.
3132 pcap_dump_close(dump_info
->pdd
);
3135 * Compress the file we just closed, if the user
3139 compress_savefile(dump_info
->CurrentFileName
);
3143 if (Cflag_count
>= Wflag
)
3146 if (dump_info
->CurrentFileName
!= NULL
)
3147 free(dump_info
->CurrentFileName
);
3148 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3149 if (dump_info
->CurrentFileName
== NULL
)
3150 error("%s: malloc", __func__
);
3151 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, Cflag_count
, WflagChars
);
3152 #ifdef HAVE_LIBCAP_NG
3153 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3154 capng_apply(CAPNG_SELECT_BOTH
);
3155 #endif /* HAVE_LIBCAP_NG */
3156 #ifdef HAVE_CAPSICUM
3157 fd
= openat(dump_info
->dirfd
, dump_info
->CurrentFileName
,
3158 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3160 error("unable to open file %s",
3161 dump_info
->CurrentFileName
);
3163 fp
= fdopen(fd
, "w");
3165 error("unable to fdopen file %s",
3166 dump_info
->CurrentFileName
);
3168 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3169 #else /* !HAVE_CAPSICUM */
3170 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3172 #ifdef HAVE_LIBCAP_NG
3173 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3174 capng_apply(CAPNG_SELECT_BOTH
);
3175 #endif /* HAVE_LIBCAP_NG */
3176 if (dump_info
->pdd
== NULL
)
3177 error("%s", pcap_geterr(pd
));
3178 #ifdef HAVE_CAPSICUM
3179 set_dumper_capsicum_rights(dump_info
->pdd
);
3184 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3185 #ifdef HAVE_PCAP_DUMP_FLUSH
3187 pcap_dump_flush(dump_info
->pdd
);
3190 if (dump_info
->ndo
!= NULL
)
3191 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3199 dump_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3201 struct dump_info
*dump_info
;
3207 dump_info
= (struct dump_info
*)user
;
3209 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3210 #ifdef HAVE_PCAP_DUMP_FLUSH
3212 pcap_dump_flush(dump_info
->pdd
);
3215 if (dump_info
->ndo
!= NULL
)
3216 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3224 print_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3231 pretty_print_packet((netdissect_options
*)user
, h
, sp
, packets_captured
);
3238 #ifdef SIGNAL_REQ_INFO
3240 requestinfo(int signo _U_
)
3249 #ifdef SIGNAL_FLUSH_PCAP
3251 flushpcap(int signo _U_
)
3254 pcap_dump_flush(pdd
);
3259 print_packets_captured (void)
3261 static u_int prev_packets_captured
, first
= 1;
3263 if (infodelay
== 0 && (first
|| packets_captured
!= prev_packets_captured
)) {
3264 fprintf(stderr
, "Got %u\r", packets_captured
);
3266 prev_packets_captured
= packets_captured
;
3271 * Called once each second in verbose mode while dumping to file
3274 static void CALLBACK
verbose_stats_dump(PVOID param _U_
,
3275 BOOLEAN timer_fired _U_
)
3277 print_packets_captured();
3280 static void verbose_stats_dump(int sig _U_
)
3282 print_packets_captured();
3286 DIAG_OFF_DEPRECATION
3288 print_version(FILE *f
)
3290 #ifndef HAVE_PCAP_LIB_VERSION
3291 #ifdef HAVE_PCAP_VERSION
3292 extern char pcap_version
[];
3293 #else /* HAVE_PCAP_VERSION */
3294 static char pcap_version
[] = "unknown";
3295 #endif /* HAVE_PCAP_VERSION */
3296 #endif /* HAVE_PCAP_LIB_VERSION */
3297 const char *smi_version_string
;
3299 (void)fprintf(f
, "%s version " PACKAGE_VERSION
"\n", program_name
);
3300 #ifdef HAVE_PCAP_LIB_VERSION
3301 (void)fprintf(f
, "%s\n", pcap_lib_version());
3302 #else /* HAVE_PCAP_LIB_VERSION */
3303 (void)fprintf(f
, "libpcap version %s\n", pcap_version
);
3304 #endif /* HAVE_PCAP_LIB_VERSION */
3306 #if defined(HAVE_LIBCRYPTO) && defined(SSLEAY_VERSION)
3307 (void)fprintf (f
, "%s\n", SSLeay_version(SSLEAY_VERSION
));
3310 smi_version_string
= nd_smi_version_string();
3311 if (smi_version_string
!= NULL
)
3312 (void)fprintf (f
, "SMI-library: %s\n", smi_version_string
);
3314 #if defined(__SANITIZE_ADDRESS__)
3315 (void)fprintf (f
, "Compiled with AddressSanitizer/GCC.\n");
3316 #elif defined(__has_feature)
3317 # if __has_feature(address_sanitizer)
3318 (void)fprintf (f
, "Compiled with AddressSanitizer/Clang.\n");
3319 # elif __has_feature(memory_sanitizer)
3320 (void)fprintf (f
, "Compiled with MemorySanitizer/Clang.\n");
3322 #endif /* __SANITIZE_ADDRESS__ or __has_feature */
3327 print_usage(FILE *f
)
3331 "Usage: %s [-Abd" D_FLAG
"efhH" I_FLAG J_FLAG
"KlLnNOpqStu" U_FLAG
"vxX#]" B_FLAG_USAGE
" [ -c count ] [--count]\n", program_name
);
3333 "\t\t[ -C file_size ] [ -E algo:secret ] [ -F file ] [ -G seconds ]\n");
3335 "\t\t[ -i interface ]" IMMEDIATE_MODE_USAGE j_FLAG_USAGE
"\n");
3336 #ifdef HAVE_PCAP_FINDALLDEVS_EX
3338 "\t\t[ --lengths ]" LIST_REMOTE_INTERFACES_USAGE
"\n");
3342 "\t\t" m_FLAG_USAGE
"\n");
3345 "\t\t[ -M secret ] [ --number ] [ --print ]\n");
3347 "\t\t[ --print-sampling nth ]" Q_FLAG_USAGE
" [ -r file ]\n");
3349 "\t\t[ -s snaplen ] [ -T type ] [ --version ]\n");
3351 "\t\t[ -V file ] [ -w file ] [ -W filecount ] [ -y datalinktype ]\n");
3352 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
3354 "\t\t[ --time-stamp-precision precision ] [ --micro ] [ --nano ]\n");
3357 "\t\t[ -z postrotate-command ] [ -Z user ] [ expression ]\n");