Difference between pages "r7.1.1:Enum libtest test id" and "r7.1.1:Function libbenchmark misc pal helper add logical processor node to topology tree"

From liblfds.org
(Difference between pages)
Jump to navigation Jump to search
m (1 revision imported)
 
m (1 revision imported)
 
Line 1: Line 1:
{{DISPLAYTITLE:enum libtest_test_id}}
{{DISPLAYTITLE:function libbenchmark_misc_pal_helper_new_topology_node}}
==Source File==
==Source Files==
  └── test_and_benchmark
  └───test_and_benchmark
     └── libtest
     └───libbenchmark
         └── inc
         ├───inc
             └── libtest
        │  └───libbenchmark
                └── libtest_tests.h
        │          libbenchmark_porting_abstraction_layer.h
        └───src
             └───libbenchmark_misc
                    libbenchmark_misc_pal_helpers.c


==Opaque Structures==
struct [[r7.1.1:struct libbenchmark_topology_state|libbenchmark_topology_state]];


==Enum==
==Prototype==
  enum libtest_test_id
  void libbenchmark_misc_pal_helper_add_logical_processor_node_to_topology_tree( struct libbenchmark_topology_state *ts,
{
                                                                                lfds711_pal_uint_t logical_processor_number,
  LIBTEST_TEST_ID_PORTING_ABSTRACTION_LAYER_ADD,
                                                                                enum flag windows_processor_group_inuse_flag,
  LIBTEST_TEST_ID_PORTING_ABSTRACTION_LAYER_CAS,
                                                                                lfds711_pal_uint_t windows_processor_group_number );
  LIBTEST_TEST_ID_PORTING_ABSTRACTION_LAYER_DCAS,
  LIBTEST_TEST_ID_PORTING_ABSTRACTION_LAYER_EXCHANGE,
  LIBTEST_TEST_ID_BTREE_ADDONLY_UNBALANCED_ALIGNMENT,
  LIBTEST_TEST_ID_BTREE_ADDONLY_UNBALANCED_RANDOM_ADDS_FAIL,
  LIBTEST_TEST_ID_BTREE_ADDONLY_UNBALANCED_RANDOM_ADDS_FAIL_AND_OVERWRITE,
  LIBTEST_TEST_ID_BTREE_ADDONLY_UNBALANCED_RANDOM_ADDS_OVERWRITE,
  LIBTEST_TEST_ID_FREELIST_ALIGNMENT,
  LIBTEST_TEST_ID_FREELIST_EA_POPPING,
  LIBTEST_TEST_ID_FREELIST_EA_POPPING_AND_PUSHING,
  LIBTEST_TEST_ID_FREELIST_EA_PUSHING,
  LIBTEST_TEST_ID_FREELIST_EA_RAPID_POPPING_AND_PUSHING,
  LIBTEST_TEST_ID_FREELIST_WITHOUT_EA_POPPING,
  LIBTEST_TEST_ID_FREELIST_WITHOUT_EA_POPPING_AND_PUSHING,
  LIBTEST_TEST_ID_FREELIST_WITHOUT_EA_PUSHING,
  LIBTEST_TEST_ID_FREELIST_WITHOUT_EA_RAPID_POPPING_AND_PUSHING,
  LIBTEST_TEST_ID_HASH_ADDONLY_ALIGNMENT,
  LIBTEST_TEST_ID_HASH_ADDONLY_FAIL_AND_OVERWRITE,
  LIBTEST_TEST_ID_HASH_ADDONLY_RANDOM_ADDS_FAIL,
  LIBTEST_TEST_ID_HASH_ADDONLY_RANDOM_ADDS_OVERWRITE,
  LIBTEST_TEST_ID_HASH_ADDONLY_ITERATE,
  LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_ORDERED_ALIGNMENT,
  LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_ORDERED_NEW_ORDERED,
  LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_ORDERED_NEW_ORDERED_WITH_CURSOR,
  LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_UNORDERED_ALIGNMENT,
  LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_UNORDERED_NEW_START,
  LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_UNORDERED_NEW_END,
  LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_UNORDERED_NEW_AFTER,
  LIBTEST_TEST_ID_QUEUE_UMM_ALIGNMENT,
  LIBTEST_TEST_ID_QUEUE_UMM_DEQUEUING,
  LIBTEST_TEST_ID_QUEUE_UMM_ENQUEUING,
  LIBTEST_TEST_ID_QUEUE_UMM_ENQUEUING_AND_DEQUEUING,
  LIBTEST_TEST_ID_QUEUE_UMM_ENQUEUING_WITH_MALLOC_AND_DEQUEUING_WITH_FREE,
  LIBTEST_TEST_ID_QUEUE_UMM_RAPID_ENQUEUING_AND_DEQUEUING,
  LIBTEST_TEST_ID_QUEUE_BMM_ALIGNMENT,
  LIBTEST_TEST_ID_QUEUE_BMM_COUNT,
  LIBTEST_TEST_ID_QUEUE_BMM_ENQUEUING,
  LIBTEST_TEST_ID_QUEUE_BMM_DEQUEUING,
  LIBTEST_TEST_ID_QUEUE_BMM_ENQUEUING_AND_DEQUEUING,
  LIBTEST_TEST_ID_QUEUE_BMM_RAPID_ENQUEUING_AND_DEQUEUING,
  LIBTEST_TEST_ID_QUEUE_BSS_DEQUEUING,
  LIBTEST_TEST_ID_QUEUE_BSS_ENQUEUING,
  LIBTEST_TEST_ID_QUEUE_BSS_ENQUEUING_AND_DEQUEUING,
  LIBTEST_TEST_ID_RINGBUFFER_READING,
  LIBTEST_TEST_ID_RINGBUFFER_WRITING,
  LIBTEST_TEST_ID_RINGBUFFER_READING_AND_WRITING,
  LIBTEST_TEST_ID_STACK_ALIGNMENT,
  LIBTEST_TEST_ID_STACK_POPPING,
  LIBTEST_TEST_ID_STACK_POPPING_AND_PUSHING,
  LIBTEST_TEST_ID_STACK_PUSHING,
  LIBTEST_TEST_ID_STACK_RAPID_POPPING_AND_PUSHING,
  LIBTEST_TEST_ID_COUNT
};


==Values==
==Parameters==
''LIBTEST_TEST_ID_PORTING_ABSTRACTION_LAYER_ADD''
''struct libbenchmark_topology_state *ts''
: Atomic add abstraction test.
: A pointer a ''struct libbenchmark_topology'' obtained from ''libbenchmark_pal_populate_topology''.


''LIBTEST_TEST_ID_PORTING_ABSTRACTION_LAYER_CAS''
''lfds711_pal_uint_t logical_processor_number''
: Atomic CAS abstraction test.
: The logical processor number of the logical processor to add to the topology tree pointed to by ''ts''.


''LIBTEST_TEST_ID_PORTING_ABSTRACTION_LAYER_DCAS''
''enum flag windows_processor_group_inuse_flag''
: Atomic DWCAS abstraction test.
: An ''enum flag'' which indicates whether or not the ''windows_processor_group_number'' argument contains a valid value (for that field is only meaningful on Windows 7 and greater).


''LIBTEST_TEST_ID_PORTING_ABSTRACTION_LAYER_EXCHANGE''
''lfds711_pal_uint_t windows_processor_group_number''
: Atomic exchange abstraction test.
: The Windows processor group number of the logical processor to add to the topology tree pointed to by ''ts''.  This value is only meaningful on Windows 7 and greater.  It will only be used if the ''windows_processor_group_inuse_flag'' is set to ''RAISED'', and so if not used, can be set to any value.  Zero is as good a choice as any other.


''LIBTEST_TEST_ID_BTREE_ADDONLY_UNBALANCED_ALIGNMENT''
==Return Value==
: btree (addonly, unbalanced) structs member alignments test.
No return value.


''LIBTEST_TEST_ID_BTREE_ADDONLY_UNBALANCED_RANDOM_ADDS_FAIL''
==Example==
:
 
''LIBTEST_TEST_ID_BTREE_ADDONLY_UNBALANCED_RANDOM_ADDS_FAIL_AND_OVERWRITE''
:
 
''LIBTEST_TEST_ID_BTREE_ADDONLY_UNBALANCED_RANDOM_ADDS_OVERWRITE''
:
 
''LIBTEST_TEST_ID_FREELIST_ALIGNMENT''
: freelist structs member alignments test.
 
''LIBTEST_TEST_ID_FREELIST_EA_POPPING''
:
 
''LIBTEST_TEST_ID_FREELIST_EA_POPPING_AND_PUSHING''
:
 
''LIBTEST_TEST_ID_FREELIST_EA_PUSHING''
:
 
''LIBTEST_TEST_ID_FREELIST_EA_RAPID_POPPING_AND_PUSHING''
:
 
''LIBTEST_TEST_ID_FREELIST_WITHOUT_EA_POPPING''
:
 
''LIBTEST_TEST_ID_FREELIST_WITHOUT_EA_POPPING_AND_PUSHING''
:
 
''LIBTEST_TEST_ID_FREELIST_WITHOUT_EA_PUSHING''
:
 
''LIBTEST_TEST_ID_FREELIST_WITHOUT_EA_RAPID_POPPING_AND_PUSHING''
:
 
''LIBTEST_TEST_ID_HASH_ADDONLY_ALIGNMENT''
: hash (addonly) structs member alignments test.
 
''LIBTEST_TEST_ID_HASH_ADDONLY_FAIL_AND_OVERWRITE''
:
 
''LIBTEST_TEST_ID_HASH_ADDONLY_RANDOM_ADDS_FAIL''
:
 
''LIBTEST_TEST_ID_HASH_ADDONLY_RANDOM_ADDS_OVERWRITE''
:
 
''LIBTEST_TEST_ID_HASH_ADDONLY_ITERATE''
:
 
''LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_ORDERED_ALIGNMENT''
: list (addonly, singlylinked, ordered) structs member alignments test.
 
''LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_ORDERED_NEW_ORDERED''
:
 
''LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_ORDERED_NEW_ORDERED_WITH_CURSOR''
:
 
''LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_UNORDERED_ALIGNMENT''
: list (addonly, singlylinked, unordered) structs member alignments test.
 
''LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_UNORDERED_NEW_START''
:
 
''LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_UNORDERED_NEW_END''
:
 
''LIBTEST_TEST_ID_LIST_ADDONLY_SINGLYLINKED_UNORDERED_NEW_AFTER''
:
 
''LIBTEST_TEST_ID_QUEUE_UMM_ALIGNMENT''
: queue (unbounded, many producer, many consumer) structs member alignments test.
 
''LIBTEST_TEST_ID_QUEUE_UMM_DEQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_UMM_ENQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_UMM_ENQUEUING_AND_DEQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_UMM_ENQUEUING_WITH_MALLOC_AND_DEQUEUING_WITH_FREE''
:
 
''LIBTEST_TEST_ID_QUEUE_UMM_RAPID_ENQUEUING_AND_DEQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_BMM_ALIGNMENT''
: queue (bounded, many producer, many consumer) structs member alignments test.
 
''LIBTEST_TEST_ID_QUEUE_BMM_COUNT''
:
 
''LIBTEST_TEST_ID_QUEUE_BMM_ENQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_BMM_DEQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_BMM_ENQUEUING_AND_DEQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_BMM_RAPID_ENQUEUING_AND_DEQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_BSS_DEQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_BSS_ENQUEUING''
:
 
''LIBTEST_TEST_ID_QUEUE_BSS_ENQUEUING_AND_DEQUEUING''
:
 
''LIBTEST_TEST_ID_RINGBUFFER_READING''
:
 
''LIBTEST_TEST_ID_RINGBUFFER_WRITING''
:
 
''LIBTEST_TEST_ID_RINGBUFFER_READING_AND_WRITING''
:
 
''LIBTEST_TEST_ID_STACK_ALIGNMENT''
: stack structs member alignments test.
 
''LIBTEST_TEST_ID_STACK_POPPING''
:
 
''LIBTEST_TEST_ID_STACK_POPPING_AND_PUSHING''
:
 
''LIBTEST_TEST_ID_STACK_PUSHING''
:
 
''LIBTEST_TEST_ID_STACK_RAPID_POPPING_AND_PUSHING''
:
 
''LIBTEST_TEST_ID_COUNT''
: The number of members in this enum.


==Notes==
==Notes==
This enum is used by ''libtest'' to uniquely identify tests.
This helper function is used by ''libbenchmark_pal_populate_topology'' to add a logical processor node to the topology tree.


==See Also==
==See Also==
* [[r7.1.1:Release_7.1.1_Documentation|Release 7.1.1 Documentation]]
* [[r7.1.1:Porting Guide (libbenchmark)|Porting Guide (libbenchmark)]]
* ''[[r7.1.1:function libbenchmark_pal_populate_topology|libbenchmark_pal_populate_topology]]''

Latest revision as of 20:16, 17 February 2017

Source Files

└───test_and_benchmark
    └───libbenchmark
        ├───inc
        │   └───libbenchmark
        │           libbenchmark_porting_abstraction_layer.h
        └───src
            └───libbenchmark_misc
                    libbenchmark_misc_pal_helpers.c

Opaque Structures

struct libbenchmark_topology_state;

Prototype

void libbenchmark_misc_pal_helper_add_logical_processor_node_to_topology_tree( struct libbenchmark_topology_state *ts,
                                                                               lfds711_pal_uint_t logical_processor_number,
                                                                               enum flag windows_processor_group_inuse_flag,
                                                                               lfds711_pal_uint_t windows_processor_group_number );

Parameters

struct libbenchmark_topology_state *ts

A pointer a struct libbenchmark_topology obtained from libbenchmark_pal_populate_topology.

lfds711_pal_uint_t logical_processor_number

The logical processor number of the logical processor to add to the topology tree pointed to by ts.

enum flag windows_processor_group_inuse_flag

An enum flag which indicates whether or not the windows_processor_group_number argument contains a valid value (for that field is only meaningful on Windows 7 and greater).

lfds711_pal_uint_t windows_processor_group_number

The Windows processor group number of the logical processor to add to the topology tree pointed to by ts. This value is only meaningful on Windows 7 and greater. It will only be used if the windows_processor_group_inuse_flag is set to RAISED, and so if not used, can be set to any value. Zero is as good a choice as any other.

Return Value

No return value.

Example

Notes

This helper function is used by libbenchmark_pal_populate_topology to add a logical processor node to the topology tree.

See Also

Retrieved from ‘https://www.liblfds.org/mediawiki/index.php?title=r7.1.1:Enum_libtest_test_id&oldid=1113’