]> The Tcpdump Group git mirrors - tcpdump/blob - netdissect.h
add a maxlen boundary check to safeputs, print unprintable chars as hex in safeputchar
[tcpdump] / netdissect.h
1 /*
2 * Copyright (c) 1988-1997
3 * The Regents of the University of California. All rights reserved.
4 *
5 * Copyright (c) 1998-2004 Michael Richardson <mcr@tcpdump.org>
6 * The TCPDUMP project
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that: (1) source code distributions
10 * retain the above copyright notice and this paragraph in its entirety, (2)
11 * distributions including binary code include the above copyright notice and
12 * this paragraph in its entirety in the documentation or other materials
13 * provided with the distribution, and (3) all advertising materials mentioning
14 * features or use of this software display the following acknowledgement:
15 * ``This product includes software developed by the University of California,
16 * Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
17 * the University nor the names of its contributors may be used to endorse
18 * or promote products derived from this software without specific prior
19 * written permission.
20 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
21 * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
22 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
23 *
24 * @(#) $Header: /tcpdump/master/tcpdump/netdissect.h,v 1.21 2006-02-08 01:38:17 hannes Exp $ (LBL)
25 */
26
27 #ifndef netdissect_h
28 #define netdissect_h
29
30 #ifdef HAVE_OS_PROTO_H
31 #include "os-proto.h"
32 #endif
33 #include <sys/types.h>
34
35 #ifndef HAVE___ATTRIBUTE__
36 #define __attribute__(x)
37 #endif
38
39 /* snprintf et al */
40
41 #include <stdarg.h>
42
43 #if !defined(HAVE_SNPRINTF)
44 int snprintf (char *str, size_t sz, const char *format, ...)
45 __attribute__ ((format (printf, 3, 4)));
46 #endif
47
48 #if !defined(HAVE_VSNPRINTF)
49 int vsnprintf (char *str, size_t sz, const char *format, va_list ap)
50 __attribute__((format (printf, 3, 0)));
51 #endif
52
53 #ifndef HAVE_STRLCAT
54 extern size_t strlcat (char *, const char *, size_t);
55 #endif
56 #ifndef HAVE_STRLCPY
57 extern size_t strlcpy (char *, const char *, size_t);
58 #endif
59
60 #ifndef HAVE_STRDUP
61 extern char *strdup (const char *str);
62 #endif
63
64 #ifndef HAVE_STRSEP
65 extern char *strsep(char **, const char *);
66 #endif
67
68 struct tok {
69 int v; /* value */
70 const char *s; /* string */
71 };
72
73 #define TOKBUFSIZE 128
74 extern const char *tok2strbuf(const struct tok *, const char *, int,
75 char *buf, size_t bufsize);
76
77 /* tok2str is deprecated */
78 extern const char *tok2str(const struct tok *, const char *, int);
79 extern char *bittok2str(const struct tok *, const char *, int);
80
81
82 typedef struct netdissect_options netdissect_options;
83
84 struct netdissect_options {
85 int ndo_aflag; /* translate network and broadcast addresses */
86 int ndo_eflag; /* print ethernet header */
87 int ndo_fflag; /* don't translate "foreign" IP address */
88 int ndo_nflag; /* leave addresses as numbers */
89 int ndo_Nflag; /* remove domains from printed host names */
90 int ndo_qflag; /* quick (shorter) output */
91 int ndo_Rflag; /* print sequence # field in AH/ESP*/
92 int ndo_sflag; /* use the libsmi to translate OIDs */
93 int ndo_Sflag; /* print raw TCP sequence numbers */
94 int ndo_tflag; /* print packet arrival time */
95 int ndo_Uflag; /* "unbuffered" output of dump files */
96 int ndo_uflag; /* Print undecoded NFS handles */
97 int ndo_vflag; /* verbose */
98 int ndo_xflag; /* print packet in hex */
99 int ndo_Xflag; /* print packet in hex/ascii */
100 int ndo_Aflag; /* print packet only in ascii observing TAB,
101 * LF, CR and SPACE as graphical chars
102 */
103 int ndo_Oflag; /* run filter code optimizer */
104 int ndo_dlt; /* if != -1, ask libpcap for the DLT it names*/
105 int ndo_pflag; /* don't go promiscuous */
106
107 int ndo_Cflag; /* rotate dump files after this many bytes */
108 int ndo_Cflag_count; /* Keep track of which file number we're writing */
109 int ndo_Gflag; /* rotate dump files after this many seconds */
110 int ndo_Gflag_count; /* number of files created with Gflag rotation */
111 time_t ndo_Gflag_time; /* The last time_t the dump file was rotated. */
112 int ndo_Wflag; /* recycle output files after this number of files */
113 int ndo_WflagChars;
114 int ndo_suppress_default_print; /* don't use default_print() for unknown packet types */
115 const char *ndo_dltname;
116
117 char *ndo_espsecret;
118 struct sa_list *ndo_sa_list_head; /* used by print-esp.c */
119 struct sa_list *ndo_sa_default;
120
121 char *ndo_tcpmd5secret; /* TCP-MD5 secret key */
122
123 struct esp_algorithm *ndo_espsecret_xform; /* cache of decoded */
124 char *ndo_espsecret_key;
125
126 int ndo_packettype; /* as specified by -T */
127
128 char *ndo_program_name; /*used to generate self-identifying messages */
129
130 int32_t ndo_thiszone; /* seconds offset from gmt to local time */
131
132 int ndo_snaplen;
133
134 /*global pointers to beginning and end of current packet (during printing) */
135 const u_char *ndo_packetp;
136 const u_char *ndo_snapend;
137
138 /* bookkeeping for ^T output */
139 int ndo_infodelay;
140
141 /* pointer to void function to output stuff */
142 void (*ndo_default_print)(netdissect_options *,
143 register const u_char *bp, register u_int length);
144 void (*ndo_info)(netdissect_options *, int verbose);
145
146 int (*ndo_printf)(netdissect_options *,
147 const char *fmt, ...);
148 void (*ndo_error)(netdissect_options *,
149 const char *fmt, ...);
150 void (*ndo_warning)(netdissect_options *,
151 const char *fmt, ...);
152 };
153
154 #define PT_VAT 1 /* Visual Audio Tool */
155 #define PT_WB 2 /* distributed White Board */
156 #define PT_RPC 3 /* Remote Procedure Call */
157 #define PT_RTP 4 /* Real-Time Applications protocol */
158 #define PT_RTCP 5 /* Real-Time Applications control protocol */
159 #define PT_SNMP 6 /* Simple Network Management Protocol */
160 #define PT_CNFP 7 /* Cisco NetFlow protocol */
161
162 #ifndef min
163 #define min(a,b) ((a)>(b)?(b):(a))
164 #endif
165 #ifndef max
166 #define max(a,b) ((b)>(a)?(b):(a))
167 #endif
168
169 #ifndef INET6
170 /*
171 * The default snapshot length. This value allows most printers to print
172 * useful information while keeping the amount of unwanted data down.
173 * In particular, it allows for an ethernet header, tcp/ip header, and
174 * 14 bytes of data (assuming no ip options).
175 */
176 #define DEFAULT_SNAPLEN 68
177 #else
178 #define DEFAULT_SNAPLEN 96
179 #endif
180
181 #ifndef BIG_ENDIAN
182 #define BIG_ENDIAN 4321
183 #define LITTLE_ENDIAN 1234
184 #endif
185
186 #define ESRC(ep) ((ep)->ether_shost)
187 #define EDST(ep) ((ep)->ether_dhost)
188
189 #ifndef NTOHL
190 #define NTOHL(x) (x) = ntohl(x)
191 #define NTOHS(x) (x) = ntohs(x)
192 #define HTONL(x) (x) = htonl(x)
193 #define HTONS(x) (x) = htons(x)
194 #endif
195
196 /*
197 * True if "l" bytes of "var" were captured.
198 *
199 * The "ndo->ndo_snapend - (l) <= ndo->ndo_snapend" checks to make sure
200 * "l" isn't so large that "ndo->ndo_snapend - (l)" underflows.
201 *
202 * The check is for <= rather than < because "l" might be 0.
203 */
204 #define ND_TTEST2(var, l) (ndo->ndo_snapend - (l) <= ndo->ndo_snapend && \
205 (const u_char *)&(var) <= ndo->ndo_snapend - (l))
206
207 /* True if "var" was captured */
208 #define ND_TTEST(var) ND_TTEST2(var, sizeof(var))
209
210 /* Bail if "l" bytes of "var" were not captured */
211 #define ND_TCHECK2(var, l) if (!ND_TTEST2(var, l)) goto trunc
212
213 /* Bail if "var" was not captured */
214 #define ND_TCHECK(var) ND_TCHECK2(var, sizeof(var))
215
216 #define ND_PRINT(STUFF) (*ndo->ndo_printf)STUFF
217 #define ND_DEFAULTPRINT(ap, length) (*ndo->ndo_default_print)(ndo, ap, length)
218
219 #if 0
220 extern void ts_print(netdissect_options *ipdo,
221 const struct timeval *);
222 extern void relts_print(int);
223 #endif
224
225 extern int fn_print(const u_char *, const u_char *);
226 extern int fn_printn(const u_char *, u_int, const u_char *);
227 extern const char *tok2str(const struct tok *, const char *, int);
228
229 extern void wrapup(int);
230
231 #if 0
232 extern char *read_infile(netdissect_options *, char *);
233 extern char *copy_argv(netdissect_options *, char **);
234 #endif
235
236 extern void safeputchar(int);
237 extern void safeputs(const char *, int);
238
239 #if 0
240 extern const char *isonsap_string(netdissect_options *, const u_char *);
241 extern const char *protoid_string(netdissect_options *, const u_char *);
242 extern const char *dnname_string(netdissect_options *, u_short);
243 extern const char *dnnum_string(netdissect_options *, u_short);
244 #endif
245
246 /* The printer routines. */
247
248 #include <pcap.h>
249
250
251 extern void eap_print(netdissect_options *,const u_char *, u_int);
252 extern int esp_print(netdissect_options *,
253 register const u_char *bp, int len, register const u_char *bp2,
254 int *nhdr, int *padlen);
255 extern void arp_print(netdissect_options *,const u_char *, u_int, u_int);
256 extern void isakmp_print(netdissect_options *,const u_char *,
257 u_int, const u_char *);
258 extern void isakmp_rfc3948_print(netdissect_options *,const u_char *,
259 u_int, const u_char *);
260 extern void ip_print(netdissect_options *,const u_char *, u_int);
261 extern void ip_print_inner(netdissect_options *ndo,
262 const u_char *bp, u_int length, u_int nh,
263 const u_char *bp2);
264
265 /* stuff that has not yet been rototiled */
266 #if 0
267 extern void ascii_print(netdissect_options *,u_int);
268 extern void hex_and_ascii_print_with_offset(netdissect_options *,const char *,
269 u_int, u_int);
270 extern void hex_and_ascii_print(netdissect_options *,const char *, u_int);
271 extern void hex_print_with_offset(netdissect_options *,const char *,
272 u_int, u_int);
273 extern void hex_print(netdissect_options *,const char *, u_int);
274 extern void telnet_print(netdissect_options *,const u_char *, u_int);
275 extern int ether_encap_print(netdissect_options *,u_short, const u_char *,
276 u_int, u_int, u_short *);
277 extern int llc_print(netdissect_options *,
278 const u_char *, u_int, u_int, const u_char *,
279 const u_char *, u_short *);
280 extern void aarp_print(netdissect_options *,const u_char *, u_int);
281 extern void atalk_print(netdissect_options *,const u_char *, u_int);
282 extern void atm_if_print(u_char *,const struct pcap_pkthdr *, const u_char *);
283 extern void bootp_print(netdissect_options *,const u_char *,
284 u_int, u_short, u_short);
285 extern void bgp_print(netdissect_options *,const u_char *, int);
286 extern void bxxp_print(netdissect_options *,const u_char *, u_int);
287 extern void chdlc_if_print(u_char *user, const struct pcap_pkthdr *h,
288 register const u_char *p);
289 extern void chdlc_print(netdissect_options *ndo,
290 register const u_char *p, u_int length, u_int caplen);
291 extern void cisco_autorp_print(netdissect_options *,
292 const u_char *, u_int);
293 extern void cnfp_print(netdissect_options *,const u_char *cp,
294 u_int len, const u_char *bp);
295 extern void decnet_print(netdissect_options *,const u_char *,
296 u_int, u_int);
297 extern void default_print(netdissect_options *,const u_char *, u_int);
298 extern void dvmrp_print(netdissect_options *,const u_char *, u_int);
299 extern void egp_print(netdissect_options *,const u_char *, u_int,
300 const u_char *);
301
302 extern void arcnet_if_print(u_char*,const struct pcap_pkthdr *,const u_char *);
303 extern void ether_if_print(u_char *,const struct pcap_pkthdr *,const u_char *);
304 extern void token_if_print(u_char *,const struct pcap_pkthdr *,const u_char *);
305 extern void fddi_if_print(u_char *,const struct pcap_pkthdr *, const u_char *);
306
307 extern void gre_print(netdissect_options *,const u_char *, u_int);
308 extern void icmp_print(netdissect_options *,const u_char *, u_int,
309 const u_char *);
310 extern void hsrp_print(netdissect_options *ndo,
311 register const u_char *bp, register u_int len);
312 extern void ieee802_11_if_print(u_char *,const struct pcap_pkthdr *, const u_char *);
313 extern void igmp_print(netdissect_options *,
314 register const u_char *, u_int);
315 extern void igrp_print(netdissect_options *,const u_char *, u_int,
316 const u_char *);
317 extern void ipN_print(netdissect_options *,const u_char *, u_int);
318 extern void ipx_print(netdissect_options *,const u_char *, u_int);
319 extern void isoclns_print(netdissect_options *,const u_char *,
320 u_int, u_int, const u_char *, const u_char *);
321 extern void krb_print(netdissect_options *,const u_char *, u_int);
322 extern void llap_print(netdissect_options *,const u_char *, u_int);
323 extern const char *linkaddr_string(netdissect_options *ndo,
324 const u_char *ep, const unsigned int len);
325 extern void ltalk_if_print(netdissect_options *ndo,
326 u_char *user, const struct pcap_pkthdr *h,
327 const u_char *p);
328 extern void mpls_print(netdissect_options *ndo,
329 const u_char *bp, u_int length);
330 extern void msdp_print(netdissect_options *ndo,
331 const unsigned char *sp, u_int length);
332 extern void nfsreply_print(netdissect_options *,const u_char *,
333 u_int, const u_char *);
334 extern void nfsreq_print(netdissect_options *,const u_char *,
335 u_int, const u_char *);
336 extern void ns_print(netdissect_options *,const u_char *, u_int);
337 extern void ntp_print(netdissect_options *,const u_char *, u_int);
338 extern void null_if_print(u_char *,const struct pcap_pkthdr *, const u_char *);
339 extern void ospf_print(netdissect_options *,const u_char *,
340 u_int, const u_char *);
341 extern void pimv1_print(netdissect_options *,const u_char *, u_int);
342 extern void mobile_print(netdissect_options *,const u_char *, u_int);
343 extern void pim_print(netdissect_options *,const u_char *, u_int);
344 extern void pppoe_if_print(u_char *,const struct pcap_pkthdr *, const u_char *);
345 extern void pppoe_print(netdissect_options *,const u_char *, u_int);
346 extern void ppp_print(netdissect_options *,
347 register const u_char *, u_int);
348
349 extern void ppp_if_print(u_char *,const struct pcap_pkthdr *, const u_char *);
350 extern void ppp_hdlc_if_print(u_char *,
351 const struct pcap_pkthdr *, const u_char *);
352 extern void ppp_bsdos_if_print(u_char *,
353 const struct pcap_pkthdr *, const u_char *);
354
355 extern int vjc_print(netdissect_options *,register const char *,
356 register u_int, u_short);
357
358 extern void raw_if_print(u_char *,
359 const struct pcap_pkthdr *, const u_char *);
360
361 extern void rip_print(netdissect_options *,const u_char *, u_int);
362
363 extern void sctp_print(netdissect_options *ndo,
364 const u_char *bp, const u_char *bp2,
365 u_int sctpPacketLength);
366
367 extern void sl_if_print(u_char *,const struct pcap_pkthdr *, const u_char *);
368
369 extern void lane_if_print(u_char *,const struct pcap_pkthdr *,const u_char *);
370 extern void cip_if_print(u_char *,const struct pcap_pkthdr *,const u_char *);
371 extern void sl_bsdos_if_print(u_char *,
372 const struct pcap_pkthdr *, const u_char *);
373 extern void sll_if_print(u_char *,
374 const struct pcap_pkthdr *, const u_char *);
375
376 extern void snmp_print(netdissect_options *,const u_char *, u_int);
377 extern void sunrpcrequest_print(netdissect_options *,const u_char *,
378 u_int, const u_char *);
379 extern void tcp_print(netdissect_options *,const u_char *, u_int,
380 const u_char *, int);
381 extern void tftp_print(netdissect_options *,const u_char *, u_int);
382 extern void timed_print(netdissect_options *,const u_char *, u_int);
383 extern void udp_print(netdissect_options *,const u_char *, u_int,
384 const u_char *, int);
385 extern void wb_print(netdissect_options *,const void *, u_int);
386 extern int ah_print(netdissect_options *,register const u_char *,
387 register const u_char *);
388 extern void esp_print_decodesecret(netdissect_options *ndo);
389 extern int ipcomp_print(netdissect_options *,register const u_char *,
390 register const u_char *, int *);
391 extern void rx_print(netdissect_options *,register const u_char *,
392 int, int, int, u_char *);
393 extern void netbeui_print(netdissect_options *,u_short,
394 const u_char *, int);
395 extern void ipx_netbios_print(netdissect_options *,const u_char *, u_int);
396 extern void nbt_tcp_print(netdissect_options *,const u_char *, int);
397 extern void nbt_udp137_print(netdissect_options *,
398 const u_char *data, int);
399 extern void nbt_udp138_print(netdissect_options *,
400 const u_char *data, int);
401 extern char *smb_errstr(netdissect_options *,int, int);
402 extern const char *nt_errstr(netdissect_options *, u_int32_t);
403 extern void print_data(netdissect_options *,const unsigned char *, int);
404 extern void l2tp_print(netdissect_options *,const u_char *, u_int);
405 extern void lcp_print(netdissect_options *,const u_char *, u_int);
406 extern void vrrp_print(netdissect_options *,const u_char *bp,
407 u_int len, int ttl);
408 extern void cdp_print(netdissect_options *,const u_char *,
409 u_int, u_int, const u_char *, const u_char *);
410 extern void stp_print(netdissect_options *,const u_char *p, u_int length);
411 extern void radius_print(netdissect_options *,const u_char *, u_int);
412 extern void lwres_print(netdissect_options *,const u_char *, u_int);
413 extern void pptp_print(netdissect_options *,const u_char *, u_int);
414
415 #ifdef INET6
416 extern void ip6_print(netdissect_options *,const u_char *, u_int);
417 extern void ip6_opt_print(netdissect_options *,const u_char *, int);
418 extern int hbhopt_print(netdissect_options *,const u_char *);
419 extern int dstopt_print(netdissect_options *,const u_char *);
420 extern int frag6_print(netdissect_options *,const u_char *,
421 const u_char *);
422 extern void icmp6_print(netdissect_options *,const u_char *,
423 const u_char *);
424 extern void ripng_print(netdissect_options *,const u_char *, int);
425 extern int rt6_print(netdissect_options *,const u_char *, const u_char *);
426 extern void ospf6_print(netdissect_options *,const u_char *, u_int);
427 extern void dhcp6_print(netdissect_options *,const u_char *,
428 u_int, u_int16_t, u_int16_t);
429
430 extern void zephyr_print(netdissect_options * ndo,
431 const u_char *cp, int length);
432
433 #endif /*INET6*/
434 extern u_short in_cksum(const u_short *,
435 register u_int, int);
436
437 #endif
438
439 #endif /* netdissect_h */