f2fs_io

f2fs_io(8) System Administration Utilities f2fs_io(8)

NAME

   f2fs_io - f2fs ioctl utility

DESCRIPTION

   f2fs_io is used to send various commands to the f2fs file system for administrative purposes.

AVAILABLE COMMANDS

   set_verity [file]
          Set the verity flags associated with the specified file.

   getflags [file]
          Get the flags associated with the specified file.

   setflags [flag] [file]
          Set an f2fs file on specified file.  The flag can be casefold, compression, and nocompression.

   shutdown shutdown filesystem
          Freeze and stop all IOs for the file system mounted on dir.  The level parameter can be:

               0      going down with full sync

               1      going down with checkpoint only

               2      going down with no sync

               3      going down with metadata flush

               4      going down with fsck mark

   pinfile [get|set] [file]
          Get or set the pinning status on a file.

   fallocate [keep_size] [offset] [length] [file]
          Request that space be allocated on a file.  The keep_size parameter can be either 1 or 0.

   write [chunk_size in 4kb] [offset in chunk_size] [count] [pattern] [IO] [file_path]
          Write a given pattern to file_path.  The pattern parameter can be:

               zero   zeros

               inc_num
                      incrementing numbers

               rand   random numbers

          The IO parameter can be:

               buffered
                      buffered I/O

               dio    direct I/O

               dsync  direct I/O with O_DSYNC

   read [chunk_size in 4kb] [offset in chunk_size] [count] [IO] [print_nbytes] [file_path]
          Read data in file_path and print print_nbytes.  The IO options can be:

               buffered
                      buffered I/O

               dio    direct I/O

   fiemap [offset in 4kb] [count] [file_path]
          get block address in file

   gc_urgent dev [start|end|run] [time in sec]
          Start, end, or run gc_urgent for a given time period

   defrag_file [start] [length] [file_path]
          Defragment a file.

   copy [-d] [-m] [-s] [src_path] [dst_path]
          Copy file from src_path to dst_path.  The pattern parameter can be:

               -d     use direct I/O

               -m     use mmap for source file

               -s     use sendfile to transfer data

   get_cblocks [file]
          Get the number of compressed blocks.

   release_cblocks [file]
          Release compressed blocks to get free space.

   reserve_cblocks [file]
          Reserve free blocks to prepare decompressing blocks in the file.

   gc [sync_mode] [file]
          Trigger filesystem GC

AUTHOR

   This version of f2fs_io has been written by Jaegeuk Kim <jaegeuk@kernel.org>.

AVAILABILITY

   f2fs_io is available from git://git.kernel.org/pub/scm/linux/kernel/git/jaegeuk/f2fs-tools.git.

f2fs-tools March 2020 f2fs_io(8)