home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / hardware / m68k / libjv.README < prev    next >
Encoding:
Text File  |  1992-06-23  |  3.2 KB  |  77 lines
  1.  
  2. Enclosed is a floating point library that avoids the problems of line-f 
  3. calls as is done in NeXT-step 2.
  4. The problem is the following:
  5. In the 68030 there are no floating point operations. Hence the 68882 has 
  6. been added. Its instructions are accessed by a direct link between the 
  7. 68030 and the 68882. The instructions that use this link are called 
  8. line-f instructions and they can be programmed even at the assembly 
  9. level. This system was used in the old NeXT computers that worked with 
  10. the 68030.
  11. The NeXT-stations and the newer cubes use a 68040. This chip has a 
  12. number of floating point operations (*,/,+,-,sqrt) built in. Because of 
  13. this no floating point coprocessor has been added. These operations are 
  14. again accessed by (the same) line-f instructions. The problems arise 
  15. with the extra transcendental functions that were available in the 
  16. 68882. These have to be simulated in software. However the math library 
  17. still provides the old routines with the lin-f calls for these 
  18. functions. What happens when such a function is called is then:
  19. 1:  the chip gets the line-f instruction.
  20. 2:  it does not recognize it
  21. 3:  it generates an exception
  22. 4:  the exception handler figures out what went wrong
  23. 5:  the exception handler calls the appropriate routine
  24. The overhead of this is such that it can make floating point intensive 
  25. programs, that use the transcendental functions frequently, 
  26. significantly slower than necessary. Often even by more than a factor 2. 
  27. The routines in this distribution avoid this problem. If you use 
  28. cc ........ -ljv -lm
  29. rather than
  30. cc ........ -lm
  31. the routines that are in libjv.a take priority. This avoids the 
  32. exception handler. The -lm may be necessary if you use routines that are 
  33. not in libjv.a. If you do not use such routines, it can be omitted.
  34. I did not have time to do all routines because when I made this I was in 
  35. the middle of a project and needed some speed.
  36.  
  37. Caution:
  38. The routines are guaranteed to work for IEEE precision. They do not 
  39. return extended 80 bits precision. In the way these routines are used 
  40. and because the compiler never uses the passing of arguments by 
  41. (floating point) registers there is no need for this precision. 
  42.  
  43. Remark 1:
  44. From version 3.0 on there will be similar routines in libm.a
  45.  
  46. Remark 2:
  47. You may use these routines freely. All rights remain with the author.
  48.  
  49. Remark 3:
  50. The author is Jos Vermaseren (t68@nikhef.nl). If you have useful 
  51. suggestions (like bug reports), please send them.
  52.  
  53. Remark 4:
  54. In the distribution you should find the files
  55.   acos.c asin.c atan.c atan2.c cos.c exp.c floor.c fmod.c
  56.   libjv.a log.c log10.c makefile pow.c sin.c sqrt.s tan.c
  57. You can use the libjv.a file directly. You can also make a new library 
  58. file by typing in 'make'.
  59.  
  60. Remark 5:
  61. Note that if you try to make additional routines you should try to avoid 
  62. divisions. They are quite 'expensive'.
  63.  
  64. Remark 6:
  65. If your programs use only multiplications, divisions, additions and 
  66. subtractions the use of libjv.a will not make a difference at all. 
  67. Hence the actual improvement is very much a function of your program.
  68.  
  69. Remark 7:
  70. Extract the library from the file libjv.1.tar.Z with the commands:
  71. uncompress libjv.1.tar.Z
  72. tar -xf libjv.1.tar
  73. This creates the directory libjv which contains all the files.
  74.  
  75. Good Luck
  76. Jos Vermaseren
  77.