ctl(1)                           DG/UX 5.4.2                          ctl(1)


NAME
       ctl - COFF-to-legend translator

SYNOPSIS
       ctl [ option ] filename

DESCRIPTION
       The ctl command translates the debugging information stored inside an
       object module from COFF format to legend format. Normally, ctl is
       invoked automatically by the compiler (via an as(1) option); consult
       the man page for your compiler to see if it does this.

       Ctl accepts options both on the command line, and from the LEGENDS
       environment variable. In cases of conflicting options, command line
       options override LEGENDS options, then option precedence is from
       right to left (with right-most options having the highest
       precedence).

       Many important ctl options are described by the legend(5) manual
       page.  In addition, the following options are interpreted by ctl:

       -fix-bb
              Indicate that the compiler generates a redundant pair of
              begin-block and end-block symbols around each function. This
              option should be used with gcc.

       -h"[string]"
              Store the given string in the legend. This switch is generally
              used to indicate which compiler was used.

       -l[language]
              Specify which source language was used; possible values are
              fortran, c, ansi-c, and pascal.  The default is c.

       -ocs   Assume an 88k-OCS-compliant frame format. If this switch is
              omitted, then it is assumed that r30 is the frame pointer.
              This switch is ignored if a .coffsem or sem[.value] symbol is
              present in the object module.

       -reverse-arrays
              Indicate that array dimensions are stored in reverse of the
              source code order.  This switch is ignored if a .coffsem or
              sem[.value] symbol is present in the object module.

       -s"[pathname]"
              Indicate that pathname is the source file for the object
              module being translated.

FILES
       file.o    object file
       file.lg   optional debugging information file

SEE ALSO
       as (1), cc(1), gcc(1), ghcc(1), ghf77(1), ghpc(1), mxdb(1),



Licensed material--property of copyright holder(s)                         1

ctl(1)                           DG/UX 5.4.2                          ctl(1)


       legend(5).
























































Licensed material--property of copyright holder(s)                         2