DPDK  21.02.0
Data Structures | Typedefs | Functions
rte_compressdev_pmd.h File Reference
#include <string.h>
#include <rte_dev.h>
#include <rte_common.h>
#include "rte_compressdev.h"
#include "rte_compressdev_internal.h"

Go to the source code of this file.

Data Structures

struct  rte_compressdev_global
 
struct  rte_compressdev_ops
 

Typedefs

typedef int(* compressdev_configure_t) (struct rte_compressdev *dev, struct rte_compressdev_config *config)
 
typedef int(* compressdev_start_t) (struct rte_compressdev *dev)
 
typedef void(* compressdev_stop_t) (struct rte_compressdev *dev)
 
typedef int(* compressdev_close_t) (struct rte_compressdev *dev)
 
typedef void(* compressdev_stats_get_t) (struct rte_compressdev *dev, struct rte_compressdev_stats *stats)
 
typedef void(* compressdev_stats_reset_t) (struct rte_compressdev *dev)
 
typedef void(* compressdev_info_get_t) (struct rte_compressdev *dev, struct rte_compressdev_info *dev_info)
 
typedef int(* compressdev_queue_pair_setup_t) (struct rte_compressdev *dev, uint16_t qp_id, uint32_t max_inflight_ops, int socket_id)
 
typedef int(* compressdev_queue_pair_release_t) (struct rte_compressdev *dev, uint16_t qp_id)
 
typedef int(* compressdev_stream_create_t) (struct rte_compressdev *dev, const struct rte_comp_xform *xform, void **stream)
 
typedef int(* compressdev_stream_free_t) (struct rte_compressdev *dev, void *stream)
 
typedef int(* compressdev_private_xform_create_t) (struct rte_compressdev *dev, const struct rte_comp_xform *xform, void **private_xform)
 
typedef int(* compressdev_private_xform_free_t) (struct rte_compressdev *dev, void *private_xform)
 

Functions

__rte_experimental struct rte_compressdevrte_compressdev_pmd_get_named_dev (const char *name)
 

Detailed Description

RTE comp PMD APIs

Note
These APIs are for comp PMDs only and user applications should not call them directly.

Definition in file rte_compressdev_pmd.h.

Typedef Documentation

typedef int(* compressdev_configure_t) (struct rte_compressdev *dev, struct rte_compressdev_config *config)

Definitions of all functions exported by a driver through the the generic structure of type comp_dev_ops supplied in the rte_compressdev structure associated with a device. Function used to configure device.

Parameters
devCompress device
configCompress device configurations
Returns
Returns 0 on success

Definition at line 82 of file rte_compressdev_pmd.h.

typedef int(* compressdev_start_t) (struct rte_compressdev *dev)

Function used to start a configured device.

Parameters
devCompress device
Returns
Returns 0 on success

Definition at line 93 of file rte_compressdev_pmd.h.

typedef void(* compressdev_stop_t) (struct rte_compressdev *dev)

Function used to stop a configured device.

Parameters
devCompress device

Definition at line 101 of file rte_compressdev_pmd.h.

typedef int(* compressdev_close_t) (struct rte_compressdev *dev)

Function used to close a configured device.

Parameters
devCompress device
Returns
  • 0 on success.
  • EAGAIN if can't close as device is busy

Definition at line 112 of file rte_compressdev_pmd.h.

typedef void(* compressdev_stats_get_t) (struct rte_compressdev *dev, struct rte_compressdev_stats *stats)

Function used to get statistics of a device.

Parameters
devCompress device
statsCompress device stats to populate

Definition at line 123 of file rte_compressdev_pmd.h.

typedef void(* compressdev_stats_reset_t) (struct rte_compressdev *dev)

Function used to reset statistics of a device.

Parameters
devCompress device

Definition at line 133 of file rte_compressdev_pmd.h.

typedef void(* compressdev_info_get_t) (struct rte_compressdev *dev, struct rte_compressdev_info *dev_info)

Function used to get specific information of a device.

Parameters
devCompress device
dev_infoCompress device information to populate

Definition at line 144 of file rte_compressdev_pmd.h.

typedef int(* compressdev_queue_pair_setup_t) (struct rte_compressdev *dev, uint16_t qp_id, uint32_t max_inflight_ops, int socket_id)

Setup a queue pair for a device.

Parameters
devCompress device
qp_idQueue pair identifier
max_inflight_opsMax inflight ops which qp must accommodate
socket_idSocket identifier
Returns
Returns 0 on success.

Definition at line 161 of file rte_compressdev_pmd.h.

typedef int(* compressdev_queue_pair_release_t) (struct rte_compressdev *dev, uint16_t qp_id)

Release memory resources allocated by given queue pair.

Parameters
devCompress device
qp_idQueue pair identifier
Returns
  • 0 on success.
  • EAGAIN if can't close as device is busy

Definition at line 175 of file rte_compressdev_pmd.h.

typedef int(* compressdev_stream_create_t) (struct rte_compressdev *dev, const struct rte_comp_xform *xform, void **stream)

Create driver private stream data.

Parameters
devCompressdev device
xformxform data
streamptr where handle of pmd's private stream data should be stored
Returns
  • Returns 0 if private stream structure has been created successfully.
  • Returns -EINVAL if input parameters are invalid.
  • Returns -ENOTSUP if comp device does not support STATEFUL operations.
  • Returns -ENOTSUP if comp device does not support the comp transform.
  • Returns -ENOMEM if the private stream could not be allocated.

Definition at line 194 of file rte_compressdev_pmd.h.

typedef int(* compressdev_stream_free_t) (struct rte_compressdev *dev, void *stream)

Free driver private stream data.

Parameters
devCompressdev device
streamhandle of pmd's private stream data
Returns
  • 0 if successful
  • <0 in error cases
  • Returns -EINVAL if input parameters are invalid.
  • Returns -ENOTSUP if comp device does not support STATEFUL operations.
  • Returns -EBUSY if can't free stream as there are inflight operations

Definition at line 211 of file rte_compressdev_pmd.h.

typedef int(* compressdev_private_xform_create_t) (struct rte_compressdev *dev, const struct rte_comp_xform *xform, void **private_xform)

Create driver private_xform data.

Parameters
devCompressdev device
xformxform data
private_xformptr where handle of pmd's private_xform data should be stored
Returns
  • if successful returns 0 and valid private_xform handle
  • <0 in error cases
  • Returns -EINVAL if input parameters are invalid.
  • Returns -ENOTSUP if comp device does not support the comp transform.
  • Returns -ENOMEM if the private_xform could not be allocated.

Definition at line 231 of file rte_compressdev_pmd.h.

typedef int(* compressdev_private_xform_free_t) (struct rte_compressdev *dev, void *private_xform)

Free driver private_xform data.

Parameters
devCompressdev device
private_xformhandle of pmd's private_xform data
Returns
  • 0 if successful
  • <0 in error cases
  • Returns -EINVAL if input parameters are invalid.
  • Returns -EBUSY if can't free private_xform due to inflight operations

Definition at line 247 of file rte_compressdev_pmd.h.

Function Documentation

__rte_experimental struct rte_compressdev* rte_compressdev_pmd_get_named_dev ( const char *  name)

Get the rte_compressdev structure device pointer for the named device.

Parameters
nameCompress device name
Returns