AMIGA - HAN_#?
 ----------------------------------------------------------------------------

   NAME

      han_rollifh() - Rollover handler for use with the
                      'mem_openifh()'.



   SYNOPSIS

      osigs = han_rollifh(sigs, id);

      __saveds __interrupt ULONG han_rollifh(
                            register ULONG __asm("d0"),
            register struct mem_ifh_data * __asm("a1"));



   FUNCTION

      This handler allows to collect and read the data.
      Data that dont fit will cause wrap around and thus
      overwrite top of the buffer.



   INPUTS

      sigs - Current signals.

      id   - Handler exception data.



   RETURNS

      Returns the 'sigs' back to 'exec'.



   BASES

      SysBase



   NOTES

      Using 'Seek()' with  'OFFSET_BEGINNING' is a must
      if you want to start 'Read()'ing from the rollover
      buffer.

      Using 'Seek()' with 'OFFSET_CURRENT' shuld be done
      after receiving EOF so that new read area starting
      from current position can be defined.

      Currently 'OFFSET_END' is not implemented! Use the
      'OFFSET_BEGINNING' with buffer size for that.

      Function 'Seek()' will always return 0. No failure
      is possible though.

      Values to go into  'offset' cannot be negative! It
      is advised to always pass 0.

      [30-Dec-2013] Warning! This routine may require hot
      vectoring and thus a wrapper to restore A4 register
      when binary model requested is resident and code is
      to be executed from under OS function such as
      'InternalLoadSeg()'!



   SEE ALSO

      mem_openifh(), mem_closeifh(),
      han_binaryifh(), han_rwifh(), han_termifh()



   EXAMPLE

      None.



   BUGS

      None known.



 ----------------------------------------------------------------------------