home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c004 / 2.ddi / UNIX / README.UNX < prev    next >
Encoding:
Text File  |  1989-04-18  |  3.2 KB  |  106 lines
  1. c-tree(R) V4.3 Release C
  2. February 7, 1989 17:30
  3.  
  4. ---------
  5. General
  6. ---------
  7.  
  8. See the INSTALLATION GUIDE for details on porting c-tree to UNIX and
  9. creating the appropriate libraries.
  10.  
  11. ---------
  12. Make Files
  13. ---------
  14.  
  15. There are three make scripts provided for UNIX systems:
  16.  
  17.     makesrv - makes a UNIX background server
  18.     makeapp - makes applications to run with the server
  19.     makesgl - makes non-server (single user) applications and utility
  20.           programs (such as the rebuild)
  21.     
  22. For example (assuming that the c-tree code is in the directory 
  23. /usr/acct/ctree),
  24.  
  25.     sh makeapp
  26.     
  27. will create objects in /usr/acct/ctree/app, place the c-tree library in
  28. /usr/lib and the executables in /usr/bin.
  29.  
  30. Executing
  31.  
  32.     sh makesrv
  33.  
  34. will create objects in /usr/acct/ctree/srv, place a server library
  35. in /usr/lib and place the server executable in the file /usr/bin/ctsrvr.
  36.  
  37. The makesgl script is used for a single user library, and to create the
  38. utilities such as rebuild.
  39.  
  40. IF YOUR UNIX ENVIRONMENT REQUIRES MEMORY MODEL SPECIFICATIONS, then examine how
  41. the Xenix shell scripts incorporate a memory model parameter.
  42.  
  43.  
  44. ---------
  45. Server
  46. ---------
  47.  
  48. Once you have created a c-tree server (which will be placed in
  49. /usr/bin/ctsrvr), you initiate the server with a command line
  50. of the form
  51.  
  52.     ctsrvr >ctsrvr.out &
  53.     
  54. which causes the server output to be redirected, and places the
  55. server in the background.  The server as distributed ignores
  56. the hang-up signal (SIGHUP).  Therefore, logging off of the system
  57. does not terminate the server.
  58.  
  59.  
  60. Your Unix system must have queue support enabled in order for the server
  61. to operate.  Even though queues are a standard feature, some OEM's
  62. (such as NCR) do not always create the system kernel with the queues.
  63. If queues are not supported, then you will receive system errors when
  64. attempting to start the server.  You must reconfigure your system
  65. kernel to enable queue support. The c-tree server uses two queues.
  66.  
  67.  
  68. --------
  69. User Clean-Up Demon
  70. --------
  71.  
  72. Each application which calls on the server automatically
  73. invokes (through a fork coded in CTAMSG.C) a program
  74. (usr/bin/ctdemn) which sleeps until the application is terminated,
  75. killed or otherwise aborted.  When this demon wakes up,
  76. it sends a message to the server which ensures
  77. that the user is properly logged-off the server.
  78.  
  79. Programs which chain to additional modules (maintaining the
  80. same process id), say through calls to exec, will not want
  81. each subsequent process to invoke another demon.  To keep a
  82. demon from being spawned, use the following type of code
  83. segment in each process for which you DO NOT WANT a clean-up
  84. demon.  This code sets the c-tree global variable no_demon to
  85. a non-zero value which inhibits the spawning of a demon.
  86.  
  87.         extern COUNT no_demon;
  88.  
  89.         no_demon = 1;
  90.  
  91.  
  92. --------
  93. Exclusive File Locks
  94. --------
  95.  
  96. Exclusive file locks are subject to the following limitation in the non-server
  97. mode of operation:  index files opened independently of data files may permit
  98. an exclusive lock even if other users have the file opened (without any
  99. active locks).  This is due to a weakness in Unix. c-tree is able to overcome
  100. the weakness for data files.  The c-tree server is not subject to this
  101. limitation.
  102.  
  103. --------
  104. end
  105. --------
  106.