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

NAME

6       pvm_config - Returns information about the present virtual machine con‐
7       figuration.
8
9

SYNOPSIS

11       C    int info = pvm_config( int *nhost, int *narch, struct pvmhostinfo **hostp )
12            struct pvmhostinfo {
13                 int  hi_tid;
14                 char *hi_name;
15                 char *hi_arch;
16                 int  hi_speed;
17            };
18
19       Fortran   call pvmfconfig( nhost, narch, dtid, name, arch, speed, info )
20
21

PARAMETERS

23       nhost   Integer returning the number of hosts (pvmds)  in  the  virtual
24               machine.
25
26       narch   Integer  returning  the  number of different data formats being
27               used.
28
29       hostp   Returns pointer to an array of structures which contain  infor‐
30               mation about each host including its pvmd task ID, name, archi‐
31               tecture, and relative speed.
32
33       dtid    Integer returning pvmd task ID for host
34
35       name    Character string returning name of host
36
37       arch    Character string returning architecture name of host
38
39       speed   Integer returning relative speed  of  host.  Default  value  is
40               1000.
41
42       info    Integer  status code returned by the routine.  Values less than
43               zero indicate an error.
44
45

DESCRIPTION

47       The routine pvm_config returns information about  the  present  virtual
48       machine. The information returned is similar to that available from the
49       console command conf.
50
51       The C function returns information about the entire virtual machine  in
52       one  call.  The Fortran function returns information about one host per
53       call and cycles through all the hosts.  Thus, if pvmfconfig  is  called
54       nhost times, the entire virtual machine will be represented.
55
56       Note that in C the hostp array is allocated and owned by libpvm.  It is
57       automatically freed or reused on the next call to pvm_config.
58
59       Note that in Fortran the reported value of nhost and the  host configu‐
60       ration do not change until the function resets at the end of a complete
61       cycle.  The user can reset pvmfconfig() at any time by calling it  with
62       nhost = -1.
63
64       If pvm_config is successful, info will be 0.  If some error occurs then
65       info will be < 0.
66
67

EXAMPLES

69       C:
70            struct pvmhostinfo *hostp;
71            int i, nhost, narch;
72
73            info = pvm_config( &nhost, &narch, &hostp );
74            for (i = 0; i < nhost; i++)
75                 printf("%s\n", hostp[i].hi_name);
76
77       Fortran:
78            Do i=1, NHOST
79              CALL PVMFCONFIG( NHOST,NARCH,DTID(i),HOST(i),ARCH(i),SPEED(i),INFO )
80            Enddo
81
82

ERRORS

84       The following error condition can be returned by pvm_config
85
86       PvmSysErr
87              pvmd not responding.
88

SEE ALSO

90       pvm_tasks(3PVM)
91
92
93
94                                31 August, 1994                   CONFIG(3PVM)
Impressum