RISCOS Ltd                                                         RISCOS Ltd

                ----------------------------------------------
                TECHNICAL NOTE: RISC OS 4 ROM INFORMATION CALL
                ----------------------------------------------


   Document: 20000120-001
  
    Version: 1.00 (20 Jan 2000) JRF: Written
  
  Author(s): Justin Fletcher (justin@riscos.com)



1) Introduction of new ROM information call

Applicability:

RISC OS 4 and later


Description:

OS_ReadSysInfo has been updated to read information about the currently
installed ROM on a machine. The new call is OS_ReadSysInfo 9.

OS_ReadSysInfo 9
=> R0 = 9 (reason code)
   R1 = ROM identity code
<= R0 = pointer to string, or 0 if code not present

This SWI reads information about the currently installed ROM. Identity codes
are :
     0-255 : Reserved for RISC OS use
              0 = OS name
                  This is given in the form :
                    <OS name> <version> <comments>
                  where <OS name> is 'RISC OS' on current machines
                        <version> is of the form #.##
                        <comments> may be present to describe the version
              1 = Part number
                  This is given in the form :
                    <part>[-<comment>]
                  where 
                        <part> is of the form ########-###
                        <comment> is any build specific comment. This is
                                  unlikely to be present in release versions.
              2 = Build time, eg Tue,18 Jan 2000.10:36:40
              3 = Dealer name
                  This is the supplier of the ROMs.
                  Current RISCOS Ltd and RiscStation Ltd are the only two
                  strings that are present here.
              4 = User name
                  This is the name of the owner of the ROMs. It may, or may
                  not, be present.
              5 = User address
                  This is the address of the owner. The address is newline
                  separated. It may, or may not, be present.
   256-511 : Reserved for manufacturer use
    Others : Reserved for future expansion

All versions of RISC OS 4 onwards will respond to at least identity codes 0,
1 and 2.


-- 
Comment: ReadSysInfo 9 documentation
Part: 20000120-001
