home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume27 / distributed-c-2.1 / part03 / macros.README
Encoding:
Text File  |  1993-12-22  |  3.5 KB  |  91 lines

  1. Following is an explanation how to define macros in the macro files:
  2.  
  3. First define the operating system. The following systems are already availible:
  4.     iPSC      - Intel Hypercube
  5.     AIX       - AIX on IBM Workstations
  6.     CONVEX    - ConvexOs on Convex Supercomputers
  7.     HPUX      - HpUx on Hewlett Packard Machines
  8.     SPARC     - SunOs 4.1 or greater on Sun Sparc Stations
  9.     ULTRIX    - Ultrix on Vaxes
  10.     UNICOS    - UNICOS on Cray Supercomputers
  11.     SCO_XENIX - SCO Xenix Version 2.3 on IBM PCs
  12.     SCO_UNIX  - SCO Unix Version 3.2 on IBM PCs
  13. e.g. define 'OS = SPARC'
  14.  
  15. Second define the system type to one of the following:
  16.     BSD      - BSD Unix Version 4.3
  17.     SYSTEM_V - Unix System V
  18. e.g. define 'SYSTEM = BSD'
  19.  
  20. Third define the type of the inter process communication routines you want to
  21. use. Availible are
  22.     CUBE   - intel hypercube communication primitives
  23.     SOCKET - stream sockets
  24.     MSGSEM - message queues and semaphores
  25. e.g. define 'IPC = SOCKET'
  26.  
  27. Fourthly define the type of network you want to distribute the processes in.
  28.     SINGLE        - one machine only, no distribution of processes
  29.     HOMOGENEOUS   - distribution of processes in a homogenous network
  30.     HETEROGENEOUS - distribution of processes in a heterogenous network
  31. Choose 'SINGLE' to use the compiler on a single computer, particular on a 
  32. multiprocessor workstation, where all processes are created "local", i.e. no
  33. distribution of processes will be performed. Choose 'HOMOGENEOUS' to use the 
  34. compiler on a network of binary compatible machines, i.e. the processes will
  35. be distributed in a homogenous network. Choose 'HETEROGENEOUS' to use the
  36. compiler on a network of various different Unix machines, i.e. the processes 
  37. will be distributed in a heterogenous network. 
  38. Note: HOMOGENEOUS provides faster, HETEROGENEOUS provides more powerful inter 
  39.       process communications!
  40.       If the operating system equals iPSC this step is not required!
  41. e.g. define 'NETWORK = HETEROGENEOUS'
  42.  
  43. Next define some directory names.
  44.     MAKEDIRS      - the directories you want to make by the root Makefile
  45.     INSTALLDIR    - where to install needed files 
  46. e.g. define 
  47.     MAKEDIRS      = lib dcc dcadmin dckill
  48.     INSTALLDIR    = /usr/local/Distributed_C
  49.  
  50. At least define the name of the compiler, name of the loader, the compiler and 
  51. loader flags and so on for generation of the runtime library, the compiler,
  52. the administration process and the process killer process.
  53.  
  54. The common compiler, compiler flags and loader flags:
  55. e.g. define
  56.         COMCC = cc
  57.     COMCFLAGS = -D$(OS) -D$(SYSTEM) -D$(IPC) -D$(NETWORK) -g 
  58.    COMLDFLAGS = -Me -g
  59.  
  60. The name of the compiler used for building the library and the appropriate
  61. compiler flags:
  62. e.g. define
  63.        CC_LIB = cc
  64.    CFLAGS_LIB = $(COMCFLAGS)
  65.  
  66. The Names of the compiler and loader used for building the compiler, the 
  67. appropriate compiler and loader flags and special yacc flags:
  68. e.g. define
  69.        CC_DCC = cc
  70.    CFLAGS_DCC = $(COMCFLAGS)
  71.        LD_DCC = cc
  72.   LDFLAGS_DCC = $(COMLDFLAGS)
  73.      LIBS_DCC = -lmalloc
  74.    YFLAGS_DCC = -Sr1000 -Ss1000 -Sa6000 -Sm10000
  75.  
  76. The Names of the compiler and loader used for building the administration
  77. process, the appropriate compiler and loader flags:
  78.        CC_DCA = cc
  79.    CFLAGS_DCA = $(COMCFLAGS)
  80.        LD_DCA = cc
  81.   LDFLAGS_DCA = $(COMLDFLAGS)
  82.      LIBS_DCA = -lx
  83.  
  84. The Names of the compiler and loader used for building the process killer
  85. process, the appropriate compiler and loader flags:
  86.      CC_DCK = cc
  87.  CFLAGS_DCK = $(COMCFLAGS)
  88.      LD_DCK = cc
  89. LDFLAGS_DCK = $(COMLDFLAGS) -g
  90.    LIBS_DCK =
  91.