HP MSR Encryption Accelerators - Manual (Page 43)

Utilities 43
Detaches and removes the corresponding /dev/fctx IO Accelerator block device. The fio-detach
command 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-format is 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-format utility performs a low-level format of the board. By default, fio-format displays 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 -s or -o option to change the default capacity of the device size. When
enabled, the -s and -o options 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>