1DELHOSTS(3PVM)                  PVM Version 3.4                 DELHOSTS(3PVM)
2
3
4

NAME

6       pvm_delhosts - Deletes hosts from the virtual machine.
7
8

SYNOPSIS

10       C    int info = pvm_delhosts( char **hosts, int nhost, int *infos )
11
12       Fortran   call pvmfdelhost( host, info )
13
14

PARAMETERS

16       hosts   An  array of pointers to character strings containing the names
17               of the machines to be deleted.
18
19       nhost   Integer specifying the number of hosts to be deleted.
20
21       infos   Integer array of length nhost which contains  the  status  code
22               returned  by the routine for the individual hosts.  Values less
23               than zero indicate an error.
24
25       host    Character string containing the  name  of  the  machine  to  be
26               deleted.
27
28       info    Integer  status code returned by the routine.  Values less than
29               nhost indicate partial failure, values  less  than  1  indicate
30               total failure.
31
32

DESCRIPTION

34       The routine pvm_delhosts deletes the computers pointed to in hosts from
35       the existing configuration of computers making up the virtual  machine.
36       All PVM processes and the pvmd running on these computers are killed as
37       the computer is deleted.  If pvm_delhosts is successful, info  will  be
38       nhost.   Partial  success  is  indicated by 1<= info < nhost, and total
39       failure by info < 1.  The array infos can be checked to determine which
40       host caused the error.
41
42       The Fortran routine pvmfdelhost deletes a single host from the configu‐
43       ration with each call.
44
45       If a host fails, the PVM system will  continue  to  function  and  will
46       automatically  delete  this host from the virtual machine.  An applica‐
47       tion can be notified of a host failure by calling  pvm_notify.   It  is
48       still  the  responsibility  of  the  application  developer to make his
49       application tolerant of host failure.
50
51

EXAMPLES

53       C:
54            static char *hosts[] = {
55                 "sparky",
56                 "thud.cs.utk.edu",
57            };
58            int status[2];
59            info = pvm_delhosts( hosts, 2, status );
60
61       Fortran:
62            CALL PVMFDELHOST( 'azure', INFO )
63
64

ERRORS

66       These error conditions can be returned by pvm_delhosts
67
68       PvmBadParam
69              giving an invalid argument value.
70
71       PvmSysErr
72              local pvmd not responding.
73

SEE ALSO

75       pvm_addhosts(3PVM), pvm_notify(3PVM)
76
77
78
79                                30 August, 1993                 DELHOSTS(3PVM)
Impressum