authzs_list()

authzs_list() retrieves a list of authorization descriptors for a given hgobj. If an authz name is provided, it returns the specific authorization descriptor matching that name.

C

Prototype

json_t *authzs_list(
    hgobj       gobj,
    const char *authz
);

Parameters

Key	Type	Description
gobj	hgobj	The object whose authorization descriptors are to be retrieved. Can be NULL to retrieve global authorizations.
authz	const char *	The name of a specific authorization descriptor to retrieve. If empty, all available authorizations are returned.

---

Return Value

A json_t * object containing the list of authorization descriptors. If authz is provided, returns the specific descriptor or NULL if not found.

Notes

If gobj is NULL, the function retrieves global authorization descriptors. If authz is not found, an error is logged.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python

Examples

C

// TODO C examples

JS

// TODO JS examples

Python

# TODO Python examples