Thread Pinning API Test Plan#

The Threadpinning module testplan#

The thread pinning module#

The thread pinning module provides an interface that can facilitate pinning threads to cores based on the pinning strategy requested.

The objective#

To have a compreshensive test coverage for the threadpinning API

Classes of testcases#

  • mock Tests

  • native tests

APIs tested#

* ThreadPinning::pinThreads()       -- Cpp API   -- External API
* Affinity::getAffinityVector()     -- Cpp API   -- Internal Using mock tests
* au_pin_threads_core()             -- C API     -- External API
* au_pin_threads_logical()          -- C API     -- External API
* au_pin_threads_spread()           -- C API     -- External API
* au_pin_threads_custom()           -- C API     -- External API

The test matrix for the threadpinning module mock tests#

combinations of 5 variables are tested. They are:

  • Number of threads

  • Number of cores

  • Pinning strategy

  • Hyperthreading

  • Cache sharing

The below tests tests getAffinityVector() API which is an internal API by creating a mock environment described by each entry in the test matrix. and verifies that the affinity vector returned is as expected.

ID

No. of core groups

Hyperthreading

Cache groups

No of threads

Pinning strategy

1

1

NO HT

1

> no of cores

core

2

1

NO HT

1

> no of cores

Logical

3

1

NO HT

1

> no of cores

Spread

4

1

NO HT

1

< no of cores

core

5

1

NO HT

1

< no of cores

Logical

6

1

NO HT

1

< no of cores

Spread

7

1

NO HT

1

= no of cores

core

8

1

NO HT

1

= no of cores

Logical

9

1

NO HT

1

= no of cores

Spread

10

1

NO HT

Multi

> no of cores

core

11

1

NO HT

Multi

> no of cores

Logical

12

1

NO HT

Multi

> no of cores

Spread

13

1

NO HT

Multi

< no of cores

core

14

1

NO HT

Multi

< no of cores

Logical

15

1

NO HT

Multi

< no of cores

Spread

16

1

NO HT

Multi

= no of cores

core

17

1

NO HT

Multi

= no of cores

Logical

18

1

NO HT

Multi

= no of cores

Spread

19

1

HT

1

> no of cores

core

20

1

HT

1

> no of cores

Logical

21

1

HT

1

> no of cores

Spread

22

1

HT

1

< no of cores

core

23

1

HT

1

< no of cores

Logical

24

1

HT

1

< no of cores

Spread

25

1

HT

1

= no of cores

core

26

1

HT

1

= no of cores

Logical

27

1

HT

1

= no of cores

Spread

28

1

HT

Multi

> no of cores

core

29

1

HT

Multi

> no of cores

Logical

30

1

HT

2

> no of cores

Spread

31

1

HT

Multi

< no of cores

core

32

1

HT

Multi

< no of cores

Logical

33

1

HT

Multi

< no of cores

Spread

34

1

HT

Multi

= no of cores

core

35

1

HT

Multi

= no of cores

Logical

36

1

HT

Multi

= no of cores

Spread

37

Multi

NO HT

1

> no of cores

core

38

Multi

NO HT

1

> no of cores

Logical

39

Multi

NO HT

1

> no of cores

Spread

40

Multi

NO HT

1

< no of cores

core

41

Multi

NO HT

1

< no of cores

Logical

42

Multi

NO HT

1

< no of cores

Spread

43

Multi

NO HT

1

= no of cores

core

44

Multi

NO HT

1

= no of cores

Logical

45

Multi

NO HT

1

= no of cores

Spread

46

Multi

NO HT

Multi

> no of cores

core

47

Multi

NO HT

Multi

> no of cores

Logical

48

Multi

NO HT

Multi

> no of cores

Spread

49

Multi

NO HT

Multi

< no of cores

core

50

Multi

NO HT

Multi

< no of cores

Logical

51

Multi

NO HT

Multi

< no of cores

Spread

52

Multi

NO HT

Multi

= no of cores

core

53

Multi

NO HT

Multi

= no of cores

Logical

54

Multi

NO HT

Multi

= no of cores

Spread

55

Multi

HT

1

> no of cores

core

56

Multi

HT

1

> no of cores

Logical

57

Multi

HT

1

> no of cores

Spread

58

Multi

HT

1

< no of cores

core

59

Multi

HT

1

< no of cores

Logical

60

Multi

HT

1

< no of cores

Spread

61

Multi

HT

1

= no of cores

core

62

Multi

HT

1

= no of cores

Logical

63

Multi

HT

1

= no of cores

Spread

64

Multi

HT

Multi

> no of cores

core

65

Multi

HT

Multi

> no of cores

Logical

66

Multi

HT

Multi

> no of cores

Spread

67

Multi

HT

Multi

< no of cores

core

68

Multi

HT

Multi

< no of cores

Logical

69

Multi

HT

Multi

< no of cores

Spread

70

Multi

HT

Multi

= no of cores

core

71

Multi

HT

Multi

= no of cores

Logical

72

Multi

HT

Multi

= no of cores

Spread

The test matrix for the threadpinning module native tests#

Native tests are run on the actual hardware. The test matrix is as follows: Verifies that the thread pinning is done correctly on the actual hardware. by checking the affinity of the threads to the cores. Variables testsed are:

  • Number of threads

  • Pinning strategy

ID

No of threads

Pinning strategy

1

> no of cores

core

2

> no of cores

Logical

3

> no of cores

Spread

4

< no of cores

core

5

< no of cores

Logical

6

< no of cores

Spread

7

= no of cores

core

8

= no of cores

Logical

9

= no of cores

Spread

Similar tests are provided for individual capis.