ggatec8
Geom gate network client and control utility
Usage
ggatec create
[-n]
[-v]
[{-o
ro | wo | rw}]
[-o
direct]
[-p
port]
[-q
queue_size]
[-R
rcvbuf]
[-S
sndbuf]
[-s
sectorsize]
[-t
timeout]
[-u
unit]
host
path
ggatec rescue
[-n]
[-v]
[{-o
ro | wo | rw}]
[-o
direct]
[-p
port]
[-R
rcvbuf]
[-S
sndbuf]
-u
unit
host
path
ggatec destroy
[-f]
-u
unit
ggatec list
[-v]
[-u
unit]
Overview
The ggatec utility is a network client for the GEOM Gate class. It is responsible for the creation of ggate devices and forwarding I/O requests between the GEOM Gate kernel subsystem and the ggated(8) network daemon. Available commands:
create-
Connect to a ggated(8) daemon on the specified host and create a
ggateprovider for the specified remote file or device. rescue-
Create a new connection after the
ggatecprocess has died or been killed. The new connection to the ggated(8) daemon handles pending and future requests. destroy-
Destroy the given
ggateprovider. list-
List
ggateproviders.
Available options:
-
-f -
Forcibly destroy
ggateprovider (cancels all pending requests). -
-n -
Do not use TCP_NODELAY option on TCP sockets.
-
-o option -
Specify permissions and options to use when opening the file or device.
ro-
read-only
wo-
write-only
rw-
read-write
direct-
open with O_DIRECT option on the file
Default is
rw.
-
-p port -
Port to connect to on the remote host. Default is 3080.
-
-q queue_size -
Number of pending I/O requests that can be queued before they will start to be canceled. Default is 1024.
-
-R rcvbuf -
Size of receive buffer to use. Default is 131072 (128 KiB).
-
-S sndbuf -
Size of send buffer to use. Default is 131072 (128 KiB).
-
-s sectorsize -
Sector size for
ggateprovider. If not specified, it is taken from the device, or set to 512 bytes for files. -
-t timeout -
Number of seconds to wait before an I/O request will be canceled. Default is 0, which means no timeout.
-
-u unit -
Unit number to use.
-
-v -
Do not fork, run in foreground and print debug information on standard output.
- host
-
Remote host to connect to.
- path
-
Path to a regular file or device.
Exit status
Exit status is 0 on success, or 1 if the command fails. To get details about the failure, ggatec should be called with the -v option.
Examples
Use a CD-ROM device on a remote host.
server# cat /etc/gg.exports client RO /dev/cd0 client RW /tmp/image server# ggated client# ggatec create -o ro server /dev/cd0 ggate0 client# mount_cd9660 /dev/ggate0 /cdrom client# ggatec create -o rw -o direct server /tmp/image ggate1
Releases
52 releases since FreeBSD 5.3-RELEASE; the text changed 36 times.
- 5.3–5.5
- 6.0–6.3
- 6.4
- 7.0
- 7.1
- 7.2
- 7.3
- 7.4
- 8.0
- 8.1
- 8.2
- 8.3
- 8.4
- 9.0
- 9.1
- 9.2
- 9.3
- 10.0
- 10.1
- 10.2
- 10.3
- 10.4
- 11.0
- 11.1
- 11.2
- 11.3
- 11.4
- 12.0
- 12.1
- 12.2
- 12.3
- 12.4
- 13.0–13.2
- 13.3–14.4
- 14.5
- 15.0
- 15.1–16.0
-o since FreeBSD 15.0-RELEASE.