ggated(8) [freebsd man page]

GGATED(8)						    BSD System Manager's Manual 						 GGATED(8)

NAME

     ggated -- GEOM Gate network daemon

SYNOPSIS

     ggated [-h] [-n] [-v] [-a address] [-p port] [-R rcvbuf] [-S sndbuf] [exports file]

DESCRIPTION

     The ggated utility is a network server for GEOM Gate class.  It runs on a server machine to service GEOM Gate requests from workers placed on
     a client machine.	Keep in mind, that connection between ggatec(8) and ggated is not encrypted.

     Available options:

     -a address    Specifies an IP address to bind to.

     -h 	   Print available options.

     -n 	   Do not use TCP_NODELAY option on TCP sockets.

     -p port	   Port on which ggated listens for connection.  Default is 3080.

     -R rcvbuf	   Size of receive buffer to use.  Default is 131072 (128kB).

     -S sndbuf	   Size of send buffer to use.	Default is 131072 (128kB).

     -v 	   Do not fork, run in foreground and print debug informations on standard output.

     exports file  An alternate location for the exports file.

     The format of an exports file is as follows:

	   1.2.3.4	   RO	   /dev/acd0
	   1.2.3.0/24	   RW	   /tmp/test.img
	   hostname	   WO	   /tmp/image

EXIT STATUS

     Exit status is 0 on success, or 1 if the command fails.  To get details about the failure, ggated should be called with the -v option.

EXAMPLES

     Export CD-ROM device and a file:

	   # echo "1.2.3.0/24 RO /dev/acd0" > /etc/gg.exports
	   # echo "client RW /image" >> /etc/gg.exports
	   # ggated

SEE ALSO

     geom(4), ggatec(8), ggatel(8)

AUTHORS

     The ggated utility as well as this manual page was written by Pawel Jakub Dawidek <pjd@FreeBSD.org>.

BSD
								  April 29, 2004							       BSD

GGATEC(8)						    BSD 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 GEOM Gate class.  It is responsible for creation of ggate devices and forwarding I/O requests
     between geom_gate.ko kernel module and ggated(8) network daemon.  Available commands:

     create   Connect to given ggated(8) daemon and create a ggate provider related to the given remote file or device.

     rescue   If ggatec process died/has been killed, you can save situation with this command, which creates new connection to the ggated(8) dae-
	      mon and will handle 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 permission 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 before 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 device, or set to 512 bytes for files.

     -t timeout       Number of seconds to wait before an I/O request will be canceled.  0 means no timeout.  Default is 0.

     -u unit	      Unit number to use.

     -v 	      Do not fork, run in foreground and print debug informations 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

     Make use of CD-ROM device from remote host.

	   server# cat /etc/gg.exports
	   client RO /dev/acd0
	   server# ggated

	   client# ggatec create -o ro server /dev/acd0
	   ggate0
	   client# mount_cd9660 /dev/ggate0 /cdrom

SEE ALSO

     geom(4), ggated(8), ggatel(8), mount_cd9660(8)

AUTHORS

     The ggatec utility as well as this manual page was written by Pawel Jakub Dawidek <pjd@FreeBSD.org>.

BSD
								  April 26, 2004							       BSD