REGINFO(1)

NAME
reginfo - find registered hosts in a customs network

SYNOPSIS
reginfo [-hosts] [-rate] [-showattr] [-avail] [-up] [-down] [-master] [-arch number] [-attr value ...] [-port number] [host]

DESCRIPTION

Reginfo is used to find out what hosts are registered in a network of customs(8) agents, where the master agent is, and what the status of the registered hosts is. A typical output looks like this:

HOST          ARCH   STATUS                INDEX   CLIENTS
icsia            5   load average too high         icsia
icsib1           4   available               259   ALL
icsib10          4   load average too high         ALL
icsib11          5 L available              2156   ALL
icsib53          5 M available              1212   ALL
icsib54          5   available              2560   ALL
icsie            5   available               168   icsie
rap              4   available              1872   rap
rap2             4   available              2048   rap2
unrap            4   available              2048   unrap
Network 1: 10 host(s) total, 4 available unrestricted, 4 restricted, 0 down

For each registered host, you are given

1)  its name.

2)  its architecture code. As explained in customs(8), this code is simply a number that indicates what machines have the same architecture/operating system. In the example above, sun4 machines have been assigned arch=4, whereas sun4c hosts have arch=5. This feature is used by the .EXPORTSAME pseudo-target in pmake(1).

3)  its availability status. This will either be available or a message indicating why the host is unavailable. The index serves to rank machines according to available CPU power. It is a function of the MIPS rating of the machine, the current load, and the number of jobs already exported to that host.

4)  the machines from which it is willing to accept jobs. This can be ALL or a list of acceptable machines. Servers typically accept jobs only from themselves (i.e., no at all), while workstations are open to receive jobs from all other machines.

A single letter in the third output column indicates whether the host currently serves as the master agent of the customs network (`M') or was the host last allocated (`L') for job exportation.

The last line of output gives the network number of the customs network listed, as specified by the -net option to customs(8), as well as a summary of host availability. `Restricted' hosts refers to those that are available, but don't allow imports from ALL.

The -rate flag sorts the output by availability rating (instead of by hostname) and suppresses unavailable host altogether.

The flags -avail, -up and -down restrict the host listing to machines that are available, up, and down, respectively.

The -master option lists only the current master agent for the customs network.

The flag -arch restricts the listing to machines of the given architecture number.

One or more -attr flags restrict the listing to those hosts having the specified attributes. The sematics of these arguments is the same as for export(1).

The -hosts flag causes reginfo to print only hostnames, without any additional information, header, or summary information. This is useful mainly in scripts to generate lists of customs hosts (possibly selecting for attributes).

The -showattr flag lets reginfo list the hosts' attributes instead of the STATUS, INDEX and CLIENTS information.

The optional host and -port number arguments can be used to specify a customs network other than the local one or a port different from the locally known "customs" service. Host is either an IP number or a hostname. Number is either a port number or a UDP service name.

SEE ALSO
customs(8), cctrl(8), importquota(8), pmake(1), logd(8), export(1)

BUGS
When hosts change their name or address the master will not notice the renaming until the next election (which may be forced using cctrl(8)). This does not affect customs operation, only the display of reginfo information.

AUTHOR
Adam de Boor, adam@bsw.uu.net (...!uunet!bsw!adam).
Bugfixes and enhancements by Andreas Stolcke (stolcke@icsi.berkeley.edu).