mirror of
https://github.com/freebsd/freebsd-src
synced 2024-09-06 17:18:32 +00:00
![Gleb Smirnoff](/assets/img/avatar_default.png)
These KPIs were added in 9d29c635da
and through 15 years had zero use.
They slightly remind what IfAPI does for struct ifnet. But IfAPI does
that for the sake of large collection of NIC drivers not being aware of
struct ifnet. For the inpcb it is unclear what could be a large
collection of externally written kernel modules that need extensively use
inpcb and not be aware of its internals at the same time. This isolation
of a structure knowledge requires a lot of work, and just throwing in a
few KPIs isn't helpful.
Reviewed by: kib, bz, markj
Differential Revision: https://reviews.freebsd.org/D44310
148 lines
5.3 KiB
C
148 lines
5.3 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*
|
|
* Copyright (c) 2012 Chelsio Communications, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _NETINET_TOE_H_
|
|
#define _NETINET_TOE_H_
|
|
|
|
#ifndef _KERNEL
|
|
#error "no user-serviceable parts inside"
|
|
#endif
|
|
|
|
#include <netinet/tcp.h>
|
|
#include <sys/_eventhandler.h>
|
|
|
|
struct tcpcb;
|
|
struct tcpopt;
|
|
struct tcphdr;
|
|
struct in_conninfo;
|
|
struct tcp_info;
|
|
struct nhop_object;
|
|
struct ktls_session;
|
|
|
|
struct toedev {
|
|
TAILQ_ENTRY(toedev) link; /* glue for toedev_list */
|
|
void *tod_softc; /* TOE driver private data */
|
|
|
|
/*
|
|
* Active open. If a failure occurs, it is reported back by the driver
|
|
* via toe_connect_failed.
|
|
*/
|
|
int (*tod_connect)(struct toedev *, struct socket *, struct nhop_object *,
|
|
struct sockaddr *);
|
|
|
|
/* Passive open. */
|
|
int (*tod_listen_start)(struct toedev *, struct tcpcb *);
|
|
int (*tod_listen_stop)(struct toedev *, struct tcpcb *);
|
|
|
|
/*
|
|
* The kernel uses this routine to pass on any frame it receives for an
|
|
* offloaded connection to the TOE driver. This is an unusual event.
|
|
*/
|
|
void (*tod_input)(struct toedev *, struct tcpcb *, struct mbuf *);
|
|
|
|
/*
|
|
* This is called by the kernel during pru_rcvd for an offloaded TCP
|
|
* connection and provides an opportunity for the TOE driver to manage
|
|
* its rx window and credits.
|
|
*/
|
|
void (*tod_rcvd)(struct toedev *, struct tcpcb *);
|
|
|
|
/*
|
|
* Transmit routine. The kernel calls this to have the TOE driver
|
|
* evaluate whether there is data to be transmitted, and transmit it.
|
|
*/
|
|
int (*tod_output)(struct toedev *, struct tcpcb *);
|
|
|
|
/* Immediate teardown: send RST to peer. */
|
|
int (*tod_send_rst)(struct toedev *, struct tcpcb *);
|
|
|
|
/* Initiate orderly disconnect by sending FIN to the peer. */
|
|
int (*tod_send_fin)(struct toedev *, struct tcpcb *);
|
|
|
|
/* Called to indicate that the kernel is done with this TCP PCB. */
|
|
void (*tod_pcb_detach)(struct toedev *, struct tcpcb *);
|
|
|
|
/*
|
|
* The kernel calls this once it has information about an L2 entry that
|
|
* the TOE driver enquired about previously (via toe_l2_resolve).
|
|
*/
|
|
void (*tod_l2_update)(struct toedev *, struct ifnet *,
|
|
struct sockaddr *, uint8_t *, uint16_t);
|
|
|
|
/* XXX. Route has been redirected. */
|
|
void (*tod_route_redirect)(struct toedev *, struct ifnet *,
|
|
struct nhop_object *, struct nhop_object *);
|
|
|
|
/* Syncache interaction. */
|
|
void (*tod_syncache_added)(struct toedev *, void *);
|
|
void (*tod_syncache_removed)(struct toedev *, void *);
|
|
int (*tod_syncache_respond)(struct toedev *, void *, struct mbuf *);
|
|
void (*tod_offload_socket)(struct toedev *, void *, struct socket *);
|
|
|
|
/* TCP socket option */
|
|
void (*tod_ctloutput)(struct toedev *, struct tcpcb *, int, int);
|
|
|
|
/* Update software state */
|
|
void (*tod_tcp_info)(struct toedev *, const struct tcpcb *,
|
|
struct tcp_info *);
|
|
|
|
/* Create a TLS session */
|
|
int (*tod_alloc_tls_session)(struct toedev *, struct tcpcb *,
|
|
struct ktls_session *, int);
|
|
|
|
/* ICMP fragmentation-needed received, adjust PMTU. */
|
|
void (*tod_pmtu_update)(struct toedev *, struct tcpcb *, tcp_seq, int);
|
|
};
|
|
|
|
typedef void (*tcp_offload_listen_start_fn)(void *, struct tcpcb *);
|
|
typedef void (*tcp_offload_listen_stop_fn)(void *, struct tcpcb *);
|
|
EVENTHANDLER_DECLARE(tcp_offload_listen_start, tcp_offload_listen_start_fn);
|
|
EVENTHANDLER_DECLARE(tcp_offload_listen_stop, tcp_offload_listen_stop_fn);
|
|
|
|
void init_toedev(struct toedev *);
|
|
int register_toedev(struct toedev *);
|
|
int unregister_toedev(struct toedev *);
|
|
|
|
/*
|
|
* General interface for looking up L2 information for an IP address. If an
|
|
* answer is not available right away then the TOE driver's tod_l2_update will
|
|
* be called later.
|
|
*/
|
|
int toe_l2_resolve(struct toedev *, struct ifnet *, struct sockaddr *,
|
|
uint8_t *, uint16_t *);
|
|
|
|
void toe_connect_failed(struct toedev *, struct inpcb *, int);
|
|
|
|
void toe_syncache_add(struct in_conninfo *, struct tcpopt *, struct tcphdr *,
|
|
struct inpcb *, void *, void *, uint8_t);
|
|
int toe_syncache_expand(struct in_conninfo *, struct tcpopt *, struct tcphdr *,
|
|
struct socket **);
|
|
|
|
int toe_4tuple_check(struct in_conninfo *, struct tcphdr *, struct ifnet *);
|
|
#endif
|