code: 9ferno

ref: 600bbfe4aaa9ad0f73d8d73eef1b7670e5f7d3a3
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)