Custom Thread StackSize API

[sirknightj]

Issue #, if available:

• N/A

What was changed?

• See Add API for specifying thread stack size #243 for the original PR with details.
• Add new CMake flag (KVS_DEFAULT_STACK_SIZE) that allows users to configure the default stack size of threads created with THREAD_CREATE.
• Add new CMake flag (THREAD_CREATE_WITH_PARAMS) that allows users to create threads with custom stack sizes.
• For non-windows, there was a CMake flag available: -DCONSTRAINED_DEVICE that sets the default stack size to 0.5 MiB. For backwards compatibility, this flag was not changed.
• Make KVS_DEFAULT_STACK_SIZE and CONSTRAINED_DEVICE incompatible with each other. The build will fatally exit if both of these are set.
• Added more unit tests for the new API, including a unit test that checks that validates the stack size was actually changed.
• Add a script to run various CMake flag combinations to check that that it correctly fails the build if those 2 exclusive CMake flags are set. Generate a markdown test report for that as well.

Why was it changed?

• See Add API for specifying thread stack size #243 for additional details.

How was it changed?

• See Add API for specifying thread stack size #243 for additional details.

What testing was done for the changes?

• See Add API for specifying thread stack size #243 for additional details.
• For the new changes, the newly added tests are passing and the new test report can be found at the bottom of the page: https://github.com/awslabs/amazon-kinesis-video-streams-pic/actions/runs/11676076021

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[MushMal]

This is a good change. My only concern is the name of the new API and the choice of the parameter itself. What if in the future you might want to add another parameter? I would suggest adding a struct that can be versioned and new params could be added later for back compat. The struct initially can have only a couple of fields - like the version, stack size, thread name. But later can include more flags such as start suspended, priority, etc..

[unicornss]

Something like this ...

#define THREAD_PARAMS_VERSION_1 1
typedef struct ThreadParams {
    int version;
    SIZE_T stackSize;
    :
} ThreadParams;