master
1/*-
2 * SPDX-License-Identifier: BSD-2-Clause
3 *
4 * Copyright (c) 2004-2008 University of Zagreb
5 * Copyright (c) 2007-2008 FreeBSD Foundation
6 *
7 * This software was developed by the University of Zagreb and the
8 * FreeBSD Foundation under sponsorship by the Stichting NLnet and the
9 * FreeBSD Foundation.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 * SUCH DAMAGE.
31 */
32
33#ifndef _NETGRAPH_PIPE_H_
34#define _NETGRAPH_PIPE_H_
35
36/* Node type name and magic cookie */
37#define NG_PIPE_NODE_TYPE "pipe"
38#define NGM_PIPE_COOKIE 200708191
39
40/* Hook names */
41#define NG_PIPE_HOOK_UPPER "upper"
42#define NG_PIPE_HOOK_LOWER "lower"
43
44#define MAX_FSIZE 65536 /* Largest supported frame size, in bytes, for BER */
45#define MAX_OHSIZE 256 /* Largest supported dummy-framing size, in bytes */
46
47/* Statistics structure for one hook */
48struct ng_pipe_hookstat {
49 u_int64_t fwd_octets;
50 u_int64_t fwd_frames;
51 u_int64_t in_disc_octets;
52 u_int64_t in_disc_frames;
53 u_int64_t out_disc_octets;
54 u_int64_t out_disc_frames;
55};
56
57/* Keep this in sync with the above structure definition */
58#define NG_PIPE_HOOKSTAT_INFO { \
59 { "FwdOctets", &ng_parse_uint64_type }, \
60 { "FwdFrames", &ng_parse_uint64_type }, \
61 { "queueDropOctets", &ng_parse_uint64_type }, \
62 { "queueDropFrames", &ng_parse_uint64_type }, \
63 { "delayDropOctets", &ng_parse_uint64_type }, \
64 { "delayDropFrames", &ng_parse_uint64_type }, \
65 { NULL }, \
66}
67
68/* Statistics structure returned by NGM_PIPE_GET_STATS */
69struct ng_pipe_stats {
70 struct ng_pipe_hookstat downstream;
71 struct ng_pipe_hookstat upstream;
72};
73
74/* Keep this in sync with the above structure definition */
75#define NG_PIPE_STATS_INFO(hstype) { \
76 { "downstream", (hstype) }, \
77 { "upstream", (hstype) }, \
78 { NULL }, \
79}
80
81/* Runtime structure for one hook */
82struct ng_pipe_hookrun {
83 u_int32_t fifo_queues;
84 u_int32_t qin_octets;
85 u_int32_t qin_frames;
86 u_int32_t qout_octets;
87 u_int32_t qout_frames;
88};
89
90/* Keep this in sync with the above structure definition */
91#define NG_PIPE_HOOKRUN_INFO { \
92 { "queues", &ng_parse_uint32_type }, \
93 { "queuedOctets", &ng_parse_uint32_type }, \
94 { "queuedFrames", &ng_parse_uint32_type }, \
95 { "delayedOctets", &ng_parse_uint32_type }, \
96 { "delayedFrames", &ng_parse_uint32_type }, \
97 { NULL }, \
98}
99
100/* Runtime structure returned by NGM_PIPE_GET_RUN */
101struct ng_pipe_run {
102 struct ng_pipe_hookrun downstream;
103 struct ng_pipe_hookrun upstream;
104};
105
106/* Keep this in sync with the above structure definition */
107#define NG_PIPE_RUN_INFO(hstype) { \
108 { "downstream", (hstype) }, \
109 { "upstream", (hstype) }, \
110 { NULL }, \
111}
112
113/* Config structure for one hook */
114struct ng_pipe_hookcfg {
115 u_int64_t bandwidth;
116 u_int64_t ber;
117 u_int32_t qin_size_limit;
118 u_int32_t qout_size_limit;
119 u_int32_t duplicate;
120 u_int32_t fifo;
121 u_int32_t drr;
122 u_int32_t wfq;
123 u_int32_t droptail;
124 u_int32_t drophead;
125};
126
127/* Keep this in sync with the above structure definition */
128#define NG_PIPE_HOOKCFG_INFO { \
129 { "bandwidth", &ng_parse_uint64_type }, \
130 { "BER", &ng_parse_uint64_type }, \
131 { "queuelen", &ng_parse_uint32_type }, \
132 { "delaylen", &ng_parse_uint32_type }, \
133 { "duplicate", &ng_parse_uint32_type }, \
134 { "fifo", &ng_parse_uint32_type }, \
135 { "drr", &ng_parse_uint32_type }, \
136 { "wfq", &ng_parse_uint32_type }, \
137 { "droptail", &ng_parse_uint32_type }, \
138 { "drophead", &ng_parse_uint32_type }, \
139 { NULL }, \
140}
141
142/* Config structure returned by NGM_PIPE_GET_CFG */
143struct ng_pipe_cfg {
144 u_int64_t bandwidth;
145 u_int64_t delay;
146 u_int32_t header_offset;
147 u_int32_t overhead;
148 struct ng_pipe_hookcfg downstream;
149 struct ng_pipe_hookcfg upstream;
150};
151
152/* Keep this in sync with the above structure definition */
153#define NG_PIPE_CFG_INFO(hstype) { \
154 { "bandwidth", &ng_parse_uint64_type }, \
155 { "delay", &ng_parse_uint64_type }, \
156 { "header_offset", &ng_parse_uint32_type }, \
157 { "overhead", &ng_parse_uint32_type }, \
158 { "downstream", (hstype) }, \
159 { "upstream", (hstype) }, \
160 { NULL }, \
161}
162
163/* Netgraph commands */
164enum {
165 NGM_PIPE_GET_STATS=1, /* get stats */
166 NGM_PIPE_CLR_STATS, /* clear stats */
167 NGM_PIPE_GETCLR_STATS, /* atomically get and clear stats */
168 NGM_PIPE_GET_RUN, /* get current runtime status */
169 NGM_PIPE_GET_CFG, /* get configurable parameters */
170 NGM_PIPE_SET_CFG, /* set configurable parameters */
171};
172
173#endif /* _NETGRAPH_PIPE_H_ */