Installation guide

Specifies an arbitrary name selected for the GNBD. It is used as the device name on GNBD
clients. T his name must be unique among all GNBDs exported in a network.
-o
Export the device as read-only.
-c
Enable caching. Reads from the exported GNBD and takes advantage of the Linux page cache.
By default, the gnbd_export command does not enable caching.
Note
When you configure GNBD servers with device-mapper multipath, do not specify the -c
option. All GNBDs that are part of a logical volume must run with caching disabled.
Note
If you have been using GFS 5.2 or earlier and do not want to change your GNBD setup
you should specify the -c option. Before GFS Release 5.2.1, Linux caching was enabled
by default for gnbd_export. If the -c option is not specified, GNBD runs with a
noticeable performance decrease. Also, if the -c option is not specified, the exported
GNBD runs in timeout mode, using the default timeout value (the -t option). For more
information about the gnbd_export command and its options, refer to the
gnbd_export man page.
-u uid
Manually sets the Universal Identifier for an exported device. T his option is used with -e. T he
UID is used by device-mapper multipath to determine which devices belong in a multipath map.
A device must have a UID to be multipathed. However, for most SCSI devices the default Get
UID command, /usr/sbin/gnbd_get_uid, will return an appropriate value.
Note
The UID refers to the device being exported, not the GNBD itself. The UIDs of two GNBD
devices should be equal, only if they are exporting the same underlying device. This
means that both GNBD servers are connected to the same physical device.
Chapter 3. GNBD Driver and Command Usage
11