UGAVAC Manual Page

UGAVAC(l)         MISC. REFERENCE MANUAL PAGES          UGAVAC(l)



NAME
     ugavac - UGAVAC computer simulator

SYNOPSIS
     ugavac [ -h ] [ -t ] [ -nx ] [ -v ] [ -g ] [ -l ] filename

DESCRIPTION
     ugavac simulates the execution of an  UGAVAC  Assembly  pro-
     gram.   The  UGAVAC  Assembly program should be given in the
     file filename. If no  filename  argument  is  given,  ugavac
     displays a short usage information.

     In order to run the UGAVAC machine:

     1.   Make sure you have  /usr/local/bin  in  your  execution
          path (it should be listed among other directories, when
          you execute 'echo $path').

     2.   Prepare a file, say obj, containing a  UGAVAC  Assembly
          program (usually, it will be the result of the compila-
          tion of an UGAL program).  You may use any  file  name,
          provided  it is a legal UNIX name.  Remember, that UGA-
          VAC Assembler is case sensitive, and thus, for example,
          neither  'addi'  nor  'ADDI'  will  be  treated  as the
          integer addition instruction 'addI'.

     3.   Execute  'ugavac obj'.

     WARNING: No prompt before  the  'inpI'  or  'inpR'  will  be
     printed by the system.

OPTIONS
     -h   print this info file.

     -t   trace the execution  of  an  UGAVAC  Assembly  program;
          each  instruction  will  be  traced,  preceded  by  the
          address of the instruction and its arguments.

     -nx  suppress  execution  of  an  UGAVAC  Assembly  program;
          assembly phase will, however, be executed and the list-
          ing file will be created, if desired (see -l option).

     -v   switch on the verbose mode.

     -g   include a simple debugger.  In case of a runtime error,
          a  simple  debugger  will be invoked.  Type h (or ?) to
          get a list of available debugger commands.

     -l   create the listing file filename.lst;  the listing file
          will contain line numbers, relative addresses, opcodes,
          and arguments of instructions (if any), as well as  the
          text   of  the  UGAVAC  Assembly  program.   The  cross



Sun Release 4.1     Last change: 10 May 1990                    1






UGAVAC(l)         MISC. REFERENCE MANUAL PAGES          UGAVAC(l)



          reference list of labels will also be printed.



FILES
     /usr/local/bin/ugavac
          link to ugavac executable

     /usr/local/lib/ugavac/ugavac
          ugavac executable

     /usr/local/lib/ugavac/ugavac.doc
          ugavac documentation

     file.lst
          listing file