Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ syms(4) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                  syms(4)



        _________________________________________________________________
        syms                                                  File Format
        executable file symbol table format in DG/UX
        _________________________________________________________________


        SYNTAX

        #include  <syms.h>


        DESCRIPTION

        Executable files contain information to support symbolic software
        testing (see dbx(1)).  Extensive symbolic information permits
        testing at the C source level.  The entry for a symbol is a
        variable-length structure.  The members of the structure hold the
        name (null padded), its value, and other information.  The C
        structure is given below.

        struct symentry
             {short sym_type; /* Symbol type */
              short value_size; /* 8 for partition types, 4 for other types */
              unsigned sym_value;
                            /* For partition types, word address of partition;
                            for other types, value of the symbol*/
              union {
                  struct { /* Partition type entry */
                       unsigned part_length; /* Word length of partition * /
                       short sym_length; /* Length in bytes of symbol name */
                       char *sym_name; /* Symbol name, null terminated */
                  } part;
                  struct {
                       short sym_length; /* Length in bytes of symbol name */
                       char *sym_name; /* Symbol name, null terminated */
                  } other;
             } variant;
             };

        Indexes of symbol table entries begin at 0.


        SEE ALSO

        a.out(4)
        dbx(1) in the User's Reference for the DG/UX System.


        CAVEATS

        Since longs are equivalent to ints on DG/UX machines, they are



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                  syms(4)



        converted to ints in the compiler to minimize the complexity of
        the compiler code generator.  Thus, information about which
        symbols are declared as longs and which symbols are declared as
        ints does not show up in the symbol table.

        The executable file format is used only for executable files
        (load modules), not for object files.















































        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026