

            dbg (1) --- invoke the Primos source level debugger (DBG)  08/31/84


          | _U_s_a_g_e

                 dbg { <DBG option> } <program> { <arguments> }


            _D_e_s_c_r_i_p_t_i_o_n

                 'Dbg' allows the user to access the facilities of the Primos
                 source  level  debugger  (DBG) while still in the Subsystem.
                 <Program> is a Subsystem program that  has  been  linked  by
                 'ld' with the "-d" option (i.e., it is a segment directory).
                 'Dbg'  sets  up  the  standard  input  and  output ports and
                 <arguments> for access by the program and then executes  DBG
                 with a call to Primos routine CP$.


            _E_x_a_m_p_l_e_s

                 dbg -vfyi -vfyp prog.r> new_rp >prog.f
                 dbg test.o -s -t 3


            _M_e_s_s_a_g_e_s

                 "command  too  long"  for  too  many DBG options to fit on a
                      Primos command line.


            _B_u_g_s

                 If DBG bombs (as it has been known  to  do),  the  Subsystem
                 must be reinitialized with the sequence "dels all;dels 6002"
                 and then "swt".

                 Ratfor programs must be debugged using the Fortran names and
          |      line numbers (yuk!).

          |      When  DBG  terminates  (with  the  "q"  command) it exits to
          |      PRIMOS.  Typing "ren" will return back to the subsystem.


            _S_e_e _A_l_s_o

                 fc (1), f77c (1), pc (1), plgc (1), ld (1)














            dbg (1)                       - 1 -                       dbg (1)


