[Debootloaders-miboot] required functions from run-time library

[Piotras]

Hi,

This is the list of functions from Apple run-time library that
should be reimplemented (second item from the TODO list).

* CloseDriver [1]

  This function is already implemented in emile/libmacos:-)

  [1] http://developer.apple.com/documentation/mac/devices/Devices-27.html

* FSClose [2]

  This is high-level file closing subroutine. The low-level subroutine
  PBClose provides similar functionality.

  [2] http://developer.apple.com/documentation/mac/Files/Files-129.html

* GetDCtlEntry [3]

  The implementation of this function may be based on documentation
  published by Apple. As the starting point it may be useful to check
  the relationships between various data structures used by Device
  Manager [4].

  [3] http://developer.apple.com/documentation/mac/devices/Devices-46.html
  [4] Inside Macintosh: Devices, Chapter 1 - Device Manager, About the
      Device Manager,
      http://developer.apple.com/documentation/mac/Devices/Devices-12.html

* GetEOF [5]

  This is high-level subroutine to determine file size. The low-level
  subroutine PBGetEOF provides similar functionality.

  [5] http://developer.apple.com/documentation/mac/Files/Files-134.html

* GetHandleSize [6]

  The implementation of this function may be based on documentation [6].

  [6] http://developer.apple.com/documentation/mac/Memory/Memory-81.html

* GetIndString [7]

  The implementation of this function may be based on documentation [7].
  The internal organization of the resource is briefly described
  by Apple [8]. It may also be deduced from rsrce source code.

  [7] http://developer.apple.com/documentation/mac/Text/Text-304.html
  [8] Technical Note DV 25, CD Remote Database Format,
      http://developer.apple.com/technotes/dv/pdf/dv_25.pdf

* NGetTrapAddress [9]

  The reference to this API is from unused block of code in miBoot so
  the implementation is not required. I'm adding it here for completes.

  [9] http://developer.apple.com/documentation/mac/osutilities/OSUtilities-177.html


For the implementation it could be possible to start with libmacos
from emile as there is some overlap and extend it with missing
functions. Note that it may be necessary to add additional code
referenced by these functions (lower-level functions, traps and
possibly data types).


Regards,

Piotr Krysiuk