@@ -10,7 +10,6 @@ CFLAGS+= -DMAX_SEND_SIZE=32768 | |||||
CFLAGS+= -DLIBGEOM | CFLAGS+= -DLIBGEOM | ||||
CFLAGS+= -I${.CURDIR}/../shared | CFLAGS+= -I${.CURDIR}/../shared | ||||
DPADD= ${LIBGEOM} ${LIBSBUF} ${LIBBSDXML} ${LIBUTIL} ${LIBPTHREAD} | |||||
LDADD= -lgeom -lsbuf -lbsdxml -lutil -lpthread | |||||
LIBADD= geom util pthread | |||||
.include <bsd.prog.mk> | .include <bsd.prog.mk> |
@@ -24,7 +24,7 @@ | |||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd April 26, 2004 | |||||
.Dd April 2, 2015 | |||||
.Dt GGATEC 8 | .Dt GGATEC 8 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
@@ -67,29 +67,29 @@ | |||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm | .Nm | ||||
utility is a network client for GEOM Gate class. | |||||
It is responsible for creation of | |||||
utility is a network client for the GEOM Gate class. | |||||
It is responsible for the creation of | |||||
.Nm ggate | .Nm ggate | ||||
devices and forwarding I/O requests between | |||||
devices and forwarding I/O requests between the | |||||
.Nm geom_gate.ko | .Nm geom_gate.ko | ||||
kernel module and | |||||
kernel module and the | |||||
.Xr ggated 8 | .Xr ggated 8 | ||||
network daemon. | network daemon. | ||||
Available commands: | Available commands: | ||||
.Bl -tag -width ".Cm destroy" | .Bl -tag -width ".Cm destroy" | ||||
.It Cm create | .It Cm create | ||||
Connect to given | |||||
Connect to a | |||||
.Xr ggated 8 | .Xr ggated 8 | ||||
daemon and create a | |||||
daemon on the specified host and create a | |||||
.Nm ggate | .Nm ggate | ||||
provider related to the given remote file or device. | |||||
provider for the specified remote file or device. | |||||
.It Cm rescue | .It Cm rescue | ||||
If | |||||
Create a new connection after the | |||||
.Nm | .Nm | ||||
process died/has been killed, you can save situation with this | |||||
command, which creates new connection to the | |||||
process has died or been killed. | |||||
The new connection to the | |||||
.Xr ggated 8 | .Xr ggated 8 | ||||
daemon and will handle pending and future requests. | |||||
daemon handles pending and future requests. | |||||
.It Cm destroy | .It Cm destroy | ||||
Destroy the given | Destroy the given | ||||
.Nm ggate | .Nm ggate | ||||
@@ -139,12 +139,11 @@ provider. | |||||
If not specified, it is taken from device, or set to 512 bytes for files. | If not specified, it is taken from device, or set to 512 bytes for files. | ||||
.It Fl t Ar timeout | .It Fl t Ar timeout | ||||
Number of seconds to wait before an I/O request will be canceled. | Number of seconds to wait before an I/O request will be canceled. | ||||
0 means no timeout. | |||||
Default is 0. | |||||
Default is 0, which means no timeout. | |||||
.It Fl u Ar unit | .It Fl u Ar unit | ||||
Unit number to use. | Unit number to use. | ||||
.It Fl v | .It Fl v | ||||
Do not fork, run in foreground and print debug informations on standard | |||||
Do not fork, run in foreground and print debug information on standard | |||||
output. | output. | ||||
.It Ar host | .It Ar host | ||||
Remote host to connect to. | Remote host to connect to. | ||||
@@ -159,7 +158,7 @@ should be called with the | |||||
.Fl v | .Fl v | ||||
option. | option. | ||||
.Sh EXAMPLES | .Sh EXAMPLES | ||||
Make use of CD-ROM device from remote host. | |||||
Use a CD-ROM device on a remote host. | |||||
.Bd -literal -offset indent | .Bd -literal -offset indent | ||||
server# cat /etc/gg.exports | server# cat /etc/gg.exports | ||||
client RO /dev/acd0 | client RO /dev/acd0 | ||||
@@ -6,8 +6,7 @@ PROG= ggated | |||||
MAN= ggated.8 | MAN= ggated.8 | ||||
SRCS= ggated.c ggate.c | SRCS= ggated.c ggate.c | ||||
DPADD= ${LIBPTHREAD} | |||||
LDADD= -lpthread | |||||
LIBADD= pthread | |||||
CFLAGS+= -I${.CURDIR}/../shared | CFLAGS+= -I${.CURDIR}/../shared | ||||
@@ -9,7 +9,6 @@ SRCS= ggatel.c ggate.c | |||||
CFLAGS+= -DLIBGEOM | CFLAGS+= -DLIBGEOM | ||||
CFLAGS+= -I${.CURDIR}/../shared | CFLAGS+= -I${.CURDIR}/../shared | ||||
DPADD= ${LIBGEOM} ${LIBSBUF} ${LIBBSDXML} ${LIBUTIL} | |||||
LDADD= -lgeom -lsbuf -lbsdxml -lutil | |||||
LIBADD= geom util | |||||
.include <bsd.prog.mk> | .include <bsd.prog.mk> |
@@ -24,7 +24,7 @@ | |||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd April 2, 2011 | |||||
.Dd April 9, 2015 | |||||
.Dt GGATEL 8 | .Dt GGATEL 8 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
@@ -40,12 +40,6 @@ | |||||
.Op Fl u Ar unit | .Op Fl u Ar unit | ||||
.Ar path | .Ar path | ||||
.Nm | .Nm | ||||
.Cm attach | |||||
.Op Fl v | |||||
.Op Fl o Cm ro | wo | rw | |||||
.Fl u Ar unit | |||||
.Ar path | |||||
.Nm | |||||
.Cm destroy | .Cm destroy | ||||
.Op Fl f | .Op Fl f | ||||
.Fl u Ar unit | .Fl u Ar unit | ||||
@@ -53,6 +47,12 @@ | |||||
.Cm list | .Cm list | ||||
.Op Fl v | .Op Fl v | ||||
.Op Fl u Ar unit | .Op Fl u Ar unit | ||||
.Nm | |||||
.Cm rescue | |||||
.Op Fl v | |||||
.Op Fl o Cm ro | wo | rw | |||||
.Fl u Ar unit | |||||
.Ar path | |||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm | .Nm | ||||
@@ -70,10 +70,6 @@ Available commands: | |||||
Create a | Create a | ||||
.Nm ggate | .Nm ggate | ||||
provider related to the given regular file or device. | provider related to the given regular file or device. | ||||
.It Cm attach | |||||
Attach a worker process to an existing | |||||
.Nm ggate | |||||
provider. | |||||
.It Cm destroy | .It Cm destroy | ||||
Destroy the given | Destroy the given | ||||
.Nm ggate | .Nm ggate | ||||
@@ -82,6 +78,12 @@ provider. | |||||
List | List | ||||
.Nm ggate | .Nm ggate | ||||
providers. | providers. | ||||
.It Cm rescue | |||||
Take over a previously created provider and handle pending and future | |||||
requests. This is useful if the initial | |||||
.Nm | |||||
process died. To prevent data loss, the given path must lead to the | |||||
regular file or device that was used to create the provider. | |||||
.El | .El | ||||
.Pp | .Pp | ||||
Available options: | Available options: | ||||
@@ -111,7 +113,7 @@ Default is 30. | |||||
.It Fl u Ar unit | .It Fl u Ar unit | ||||
Unit number to use. | Unit number to use. | ||||
.It Fl v | .It Fl v | ||||
Do not fork, run in foreground and print debug informations on standard | |||||
Do not fork, run in foreground and print debug information on standard | |||||
output. | output. | ||||
.It Ar path | .It Ar path | ||||
Path to a regular file or device. | Path to a regular file or device. | ||||