legend(5)                        DG/UX 5.4.2                       legend(5)


NAME
       legend - debugging information technology

DESCRIPTION
       Legend debugging information (or legends for short) is used by the
       sdb(1) and dbx(1) debuggers when debugging an ELF executable and
       always used by the mxdb(1) debugger.  It is created during
       compilation typically by as(1) which calls the ctl(1) translator.

       Traditional UNIX compilation systems control debugging information by
       the use of a -g option.  If the -g option is present on the compiler
       command line (e.g. "cc -g") then debugging information is generated.
       Legend technology provides a number of options that can't be coded
       into a single yes or no option but many existing applications have
       makefiles and shell scripts that users don't want to modify.  The
       legend options, therefore, are controlled by an environment variable
       called LEGENDS.

OPTIONS
       The following values can be placed in the LEGENDS environment
       variable, separated by blanks, to control the generation of legends.

       -external
              Store the legend data in a separate file. If the target file
              is named "prog.o", then the legend will be stored in a file
              named "prog.lg".  This reduces the size of object files,
              libraries and executables, significantly saving link time as
              well as disk space.

       -no-external
              Store legend data in the object file.  This is the default.

       -compress
              Legends come in two forms that allow you to make a speed/space
              trade-off.  If present, this option requests that legends be
              generated in a compressed form.  You can mix compressed and
              uncompressed legends into the same application.

       -no-compress
              Don't compress the legend. This is the default.

       -keep-std
              This option only makes sense when creating a COFF object file.
              If present, it directs the legend translator to preserve the
              COFF information in addition to generating a legend.  This
              allows the use of COFF debuggers in addition to mxdb(1) on
              resulting executables.  By default the COFF information is
              deleted.

       -no-keep-std
              Don't preserve COFF information.  This is the default.

       -v   Print the version of ctl to stderr.




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

legend(5)                        DG/UX 5.4.2                       legend(5)


       -warn  Print warning messages. They are suppressed by default.

SEE ALSO
       ctl(1), cc(1), dtl(1), gcc(1), ghcc(1), ghf77(1), ghpc(1), as(1),
       mxdb(1), sdb(1), dbx(1)




















































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