The dpjoin man page







NAME
     dpjoin - make DP initializations

SYNOPSIS
     #include 

     int dpjoin(path, semantic, semsize, hostid)
     char *path, *semantic;
     int  *semsize, *hostid;

DESCRIPTION
     Any UNIX(r) process other than those created by an  existent
     DP  process  may  join  in  a DP process pool, provided that
     there is already a DP process running on the host  and  that
     the process has called dpinvite() to set up a contact file.

     dpjoin() is the DP function to call for a running UNIX  pro-
     cess to enroll as a DP process.  It performs functions simi-
     lar to those done by dpinit().  The major difference between
     the  two  calls  is that dpjoin() sets up its DP environment
     according  to  the  content  of  the  contact  file  whereas
     dpinit() does necessary preparations from messages sent over
     by the spawning process.  A process that calls dpjoin()  may
     not  call  dpinit()  (since  a  joiner  does not have a true
     "parent").

     path is the name (absolute or relative) of the contact file;
     it's  application-dependent.   semantic  is  a  pointer to a
     buffer in which dpjoin() returns the semantic string of size
     semsize.  In  hostid  is  returned  the  entry number of the
     current host in the host table inherited  from  the  contact
     file.

RETURN VALUES
     Upon success, dpjoin() returns the number of  hosts  in  the
     host  table.   If  any error occurs, the process will simply
     exit to system.

REMARK
     This is a DP function call.

AUTHOR
     David Arnow

FILES
     /usr/include/dp/dp.h - DP header file
     /usr/lib/libdp.a     - DP library file

SEE ALSO
     dpinvite(3DP), dpinit(3DP), dpgetpid(3DP)





Essential DP MAN Pages:

General/Essential:


Non-Interrupting Messages:


Interrupting Messages:
  • dpblock
  • dpcatchmsg
  • dpgetmsg
  • dppause
  • dpunblock

    Other:
    Return to DP For Students Return to The DP Project Return to David Arnow's Home Page