home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Applications / Portable Patmos / README < prev    next >
Encoding:
Text File  |  1995-11-03  |  3.2 KB  |  45 lines  |  [TEXT/ttxt]

  1. Portable Patmos README
  2.  
  3. Portable Patmos is a BSD unix program environment. The advantages of this are that you can compile almost all BSD or GNU software including C and C++ without modifying the source code in any way. The original Patmos ran in protected mode, the preferred method for debugging, but for greater portability this version has been slimmed down to run on any 68020+ mac or powermac (I hope). It still is not compatible with virtual memory because it captures certain exceptions and trap vectors for supervisor use. If you try to start in VM mode you will get an explanatory message and the program will exit. To keep archive size down only the bare minimum to get going is included. This consists of the shell, the C compiler/assembler/linker, the automated build utility (make) and a few utilities.
  4.  
  5. Start your program by opening 'sh' in the root directory. You can open new windows at any time using the open menu or by drag and drop. The location of the file you dropped becomes the root directory for that session.
  6.  
  7. You can make a standalone program by pasting the Patmos-univ application resources into the resource fork of your executable program.
  8.  
  9. In theory you can also make standalone mac applications but this is more difficult and not covered in this release.
  10.  
  11. If you are unfamiliar with the usage of the GNU software, all the source code and manual pages and documentation should be available from the same site you got Patmos from, as well as many other places. The most convenient way to get new source code to compile and run is on the many CDroms that are available. You can get BSD software on CDrom or via ftp as well.
  12.  
  13. Noddy Usage guide.
  14.  
  15. You can prepare your source code with an editor such as the freeware BBEdit-2.2.2, be sure to choose the ‘UNIX line endings’ option when you save the source file. A typical compilation command would be
  16.  
  17. gcc plugh.c    where plugh.c is your program
  18.  
  19. this will generate an executable in the current directory, called a.out by default
  20. Run this program by typing
  21.  
  22. a.out
  23.  
  24. The program’s output will appear in the console window.
  25.  
  26. The majority of recent mac
  27. models use a cut down 68LC040 or powermac-emulator with no maths co-processor so the kernel
  28. and most programs assume the co-processor is unused. You could alter
  29. the kernel to save the FPU context if you have a full 68040 and this would
  30. then work in conjunction with gcc -m68040. You might need to edit the gcc specs
  31. file.
  32.  
  33. Enjoy!
  34.  
  35. License.
  36.     The Patmos kernel is copyright ©1994 by Jonathan Richard Robert Kimmitt. It also incorporates as well as the author’s work, libraries which are copyright the University of California (Berkley). The dissassembly that you get when a program crashes is copyright Free Software Foundation, as is the majority of the application software including the compiler. You may freely copy this software but you must make the source code available to anybody you distribute this software to, or tell them where they can get it. For full details, see the file COPYING
  37.     If you like this program, send a postcard with your suggestions for improvements, what mac you tried it on, etc. to
  38.  
  39. Jonathan Kimmitt
  40. 4 Moyne Close,
  41. Cambridge,
  42. CB4 2TA
  43. ENGLAND
  44.  
  45.     Or if you are excessively lazy, you can send e-mail with your feedback to jrrk@camcon.co.uk