ref: 354b56d6bfdca067a6f04a39c4ce4bc9c0160861
dir: purgatorio/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)