pvm_intro (1)

Leading comments

$Id: pvm_intro.1,v 1.7 2007/01/03 20:13:15 pvmsrc Exp $

(The comments found at the beginning of the groff file "man1/pvm_intro.1PVM".)

NAME

PVM, pvm_intro - Parallel Virtual Machine System Version 3

DESCRIPTION

PVM is a software system that enables a collection of heterogeneous computers to be used as a coherent and flexible concurrent computational resource.
The individual computers may be shared- or local-memory multiprocessors, vector supercomputers, specialized graphics engines, or scalar workstations, that may be interconnected by a variety of networks, such as ethernet, FDDI.
User programs written in C, C++ or Fortran access PVM through library routines (libpvm3.a and libfpvm3.a).
Daemon programs (pvmd3) provide communication and process control between computers.

MACHINE ARCHITECTURE

In the PVM system, machines are assigned a short string to identify their architectures (this includes operating system type as well as CPU type). The types currently predefined in the distribution are:

AFX8

Alliant FX/8

ALPHA

DEC Alpha/OSF-1

ALPHAMP

DEC Alpha/OSF-1 / using shared memory

AIX46K

IBM/RS6000 / AIX 4.x

AIX4MP

IBM SMP / shared memory transport / AIX 4.x

AIX4SP2

IBM SP-2 / using MPI / AIX 4.x

APOLLO

HP 300 running Domain/OS

ATT

AT&T/NCR 3600 running SysVR4

BAL

Sequent Balance

BFLY

BBN Butterfly TC2000

BSD386

80[345]86 running BSDI or BSD386

CM2

Thinking Machines CM-2 Sun front-end

CM5

Thinking Machines CM-5

CNVX

Convex using IEEE floating-point

CNVXN

Convex using native f.p.

CRAY

Cray

CRAY2

Cray-2

CRAYSMP

Cray S-MP

CSPP

Convex Exemplar

CYGWIN

POSIX emulation layer on top of Windows32

DGAV,DGIX

Data General Aviion

E88K

Encore 88000

FREEBSD

80[345]86 running FreeBSD

HP300

HP 9000 68000 cpu

HPPA

HP 9000 PA-Risc

HPPAMP

HP 9000 PA-Risc / shared memory transport

KSR1

Kendall Square

I860

Intel RX Hypercube

IPSC2

Intel IPSC/2

LINUX

80[345]86 running Linux

LINUXALPHA

DEC Alpha running Linux

LINUXARM

Strogarm running Linux

LINUXHPPA

HP 9000 running Linux

LINUXPPC

PowerPC running Linux

LINUXSPARC

Sparc running Linux

M88K

Motorola M88100 running Real/IX

M88K

Motorola M88100 running Real/IX

MASPAR

Maspar

MIPS

Mips

NETBSDALPHA

DEC Alpha running NetBSD

NETBSDAMIGA

Amiga running NetBSD

NETBSDARM32

Strongarm running NetBSD

NETBSDHP300

HP 300 running NetBSD

NETBSDI386

80[345]86 running NetBSD

NETBSDM68K

Any Motorola 68K running NetBSD

NETBSDMAC68K

Macintosh running NetBSD

NETBSDMIPSEB

Mips EB running NetBSD

NETBSDMIPSEL

Mips EL running NetBSD

NETBSDNS32K

NS32K running NetBSD

NETBSDPMAX

DEC Pmax running NetBSD

NETBSDPOWERPC

PowerPC running NetBSD

NETBSDSH3

SH3 running NetBSD

NETBSDSPARC

Sparc running NetBSD

NETBSDSPARC64

Sparc64 running NetBSD

NETBSDSUN3

SUN 3 running NetBSD

NETBSDVAX

Vax running NetBSD

NEXT

NeXT

OS2

OS/2

PGON

Intel Paragon

PMAX

DEC/Mips arch (3100, 5000, etc.)

RS6K

IBM/RS6000 / AIX 3.x

RS6KMP

IBM SMP / shared memory transport / AIX 3.x

RT

IBM/RT

SCO

80[345]86 running SCO Unix

SGI

Silicon Graphics IRIS

SGI5

Silicon Graphics IRIS running OS 5.0

SGI6

Silicon Graphics IRIS running OS >= 6.0

SGI64

Silicon Graphics IRIS running 64 bit

SGIMP

Silicon Graphics IRIS / OS 5.x / using shared memory

SGIMP6

Silicon Graphics IRIS / OS 6.x / using shared memory

SGIMP64

Silicon Graphics IRIS / 64 bit / using shared memory

SP2MPI

IBM SP-2 / using MPI / AIX 3.x

SUN3

Sun 3

SUN4

Sun 4, 4c, sparc, etc.

SUN4SOL2

Sun 4 running Solaris 2.x

SUNMP

Sun 4 / using shared memory / Solaris 2.x

SX3

NEC SX-3

SYMM

Sequent Symmetry

TITN

Stardent Titan

U370

IBM 3090 running AIX

UTS2

Amdahl running UTS

UVAX

DEC/Microvax

UWARE

Uware

UXPM

Fujitsu running UXP/M

VCM2

Thinking Machines CM-2 Vax front-end

WIN32

Windows 95/98/NT

X86SOL2

80[345]86 running Solaris 2.x

ENVIRONMENT VARIABLES

The following environment variables are read by PVM and may be set in order to customize your PVM environment. To set them, you can add commands to your .cshrc or .profile or equivalent shell startup file. See the manual page for the shell you normally use for information about how to do this. You can also include an appropriate shell startup file stub to set PVM environment variables and to add PVM directories to your execution path. Inert the matching stub file, pvm3/lib/cshrc.stub, pvm3/lib/kshrc.stub or pvm3/lib/bashrc.stub, after your declaration of PVM_ROOT in your shell startup file.
For csh users: Note that setting them in .login does not have the same effect. The .login script file is only read when you are actually logging in, whereas .cshrc is read every time csh starts up. PVM needs to have environment variables set when it starts a slave pvmd with "rsh host pvmd ...", so they must be set in .cshrc.
For those using a shell that doesn't always read a startup script (e.g. sh, ksh), there is another way to set environment variables for PVM. Before running the PVM executables, the pvm and pvmd startup scripts source any commands in $HOME/.pvmprofile if this file exists.
The following environment variables are supported by PVM 3.4.4:

PVM_ROOT

The path where PVM libraries and system programs are installed, for example /usr/local/pvm3 or $HOME/pvm3. This variable must be set on each host where PVM is used in order for PVM to function. There is no default value.

PVM_TMP

The path for PVM temporary files, such as the daemon socket file pvmd.<uid> and the log file pvml.<uid>. Use this environment variable to use a directory other than /tmp (or C:\TEMP on Win32), or to introduce added security by using a protected subdirectory in /tmp that is owned by your userid and cannot be easily corrupted.

PVM_RSH

The path to the "rsh" program on your system, if different than that defined in the $PVM_ROOT/conf/$PVM_ARCH.def configuration file. This environment variable can also be used to replace "rsh" with "ssh" for added security.

PVM_PATH

The execution path to be searched for PVM programs on your system. By default, PVM looks in $HOME/pvm3/bin/$PVM_ARCH and $PVM_ROOT/bin/$PVM_ARCH for your PVM applications. This environment variable does not override the ep= host file option.

PVM_WD

The working directory for spawned PVM programs on your system. By default, PVM spawns your PVM applications in $HOME, but for convenience in accessing data or input files using relative path names, an alternate working directory can be specified. This environment variable does not override the wd= host file option.

PVM_EXPORT

Names of environment variables to export from a parent task to children tasks through pvm_spawn(). Multiple names must be separated by ':'. If PVM_EXPORT is not set, no environment is exported.

PVM_DEBUGGER

The debugger script to use when pvm_spawn() is called with PvmTaskDebug set. The default is $PVM_ROOT/lib/debugger.

PVM_DPATH

The path of the pvmd startup script (default is $PVM_ROOT/lib/pvmd). It is overridden by host file option dx=.
This variable is useful if you use a shell that doesn't automatically execute a startup script (such as .cshrc) to allow setting PVM_ROOT on slave (added) hosts. If you set it to the absolute or relative path of the pvmd startup script (for example /usr/local/pvm3/lib/pvmd or pvm3/lib/pvmd), the script will automatically set PVM_ROOT. Note that for this to work, you must set it to run the pvmd script, not the pvmd3 executable itself.

PVM_WINDPATH

This variable serves the same purpose as the PVM_DPATH above, but specifically for Win32 systems. This second environment variable allows for alternate specification of the path to the pvmd3.exe daemon executable using appropriate DOS file path syntax and environment variables (e.g. %PVM_ROOT%\lib\WIN32\pvmd3.exe).

PVMHOSTFILE

Specifies the path to an optional host file to be used by default when starting PVM. This alleviates the need to manually pass a host file path argument to the "pvm" console or "pvmd" script when starting PVM.

PVMDLOGMAX

Sets the maximum length of the pvmd error log file. Default value is the PVMDLOGMAX parameter in the source, 1 Mbyte.

PVMDDEBUG

Sets the default pvmd debugging mask (as does the pvmd -d option). Value can be in hexadecimal (0x...), octal (0...) or decimal. Used to debug the pvmd (not intended to be used to debug application programs).

PVMTASKDEBUG

Sets the default libpvm debugging mask (as does pvm_setopt(PvmDebugMask, x)). Value can be in hexadecimal (0x...), octal (0...) or decimal. Used to debug libpvm (not intended to be used to debug application programs).

PVMTASK

Sets additional flag bits for the pvm_spawn() library call. Allows override at run time of flags compiled into the pvm_spawn() calls in PVM application, e.g. to turn on PvmTaskDebug for popping up child tasks in a debugger window.

PVMBUFSIZE

Sets the size of the shared memory buffers used by libpvm and the pvmd. The default value is 1048576. If your program composes messages longer than this size, you must increase it.

PVM_VMID

A new feature in PVM 3.4.4 is the concept of a "Virtual Machine ID". You can now set the PVM_VMID environment variable to an arbitrary string (or use the "id=" option in a host file, see man page for pvmd3), and this will distinguish and allow multiple virtual machines to run on the same set of hosts under the same userid. (This feature was originally introduced by SGI in their commercial PVM product, and has now been generalized for the public PVM system.) This feature seems to be something that people often want, and the PVM_VMID is the cleanest way to provide this functionality, rather than overloading the SHAREDTMP compiler flag and other internals.

Setting the PVM_VMID environment variable before starting PVM will create an encapsulated virtual machine with the given VMID name. By default, all other hosts which are added to this virtual machine will inherit the same VMID. If hosts are added to the virtual machine which are running older versions of PVM (prior to 3.4.4), then the VMID will be ignored for those hosts, and hence these machines can only be added to one virtual machine for the given user. The VMID need not be consistent on every host in a virtual machine (although this is not necessarily advisable), and the VMID can be set for individual hosts using the "id=" host file option (see man page for pvmd3).

The following environment variables are used by PVM internally. With the exception of PVM_ARCH, their values should not be modified. This is for information only.

PVM_ARCH

The PVM architecture name of the host on which it is set, used to distinguish between machines with different executable (a.out) formats. Copies of a program for different architectures are installed in parallel directories named for PVM architectures.

PVMSOCK

Is passed from pvmd to spawned task, and gives the address of the pvmd local socket.

PVMEPID

Holds the expected process id of a spawned task exec'd by the pvmd. This is a magic cookie used by the task to identify itself when reconnecting to the pvmd, in order to get the correct task slot.

PVMTMASK

The libpvm trace mask, passed from the pvmd to spawned tasks.

PVMTRCBUF

The libpvm trace buffer size. If specified determines the number of bytes of trace event message buffer to be collected before sending to front-end tracer program.

PVMTRCOPT

The libpvm trace option setting. Determines the level of tracing to be performed on invocations of PVM library calls.

PVMINPLACEDELAY

Used to optimize sending of PvmDataInPlace messages on MPP systems.

PVMKEY

PVM uses this value, combined with the process id, to generate shared-memory segment keys. The default value is your numeric uid. PVM automatically detects collisions when generating a key and picks a new key, so it should almost never need to be set explicitly.

SEE ALSO

aimk(1PVM), pvm(1PVM), pvmd3(1PVM), PVM 3.3 User's Guide and Reference Manual

AUTHORS

A. L. Beguelin [4,5], J. J. Dongarra [1,2], G. A. Geist [2], W. C. Jiang [1], R. J. Manchek [1], B. K. Moore [1], V. S. Sunderam [3]
1. University of Tennessee, Knoxville TN.
2. Oak Ridge National Laboratory, Oak Ridge TN.
3. Emory University, Atlanta GA.
4. Carnegie Mellon University, Pittsburgh PA
5. Pittsburgh Supercomputer Center, Pittsburgh PA