ggatel man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD logo
[printable version]

GGATEL(8)		  BSD 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.

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

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

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

BSD				April 26, 2004				   BSD
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net