1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2016-2017 Cavium, Inc
3 */
4
5 #ifndef _RTE_EVENTDEV_PMD_VDEV_H_
6 #define _RTE_EVENTDEV_PMD_VDEV_H_
7
8 /** @file
9 * RTE Eventdev VDEV PMD APIs
10 *
11 * @note
12 * These API are from event VDEV PMD only and user applications should not call
13 * them directly.
14 */
15
16 #ifdef __cplusplus
17 extern "C" {
18 #endif
19
20 #include <string.h>
21
22 #include <rte_config.h>
23 #include <rte_debug.h>
24 #include <rte_eal.h>
25 #include <rte_bus_vdev.h>
26
27 #include "rte_eventdev_pmd.h"
28
29 /**
30 * @internal
31 * Creates a new virtual event device and returns the pointer to that device.
32 *
33 * @param name
34 * PMD type name
35 * @param dev_private_size
36 * Size of event PMDs private data
37 * @param socket_id
38 * Socket to allocate resources on.
39 *
40 * @return
41 * - Eventdev pointer if device is successfully created.
42 * - NULL if device cannot be created.
43 */
44 static inline struct rte_eventdev *
rte_event_pmd_vdev_init(const char * name,size_t dev_private_size,int socket_id)45 rte_event_pmd_vdev_init(const char *name, size_t dev_private_size,
46 int socket_id)
47 {
48
49 struct rte_eventdev *eventdev;
50
51 /* Allocate device structure */
52 eventdev = rte_event_pmd_allocate(name, socket_id);
53 if (eventdev == NULL)
54 return NULL;
55
56 /* Allocate private device structure */
57 if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
58 eventdev->data->dev_private =
59 rte_zmalloc_socket("eventdev device private",
60 dev_private_size,
61 RTE_CACHE_LINE_SIZE,
62 socket_id);
63
64 if (eventdev->data->dev_private == NULL)
65 rte_panic("Cannot allocate memzone for private device"
66 " data");
67 }
68
69 return eventdev;
70 }
71
72 /**
73 * @internal
74 * Destroy the given virtual event device
75 *
76 * @param name
77 * PMD type name
78 * @return
79 * - 0 on success, negative on error
80 */
81 static inline int
rte_event_pmd_vdev_uninit(const char * name)82 rte_event_pmd_vdev_uninit(const char *name)
83 {
84 int ret;
85 struct rte_eventdev *eventdev;
86
87 if (name == NULL)
88 return -EINVAL;
89
90 eventdev = rte_event_pmd_get_named_dev(name);
91 if (eventdev == NULL)
92 return -ENODEV;
93
94 ret = rte_event_dev_close(eventdev->data->dev_id);
95 if (ret < 0)
96 return ret;
97
98 /* Free the event device */
99 rte_event_pmd_release(eventdev);
100
101 return 0;
102 }
103
104 #ifdef __cplusplus
105 }
106 #endif
107
108 #endif /* _RTE_EVENTDEV_PMD_VDEV_H_ */
109