Detaches and removes the corresponding /dev/fctx IO Accelerator block device. The fio-detachcommand waits until the device completes all read/write activity before executing the detach process. The command displays a progress bar and percentage as it completes the process.

NOTE: Before using this utility, be sure that the device you want to detach is not currently mounted and in use.

Syntax

fio-detach <device> [options]

where <device> is the name of the device node (/dev/fctx), where x indicates the board number: 0, 1, 2, and so on. For example, /dev/fct0 indicates the first IO Accelerator installed on the system.

You can specify multiple IO Accelerator devices. For example, /dev/fct1 /dev/fct2 indicates the second and third IO Accelerator devices installed on the system. You can also use a wildcard to indicate all IO Accelerator devices on the system.

For example, /dev/fct*

Options

Description

 

 

-i

Immediate: Causes a forced immediate detach (does not save metadata). This will fail

 

if the device is in use by the OS.

-q

Quiet: Disables the display of the progress bar and percentage.

NOTE: Detaching an IO Accelerator device might fail with an error indicating that the device is busy. This might occur if the IO Accelerator device is part of a software RAID volume (0,1,5), is mounted, or if some process has the device open.

The tools fuser, mount, and lsof can be helpful to determine what is holding the device open.

fio-format

Description

IMPORTANT: The IO Accelerator devices are shipped pre-formatted. fio-formatis not required except to change the logical size or block size of a device, or to erase user data on a device. To ensure the user data is truly erased, use fio-sure-erase.

The fio-formatutility performs a low-level format of the board. By default, fio-formatdisplays a progress-percentage indicator as it runs.

CAUTION: Use this utility with care since it deletes all user information on the IO Accelerator.

IMPORTANT: Use the -sor -ooption to change the default capacity of the device size. When enabled, the -sand -ooptions must include the size or percentage indicators.

NOTE: Use a large block (sector) size to reduce IO Accelerator memory consumption. For

example: 4096 bytes. Be aware that some applications are not compatible with non-512-byte sector sizes.

Syntax

fio-format [options] <device>

Utilities 43