Skip to content

Conversation

lplewa
Copy link
Contributor

@lplewa lplewa commented Sep 17, 2025

No description provided.

@lplewa lplewa changed the title Ctl split The last CTL patch :) Sep 17, 2025
@lplewa lplewa force-pushed the ctl_split branch 11 times, most recently from 629b379 to 2706166 Compare September 18, 2025 14:44
@lplewa lplewa marked this pull request as ready for review September 18, 2025 15:22
@lplewa lplewa requested a review from a team as a code owner September 18, 2025 15:22
Copy link
Contributor

@lukaszstolarczuk lukaszstolarczuk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

after all, this is super huge PR - I'd split this somehow, if easily done...


UMF's experimental CTL API is showcased in the [CTL example](examples/ctl/ctl.c),
which explores provider and pool statistics, and in the [custom CTL example](examples/ctl/custom_ctl.c), which wires CTL support into a bespoke memory
provider. These examples rely on experimental headers whose interfaces may
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

whose refer to people -> perhaps: ... experimental headers which may change ...

sizeof(alloc_count), name, i);
}

Ensure that the types of wildcard arguments match the expected node types.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

otherwise what? you get an error, a crash, ...?

sizeof(capacity));

Every subsequently created disjoint pool will use ``16`` as its starting
capacity overriding it's creation parameters. Defaults are keyed by the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's -> its


UMF_CONF="umf.logger.output=stdout;umf.logger.level=0"

CTL options available through environment variables are limited—you can only
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

limited—you misspell

Within each subsystem the path continues with an addressing scheme followed by
the module or leaf of interest.

Reading this reference
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

consider renaming this section to Reading below sections or dunno, something else ;d

:type:`umf_memory_provider_handle_t` argument to reach a specific provider.
Providers can also be addressed by name through ``umf.provider.by_name.{provider}``;
append ``.{index}`` to address specific provider when multiple providers share the same label.
Defaults for future providers reside under ``umf.provider.default.{provider}`` and track the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not sure what you meant by ... and track the name ...

===========

A ``{}`` in the path acts as a wildcard and is replaced with successive
arguments of ``umfCtlGet``, ``umfCtlSet`` or ``umfCtlExec``. Wildcards can
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

set and get are explained, but umfCtlExec wasn't

target_include_directories(${ EXAMPLE_NAME} PRIVATE ${ LIBUMF_INCLUDE_DIRS})
target_link_directories(
${
EXAMPLE_NAME}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

that's a weird formatting - can you make it like ${EXAMPLE_NAME}...?

// fix below, as well pls

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants