sys/net/bpfdesc.h

   1 /*-
   2  * SPDX-License-Identifier: BSD-3-Clause
   3  *
   4  * Copyright (c) 1990, 1991, 1993
   5  *      The Regents of the University of California.  All rights reserved.
   6  *
   7  * This code is derived from the Stanford/CMU enet packet filter,
   8  * (net/enet.c) distributed as part of 4.3BSD, and code contributed
   9  * to Berkeley by Steven McCanne and Van Jacobson both of Lawrence
  10  * Berkeley Laboratory.
  11  *
  12  * Redistribution and use in source and binary forms, with or without
  13  * modification, are permitted provided that the following conditions
  14  * are met:
  15  * 1. Redistributions of source code must retain the above copyright
  16  *    notice, this list of conditions and the following disclaimer.
  17  * 2. Redistributions in binary form must reproduce the above copyright
  18  *    notice, this list of conditions and the following disclaimer in the
  19  *    documentation and/or other materials provided with the distribution.
  20  * 3. Neither the name of the University nor the names of its contributors
  21  *    may be used to endorse or promote products derived from this software
  22  *    without specific prior written permission.
  23  *
  24  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  34  * SUCH DAMAGE.
  35  *
  36  *      @(#)bpfdesc.h   8.1 (Berkeley) 6/10/93
  37  *
  38  * $FreeBSD$
  39  */
  40
  41 #ifndef _NET_BPFDESC_H_
  42 #define _NET_BPFDESC_H_
  43
  44 #include <sys/callout.h>
  45 #include <sys/selinfo.h>
  46 #include <sys/queue.h>
  47 #include <sys/conf.h>
  48 #include <net/if.h>
  49
  50 /*
  51  * Descriptor associated with each open bpf file.
  52  */
  53 struct zbuf;
  54 struct bpf_d {
  55         LIST_ENTRY(bpf_d) bd_next;      /* Linked list of descriptors */
  56         /*
  57          * Buffer slots: two memory buffers store the incoming packets.
  58          *   The model has three slots.  Sbuf is always occupied.
  59          *   sbuf (store) - Receive interrupt puts packets here.
  60          *   hbuf (hold) - When sbuf is full, put buffer here and
  61          *                 wakeup read (replace sbuf with fbuf).
  62          *   fbuf (free) - When read is done, put buffer here.
  63          * On receiving, if sbuf is full and fbuf is 0, packet is dropped.
  64          */
  65         caddr_t         bd_sbuf;        /* store slot */
  66         caddr_t         bd_hbuf;        /* hold slot */
  67         caddr_t         bd_fbuf;        /* free slot */
  68         int             bd_hbuf_in_use; /* don't rotate buffers */
  69         int             bd_slen;        /* current length of store buffer */
  70         int             bd_hlen;        /* current length of hold buffer */
  71
  72         int             bd_bufsize;     /* absolute length of buffers */
  73
  74         struct bpf_if * bd_bif;         /* interface descriptor */
  75         u_long          bd_rtout;       /* Read timeout in 'ticks' */
  76         struct bpf_insn *bd_rfilter;    /* read filter code */
  77         struct bpf_insn *bd_wfilter;    /* write filter code */
  78         void            *bd_bfilter;    /* binary filter code */
  79         u_int64_t       bd_rcount;      /* number of packets received */
  80         u_int64_t       bd_dcount;      /* number of packets dropped */
  81
  82         u_char          bd_promisc;     /* true if listening promiscuously */
  83         u_char          bd_state;       /* idle, waiting, or timed out */
  84         u_char          bd_immediate;   /* true to return on packet arrival */
  85         u_char          bd_writer;      /* non-zero if d is writer-only */
  86         int             bd_hdrcmplt;    /* false to fill in src lladdr automatically */
  87         int             bd_direction;   /* select packet direction */
  88         int             bd_tstamp;      /* select time stamping function */
  89         int             bd_feedback;    /* true to feed back sent packets */
  90         int             bd_async;       /* non-zero if packet reception should generate signal */
  91         int             bd_sig;         /* signal to send upon packet reception */
  92         struct sigio *  bd_sigio;       /* information for async I/O */
  93         struct selinfo  bd_sel;         /* bsd select info */
  94         struct mtx      bd_lock;        /* per-descriptor lock */
  95         struct callout  bd_callout;     /* for BPF timeouts with select */
  96         struct label    *bd_label;      /* MAC label for descriptor */
  97         u_int64_t       bd_fcount;      /* number of packets which matched filter */
  98         pid_t           bd_pid;         /* PID which created descriptor */
  99         int             bd_locked;      /* true if descriptor is locked */
 100         u_int           bd_bufmode;     /* Current buffer mode. */
 101         u_int64_t       bd_wcount;      /* number of packets written */
 102         u_int64_t       bd_wfcount;     /* number of packets that matched write filter */
 103         u_int64_t       bd_wdcount;     /* number of packets dropped during a write */
 104         u_int64_t       bd_zcopy;       /* number of zero copy operations */
 105         u_char          bd_compat32;    /* 32-bit stream on LP64 system */
 106 };
 107
 108 /* Values for bd_state */
 109 #define BPF_IDLE        0               /* no select in progress */
 110 #define BPF_WAITING     1               /* waiting for read timeout in select */
 111 #define BPF_TIMED_OUT   2               /* read timeout has expired in select */
 112
 113 #define BPFD_LOCK(bd)           mtx_lock(&(bd)->bd_lock)
 114 #define BPFD_UNLOCK(bd)         mtx_unlock(&(bd)->bd_lock)
 115 #define BPFD_LOCK_ASSERT(bd)    mtx_assert(&(bd)->bd_lock, MA_OWNED)
 116
 117 #define BPF_PID_REFRESH(bd, td) (bd)->bd_pid = (td)->td_proc->p_pid
 118 #define BPF_PID_REFRESH_CUR(bd) (bd)->bd_pid = curthread->td_proc->p_pid
 119
 120 #define BPF_LOCK()              mtx_lock(&bpf_mtx)
 121 #define BPF_UNLOCK()            mtx_unlock(&bpf_mtx)
 122 #define BPF_LOCK_ASSERT()       mtx_assert(&bpf_mtx, MA_OWNED)
 123 /*
 124  * External representation of the bpf descriptor
 125  */
 126 struct xbpf_d {
 127         u_int           bd_structsize;  /* Size of this structure. */
 128         u_char          bd_promisc;
 129         u_char          bd_immediate;
 130         u_char          __bd_pad[6];
 131         int             bd_hdrcmplt;
 132         int             bd_direction;
 133         int             bd_feedback;
 134         int             bd_async;
 135         u_int64_t       bd_rcount;
 136         u_int64_t       bd_dcount;
 137         u_int64_t       bd_fcount;
 138         int             bd_sig;
 139         int             bd_slen;
 140         int             bd_hlen;
 141         int             bd_bufsize;
 142         pid_t           bd_pid;
 143         char            bd_ifname[IFNAMSIZ];
 144         int             bd_locked;
 145         u_int64_t       bd_wcount;
 146         u_int64_t       bd_wfcount;
 147         u_int64_t       bd_wdcount;
 148         u_int64_t       bd_zcopy;
 149         int             bd_bufmode;
 150         /*
 151          * Allocate 4 64 bit unsigned integers for future expansion so we do
 152          * not have to worry about breaking the ABI.
 153          */
 154         u_int64_t       bd_spare[4];
 155 };
 156
 157 #define BPFIF_RLOCK(bif)        rw_rlock(&(bif)->bif_lock)
 158 #define BPFIF_RUNLOCK(bif)      rw_runlock(&(bif)->bif_lock)
 159 #define BPFIF_WLOCK(bif)        rw_wlock(&(bif)->bif_lock)
 160 #define BPFIF_WUNLOCK(bif)      rw_wunlock(&(bif)->bif_lock)
 161
 162 #define BPFIF_FLAG_DYING        1       /* Reject new bpf consumers */
 163
 164 #endif