The
gnop
utility is used for setting up transparent providers on existing ones.
Its main purpose is testing other GEOM classes, as it allows forced provider
removal and I/O error simulation with a given probability.
It also gathers statistics on the number of read, write, delete,
getattr, flush, and other requests, and the number of bytes read and written.
gnop
can also be used as a good starting point for implementing new GEOM
classes.
The first argument to
gnop
indicates an action to be performed:
|
| create
|
Set up a transparent provider on the given devices.
If the operation succeeds, the new provider should appear with name
/dev/<dev > .nop.
The kernel module
geom_nop.ko
will be loaded if it is not loaded already.
|
| configure
|
| |
Configure existing transparent provider.
At the moment it is only used for changing failure probability.
|
| destroy
|
Turn off the given transparent providers.
|
| reset
|
Reset statistics for the given transparent providers.
|
| list
|
See
geom(8).
|
| status
|
See
geom(8).
|
| load
|
See
geom(8).
|
| unload
|
See
geom(8).
|
|
Additional options:
| -c count_until_fail
|
| |
Specifies the number of I/O requests to allow before setting the read, write and
delay failure probabilities.
|
| -d delaymsec
|
Specifies the delay of the requests in milliseconds.
Note that requests will be delayed before they are sent to the backing device.
|
| -e error
|
Specifies the error number to return on failure.
|
| -f
|
Force the removal of the specified provider.
|
| -o offset
|
Where to begin on the original provider.
|
| -p stripesize
|
| |
Value of the stripesize property of the transparent provider.
|
| -P stripeoffset
|
| |
Value of the stripeoffset property of the transparent provider.
|
| -q rdelayprob
|
| |
Specifies read delay probability in percent.
|
| -r rfailprob
|
Specifies read failure probability in percent.
|
| -s size
|
Size of the transparent provider.
|
| -S secsize
|
Sector size of the transparent provider.
|
| -w wfailprob
|
Specifies write failure probability in percent.
|
| -v
|
Be more verbose.
|
| -x wdelayprob
|
| |
Specifies write delay probability in percent.
|
| -z physpath
|
Physical path of the transparent provider.
|
| -Z gnopname
|
The name of the new provider.
The suffix
".nop"
will be appended to the provider name.
|
|
