#include <fs_crypto_api.h>
#include <sys/fs_crypto.h>
int fs_crypto_file_set_domain( const char *path,
int pdomain,
int *preply );
Arguments:
path
The path to the file or directory whose domain you want to set.
domain
The number of the domain that you want to assign the file or directory to, or
0 (FS_CRYPTO_UNASSIGNED_DOMAIN) if you don't
want the item to be in any domain, and hence unencrypted.
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_file_set_domain() function sets the domain number for the given file or
directory, storing the number in the location that domain points to.
Note:
In order to use filesystem encryption, download the Encrypted Filesystem package from the QNX Software Center.
In order for you to successfully set the domain:
the domain must exist and be unlocked
the path must be either a directory or a regular file
there must be no data in the file
the disk must not be read-only
This function sets the variable pointed to by preply to one of the following values:
FS_CRYPTO_REPLY_ALREADY
The file or directory is already assigned to the given domain.
FS_CRYPTO_REPLY_BAD_FILE
The path isn't for a directory or a regular file.
FS_CRYPTO_REPLY_COMPLETE
The function retrieved the domain number.
FS_CRYPTO_REPLY_ERRNO
See the error code for more information.
FS_CRYPTO_REPLY_INVALID
The command wasn't completed successfully.
FS_CRYPTO_REPLY_NOT_ZERO
The path is for a regular file, and the file's size isn't zero.
FS_CRYPTO_REPLY_READONLY
The filesystem is mounted as read-only.
FS_CRYPTO_REPLY_UNKNOWN_DOMAIN
There's no domain with the given number.
Returns:
EOK
Success.
EINVAL
Invalid arguments.
This function can also return any of the errors indicated by
devctl()
or
open(),
or any
errno
values returned by the underlying filesystem.