2 * Copyright (c) 1990, 1991, 1992, 1993, 1994, 1995, 1996
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 * Modifications made to accommodate the new SunOS4.0 NIT facility by
22 * Micky Liu, micky@cunixc.cc.columbia.edu, Columbia University in May, 1989.
23 * This module now handles the STREAMS based NIT.
30 #include <sys/types.h>
32 #include <sys/timeb.h>
34 #include <sys/fcntlcom.h>
36 #include <sys/ioctl.h>
37 #include <sys/socket.h>
38 #include <sys/stropts.h>
42 #include <net/nit_if.h>
43 #include <net/nit_pf.h>
44 #include <net/nit_buf.h>
46 #include <netinet/in.h>
47 #include <netinet/in_systm.h>
48 #include <netinet/ip.h>
49 #include <netinet/if_ether.h>
50 #include <netinet/ip_var.h>
51 #include <netinet/udp.h>
52 #include <netinet/udp_var.h>
53 #include <netinet/tcp.h>
54 #include <netinet/tcpip.h>
63 #ifdef HAVE_OS_PROTO_H
68 * The chunk size for NIT. This is the amount of buffering
69 * done for read calls.
71 #define CHUNKSIZE (2*1024)
74 * The total buffer space used by NIT.
76 #define BUFSPACE (4*CHUNKSIZE)
79 static int nit_setflags(int, int, int, char *);
82 * Private data for capturing on STREAMS NIT devices.
85 struct pcap_stat stat;
89 pcap_stats_snit(pcap_t *p, struct pcap_stat *ps)
91 struct pcap_snit *psn = p->priv;
94 * "ps_recv" counts packets handed to the filter, not packets
95 * that passed the filter. As filtering is done in userland,
96 * this does not include packets dropped because we ran out
99 * "ps_drop" counts packets dropped inside the "/dev/nit"
100 * device because of flow control requirements or resource
101 * exhaustion; it doesn't count packets dropped by the
102 * interface driver, or packets dropped upstream. As filtering
103 * is done in userland, it counts packets regardless of whether
104 * they would've passed the filter.
106 * These statistics don't include packets not yet read from the
107 * kernel by libpcap or packets not yet read from libpcap by the
115 pcap_read_snit(pcap_t *p, int cnt, pcap_handler callback, u_char *user)
117 struct pcap_snit *psn = p->priv;
119 register u_char *bp, *cp, *ep;
120 register struct nit_bufhdr *hdrp;
121 register struct nit_iftime *ntp;
122 register struct nit_iflen *nlp;
123 register struct nit_ifdrops *ndp;
128 cc = read(p->fd, (char *)p->buffer, p->bufsize);
130 if (errno == EWOULDBLOCK)
132 pcap_fmt_errmsg_for_errno(p->errbuf, sizeof(p->errbuf),
136 bp = (u_char *)p->buffer;
141 * loop through each snapshot in the chunk
143 * This assumes that a single buffer of packets will have
144 * <= INT_MAX packets, so the packet count doesn't overflow.
150 * Has "pcap_breakloop()" been called?
151 * If so, return immediately - if we haven't read any
152 * packets, clear the flag and return -2 to indicate
153 * that we were told to break out of the loop, otherwise
154 * leave the flag set, so that the *next* call will break
155 * out of the loop without having read any packets, and
156 * return the number of packets we've processed so far.
172 /* get past NIT buffer */
173 hdrp = (struct nit_bufhdr *)cp;
176 /* get past NIT timer */
177 ntp = (struct nit_iftime *)cp;
180 ndp = (struct nit_ifdrops *)cp;
181 psn->stat.ps_drop = ndp->nh_drops;
184 /* get past packet len */
185 nlp = (struct nit_iflen *)cp;
189 bp += hdrp->nhb_totlen;
191 caplen = nlp->nh_pktlen;
192 if (caplen > p->snapshot)
193 caplen = p->snapshot;
195 if (pcap_filter(p->fcode.bf_insns, cp, nlp->nh_pktlen, caplen)) {
196 struct pcap_pkthdr h;
197 h.ts = ntp->nh_timestamp;
198 h.len = nlp->nh_pktlen;
200 (*callback)(user, &h, cp);
201 if (++n >= cnt && !PACKET_COUNT_IS_UNLIMITED(cnt)) {
213 pcap_inject_snit(pcap_t *p, const void *buf, int size)
215 struct strbuf ctl, data;
218 * XXX - can we just do
220 ret = write(pd->f, buf, size);
222 ctl.len = sizeof(*sa); /* XXX - what was this? */
223 ctl.buf = (char *)sa;
226 ret = putmsg(p->fd, &ctl, &data);
228 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
236 nit_setflags(pcap_t *p)
241 struct timeval timeout;
243 if (p->opt.immediate) {
245 * Set the chunk size to zero, so that chunks get sent
248 si.ic_cmd = NIOCSCHUNK;
249 si.ic_len = sizeof(zero);
250 si.ic_dp = (char *)&zero;
251 if (ioctl(p->fd, I_STR, (char *)&si) < 0) {
252 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
253 errno, "NIOCSCHUNK");
257 si.ic_timout = INFTIM;
258 if (p->opt.timeout != 0) {
259 timeout.tv_sec = p->opt.timeout / 1000;
260 timeout.tv_usec = (p->opt.timeout * 1000) % 1000000;
261 si.ic_cmd = NIOCSTIME;
262 si.ic_len = sizeof(timeout);
263 si.ic_dp = (char *)&timeout;
264 if (ioctl(p->fd, I_STR, (char *)&si) < 0) {
265 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
270 flags = NI_TIMESTAMP | NI_LEN | NI_DROPS;
273 si.ic_cmd = NIOCSFLAGS;
274 si.ic_len = sizeof(flags);
275 si.ic_dp = (char *)&flags;
276 if (ioctl(p->fd, I_STR, (char *)&si) < 0) {
277 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
278 errno, "NIOCSFLAGS");
285 pcap_activate_snit(pcap_t *p)
287 struct strioctl si; /* struct for ioctl() */
288 struct ifreq ifr; /* interface request struct */
289 int chunksize = CHUNKSIZE;
291 static const char dev[] = "/dev/nit";
296 * No monitor mode on SunOS 4.x (no Wi-Fi devices on
297 * hardware supported by SunOS 4.x).
299 return (PCAP_ERROR_RFMON_NOTSUP);
303 * Turn a negative snapshot value (invalid), a snapshot value of
304 * 0 (unspecified), or a value bigger than the normal maximum
305 * value, into the maximum allowed value.
307 * If some application really *needs* a bigger snapshot
308 * length, we should just increase MAXIMUM_SNAPLEN.
310 if (p->snapshot <= 0 || p->snapshot > MAXIMUM_SNAPLEN)
311 p->snapshot = MAXIMUM_SNAPLEN;
313 if (p->snapshot < 96)
315 * NIT requires a snapshot length of at least 96.
320 * Initially try a read/write open (to allow the inject
321 * method to work). If that fails due to permission
322 * issues, fall back to read-only. This allows a
323 * non-root user to be granted specific access to pcap
324 * capabilities via file permissions.
326 * XXX - we should have an API that has a flag that
327 * controls whether to open read-only or read-write,
328 * so that denial of permission to send (or inability
329 * to send, if sending packets isn't supported on
330 * the device in question) can be indicated at open
333 p->fd = fd = open(dev, O_RDWR);
334 if (fd < 0 && errno == EACCES)
335 p->fd = fd = open(dev, O_RDONLY);
337 if (errno == EACCES) {
338 err = PCAP_ERROR_PERM_DENIED;
339 snprintf(p->errbuf, PCAP_ERRBUF_SIZE,
340 "Attempt to open %s failed with EACCES - root privileges may be required",
344 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
350 /* arrange to get discrete messages from the STREAM and use NIT_BUF */
351 if (ioctl(fd, I_SRDOPT, (char *)RMSGD) < 0) {
352 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
357 if (ioctl(fd, I_PUSH, "nbuf") < 0) {
358 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
363 /* set the chunksize */
364 si.ic_cmd = NIOCSCHUNK;
365 si.ic_timout = INFTIM;
366 si.ic_len = sizeof(chunksize);
367 si.ic_dp = (char *)&chunksize;
368 if (ioctl(fd, I_STR, (char *)&si) < 0) {
369 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
370 errno, "NIOCSCHUNK");
375 /* request the interface */
376 strncpy(ifr.ifr_name, p->opt.device, sizeof(ifr.ifr_name));
377 ifr.ifr_name[sizeof(ifr.ifr_name) - 1] = '\0';
378 si.ic_cmd = NIOCBIND;
379 si.ic_len = sizeof(ifr);
380 si.ic_dp = (char *)𝔦
381 if (ioctl(fd, I_STR, (char *)&si) < 0) {
383 * XXX - is there an error that means "no such device"?
384 * Is there one that means "that device doesn't support
387 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
388 errno, "NIOCBIND: %s", ifr.ifr_name);
393 /* set the snapshot length */
394 si.ic_cmd = NIOCSSNAP;
395 si.ic_len = sizeof(p->snapshot);
396 si.ic_dp = (char *)&p->snapshot;
397 if (ioctl(fd, I_STR, (char *)&si) < 0) {
398 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
403 if (nit_setflags(p) < 0) {
408 (void)ioctl(fd, I_FLUSH, (char *)FLUSHR);
410 * NIT supports only ethernets.
412 p->linktype = DLT_EN10MB;
414 p->bufsize = BUFSPACE;
415 p->buffer = malloc(p->bufsize);
416 if (p->buffer == NULL) {
417 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
424 * "p->fd" is an FD for a STREAMS device, so "select()" and
425 * "poll()" should work on it.
427 p->selectable_fd = p->fd;
430 * This is (presumably) a real Ethernet capture; give it a
431 * link-layer-type list with DLT_EN10MB and DLT_DOCSIS, so
432 * that an application can let you choose it, in case you're
433 * capturing DOCSIS traffic that a Cisco Cable Modem
434 * Termination System is putting out onto an Ethernet (it
435 * doesn't put an Ethernet header onto the wire, it puts raw
436 * DOCSIS frames out on the wire inside the low-level
439 p->dlt_list = (u_int *) malloc(sizeof(u_int) * 2);
441 * If that fails, just leave the list empty.
443 if (p->dlt_list != NULL) {
444 p->dlt_list[0] = DLT_EN10MB;
445 p->dlt_list[1] = DLT_DOCSIS;
449 p->read_op = pcap_read_snit;
450 p->inject_op = pcap_inject_snit;
451 p->setfilter_op = install_bpf_program; /* no kernel filtering */
452 p->setdirection_op = NULL; /* Not implemented. */
453 p->set_datalink_op = NULL; /* can't change data link type */
454 p->getnonblock_op = pcap_getnonblock_fd;
455 p->setnonblock_op = pcap_setnonblock_fd;
456 p->stats_op = pcap_stats_snit;
460 pcap_cleanup_live_common(p);
465 pcap_create_interface(const char *device _U_, char *ebuf)
469 p = PCAP_CREATE_COMMON(ebuf, struct pcap_snit);
473 p->activate_op = pcap_activate_snit;
478 * XXX - there's probably a NIOCBIND error that means "that device
479 * doesn't support NIT"; if so, we should try an NIOCBIND and use that.
482 can_be_bound(const char *name _U_)
488 get_if_flags(const char *name _U_, bpf_u_int32 *flags _U_, char *errbuf _U_)
492 * XXX - is there a way to find out whether an adapter has
493 * something plugged into it?
499 pcap_platform_finddevs(pcap_if_list_t *devlistp, char *errbuf)
501 return (pcap_findalldevs_interfaces(devlistp, errbuf, can_be_bound,
506 * Libpcap version string.
509 pcap_lib_version(void)
511 return (PCAP_VERSION_STRING);