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
GGATEL(8)		FreeBSD	System Manager's Manual		     GGATEL(8)

NAME
     ggatel -- GEOM Gate local control utility

SYNOPSIS
     ggatel create [-v]	[-o ro | wo | rw] [-q queue_size] [-s sectorsize]
	    [-t	timeout] [-u unit] path
     ggatel attach [-v]	[-o ro | wo | rw] -u unit path
     ggatel destroy [-f] -u unit
     ggatel list [-v] [-u unit]

DESCRIPTION
     The ggatel	utility	is a local GEOM	Gate class consumer.  It can be	used
     as	a replacement for md(4)	devices	or as a	``GEOMificator'' for non GEOM-
     aware devices, but	it was mainly created as an example on how to use and
     how to communicate	with the GEOM Gate kernel module.

     Available commands:

     create   Create a ggate provider related to the given regular file	or
	      device.

     attach   Attach a worker process to an existing ggate provider.

     destroy  Destroy the given	ggate provider.

     list     List ggate providers.

     Available options:

     -f		      Forcibly destroy ggate provider (cancels all pending
		      requests).

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

     -q	queue_size    Number of	pending	I/O requests that can be queued	before
		      they will	start to be canceled.  Default is 1024.

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

     path	      Path to a	regular	file or	device.

EXAMPLES
     ``GEOMify'' the ``fd0'' device and	use gbde(8) to encrypt data on a
     floppy.

	   ggatel create -u 5 /dev/fd0
	   gbde	init /dev/ggate5
	   gbde	attach ggate5
	   newfs /dev/ggate5.bde
	   mount /dev/ggate5.bde /secret
	   cp /private/foo /secret/
	   umount /secret
	   gbde	detach ggate5
	   ggatel destroy -u 5

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

SEE ALSO
     geom(4), gbde(8), ggatec(8), ggated(8), mount(8), newfs(8)

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

FreeBSD	9.2			April 26, 2004			   FreeBSD 9.2

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

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

home | help