NETGET(1) NETGET(1)
NAME
netget - octopus network resource register tool
SYNOPSIS
netget [ -d ] [ -r regdir ] name spec ...
DESCRIPTION
Netget registers the resource named name with attributes as
specified in spec into the registry. The registry is found
by trying /mnt/registry, or the directory regdir given to
the -r flag. If the registry is not found and -r was not
used, the module dials tcp!pc!registry to mount the registry
listening there.
The program updates the registry entry once in a while,
updating atrributes that reflect the location and the radius
(round trip time in milliseconds) to the PC. More than one
resource may be given in the command line (two arguments
each, as said), to create multiple entries in the registry.
Entries registered by netget are subject to leasing because
the program adds a lease attribute to them, and refresh it
along with location and radius to the PC to renew the lease.
The lease interval is set to twice the refresh rate (one
minute in the current implementation).
A resource is specified by a pair of name and spec (both
strings). Where name is the name for a network gadget, for
example, audio. Netget defines the attribute name wich such
name. The name used in the registry for the resource would
be o! followed by name followed by the system name, like in
o!audio!$sysname. The convention is that the name includes
the system name for the machine providing the resource after
the resource name, as shown.
The spec argument is a set of attribute/value pairs, in a
single argument string, separated by white space. At least
one attribute named path is expected in the octopus, whose
value must be the path for the resource in the terminal pro-
viding the resource (see the example below). Netreg adds
/terms/$sysname before the path attribute suppied, to make
it portable across terminals and to ensure that all such
attributes are homogeneous.
The program adds attributes sys (with the sysname name),
user (with the user name for the user running the program),
loc (with the location as for the machine as said in
/pc/what/$sysname/where ), rad (with the radius for the ser-
vice, ie., milliseconds of RTT to the central PC), and arch
(with a string reflecting the host architecture and system
NETGET(1) NETGET(1)
name).
EXAMPLE
Register the directory /what from the terminal in the cen-
tral PC:
o/netget what 'path /what'
SOURCE
/usr/octopus/port/lib/netget.b