Subrutina nx_rel_excl_access()

Editar en línea

Finalidad

Libera un número específico de créditos de calidad de servicio (QoS) reservados.

Sintaxis

#include <sys/nx.h>
int nx_rel_excl_access(nx_accel_type_t accel_type,
                       uint32_t        flags,
                       int             number_of_credits,
                       nx_unit_id_t    unit_id);
Nota: Actualmente, NX_GZIP_TYPE es el único tipo de acelerador soportado. Debe especificar NX_GZIP_TYPE en el parámetro accel_type.

Descripción

Una aplicación privilegiada puede utilizar esta subrutina para liberar un número específico de créditos QoS que la aplicación ha reservado para uso exclusivo. Los argumentos son los mismos que la subrutina nx_get_excl_access.

De forma similar a la subrutina nx_get_excl_access, se pueden utilizar los valores especiales NX_ALL_CREDITS y NX_ANY_UNIT para la subrutina nx_rel_excl_access.

Nota: La subrutina nx_rel_excl_access libera los créditos aunque estén en uso, es decir, incluso cuando la aplicación ejecuta un trabajo en el acelerador. En este caso, se detiene la operación correspondiente.

Valores de retorno

0
Indica el éxito. Se liberan el número solicitado de créditos (o todos los créditos si se especifica el valor NX_ALL_CREDITS ).
-1
Se ha detectado un error. La variable errno se establece para indicar el tipo de error:
  • ENOTSUP: La partición lógica no puede acceder a un acelerador de anidamiento.
  • EPERM: La llamada a la aplicación no tiene el nivel de privilegio correcto.
  • EINVAL: distintivos no válidos, número de créditos no válido o ID de unidad no válido.