ibis.ipl
Interface ResizeHandler

public interface ResizeHandler

Describes the upcalls that are generated for the Ibis group management of a run. At most one of the methods in this interface will be active at any time (they are serialized by ibis). These upcalls must be explicitly enabled, by means of the Ibis.enableResizeUpcalls() method. The following also holds:
- For any given Ibis identifier, at most one joined() call will be generated.
- For any given Ibis identifier, at most one left() call will be generated.
- An Ibis instance will also receive a joined() upcall for itself.

Method Summary

void	died(IbisIdentifier corpse) Upcall generated when an Ibis instance crashed or was killed, implicitly removing it from the current run.
void	joined(IbisIdentifier ident) Upcall generated when an Ibis instance joined the current run.
void	left(IbisIdentifier ident) Upcall generated when an Ibis instance voluntarily left the current run.
void	mustLeave(IbisIdentifier[] ibisses) Upcall generated when one or more Ibisses are ordered to leave.

Method Detail

joined

public void joined(IbisIdentifier ident)

Upcall generated when an Ibis instance joined the current run.

Parameters:

ident - the ibis identifier of the Ibis instance that joined the current run.

left

public void left(IbisIdentifier ident)

Upcall generated when an Ibis instance voluntarily left the current run.

Parameters:

ident - the ibis identifier of the Ibis instance that left the current run.

died

public void died(IbisIdentifier corpse)

Upcall generated when an Ibis instance crashed or was killed, implicitly removing it from the current run.

Parameters:

corpse - the ibis identifier of the dead Ibis instance.

mustLeave

public void mustLeave(IbisIdentifier[] ibisses)

Upcall generated when one or more Ibisses are ordered to leave. An ibis may be given some time to leave before it is actually forced to quit. A left or died signal will be issued when the node actually leaves the run, depending on if it left in time, or was explicitly killed.

Parameters:

ibisses - the ibisses which are told to leave. Multiple ibisses may be ordered to leave when, for instance, an entire cluster is killed.