FreeBSD Manual Pages
GGATEC(8) System Manager's Manual GGATEC(8) NAME ggatec -- GEOM Gate network client and control utility SYNOPSIS ggatec create [-n] [-v] [-o ro | wo | rw] [-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] [-p port] [-R rcvbuf] [-S sndbuf] -u unit host path ggatec destroy [-f] -u unit ggatec list [-v] [-u unit] DESCRIPTION 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 re- quests 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 ggate provider for the specified remote file or device. rescue Create a new connection after the ggatec process has died or been killed. The new connection to the ggated(8) daemon han- dles pending and future requests. destroy Destroy the given ggate provider. list List ggate providers. Available options: -f Forcibly destroy ggate provider (cancels all pending requests). -n Do not use TCP_NODELAY option on TCP sockets. -o ro | wo | rw Specify permissions to use when opening the file or device: read-only (ro), write-only (wo), or read-write (rw). 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 be- fore they will start to be canceled. Default is 1024. -R rcvbuf Size of receive buffer to use. Default is 131072 (128kB). -S sndbuf Size of send buffer to use. Default is 131072 (128kB). -s sectorsize Sector size for ggate provider. 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 infor- mation 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 server# ggated client# ggatec create -o ro server /dev/cd0 ggate0 client# mount_cd9660 /dev/ggate0 /cdrom SEE ALSO geom(4), ggated(8), ggatel(8), mount_cd9660(8) HISTORY The ggatec utility appeared in FreeBSD 5.3. AUTHORS The ggatec utility as well as this manual page was written by Pawel Jakub Dawidek <pjd@FreeBSD.org>. FreeBSD 14.3 September 8, 2016 GGATEC(8)
NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | SEE ALSO | HISTORY | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ggatec&sektion=8&manpath=FreeBSD+14.3-RELEASE+and+Ports>