Include

Types

ao_threshold64_t

typedef struct ao_threshold64_t ao_threshold64_t;

Represents a threshold.

ao_threshold64_wait_t

typedef struct ao_threshold64_wait_t ao_threshold64_wait_t;

Represents the waiting for a threshold match.

ao_threshold64_adjust_t

typedef uint64_t (* ao_threshold64_adjust_t)
(
    uint64_t value_old,
    void *   parameter
);

Represents a function to adjust a threshold value. The function takes the old value and an additional parameter and returns the new value.

ao_threshold64_match_t

typedef bool (* ao_threshold64_match_t)
(
    uint64_t value_old,
    uint64_t value_new,
    void *   parameter
);

Represents a function to check whether a specific threshold value is a match. The function takes both the old and the new value of a threshold as well as an additional parameter.

Structs

ao_threshold64_t

struct ao_threshold64_t
{
    ao_threshold64_adjust_t adjust;
    void *                  adjust_parameter;
    ao_threshold64_match_t  match;
    void *                  match_parameter;
    uint64_t                value;
    ao_list_t               wait;
};

ao_threshold64_wait_t

struct ao_threshold64_wait_t
{
    ao_async_t         async;
    bool      volatile result;
    ao_threshold64_t * threshold;
    ao_list_node_t     threshold_wait_node;
    uint64_t  volatile value_new;
    uint64_t  volatile value_old;
};

Functions

ao_threshold64_adjust

void ao_threshold64_adjust(ao_threshold64_t * t, ao_threshold64_adjust_t a, void * ap);

Adjusts a threshold.

ao_threshold64_add

void ao_threshold64_add(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions adds the threshold’s value and the specified value.

ao_threshold64_and

void ao_threshold64_and(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions performs a bitwise AND with the specified value.

ao_threshold64_decrement

void ao_threshold64_decrement(ao_threshold64_t * t);

Updates a threshold’s value. This functions decrements the threshold’s value.

ao_threshold64_divide

void ao_threshold64_divide(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions divides the threshold’s value by the specified value.

ao_threshold64_increment

void ao_threshold64_increment(ao_threshold64_t * t);

Updates a threshold’s value. This functions increments the threshold’s value.

ao_threshold64_max

void ao_threshold64_max(ao_threshold64_t * t);

Updates a threshold’s value. This functions sets the threshold’s value to the maximum possible value.

ao_threshold64_min

void ao_threshold64_min(ao_threshold64_t * t);

Updates a threshold’s value. This functions sets the threshold’s value to the minimum possible value, i.e. zero.

ao_threshold64_modulo

void ao_threshold64_modulo(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions sets the threshold’s value to the remainder of it divided by the specified value.

ao_threshold64_multiply

void ao_threshold64_multiply(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions multiplies the threshold’s value with the specified value.

ao_threshold64_nand

void ao_threshold64_nand(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions performs a bitwise NAND with the specified value.

ao_threshold64_nor

void ao_threshold64_nor(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions performs a bitwise NOR with the specified value.

ao_threshold64_not

void ao_threshold64_not(ao_threshold64_t * t);

Updates a threshold’s value. This functions performs a bitwise inversion on the threshold’s value.

ao_threshold64_or

void ao_threshold64_or(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions performs a bitwise OR with the specified value.

ao_threshold64_set

void ao_threshold64_set(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions sets the threshold’s value to the specified value.

ao_threshold64_subtract

void ao_threshold64_subtract(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions subtracts the specified value from the threshold’s value.

ao_threshold64_subtract_from

void ao_threshold64_subtract_from(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions subtracts the threshold’s value from the specified value.

ao_threshold64_xnor

void ao_threshold64_xnor(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions performs a bitwise XNOR with the specified value.

ao_threshold64_xor

void ao_threshold64_xor(ao_threshold64_t * t, uint64_t x);

Updates a threshold’s value. This functions performs a bitwise XOR with the specified value.

ao_threshold64_wait

ao_threshold64_wait_from

bool ao_threshold64_wait     (ao_threshold64_wait_t * w, ao_time_t timeout);
bool ao_threshold64_wait_from(ao_threshold64_wait_t * w, ao_time_t timeout, ao_time_t beginning);

Waits for a threshold match in a blocking fashion with a timeout and an optional beginning.

ao_threshold64_wait_forever

bool ao_threshold64_wait_forever(ao_threshold64_wait_t * w);

Waits for a threshold match indefinitely in a blocking fashion.

ao_threshold64_wait_try

bool ao_threshold64_wait_try(ao_threshold64_wait_t * w);

Waits for a threshold match in a non-blocking fashion.

ao_threshold64_wait_begin

ao_threshold64_wait_end

void ao_threshold64_wait_begin(ao_threshold64_wait_t * w);
void ao_threshold64_wait_end  (ao_threshold64_wait_t * w);

Begins or ends, respectively, a waiting for a threshold match.