home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / network / a172_1 / !awServer / !Help next >
Text File  |  1991-08-27  |  6KB  |  171 lines
  1. !Server
  2. Ver 0.05 (Public domain)
  3. (C) Alan Williams 1989/1990/1991
  4. How to contact me.
  5.  
  6. Snail Mail 
  7.   Alan Williams
  8.   18 Turner Ave
  9.   Glenhuntly  3163
  10.   Victoria
  11.   Australia
  12.  
  13. Phone (Home) +61 3 578 1291
  14.       (Work) +61 3 419 3033 / Aust. toll free 008 032604
  15. Fax   (Work) +61 3 419 2892
  16. SID : 1278
  17. Email: awilliams@acorn.co.uk
  18.  
  19. The default password file contains BOOT and SYST.
  20.  
  21. This program is a fileserver for RISC OS machines. 
  22.  
  23. It is still in a very experimental state and there are numerous known
  24. deficiencies in the  client services it performs.  However it is still a
  25. very useful program. 
  26.  
  27. It is an 'Acorn' compatible server as far as is possible.  It mimics the
  28. Acorn style of space  accounting, group and user names. It is also
  29. password file syntax compatible with Acorn  servers.
  30.  
  31.  
  32. It is limited by the nature of the RISC OS Filing systems that it
  33. serves.  Most of these  will be instantiations  (Acorns word not mine)
  34. of Filecore and as such will have an upper limit of directory entries
  35. that is lower than a normal Fileserver. 
  36.  
  37. At its current level of development it should be regarded as a useful
  38. utility rather than a  replacement for an Acorn server.  
  39.  
  40.  
  41. There are currently known only to be four client requests not supported
  42. by the server.   They are *LOAD & *SAVE as command line operations, 
  43. the CatHeader and UID function  call.  The only machines likely
  44. to be affected by these three (I hope) are Atoms, Systems or ARC only 
  45. nets using the broadcast loader (of which there are currently non).
  46. (If you don't think this is true read the date at the top of the page)
  47.  
  48.  
  49. Those of you who attended the Australian 1988 Econet conference may have
  50. seen my  Front end & Management system for Filestore.  Unfortunately for
  51. that system the recent  releases of Filestore code (1.39 at the time of
  52. writing)  are a down grade on the original Filestore code (1.23).  No
  53. work at all has been done on the Frontend since then.  This  server was
  54. an attempt to provide an upgrade path to the users of my Frontend. 
  55. Granted it  involved them throwing away their Filestores, no doubt some
  56. bits could be recycled for  useful purposes, like door stops perhaps.
  57.  
  58.  
  59. You will need to do a little work setting up the server before you can
  60. use it.  The servers  operational parameters are setup as system
  61. variables in the !Run file before the server  starts.  You should edit
  62. that file to suit your self.  Briefly the items that can be set are as 
  63. follows;
  64.  
  65.  
  66. Set Server$DevX:ClientAreaName  Adfs::4.$
  67. Set Server$DevX_PWF  Adfs::4.$.Passwords
  68.  
  69. This pair of lines can be repeated up to 10 times.  Starting with X=0 to
  70. X=9.  It defines  the locations of the areas you wish to server, and
  71. also the name that area will have when  viewed from the net.  You should
  72. substitute appropriate names in place of  ClienAreaName in the above
  73. example.
  74.  
  75. You can see from this that you can serve any area of the RISC OS filing
  76. system world.   The second line above is where to find the Password file
  77. for the area.  It should be noted  that it is not necessary for the
  78. password file to reside in the shared area, and can thus be  hidden from
  79. the clients.
  80.  
  81. The following line sets the maximum number of users that can log on to
  82. the server.
  83.  
  84. Set Server$Users  10
  85.  
  86. It is also possible to get the server to write a trace file of all the
  87. requests made by the  clients.  The following line would set up a trace.
  88.  
  89. Set Server$Trace <Obey$Dir>.TraceFile
  90.  
  91. The following is an example of the trace file output (Some have been 
  92. shortened to fit on this page);
  93.  
  94. Server started at Sat,23 June 1990.11:13:19
  95. Sat,23 June 1990.11:13:24 0.1 Stranger *I am FRED  
  96. 0.1 Client Function 21 Read user environment
  97. 0.1 Client Function 14 Read disc names. 
  98. 0.1 Client Function 6 Find :Archimedes.$.ArthurLib type 101. 
  99. 0.1 Client Function 7 Shut 4. 
  100. 0.1 Client Function 18 Read name of dir on 
  101. 0.1 Client Function 3 EXAMINE  for title and ACCESS. 
  102. 0.1 Client Function 3 EXAMINE  for title and ACCESS. 
  103. 0.1 Client Function 3 EXAMINE  for title and ACCESS. 
  104. 0.1 Client Function 3 EXAMINE  
  105. 0.1 Client *Lib WORK 
  106.  
  107.                                                            
  108. It should be noted that the trace file gets VERY BIG very fast and should
  109. only be used in exceptional circumstances.  It may be helpful in reporting
  110. bugs.
  111.  
  112. Version 0.5
  113. Introduced a command line option -NOICON.  This causes the server
  114. to run under the wimp but not to create a icon bar icon.  This helps to reduce
  115. desktop clutter!  It can still be killed via the task manager.
  116.  
  117. The line
  118. Run <Server$Dir>.!RunImage -NOICON
  119. would start the server in this way.
  120.  
  121. Version 0.7 
  122. Introduced *SETFREE as a built in command
  123.  
  124. Version 0.8 
  125. Introduced extended file handles for ARM machines. (up to 32 open objects)
  126. It has been noticed that I don't support functions calls 32/33 (As of SFS 1.40.00)
  127. This will be done when I find out what they do!  
  128. I don't think that this version will support broadcast loading yet.  I am not sure 
  129. what server facilities are required by this.  
  130.  
  131. Version 0.9
  132. Now serves a made up SIN.  Which should suffice for broadcast loader support.
  133. Now has a 'xx user(s) logged on, are you sure you want to quit?' dialogue box.
  134. Now supports wildcards in disc manes.
  135. Now supports function 18 arg 7.  Which is used by the Broadcast loader.
  136. Now has *ReadFree as a built in command.
  137. Now has a Users menu. (Tacky but functional)
  138. Now has *TIME as a built in command
  139. Now has *DATE as a built in command
  140. Now has *VER as a built in command. Returns the server version.
  141. Now if you hold down SHIFT while quitting it quits, current users or not.
  142. Now has *DISCS as a built in command
  143.  
  144. Version 1.00
  145. First release into the big wide world outside the land of OZ.
  146.  
  147.  
  148. !awServer is provided as is with no warranties of any kind including
  149. the warranties of design, merchantability and fitness for a particular
  150. purpose, or arising from a course of dealing, usage or trade practice.
  151.  
  152. The opinions expressed are my own and not necessarily those of Acorn.
  153.                                                              
  154.  
  155. *********************************************************************
  156.                                  ADVERT
  157. *********************************************************************
  158.  
  159. If you are interested in an EXCELLENT set of Fileserver management
  160. utilities for L3/Filestore/!awServer then I can recommend the following
  161.  
  162. The NetManager suit
  163. Written by 
  164. Chris Laycock
  165. Elizabeth College
  166. Cnr. Warwick & Murray St.
  167. Hobart  7000
  168. Tasmania
  169. Australia
  170.             
  171.