home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue4 / SDL / gcc346 / !gcc / docs / resgen / Resgen < prev   
Encoding:
Text File  |  2006-04-15  |  1.4 KB  |  48 lines
  1. Resgen
  2. ~~~~~~
  3.  
  4. 1. What ?
  5. -------
  6.  
  7. A tool to create an AOF file encapsulating one or more files ready for
  8. (de)registering with ResourceFS.  All files are stored in one 32-bit CODE
  9. READONLY area together with a global routine which is exported and can
  10. be called to give you a pointer to the begining of the ResourceFS data
  11. block holding the contents of those given files.
  12.  
  13. 2. How ?
  14. ------
  15.  
  16. resgen <areaname> <output file> [ <local file> <ResourceFS name> ]*
  17.  
  18. E.g.
  19.  
  20.   $ resgen resourcefsdata resgen.o dat/file1 $.ThirdParty.GCCSDK.Example.file1 dat/file2 $.ThirdParty.GCCSDK.Example.file2
  21.  
  22. This will create the AOF file 'resgen.o' contain a 32-bit CODE READONLY area
  23. named 'resourcefsdata' holding the file contents of files dat/file1 and
  24. dat/file2 in a ResourceFS structure ready to be registered as
  25. Resources:$.ThirdParty.GCCSDK.Example.file1 and
  26. Resources:$.ThirdParty.GCCSDK.Example.file2 respectively.
  27.  
  28. To get access to that area, you can call the following generated routine
  29. (you have to declare the function prototype yourself) :
  30.  
  31.   void *resourcefsdata(void);
  32.  
  33. I.e. the function name is the same as the given areaname.
  34.  
  35. The returned value is supposed to be used with SWIs ResourceFS_RegisterFiles
  36. (&41B40), ResourceFS_DeregisterFiles (&41B41) and service call
  37. Service_ResourceFSStarting (&60).
  38.  
  39. 3. License
  40. ----------
  41.  
  42. Written by John Tytgat / BASS and licensed under GPL v2 or later.  See
  43. file COPYING for details.
  44.  
  45. Contact: <mailto:John.Tytgat@aaug.net>
  46.  
  47. -EOF-
  48.