FD.io VPP  v21.06-3-gbb25fbf28
Vector Packet Processing
ip6_nd.api
Go to the documentation of this file.
1 /* Hey Emacs use -*- mode: C -*- */
2 /*
3  * Copyright (c) 2018 Cisco and/or its affiliates.
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at:
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 /** \file
18 
19  This file defines vpp IP control-plane API messages which are generally
20  called through a shared memory interface.
21 */
22 
23 option version = "1.0.0";
24 
25 import "vnet/ip/ip_types.api";
26 import "vnet/interface_types.api";
27 
28 /** \brief IPv6 router advertisement config request
29  @param client_index - opaque cookie to identify the sender
30  @param context - sender context, to match reply w/ request
31  @param suppress -
32  @param managed -
33  @param other -
34  @param ll_option -
35  @param send_unicast -
36  @param cease -
37  @param is_no -
38  @param default_router -
39  @param max_interval -
40  @param min_interval -
41  @param lifetime -
42  @param initial_count -
43  @param initial_interval -
44 */
45 autoreply define sw_interface_ip6nd_ra_config
46 {
49  vl_api_interface_index_t sw_if_index;
56  bool is_no;
63 };
64 
65 /** \brief IPv6 router advertisement prefix config request
66  @param client_index - opaque cookie to identify the sender
67  @param context - sender context, to match reply w/ request
68  @param sw_if_index - The interface the RA prefix information is for
69  @param prefix - The prefix to advertise
70  @param use_default - Revert to default settings
71  @param no_advertise - Do not advertise this prefix
72  @param off_link - The prefix is off link (it is not configured on the interface)
73  Configures the L-flag, When set, indicates that this
74  prefix can be used for on-link determination.
75  @param no_autoconfig - Setting for the A-flag. When
76  set indicates that this prefix can be used for
77  stateless address configuration.
78  @param no_onlink - The prefix is not on link. Make sure this is consistent
79  with the off_link parameter else YMMV
80  @param is_no - add/delete
81  @param val_lifetime - The length of time in
82  seconds (relative to the time the packet is sent)
83  that the prefix is valid for the purpose of on-link
84  determination. A value of all one bits
85  (0xffffffff) represents infinity
86  @param pref_lifetime - The length of time in
87  seconds (relative to the time the packet is sent)
88  that addresses generated from the prefix via
89  stateless address autoconfiguration remain
90  preferred [ADDRCONF]. A value of all one bits
91  (0xffffffff) represents infinity.
92 */
93 autoreply define sw_interface_ip6nd_ra_prefix
94 {
97  vl_api_interface_index_t sw_if_index;
98  vl_api_prefix_t prefix;
101  bool off_link;
103  bool no_onlink;
104  bool is_no;
107 };
108 
109 /** \brief IPv6 ND proxy config
110  @param client_index - opaque cookie to identify the sender
111  @param context - sender context, to match reply w/ request
112  @param sw_if_index - The interface the host is on
113  @param ip - The address of the host for which to proxy for
114  @param is_add - Adding or deleting
115 */
116 autoreply define ip6nd_proxy_add_del
117 {
120  vl_api_interface_index_t sw_if_index;
121  bool is_add;
122  vl_api_ip6_address_t ip;
123 };
124 
125 /** \brief IPv6 ND proxy details returned after request
126  @param context - sender context, to match reply w/ request
127  @param sw_if_index - The interface the host is on
128  @param ip - The address of the host for which to proxy for
129 */
130 define ip6nd_proxy_details
131 {
133  vl_api_interface_index_t sw_if_index;
134  vl_api_ip6_address_t ip;
135 };
136 
137 /** \brief IPv6 ND proxy dump request
138  @param context - sender context, to match reply w/ request
139 */
140 define ip6nd_proxy_dump
141 {
144 };
145 
146 /** \brief Start / stop sending router solicitation
147  @param client_index - opaque cookie to identify the sender
148  @param context - sender context, to match reply w/ request
149  @param irt - initial retransmission time
150  @param mrt - maximum retransmission time
151  @param mrc - maximum retransmission count
152  @param mrd - maximum retransmission duration
153  @param sw_if_index - software interface index of interface
154  for sending router solicitation
155  @param stop - if non-zero then stop sending router solicitation,
156  otherwise start sending router solicitation
157 */
158 autoreply define ip6nd_send_router_solicitation
159 {
166  vl_api_interface_index_t sw_if_index;
167  bool stop;
168 };
169 
171  rpc want_ip6_ra_events returns want_ip6_ra_events_reply
172  events ip6_ra_event;
173 };
174 
175 /** \brief Register for ip6 router advertisement events
176  @param client_index - opaque cookie to identify the sender
177  @param context - sender context, to match reply w/ request
178  @param enable - 1 => register for events, 0 => cancel registration
179  @param pid - sender's pid
180 */
181 autoreply define want_ip6_ra_events
182 {
185  bool enable;
187 };
188 
189 /** \brief Struct representing RA prefix info
190  @param prefix - RA prefix info destination address
191  @param flags - RA prefix info flags
192  @param valid_time - RA prefix info valid time
193  @param preferred_time - RA prefix info preferred time
194 */
195 typedef ip6_ra_prefix_info
196 {
197  vl_api_prefix_t prefix;
201 };
202 
203 /** \brief Tell client about a router advertisement event
204  @param client_index - opaque cookie to identify the sender
205  @param pid - client pid registered to receive notification
206  @param current_hop_limit - RA current hop limit
207  @param flags - RA flags
208  @param router_lifetime_in_sec - RA lifetime in seconds
209  @param router_addr - The router's address
210  @param neighbor_reachable_time_in_msec - RA neighbor reachable time in msec
211  @param time_in_msec_between_retransmitted_neighbor_solicitations -
212  time in msec between retransmitted neighbor solicitations
213  @param n_prefixes -
214  @param prefixes -
215 */
216 define ip6_ra_event
217 {
220  vl_api_interface_index_t sw_if_index;
221  vl_api_ip6_address_t router_addr;
228  vl_api_ip6_ra_prefix_info_t prefixes[n_prefixes];
229 };
230 
231 
232 /*
233  * Local Variables:
234  * eval: (c-set-style "gnu")
235  * End:
236  */
vl_api_sw_interface_ip6nd_ra_config_t::default_router
u8 default_router
Definition: ip6_nd.api:57
vl_api_sw_interface_ip6nd_ra_prefix_t::no_autoconfig
bool no_autoconfig
Definition: ip6_nd.api:102
vl_api_sw_interface_ip6nd_ra_config_t::other
u8 other
Definition: ip6_nd.api:52
vl_api_sw_interface_ip6nd_ra_prefix_t::client_index
u32 client_index
Definition: ip6_nd.api:95
flags
u8 flags
Definition: ip6_nd.api:198
vl_api_want_ip6_ra_events_t::enable
bool enable
Definition: ip6_nd.api:185
vl_api_sw_interface_ip6nd_ra_config_t::send_unicast
u8 send_unicast
Definition: ip6_nd.api:54
vl_api_ip6_ra_event_t::n_prefixes
u32 n_prefixes
Definition: ip6_nd.api:227
vl_api_ip6_ra_event_t::time_in_msec_between_retransmitted_neighbor_solicitations
u32 time_in_msec_between_retransmitted_neighbor_solicitations
Definition: ip6_nd.api:226
vl_api_want_ip6_ra_events_t::context
u32 context
Definition: ip6_nd.api:184
vl_api_ip6nd_proxy_details_t::ip
vl_api_ip6_address_t ip
Definition: ip6_nd.api:134
vl_api_ip6nd_proxy_details_t::sw_if_index
vl_api_interface_index_t sw_if_index
Definition: ip6_nd.api:133
u16
unsigned short u16
Definition: types.h:57
vl_api_ip6_ra_event_t
Tell client about a router advertisement event.
Definition: ip6_nd.api:216
vl_api_sw_interface_ip6nd_ra_config_t::is_no
bool is_no
Definition: ip6_nd.api:56
vl_api_ip6_ra_event_t::flags
u8 flags
Definition: ip6_nd.api:223
vl_api_sw_interface_ip6nd_ra_config_t
IPv6 router advertisement config request.
Definition: ip6_nd.api:45
vl_api_sw_interface_ip6nd_ra_config_t::min_interval
u32 min_interval
Definition: ip6_nd.api:59
vl_api_ip6nd_proxy_add_del_t::sw_if_index
vl_api_interface_index_t sw_if_index
Definition: ip6_nd.api:120
vl_api_sw_interface_ip6nd_ra_config_t::sw_if_index
vl_api_interface_index_t sw_if_index
Definition: ip6_nd.api:49
vl_api_sw_interface_ip6nd_ra_config_t::cease
u8 cease
Definition: ip6_nd.api:55
vl_api_sw_interface_ip6nd_ra_prefix_t::no_onlink
bool no_onlink
Definition: ip6_nd.api:103
vl_api_sw_interface_ip6nd_ra_config_t::lifetime
u32 lifetime
Definition: ip6_nd.api:60
vl_api_want_ip6_ra_events_t::pid
u32 pid
Definition: ip6_nd.api:186
vl_api_ip6nd_proxy_dump_t::client_index
u32 client_index
Definition: ip6_nd.api:142
vl_api_ip6nd_proxy_dump_t::context
u32 context
Definition: ip6_nd.api:143
ip6_ra_prefix_info
typedef ip6_ra_prefix_info
Struct representing RA prefix info.
Definition: ip6_nd.api:196
vl_api_ip6_ra_event_t::sw_if_index
vl_api_interface_index_t sw_if_index
Definition: ip6_nd.api:220
vl_api_want_ip6_ra_events_t::client_index
u32 client_index
Definition: ip6_nd.api:183
vl_api_ip6nd_proxy_add_del_t::is_add
bool is_add
Definition: ip6_nd.api:121
vl_api_ip6nd_send_router_solicitation_t
Start / stop sending router solicitation.
Definition: ip6_nd.api:158
vl_api_ip6nd_proxy_dump_t
IPv6 ND proxy dump request.
Definition: ip6_nd.api:140
vl_api_ip6nd_send_router_solicitation_t::mrd
u32 mrd
Definition: ip6_nd.api:165
vl_api_ip6nd_proxy_add_del_t::client_index
u32 client_index
Definition: ip6_nd.api:118
vl_api_sw_interface_ip6nd_ra_prefix_t::val_lifetime
u32 val_lifetime
Definition: ip6_nd.api:105
vl_api_sw_interface_ip6nd_ra_config_t::context
u32 context
Definition: ip6_nd.api:48
vl_api_ip6nd_proxy_add_del_t::ip
vl_api_ip6_address_t ip
Definition: ip6_nd.api:122
vl_api_ip6_ra_event_t::router_addr
vl_api_ip6_address_t router_addr
Definition: ip6_nd.api:221
service
service
Definition: ip6_nd.api:170
vl_api_ip6nd_send_router_solicitation_t::irt
u32 irt
Definition: ip6_nd.api:162
vl_api_sw_interface_ip6nd_ra_config_t::max_interval
u32 max_interval
Definition: ip6_nd.api:58
vl_api_ip6_ra_event_t::neighbor_reachable_time_in_msec
u32 neighbor_reachable_time_in_msec
Definition: ip6_nd.api:225
vl_api_sw_interface_ip6nd_ra_prefix_t::off_link
bool off_link
Definition: ip6_nd.api:101
vl_api_ip6nd_proxy_details_t::context
u32 context
Definition: ip6_nd.api:132
vl_api_ip6nd_send_router_solicitation_t::stop
bool stop
Definition: ip6_nd.api:167
vl_api_sw_interface_ip6nd_ra_prefix_t::no_advertise
bool no_advertise
Definition: ip6_nd.api:100
vl_api_sw_interface_ip6nd_ra_config_t::initial_count
u32 initial_count
Definition: ip6_nd.api:61
events
static perfmon_event_t events[]
Definition: core.c:21
vl_api_sw_interface_ip6nd_ra_prefix_t::prefix
vl_api_prefix_t prefix
Definition: ip6_nd.api:98
preferred_time
u32 preferred_time
Definition: ip6_nd.api:200
vl_api_sw_interface_ip6nd_ra_prefix_t::is_no
bool is_no
Definition: ip6_nd.api:104
version
option version
Definition: ip6_nd.api:23
vl_api_ip6nd_send_router_solicitation_t::sw_if_index
vl_api_interface_index_t sw_if_index
Definition: ip6_nd.api:166
valid_time
u32 valid_time
Definition: ip6_nd.api:199
vl_api_ip6nd_proxy_details_t
IPv6 ND proxy details returned after request.
Definition: ip6_nd.api:130
vl_api_ip6nd_send_router_solicitation_t::mrc
u32 mrc
Definition: ip6_nd.api:164
vl_api_ip6_ra_event_t::current_hop_limit
u8 current_hop_limit
Definition: ip6_nd.api:222
vl_api_ip6_ra_event_t::pid
u32 pid
Definition: ip6_nd.api:219
vl_api_sw_interface_ip6nd_ra_prefix_t::pref_lifetime
u32 pref_lifetime
Definition: ip6_nd.api:106
vl_api_sw_interface_ip6nd_ra_config_t::suppress
u8 suppress
Definition: ip6_nd.api:50
u32
unsigned int u32
Definition: types.h:88
vl_api_sw_interface_ip6nd_ra_config_t::ll_option
u8 ll_option
Definition: ip6_nd.api:53
vl_api_ip6_ra_event_t::prefixes
vl_api_ip6_ra_prefix_info_t prefixes[n_prefixes]
Definition: ip6_nd.api:228
vl_api_want_ip6_ra_events_t
Register for ip6 router advertisement events.
Definition: ip6_nd.api:181
vl_api_sw_interface_ip6nd_ra_prefix_t::use_default
bool use_default
Definition: ip6_nd.api:99
vl_api_ip6_ra_event_t::router_lifetime_in_sec
u16 router_lifetime_in_sec
Definition: ip6_nd.api:224
u8
unsigned char u8
Definition: types.h:56
vl_api_ip6nd_send_router_solicitation_t::context
u32 context
Definition: ip6_nd.api:161
vl_api_sw_interface_ip6nd_ra_config_t::managed
u8 managed
Definition: ip6_nd.api:51
vl_api_sw_interface_ip6nd_ra_prefix_t::sw_if_index
vl_api_interface_index_t sw_if_index
Definition: ip6_nd.api:97
vl_api_sw_interface_ip6nd_ra_config_t::client_index
u32 client_index
Definition: ip6_nd.api:47
vl_api_ip6_ra_event_t::client_index
u32 client_index
Definition: ip6_nd.api:218
vl_api_sw_interface_ip6nd_ra_prefix_t::context
u32 context
Definition: ip6_nd.api:96
vl_api_ip6nd_proxy_add_del_t::context
u32 context
Definition: ip6_nd.api:119
vl_api_ip6nd_send_router_solicitation_t::mrt
u32 mrt
Definition: ip6_nd.api:163
vl_api_ip6nd_send_router_solicitation_t::client_index
u32 client_index
Definition: ip6_nd.api:160
vl_api_sw_interface_ip6nd_ra_config_t::initial_interval
u32 initial_interval
Definition: ip6_nd.api:62
vl_api_sw_interface_ip6nd_ra_prefix_t
IPv6 router advertisement prefix config request.
Definition: ip6_nd.api:93
vl_api_ip6nd_proxy_add_del_t
IPv6 ND proxy config.
Definition: ip6_nd.api:116
prefix
vl_api_prefix_t prefix
Definition: ip.api:146