Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
GGATEC(8)		FreeBSD	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 attach [-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.  Avail-
     able commands:

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

     attach   Attach a worker process to an existing ggate provider (create a
	      new connection to	the ggated(8) daemon).

     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 30.

     -u	unit	      Unit number to use.

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

     host	      Remote host to connect to.

     path	      Path to a	regular	file or	device.

EXAMPLES
     Made 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

DIAGNOSTICS
     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.

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>.

FreeBSD	10.1			April 26, 2004			  FreeBSD 10.1

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | DIAGNOSTICS | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ggatec&sektion=8&manpath=FreeBSD+5.3-RELEASE>

home | help