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>

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

Options

Description

 

 

-b <size

Set the block (sector) size, in bytes or KiBytes (base 2). The default is 512 bytes. For

BK>

example: -b 512B or -b 4K (B in 512B is optional).

Utilities 25