fs_crypto_domain_whitelist_configure()

Updated: April 19, 2023

Perform whitelist configuration for a domain whitelist

Synopsis:

#include <fs_crypto_api.h>
#include <sys/fs_crypto.h>

int fs_crypto_domain_whitelist_configure(
    const char *path,
    int domain,
    unsigned  type,
    unsigned *flags,
    int *preply)

Arguments:

path
The path to the filesystem's mountpoint.
domain
The number of the domain that you want to modify the list for.
type
The type of whitelist to carry out the action on. Must be one of the following:
  • FS_CRYPTO_WHITELIST_TYPE_PID — process ID.
  • FS_CRYPTO_WHITELIST_TYPE_GID — group ID.
flags
A pointer to the new flags to use for the whitelist. This will also be populated with the newly updated flags of the whitelist if the operation is completed successfully.
preply
A pointer to a location where the function can store additional success or error information.

Library:

libfscrypto

Use the -l fscrypto option to qcc to link against this library.

Description:

The fs_crypto_domain_whitelist_configure() function performs whitelist configuration for a domain whitelist. More specifically, this executes the whitelist action FS_CRYPTO_WHITELIST_ACTION_CONFIGURE. The data argument must point to a single data item associated with the type. For example, when FS_CRYPTO_WHITELIST_TYPE_PID is specified, data must be a pointer to a pid_t value.

Note: In order to use filesystem encryption, download the Encrypted Filesystem package from the QNX Software Center.

Returns:

EOK
Success.
EINVAL
Invalid arguments.
ENOMEM
Insufficent free memory.

This function can also return any of the errors indicated by devctl() or open().

Classification:

QNX Neutrino

Safety:  
Cancellation point Yes
Interrupt handler No
Signal handler No
Thread Yes