2 * Copyright (c) 2017 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
15 #ifndef SRC_VNET_SESSION_SEGMENT_MANAGER_H_
16 #define SRC_VNET_SESSION_SEGMENT_MANAGER_H_
18 #include <vnet/vnet.h>
19 #include <svm/svm_fifo_segment.h>
20 #include <svm/message_queue.h>
21 #include <vlibmemory/api.h>
22 #include <vppinfra/lock.h>
23 #include <vppinfra/valloc.h>
25 typedef struct _segment_manager_properties
27 /** Session fifo sizes. */
32 /** Configured additional segment size */
36 u8 add_segment:1; /**< can add new segments */
37 u8 use_mq_eventfd:1; /**< use eventfds for mqs */
40 /** Segment type: if set to SSVM_N_TYPES, private segments are used */
41 ssvm_segment_type_t segment_type;
43 } segment_manager_properties_t;
45 typedef struct _segment_manager
47 /** Pool of segments allocated by this manager */
48 svm_fifo_segment_private_t *segments;
50 /** rwlock that protects the segments pool */
51 clib_rwlock_t segments_rwlock;
53 /** Owner app index */
57 * First segment should not be deleted unless segment manger is deleted.
58 * This also indicates that the segment manager is the first to have been
59 * allocated for the app.
61 u8 first_is_protected;
64 * App event queue allocated in first segment
66 svm_msg_q_t *event_queue;
69 #define segment_manager_foreach_segment_w_lock(VAR, SM, BODY) \
71 clib_rwlock_reader_lock (&(SM)->segments_rwlock); \
72 pool_foreach((VAR), ((SM)->segments), (BODY)); \
73 clib_rwlock_reader_unlock (&(SM)->segments_rwlock); \
76 typedef struct segment_manager_main_
78 /** Pool of segment managers */
79 segment_manager_t *segment_managers;
81 /** Virtual address allocator */
82 clib_valloc_main_t va_allocator;
84 } segment_manager_main_t;
86 extern segment_manager_main_t segment_manager_main;
88 typedef struct segment_manager_main_init_args_
92 } segment_manager_main_init_args_t;
94 #define SEGMENT_MANAGER_INVALID_APP_INDEX ((u32) ~0)
96 /** Pool of segment managers */
97 extern segment_manager_t *segment_managers;
99 always_inline segment_manager_t *
100 segment_manager_get (u32 index)
102 return pool_elt_at_index (segment_manager_main.segment_managers, index);
105 always_inline segment_manager_t *
106 segment_manager_get_if_valid (u32 index)
108 if (pool_is_free_index (segment_manager_main.segment_managers, index))
110 return pool_elt_at_index (segment_manager_main.segment_managers, index);
114 segment_manager_index (segment_manager_t * sm)
116 return sm - segment_manager_main.segment_managers;
119 always_inline svm_msg_q_t *
120 segment_manager_event_queue (segment_manager_t * sm)
122 return sm->event_queue;
125 segment_manager_t *segment_manager_new ();
126 int segment_manager_init (segment_manager_t * sm, u32 first_seg_size,
127 u32 prealloc_fifo_pairs);
129 svm_fifo_segment_private_t *segment_manager_get_segment (segment_manager_t *
132 svm_fifo_segment_private_t
133 * segment_manager_get_segment_w_lock (segment_manager_t * sm,
135 int segment_manager_add_segment (segment_manager_t * sm, u32 segment_size);
136 void segment_manager_del_segment (segment_manager_t * sm,
137 svm_fifo_segment_private_t * fs);
138 void segment_manager_segment_reader_unlock (segment_manager_t * sm);
139 void segment_manager_segment_writer_unlock (segment_manager_t * sm);
141 int segment_manager_add_first_segment (segment_manager_t * sm,
143 void segment_manager_del_sessions (segment_manager_t * sm);
144 void segment_manager_del (segment_manager_t * sm);
145 void segment_manager_init_del (segment_manager_t * sm);
146 u8 segment_manager_has_fifos (segment_manager_t * sm);
147 int segment_manager_alloc_session_fifos (segment_manager_t * sm,
148 svm_fifo_t ** server_rx_fifo,
149 svm_fifo_t ** server_tx_fifo,
150 u32 * fifo_segment_index);
151 int segment_manager_try_alloc_fifos (svm_fifo_segment_private_t * fs,
152 u32 rx_fifo_size, u32 tx_fifo_size,
153 svm_fifo_t ** rx_fifo,
154 svm_fifo_t ** tx_fifo);
155 void segment_manager_dealloc_fifos (u32 segment_index, svm_fifo_t * rx_fifo,
156 svm_fifo_t * tx_fifo);
157 u32 segment_manager_evt_q_expected_size (u32 q_size);
158 svm_msg_q_t *segment_manager_alloc_queue (svm_fifo_segment_private_t * fs,
159 segment_manager_properties_t *
161 void segment_manager_dealloc_queue (segment_manager_t * sm, svm_queue_t * q);
162 void segment_manager_app_detach (segment_manager_t * sm);
164 void segment_manager_main_init (segment_manager_main_init_args_t * a);
165 segment_manager_properties_t
166 * segment_manager_properties_init (segment_manager_properties_t * sm);
168 #endif /* SRC_VNET_SESSION_SEGMENT_MANAGER_H_ */
170 * fd.io coding-style-patch-verification: ON
173 * eval: (c-set-style "gnu")