semanage_query(3) — Linux manual page

semanage_query(3)     Libsemanage API documentation    semanage_query(3)

NAME

       semanage_query - SELinux Management API

SYNOPSIS

       The following query function is supported for any semanage
       record.
       Replace the function and object name as necessary.

       extern int QUERY_FUNCTION (
            semanage_handle_t *handle,
            const semanage_OBJECT_key_t *key,
            semanage_OBJECT_t **response);

DESCRIPTION

       Behavior:
              The query function will fail if a matching key is not
              found. Otherwise, the corresponding object is returned.

       Parameters:
              The handle is used to track persistent state across
              semanage calls, and for error reporting. The key
              identifies the object being queried, which will be stored
              in the address pointed by response The key is a property
              of the caller, and will not be stored or modified
              internally. The object returned becomes a property of the
              caller, and must be freed with semanage_OBJECT_free.

       Requirements:
              This function requires an semanage connection to be
              established (see semanage_connect(3) )

RETURN VALUE

       In case of failure, -1 is returned, and the semanage error
       callback is invoked, describing the error.  Otherwise a non-
       negative integer is returned (a commit number). The same number
       will be returned by all other semanage object read calls until
       the next commit.

SEE ALSO

       semanage_handle_create(3), semanage_connect(3),

COLOPHON

       This page is part of the selinux (Security-Enhanced Linux user-
       space libraries and tools) project.  Information about the
       project can be found at 
       ⟨https://github.com/SELinuxProject/selinux/wiki⟩.  If you have a
       bug report for this manual page, see
       ⟨https://github.com/SELinuxProject/selinux/wiki/Contributing⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/SELinuxProject/selinux⟩ on 2024-06-14.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-05-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

ivg2@cornell.edu              15 March 2006            semanage_query(3)

Pages that refer to this page: semanage_bool(3), semanage_fcontext(3), semanage_iface(3), semanage_node(3), semanage_port(3), semanage_seuser(3), semanage_user(3)

---