xref: /xnu-11417.121.6/bsd/net/flowadv.h (revision a1e26a70f38d1d7daa7b49b258e2f8538ad81650)
1*a1e26a70SApple OSS Distributions /*
2*a1e26a70SApple OSS Distributions  * Copyright (c) 2012-2021 Apple Inc. All rights reserved.
3*a1e26a70SApple OSS Distributions  *
4*a1e26a70SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5*a1e26a70SApple OSS Distributions  *
6*a1e26a70SApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
7*a1e26a70SApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
8*a1e26a70SApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
9*a1e26a70SApple OSS Distributions  * compliance with the License. The rights granted to you under the License
10*a1e26a70SApple OSS Distributions  * may not be used to create, or enable the creation or redistribution of,
11*a1e26a70SApple OSS Distributions  * unlawful or unlicensed copies of an Apple operating system, or to
12*a1e26a70SApple OSS Distributions  * circumvent, violate, or enable the circumvention or violation of, any
13*a1e26a70SApple OSS Distributions  * terms of an Apple operating system software license agreement.
14*a1e26a70SApple OSS Distributions  *
15*a1e26a70SApple OSS Distributions  * Please obtain a copy of the License at
16*a1e26a70SApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17*a1e26a70SApple OSS Distributions  *
18*a1e26a70SApple OSS Distributions  * The Original Code and all software distributed under the License are
19*a1e26a70SApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20*a1e26a70SApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21*a1e26a70SApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22*a1e26a70SApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23*a1e26a70SApple OSS Distributions  * Please see the License for the specific language governing rights and
24*a1e26a70SApple OSS Distributions  * limitations under the License.
25*a1e26a70SApple OSS Distributions  *
26*a1e26a70SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27*a1e26a70SApple OSS Distributions  */
28*a1e26a70SApple OSS Distributions 
29*a1e26a70SApple OSS Distributions #ifndef _NET_FLOWADV_H_
30*a1e26a70SApple OSS Distributions #define _NET_FLOWADV_H_
31*a1e26a70SApple OSS Distributions 
32*a1e26a70SApple OSS Distributions #ifdef KERNEL_PRIVATE
33*a1e26a70SApple OSS Distributions #include <sys/types.h>
34*a1e26a70SApple OSS Distributions #include <sys/queue.h>
35*a1e26a70SApple OSS Distributions 
36*a1e26a70SApple OSS Distributions #if SKYWALK
37*a1e26a70SApple OSS Distributions #include <skywalk/os_skywalk.h>
38*a1e26a70SApple OSS Distributions #endif /* SKYWALK */
39*a1e26a70SApple OSS Distributions 
40*a1e26a70SApple OSS Distributions #define FADV_SUCCESS            0       /* success */
41*a1e26a70SApple OSS Distributions #define FADV_FLOW_CONTROLLED    1       /* regular flow control */
42*a1e26a70SApple OSS Distributions #define FADV_SUSPENDED          2       /* flow control due to suspension */
43*a1e26a70SApple OSS Distributions 
44*a1e26a70SApple OSS Distributions struct flowadv {
45*a1e26a70SApple OSS Distributions 	int32_t         code;           /* FADV advisory code */
46*a1e26a70SApple OSS Distributions };
47*a1e26a70SApple OSS Distributions 
48*a1e26a70SApple OSS Distributions typedef enum fce_event_type {
49*a1e26a70SApple OSS Distributions 	FCE_EVENT_TYPE_FLOW_CONTROL_FEEDBACK   = 0,
50*a1e26a70SApple OSS Distributions 	FCE_EVENT_TYPE_CONGESTION_EXPERIENCED  = 1,
51*a1e26a70SApple OSS Distributions } fce_event_type_t;
52*a1e26a70SApple OSS Distributions 
53*a1e26a70SApple OSS Distributions #ifdef BSD_KERNEL_PRIVATE
54*a1e26a70SApple OSS Distributions struct flowadv_fcentry {
55*a1e26a70SApple OSS Distributions 	STAILQ_ENTRY(flowadv_fcentry) fce_link;
56*a1e26a70SApple OSS Distributions 	u_int32_t        fce_flowsrc_type;       /* FLOWSRC values */
57*a1e26a70SApple OSS Distributions 	u_int32_t        fce_flowid;
58*a1e26a70SApple OSS Distributions 	u_int32_t        fce_ce_cnt;
59*a1e26a70SApple OSS Distributions 	u_int32_t        fce_pkts_since_last_report;
60*a1e26a70SApple OSS Distributions 	fce_event_type_t fce_event_type;
61*a1e26a70SApple OSS Distributions #if SKYWALK
62*a1e26a70SApple OSS Distributions 	flowadv_token_t fce_flowsrc_token;
63*a1e26a70SApple OSS Distributions 	flowadv_idx_t   fce_flowsrc_fidx;
64*a1e26a70SApple OSS Distributions 	struct ifnet    *fce_ifp;
65*a1e26a70SApple OSS Distributions #endif /* SKYWALK */
66*a1e26a70SApple OSS Distributions };
67*a1e26a70SApple OSS Distributions 
68*a1e26a70SApple OSS Distributions STAILQ_HEAD(flowadv_fclist, flowadv_fcentry);
69*a1e26a70SApple OSS Distributions 
70*a1e26a70SApple OSS Distributions __BEGIN_DECLS
71*a1e26a70SApple OSS Distributions 
72*a1e26a70SApple OSS Distributions extern void flowadv_init(void);
73*a1e26a70SApple OSS Distributions extern struct flowadv_fcentry *flowadv_alloc_entry(int);
74*a1e26a70SApple OSS Distributions extern void flowadv_free_entry(struct flowadv_fcentry *);
75*a1e26a70SApple OSS Distributions extern void flowadv_add(struct flowadv_fclist *);
76*a1e26a70SApple OSS Distributions extern void flowadv_add_entry(struct flowadv_fcentry *);
77*a1e26a70SApple OSS Distributions 
78*a1e26a70SApple OSS Distributions __END_DECLS
79*a1e26a70SApple OSS Distributions 
80*a1e26a70SApple OSS Distributions #endif /* BSD_KERNEL_PRIVATE */
81*a1e26a70SApple OSS Distributions #endif /* KERNEL_PRIVATE */
82*a1e26a70SApple OSS Distributions #endif /* _NET_FLOWADV_H_ */
83