18218713bf
Putting a '__attribute__((deprecated))' in the middle of a function
prototype does not result in the expected result with gcc (while clang
is fine with this syntax).
$ cat deprecated.c
void * __attribute__((deprecated)) incorrect() { return 0; }
__attribute__((deprecated)) void *correct(void) { return 0; }
int main(int argc, char *argv[]) { incorrect(); correct(); return 0; }
$ gcc -o deprecated.o -c deprecated.c
deprecated.c: In function ‘main’:
deprecated.c:3:1: warning: ‘correct’ is deprecated (declared at
deprecated.c:2) [-Wdeprecated-declarations]
int main(int argc, char *argv[]) { incorrect(); correct(); return 0; }
^
Move the tag on a separate line and make it the first thing of function
prototypes.
This is not perfect but we will trust reviewers to catch the other not
so easy to detect patterns.
sed -i \
-e '/^\([^#].*\)\?__rte_experimental */{' \
-e 's//\1/; s/ *$//; i\' \
-e __rte_experimental \
-e '/^$/d}' \
$(git grep -l __rte_experimental -- '*.h')
Special mention for rte_mbuf_data_addr_default():
There is either a bug or a (not yet understood) issue with gcc.
gcc won't drop this inline when unused and rte_mbuf_data_addr_default()
calls rte_mbuf_buf_addr() which itself is experimental.
This results in a build warning when not accepting experimental apis
from sources just including rte_mbuf.h.
For this specific case, we hide the call to rte_mbuf_buf_addr() under
the ALLOW_EXPERIMENTAL_API flag.
Signed-off-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
Signed-off-by: David Marchand <david.marchand@redhat.com>
118 lines
3.4 KiB
C
118 lines
3.4 KiB
C
/* SPDX-License-Identifier: BSD-3-Clause
|
|
* Copyright(c) 2017-2018 Intel Corporation
|
|
*/
|
|
|
|
#ifndef _VHOST_CRYPTO_H_
|
|
#define _VHOST_CRYPTO_H_
|
|
|
|
#define VHOST_CRYPTO_MBUF_POOL_SIZE (8192)
|
|
#define VHOST_CRYPTO_MAX_BURST_SIZE (64)
|
|
#define VHOST_CRYPTO_SESSION_MAP_ENTRIES (1024) /**< Max nb sessions */
|
|
/** max nb virtual queues in a burst for finalizing*/
|
|
#define VIRTIO_CRYPTO_MAX_NUM_BURST_VQS (64)
|
|
|
|
enum rte_vhost_crypto_zero_copy {
|
|
RTE_VHOST_CRYPTO_ZERO_COPY_DISABLE = 0,
|
|
RTE_VHOST_CRYPTO_ZERO_COPY_ENABLE = 1,
|
|
RTE_VHOST_CRYPTO_MAX_ZERO_COPY_OPTIONS
|
|
};
|
|
|
|
/**
|
|
* Create Vhost-crypto instance
|
|
*
|
|
* @param vid
|
|
* The identifier of the vhost device.
|
|
* @param cryptodev_id
|
|
* The identifier of DPDK Cryptodev, the same cryptodev_id can be assigned to
|
|
* multiple Vhost-crypto devices.
|
|
* @param sess_pool
|
|
* The pointer to the created cryptodev session pool.
|
|
* @param sess_priv_pool
|
|
* The pointer to the created cryptodev session private data mempool.
|
|
* @param socket_id
|
|
* NUMA Socket ID to allocate resources on. *
|
|
* @return
|
|
* 0 if the Vhost Crypto Instance is created successfully.
|
|
* Negative integer if otherwise
|
|
*/
|
|
__rte_experimental
|
|
int
|
|
rte_vhost_crypto_create(int vid, uint8_t cryptodev_id,
|
|
struct rte_mempool *sess_pool,
|
|
struct rte_mempool *sess_priv_pool,
|
|
int socket_id);
|
|
|
|
/**
|
|
* Free the Vhost-crypto instance
|
|
*
|
|
* @param vid
|
|
* The identifier of the vhost device.
|
|
* @return
|
|
* 0 if the Vhost Crypto Instance is created successfully.
|
|
* Negative integer if otherwise.
|
|
*/
|
|
__rte_experimental
|
|
int
|
|
rte_vhost_crypto_free(int vid);
|
|
|
|
/**
|
|
* Enable or disable zero copy feature
|
|
*
|
|
* @param vid
|
|
* The identifier of the vhost device.
|
|
* @param option
|
|
* Flag of zero copy feature.
|
|
* @return
|
|
* 0 if completed successfully.
|
|
* Negative integer if otherwise.
|
|
*/
|
|
__rte_experimental
|
|
int
|
|
rte_vhost_crypto_set_zero_copy(int vid, enum rte_vhost_crypto_zero_copy option);
|
|
|
|
/**
|
|
* Fetch a number of vring descriptors from virt-queue and translate to DPDK
|
|
* crypto operations. After this function is executed, the user can enqueue
|
|
* the processed ops to the target cryptodev.
|
|
*
|
|
* @param vid
|
|
* The identifier of the vhost device.
|
|
* @param qid
|
|
* Virtio queue index.
|
|
* @param ops
|
|
* The address of an array of pointers to *rte_crypto_op* structures that must
|
|
* be large enough to store *nb_ops* pointers in it.
|
|
* @param nb_ops
|
|
* The maximum number of operations to be fetched and translated.
|
|
* @return
|
|
* The number of fetched and processed vhost crypto request operations.
|
|
*/
|
|
__rte_experimental
|
|
uint16_t
|
|
rte_vhost_crypto_fetch_requests(int vid, uint32_t qid,
|
|
struct rte_crypto_op **ops, uint16_t nb_ops);
|
|
/**
|
|
* Finalize the dequeued crypto ops. After the translated crypto ops are
|
|
* dequeued from the cryptodev, this function shall be called to write the
|
|
* processed data back to the vring descriptor (if no-copy is turned off).
|
|
*
|
|
* @param ops
|
|
* The address of an array of *rte_crypto_op* structure that was dequeued
|
|
* from cryptodev.
|
|
* @param nb_ops
|
|
* The number of operations contained in the array.
|
|
* @callfds
|
|
* The callfd number(s) contained in this burst, this shall be an array with
|
|
* no less than VIRTIO_CRYPTO_MAX_NUM_BURST_VQS elements.
|
|
* @nb_callfds
|
|
* The number of call_fd numbers exist in the callfds.
|
|
* @return
|
|
* The number of ops processed.
|
|
*/
|
|
__rte_experimental
|
|
uint16_t
|
|
rte_vhost_crypto_finalize_requests(struct rte_crypto_op **ops,
|
|
uint16_t nb_ops, int *callfds, uint16_t *nb_callfds);
|
|
|
|
#endif /**< _VHOST_CRYPTO_H_ */
|