pips_provider_root()

Updated: October 26, 2022

Retrieve a provider's root namespace

Synopsis:

#include <pips/pips.h>
pips_namespace_t* pips_provider_root(pips_provider_t *const provider)

Arguments:

provider
A handle to the provider implementation whose root namespace is being retrieved

Library:

pips-client

Description:

This function retrieves the root namespace for the specified provider implementation. Clients can use the returned namespace instance to enumerate the topics in the provider, using pips_namespace_next_child().

Returns:

On success, a pointer to the root namespace of the named provider. On error, NULL (errno is set).

Errors:

  • EINVAL: The specified provider is invalid.