enum lfds711_list_aso_query

From liblfds.org
Revision as of 18:11, 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 File

└───liblfds711
    └───inc
        └───liblfds711
                lfds711_list_addonly_singlylinked_ordered.h

Enum

enum lfds711_list_aso_query
{
  LFDS711_LIST_ASO_QUERY_GET_POTENTIALLY_INACCURATE_COUNT,
  LFDS711_LIST_ASO_QUERY_SINGLETHREADED_VALIDATE
};

Values

LFDS711_LIST_ASO_QUERY_GET_POTENTIALLY_INACCURATE_COUNT

Counts the number of elements in the list. This query is and is only safe if performed single-threaded, i.e. that no insert operations occur while the count operation is executing. If insert operations occur, it is not merely the case that the count could be wrong - in theory, it could be possible for the count to enter an infinite loop or access random addresses in memory. Don't do this.

LFDS711_LIST_ASO_QUERY_SINGLETHREADED_VALIDATE

Validates the list. This is done by checking there are no loops. Additionally, if given as input a lfds711_misc_validation_info, which indicates an expected range of the number of elements in the list, counts the number of elements in the list and checks they fall within the expected range. As with count, both the loop check and the element count (which is in fact performed by issuing the LFDS711_LIST_ASO_QUERY_GET_POTENTIALLY_INACCURATE_COUNT query) can in theory enter an infinite loop if insert operations occur while the validation operation is executing. You were warned.

Notes

This enum is used by the list query function, lfds711_list_aso_query.

See Also