function lfds711_queue_umm_init_valid_on_current_logical_core

From liblfds.org
Revision as of 18:12, 16 February 2017 by Admin (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Source Files

└───liblfds711
    ├───inc
    │   └───liblfds711
    │           lfds711_queue_umm.h
    └───src
        └───llfds711_queue
                lfds711_queue_umm_init.c

Opaque Structures

struct lfds711_queue_umm_element;
struct lfds711_queue_umm_state;

Prototype

void lfds711_queue_init( struct lfds711_queue_umm_state *qumms,
                         struct lfds711_queue_umm_element *qumme_dummy,
                         void *user_state );

Parameters

struct lfds711_queue_umm_state *qumms

A pointer to a user-allocated LFDS711_PAL_ATOMIC_ISOLATION_IN_BYTES aligned struct lfds711_queue_umm_state. Stack declared variables will automatically be correctly aligned by the compiler, due to the information in the structure definitions; nothing has to be done. Heap allocated variables however will by no means be correctly aligned and an aligned malloc must be used.

struct lfds711_queue_umm_element *qumme_dummy

A pointer to a user-allocated LFDS711_PAL_ATOMIC_ISOLATION_IN_BYTES aligned struct lfds711_queue_umm_element. The queue data structure contains a single dummy element; this is that dummy element. Stack declared variables will automatically be correctly aligned by the compiler, due to the information in the structure definitions; nothing has to be done. Heap allocated variables however will by no means be correctly aligned and an aligned malloc must be used.

void *user_state

A pointer to void, supplied by the user, which is returned to the user in various callback functions, permitting the user to pass his own state into those functions. This argument can be NULL.

Notes

As the function name indicates, the initialization work performed on the queue state is only valid on the current logical core. To make this work valid on other logical cores, threads on other cores must call LFDS711_MISC_MAKE_VALID_ON_CURRENT_LOGICAL_CORE_INITS_COMPLETED_BEFORE_NOW_ON_ANY_OTHER_LOGICAL_CORE.

The queue requires a single dummy element to function. This element is in fact used normally - it will emerge from the queue - and so it must be possible for the user to treat it, when it does emerge, as he would do any other element.

See Also