RENDEZVOUS(2)                                       RENDEZVOUS(2)

     NAME
          rendezvous - user level process synchronization

     SYNOPSIS
          ulong rendezvous(ulong tag, ulong value)

     DESCRIPTION
          The rendezvous system call allows two processes to synchro-
          nize and exchange a value.  In conjunction with the shared
          memory system calls (see segattach(2) and fork(2)), it
          enables parallel programs to access the system scheduler.

          Two processes wishing to synchronize call rendezvous with a
          common tag, typically an address in memory they share.  One
          process will arrive at the rendezvous first; it suspends
          execution until a second arrives.  When a second process
          meets the rendezvous the value arguments are exchanged
          between the processes and returned as the result of the
          respective rendezvous system calls.  Both processes are
          awakened when the rendezvous succeeds.

          The tag space is common to processes in the same file name
          space.

          If a rendezvous is interrupted the return value is ~0, so
          that value should not be used in normal communication.

     SEE ALSO
          segattach(2), fork(2)

     DIAGNOSTICS
          Sets errstr.

     Page 1                       Plan 9             (printed 4/16/24)