1IOCTL-XFS-GOINGDOWN(2)        System Calls Manual       IOCTL-XFS-GOINGDOWN(2)
2
3
4

NAME

6       ioctl_xfs_goingdown - shut down an XFS filesystem
7

SYNOPSIS

9       #include <xfs/xfs_fs.h>
10
11       int ioctl(int fd, XFS_IOC_GOINGDOWN, uint32_t flags);
12

DESCRIPTION

14       Shuts  down  a  live XFS filesystem.  This is a software initiated hard
15       shutdown and should be avoided whenever possible.  After this call com‐
16       pletes, the filesystem ill be totally unusable until the filesystem has
17       been unmounted and remounted.
18
19
20       flags can be one of the following:
21
22           XFS_FSOP_GOING_FLAGS_DEFAULT
23                  Flush all dirty data and metadata  to  disk,  flush  pending
24                  transactions to the log, and shut down.
25
26           XFS_FSOP_GOING_FLAGS_LOGFLUSH
27                  Flush  all pending metadata transactions to the log and shut
28                  down, leaving all dirty data unwritten.
29
30           XFS_FSOP_GOING_FLAGS_NOLOGFLUSH
31                  Shut down immediately, without writing pending  transactions
32                  or dirty data to disk.
33
34

RETURN VALUE

36       On error, -1 is returned, and errno is set to indicate the error.
37

ERRORS

39       Error codes can be one of, but are not limited to, the following:
40
41       EFSBADCRC
42              Metadata checksum validation failed while performing the query.
43
44       EFSCORRUPTED
45              Metadata corruption was encountered while performing the query.
46
47       EIO    An I/O error was encountered while performing the query.
48
49       EPERM  Caller did not have permission to shut down the filesystem.
50

CONFORMING TO

52       This API is specific to XFS filesystem on the Linux kernel.
53

SEE ALSO

55       ioctl(2)
56
57
58
59XFS                               2019-06-17            IOCTL-XFS-GOINGDOWN(2)
Impressum