← Back to branch summary

~ubuntu-branches/ubuntu/hoary/scilab/hoary

« back to all changes in this revision

Viewing changes to man/pvm/pvm_spawn_independent.cat

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2005-01-09 22:58:21 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050109225821-473xr8vhgugxxx5j
Tags: 3.0-12
http://bugs.debian.org/255869
changed configure.in to build scilab's own malloc.o, closes: #255869

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/pvm/pvm_spawn_independent.cat
1
 
pvm_spawn_independent Scilab // Group Scilab function pvm_spawn_independent
2
 
NAME
3
 
   pvm_spawn_independent - Starts new PVM processes.
4
 
  
5
 
CALLING SEQUENCE
6
 
 [tids, numt] = pvm_spawn_independent(task,  ntask, [where])
7
 
PARAMETERS
8
 
 task: string, which is the executable file name of the PVM process to be
9
 
       started. The executable must already reside on the host on which it
10
 
       is to be started.  The name may be a file in the PVM search path or
11
 
       an absolute path.  The default PVM search path is
12
 
       $HOME/pvm3/bin/$PVM_ARCH/ .
13
 
       
14
 
 ntask:
15
 
        integer, specifying the number of copies of the executable file to start.
16
 
       
17
 
 where:
18
 
        string (optional), can be a host name such as ``tequila.ens-lyon.fr'' or
19
 
       a PVM architecture class such as ``SUN4''.
20
 
       
21
 
 numt: integer, the actual number of tasks started.  Values less than zero
22
 
       indicate a system error.
23
 
       
24
 
      tids:  row of integers, array of the tids of the PVM processes
25
 
       started by this pvm_spawn_independent call.
26
 
       
27
 
DESCRIPTION
28
 
   pvm_spawn_independent  starts
29
 
  
30
 
   copies of the executable named 
31
 
  
32
 
   On systems that support environment, spawn passes selected variables from
33
 
  parent environment to children tasks.  If set, the envar PVM_EXPORT is
34
 
  passed.  If PVM_EXPORT contains other names (separated by ':') they will
35
 
  be passed too.  This is useful for e.g.:
36
 
  
37
 
 
38
 
  setenv DISPLAY myworkstation:0.0
39
 
  setenv MYSTERYVAR 13
40
 
  setenv PVM_EXPORT DISPLAY:MYSTERYVAR
41
 
   The hosts on which the PVM processes are started are determined by the
42
 
  
43
 
   arguments. On return the array
44
 
  
45
 
   contains the PVM task identifiers for each process started.
46
 
  
47
 
   If pvm_spawn_independent starts one or more tasks,
48
 
  
49
 
   will be the actual number of tasks started.  If a system error occurs
50
 
  then
51
 
  
52
 
   will be < 0. If
53
 
  
54
 
   is less than
55
 
  
56
 
   then some executables have failed to start and the user should check the
57
 
  last
58
 
  
59
 
   locations in the
60
 
  
61
 
   array which will contain error codes (see below for meaning).  The first
62
 
  
63
 
   tids in the array are always valid.
64
 
  
65
 
   When the argument
66
 
  
67
 
   is omitted  a heuristic (round-robin assignment) is used to distribute
68
 
  the
69
 
  
70
 
   processes across the virtual machine.
71
 
  
72
 
   In the special case where a multiprocessor is specified by
73
 
  
74
 
   pvm_spawn_independent will start all
75
 
  
76
 
   copies on this single machine using the vendor's underlying routines.  
77
 
  
78
 
EXAMPLE
79
 
 [tids, numt] = pvm_spawn_independent("a.out",2)
80
 
SEE ALSO
81
 
   pvm, pvm_spawn
82