2 * Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that: (1) source code distributions
7 * retain the above copyright notice and this paragraph in its entirety, (2)
8 * distributions including binary code include the above copyright notice and
9 * this paragraph in its entirety in the documentation or other materials
10 * provided with the distribution, and (3) all advertising materials mentioning
11 * features or use of this software display the following acknowledgement:
12 * ``This product includes software developed by the University of California,
13 * Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
14 * the University nor the names of its contributors may be used to endorse
15 * or promote products derived from this software without specific prior
17 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
18 * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
19 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
21 * Support for splitting captures into multiple files with a maximum
25 * Seth Webster <swebster@sst.ll.mit.edu>
29 * tcpdump - dump traffic on a network
31 * First written in 1987 by Van Jacobson, Lawrence Berkeley Laboratory.
32 * Mercilessly hacked and occasionally improved since then via the
33 * combined efforts of Van, Steve McCanne and Craig Leres of LBL.
41 * Some older versions of Mac OS X ship pcap.h from libpcap 0.6 with a
42 * libpcap based on 0.8. That means it has pcap_findalldevs() but the
43 * header doesn't define pcap_if_t, meaning that we can't actually *use*
46 #ifdef HAVE_PCAP_FINDALLDEVS
47 #ifndef HAVE_PCAP_IF_T
48 #undef HAVE_PCAP_FINDALLDEVS
52 #include "netdissect-stdinc.h"
55 * This must appear after including netdissect-stdinc.h, so that _U_ is
59 static const char copyright
[] _U_
=
60 "@(#) Copyright (c) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 2000\n\
61 The Regents of the University of California. All rights reserved.\n";
71 #include <openssl/crypto.h>
74 #ifdef HAVE_GETOPT_LONG
77 #include "missing/getopt_long.h"
79 /* Capsicum-specific code requires macros from <net/bpf.h>, which will fail
80 * to compile if <pcap.h> has already been included; including the headers
81 * in the opposite order works fine. For the most part anyway, because in
82 * FreeBSD <pcap/pcap.h> declares bpf_dump() instead of <net/bpf.h>. Thus
83 * interface.h takes care of it later to avoid a compiler warning.
86 #include <sys/capsicum.h>
87 #include <sys/ioccom.h>
91 #include <libcasper.h>
92 #include <casper/cap_dns.h>
94 #endif /* HAVE_CASPER */
95 #endif /* HAVE_CAPSICUM */
98 * We found pcap_open() in the capture library, so we'll be using
99 * the remote capture APIs; define PCAP_REMOTE before we include pcap.h,
100 * so we get those APIs declared, and the types and #defines that they
103 * WinPcap's headers require that PCAP_REMOTE be defined in order to get
104 * remote-capture APIs declared and types and #defines that they use
107 * (Versions of libpcap with those APIs, and thus Npcap, which is based on
108 * those versions of libpcap, don't require it.)
122 #include <sys/time.h>
123 #include <sys/wait.h>
124 #include <sys/resource.h>
130 * Pathname separator.
131 * Use this in pathnames, but do *not* use it in URLs.
134 #define PATH_SEPARATOR '\\'
136 #define PATH_SEPARATOR '/'
139 /* capabilities convenience library */
140 /* If a code depends on HAVE_LIBCAP_NG, it depends also on HAVE_CAP_NG_H.
141 * If HAVE_CAP_NG_H is not defined, undefine HAVE_LIBCAP_NG.
142 * Thus, the later tests are done only on HAVE_LIBCAP_NG.
144 #ifdef HAVE_LIBCAP_NG
148 #undef HAVE_LIBCAP_NG
149 #endif /* HAVE_CAP_NG_H */
150 #endif /* HAVE_LIBCAP_NG */
153 #include <sys/sysctl.h>
154 #endif /* __FreeBSD__ */
156 #include "netdissect-stdinc.h"
157 #include "netdissect.h"
158 #include "interface.h"
159 #include "addrtoname.h"
161 #include "pcap-missing.h"
162 #include "ascii_strcasecmp.h"
166 #include "diag-control.h"
171 #define PATH_MAX 1024
175 #define SIGNAL_REQ_INFO SIGINFO
176 #elif defined(SIGUSR1)
177 #define SIGNAL_REQ_INFO SIGUSR1
180 #if defined(HAVE_PCAP_DUMP_FLUSH) && defined(SIGUSR2)
181 #define SIGNAL_FLUSH_PCAP SIGUSR2
184 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
185 static int Bflag
; /* buffer size */
187 #ifdef HAVE_PCAP_DUMP_FTELL64
188 static int64_t Cflag
; /* rotate dump files after this many bytes */
190 static long Cflag
; /* rotate dump files after this many bytes */
192 static int Cflag_count
; /* Keep track of which file number we're writing */
193 #ifdef HAVE_PCAP_FINDALLDEVS
194 static int Dflag
; /* list available devices and exit */
196 #ifdef HAVE_PCAP_FINDALLDEVS_EX
197 static char *remote_interfaces_source
; /* list available devices from this source and exit */
201 * This is exported because, in some versions of libpcap, if libpcap
202 * is built with optimizer debugging code (which is *NOT* the default
203 * configuration!), the library *imports*(!) a variable named dflag,
204 * under the expectation that tcpdump is exporting it, to govern
205 * how much debugging information to print when optimizing
206 * the generated BPF code.
208 * This is a horrible hack; newer versions of libpcap don't import
209 * dflag but, instead, *if* built with optimizer debugging code,
210 * *export* a routine to set that flag.
213 int dflag
; /* print filter code */
214 static int Gflag
; /* rotate dump files after this many seconds */
215 static int Gflag_count
; /* number of files created with Gflag rotation */
216 static time_t Gflag_time
; /* The last time_t the dump file was rotated. */
217 static int Lflag
; /* list available data link types and exit */
218 static int Iflag
; /* rfmon (monitor) mode */
219 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
220 static int Jflag
; /* list available time stamp types */
221 static int jflag
= -1; /* packet time stamp source */
223 static int lflag
; /* line-buffered output */
224 static int pflag
; /* don't go promiscuous */
225 #ifdef HAVE_PCAP_SETDIRECTION
226 static int Qflag
= -1; /* restrict captured packet by send/receive direction */
228 #ifdef HAVE_PCAP_DUMP_FLUSH
229 static int Uflag
; /* "unbuffered" output of dump files */
231 static int Wflag
; /* recycle output files after this number of files */
232 static int WflagChars
;
233 static char *zflag
= NULL
; /* compress each savefile using a specified command (like gzip or bzip2) */
234 static int timeout
= 1000; /* default timeout = 1000 ms = 1 s */
235 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
236 static int immediate_mode
;
238 static int count_mode
;
240 static int infodelay
;
241 static int infoprint
;
246 static void (*setsignal (int sig
, void (*func
)(int)))(int);
247 static void cleanup(int);
248 static void child_cleanup(int);
249 static void print_version(FILE *);
250 static void print_usage(FILE *);
252 static void print_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
253 static void dump_packet_and_trunc(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
254 static void dump_packet(u_char
*, const struct pcap_pkthdr
*, const u_char
*);
256 #ifdef SIGNAL_REQ_INFO
257 static void requestinfo(int);
260 #ifdef SIGNAL_FLUSH_PCAP
261 static void flushpcap(int);
265 static HANDLE timer_handle
= INVALID_HANDLE_VALUE
;
266 static void CALLBACK
verbose_stats_dump(PVOID param
, BOOLEAN timer_fired
);
268 static void verbose_stats_dump(int sig
);
271 static void info(int);
272 static u_int packets_captured
;
274 #ifdef HAVE_PCAP_FINDALLDEVS
275 static const struct tok status_flags
[] = {
277 { PCAP_IF_UP
, "Up" },
279 #ifdef PCAP_IF_RUNNING
280 { PCAP_IF_RUNNING
, "Running" },
282 { PCAP_IF_LOOPBACK
, "Loopback" },
283 #ifdef PCAP_IF_WIRELESS
284 { PCAP_IF_WIRELESS
, "Wireless" },
291 static pcap_dumper_t
*pdd
= NULL
;
293 static int supports_monitor_mode
;
301 char *CurrentFileName
;
304 netdissect_options
*ndo
;
310 #if defined(HAVE_PCAP_SET_PARSER_DEBUG)
312 * We have pcap_set_parser_debug() in libpcap; declare it (it's not declared
313 * by any libpcap header, because it's a special hack, only available if
314 * libpcap was configured to include it, and only intended for use by
315 * libpcap developers trying to debug the parser for filter expressions).
318 __declspec(dllimport
)
322 void pcap_set_parser_debug(int);
323 #elif defined(HAVE_PCAP_DEBUG) || defined(HAVE_YYDEBUG)
325 * We don't have pcap_set_parser_debug() in libpcap, but we do have
326 * pcap_debug or yydebug. Make a local version of pcap_set_parser_debug()
327 * to set the flag, and define HAVE_PCAP_SET_PARSER_DEBUG.
330 pcap_set_parser_debug(int value
)
332 #ifdef HAVE_PCAP_DEBUG
333 extern int pcap_debug
;
336 #else /* HAVE_PCAP_DEBUG */
340 #endif /* HAVE_PCAP_DEBUG */
343 #define HAVE_PCAP_SET_PARSER_DEBUG
346 #if defined(HAVE_PCAP_SET_OPTIMIZER_DEBUG)
348 * We have pcap_set_optimizer_debug() in libpcap; declare it (it's not declared
349 * by any libpcap header, because it's a special hack, only available if
350 * libpcap was configured to include it, and only intended for use by
351 * libpcap developers trying to debug the optimizer for filter expressions).
354 __declspec(dllimport
)
358 void pcap_set_optimizer_debug(int);
362 exit_tcpdump(const int status
)
369 static void NORETURN
PRINTFLIKE(1, 2)
370 error(FORMAT_STRING(const char *fmt
), ...)
374 (void)fprintf(stderr
, "%s: ", program_name
);
376 (void)vfprintf(stderr
, fmt
, ap
);
381 (void)fputc('\n', stderr
);
383 exit_tcpdump(S_ERR_HOST_PROGRAM
);
388 static void PRINTFLIKE(1, 2)
389 warning(FORMAT_STRING(const char *fmt
), ...)
393 (void)fprintf(stderr
, "%s: WARNING: ", program_name
);
395 (void)vfprintf(stderr
, fmt
, ap
);
400 (void)fputc('\n', stderr
);
404 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
406 show_tstamp_types_and_exit(pcap_t
*pc
, const char *device
)
409 int *tstamp_types
= 0;
410 const char *tstamp_type_name
;
413 n_tstamp_types
= pcap_list_tstamp_types(pc
, &tstamp_types
);
414 if (n_tstamp_types
< 0)
415 error("%s", pcap_geterr(pc
));
417 if (n_tstamp_types
== 0) {
418 fprintf(stderr
, "Time stamp type cannot be set for %s\n",
420 exit_tcpdump(S_SUCCESS
);
422 fprintf(stdout
, "Time stamp types for %s (use option -j to set):\n",
424 for (i
= 0; i
< n_tstamp_types
; i
++) {
425 tstamp_type_name
= pcap_tstamp_type_val_to_name(tstamp_types
[i
]);
426 if (tstamp_type_name
!= NULL
) {
427 (void) fprintf(stdout
, " %s (%s)\n", tstamp_type_name
,
428 pcap_tstamp_type_val_to_description(tstamp_types
[i
]));
430 (void) fprintf(stdout
, " %d\n", tstamp_types
[i
]);
433 pcap_free_tstamp_types(tstamp_types
);
434 exit_tcpdump(S_SUCCESS
);
439 show_dlts_and_exit(pcap_t
*pc
, const char *device
)
443 const char *dlt_name
;
445 n_dlts
= pcap_list_datalinks(pc
, &dlts
);
447 error("%s", pcap_geterr(pc
));
448 else if (n_dlts
== 0 || !dlts
)
449 error("No data link types.");
452 * If the interface is known to support monitor mode, indicate
453 * whether these are the data link types available when not in
454 * monitor mode, if -I wasn't specified, or when in monitor mode,
455 * when -I was specified (the link-layer types available in
456 * monitor mode might be different from the ones available when
457 * not in monitor mode).
459 (void) fprintf(stdout
, "Data link types for ");
460 if (supports_monitor_mode
)
461 (void) fprintf(stdout
, "%s %s",
463 Iflag
? "when in monitor mode" : "when not in monitor mode");
465 (void) fprintf(stdout
, "%s",
467 (void) fprintf(stdout
, " (use option -y to set):\n");
469 for (i
= 0; i
< n_dlts
; i
++) {
470 dlt_name
= pcap_datalink_val_to_name(dlts
[i
]);
471 if (dlt_name
!= NULL
) {
472 (void) fprintf(stdout
, " %s (%s)", dlt_name
,
473 pcap_datalink_val_to_description(dlts
[i
]));
476 * OK, does tcpdump handle that type?
478 if (!has_printer(dlts
[i
]))
479 (void) fprintf(stdout
, " (printing not supported)");
480 fprintf(stdout
, "\n");
482 (void) fprintf(stdout
, " DLT %d (printing not supported)\n",
486 #ifdef HAVE_PCAP_FREE_DATALINKS
487 pcap_free_datalinks(dlts
);
489 exit_tcpdump(S_SUCCESS
);
492 #ifdef HAVE_PCAP_FINDALLDEVS
494 show_devices_and_exit(void)
496 pcap_if_t
*dev
, *devlist
;
497 char ebuf
[PCAP_ERRBUF_SIZE
];
500 if (pcap_findalldevs(&devlist
, ebuf
) < 0)
502 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
503 printf("%d.%s", i
+1, dev
->name
);
504 if (dev
->description
!= NULL
)
505 printf(" (%s)", dev
->description
);
506 if (dev
->flags
!= 0) {
508 printf("%s", bittok2str(status_flags
, "none", dev
->flags
));
509 #ifdef PCAP_IF_WIRELESS
510 if (dev
->flags
& PCAP_IF_WIRELESS
) {
511 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
513 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
514 printf(", Association status unknown");
517 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
518 printf(", Associated");
521 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
522 printf(", Not associated");
525 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
529 switch (dev
->flags
& PCAP_IF_CONNECTION_STATUS
) {
531 case PCAP_IF_CONNECTION_STATUS_UNKNOWN
:
532 printf(", Connection status unknown");
535 case PCAP_IF_CONNECTION_STATUS_CONNECTED
:
536 printf(", Connected");
539 case PCAP_IF_CONNECTION_STATUS_DISCONNECTED
:
540 printf(", Disconnected");
543 case PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
:
552 pcap_freealldevs(devlist
);
553 exit_tcpdump(S_SUCCESS
);
555 #endif /* HAVE_PCAP_FINDALLDEVS */
557 #ifdef HAVE_PCAP_FINDALLDEVS_EX
559 show_remote_devices_and_exit(void)
561 pcap_if_t
*dev
, *devlist
;
562 char ebuf
[PCAP_ERRBUF_SIZE
];
565 if (pcap_findalldevs_ex(remote_interfaces_source
, NULL
, &devlist
,
567 if (strcmp(ebuf
, "not supported") == 0) {
569 * macOS 14's pcap_findalldevs_ex(), which is a
570 * stub that always returns -1 with an error
571 * message of "not supported".
573 * In this case, as we passed it an rpcap://
574 * URL, treat that as meaning "remote capture
577 error("Remote capture not supported");
581 for (i
= 0, dev
= devlist
; dev
!= NULL
; i
++, dev
= dev
->next
) {
582 printf("%d.%s", i
+1, dev
->name
);
583 if (dev
->description
!= NULL
)
584 printf(" (%s)", dev
->description
);
586 printf(" [%s]", bittok2str(status_flags
, "none", dev
->flags
));
589 pcap_freealldevs(devlist
);
590 exit_tcpdump(S_SUCCESS
);
592 #endif /* HAVE_PCAP_FINDALLDEVS */
597 * Note that there we use all letters for short options except for g, k,
598 * o, and P, and those are used by other versions of tcpdump, and we should
599 * only use them for the same purposes that the other versions of tcpdump
602 * macOS tcpdump uses -g to force non--v output for IP to be on one
603 * line, making it more "g"repable;
605 * macOS tcpdump uses -k to specify that packet comments in pcapng files
608 * OpenBSD tcpdump uses -o to indicate that OS fingerprinting should be done
609 * for hosts sending TCP SYN packets;
611 * macOS tcpdump uses -P to indicate that -w should write pcapng rather
614 * macOS tcpdump also uses -Q to specify expressions that match packet
615 * metadata, including but not limited to the packet direction.
616 * The expression syntax is different from a simple "in|out|inout",
617 * and those expressions aren't accepted by macOS tcpdump, but the
618 * equivalents would be "in" = "dir=in", "out" = "dir=out", and
619 * "inout" = "dir=in or dir=out", and the parser could conceivably
620 * special-case "in", "out", and "inout" as expressions for backwards
621 * compatibility, so all is not (yet) lost.
625 * Set up flags that might or might not be supported depending on the
626 * version of libpcap we're using.
628 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
630 #define B_FLAG_USAGE " [ -B size ]"
631 #else /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
634 #endif /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
636 #ifdef HAVE_PCAP_FINDALLDEVS
642 #ifdef HAVE_PCAP_CREATE
644 #else /* HAVE_PCAP_CREATE */
646 #endif /* HAVE_PCAP_CREATE */
648 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
650 #define j_FLAG_USAGE " [ -j tstamptype ]"
652 #else /* PCAP_ERROR_TSTAMP_TYPE_NOTSUP */
656 #endif /* PCAP_ERROR_TSTAMP_TYPE_NOTSUP */
659 #define m_FLAG_USAGE "[ -m module ] ..."
662 #ifdef HAVE_PCAP_SETDIRECTION
664 #define Q_FLAG_USAGE " [ -Q in|out|inout ]"
670 #ifdef HAVE_PCAP_DUMP_FLUSH
676 #define SHORTOPTS "aAb" B_FLAG "c:C:d" D_FLAG "eE:fF:G:hHi:" I_FLAG j_FLAG J_FLAG "KlLm:M:nNOpq" Q_FLAG "r:s:StT:u" U_FLAG "vV:w:W:xXy:Yz:Z:#"
681 * We do not currently have long options corresponding to all short
682 * options; we should probably pick appropriate option names for them.
684 * However, the short options where the number of times the option is
685 * specified matters, such as -v and -d and -t, should probably not
686 * just map to a long option, as saying
688 * tcpdump --verbose --verbose
690 * doesn't make sense; it should be --verbosity={N} or something such
693 * For long options with no corresponding short options, we define values
694 * outside the range of ASCII graphic characters, make that the last
695 * component of the entry for the long option, and have a case for that
696 * option in the switch statement.
698 #define OPTION_VERSION 128
699 #define OPTION_TSTAMP_PRECISION 129
700 #define OPTION_IMMEDIATE_MODE 130
701 #define OPTION_PRINT 131
702 #define OPTION_LIST_REMOTE_INTERFACES 132
703 #define OPTION_TSTAMP_MICRO 133
704 #define OPTION_TSTAMP_NANO 134
705 #define OPTION_FP_TYPE 135
706 #define OPTION_COUNT 136
707 #define OPTION_PRINT_SAMPLING 137
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 { "version", no_argument
, NULL
, OPTION_VERSION
},
760 #ifdef HAVE_PCAP_FINDALLDEVS_EX
761 #define LIST_REMOTE_INTERFACES_USAGE "[ --list-remote-interfaces remote-source ]"
763 #define LIST_REMOTE_INTERFACES_USAGE
766 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
767 #define IMMEDIATE_MODE_USAGE " [ --immediate-mode ]"
769 #define IMMEDIATE_MODE_USAGE ""
773 /* Drop root privileges and chroot if necessary */
775 droproot(const char *username
, const char *chroot_dir
)
777 struct passwd
*pw
= NULL
;
779 if (chroot_dir
&& !username
)
780 error("Chroot without dropping root is insecure");
782 pw
= getpwnam(username
);
785 if (chroot(chroot_dir
) != 0 || chdir ("/") != 0)
786 error("Couldn't chroot/chdir to '%.64s': %s",
787 chroot_dir
, pcap_strerror(errno
));
789 #ifdef HAVE_LIBCAP_NG
791 int ret
= capng_change_id(pw
->pw_uid
, pw
->pw_gid
, CAPNG_NO_FLAG
);
793 error("capng_change_id(): return %d\n", ret
);
795 fprintf(stderr
, "dropped privs to %s\n", username
);
798 if (initgroups(pw
->pw_name
, pw
->pw_gid
) != 0 ||
799 setgid(pw
->pw_gid
) != 0 || setuid(pw
->pw_uid
) != 0)
800 error("Couldn't change to '%.32s' uid=%lu gid=%lu: %s",
802 (unsigned long)pw
->pw_uid
,
803 (unsigned long)pw
->pw_gid
,
804 pcap_strerror(errno
));
806 fprintf(stderr
, "dropped privs to %s\n", username
);
808 #endif /* HAVE_LIBCAP_NG */
810 error("Couldn't find user '%.32s'", username
);
811 #ifdef HAVE_LIBCAP_NG
812 /* We don't need CAP_SETUID, CAP_SETGID and CAP_SYS_CHROOT anymore. */
816 CAPNG_EFFECTIVE
| CAPNG_PERMITTED
,
822 capng_apply(CAPNG_SELECT_BOTH
);
823 #endif /* HAVE_LIBCAP_NG */
844 MakeFilename(char *buffer
, char *orig_name
, int cnt
, int max_chars
)
846 char *filename
= malloc(PATH_MAX
+ 1);
847 if (filename
== NULL
)
848 error("%s: malloc", __func__
);
849 if (strlen(orig_name
) == 0)
850 error("an empty string is not a valid file name");
852 /* Process with strftime if Gflag is set. */
856 /* Convert Gflag_time to a usable format */
857 if ((local_tm
= localtime(&Gflag_time
)) == NULL
) {
858 error("%s: localtime", __func__
);
861 /* There's no good way to detect an error in strftime since a return
862 * value of 0 isn't necessarily failure; if orig_name is an empty
863 * string, the formatted string will be empty.
865 * However, the C90 standard says that, if there *is* a
866 * buffer overflow, the content of the buffer is undefined,
867 * so we must check for a buffer overflow.
869 * So we check above for an empty orig_name, and only call
870 * strftime() if it's non-empty, in which case the return
871 * value will only be 0 if the formatted date doesn't fit
874 * (We check above because, even if we don't use -G, we
875 * want a better error message than "tcpdump: : No such
876 * file or directory" for this case.)
878 if (strftime(filename
, PATH_MAX
, orig_name
, local_tm
) == 0) {
879 error("%s: strftime", __func__
);
882 strncpy(filename
, orig_name
, PATH_MAX
);
885 if (cnt
== 0 && max_chars
== 0)
886 strncpy(buffer
, filename
, PATH_MAX
+ 1);
888 if (snprintf(buffer
, PATH_MAX
+ 1, "%s%0*d", filename
, max_chars
, cnt
) > PATH_MAX
)
889 /* Report an error if the filename is too large */
890 error("too many output files or filename is too long (> %d)", PATH_MAX
);
895 get_next_file(FILE *VFile
, char *ptr
)
900 ret
= fgets(ptr
, PATH_MAX
, VFile
);
905 if (len
> 0 && ptr
[len
- 1] == '\n')
912 static cap_channel_t
*
915 cap_channel_t
*capcas
, *capdnsloc
;
916 const char *types
[1];
921 error("unable to create casper process");
922 capdnsloc
= cap_service_open(capcas
, "system.dns");
923 /* Casper capability no longer needed. */
925 if (capdnsloc
== NULL
)
926 error("unable to open system.dns service");
927 /* Limit system.dns to reverse DNS lookups. */
929 if (cap_dns_type_limit(capdnsloc
, types
, 1) < 0)
930 error("unable to limit access to system.dns service");
931 families
[0] = AF_INET
;
932 /* Casper is a feature of FreeBSD, which defines AF_INET6. */
933 families
[1] = AF_INET6
;
934 if (cap_dns_family_limit(capdnsloc
, families
, 2) < 0)
935 error("unable to limit access to system.dns service");
939 #endif /* HAVE_CASPER */
941 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
943 tstamp_precision_from_string(const char *precision
)
945 if (strncmp(precision
, "nano", strlen("nano")) == 0)
946 return PCAP_TSTAMP_PRECISION_NANO
;
948 if (strncmp(precision
, "micro", strlen("micro")) == 0)
949 return PCAP_TSTAMP_PRECISION_MICRO
;
955 tstamp_precision_to_string(int precision
)
959 case PCAP_TSTAMP_PRECISION_MICRO
:
962 case PCAP_TSTAMP_PRECISION_NANO
:
973 * Ensure that, on a dump file's descriptor, we have all the rights
974 * necessary to make the standard I/O library work with an fdopen()ed
975 * FILE * from that descriptor.
977 * A long time ago in a galaxy far, far away, AT&T decided that, instead
978 * of providing separate APIs for getting and setting the FD_ flags on a
979 * descriptor, getting and setting the O_ flags on a descriptor, and
980 * locking files, they'd throw them all into a kitchen-sink fcntl() call
981 * along the lines of ioctl(), the fact that ioctl() operations are
982 * largely specific to particular character devices but fcntl() operations
983 * are either generic to all descriptors or generic to all descriptors for
984 * regular files notwithstanding.
986 * The Capsicum people decided that fine-grained control of descriptor
987 * operations was required, so that you need to grant permission for
988 * reading, writing, seeking, and fcntl-ing. The latter, courtesy of
989 * AT&T's decision, means that "fcntl-ing" isn't a thing, but a motley
990 * collection of things, so there are *individual* fcntls for which
991 * permission needs to be granted.
993 * The FreeBSD standard I/O people implemented some optimizations that
994 * requires that the standard I/O routines be able to determine whether
995 * the descriptor for the FILE * is open append-only or not; as that
996 * descriptor could have come from an open() rather than an fopen(),
997 * that requires that it be able to do an F_GETFL fcntl() to read
1000 * Tcpdump uses ftell() to determine how much data has been written
1001 * to a file in order to, when used with -C, determine when it's time
1002 * to rotate capture files. ftell() therefore needs to do an lseek()
1003 * to find out the file offset and must, thanks to the aforementioned
1004 * optimization, also know whether the descriptor is open append-only
1007 * The net result of all the above is that we need to grant CAP_SEEK,
1008 * CAP_WRITE, and CAP_FCNTL with the CAP_FCNTL_GETFL subcapability.
1010 * Perhaps this is the universe's way of saying that either
1012 * 1) there needs to be an fopenat() call and a pcap_dump_openat() call
1013 * using it, so that Capsicum-capable tcpdump wouldn't need to do
1018 * 2) there needs to be a cap_fdopen() call in the FreeBSD standard
1019 * I/O library that knows what rights are needed by the standard
1020 * I/O library, based on the open mode, and assigns them, perhaps
1021 * with an additional argument indicating, for example, whether
1022 * seeking should be allowed, so that tcpdump doesn't need to know
1023 * what the standard I/O library happens to require this week.
1026 set_dumper_capsicum_rights(pcap_dumper_t
*p
)
1028 int fd
= fileno(pcap_dump_file(p
));
1029 cap_rights_t rights
;
1031 cap_rights_init(&rights
, CAP_SEEK
, CAP_WRITE
, CAP_FCNTL
);
1032 if (cap_rights_limit(fd
, &rights
) < 0 && errno
!= ENOSYS
) {
1033 error("unable to limit dump descriptor");
1035 if (cap_fcntls_limit(fd
, CAP_FCNTL_GETFL
) < 0 && errno
!= ENOSYS
) {
1036 error("unable to limit dump descriptor fcntls");
1042 * Copy arg vector into a new buffer, concatenating arguments with spaces.
1045 copy_argv(char **argv
)
1057 len
+= strlen(*p
++) + 1;
1059 buf
= (char *)malloc(len
);
1061 error("%s: malloc", __func__
);
1065 while ((src
= *p
++) != NULL
) {
1066 while ((*dst
++ = *src
++) != '\0')
1076 * On Windows, we need to open the file in binary mode, so that
1077 * we get all the bytes specified by the size we get from "fstat()".
1078 * On UNIX, that's not necessary. O_BINARY is defined on Windows;
1079 * we define it as 0 if it's not defined, so it does nothing.
1086 read_infile(char *fname
)
1093 fd
= open(fname
, O_RDONLY
|O_BINARY
);
1095 error("can't open %s: %s", fname
, pcap_strerror(errno
));
1097 if (our_fstat(fd
, &buf
) < 0)
1098 error("can't stat %s: %s", fname
, pcap_strerror(errno
));
1101 * Reject files whose size doesn't fit into an int; a filter
1102 * *that* large will probably be too big.
1104 if (buf
.st_size
> INT_MAX
)
1105 error("%s is too large", fname
);
1107 cp
= malloc((u_int
)buf
.st_size
+ 1);
1109 error("malloc(%d) for %s: %s", (u_int
)buf
.st_size
+ 1,
1110 fname
, pcap_strerror(errno
));
1111 cc
= read(fd
, cp
, (u_int
)buf
.st_size
);
1113 error("read %s: %s", fname
, pcap_strerror(errno
));
1114 if (cc
!= buf
.st_size
)
1115 error("short read %s (%d != %d)", fname
, (int) cc
,
1119 /* replace "# comment" with spaces */
1120 for (i
= 0; i
< cc
; i
++) {
1122 while (i
< cc
&& cp
[i
] != '\n')
1129 #ifdef HAVE_PCAP_FINDALLDEVS
1131 parse_interface_number(const char *device
)
1138 * Search for a colon, terminating any scheme at the beginning
1141 p
= strchr(device
, ':');
1144 * We found it. Is it followed by "//"?
1146 p
++; /* skip the : */
1147 if (strncmp(p
, "//", 2) == 0) {
1149 * Yes. Search for the next /, at the end of the
1150 * authority part of the URL.
1152 p
+= 2; /* skip the // */
1156 * OK, past the / is the path.
1162 devnum
= strtol(device
, &end
, 10);
1163 if (device
!= end
&& *end
== '\0') {
1165 * It's all-numeric, but is it a valid number?
1169 * No, it's not an ordinal.
1171 error("Invalid adapter index");
1176 * It's not all-numeric; return -1, so our caller
1184 find_interface_by_number(const char *url
1185 #ifndef HAVE_PCAP_FINDALLDEVS_EX
1190 pcap_if_t
*dev
, *devlist
;
1192 char ebuf
[PCAP_ERRBUF_SIZE
];
1194 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1200 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1202 * Search for a colon, terminating any scheme at the beginning
1205 endp
= strchr(url
, ':');
1208 * We found it. Is it followed by "//"?
1210 endp
++; /* skip the : */
1211 if (strncmp(endp
, "//", 2) == 0) {
1213 * Yes. Search for the next /, at the end of the
1214 * authority part of the URL.
1216 endp
+= 2; /* skip the // */
1217 endp
= strchr(endp
, '/');
1223 * OK, everything from device to endp is a URL to hand
1224 * to pcap_findalldevs_ex().
1226 endp
++; /* Include the trailing / in the URL; pcap_findalldevs_ex() requires it */
1227 host_url
= malloc(endp
- url
+ 1);
1228 if (host_url
== NULL
&& (endp
- url
+ 1) > 0)
1229 error("Invalid allocation for host");
1231 memcpy(host_url
, url
, endp
- url
);
1232 host_url
[endp
- url
] = '\0';
1233 status
= pcap_findalldevs_ex(host_url
, NULL
, &devlist
, ebuf
);
1237 status
= pcap_findalldevs(&devlist
, ebuf
);
1241 * Look for the devnum-th entry in the list of devices (1-based).
1243 for (i
= 0, dev
= devlist
; i
< devnum
-1 && dev
!= NULL
;
1244 i
++, dev
= dev
->next
)
1247 error("Invalid adapter index");
1248 device
= strdup(dev
->name
);
1249 pcap_freealldevs(devlist
);
1254 #ifdef HAVE_PCAP_OPEN
1256 * Prefixes for rpcap URLs.
1258 static char rpcap_prefix
[] = "rpcap://";
1259 static char rpcap_ssl_prefix
[] = "rpcaps://";
1263 open_interface(const char *device
, netdissect_options
*ndo
, char *ebuf
)
1266 #ifdef HAVE_PCAP_CREATE
1271 #ifdef HAVE_PCAP_OPEN
1273 * Is this an rpcap URL?
1275 if (strncmp(device
, rpcap_prefix
, sizeof(rpcap_prefix
) - 1) == 0 ||
1276 strncmp(device
, rpcap_ssl_prefix
, sizeof(rpcap_ssl_prefix
) - 1) == 0) {
1278 * Yes. Open it with pcap_open().
1281 pc
= pcap_open(device
, ndo
->ndo_snaplen
,
1282 pflag
? 0 : PCAP_OPENFLAG_PROMISCUOUS
, timeout
, NULL
,
1286 * macOS 14's pcap_pcap_open(), which is a
1287 * stub that always returns NULL with an error
1288 * message of "not supported".
1290 * In this case, as we passed it an rpcap://
1291 * URL, treat that as meaning "remote capture
1294 if (strcmp(ebuf
, "not supported") == 0)
1295 error("Remote capture not supported");
1298 * If this failed with "No such device" or "The system
1299 * cannot find the device specified", that means
1300 * the interface doesn't exist; return NULL, so that
1301 * the caller can see whether the device name is
1302 * actually an interface index.
1304 if (strstr(ebuf
, "No such device") != NULL
||
1305 strstr(ebuf
, "The system cannot find the device specified") != NULL
)
1310 warning("%s", ebuf
);
1313 #endif /* HAVE_PCAP_OPEN */
1315 #ifdef HAVE_PCAP_CREATE
1316 pc
= pcap_create(device
, ebuf
);
1319 * If this failed with "No such device", that means
1320 * the interface doesn't exist; return NULL, so that
1321 * the caller can see whether the device name is
1322 * actually an interface index.
1324 if (strstr(ebuf
, "No such device") != NULL
)
1328 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1330 show_tstamp_types_and_exit(pc
, device
);
1332 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
1333 status
= pcap_set_tstamp_precision(pc
, ndo
->ndo_tstamp_precision
);
1335 error("%s: Can't set %ssecond time stamp precision: %s",
1337 tstamp_precision_to_string(ndo
->ndo_tstamp_precision
),
1338 pcap_statustostr(status
));
1341 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
1342 if (immediate_mode
) {
1343 status
= pcap_set_immediate_mode(pc
, 1);
1345 error("%s: Can't set immediate mode: %s",
1346 device
, pcap_statustostr(status
));
1350 * Is this an interface that supports monitor mode?
1352 if (pcap_can_set_rfmon(pc
) == 1)
1353 supports_monitor_mode
= 1;
1355 supports_monitor_mode
= 0;
1356 if (ndo
->ndo_snaplen
!= 0) {
1358 * A snapshot length was explicitly specified;
1361 status
= pcap_set_snaplen(pc
, ndo
->ndo_snaplen
);
1363 error("%s: Can't set snapshot length: %s",
1364 device
, pcap_statustostr(status
));
1366 status
= pcap_set_promisc(pc
, !pflag
);
1368 error("%s: Can't set promiscuous mode: %s",
1369 device
, pcap_statustostr(status
));
1371 status
= pcap_set_rfmon(pc
, 1);
1373 error("%s: Can't set monitor mode: %s",
1374 device
, pcap_statustostr(status
));
1376 status
= pcap_set_timeout(pc
, timeout
);
1378 error("%s: pcap_set_timeout failed: %s",
1379 device
, pcap_statustostr(status
));
1381 status
= pcap_set_buffer_size(pc
, Bflag
);
1383 error("%s: Can't set buffer size: %s",
1384 device
, pcap_statustostr(status
));
1386 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1388 status
= pcap_set_tstamp_type(pc
, jflag
);
1390 error("%s: Can't set time stamp type: %s",
1391 device
, pcap_statustostr(status
));
1392 else if (status
> 0)
1393 warning("When trying to set timestamp type '%s' on %s: %s",
1394 pcap_tstamp_type_val_to_name(jflag
), device
,
1395 pcap_statustostr(status
));
1398 status
= pcap_activate(pc
);
1401 * pcap_activate() failed.
1403 cp
= pcap_geterr(pc
);
1404 if (status
== PCAP_ERROR
)
1406 else if (status
== PCAP_ERROR_NO_SUCH_DEVICE
) {
1408 * Return an error for our caller to handle.
1410 snprintf(ebuf
, PCAP_ERRBUF_SIZE
, "%s: %s\n(%s)",
1411 device
, pcap_statustostr(status
), cp
);
1412 } else if (status
== PCAP_ERROR_PERM_DENIED
&& *cp
!= '\0')
1413 error("%s: %s\n(%s)", device
,
1414 pcap_statustostr(status
), cp
);
1416 else if (status
== PCAP_ERROR_RFMON_NOTSUP
&&
1417 strncmp(device
, "wlan", 4) == 0) {
1418 char parent
[8], newdev
[8];
1420 size_t s
= sizeof(parent
);
1422 snprintf(sysctl
, sizeof(sysctl
),
1423 "net.wlan.%d.%%parent", atoi(device
+ 4));
1424 sysctlbyname(sysctl
, parent
, &s
, NULL
, 0);
1425 strlcpy(newdev
, device
, sizeof(newdev
));
1426 /* Suggest a new wlan device. */
1427 /* FIXME: incrementing the index this way is not going to work well
1428 * when the index is 9 or greater but the only consequence in this
1429 * specific case would be an error message that looks a bit odd.
1431 newdev
[strlen(newdev
)-1]++;
1432 error("%s is not a monitor mode VAP\n"
1433 "To create a new monitor mode VAP use:\n"
1434 " ifconfig %s create wlandev %s wlanmode monitor\n"
1435 "and use %s as the tcpdump interface",
1436 device
, newdev
, parent
, newdev
);
1440 error("%s: %s", device
,
1441 pcap_statustostr(status
));
1444 } else if (status
> 0) {
1446 * pcap_activate() succeeded, but it's warning us
1447 * of a problem it had.
1449 cp
= pcap_geterr(pc
);
1450 if (status
== PCAP_WARNING
)
1452 else if (status
== PCAP_WARNING_PROMISC_NOTSUP
&&
1454 warning("%s: %s\n(%s)", device
,
1455 pcap_statustostr(status
), cp
);
1457 warning("%s: %s", device
,
1458 pcap_statustostr(status
));
1460 #ifdef HAVE_PCAP_SETDIRECTION
1462 status
= pcap_setdirection(pc
, Qflag
);
1464 error("%s: pcap_setdirection() failed: %s",
1465 device
, pcap_geterr(pc
));
1467 #endif /* HAVE_PCAP_SETDIRECTION */
1468 #else /* HAVE_PCAP_CREATE */
1471 * If no snapshot length was specified, or a length of 0 was
1472 * specified, default to 256KB.
1474 if (ndo
->ndo_snaplen
== 0)
1475 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
1476 pc
= pcap_open_live(device
, ndo
->ndo_snaplen
, !pflag
, timeout
, ebuf
);
1479 * If this failed with "No such device", that means
1480 * the interface doesn't exist; return NULL, so that
1481 * the caller can see whether the device name is
1482 * actually an interface index.
1484 if (strstr(ebuf
, "No such device") != NULL
)
1489 warning("%s", ebuf
);
1490 #endif /* HAVE_PCAP_CREATE */
1496 main(int argc
, char **argv
)
1499 bpf_u_int32 localnet
= 0, netmask
= 0;
1500 char *cp
, *infile
, *cmdbuf
, *device
, *RFileName
, *VFileName
, *WFileName
;
1502 pcap_handler callback
;
1504 const char *dlt_name
;
1505 struct bpf_program fcode
;
1507 void (*oldhandler
)(int);
1509 struct dump_info dumpinfo
;
1510 u_char
*pcap_userdata
;
1511 char ebuf
[PCAP_ERRBUF_SIZE
];
1512 char VFileLine
[PATH_MAX
+ 1];
1513 const char *username
= NULL
;
1515 const char *chroot_dir
= NULL
;
1519 #ifdef HAVE_PCAP_FINDALLDEVS
1525 #ifdef HAVE_CAPSICUM
1526 cap_rights_t rights
;
1528 #endif /* HAVE_CAPSICUM */
1529 int Oflag
= 1; /* run filter code optimizer */
1531 const char *yflag_dlt_name
= NULL
;
1535 netdissect_options Ndo
;
1536 netdissect_options
*ndo
= &Ndo
;
1539 * Initialize the netdissect code.
1541 if (nd_init(ebuf
, sizeof(ebuf
)) == -1)
1544 memset(ndo
, 0, sizeof(*ndo
));
1545 ndo_set_function_pointers(ndo
);
1555 if ((cp
= strrchr(argv
[0], PATH_SEPARATOR
)) != NULL
)
1556 ndo
->program_name
= program_name
= cp
+ 1;
1558 ndo
->program_name
= program_name
= argv
[0];
1560 #if defined(HAVE_PCAP_WSOCKINIT)
1561 if (pcap_wsockinit() != 0)
1562 error("Attempting to initialize Winsock failed");
1563 #elif defined(HAVE_WSOCKINIT)
1564 if (wsockinit() != 0)
1565 error("Attempting to initialize Winsock failed");
1569 * On platforms where the CPU doesn't support unaligned loads,
1570 * force unaligned accesses to abort with SIGBUS, rather than
1571 * being fixed up (slowly) by the OS kernel; on those platforms,
1572 * misaligned accesses are bugs, and we want tcpdump to crash so
1573 * that the bugs are reported.
1575 if (abort_on_misalignment(ebuf
, sizeof(ebuf
)) < 0)
1579 (op
= getopt_long(argc
, argv
, SHORTOPTS
, longopts
, NULL
)) != -1)
1583 /* compatibility for old -a */
1594 #if defined(HAVE_PCAP_CREATE) || defined(_WIN32)
1596 Bflag
= atoi(optarg
)*1024;
1598 error("invalid packet buffer size %s", optarg
);
1600 #endif /* defined(HAVE_PCAP_CREATE) || defined(_WIN32) */
1605 error("invalid packet count %s", optarg
);
1610 #ifdef HAVE_PCAP_DUMP_FTELL64
1611 Cflag
= strtoint64_t(optarg
, &endp
, 10);
1613 Cflag
= strtol(optarg
, &endp
, 10);
1615 if (endp
== optarg
|| errno
!= 0 || Cflag
<= 0)
1616 error("invalid file size %s", optarg
);
1618 if (*endp
== '\0') {
1620 * There's nothing after the file size,
1621 * so the size is in units of 1 MB
1622 * (1,000,000 bytes).
1624 Cflagmult
= 1000000;
1627 * There's something after the file
1630 * If it's a single letter, then:
1632 * if the letter is k or K, the size
1633 * is in units of 1 KiB (1024 bytes);
1635 * if the letter is m or M, the size
1636 * is in units of 1 MiB (1,048,576 bytes);
1638 * if the letter is g or G, the size
1639 * is in units of 1 GiB (1,073,741,824 bytes).
1641 * Otherwise, it's an error.
1652 Cflagmult
= 1024*1024;
1657 Cflagmult
= 1024*1024*1024;
1661 error("invalid file size %s", optarg
);
1665 * OK, there was a letter that we treat
1666 * as a units indication; was there
1667 * anything after it?
1670 if (*endp
!= '\0') {
1672 error("invalid file size %s", optarg
);
1677 * Will multiplying it by multiplier overflow?
1679 #ifdef HAVE_PCAP_DUMP_FTELL64
1680 if (Cflag
> INT64_T_CONSTANT(0x7fffffffffffffff) / Cflagmult
)
1682 if (Cflag
> LONG_MAX
/ Cflagmult
)
1684 error("file size %s is too large", optarg
);
1692 #ifdef HAVE_PCAP_FINDALLDEVS
1698 #ifdef HAVE_PCAP_FINDALLDEVS_EX
1699 case OPTION_LIST_REMOTE_INTERFACES
:
1700 remote_interfaces_source
= optarg
;
1713 #ifndef HAVE_LIBCRYPTO
1714 warning("crypto code not compiled in");
1716 ndo
->ndo_espsecret
= optarg
;
1728 Gflag
= atoi(optarg
);
1730 error("invalid number of seconds %s", optarg
);
1732 /* We will create one file initially. */
1735 /* Grab the current time for rotation use. */
1736 if ((Gflag_time
= time(NULL
)) == (time_t)-1) {
1737 error("%s: can't get current time: %s",
1738 __func__
, pcap_strerror(errno
));
1743 print_usage(stdout
);
1744 exit_tcpdump(S_SUCCESS
);
1755 #ifdef HAVE_PCAP_CREATE
1759 #endif /* HAVE_PCAP_CREATE */
1761 #ifdef HAVE_PCAP_SET_TSTAMP_TYPE
1763 jflag
= pcap_tstamp_type_name_to_val(optarg
);
1765 error("invalid time stamp type %s", optarg
);
1776 * _IOLBF is the same as _IOFBF in Microsoft's C
1777 * libraries; the only alternative they offer
1780 * XXX - this should really be checking for MSVC++,
1781 * not _WIN32, if, for example, MinGW has its own
1782 * C library that is more UNIX-compatible.
1784 setvbuf(stdout
, NULL
, _IONBF
, 0);
1786 #ifdef HAVE_SETLINEBUF
1789 setvbuf(stdout
, NULL
, _IOLBF
, 0);
1800 if (nd_have_smi_support()) {
1801 if (nd_load_smi_module(optarg
, ebuf
, sizeof(ebuf
)) == -1)
1804 (void)fprintf(stderr
, "%s: ignoring option '-m %s' ",
1805 program_name
, optarg
);
1806 (void)fprintf(stderr
, "(no libsmi support)\n");
1811 /* TCP-MD5 shared secret */
1812 #ifndef HAVE_LIBCRYPTO
1813 warning("crypto code not compiled in");
1815 ndo
->ndo_sigsecret
= optarg
;
1836 ++ndo
->ndo_suppress_default_print
;
1839 #ifdef HAVE_PCAP_SETDIRECTION
1841 if (ascii_strcasecmp(optarg
, "in") == 0)
1843 else if (ascii_strcasecmp(optarg
, "out") == 0)
1845 else if (ascii_strcasecmp(optarg
, "inout") == 0)
1846 Qflag
= PCAP_D_INOUT
;
1848 error("unknown capture direction '%s'", optarg
);
1850 #endif /* HAVE_PCAP_SETDIRECTION */
1857 ndo
->ndo_snaplen
= (int)strtol(optarg
, &end
, 0);
1858 if (optarg
== end
|| *end
!= '\0'
1859 || ndo
->ndo_snaplen
< 0 || ndo
->ndo_snaplen
> MAXIMUM_SNAPLEN
)
1860 error("invalid snaplen %s (must be >= 0 and <= %d)",
1861 optarg
, MAXIMUM_SNAPLEN
);
1873 if (ascii_strcasecmp(optarg
, "vat") == 0)
1874 ndo
->ndo_packettype
= PT_VAT
;
1875 else if (ascii_strcasecmp(optarg
, "wb") == 0)
1876 ndo
->ndo_packettype
= PT_WB
;
1877 else if (ascii_strcasecmp(optarg
, "rpc") == 0)
1878 ndo
->ndo_packettype
= PT_RPC
;
1879 else if (ascii_strcasecmp(optarg
, "rtp") == 0)
1880 ndo
->ndo_packettype
= PT_RTP
;
1881 else if (ascii_strcasecmp(optarg
, "rtcp") == 0)
1882 ndo
->ndo_packettype
= PT_RTCP
;
1883 else if (ascii_strcasecmp(optarg
, "snmp") == 0)
1884 ndo
->ndo_packettype
= PT_SNMP
;
1885 else if (ascii_strcasecmp(optarg
, "cnfp") == 0)
1886 ndo
->ndo_packettype
= PT_CNFP
;
1887 else if (ascii_strcasecmp(optarg
, "tftp") == 0)
1888 ndo
->ndo_packettype
= PT_TFTP
;
1889 else if (ascii_strcasecmp(optarg
, "aodv") == 0)
1890 ndo
->ndo_packettype
= PT_AODV
;
1891 else if (ascii_strcasecmp(optarg
, "carp") == 0)
1892 ndo
->ndo_packettype
= PT_CARP
;
1893 else if (ascii_strcasecmp(optarg
, "radius") == 0)
1894 ndo
->ndo_packettype
= PT_RADIUS
;
1895 else if (ascii_strcasecmp(optarg
, "zmtp1") == 0)
1896 ndo
->ndo_packettype
= PT_ZMTP1
;
1897 else if (ascii_strcasecmp(optarg
, "vxlan") == 0)
1898 ndo
->ndo_packettype
= PT_VXLAN
;
1899 else if (ascii_strcasecmp(optarg
, "pgm") == 0)
1900 ndo
->ndo_packettype
= PT_PGM
;
1901 else if (ascii_strcasecmp(optarg
, "pgm_zmtp1") == 0)
1902 ndo
->ndo_packettype
= PT_PGM_ZMTP1
;
1903 else if (ascii_strcasecmp(optarg
, "lmp") == 0)
1904 ndo
->ndo_packettype
= PT_LMP
;
1905 else if (ascii_strcasecmp(optarg
, "resp") == 0)
1906 ndo
->ndo_packettype
= PT_RESP
;
1907 else if (ascii_strcasecmp(optarg
, "ptp") == 0)
1908 ndo
->ndo_packettype
= PT_PTP
;
1909 else if (ascii_strcasecmp(optarg
, "someip") == 0)
1910 ndo
->ndo_packettype
= PT_SOMEIP
;
1911 else if (ascii_strcasecmp(optarg
, "domain") == 0)
1912 ndo
->ndo_packettype
= PT_DOMAIN
;
1913 else if (ascii_strcasecmp(optarg
, "quic") == 0)
1914 ndo
->ndo_packettype
= PT_QUIC
;
1916 error("unknown packet type '%s'", optarg
);
1923 #ifdef HAVE_PCAP_DUMP_FLUSH
1942 Wflag
= atoi(optarg
);
1944 error("invalid number of output files %s", optarg
);
1945 WflagChars
= getWflagChars(Wflag
);
1950 ++ndo
->ndo_suppress_default_print
;
1955 ++ndo
->ndo_suppress_default_print
;
1959 yflag_dlt_name
= optarg
;
1961 pcap_datalink_name_to_val(yflag_dlt_name
);
1963 error("invalid data link type %s", yflag_dlt_name
);
1966 #ifdef HAVE_PCAP_SET_PARSER_DEBUG
1969 /* Undocumented flag */
1970 pcap_set_parser_debug(1);
1983 ndo
->ndo_packet_number
= 1;
1986 case OPTION_VERSION
:
1987 print_version(stdout
);
1988 exit_tcpdump(S_SUCCESS
);
1991 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
1992 case OPTION_TSTAMP_PRECISION
:
1993 ndo
->ndo_tstamp_precision
= tstamp_precision_from_string(optarg
);
1994 if (ndo
->ndo_tstamp_precision
< 0)
1995 error("unsupported time stamp precision");
1999 #ifdef HAVE_PCAP_SET_IMMEDIATE_MODE
2000 case OPTION_IMMEDIATE_MODE
:
2009 case OPTION_PRINT_SAMPLING
:
2012 ndo
->ndo_print_sampling
= atoi(optarg
);
2013 if (ndo
->ndo_print_sampling
<= 0)
2014 error("invalid print sampling %s", optarg
);
2017 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2018 case OPTION_TSTAMP_MICRO
:
2019 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_MICRO
;
2022 case OPTION_TSTAMP_NANO
:
2023 ndo
->ndo_tstamp_precision
= PCAP_TSTAMP_PRECISION_NANO
;
2027 case OPTION_FP_TYPE
:
2029 * Print out the type of floating-point arithmetic
2030 * we're doing; it's probably IEEE, unless somebody
2031 * tries to run this on a VAX, but the precision
2032 * may differ (e.g., it might be 32-bit, 64-bit,
2035 float_type_check(0x4e93312d);
2043 print_usage(stderr
);
2044 exit_tcpdump(S_ERR_HOST_PROGRAM
);
2048 #ifdef HAVE_PCAP_FINDALLDEVS
2050 show_devices_and_exit();
2052 #ifdef HAVE_PCAP_FINDALLDEVS_EX
2053 if (remote_interfaces_source
!= NULL
)
2054 show_remote_devices_and_exit();
2057 switch (ndo
->ndo_tflag
) {
2059 case 0: /* Default */
2060 case 1: /* No time stamp */
2061 case 2: /* Unix timeval style */
2062 case 3: /* Microseconds/nanoseconds since previous packet */
2063 case 4: /* Date + Default */
2064 case 5: /* Microseconds/nanoseconds since first packet */
2067 default: /* Not supported */
2068 error("only -t, -tt, -ttt, -tttt and -ttttt are supported");
2072 if (ndo
->ndo_fflag
!= 0 && (VFileName
!= NULL
|| RFileName
!= NULL
))
2073 error("-f can not be used with -V or -r");
2075 if (VFileName
!= NULL
&& RFileName
!= NULL
)
2076 error("-V and -r are mutually exclusive.");
2079 * If we're printing dissected packets to the standard output,
2080 * and either the standard output is a terminal or we're doing
2081 * "line" buffering, set the capture timeout to .1 second rather
2082 * than 1 second, as the user's probably expecting to see packets
2083 * pop up immediately shortly after they arrive.
2085 * XXX - would there be some value appropriate for all cases,
2086 * based on, say, the buffer size and packet input rate?
2088 if ((WFileName
== NULL
|| print
) && (isatty(1) || lflag
))
2092 /* if run as root, prepare for chrooting */
2093 if (getuid() == 0 || geteuid() == 0) {
2094 /* future extensibility for cmd-line arguments */
2096 chroot_dir
= WITH_CHROOT
;
2101 /* if run as root, prepare for dropping root privileges */
2102 if (getuid() == 0 || geteuid() == 0) {
2103 /* Run with '-Z root' to restore old behaviour */
2105 username
= WITH_USER
;
2106 else if (strcmp(username
, "root") == 0)
2111 if (RFileName
!= NULL
|| VFileName
!= NULL
) {
2113 * If RFileName is non-null, it's the pathname of a
2114 * savefile to read. If VFileName is non-null, it's
2115 * the pathname of a file containing a list of pathnames
2116 * (one per line) of savefiles to read.
2118 * In either case, we're reading a savefile, not doing
2123 * We don't need network access, so relinquish any set-UID
2124 * or set-GID privileges we have (if any).
2126 * We do *not* want set-UID privileges when opening a
2127 * trace file, as that might let the user read other
2128 * people's trace files (especially if we're set-UID
2131 if (setgid(getgid()) != 0 || setuid(getuid()) != 0 )
2132 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2134 if (VFileName
!= NULL
) {
2135 if (VFileName
[0] == '-' && VFileName
[1] == '\0')
2138 VFile
= fopen(VFileName
, "r");
2141 error("Unable to open file: %s\n", pcap_strerror(errno
));
2143 ret
= get_next_file(VFile
, VFileLine
);
2145 error("Nothing in %s\n", VFileName
);
2146 RFileName
= VFileLine
;
2149 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
2150 pd
= pcap_open_offline_with_tstamp_precision(RFileName
,
2151 ndo
->ndo_tstamp_precision
, ebuf
);
2153 pd
= pcap_open_offline(RFileName
, ebuf
);
2158 #ifdef HAVE_CAPSICUM
2159 cap_rights_init(&rights
, CAP_READ
);
2160 if (cap_rights_limit(fileno(pcap_file(pd
)), &rights
) < 0 &&
2162 error("unable to limit pcap descriptor");
2165 dlt
= pcap_datalink(pd
);
2166 dlt_name
= pcap_datalink_val_to_name(dlt
);
2167 fprintf(stderr
, "reading from file %s", RFileName
);
2168 if (dlt_name
== NULL
) {
2169 fprintf(stderr
, ", link-type %u", dlt
);
2171 fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2172 pcap_datalink_val_to_description(dlt
));
2174 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2175 #ifdef DLT_LINUX_SLL2
2176 if (dlt
== DLT_LINUX_SLL2
)
2177 fprintf(stderr
, "Warning: interface names might be incorrect\n");
2179 } else if (dflag
&& !device
) {
2180 int dump_dlt
= DLT_EN10MB
;
2182 * We're dumping the compiled code without an explicit
2183 * device specification. (If a device is specified, we
2184 * definitely want to open it to use the DLT of that device.)
2185 * Either default to DLT_EN10MB with a warning, or use
2186 * the user-specified value if supplied.
2189 * If no snapshot length was specified, or a length of 0 was
2190 * specified, default to 256KB.
2192 if (ndo
->ndo_snaplen
== 0)
2193 ndo
->ndo_snaplen
= MAXIMUM_SNAPLEN
;
2195 * If a DLT was specified with the -y flag, use that instead.
2197 if (yflag_dlt
!= -1)
2198 dump_dlt
= yflag_dlt
;
2200 fprintf(stderr
, "Warning: assuming Ethernet\n");
2201 pd
= pcap_open_dead(dump_dlt
, ndo
->ndo_snaplen
);
2204 * We're doing a live capture.
2206 if (device
== NULL
) {
2208 * No interface was specified. Pick one.
2210 #ifdef HAVE_PCAP_FINDALLDEVS
2212 * Find the list of interfaces, and pick
2213 * the first interface.
2215 if (pcap_findalldevs(&devlist
, ebuf
) == -1)
2217 if (devlist
== NULL
)
2218 error("no interfaces available for capture");
2219 device
= strdup(devlist
->name
);
2220 pcap_freealldevs(devlist
);
2221 #else /* HAVE_PCAP_FINDALLDEVS */
2223 * Use whatever interface pcap_lookupdev()
2226 device
= pcap_lookupdev(ebuf
);
2233 * Try to open the interface with the specified name.
2235 pd
= open_interface(device
, ndo
, ebuf
);
2238 * That failed. If we can get a list of
2239 * interfaces, and the interface name
2240 * is purely numeric, try to use it as
2241 * a 1-based index in the list of
2244 #ifdef HAVE_PCAP_FINDALLDEVS
2245 devnum
= parse_interface_number(device
);
2248 * It's not a number; just report
2249 * the open error and fail.
2255 * OK, it's a number; try to find the
2256 * interface with that index, and try
2259 * find_interface_by_number() exits if it
2260 * couldn't be found.
2262 device
= find_interface_by_number(device
, devnum
);
2263 pd
= open_interface(device
, ndo
, ebuf
);
2266 #else /* HAVE_PCAP_FINDALLDEVS */
2268 * We can't get a list of interfaces; just
2272 #endif /* HAVE_PCAP_FINDALLDEVS */
2276 * Let user own process after capture device has
2280 if (setgid(getgid()) != 0 || setuid(getuid()) != 0)
2281 fprintf(stderr
, "Warning: setgid/setuid failed !\n");
2283 #if !defined(HAVE_PCAP_CREATE) && defined(_WIN32)
2285 if(pcap_setbuff(pd
, Bflag
)==-1){
2286 error("%s", pcap_geterr(pd
));
2288 #endif /* !defined(HAVE_PCAP_CREATE) && defined(_WIN32) */
2290 show_dlts_and_exit(pd
, device
);
2291 if (yflag_dlt
>= 0) {
2292 #ifdef HAVE_PCAP_SET_DATALINK
2293 if (pcap_set_datalink(pd
, yflag_dlt
) < 0)
2294 error("%s", pcap_geterr(pd
));
2297 * We don't actually support changing the
2298 * data link type, so we only let them
2299 * set it to what it already is.
2301 if (yflag_dlt
!= pcap_datalink(pd
)) {
2302 error("%s is not one of the DLTs supported by this device\n",
2306 (void)fprintf(stderr
, "%s: data link type %s\n",
2308 pcap_datalink_val_to_name(yflag_dlt
));
2309 (void)fflush(stderr
);
2311 #if defined(DLT_LINUX_SLL2) && defined(HAVE_PCAP_SET_DATALINK)
2314 * Attempt to set default linktype to
2315 * DLT_LINUX_SLL2 when capturing on the
2318 * If the attempt fails, just quietly drive
2319 * on; this may be a non-Linux "any" device
2320 * that doesn't support DLT_LINUX_SLL2.
2322 if (strcmp(device
, "any") == 0)
2323 (void) pcap_set_datalink(pd
, DLT_LINUX_SLL2
);
2326 i
= pcap_snapshot(pd
);
2327 if (ndo
->ndo_snaplen
< i
) {
2328 if (ndo
->ndo_snaplen
!= 0)
2329 warning("snaplen raised from %d to %d", ndo
->ndo_snaplen
, i
);
2330 ndo
->ndo_snaplen
= i
;
2331 } else if (ndo
->ndo_snaplen
> i
) {
2332 warning("snaplen lowered from %d to %d", ndo
->ndo_snaplen
, i
);
2333 ndo
->ndo_snaplen
= i
;
2335 if(ndo
->ndo_fflag
!= 0) {
2336 if (pcap_lookupnet(device
, &localnet
, &netmask
, ebuf
) < 0) {
2337 warning("foreign (-f) flag used but: %s", ebuf
);
2343 cmdbuf
= read_infile(infile
);
2345 cmdbuf
= copy_argv(&argv
[optind
]);
2347 #ifdef HAVE_PCAP_SET_OPTIMIZER_DEBUG
2348 pcap_set_optimizer_debug(dflag
);
2350 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2351 error("%s", pcap_geterr(pd
));
2353 bpf_dump(&fcode
, dflag
);
2356 pcap_freecode(&fcode
);
2357 exit_tcpdump(S_SUCCESS
);
2361 if (!ndo
->ndo_nflag
)
2362 capdns
= capdns_setup();
2363 #endif /* HAVE_CASPER */
2365 init_print(ndo
, localnet
, netmask
);
2368 (void)setsignal(SIGPIPE
, cleanup
);
2369 (void)setsignal(SIGTERM
, cleanup
);
2371 (void)setsignal(SIGINT
, cleanup
);
2372 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2373 (void)setsignal(SIGCHLD
, child_cleanup
);
2375 /* Cooperate with nohup(1) */
2377 if ((oldhandler
= setsignal(SIGHUP
, cleanup
)) != SIG_DFL
)
2378 (void)setsignal(SIGHUP
, oldhandler
);
2383 * If a user name was specified with "-Z", attempt to switch to
2384 * that user's UID. This would probably be used with sudo,
2385 * to allow tcpdump to be run in a special restricted
2386 * account (if you just want to allow users to open capture
2387 * devices, and can't just give users that permission,
2388 * you'd make tcpdump set-UID or set-GID).
2390 * Tcpdump doesn't necessarily write only to one savefile;
2391 * the general only way to allow a -Z instance to write to
2392 * savefiles as the user under whose UID it's run, rather
2393 * than as the user specified with -Z, would thus be to switch
2394 * to the original user ID before opening a capture file and
2395 * then switch back to the -Z user ID after opening the savefile.
2396 * Switching to the -Z user ID only after opening the first
2397 * savefile doesn't handle the general case.
2400 if (getuid() == 0 || geteuid() == 0) {
2401 #ifdef HAVE_LIBCAP_NG
2402 /* Initialize capng */
2403 capng_clear(CAPNG_SELECT_BOTH
);
2405 DIAG_OFF_ASSIGN_ENUM
2408 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2415 DIAG_OFF_ASSIGN_ENUM
2418 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2425 DIAG_OFF_ASSIGN_ENUM
2428 CAPNG_PERMITTED
| CAPNG_EFFECTIVE
,
2433 capng_apply(CAPNG_SELECT_BOTH
);
2434 #endif /* HAVE_LIBCAP_NG */
2435 if (username
|| chroot_dir
)
2436 droproot(username
, chroot_dir
);
2441 if (pcap_setfilter(pd
, &fcode
) < 0)
2442 error("%s", pcap_geterr(pd
));
2443 #ifdef HAVE_CAPSICUM
2444 if (RFileName
== NULL
&& VFileName
== NULL
&& pcap_fileno(pd
) != -1) {
2445 static const unsigned long cmds
[] = { BIOCGSTATS
, BIOCROTZBUF
};
2448 * The various libpcap devices use a combination of
2449 * read (bpf), ioctl (bpf, netmap), poll (netmap)
2450 * so we add the relevant access rights.
2452 cap_rights_init(&rights
, CAP_IOCTL
, CAP_READ
, CAP_EVENT
);
2453 if (cap_rights_limit(pcap_fileno(pd
), &rights
) < 0 &&
2455 error("unable to limit pcap descriptor");
2457 if (cap_ioctls_limit(pcap_fileno(pd
), cmds
,
2458 sizeof(cmds
) / sizeof(cmds
[0])) < 0 && errno
!= ENOSYS
) {
2459 error("unable to limit ioctls on pcap descriptor");
2464 /* Do not exceed the default PATH_MAX for files. */
2465 dumpinfo
.CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
2467 if (dumpinfo
.CurrentFileName
== NULL
)
2468 error("malloc of dumpinfo.CurrentFileName");
2470 /* We do not need numbering for dumpfiles if Cflag isn't set. */
2472 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, WflagChars
);
2474 MakeFilename(dumpinfo
.CurrentFileName
, WFileName
, 0, 0);
2476 pdd
= pcap_dump_open(pd
, dumpinfo
.CurrentFileName
);
2477 #ifdef HAVE_LIBCAP_NG
2478 /* Give up CAP_DAC_OVERRIDE capability.
2479 * Only allow it to be restored if the -C or -G flag have been
2480 * set since we may need to create more files later on.
2484 (Cflag
|| Gflag
? 0 : CAPNG_PERMITTED
)
2488 capng_apply(CAPNG_SELECT_BOTH
);
2489 #endif /* HAVE_LIBCAP_NG */
2491 error("%s", pcap_geterr(pd
));
2492 #ifdef HAVE_CAPSICUM
2493 set_dumper_capsicum_rights(pdd
);
2495 if (Cflag
!= 0 || Gflag
!= 0) {
2496 #ifdef HAVE_CAPSICUM
2498 * basename() and dirname() may modify their input buffer
2499 * and they do since FreeBSD 12.0, but they didn't before.
2500 * Hence use the return value only, but always assume the
2501 * input buffer has been modified and would need to be
2502 * reset before the next use.
2504 char *WFileName_copy
;
2506 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2507 error("Unable to allocate memory for file %s",
2510 DIAG_OFF_C11_EXTENSIONS
2511 dumpinfo
.WFileName
= strdup(basename(WFileName_copy
));
2512 DIAG_ON_C11_EXTENSIONS
2513 if (dumpinfo
.WFileName
== NULL
) {
2514 error("Unable to allocate memory for file %s",
2517 free(WFileName_copy
);
2519 if ((WFileName_copy
= strdup(WFileName
)) == NULL
) {
2520 error("Unable to allocate memory for file %s",
2523 DIAG_OFF_C11_EXTENSIONS
2524 char *WFileName_dirname
= dirname(WFileName_copy
);
2525 DIAG_ON_C11_EXTENSIONS
2526 dumpinfo
.dirfd
= open(WFileName_dirname
,
2527 O_DIRECTORY
| O_RDONLY
);
2528 if (dumpinfo
.dirfd
< 0) {
2529 error("unable to open directory %s",
2532 free(WFileName_dirname
);
2533 free(WFileName_copy
);
2535 cap_rights_init(&rights
, CAP_CREATE
, CAP_FCNTL
,
2536 CAP_FTRUNCATE
, CAP_LOOKUP
, CAP_SEEK
, CAP_WRITE
);
2537 if (cap_rights_limit(dumpinfo
.dirfd
, &rights
) < 0 &&
2539 error("unable to limit directory rights");
2541 if (cap_fcntls_limit(dumpinfo
.dirfd
, CAP_FCNTL_GETFL
) < 0 &&
2543 error("unable to limit dump descriptor fcntls");
2545 #else /* !HAVE_CAPSICUM */
2546 dumpinfo
.WFileName
= WFileName
;
2548 callback
= dump_packet_and_trunc
;
2551 pcap_userdata
= (u_char
*)&dumpinfo
;
2553 callback
= dump_packet
;
2554 dumpinfo
.WFileName
= WFileName
;
2557 pcap_userdata
= (u_char
*)&dumpinfo
;
2560 dlt
= pcap_datalink(pd
);
2561 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2564 dumpinfo
.ndo
= NULL
;
2566 #ifdef HAVE_PCAP_DUMP_FLUSH
2568 pcap_dump_flush(pdd
);
2571 dlt
= pcap_datalink(pd
);
2572 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2573 callback
= print_packet
;
2574 pcap_userdata
= (u_char
*)ndo
;
2577 #ifdef SIGNAL_REQ_INFO
2579 * We can't get statistics when reading from a file rather
2580 * than capturing from a device.
2582 if (RFileName
== NULL
)
2583 (void)setsignal(SIGNAL_REQ_INFO
, requestinfo
);
2585 #ifdef SIGNAL_FLUSH_PCAP
2586 (void)setsignal(SIGNAL_FLUSH_PCAP
, flushpcap
);
2589 if (ndo
->ndo_vflag
> 0 && WFileName
&& RFileName
== NULL
&& !print
) {
2591 * When capturing to a file, if "--print" wasn't specified,
2592 *"-v" means tcpdump should, once per second,
2593 * "v"erbosely report the number of packets captured.
2594 * Except when reading from a file, because -r, -w and -v
2595 * together used to make a corner case, in which pcap_loop()
2596 * errored due to EINTR (see GH #155 for details).
2600 * https://blogs.msdn.microsoft.com/oldnewthing/20151230-00/?p=92741
2602 * suggests that this dates back to W2K.
2604 * I don't know what a "long wait" is, but we'll assume
2605 * that printing the stats could be a "long wait".
2607 CreateTimerQueueTimer(&timer_handle
, NULL
,
2608 verbose_stats_dump
, NULL
, 1000, 1000,
2609 WT_EXECUTEDEFAULT
|WT_EXECUTELONGFUNCTION
);
2610 setvbuf(stderr
, NULL
, _IONBF
, 0);
2613 * Assume this is UN*X, and that it has setitimer(); that
2614 * dates back to UNIX 95.
2616 struct itimerval timer
;
2617 (void)setsignal(SIGALRM
, verbose_stats_dump
);
2618 timer
.it_interval
.tv_sec
= 1;
2619 timer
.it_interval
.tv_usec
= 0;
2620 timer
.it_value
.tv_sec
= 1;
2621 timer
.it_value
.tv_usec
= 1;
2622 setitimer(ITIMER_REAL
, &timer
, NULL
);
2626 if (RFileName
== NULL
) {
2628 * Live capture (if -V was specified, we set RFileName
2629 * to a file from the -V file). Print a message to
2630 * the standard error on UN*X.
2632 if (!ndo
->ndo_vflag
&& !WFileName
) {
2633 (void)fprintf(stderr
,
2634 "%s: verbose output suppressed, use -v[v]... for full protocol decode\n",
2637 (void)fprintf(stderr
, "%s: ", program_name
);
2638 dlt
= pcap_datalink(pd
);
2639 dlt_name
= pcap_datalink_val_to_name(dlt
);
2640 (void)fprintf(stderr
, "listening on %s", device
);
2641 if (dlt_name
== NULL
) {
2642 (void)fprintf(stderr
, ", link-type %u", dlt
);
2644 (void)fprintf(stderr
, ", link-type %s (%s)", dlt_name
,
2645 pcap_datalink_val_to_description(dlt
));
2647 (void)fprintf(stderr
, ", snapshot length %d bytes\n", ndo
->ndo_snaplen
);
2648 (void)fflush(stderr
);
2651 #ifdef HAVE_CAPSICUM
2652 cansandbox
= (VFileName
== NULL
&& zflag
== NULL
);
2654 cansandbox
= (cansandbox
&& (ndo
->ndo_nflag
|| capdns
!= NULL
));
2656 cansandbox
= (cansandbox
&& ndo
->ndo_nflag
);
2657 #endif /* HAVE_CASPER */
2658 cansandbox
= (cansandbox
&& (pcap_fileno(pd
) != -1 ||
2659 RFileName
!= NULL
));
2661 if (cansandbox
&& cap_enter() < 0 && errno
!= ENOSYS
)
2662 error("unable to enter the capability mode");
2663 #endif /* HAVE_CAPSICUM */
2666 status
= pcap_loop(pd
, cnt
, callback
, pcap_userdata
);
2667 if (WFileName
== NULL
) {
2669 * We're printing packets. Flush the printed output,
2670 * so it doesn't get intermingled with error output.
2674 * We got interrupted, so perhaps we didn't
2675 * manage to finish a line we were printing.
2676 * Print an extra newline, just in case.
2680 (void)fflush(stdout
);
2684 * We got interrupted. If we are reading multiple
2685 * files (via -V) set these so that we stop.
2694 (void)fprintf(stderr
, "%s: pcap_loop: %s\n",
2695 program_name
, pcap_geterr(pd
));
2697 if (RFileName
== NULL
) {
2699 * We're doing a live capture. Report the capture
2705 if (VFileName
!= NULL
) {
2706 ret
= get_next_file(VFile
, VFileLine
);
2710 RFileName
= VFileLine
;
2711 pd
= pcap_open_offline(RFileName
, ebuf
);
2714 #ifdef HAVE_CAPSICUM
2715 cap_rights_init(&rights
, CAP_READ
);
2716 if (cap_rights_limit(fileno(pcap_file(pd
)),
2717 &rights
) < 0 && errno
!= ENOSYS
) {
2718 error("unable to limit pcap descriptor");
2721 new_dlt
= pcap_datalink(pd
);
2722 if (new_dlt
!= dlt
) {
2724 * The new file has a different
2725 * link-layer header type from the
2728 if (WFileName
!= NULL
) {
2730 * We're writing raw packets
2731 * that match the filter to
2732 * a pcap file. pcap files
2733 * don't support multiple
2734 * different link-layer
2735 * header types, so we fail
2738 error("%s: new dlt does not match original", RFileName
);
2742 * We're printing the decoded packets;
2743 * switch to the new DLT.
2745 * To do that, we need to change
2746 * the printer, change the DLT name,
2747 * and recompile the filter with
2751 ndo
->ndo_if_printer
= get_if_printer(dlt
);
2752 /* Free the old filter */
2753 pcap_freecode(&fcode
);
2754 if (pcap_compile(pd
, &fcode
, cmdbuf
, Oflag
, netmask
) < 0)
2755 error("%s", pcap_geterr(pd
));
2759 * Set the filter on the new file.
2761 if (pcap_setfilter(pd
, &fcode
) < 0)
2762 error("%s", pcap_geterr(pd
));
2765 * Report the new file.
2767 dlt_name
= pcap_datalink_val_to_name(dlt
);
2768 fprintf(stderr
, "reading from file %s", RFileName
);
2769 if (dlt_name
== NULL
) {
2770 fprintf(stderr
, ", link-type %u", dlt
);
2772 fprintf(stderr
, ", link-type %s (%s)",
2774 pcap_datalink_val_to_description(dlt
));
2776 fprintf(stderr
, ", snapshot length %d\n", pcap_snapshot(pd
));
2780 while (ret
!= NULL
);
2782 if (count_mode
&& RFileName
!= NULL
)
2783 fprintf(stdout
, "%u packet%s\n", packets_captured
,
2784 PLURAL_SUFFIX(packets_captured
));
2787 pcap_freecode(&fcode
);
2788 exit_tcpdump(status
== -1 ? S_ERR_HOST_PROGRAM
: S_SUCCESS
);
2795 (*setsignal (int sig
, void (*func
)(int)))(int)
2798 return (signal(sig
, func
));
2800 struct sigaction old
, new;
2802 memset(&new, 0, sizeof(new));
2803 new.sa_handler
= func
;
2804 if ((sig
== SIGCHLD
)
2805 # ifdef SIGNAL_REQ_INFO
2806 || (sig
== SIGNAL_REQ_INFO
)
2808 # ifdef SIGNAL_FLUSH_PCAP
2809 || (sig
== SIGNAL_FLUSH_PCAP
)
2812 new.sa_flags
= SA_RESTART
;
2813 if (sigaction(sig
, &new, &old
) < 0)
2815 return (old
.sa_handler
);
2819 /* make a clean exit on interrupts */
2821 cleanup(int signo _U_
)
2824 if (timer_handle
!= INVALID_HANDLE_VALUE
) {
2825 DeleteTimerQueueTimer(NULL
, timer_handle
, NULL
);
2826 CloseHandle(timer_handle
);
2827 timer_handle
= INVALID_HANDLE_VALUE
;
2830 struct itimerval timer
;
2832 timer
.it_interval
.tv_sec
= 0;
2833 timer
.it_interval
.tv_usec
= 0;
2834 timer
.it_value
.tv_sec
= 0;
2835 timer
.it_value
.tv_usec
= 0;
2836 setitimer(ITIMER_REAL
, &timer
, NULL
);
2839 #ifdef HAVE_PCAP_BREAKLOOP
2841 * We have "pcap_breakloop()"; use it, so that we do as little
2842 * as possible in the signal handler (it's probably not safe
2843 * to do anything with standard I/O streams in a signal handler -
2844 * the ANSI C standard doesn't say it is).
2849 * We don't have "pcap_breakloop()"; this isn't safe, but
2850 * it's the best we can do. Print the summary if we're
2851 * not reading from a savefile - i.e., if we're doing a
2852 * live capture - and exit.
2854 if (pd
!= NULL
&& pcap_file(pd
) == NULL
) {
2856 * We got interrupted, so perhaps we didn't
2857 * manage to finish a line we were printing.
2858 * Print an extra newline, just in case.
2861 (void)fflush(stdout
);
2864 exit_tcpdump(S_SUCCESS
);
2869 On windows, we do not use a fork, so we do not care less about
2870 waiting a child processes to die
2872 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2874 child_cleanup(int signo _U_
)
2876 while (waitpid(-1, NULL
, WNOHANG
) >= 0);
2878 #endif /* HAVE_FORK && HAVE_VFORK */
2883 struct pcap_stat stats
;
2886 * Older versions of libpcap didn't set ps_ifdrop on some
2887 * platforms; initialize it to 0 to handle that.
2889 stats
.ps_ifdrop
= 0;
2890 if (pcap_stats(pd
, &stats
) < 0) {
2891 (void)fprintf(stderr
, "pcap_stats: %s\n", pcap_geterr(pd
));
2897 fprintf(stderr
, "%s: ", program_name
);
2899 (void)fprintf(stderr
, "%u packet%s captured", packets_captured
,
2900 PLURAL_SUFFIX(packets_captured
));
2902 fputs(", ", stderr
);
2905 (void)fprintf(stderr
, "%u packet%s received by filter", stats
.ps_recv
,
2906 PLURAL_SUFFIX(stats
.ps_recv
));
2908 fputs(", ", stderr
);
2911 (void)fprintf(stderr
, "%u packet%s dropped by kernel", stats
.ps_drop
,
2912 PLURAL_SUFFIX(stats
.ps_drop
));
2913 if (stats
.ps_ifdrop
!= 0) {
2915 fputs(", ", stderr
);
2918 (void)fprintf(stderr
, "%u packet%s dropped by interface\n",
2919 stats
.ps_ifdrop
, PLURAL_SUFFIX(stats
.ps_ifdrop
));
2925 #if defined(HAVE_FORK) || defined(HAVE_VFORK)
2927 #define fork_subprocess() fork()
2929 #define fork_subprocess() vfork()
2932 compress_savefile(const char *filename
)
2936 child
= fork_subprocess();
2939 "compress_savefile: fork failed: %s\n",
2940 pcap_strerror(errno
));
2944 /* Parent process. */
2950 * Set to lowest priority so that this doesn't disturb the capture.
2953 setpriority(PRIO_PROCESS
, 0, NZERO
- 1);
2955 setpriority(PRIO_PROCESS
, 0, 19);
2957 if (execlp(zflag
, zflag
, filename
, (char *)NULL
) == -1)
2959 "compress_savefile: execlp(%s, %s) failed: %s\n",
2962 pcap_strerror(errno
));
2964 exit(S_ERR_HOST_PROGRAM
);
2966 _exit(S_ERR_HOST_PROGRAM
);
2969 #else /* HAVE_FORK && HAVE_VFORK */
2971 compress_savefile(const char *filename
)
2974 "compress_savefile failed. Functionality not implemented under your system\n");
2976 #endif /* HAVE_FORK && HAVE_VFORK */
2979 dump_packet_and_trunc(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
2981 struct dump_info
*dump_info
;
2987 dump_info
= (struct dump_info
*)user
;
2990 * XXX - this won't force the file to rotate on the specified time
2991 * boundary, but it will rotate on the first packet received after the
2992 * specified Gflag number of seconds. Note: if a Gflag time boundary
2993 * and a Cflag size boundary coincide, the time rotation will occur
2994 * first thereby cancelling the Cflag boundary (since the file should
2998 /* Check if it is time to rotate */
3001 /* Get the current time */
3002 if ((t
= time(NULL
)) == (time_t)-1) {
3003 error("%s: can't get current_time: %s",
3004 __func__
, pcap_strerror(errno
));
3008 /* If the time is greater than the specified window, rotate */
3009 if (t
- Gflag_time
>= Gflag
) {
3010 #ifdef HAVE_CAPSICUM
3015 /* Update the Gflag_time */
3017 /* Update Gflag_count */
3020 * Close the current file and open a new one.
3022 pcap_dump_close(dump_info
->pdd
);
3025 * Compress the file we just closed, if the user asked for it
3028 compress_savefile(dump_info
->CurrentFileName
);
3031 * Check to see if we've exceeded the Wflag (when
3034 if (Cflag
== 0 && Wflag
> 0 && Gflag_count
>= Wflag
) {
3035 (void)fprintf(stderr
, "Maximum file limit reached: %d\n",
3038 exit_tcpdump(S_SUCCESS
);
3041 if (dump_info
->CurrentFileName
!= NULL
)
3042 free(dump_info
->CurrentFileName
);
3043 /* Allocate space for max filename + \0. */
3044 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3045 if (dump_info
->CurrentFileName
== NULL
)
3046 error("dump_packet_and_trunc: malloc");
3048 * Gflag was set otherwise we wouldn't be here. Reset the count
3049 * so multiple files would end with 1,2,3 in the filename.
3050 * The counting is handled with the -C flow after this.
3055 * This is always the first file in the Cflag
3057 * We also don't need numbering if Cflag is not set.
3060 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0,
3063 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, 0, 0);
3065 #ifdef HAVE_LIBCAP_NG
3066 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3067 capng_apply(CAPNG_SELECT_BOTH
);
3068 #endif /* HAVE_LIBCAP_NG */
3069 #ifdef HAVE_CAPSICUM
3070 fd
= openat(dump_info
->dirfd
,
3071 dump_info
->CurrentFileName
,
3072 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3074 error("unable to open file %s",
3075 dump_info
->CurrentFileName
);
3077 fp
= fdopen(fd
, "w");
3079 error("unable to fdopen file %s",
3080 dump_info
->CurrentFileName
);
3082 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3083 #else /* !HAVE_CAPSICUM */
3084 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3086 #ifdef HAVE_LIBCAP_NG
3087 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3088 capng_apply(CAPNG_SELECT_BOTH
);
3089 #endif /* HAVE_LIBCAP_NG */
3090 if (dump_info
->pdd
== NULL
)
3091 error("%s", pcap_geterr(pd
));
3092 #ifdef HAVE_CAPSICUM
3093 set_dumper_capsicum_rights(dump_info
->pdd
);
3099 * XXX - this won't prevent capture files from getting
3100 * larger than Cflag - the last packet written to the
3101 * file could put it over Cflag.
3104 #ifdef HAVE_PCAP_DUMP_FTELL64
3105 int64_t size
= pcap_dump_ftell64(dump_info
->pdd
);
3108 * XXX - this only handles a Cflag value > 2^31-1 on
3109 * LP64 platforms; to handle ILP32 (32-bit UN*X and
3110 * Windows) or LLP64 (64-bit Windows) would require
3111 * a version of libpcap with pcap_dump_ftell64().
3113 long size
= pcap_dump_ftell(dump_info
->pdd
);
3117 error("ftell fails on output file");
3119 #ifdef HAVE_CAPSICUM
3125 * Close the current file and open a new one.
3127 pcap_dump_close(dump_info
->pdd
);
3130 * Compress the file we just closed, if the user
3134 compress_savefile(dump_info
->CurrentFileName
);
3138 if (Cflag_count
>= Wflag
)
3141 if (dump_info
->CurrentFileName
!= NULL
)
3142 free(dump_info
->CurrentFileName
);
3143 dump_info
->CurrentFileName
= (char *)malloc(PATH_MAX
+ 1);
3144 if (dump_info
->CurrentFileName
== NULL
)
3145 error("%s: malloc", __func__
);
3146 MakeFilename(dump_info
->CurrentFileName
, dump_info
->WFileName
, Cflag_count
, WflagChars
);
3147 #ifdef HAVE_LIBCAP_NG
3148 capng_update(CAPNG_ADD
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3149 capng_apply(CAPNG_SELECT_BOTH
);
3150 #endif /* HAVE_LIBCAP_NG */
3151 #ifdef HAVE_CAPSICUM
3152 fd
= openat(dump_info
->dirfd
, dump_info
->CurrentFileName
,
3153 O_CREAT
| O_WRONLY
| O_TRUNC
, 0644);
3155 error("unable to open file %s",
3156 dump_info
->CurrentFileName
);
3158 fp
= fdopen(fd
, "w");
3160 error("unable to fdopen file %s",
3161 dump_info
->CurrentFileName
);
3163 dump_info
->pdd
= pcap_dump_fopen(dump_info
->pd
, fp
);
3164 #else /* !HAVE_CAPSICUM */
3165 dump_info
->pdd
= pcap_dump_open(dump_info
->pd
, dump_info
->CurrentFileName
);
3167 #ifdef HAVE_LIBCAP_NG
3168 capng_update(CAPNG_DROP
, CAPNG_EFFECTIVE
, CAP_DAC_OVERRIDE
);
3169 capng_apply(CAPNG_SELECT_BOTH
);
3170 #endif /* HAVE_LIBCAP_NG */
3171 if (dump_info
->pdd
== NULL
)
3172 error("%s", pcap_geterr(pd
));
3173 #ifdef HAVE_CAPSICUM
3174 set_dumper_capsicum_rights(dump_info
->pdd
);
3179 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3180 #ifdef HAVE_PCAP_DUMP_FLUSH
3182 pcap_dump_flush(dump_info
->pdd
);
3185 if (dump_info
->ndo
!= NULL
)
3186 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3194 dump_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3196 struct dump_info
*dump_info
;
3202 dump_info
= (struct dump_info
*)user
;
3204 pcap_dump((u_char
*)dump_info
->pdd
, h
, sp
);
3205 #ifdef HAVE_PCAP_DUMP_FLUSH
3207 pcap_dump_flush(dump_info
->pdd
);
3210 if (dump_info
->ndo
!= NULL
)
3211 pretty_print_packet(dump_info
->ndo
, h
, sp
, packets_captured
);
3219 print_packet(u_char
*user
, const struct pcap_pkthdr
*h
, const u_char
*sp
)
3226 pretty_print_packet((netdissect_options
*)user
, h
, sp
, packets_captured
);
3233 #ifdef SIGNAL_REQ_INFO
3235 requestinfo(int signo _U_
)
3244 #ifdef SIGNAL_FLUSH_PCAP
3246 flushpcap(int signo _U_
)
3249 pcap_dump_flush(pdd
);
3254 print_packets_captured (void)
3256 static u_int prev_packets_captured
, first
= 1;
3258 if (infodelay
== 0 && (first
|| packets_captured
!= prev_packets_captured
)) {
3259 fprintf(stderr
, "Got %u\r", packets_captured
);
3261 prev_packets_captured
= packets_captured
;
3266 * Called once each second in verbose mode while dumping to file
3269 static void CALLBACK
verbose_stats_dump(PVOID param _U_
,
3270 BOOLEAN timer_fired _U_
)
3272 print_packets_captured();
3275 static void verbose_stats_dump(int sig _U_
)
3277 print_packets_captured();
3281 DIAG_OFF_DEPRECATION
3283 print_version(FILE *f
)
3285 #ifndef HAVE_PCAP_LIB_VERSION
3286 #ifdef HAVE_PCAP_VERSION
3287 extern char pcap_version
[];
3288 #else /* HAVE_PCAP_VERSION */
3289 static char pcap_version
[] = "unknown";
3290 #endif /* HAVE_PCAP_VERSION */
3291 #endif /* HAVE_PCAP_LIB_VERSION */
3292 const char *smi_version_string
;
3294 (void)fprintf(f
, "%s version " PACKAGE_VERSION
"\n", program_name
);
3295 #ifdef HAVE_PCAP_LIB_VERSION
3296 (void)fprintf(f
, "%s\n", pcap_lib_version());
3297 #else /* HAVE_PCAP_LIB_VERSION */
3298 (void)fprintf(f
, "libpcap version %s\n", pcap_version
);
3299 #endif /* HAVE_PCAP_LIB_VERSION */
3301 #if defined(HAVE_LIBCRYPTO) && defined(SSLEAY_VERSION)
3302 (void)fprintf (f
, "%s\n", SSLeay_version(SSLEAY_VERSION
));
3305 smi_version_string
= nd_smi_version_string();
3306 if (smi_version_string
!= NULL
)
3307 (void)fprintf (f
, "SMI-library: %s\n", smi_version_string
);
3309 #if defined(__SANITIZE_ADDRESS__)
3310 (void)fprintf (f
, "Compiled with AddressSanitizer/GCC.\n");
3311 #elif defined(__has_feature)
3312 # if __has_feature(address_sanitizer)
3313 (void)fprintf (f
, "Compiled with AddressSanitizer/Clang.\n");
3314 # elif __has_feature(memory_sanitizer)
3315 (void)fprintf (f
, "Compiled with MemorySanitizer/Clang.\n");
3317 #endif /* __SANITIZE_ADDRESS__ or __has_feature */
3322 print_usage(FILE *f
)
3326 "Usage: %s [-Abd" D_FLAG
"efhH" I_FLAG J_FLAG
"KlLnNOpqStu" U_FLAG
"vxX#]" B_FLAG_USAGE
" [ -c count ] [--count]\n", program_name
);
3328 "\t\t[ -C file_size ] [ -E algo:secret ] [ -F file ] [ -G seconds ]\n");
3330 "\t\t[ -i interface ]" IMMEDIATE_MODE_USAGE j_FLAG_USAGE
"\n");
3331 #ifdef HAVE_PCAP_FINDALLDEVS_EX
3333 "\t\t" LIST_REMOTE_INTERFACES_USAGE
"\n");
3337 "\t\t" m_FLAG_USAGE
"\n");
3340 "\t\t[ -M secret ] [ --number ] [ --print ]\n");
3342 "\t\t[ --print-sampling nth ]" Q_FLAG_USAGE
" [ -r file ]\n");
3344 "\t\t[ -s snaplen ] [ -T type ] [ --version ]\n");
3346 "\t\t[ -V file ] [ -w file ] [ -W filecount ] [ -y datalinktype ]\n");
3347 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
3349 "\t\t[ --time-stamp-precision precision ] [ --micro ] [ --nano ]\n");
3352 "\t\t[ -z postrotate-command ] [ -Z user ] [ expression ]\n");