Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filevq_gdos()                                                               VDI

Syntax

ULONG vq_gdos( VOID ) or
ULONG vq_vgdos( VOID )

Function      vq_gdos() determines the availability and type of GDOS
              present.

Opcode        N/A

Availability  Supported in ROM by all Atari computers.

Binding       ; Correct binding for vq_gdos. Some compilers
              ; use the name vq_vgdos for the new version
              ; and vq_gdos for the old version which
              ; looked like:
              ;    move.w  #-2,d0
              ;    trap    #2
              ;    cmp.w   #-2,d0
              ;    sne     d0
              ;    ext.w   d0

              _vq_gdos:

              move.w   #-2,d0
              trap     #2
              rts

Return Value  Currently one of the following values are returned:

              Name       Value                  GDOS Type

              GDOS_NONE  -2                     GDOS not installed.

              -          Any other value.       GDOS 1.0, 1.1, or 1.2
                                                installed.

              GDOS_FNT   0x5F464E54 ('_FNT')    FONTGDOS installed.

              GDOS_FSM   0x5F46534D ('_FSM')    FSMGDOS installed.

Comments      Calling a GDOS function without GDOS loaded is fatal and
              will cause a system crash.

              To determine whether FSMGDOS or SpeedoGDOS is loaded look for
              the 'FSMC' cookie in the cookie jar. The cookie value points
              to a longword which will contain either '_FSM' or '_SPD'.

              Older third-party GDOS replacements fall into the 'other value'
              category of the table. Check with the manufacturer for more
              product specific details.

Group         VDI GDOS