selinux_restorecon_default_handle(3)

selinux_restorecon_default_handle3

Sets default parameters for selinux_restorecon(3)

Usage

#include <selinux/restorecon.h>
#include <selinux/label.h>

struct selabel_handle *selinux_restorecon_default_handle(void);

Overview

selinux_restorecon_default_handle() sets default parameters for selinux_restorecon(3) by calling selabel_open(3) with the SELABEL_OPT_DIGEST option only. This will enable a digest to be calculated on the currently loaded policy file_contexts(5) set of files as described in the NOTES section of selinux_restorecon(3).

Calling selinux_restorecon_default_handle() is optional, however if used then selinux_restorecon_set_sehandle(3) should be called with the returned handle to set this for use by selinux_restorecon(3).

selinux_restorecon_default_handle() is optional as selinux_restorecon(3) will automatically call this and selinux_restorecon_set_sehandle(3) provided a handle has not already been set, for example by selinux_restorecon_set_sehandle(3) to set customised selabel_open(3) parameters.

Return value

A non-NULL handle value is returned on success. On error, NULL is returned and errno is set appropriately.

Releases

Unchanged in 5 releases since Debian 9 (Stretch).

  1. 9–13

From libselinux1-dev 3.8.1-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.