code: 9ferno

ref: e81c54ba2ecc673a4d5f8aed0e9b52841fe07b0d
dir: /man/1/grid-register/

View raw version
.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)