.TH MKLOCALREG 1
.SH NAME
mklocalreg
.SH SYNOPSIS
g/mklocalreg NAME PORT
.SH DESCRIPTION
mklocalreg creates a local service registry that can be exported to allow other grid clients to register services. It implements a small subset of the functions and semantics of the inferno registry. The command creates a registry and starts a listener exporting it. The registry is created as a directory within /tmp/grid/localreg containing two files, index and new. The index file stores the registry of services announced to it, the new file is where clients write their announcements. After the registry is created, it should be announced to other registries using g/tellreg. The registry is created with 'reg' prefixed to the given name. New services written by clients to 'new' are transferred to the index file once per minute. Note that unlike the inferno registry, the system does not automatically remove index entries for clients that go offline, so manual cleaning of outdated entries is necessary at this point.
.SH SOURCE
/bin/g
.SH BUGS
The mklocalreg commands make a registry with similar semantics, but reduced functionality compared to the inferno registry. In particular, the inferno registry maintains a continuous connection with clients via an open file descriptor, enabling automatic removal of services when the node providing them goes offline. Providing a more fully featured and compatible registry from Plan 9 nodes would be an improvement.
