Flashnux

GNU/Linux man pages

Livre :
Expressions régulières,
Syntaxe et mise en oeuvre :

ISBN : 978-2-7460-9712-4
EAN : 9782746097124
(Editions ENI)

GNU/Linux

RedHat 6.2

(Zoot)

reginfo(1)


REGINFO

REGINFO

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
BUGS
AUTHOR

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).



reginfo(1)