ioctl_xfs_goingdown - shut down an XFS filesystem
#include <xfs/xfs_fs.h>
int ioctl(int fd, XFS_IOC_GOINGDOWN, uint32_t
flags);
Shuts down a live XFS filesystem. This is a software initiated hard shutdown and
should be avoided whenever possible. After this call completes, the filesystem
ill be totally unusable until the filesystem has been unmounted and remounted.
flags can be one of the following:
- XFS_FSOP_GOING_FLAGS_DEFAULT
- Flush all dirty data and metadata to disk, flush pending
transactions to the log, and shut down.
- XFS_FSOP_GOING_FLAGS_LOGFLUSH
- Flush all pending metadata transactions to the log and shut
down, leaving all dirty data unwritten.
- XFS_FSOP_GOING_FLAGS_NOLOGFLUSH
- Shut down immediately, without writing pending transactions
or dirty data to disk.
On error, -1 is returned, and
errno is set to indicate the error.
Error codes can be one of, but are not limited to, the following:
- EFSBADCRC
- Metadata checksum validation failed while performing the
query.
- EFSCORRUPTED
- Metadata corruption was encountered while performing the
query.
- EIO
- An I/O error was encountered while performing the
query.
- EPERM
- Caller did not have permission to shut down the
filesystem.
This API is specific to XFS filesystem on the Linux kernel.
ioctl(2)