2 * Copyright (c) 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.
21 * This code contributed by Sagun Shakya (sagun.shakya@sun.com)
24 * Packet capture routines for DLPI using libdlpi under SunOS 5.11.
31 #include <sys/types.h>
33 #include <sys/bufmod.h>
34 #include <sys/stream.h>
47 static int dlpromiscon(pcap_t *, bpf_u_int32);
48 static int pcap_read_libdlpi(pcap_t *, int, pcap_handler, u_char *);
49 static int pcap_inject_libdlpi(pcap_t *, const void *, size_t);
50 static void pcap_libdlpi_err(const char *, const char *, int, char *);
51 static void pcap_cleanup_libdlpi(pcap_t *);
54 * list_interfaces() will list all the network links that are
55 * available on a system.
57 static boolean_t list_interfaces(const char *, void *);
59 typedef struct linknamelist {
60 char linkname[DLPI_LINKNAME_MAX];
61 struct linknamelist *lnl_next;
64 typedef struct linkwalk {
65 linknamelist_t *lw_list;
70 * The caller of this function should free the memory allocated
71 * for each linknamelist_t "entry" allocated.
74 list_interfaces(const char *linkname, void *arg)
76 linkwalk_t *lwp = arg;
77 linknamelist_t *entry;
79 if ((entry = calloc(1, sizeof(linknamelist_t))) == NULL) {
83 (void) pcap_strlcpy(entry->linkname, linkname, DLPI_LINKNAME_MAX);
85 if (lwp->lw_list == NULL) {
88 entry->lnl_next = lwp->lw_list;
96 pcap_activate_libdlpi(pcap_t *p)
98 struct pcap_dlpi *pd = p->priv;
105 * Enable Solaris raw and passive DLPI extensions;
106 * dlpi_open() will not fail if the underlying link does not support
107 * passive mode. See dlpi(7P) for details.
109 retv = dlpi_open(p->opt.device, &dh, DLPI_RAW|DLPI_PASSIVE);
110 if (retv != DLPI_SUCCESS) {
111 if (retv == DLPI_ELINKNAMEINVAL || retv == DLPI_ENOLINK)
112 status = PCAP_ERROR_NO_SUCH_DEVICE;
113 else if (retv == DL_SYSERR &&
114 (errno == EPERM || errno == EACCES))
115 status = PCAP_ERROR_PERM_DENIED;
118 pcap_libdlpi_err(p->opt.device, "dlpi_open", retv,
126 * This device exists, but we don't support monitor mode
127 * any platforms that support DLPI.
129 status = PCAP_ERROR_RFMON_NOTSUP;
133 /* Bind with DLPI_ANY_SAP. */
134 if ((retv = dlpi_bind(pd->dlpi_hd, DLPI_ANY_SAP, 0)) != DLPI_SUCCESS) {
136 pcap_libdlpi_err(p->opt.device, "dlpi_bind", retv, p->errbuf);
141 * Turn a negative snapshot value (invalid), a snapshot value of
142 * 0 (unspecified), or a value bigger than the normal maximum
143 * value, into the maximum allowed value.
145 * If some application really *needs* a bigger snapshot
146 * length, we should just increase MAXIMUM_SNAPLEN.
148 if (p->snapshot <= 0 || p->snapshot > MAXIMUM_SNAPLEN)
149 p->snapshot = MAXIMUM_SNAPLEN;
151 /* Enable promiscuous mode. */
152 if (p->opt.promisc) {
153 retv = dlpromiscon(p, DL_PROMISC_PHYS);
156 * "You don't have permission to capture on
157 * this device" and "you don't have permission
158 * to capture in promiscuous mode on this
159 * device" are different; let the user know,
160 * so if they can't get permission to
161 * capture in promiscuous mode, they can at
162 * least try to capture in non-promiscuous
165 * XXX - you might have to capture in
166 * promiscuous mode to see outgoing packets.
168 if (retv == PCAP_ERROR_PERM_DENIED)
169 status = PCAP_ERROR_PROMISC_PERM_DENIED;
175 /* Try to enable multicast. */
176 retv = dlpromiscon(p, DL_PROMISC_MULTI);
183 /* Try to enable SAP promiscuity. */
184 retv = dlpromiscon(p, DL_PROMISC_SAP);
187 * Not fatal, since the DL_PROMISC_PHYS mode worked.
188 * Report it as a warning, however.
191 status = PCAP_WARNING;
198 /* Determine link type. */
199 if ((retv = dlpi_info(pd->dlpi_hd, &dlinfo, 0)) != DLPI_SUCCESS) {
201 pcap_libdlpi_err(p->opt.device, "dlpi_info", retv, p->errbuf);
205 if (pcap_process_mactype(p, dlinfo.di_mactype) != 0) {
210 p->fd = dlpi_fd(pd->dlpi_hd);
212 /* Push and configure bufmod. */
213 if (pcap_conf_bufmod(p, p->snapshot) != 0) {
219 * Flush the read side.
221 if (ioctl(p->fd, I_FLUSH, FLUSHR) != 0) {
223 pcap_fmt_errmsg_for_errno(p->errbuf, PCAP_ERRBUF_SIZE,
228 /* Allocate data buffer. */
229 if (pcap_alloc_databuf(p) != 0) {
235 * "p->fd" is a FD for a STREAMS device, so "select()" and
236 * "poll()" should work on it.
238 p->selectable_fd = p->fd;
240 p->read_op = pcap_read_libdlpi;
241 p->inject_op = pcap_inject_libdlpi;
242 p->setfilter_op = install_bpf_program; /* No kernel filtering */
243 p->setdirection_op = NULL; /* Not implemented */
244 p->set_datalink_op = NULL; /* Can't change data link type */
245 p->getnonblock_op = pcap_getnonblock_fd;
246 p->setnonblock_op = pcap_setnonblock_fd;
247 p->stats_op = pcap_stats_dlpi;
248 p->cleanup_op = pcap_cleanup_libdlpi;
252 pcap_cleanup_libdlpi(p);
256 #define STRINGIFY(n) #n
259 dlpromiscon(pcap_t *p, bpf_u_int32 level)
261 struct pcap_dlpi *pd = p->priv;
265 retv = dlpi_promiscon(pd->dlpi_hd, level);
266 if (retv != DLPI_SUCCESS) {
267 if (retv == DL_SYSERR &&
268 (errno == EPERM || errno == EACCES))
269 err = PCAP_ERROR_PERM_DENIED;
272 pcap_libdlpi_err(p->opt.device, "dlpi_promiscon" STRINGIFY(level),
280 * Presumably everything returned by dlpi_walk() is a DLPI device,
281 * so there's no work to be done here to check whether name refers
285 is_dlpi_interface(const char *name _U_)
291 get_if_flags(const char *name _U_, bpf_u_int32 *flags _U_, char *errbuf _U_)
294 * Nothing we can do other than mark loopback devices as "the
295 * connected/disconnected status doesn't apply".
297 * XXX - on Solaris, can we do what the dladm command does,
298 * i.e. get a connected/disconnected indication from a kstat?
299 * (Note that you can also get the link speed, and possibly
300 * other information, from a kstat as well.)
302 if (*flags & PCAP_IF_LOOPBACK) {
304 * Loopback devices aren't wireless, and "connected"/
305 * "disconnected" doesn't apply to them.
307 *flags |= PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE;
314 * In Solaris, the "standard" mechanism" i.e SIOCGLIFCONF will only find
315 * network links that are plumbed and are up. dlpi_walk(3DLPI) will find
316 * additional network links present in the system.
319 pcap_platform_finddevs(pcap_if_list_t *devlistp, char *errbuf)
323 linknamelist_t *entry, *next;
324 linkwalk_t lw = {NULL, 0};
328 * Get the list of regular interfaces first.
330 if (pcap_findalldevs_interfaces(devlistp, errbuf,
331 is_dlpi_interface, get_if_flags) == -1)
332 return (-1); /* failure */
334 /* dlpi_walk() for loopback will be added here. */
337 * Find all DLPI devices in the current zone.
339 * XXX - will pcap_findalldevs_interfaces() find any devices
340 * outside the current zone? If not, the only reason to call
341 * it would be to get the interface addresses.
343 dlpi_walk(list_interfaces, &lw, 0);
345 if (lw.lw_err != 0) {
346 pcap_fmt_errmsg_for_errno(errbuf, PCAP_ERRBUF_SIZE,
347 lw.lw_err, "dlpi_walk");
352 /* Add linkname if it does not exist on the list. */
353 for (entry = lw.lw_list; entry != NULL; entry = entry->lnl_next) {
355 * If it isn't already in the list of devices, try to
358 if (find_or_add_dev(devlistp, entry->linkname, 0, get_if_flags,
359 NULL, errbuf) == NULL)
364 for (entry = lw.lw_list; entry != NULL; entry = next) {
365 next = entry->lnl_next;
374 * Read data received on DLPI handle. Returns -2 if told to terminate, else
375 * returns the number of packets read.
378 pcap_read_libdlpi(pcap_t *p, int count, pcap_handler callback, u_char *user)
380 struct pcap_dlpi *pd = p->priv;
392 /* Has "pcap_breakloop()" been called? */
395 * Yes - clear the flag that indicates that it has,
396 * and return -2 to indicate that we were told to
397 * break out of the loop.
404 bufp = (u_char *)p->buffer + p->offset;
406 retv = dlpi_recv(pd->dlpi_hd, NULL, NULL, bufp,
408 if (retv != DLPI_SUCCESS) {
410 * This is most likely a call to terminate out of the
411 * loop. So, do not return an error message, instead
412 * check if "pcap_breakloop()" has been called above.
414 if (retv == DL_SYSERR && errno == EINTR) {
418 pcap_libdlpi_err(dlpi_linkname(pd->dlpi_hd),
419 "dlpi_recv", retv, p->errbuf);
426 return (pcap_process_pkts(p, callback, user, count, bufp, len));
430 pcap_inject_libdlpi(pcap_t *p, const void *buf, size_t size)
432 struct pcap_dlpi *pd = p->priv;
435 retv = dlpi_send(pd->dlpi_hd, NULL, 0, buf, size, NULL);
436 if (retv != DLPI_SUCCESS) {
437 pcap_libdlpi_err(dlpi_linkname(pd->dlpi_hd), "dlpi_send", retv,
442 * dlpi_send(3DLPI) does not provide a way to return the number of
443 * bytes sent on the wire. Based on the fact that DLPI_SUCCESS was
444 * returned we are assuming 'size' bytes were sent.
453 pcap_cleanup_libdlpi(pcap_t *p)
455 struct pcap_dlpi *pd = p->priv;
457 if (pd->dlpi_hd != NULL) {
458 dlpi_close(pd->dlpi_hd);
462 pcap_cleanup_live_common(p);
466 * Write error message to buffer.
469 pcap_libdlpi_err(const char *linkname, const char *func, int err, char *errbuf)
471 pcap_snprintf(errbuf, PCAP_ERRBUF_SIZE, "libpcap: %s failed on %s: %s",
472 func, linkname, dlpi_strerror(err));
476 pcap_create_interface(const char *device _U_, char *ebuf)
480 p = pcap_create_common(ebuf, sizeof (struct pcap_dlpi));
484 p->activate_op = pcap_activate_libdlpi;
489 * Libpcap version string.
492 pcap_lib_version(void)
494 return (PCAP_VERSION_STRING);