src/svm/svm_fifo_segment.h

   1 /*
   2  * Copyright (c) 2016 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:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   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.
  14  */
  15 #ifndef __included_ssvm_fifo_segment_h__
  16 #define __included_ssvm_fifo_segment_h__
  17
  18 #include <svm/svm_fifo.h>
  19 #include <svm/ssvm.h>
  20 #include <vppinfra/lock.h>
  21
  22 typedef enum
  23 {
  24   FIFO_SEGMENT_FREELIST_NONE = -1,
  25   FIFO_SEGMENT_RX_FREELIST = 0,
  26   FIFO_SEGMENT_TX_FREELIST,
  27   FIFO_SEGMENT_N_FREELISTS
  28 } svm_fifo_segment_freelist_t;
  29
  30 typedef struct
  31 {
  32   svm_fifo_t *fifos;            /**< Linked list of active RX fifos */
  33   u8 *segment_name;             /**< Segment name */
  34   svm_fifo_t *free_fifos[FIFO_SEGMENT_N_FREELISTS];     /**< Free lists */
  35 } svm_fifo_segment_header_t;
  36
  37 typedef struct
  38 {
  39   ssvm_private_t ssvm;
  40   svm_fifo_segment_header_t *h;
  41 } svm_fifo_segment_private_t;
  42
  43 typedef struct
  44 {
  45   volatile u32 lock;
  46
  47   /** pool of segments */
  48   svm_fifo_segment_private_t *segments;
  49   /* Where to put the next one */
  50   u64 next_baseva;
  51   u32 timeout_in_seconds;
  52 } svm_fifo_segment_main_t;
  53
  54 extern svm_fifo_segment_main_t svm_fifo_segment_main;
  55
  56 typedef struct
  57 {
  58   char *segment_name;
  59   u32 segment_size;
  60   u32 *new_segment_indices;
  61   u32 rx_fifo_size;
  62   u32 tx_fifo_size;
  63   u32 preallocated_fifo_pairs;
  64   u32 private_segment_count;
  65   u32 private_segment_size;
  66 } svm_fifo_segment_create_args_t;
  67
  68 static inline svm_fifo_segment_private_t *
  69 svm_fifo_get_segment (u32 segment_index)
  70 {
  71   svm_fifo_segment_main_t *ssm = &svm_fifo_segment_main;
  72   return vec_elt_at_index (ssm->segments, segment_index);
  73 }
  74
  75 static inline u8
  76 svm_fifo_segment_has_fifos (svm_fifo_segment_private_t * fifo_segment)
  77 {
  78   return fifo_segment->h->fifos != 0;
  79 }
  80
  81 static inline svm_fifo_t *
  82 svm_fifo_segment_get_fifo_list (svm_fifo_segment_private_t * fifo_segment)
  83 {
  84   return fifo_segment->h->fifos;
  85 }
  86
  87 #define foreach_ssvm_fifo_segment_api_error             \
  88 _(OUT_OF_SPACE, "Out of space in segment", -200)
  89
  90 typedef enum
  91 {
  92 #define _(n,s,c) SSVM_FIFO_SEGMENT_API_ERROR_##n = c,
  93   foreach_ssvm_fifo_segment_api_error
  94 #undef _
  95 } ssvm_fifo_segment_api_error_enum_t;
  96
  97 int svm_fifo_segment_create (svm_fifo_segment_create_args_t * a);
  98 int svm_fifo_segment_create_process_private (svm_fifo_segment_create_args_t
  99                                              * a);
 100 int svm_fifo_segment_attach (svm_fifo_segment_create_args_t * a);
 101 void svm_fifo_segment_delete (svm_fifo_segment_private_t * s);
 102
 103 svm_fifo_t *svm_fifo_segment_alloc_fifo (svm_fifo_segment_private_t * s,
 104                                          u32 data_size_in_bytes,
 105                                          svm_fifo_segment_freelist_t index);
 106 void svm_fifo_segment_free_fifo (svm_fifo_segment_private_t * s,
 107                                  svm_fifo_t * f,
 108                                  svm_fifo_segment_freelist_t index);
 109 void svm_fifo_segment_init (u64 baseva, u32 timeout_in_seconds);
 110 u32 svm_fifo_segment_index (svm_fifo_segment_private_t * s);
 111
 112 #endif /* __included_ssvm_fifo_segment_h__ */
 113
 114 /*
 115  * fd.io coding-style-patch-verification: ON
 116  *
 117  * Local Variables:
 118  * eval: (c-set-style "gnu")
 119  * End:
 120  */