home *** CD-ROM | disk | FTP | other *** search
/ ftp.math.s.chiba-u.ac.jp / ftp.math.s.chiba-u.ac.jp.zip / ftp.math.s.chiba-u.ac.jp / asir / ASIR_INSTALL < prev    next >
Text File  |  1994-06-07  |  10KB  |  317 lines
  1. If you find anything unclear, inconsistent or inconvenient in the 
  2. following description, please e-mail to 
  3.  
  4.      noro@iias.flab.fujitsu.co.jp.
  5.  
  6.  
  7. UNIX version
  8. ============
  9.  
  10. Following five (5) files are provided.
  11.  
  12. `asir.gz'
  13.      Asir
  14. `asir_ping.gz'
  15.      A program for testing process communication facility.
  16. `asir_plot.gz'
  17.      A program for plotting implicit functions. (2-dimensional
  18.      algebraic curves.)
  19. `asir.o.gz'
  20.      An utility file for adding binary functions.
  21. `asirlib.tar.gz'
  22.      Files containing user defined functions and files for help
  23.      facility.
  24.  
  25. File `asir_ping.gz' is dispensable. File `asir.o.gz' is dispensable,
  26. too.  This is used for making a new Asir which contains new
  27. additional Asir functions written in C. All above mentioned files are
  28. compressed by `gzip'. They should be expanded by `gzip' after getting
  29. them.
  30.  
  31.      # gzip -dc asir > /usr/local/bin/asir
  32.      # gzip -dc asir_plot > /usr/local/bin/asir_plot
  33.      # chmod 755 /usr/local/bin/asir /usr/local/bin/asir_plot
  34.  
  35. Programs such as `asir', `asir_plot' and `asir_ping' are usually
  36. located to a common command directory, e.g., `/usr/local/bin', or to
  37. `$HOME/bin' if they are used privately.
  38.  
  39. Files in `asirlib.tar.gz' are located to directory
  40. `/usr/local/lib/asir' by default.
  41.  
  42.      # mkdir /usr/local/lib/asir
  43.      # gzip -dc asirlib.tar.gz | ( cd /usr/local/lib/asir; tar xf - )
  44.  
  45. If you wish to place them to a different directory, you should set the
  46. directory to an environment variable `ASIR_LIBDIR'.
  47.  
  48.      % mkdir $HOME/lib/asir
  49.      % gzip -dc asirlib.tar.gz | ( cd $HOME/lib/asir; tar xf - )
  50.      % setenv ASIR_LIBDIR $HOME/lib/asir
  51.  
  52. After installing libraries, make a symbolic link from in the library
  53. directory to `asir' with name `asir_symtab'.
  54.  
  55.      % cd /usr/local/lib/asir
  56.      % ln -s /usr/local/bin/asir asir_symtab
  57.  
  58. Start `asir', and Asir will immediately terminate leaving you a
  59. message as follows.
  60.  
  61.      % /usr/local/bin/asir
  62.      asir_key not found.
  63.      ID for this machine is XXXXXXXX.
  64.      See the file ASIR_INSTALL to get the correct key.
  65.  
  66. For UNIX version of asir, you need a `key', a string, for each machine
  67. you want to run Asir. In order to get the `key', you just need to send
  68. an e-mail consisting of a single line like
  69.  
  70.      ASIR XXXXXXXX
  71.  
  72. to address
  73.  
  74.      risa@iias.flab.fujitsu.co.jp
  75.  
  76. Here, `XXXXXXXX' is the machine ID notified in the first message from
  77. Asir.
  78.  
  79. After a while, an e-mail will be returned containing only one line
  80. like
  81.  
  82.      YYYYYYYY YYYYYYYY YYYYYYYY
  83.  
  84. Then, you shall create a new file in the current directory named
  85. `asir_key' containing the returned string in one line.
  86.  
  87. All after this, call again `asir'.
  88.  
  89.      % /usr/local/bin/asir
  90.      [0]
  91.  
  92. If you get such a prompt (`[0]') from Asir, the key you have is valid
  93. to the machine you are currently running `asir'.
  94.  
  95. When the file `asir_key' is located on the library directory, all the
  96. users of the machine can execute `asir'. The file `asir_key' can
  97. contain several lines for several `key''s.  This enables users to run
  98. several machines sharing the same library directory by simply adding
  99. lines for machines to be used. We shall describe about the file for
  100. `key''s in detail in the description of the environment variable
  101. `ASIR_KEY'.
  102.  
  103.      # cp asir_key /usr/local/lib/asir
  104.  
  105.  
  106. Macintosh version
  107. =================
  108.  
  109. For Macintoshes the following three files are provided.
  110.  
  111. `asir.sea'
  112. for Macintoshes with a 68020 CPU or upper compatible one with floating 
  113. point number operations. 
  114. `asir-sc.sea'
  115. for Macintoshes with a 68020 CPU or upper compatible one without floating 
  116. point number operations. 
  117.  
  118. `asir-00.sea'
  119. for Macintoshes with a 68000 CPU. 
  120.  
  121. A double click on this file will create a folder. This folder consists
  122. of `asir' executable file and a sub-folder containing files of user
  123. defined functions.  No `key' is needed for Macintosh version.  The
  124. `asir' executable file is ready to be executed. See Appendix for
  125. details.
  126.  
  127. File organization
  128. -----------------
  129.  
  130.  
  131.      dist -- asir    asir for 680X0 (X>=2)
  132.            |
  133.            |- asir-sc asir for 680X0 (X>=2) without co-processor
  134.            |
  135.            |- asir-00 asir for 68000
  136.            |
  137.            |- params parameters for memory management
  138.            |
  139.            |- lib    -- gr       Groebner basis package 
  140.                       |
  141.                       |- wang    test program for factoring
  142.                       |
  143.                       |- defs.h
  144.                       |         
  145.                       |- ...
  146.  
  147. params
  148. ------
  149.  
  150. The contents of params are as follows.
  151.  
  152.      stacksize=xxx adj=xxx paristack=xxx fontsize=xxx rows=xxx cols=xxx
  153.  
  154. where xxx's are decimal numbers: Their meanings are as follows.
  155.  
  156. STACKSIZE
  157.      Stack size for Asir.  Unit=byte.
  158.  
  159. ADJ
  160.      Lager adj increases the frequency of garbage collection.
  161.  
  162. PARISTACK
  163.      Heap size for PARI.  The default is 1 kbytes. Unit=byte.
  164.  
  165. FONTSIZE
  166.      Font size for display.
  167.  
  168. ROWS
  169.      Lines of contained in the window.
  170.  
  171. COLS
  172.      Number of characters that a line can contain.
  173.  
  174. Default partition size is set up for Asir.  This can be referred to
  175. and modified by command+i (i.e., typing i while holding down the
  176. command-key.)  Because available memory size is limited by the
  177. partition size, you may need to change it for your purpose.  When
  178. virtual memory is enabled on System 7, the available partition size can
  179. exceed the real memory.  However, if computation requires memories
  180. larger than the real memory size, computation speed shall slow down
  181. very seriously.
  182.  
  183. Starting up
  184. -----------
  185.  
  186. Click doubly the icon Asir, and a window named `Asir' will open. 
  187. After that all session procedures are alike as those of UNIX version.
  188.  
  189. Differences from UNIX version
  190. -----------------------------
  191.  
  192. Command line editing facility is incorporated.  It acilitates an emacs 
  193. key binding and history substitution.  
  194. Only `!!' and `!string' type history referencing is available. 
  195. The history is saved to the file `history' under the same directory as 
  196. `asir', and saved as many as 100 command lines. 
  197.  
  198. To read in program files, type as the following.
  199.  
  200.      [1] load(":dir_a:dir_b:...:filename");
  201.  
  202. The first colon (:) is superfluous if the file path start at the current
  203. directory.  For user's convenience, reading-in facility by mini-finder is
  204. provided.  To open the mini-finder for file loading, choose `Load' in
  205. `File' menu, or type command+`L' (i.e., typing `L' while holding down
  206. the command key.)
  207.  
  208. To interrupt Asir execution, type command+`.' (i.e., type a period `.'
  209. while holding down the command key.)
  210.  
  211.  
  212. DOS version
  213. ===========
  214.  
  215. Three (3) files are provided for DOS version as follows.
  216.  
  217. `asir.lzh'
  218.      Asir
  219. `asirlib.lzh'
  220.      Files of user defined functions.
  221. `go32.lzh'
  222.      `go32.exe' `V1.10' for IBM-PC, PC98 and Fujitsu FM series
  223.  
  224. These three files are compressed by `lha.exe', and will be melted by
  225. `lha.exe'.
  226.  
  227.      C> lha x asir
  228.      C> lha x asirlib
  229.  
  230. No `key' is needed for DOS version. While no default library directory
  231. is set, it is necessary to set up environments `ASIR_LIBDIR' and
  232. `ASIRLOADPATH'. Note that the way to set up environments for DOS differs
  233. from that for UNIX.
  234.  
  235.      C> set ASIR_LIBDIR=C:\usr\lib\asir
  236.      C> set ASIRLOADPATH=.;C:\usr\noro\lib\asir
  237.  
  238. If your machine has not yet `go32.exe' installed, you have to install
  239. it and to set up its environments. We recommend to install `go32.exe'
  240. with version V1.10 or newer. When older version is installed,
  241. depending on which device driver is installed to DOS, it sometimes
  242. happens to extremely slower Asir execution.  Such a situation happens
  243. due to swap-out of Asir caused by failure of `go32' to get memories.
  244.  
  245. In `go32.lzh', the following files are contained.
  246.  
  247. `go32-pc.exe'
  248.      For IBM-PC clones
  249. `go32-98.exe'
  250.      For NEC PC98 series
  251. `go32-fm.exe'
  252.      For Fujitsu FMR and FMTOWNS
  253. `emu387'
  254.      387 emulation module
  255. `readme'
  256.      readme of `go32'.
  257.  
  258. The version of `go32-xx.exe' is 1.10. Choose the proper `go32'
  259. executable for your machine. Then, place it on a convenient command
  260. directory with name `go32.exe'.  Finally, set up environments
  261. `GO32TMP' and `GO32'. (See `readme' of `go32' for setting up
  262. environments.)
  263.  
  264.      C> set GO32TMP=C:\tmp
  265.      C> set GO32=ansi
  266.  
  267. It is necessary to install and use `emu387' for machines which have no
  268. hardware support for floating point number operations. (Machines which
  269. do not have 80387, or 486 machines which lack hardware floating point
  270. operation support.) In such a case, set, for examaple, the environment
  271. variable as follows.
  272.  
  273.      C> set GO32=emu C:\usr\djgpp\lib\emu387
  274.  
  275. See `readme' of `go32' for details.
  276.  
  277. Usage of Dos version
  278. --------------------
  279.  
  280. One standard starting up method is to type the following.
  281.  
  282.      A> go32 asir
  283.      [0]
  284.  
  285. Or, in the case of `asir.exe', which is generated by concatenating
  286. `stub.exe' before `asir', simply type the following.
  287.  
  288.      A> asir
  289.      [0]
  290.  
  291. The other operations are similar to those for UNIX version.  One
  292. INPORTANT difference: To interrrupt Asir execution, type ^X.  Note
  293. that ^C, the usual interrupting command for UNIX, cannot be used,
  294. because, in MS-DOS, it terminates `go32'.  Typing ^Z suspends the Asir
  295. session and invokes shell (normally `command.com').  This shell will
  296. be terminated by the `exit' command, and the suspended Asir session
  297. will be resumed to continue.
  298.  
  299. Graphics and dynamic loading of object programs are not supported yet.
  300.  
  301. DOS version has more defects and instability in various point than 
  302. UNIX version.  Here, we summaries them. 
  303.  
  304.    * Asir itself will be terminated by an internal error. 
  305.    * To interrupt Asir, use ^X.  This is because an ^C shall terminate 
  306.      Asir itself. 
  307.    * Interrupts are not accepted when PARI is invoked.  This is because 
  308.      interrupts are detected by Asir's memory manager. 
  309.    * When another program is invoked by a ^Z or `help()', `go32' swaps 
  310.      almost all memory onto disk.  By this, if Asir is using much memory 
  311.      for a large problem, the time to swap may be very large. 
  312.      If the swap space is short, Asir shall be terminated, and sometimes 
  313.      MS-DOS may be terminated in the worst case. 
  314.    * The `CPU time' reported by `time() is, as a matter of fact, 
  315.      the difference of the time stamp of the real world clock from the start 
  316.      to the end of the computation. 
  317.