DCMD_ETFS_* Parent topic: DCMD_ETFS_*

DCMD_ETFS_FORMAT

Format an embedded transaction filesystem

Synopsis:

#include <sys/dcmd_mem.h>

#define DCMD_ETFS_FORMAT    __DION(_DCMD_MEM, 103)

Arguments to devctl():

Argument Value
filedes A file descriptor that you obtained by opening the filesystem partition, /dev/etfs2
dcmd DCMD_ETFS_FORMAT
dev_data_ptr NULL
n_bytes 0
dev_info_ptr NULL

Description:

This command erases the device and then formats an empty filesystem. You must be root or have the appropriate permissions to use this command.

Input:

None.

Output:

None.

Errors:

The devctl() function can return the following, in addition to the error codes listed in its entry in the C Library Reference:

EBUSY
There are open files in the filesystem.
EINVAL
The file descriptor doesn't correspond to the filesystem partition, /dev/etfs2.
EPERM
You don't have the required permissions.

See also:

devctl() in the QNX Neutrino C Library Reference

etfsctl, fs-etfs-ram in the Utilities Reference

Parent topic: DCMD_ETFS_*