ref: 54bac038f411c10a596adf84c06df32f8c7c4c53
dir: /man/1/grid-register/
.TH GRID-REGISTER 1
.SH NAME
grid: register \- registers a resource with a known
.IR registry (4)
.SH SYNOPSIS
.B grid/register [
.I option ...
.B ] {
.I command ...
.B }
.SH DESCRIPTION
.I Register
takes a program that serves a namespace using the 9P protocol on its standard input
and registers it with a known
.IR registery (4).
(See
.IR intro (5)
for a description of the protocol.)
It then marshals the service by listening for incoming connections and exporting the namespace across them.
.I Register
prints out various status messages to
.I stdout
in the form which may be read by
.IR grid-monitor (1).
.SH OPTIONS
.TP 17
.BI -u " maxusers"
Specifies the maximum number of connections to the resource at any one time. If not given, any number of connections are allowed.
.TP
.BI -e " n"
Tells
.I register
to exit after the last connection has gone away.
.I N
is a threshold value, so that
.I register
will not exit upon the last connection going away until the number of incoming connections has reached at least
.I n.
.TP
.BI -a " 'name=value'"
Specifies the name and value of an attribute to be listed as belonging to the resource when registered with the
.IR registry (4).
.TP
.BI -A " address"
Allows the user to specify the address for the service to announce on.
.I Address
takes the form
.BI tcp! machine ! port
.TP
.B -m
Includes the amount of free main memory as part of the attributes list.
.SH SOURCE
.B /appl/grid/register.b
.SH "SEE ALSO"
.IR registries (2),
.IR registry (4),
.IR grid-localreg (1)