fs_crypto_domain

Get status information for a domain

Synopsis:

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

int fs_crypto_domain_query( const char *path,
                            int domain,
                            int *preply );

Arguments:

path: The path to the filesystem's mountpoint.
domain: The number of the domain that you want the status of.
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_query() function gets status information for a domain.

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

This function sets the variable pointed to by preply to one of the following values:

FS_CRYPTO_REPLY_LOCKED: The domain is currently locked.
FS_CRYPTO_REPLY_INVALID: The command wasn't completed successfully.
FS_CRYPTO_REPLY_NOENTRY: No entry was found for the given domain.
FS_CRYPTO_REPLY_UNLOCKED: The domain is currently unlocked.

Returns:

EOK: Success.
EINVAL: Invalid arguments.

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