2 * Copyright (c) 1990, 1991, 1993, 1994, 1995, 1996, 1997
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.
23 * txtproto_print() derived from original code by Hannes Gredler
24 * (hannes@juniper.net):
26 * Redistribution and use in source and binary forms, with or without
27 * modification, are permitted provided that: (1) source code
28 * distributions retain the above copyright notice and this paragraph
29 * in its entirety, and (2) distributions including binary code include
30 * the above copyright notice and this paragraph in its entirety in
31 * the documentation or other materials provided with the distribution.
32 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND
33 * WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
34 * LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
35 * FOR A PARTICULAR PURPOSE.
42 #include <netdissect-stdinc.h>
55 #include "netdissect.h"
56 #include "ascii_strcasecmp.h"
57 #include "timeval-operations.h"
59 int32_t thiszone
; /* seconds offset from gmt to local time */
60 /* invalid string to print '(invalid)' for malformed or corrupted packets */
61 const char istr
[] = " (invalid)";
64 * timestamp display buffer size, the biggest size of both formats is needed
65 * sizeof("0000000000.000000000") > sizeof("00:00:00.000000000")
67 #define TS_BUF_SIZE sizeof("0000000000.000000000")
69 #define TOKBUFSIZE 128
72 * Print out a character, filtering out the non-printable ones
75 fn_print_char(netdissect_options
*ndo
, u_char c
)
79 ND_PRINT((ndo
, "M-"));
82 c
^= 0x40; /* DEL to ?, others to alpha */
85 ND_PRINT((ndo
, "%c", c
));
89 * Print out a null-terminated filename (or other ascii string).
90 * If ep is NULL, assume no truncation check is needed.
91 * Return true if truncated.
92 * Stop at ep (if given) or before the null char, whichever is first.
95 fn_print(netdissect_options
*ndo
,
96 register const u_char
*s
, register const u_char
*ep
)
101 ret
= 1; /* assume truncated */
102 while (ep
== NULL
|| s
< ep
) {
108 if (!ND_ISASCII(c
)) {
110 ND_PRINT((ndo
, "M-"));
112 if (!ND_ISPRINT(c
)) {
113 c
^= 0x40; /* DEL to ?, others to alpha */
114 ND_PRINT((ndo
, "^"));
116 ND_PRINT((ndo
, "%c", c
));
122 * Print out a null-terminated filename (or other ascii string) from
123 * a fixed-length buffer.
124 * If ep is NULL, assume no truncation check is needed.
125 * Return the number of bytes of string processed, including the
126 * terminating null, if not truncated. Return 0 if truncated.
129 fn_printztn(netdissect_options
*ndo
,
130 register const u_char
*s
, register u_int n
, register const u_char
*ep
)
132 register u_int bytes
;
137 if (n
== 0 || (ep
!= NULL
&& s
>= ep
)) {
139 * Truncated. This includes "no null before we
140 * got to the end of the fixed-length buffer".
142 * XXX - BOOTP says "null-terminated", which
143 * means the maximum length of the string, in
144 * bytes, is 1 less than the size of the buffer,
145 * as there must always be a terminating null.
158 if (!ND_ISASCII(c
)) {
160 ND_PRINT((ndo
, "M-"));
162 if (!ND_ISPRINT(c
)) {
163 c
^= 0x40; /* DEL to ?, others to alpha */
164 ND_PRINT((ndo
, "^"));
166 ND_PRINT((ndo
, "%c", c
));
172 * Print out a counted filename (or other ascii string).
173 * If ep is NULL, assume no truncation check is needed.
174 * Return true if truncated.
175 * Stop at ep (if given) or after n bytes, whichever is first.
178 fn_printn(netdissect_options
*ndo
,
179 register const u_char
*s
, register u_int n
, register const u_char
*ep
)
183 while (n
> 0 && (ep
== NULL
|| s
< ep
)) {
186 if (!ND_ISASCII(c
)) {
188 ND_PRINT((ndo
, "M-"));
190 if (!ND_ISPRINT(c
)) {
191 c
^= 0x40; /* DEL to ?, others to alpha */
192 ND_PRINT((ndo
, "^"));
194 ND_PRINT((ndo
, "%c", c
));
196 return (n
== 0) ? 0 : 1;
200 * Print out a null-padded filename (or other ascii string).
201 * If ep is NULL, assume no truncation check is needed.
202 * Return true if truncated.
203 * Stop at ep (if given) or after n bytes or before the null char,
204 * whichever is first.
207 fn_printzp(netdissect_options
*ndo
,
208 register const u_char
*s
, register u_int n
,
209 register const u_char
*ep
)
214 ret
= 1; /* assume truncated */
215 while (n
> 0 && (ep
== NULL
|| s
< ep
)) {
222 if (!ND_ISASCII(c
)) {
224 ND_PRINT((ndo
, "M-"));
226 if (!ND_ISPRINT(c
)) {
227 c
^= 0x40; /* DEL to ?, others to alpha */
228 ND_PRINT((ndo
, "^"));
230 ND_PRINT((ndo
, "%c", c
));
232 return (n
== 0) ? 0 : ret
;
236 * Format the timestamp
239 ts_format(netdissect_options
*ndo
240 #ifndef HAVE_PCAP_SET_TSTAMP_PRECISION
243 , int sec
, int usec
, char *buf
)
247 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
248 switch (ndo
->ndo_tstamp_precision
) {
250 case PCAP_TSTAMP_PRECISION_MICRO
:
251 format
= "%02d:%02d:%02d.%06u";
254 case PCAP_TSTAMP_PRECISION_NANO
:
255 format
= "%02d:%02d:%02d.%09u";
259 format
= "%02d:%02d:%02d.{unknown}";
263 format
= "%02d:%02d:%02d.%06u";
266 snprintf(buf
, TS_BUF_SIZE
, format
,
267 sec
/ 3600, (sec
% 3600) / 60, sec
% 60, usec
);
273 * Format the timestamp - Unix timeval style
276 ts_unix_format(netdissect_options
*ndo
277 #ifndef HAVE_PCAP_SET_TSTAMP_PRECISION
280 , int sec
, int usec
, char *buf
)
284 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
285 switch (ndo
->ndo_tstamp_precision
) {
287 case PCAP_TSTAMP_PRECISION_MICRO
:
291 case PCAP_TSTAMP_PRECISION_NANO
:
296 format
= "%u.{unknown}";
303 snprintf(buf
, TS_BUF_SIZE
, format
,
304 (unsigned)sec
, (unsigned)usec
);
310 * Print the timestamp
313 ts_print(netdissect_options
*ndo
,
314 register const struct timeval
*tvp
)
319 char buf
[TS_BUF_SIZE
];
320 static struct timeval tv_ref
;
321 struct timeval tv_result
;
325 switch (ndo
->ndo_tflag
) {
327 case 0: /* Default */
328 s
= (tvp
->tv_sec
+ thiszone
) % 86400;
329 ND_PRINT((ndo
, "%s ", ts_format(ndo
, s
, tvp
->tv_usec
, buf
)));
332 case 1: /* No time stamp */
335 case 2: /* Unix timeval style */
336 ND_PRINT((ndo
, "%s ", ts_unix_format(ndo
,
337 tvp
->tv_sec
, tvp
->tv_usec
, buf
)));
340 case 3: /* Microseconds/nanoseconds since previous packet */
341 case 5: /* Microseconds/nanoseconds since first packet */
342 #ifdef HAVE_PCAP_SET_TSTAMP_PRECISION
343 switch (ndo
->ndo_tstamp_precision
) {
344 case PCAP_TSTAMP_PRECISION_MICRO
:
347 case PCAP_TSTAMP_PRECISION_NANO
:
357 if (!(netdissect_timevalisset(&tv_ref
)))
358 tv_ref
= *tvp
; /* set timestamp for first packet */
360 negative_offset
= netdissect_timevalcmp(tvp
, &tv_ref
, <);
362 netdissect_timevalsub(&tv_ref
, tvp
, &tv_result
, nano_prec
);
364 netdissect_timevalsub(tvp
, &tv_ref
, &tv_result
, nano_prec
);
366 ND_PRINT((ndo
, (negative_offset
? "-" : " ")));
368 ND_PRINT((ndo
, "%s ", ts_format(ndo
,
369 tv_result
.tv_sec
, tv_result
.tv_usec
, buf
)));
371 if (ndo
->ndo_tflag
== 3)
372 tv_ref
= *tvp
; /* set timestamp for previous packet */
375 case 4: /* Default + Date */
376 s
= (tvp
->tv_sec
+ thiszone
) % 86400;
377 Time
= (tvp
->tv_sec
+ thiszone
) - s
;
380 ND_PRINT((ndo
, "Date fail "));
382 ND_PRINT((ndo
, "%04d-%02d-%02d %s ",
383 tm
->tm_year
+1900, tm
->tm_mon
+1, tm
->tm_mday
,
384 ts_format(ndo
, s
, tvp
->tv_usec
, buf
)));
390 * Print an unsigned relative number of seconds (e.g. hold time, prune timer)
391 * in the form 5m1s. This does no truncation, so 32230861 seconds
392 * is represented as 1y1w1d1h1m1s.
395 unsigned_relts_print(netdissect_options
*ndo
,
398 static const char *lengths
[] = {"y", "w", "d", "h", "m", "s"};
399 static const u_int seconds
[] = {31536000, 604800, 86400, 3600, 60, 1};
400 const char **l
= lengths
;
401 const u_int
*s
= seconds
;
404 ND_PRINT((ndo
, "0s"));
409 ND_PRINT((ndo
, "%d%s", secs
/ *s
, *l
));
410 secs
-= (secs
/ *s
) * *s
;
418 * Print a signed relative number of seconds (e.g. hold time, prune timer)
419 * in the form 5m1s. This does no truncation, so 32230861 seconds
420 * is represented as 1y1w1d1h1m1s.
423 signed_relts_print(netdissect_options
*ndo
,
427 ND_PRINT((ndo
, "-"));
428 if (secs
== INT32_MIN
) {
430 * -2^31; you can't fit its absolute value into
431 * a 32-bit signed integer.
433 * Just directly pass said absolute value to
434 * unsigned_relts_print() directly.
436 * (XXX - does ISO C guarantee that -(-2^n),
437 * when calculated and cast to an n-bit unsigned
438 * integer type, will have the value 2^n?)
440 unsigned_relts_print(ndo
, 2147483648U);
443 * We now know -secs will fit into an int32_t;
444 * negate it and pass that to unsigned_relts_print().
446 unsigned_relts_print(ndo
, -secs
);
450 unsigned_relts_print(ndo
, secs
);
454 * this is a generic routine for printing unknown data;
455 * we pass on the linefeed plus indentation string to
456 * get a proper output - returns 0 on error
460 print_unknown_data(netdissect_options
*ndo
, const u_char
*cp
,const char *ident
,int len
)
463 ND_PRINT((ndo
,"%sDissector error: print_unknown_data called with negative length",
467 if (ndo
->ndo_snapend
- cp
< len
)
468 len
= ndo
->ndo_snapend
- cp
;
470 ND_PRINT((ndo
,"%sDissector error: print_unknown_data called with pointer past end of packet",
474 hex_print(ndo
, ident
,cp
,len
);
475 return(1); /* everything is ok */
479 * Convert a token value to a string; use "fmt" if not found.
482 tok2strbuf(register const struct tok
*lp
, register const char *fmt
,
483 register u_int v
, char *buf
, size_t bufsize
)
486 while (lp
->s
!= NULL
) {
495 (void)snprintf(buf
, bufsize
, fmt
, v
);
496 return (const char *)buf
;
500 * Convert a token value to a string; use "fmt" if not found.
503 tok2str(register const struct tok
*lp
, register const char *fmt
,
506 static char buf
[4][TOKBUFSIZE
];
512 return tok2strbuf(lp
, fmt
, v
, ret
, sizeof(buf
[0]));
516 * Convert a bit token value to a string; use "fmt" if not found.
517 * this is useful for parsing bitfields, the output strings are seperated
518 * if the s field is positive.
521 bittok2str_internal(register const struct tok
*lp
, register const char *fmt
,
522 register u_int v
, const char *sep
)
524 static char buf
[256]; /* our stringbuffer */
526 register u_int rotbit
; /* this is the bit we rotate through all bitpositions */
527 register u_int tokval
;
528 const char * sepstr
= "";
530 while (lp
!= NULL
&& lp
->s
!= NULL
) {
531 tokval
=lp
->v
; /* load our first value */
533 while (rotbit
!= 0) {
535 * lets AND the rotating bit with our token value
536 * and see if we have got a match
538 if (tokval
== (v
&rotbit
)) {
539 /* ok we have found something */
540 buflen
+=snprintf(buf
+buflen
, sizeof(buf
)-buflen
, "%s%s",
545 rotbit
=rotbit
<<1; /* no match - lets shift and try again */
551 /* bummer - lets print the "unknown" message as advised in the fmt string if we got one */
552 (void)snprintf(buf
, sizeof(buf
), fmt
== NULL
? "#%08x" : fmt
, v
);
557 * Convert a bit token value to a string; use "fmt" if not found.
558 * this is useful for parsing bitfields, the output strings are not seperated.
561 bittok2str_nosep(register const struct tok
*lp
, register const char *fmt
,
564 return (bittok2str_internal(lp
, fmt
, v
, ""));
568 * Convert a bit token value to a string; use "fmt" if not found.
569 * this is useful for parsing bitfields, the output strings are comma seperated.
572 bittok2str(register const struct tok
*lp
, register const char *fmt
,
575 return (bittok2str_internal(lp
, fmt
, v
, ", "));
579 * Convert a value to a string using an array; the macro
580 * tok2strary() in <netdissect.h> is the public interface to
581 * this function and ensures that the second argument is
582 * correct for bounds-checking.
585 tok2strary_internal(register const char **lp
, int n
, register const char *fmt
,
588 static char buf
[TOKBUFSIZE
];
590 if (v
>= 0 && v
< n
&& lp
[v
] != NULL
)
594 (void)snprintf(buf
, sizeof(buf
), fmt
, v
);
599 * Convert a 32-bit netmask to prefixlen if possible
600 * the function returns the prefix-len; if plen == -1
601 * then conversion was not possible;
605 mask2plen(uint32_t mask
)
607 uint32_t bitmasks
[33] = {
609 0x80000000, 0xc0000000, 0xe0000000, 0xf0000000,
610 0xf8000000, 0xfc000000, 0xfe000000, 0xff000000,
611 0xff800000, 0xffc00000, 0xffe00000, 0xfff00000,
612 0xfff80000, 0xfffc0000, 0xfffe0000, 0xffff0000,
613 0xffff8000, 0xffffc000, 0xffffe000, 0xfffff000,
614 0xfffff800, 0xfffffc00, 0xfffffe00, 0xffffff00,
615 0xffffff80, 0xffffffc0, 0xffffffe0, 0xfffffff0,
616 0xfffffff8, 0xfffffffc, 0xfffffffe, 0xffffffff
620 /* let's see if we can transform the mask into a prefixlen */
621 while (prefix_len
>= 0) {
622 if (bitmasks
[prefix_len
] == mask
)
630 mask62plen(const u_char
*mask
)
632 u_char bitmasks
[9] = {
634 0x80, 0xc0, 0xe0, 0xf0,
635 0xf8, 0xfc, 0xfe, 0xff
640 for (byte
= 0; byte
< 16; byte
++) {
643 for (bits
= 0; bits
< (sizeof (bitmasks
) / sizeof (bitmasks
[0])); bits
++) {
644 if (mask
[byte
] == bitmasks
[bits
]) {
650 if (mask
[byte
] != 0xff)
657 * Routine to print out information for text-based protocols such as FTP,
658 * HTTP, SMTP, RTSP, SIP, ....
660 #define MAX_TOKEN 128
663 * Fetch a token from a packet, starting at the specified index,
664 * and return the length of the token.
666 * Returns 0 on error; yes, this is indistinguishable from an empty
667 * token, but an "empty token" isn't a valid token - it just means
668 * either a space character at the beginning of the line (this
669 * includes a blank line) or no more tokens remaining on the line.
672 fetch_token(netdissect_options
*ndo
, const u_char
*pptr
, u_int idx
, u_int len
,
673 u_char
*tbuf
, size_t tbuflen
)
677 for (; idx
< len
; idx
++) {
678 if (!ND_TTEST(*(pptr
+ idx
))) {
679 /* ran past end of captured data */
682 if (!isascii(*(pptr
+ idx
))) {
683 /* not an ASCII character */
686 if (isspace(*(pptr
+ idx
))) {
690 if (!isprint(*(pptr
+ idx
))) {
691 /* not part of a command token or response code */
694 if (toklen
+ 2 > tbuflen
) {
695 /* no room for this character and terminating '\0' */
698 tbuf
[toklen
] = *(pptr
+ idx
);
708 * Skip past any white space after the token, until we see
709 * an end-of-line (CR or LF).
711 for (; idx
< len
; idx
++) {
712 if (!ND_TTEST(*(pptr
+ idx
))) {
713 /* ran past end of captured data */
716 if (*(pptr
+ idx
) == '\r' || *(pptr
+ idx
) == '\n') {
720 if (!isascii(*(pptr
+ idx
)) || !isprint(*(pptr
+ idx
))) {
721 /* not a printable ASCII character */
724 if (!isspace(*(pptr
+ idx
))) {
725 /* beginning of next token */
733 * Scan a buffer looking for a line ending - LF or CR-LF.
734 * Return the index of the character after the line ending or 0 if
735 * we encounter a non-ASCII or non-printable character or don't find
739 print_txt_line(netdissect_options
*ndo
, const char *protoname
,
740 const char *prefix
, const u_char
*pptr
, u_int idx
, u_int len
)
747 ND_TCHECK(*(pptr
+idx
));
748 if (*(pptr
+idx
) == '\n') {
750 * LF without CR; end of line.
751 * Skip the LF and print the line, with the
752 * exception of the LF.
754 linelen
= idx
- startidx
;
757 } else if (*(pptr
+idx
) == '\r') {
759 if ((idx
+1) >= len
) {
760 /* not in this packet */
763 ND_TCHECK(*(pptr
+idx
+1));
764 if (*(pptr
+idx
+1) == '\n') {
766 * CR-LF; end of line.
767 * Skip the CR-LF and print the line, with
768 * the exception of the CR-LF.
770 linelen
= idx
- startidx
;
776 * CR followed by something else; treat this
777 * as if it were binary data, and don't print
781 } else if (!isascii(*(pptr
+idx
)) ||
782 (!isprint(*(pptr
+idx
)) && *(pptr
+idx
) != '\t')) {
784 * Not a printable ASCII character and not a tab;
785 * treat this as if it were binary data, and
794 * All printable ASCII, but no line ending after that point
795 * in the buffer; treat this as if it were truncated.
798 linelen
= idx
- startidx
;
799 ND_PRINT((ndo
, "%s%.*s[!%s]", prefix
, (int)linelen
, pptr
+ startidx
,
804 ND_PRINT((ndo
, "%s%.*s", prefix
, (int)linelen
, pptr
+ startidx
));
809 txtproto_print(netdissect_options
*ndo
, const u_char
*pptr
, u_int len
,
810 const char *protoname
, const char **cmds
, u_int flags
)
813 u_char token
[MAX_TOKEN
+1];
820 * This protocol has more than just request and
821 * response lines; see whether this looks like a
822 * request or response.
824 idx
= fetch_token(ndo
, pptr
, 0, len
, token
, sizeof(token
));
826 /* Is this a valid request name? */
827 while ((cmd
= *cmds
++) != NULL
) {
828 if (ascii_strcasecmp((const char *)token
, cmd
) == 0) {
836 * No - is this a valid response code (3 digits)?
838 * Is this token the response code, or is the next
839 * token the response code?
841 if (flags
& RESP_CODE_SECOND_TOKEN
) {
843 * Next token - get it.
845 idx
= fetch_token(ndo
, pptr
, idx
, len
, token
,
849 if (isdigit(token
[0]) && isdigit(token
[1]) &&
850 isdigit(token
[2]) && token
[3] == '\0') {
858 * This protocol has only request and response lines
859 * (e.g., FTP, where all the data goes over a
860 * different connection); assume the payload is
861 * a request or response.
866 /* Capitalize the protocol name */
867 for (pnp
= protoname
; *pnp
!= '\0'; pnp
++)
868 ND_PRINT((ndo
, "%c", toupper((u_char
)*pnp
)));
872 * In non-verbose mode, just print the protocol, followed
873 * by the first line as the request or response info.
875 * In verbose mode, print lines as text until we run out
876 * of characters or see something that's not a
877 * printable-ASCII line.
879 if (ndo
->ndo_vflag
) {
881 * We're going to print all the text lines in the
882 * request or response; just print the length
883 * on the first line of the output.
885 ND_PRINT((ndo
, ", length: %u", len
));
887 idx
< len
&& (eol
= print_txt_line(ndo
, protoname
, "\n\t", pptr
, idx
, len
)) != 0;
892 * Just print the first text line.
894 print_txt_line(ndo
, protoname
, ": ", pptr
, 0, len
);
900 safeputs(netdissect_options
*ndo
,
901 const u_char
*s
, const u_int maxlen
)
905 while (*s
&& idx
< maxlen
) {
906 safeputchar(ndo
, *s
);
913 safeputchar(netdissect_options
*ndo
,
916 ND_PRINT((ndo
, (c
< 0x80 && ND_ISPRINT(c
)) ? "%c" : "\\0x%02x", c
));
921 * Some compilers try to optimize memcpy(), using the alignment constraint
922 * on the argument pointer type. by using this function, we try to avoid the
926 unaligned_memcpy(void *p
, const void *q
, size_t l
)
931 /* As with memcpy(), so with memcmp(). */
933 unaligned_memcmp(const void *p
, const void *q
, size_t l
)
935 return (memcmp(p
, q
, l
));