Provided by: lam4-dev_7.1.2-2build1_i386 bug

NAME

       procschema - LAM process schema format

SYNTAX

       #
       # comment
       #
       <program> [$delay] [$inet_topo] [<arguments>]
       <program> [$delay] [$inet_topo] [<arguments>]
        ...

DESCRIPTION

       Most LAM/MPI users can disregard this page.

       A  process  schema (once ambiguously called a configuration file) lists
       the programs that will constitute the LAM environment on  a  particular
       node.  It drives the operation of hboot(1).  LAM system developers will
       find process schemata very useful  for  debugging  and  for  generating
       custom systems.  By convention these files begin with the prefix conf.

       The  default  process schema selected by lamboot(1) (conf.lam) contains
       only one program, the LAM daemon (lamd).  A one program process  schema
       makes  the  whole  business  of  process  schemata  and hboot(1) rather
       redundant.  LAM can also be run in a de-clustered mode with the  daemon
       reduced  to  a  simple  local message-passing server (the "kernel") and
       several system clients for network message-passing and remote services.
       This form of LAM is described in the process schema, conf.otb.

       The  syntax is line oriented.  Comments begin with # and terminate with
       a newline.

       Process lines consist  of  a  filename,  command  line  arguments,  and
       possibly   options   and  substitution  variables.   The  command  line
       arguments are passed to the process when it is  started.   The  process
       options  control  how  the  process  is  started.   Currently supported
       process options are:

       $delay        After starting the process,  pause  before  starting  the
                     next process.

       Substitution  variables are set by the tools that interpret the process
       schema and are a way  of  customizing  the  process  at  runtime.   See
       hboot(1).  Currently supported substitution variables are:

       $inet_topo    typically,   command-line   arguments  for  LAM  Internet
                     datalink processes

       $rtr_topo     typically, command-line arguments  for  the  LAM  network
                     information process

       The  programs  found  in  the  LAM  de-clustered  mode  process schema,
       conf.otb, are listed below.

       bufferd     Creates, kills, sweeps, and states buffers.
       bforward    Forward messages; helper for bufferd.
       died        Monitors for death of user processes.
       dli_inet    UDP/IP incoming connection to other nodes
       dlo_inet    UDP/IP outgoing connection to other nodes
       echod       Echoes messages; can be used to test nodes and links.
       filed       Serves file access.
       flatd       Provides symbolic access to node memory.
       kenyad      Controls and monitors processes.
       kernel      Coordinates local message-passing.
       loadd       Loads executable files onto nodes.
       router      Maintains network information.
       traced      Collects and transports trace data.

       Processes are started in the order given in the process schema, and for
       LAM, the order is important.  In particular, the kernel must be first.

EXAMPLE

       The de-clustered debug mode LAM process schema is shown below:

       ##
       ## The kernel is listed first.
       ##
       kernel $delay

       ##
       ## daemons
       ##
       router
       kenyad
       dli_inet $inet_topo
       dlo_inet
       bufferd
       bforward
       loadd
       echod
       flatd
       filed
       traced

FILES

       $LAMHOME/etc/lam-conf.lamd        default     process     schema    for
                                         lamboot(1),  where  $LAMHOME  is  the
                                         installation directory

       $LAMHOME/etc/lam-conf.separate    default process schema for hboot(1)

SEE ALSO

       lamboot(1), hboot(1)