File: PVM.barrier.Rd

package info (click to toggle)
rpvm 0.6.2-2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 440 kB
  • ctags: 90
  • sloc: ansic: 1,075; sh: 57; makefile: 12
file content (52 lines) | stat: -rw-r--r-- 1,644 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
\name{PVM.barrier}
\alias{.PVM.barrier}
\title{Group synchronization}
\description{
 Blocks the calling process until all processes in a group have called
 it.
}
\usage{
.PVM.barrier (group, count = .PVM.gsize (group))
}
\arguments{
  \item{group}{a character string naming the group}
  \item{count}{the number of group members that must call
    \code{.PVM.barrier} before they are all released, usually the total
    number of members of the specified group.}
}
\value{
  None.
}
\details{
  \code{.PVM.barrier} blocks the calling process until count members of
  the group have called it.  The count argument is required because
  processes could be joining the given group after other processes have
  called \code{.PVM.barrier}.  Thus PVM doesn't know how many group
  members to wait for at any given instant. Although count can be set
  less, it is typically the total number of members of the group.  So
  the logical function of the \code{.PVM.barrier} call is to provide a
  group synchronization.  During any given barrier call all
  participating group members must call barrier with the \emph{same} count
  value.  Once a given barrier has been successfully passed,
  \code{.PVM.barrier} can be called again by the same group using the
  same group name.
}
\references{
  PVM documentation
}
\seealso{
  \code{\link{.PVM.joingroup}}
}
\examples{
gname <- "pvmtest"
\dontrun{myinst <- .PVM.joingroup (gname)}
# do something here ...
\dontrun{.PVM.barrier (gname, 5)}
}
\author{
  Na (Michael) Li \email{nali@umn.edu} and
  A.J. Rossini \email{rossini@u.washington.edu}
}
\keyword{utilities}
\keyword{connection}
\keyword{interface}