FD.io VPP  v18.10-34-gcce845e
Vector Packet Processing
application.h File Reference
+ Include dependency graph for application.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  app_worker_
 
struct  app_worker_map_
 
struct  app_listener_
 
struct  application_
 
struct  app_main_
 
struct  app_init_args_
 

Macros

#define APP_DEBUG   0
 
#define APP_DBG(_fmt, _args...)
 
#define foreach_app_init_args
 
#define APP_INVALID_INDEX   ((u32)~0)
 
#define APP_NS_INVALID_INDEX   ((u32)~0)
 
#define APP_INVALID_SEGMENT_MANAGER_INDEX   ((u32) ~0)
 

Typedefs

typedef struct _stream_session_cb_vft session_cb_vft_t
 
typedef struct app_worker_ app_worker_t
 
typedef struct app_worker_map_ app_worker_map_t
 
typedef struct app_listener_ app_listener_t
 
typedef struct application_ application_t
 
typedef struct app_main_ app_main_t
 
typedef struct app_init_args_ app_init_args_t
 
typedef struct _vnet_app_worker_add_del_args vnet_app_worker_add_del_args_t
 

Functions

app_worker_tapp_worker_alloc (application_t *app)
 
int app_worker_alloc_and_init (application_t *app, app_worker_t **wrk)
 
app_worker_tapp_worker_get (u32 wrk_index)
 
app_worker_tapp_worker_get_if_valid (u32 wrk_index)
 
application_tapp_worker_get_app (u32 wrk_index)
 
void app_worker_free (app_worker_t *app_wrk)
 
int app_worker_open_session (app_worker_t *app, session_endpoint_t *tep, u32 api_context)
 
segment_manager_tapp_worker_get_listen_segment_manager (app_worker_t *, stream_session_t *)
 
segment_manager_tapp_worker_get_connect_segment_manager (app_worker_t *)
 
int app_worker_alloc_connects_segment_manager (app_worker_t *app)
 
int app_worker_add_segment_notify (u32 app_or_wrk, ssvm_private_t *fs)
 Send an API message to the external app, to map new segment. More...
 
u32 app_worker_n_listeners (app_worker_t *app)
 
stream_session_tapp_worker_first_listener (app_worker_t *app, u8 fib_proto, u8 transport_proto)
 
u8 app_worker_application_is_builtin (app_worker_t *app_wrk)
 
int app_worker_send_event (app_worker_t *app, stream_session_t *s, u8 evt)
 Send event to application. More...
 
int app_worker_lock_and_send_event (app_worker_t *app, stream_session_t *s, u8 evt_type)
 Send event to application. More...
 
clib_error_tvnet_app_worker_add_del (vnet_app_worker_add_del_args_t *a)
 
int application_start_listen (application_t *app, session_endpoint_extended_t *tep, session_handle_t *handle)
 Start listening local transport endpoint for requested transport. More...
 
int application_stop_listen (u32 app_index, u32 app_or_wrk, session_handle_t handle)
 Stop listening on session associated to handle. More...
 
application_tapplication_alloc (void)
 
int application_alloc_and_init (app_init_args_t *args)
 
void application_free (application_t *app)
 
application_tapplication_get (u32 index)
 
application_tapplication_get_if_valid (u32 index)
 
application_tapplication_lookup (u32 api_client_index)
 
application_tapplication_lookup_name (const u8 *name)
 
u32 application_index (application_t *app)
 
app_worker_tapplication_get_worker (application_t *app, u32 wrk_index)
 
app_worker_tapplication_get_default_worker (application_t *app)
 
app_worker_tapplication_listener_select_worker (stream_session_t *ls, u8 is_local)
 
int application_api_queue_is_full (application_t *app)
 
int application_is_proxy (application_t *app)
 
int application_is_builtin (application_t *app)
 
int application_is_builtin_proxy (application_t *app)
 
u32 application_session_table (application_t *app, u8 fib_proto)
 
u32 application_local_session_table (application_t *app)
 
u8application_name_from_index (u32 app_or_wrk)
 Returns app name. More...
 
u8 application_has_local_scope (application_t *app)
 
u8 application_has_global_scope (application_t *app)
 
u8 application_use_mq_for_ctrl (application_t *app)
 
void application_setup_proxy (application_t *app)
 
void application_remove_proxy (application_t *app)
 
segment_manager_properties_tapplication_get_segment_manager_properties (u32 app_index)
 
segment_manager_properties_tapplication_segment_manager_properties (application_t *app)
 
local_session_tapplication_local_session_alloc (app_worker_t *app)
 
void application_local_session_free (app_worker_t *app, local_session_t *ls)
 
local_session_tapplication_get_local_session (app_worker_t *app, u32 session_index)
 
local_session_tapplication_get_local_session_from_handle (session_handle_t handle)
 
local_session_tapplication_get_local_listen_session_from_handle (session_handle_t lh)
 
int application_start_local_listen (application_t *server, session_endpoint_extended_t *sep, session_handle_t *handle)
 
int application_stop_local_listen (u32 app_index, u32 app_or_wrk, session_handle_t lh)
 Clean up local session table. More...
 
int application_local_session_connect (app_worker_t *client, app_worker_t *server, local_session_t *ls, u32 opaque)
 
int application_local_session_connect_notify (local_session_t *ls)
 
int application_local_session_disconnect (u32 app_or_wrk, local_session_t *ls)
 
int application_local_session_disconnect_w_index (u32 app_or_wrk, u32 ls_index)
 
void app_worker_local_sessions_free (app_worker_t *app)
 
static u32 local_session_id (local_session_t *ls)
 
static void local_session_parse_id (u32 ls_id, u32 *app_or_wrk, u32 *session_index)
 
static void local_session_parse_handle (session_handle_t handle, u32 *app_or_wrk_index, u32 *session_index)
 
static session_handle_t application_local_session_handle (local_session_t *ls)
 
static local_session_tapplication_get_local_listen_session (application_t *app, u32 session_index)
 
static local_session_tapplication_get_local_listener_w_handle (session_handle_t handle)
 
static u8 application_local_session_listener_has_transport (local_session_t *ls)
 
void mq_send_local_session_disconnected_cb (u32 app_or_wrk, local_session_t *ls)
 
uword unformat_application_proto (unformat_input_t *input, va_list *args)
 

Macro Definition Documentation

#define APP_DBG (   _fmt,
  _args... 
)

Definition at line 28 of file application.h.

#define APP_DEBUG   0

Definition at line 23 of file application.h.

#define APP_INVALID_INDEX   ((u32)~0)

Definition at line 218 of file application.h.

#define APP_INVALID_SEGMENT_MANAGER_INDEX   ((u32) ~0)

Definition at line 220 of file application.h.

#define APP_NS_INVALID_INDEX   ((u32)~0)

Definition at line 219 of file application.h.

#define foreach_app_init_args
Value:
_(u32, api_client_index) \
_(u8 *, name) \
_(u64 *, options) \
_(u8 *, namespace_id) \
_(u32, app_index) \
unsigned long u64
Definition: types.h:89
unsigned char u8
Definition: types.h:56
struct _stream_session_cb_vft session_cb_vft_t
unsigned int u32
Definition: types.h:88
static session_cb_vft_t session_cb_vft
Definition: session_api.c:391
u8 name[64]
Definition: memclnt.api:151

Definition at line 194 of file application.h.

Typedef Documentation

typedef struct app_listener_ app_listener_t
typedef struct app_main_ app_main_t
typedef struct app_worker_ app_worker_t
typedef struct application_ application_t
typedef struct _stream_session_cb_vft session_cb_vft_t
typedef struct _vnet_app_worker_add_del_args vnet_app_worker_add_del_args_t

Function Documentation

int app_worker_add_segment_notify ( u32  app_or_wrk,
ssvm_private_t fs 
)

Send an API message to the external app, to map new segment.

Definition at line 985 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

app_worker_t* app_worker_alloc ( application_t app)

Definition at line 483 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int app_worker_alloc_and_init ( application_t app,
app_worker_t **  wrk 
)

Definition at line 579 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int app_worker_alloc_connects_segment_manager ( app_worker_t app)

Definition at line 852 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u8 app_worker_application_is_builtin ( app_worker_t app_wrk)

Definition at line 1023 of file application.c.

+ Here is the caller graph for this function:

stream_session_t* app_worker_first_listener ( app_worker_t app,
u8  fib_proto,
u8  transport_proto 
)

Definition at line 999 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void app_worker_free ( app_worker_t app_wrk)

Definition at line 513 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

app_worker_t* app_worker_get ( u32  wrk_index)

Definition at line 499 of file application.c.

+ Here is the caller graph for this function:

application_t* app_worker_get_app ( u32  wrk_index)

Definition at line 627 of file application.c.

+ Here is the call graph for this function:

segment_manager_t* app_worker_get_connect_segment_manager ( app_worker_t )

Definition at line 867 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

app_worker_t* app_worker_get_if_valid ( u32  wrk_index)

Definition at line 505 of file application.c.

+ Here is the caller graph for this function:

segment_manager_t* app_worker_get_listen_segment_manager ( app_worker_t ,
stream_session_t  
)

Definition at line 874 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void app_worker_local_sessions_free ( app_worker_t app)

Definition at line 1837 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int app_worker_lock_and_send_event ( app_worker_t app,
stream_session_t s,
u8  evt_type 
)

Send event to application.

Logic from queue perspective is blocking. However, if queue is full, we return.

Definition at line 1339 of file application.c.

+ Here is the caller graph for this function:

u32 app_worker_n_listeners ( app_worker_t app)
int app_worker_open_session ( app_worker_t app,
session_endpoint_t tep,
u32  api_context 
)

Definition at line 837 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int app_worker_send_event ( app_worker_t app,
stream_session_t s,
u8  evt_type 
)

Send event to application.

Logic from queue perspective is non-blocking. If there's not enough space to enqueue a message, we return.

Definition at line 1326 of file application.c.

application_t* application_alloc ( void  )

Definition at line 233 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_alloc_and_init ( app_init_args_t args)

Definition at line 306 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_api_queue_is_full ( application_t app)

Definition at line 159 of file application.c.

+ Here is the call graph for this function:

void application_free ( application_t app)

Definition at line 388 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

application_t* application_get ( u32  index)

Definition at line 243 of file application.c.

+ Here is the caller graph for this function:

app_worker_t* application_get_default_worker ( application_t app)

Definition at line 454 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

application_t* application_get_if_valid ( u32  index)

Definition at line 251 of file application.c.

+ Here is the caller graph for this function:

static local_session_t* application_get_local_listen_session ( application_t app,
u32  session_index 
)
inlinestatic

Definition at line 357 of file application.h.

+ Here is the caller graph for this function:

local_session_t* application_get_local_listen_session_from_handle ( session_handle_t  lh)
static local_session_t* application_get_local_listener_w_handle ( session_handle_t  handle)
inlinestatic

Definition at line 363 of file application.h.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

local_session_t* application_get_local_session ( app_worker_t app,
u32  session_index 
)

Definition at line 1366 of file application.c.

+ Here is the caller graph for this function:

local_session_t* application_get_local_session_from_handle ( session_handle_t  handle)

Definition at line 1374 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

segment_manager_properties_t* application_get_segment_manager_properties ( u32  app_index)

Definition at line 1191 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

app_worker_t* application_get_worker ( application_t app,
u32  wrk_index 
)

Definition at line 444 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u8 application_has_global_scope ( application_t app)

Definition at line 970 of file application.c.

+ Here is the caller graph for this function:

u8 application_has_local_scope ( application_t app)

Definition at line 964 of file application.c.

+ Here is the caller graph for this function:

u32 application_index ( application_t app)

Definition at line 260 of file application.c.

+ Here is the caller graph for this function:

int application_is_builtin ( application_t app)

Definition at line 952 of file application.c.

+ Here is the caller graph for this function:

int application_is_builtin_proxy ( application_t app)

Definition at line 958 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_is_proxy ( application_t app)

Definition at line 946 of file application.c.

+ Here is the caller graph for this function:

app_worker_t* application_listener_select_worker ( stream_session_t ls,
u8  is_local 
)

Definition at line 460 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

local_session_t* application_local_session_alloc ( app_worker_t app)

Definition at line 1346 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_local_session_connect ( app_worker_t client,
app_worker_t server,
local_session_t ls,
u32  opaque 
)

Definition at line 1562 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_local_session_connect_notify ( local_session_t ls)

Definition at line 1677 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_local_session_disconnect ( u32  app_or_wrk,
local_session_t ls 
)

Definition at line 1765 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_local_session_disconnect_w_index ( u32  app_or_wrk,
u32  ls_index 
)

Definition at line 1827 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void application_local_session_free ( app_worker_t app,
local_session_t ls 
)

Definition at line 1358 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static session_handle_t application_local_session_handle ( local_session_t ls)
inlinestatic

Definition at line 350 of file application.h.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static u8 application_local_session_listener_has_transport ( local_session_t ls)
inlinestatic

Definition at line 373 of file application.h.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u32 application_local_session_table ( application_t app)

Definition at line 139 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

application_t* application_lookup ( u32  api_client_index)

Definition at line 211 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

application_t* application_lookup_name ( const u8 name)

Definition at line 222 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u8* application_name_from_index ( u32  app_index)

Returns app name.

Since the name is not stored per app, we generate it on the fly. It is the caller's responsibility to free the vector

Definition at line 183 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void application_remove_proxy ( application_t app)

Definition at line 1169 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

segment_manager_properties_t* application_segment_manager_properties ( application_t app)

Definition at line 1185 of file application.c.

+ Here is the caller graph for this function:

u32 application_session_table ( application_t app,
u8  fib_proto 
)

Definition at line 124 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void application_setup_proxy ( application_t app)

Definition at line 1153 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_start_listen ( application_t app,
session_endpoint_extended_t sep_ext,
session_handle_t res 
)

Start listening local transport endpoint for requested transport.

Creates a 'dummy' stream session with state LISTENING to be used in session lookups, prior to establishing connection. Requests transport to build it's own specific listening connection.

Definition at line 717 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_start_local_listen ( application_t server,
session_endpoint_extended_t sep,
session_handle_t handle 
)

Definition at line 1410 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_stop_listen ( u32  app_index,
u32  app_wrk_index,
session_handle_t  handle 
)

Stop listening on session associated to handle.

Parameters
handlelistener handle
app_indexindex of the app owning the handle.
app_wrk_indexindex of the worker requesting the stop

Definition at line 799 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

int application_stop_local_listen ( u32  app_index,
u32  wrk_map_index,
session_handle_t  lh 
)

Clean up local session table.

If we have a listener session use it to find the port and proto. If not, the handle must be a local table handle so parse it.

Definition at line 1472 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

u8 application_use_mq_for_ctrl ( application_t app)

Definition at line 976 of file application.c.

+ Here is the caller graph for this function:

static u32 local_session_id ( local_session_t ls)
inlinestatic

Definition at line 313 of file application.h.

+ Here is the caller graph for this function:

static void local_session_parse_handle ( session_handle_t  handle,
u32 app_or_wrk_index,
u32 session_index 
)
inlinestatic

Definition at line 340 of file application.h.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static void local_session_parse_id ( u32  ls_id,
u32 app_or_wrk,
u32 session_index 
)
inlinestatic

Definition at line 333 of file application.h.

+ Here is the caller graph for this function:

void mq_send_local_session_disconnected_cb ( u32  app_or_wrk,
local_session_t ls 
)

Definition at line 531 of file session_api.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

uword unformat_application_proto ( unformat_input_t input,
va_list *  args 
)

+ Here is the caller graph for this function:

clib_error_t* vnet_app_worker_add_del ( vnet_app_worker_add_del_args_t a)

Definition at line 884 of file application.c.

+ Here is the call graph for this function:

+ Here is the caller graph for this function: