fs_crypto_domain_remove

Destroy a dynamic domain

Synopsis:

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

int fs_crypto_domain_remove_dynamic(
    const char *path,
    int *preply)

path: The path to the directory whose domain you wish to remove.
preply: A pointer to a location where the function can store additional success or error information.

libfscrypto

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

The fs_crypto_domain_remove_dynamic() function destroys a dynamic domain.

Note:

In order to use filesystem encryption, download the Encrypted Filesystem package from the QNX Software Center.
You must be in the group that owns the filesystem's mountpoint in order to remove a domain. Original file contents assigned to this domain will be immediately unavailable and unrecoverable.

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

FS_CRYPTO_REPLY_COMPLETE: The domain was successfully created.
FS_CRYPTO_REPLY_ERRNO: See the error code.
FS_CRYPTO_REPLY_DOMAIN_EXISTS: The domain already exists.
FS_CRYPTO_REPLY_INVALID: The command wasn't completed successfully.
FS_CRYPTO_REPLY_READONLY: The filesystem is mounted read-only.
FS_CRYPTO_REPLY_UNKNOWN_TYPE: The type argument isn't a valid type of encryption.

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