DPDK  19.05.0
rte_service.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2017 Intel Corporation
3  */
4 
5 #ifndef _RTE_SERVICE_H_
6 #define _RTE_SERVICE_H_
7 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif
29 
30 #include<stdio.h>
31 #include <stdint.h>
32 #include <sys/queue.h>
33 
34 #include <rte_config.h>
35 #include <rte_lcore.h>
36 
37 #define RTE_SERVICE_NAME_MAX 32
38 
39 /* Capabilities of a service.
40  *
41  * Use the *rte_service_probe_capability* function to check if a service is
42  * capable of a specific capability.
43  */
47 #define RTE_SERVICE_CAP_MT_SAFE (1 << 0)
48 
57 uint32_t rte_service_get_count(void);
58 
81 int32_t rte_service_get_by_name(const char *name, uint32_t *service_id);
82 
89 const char *rte_service_get_name(uint32_t id);
90 
99 int32_t rte_service_probe_capability(uint32_t id, uint32_t capability);
100 
120 int32_t rte_service_map_lcore_set(uint32_t service_id, uint32_t lcore,
121  uint32_t enable);
122 
133 int32_t rte_service_map_lcore_get(uint32_t service_id, uint32_t lcore);
134 
147 int32_t rte_service_runstate_set(uint32_t id, uint32_t runstate);
148 
162 int32_t rte_service_runstate_get(uint32_t id);
163 
181 int32_t __rte_experimental
182 rte_service_may_be_active(uint32_t id);
183 
195 int32_t rte_service_set_runstate_mapped_check(uint32_t id, int32_t enable);
196 
230 int32_t rte_service_run_iter_on_app_lcore(uint32_t id,
231  uint32_t serialize_multithread_unsafe);
232 
245 int32_t rte_service_lcore_start(uint32_t lcore_id);
246 
261 int32_t rte_service_lcore_stop(uint32_t lcore_id);
262 
274 int32_t rte_service_lcore_add(uint32_t lcore);
275 
285 int32_t rte_service_lcore_del(uint32_t lcore);
286 
299 int32_t rte_service_lcore_count(void);
300 
308 int32_t rte_service_lcore_reset_all(void);
309 
319 int32_t rte_service_set_stats_enable(uint32_t id, int32_t enable);
320 
337 int32_t rte_service_lcore_list(uint32_t array[], uint32_t n);
338 
347 int32_t rte_service_lcore_count_services(uint32_t lcore);
348 
356 int32_t rte_service_dump(FILE *f, uint32_t id);
357 
361 #define RTE_SERVICE_ATTR_CYCLES 0
362 
366 #define RTE_SERVICE_ATTR_CALL_COUNT 1
367 
374 int32_t rte_service_attr_get(uint32_t id, uint32_t attr_id,
375  uint64_t *attr_value);
376 
384 int32_t rte_service_attr_reset_all(uint32_t id);
385 
389 #define RTE_SERVICE_LCORE_ATTR_LOOPS 0
390 
404 int32_t __rte_experimental
405 rte_service_lcore_attr_get(uint32_t lcore, uint32_t attr_id,
406  uint64_t *attr_value);
407 
419 int32_t __rte_experimental
420 rte_service_lcore_attr_reset_all(uint32_t lcore);
421 
422 #ifdef __cplusplus
423 }
424 #endif
425 
426 
427 #endif /* _RTE_SERVICE_H_ */