function libtest_misc_determine_erg

Jump to navigation Jump to search

Source Files

└── test_and_benchmark
    └── libtest
        ├── inc
        │   └── libtest
        │       └── libtest_misc.h
        └── src
            └── libshared_misc
                └── libtest_misc_determine_erg.c


enum libtest_determine_erg_result

Opaque Structures

struct libshared_memory_state;


void libtest_misc_determine_erg( struct libshared_memory_state *ms,
                                 lfds710_pal_uint_t (*count_array)[10],
                                 enum libtest_misc_determine_erg_result *der,
                                 lfds710_pal_uint_t *erg_length_in_bytes );


struct libshared_memory_state *ms

A pointer to an initialized struct libshared_memory_state. See Notes for recommended amounts of store.

lfds710_pal_uint_t (*count_array)[10]

A pointer to an array of ten lfds710_pal_uint_t. The elements in this array will be set to the number of successful operations for ERG sizes 4 to 2048 bytes, where index 0 contains the count for 4 bytes and index 9 the count for 2048 bytes. These results are made available to the user because the approach used is not foolproof, and so manual inspection of the results may be necessary or useful.

enum libtest_misc_determine_erg_result *der

The attempt to determine the ERG length may succeed or it may fail and failure can occur for a range of reasons. This argument is set to the outcome of the attempt.

lfds710_pal_uint_t *erg_length_in_bytes

If der is set to LIBTEST_MISC_DETERMINE_ERG_RESULT_SUCCESS, then the lfds710_pal_uint_t pointed to by erg_length_in_bytes is set to the ERG length.


This function is only relevant to ARM and POWERPC, and currently is only implemented for ARM32.

Please read Exclusive Reservation Granule (ARM, POWERPC) for an explanation of the concept of ERG and why it is EXTREMELY IMPORTANT to get the correct length and to configure the liblfds710 porting abtraction layer with that length.


See Also