GGATEL(8) MidnightBSD System Manager’s Manual GGATEL(8)
ggatel — GEOM Gate local control utility
ggatel create [−v]
[−o ro | wo | rw]
[−u unit] path
ggatel attach [−v] [−o ro | wo | rw] −u unit path
ggatel destroy [−f] −u unit
ggatel list [−v] [−u unit]
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.
Create a ggate provider related to the given regular file or device.
Attach a worker process to an existing ggate provider.
Destroy the given ggate provider.
List ggate providers.
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.
Number of pending I/O requests that can be queued before they will start to be canceled. Default is 1024.
Sector size for ggate provider. If not specified, it is taken from device, or set to 512 bytes for files.
Number of seconds to wait before an I/O request will be canceled. 0 means no timeout. Default is 30.
Unit number to use.
Do not fork, run in foreground and print debug informations on standard output.
Path to a regular file or device.
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.
‘‘GEOMify’’ the ‘‘fd0’’ device and use gbde(8) to encrypt data on a floppy.
ggatel create -u 5
gbde init /dev/ggate5
gbde attach ggate5
mount /dev/ggate5.bde /secret
cp /private/foo /secret/
gbde detach ggate5
ggatel destroy -u 5
geom(4), gbde(8), ggatec(8), ggated(8), mount(8), newfs(8)
The ggatel utility as well as this manual page was written by Pawel Jakub Dawidek 〈pjd@FreeBSD.org〉.
MidnightBSD 0.3 April 26, 2004 MidnightBSD 0.3