SYMS(4)

НАЗВАНИЕ
syms - формат таблицы имен в обычном об ектном файле

СИНТАКСИС

#include <syms.h>

ОПИСАНИЕ
Объектные файлы обычного формата содержат информацию для поддержки, отладки в терминах исходного языка [см. sdb(1)]. Информация о номерах строк [см. linenum(4)] и об именах, встречающихся в программе, позволяет отлаживать программу на уровне исходного C-текста. Каждая таблица имен в объектном файле устроена следующим образом:

• Имя первого файла.
  • Имя первой функции.
    • Локальные имена из первой функции.
  • Имя второй функции.
    • Локальные имена из второй функции.
    • ...
  • Имена, локальные в первом файле (описанные вне
  • функций как static).
• Имя второго файла.
  • Имя первой функции.
    • Локальные имена из первой функции.
  • Имя второй функции.
    • Локальные имена из второй функции.
    • ...
  • Имена, локальные во втором файле.
  • ...
• Определенные глобальные имена.
• Неопределенные глобальные имена.

Таблица имен состоит из элементов фиксированной длины (18 байт). Элемент, описывающий имя, кроме собственно текста имени, дополненного нулями, содержит его значение и другую информацию. Ниже приведена соответствующая C-структура:

#define SYMNMLEN 8  /* Максимальное количество символов в тексте имени */

#define FILNMLEN 14 /* Максимальное количество символов в имени файла */

#define DIMNUM   4  /* Размерность массива во вспомогательном разделе */



struct syment {

  union {        /* Все способы описать текст имени */

    char _n_name[SYMNMLEN]; /* Текст имени */

    struct {

      long _n_zeroes; /* Если == 0, то в таблице цепочек */

      long _n_offset; /* Смещение в табл. цепочек */

    }    _n_n;

    char *_n_nptr[2];

  }              _n;

  long           n_value;   /* Значение имени */

  short          n_scnum;   /* Номер секции */

  unsigned short n_type;    /* Тип и производный тип */

  char           n_sclass;  /* Класс памяти */

  char           n_numaux;  /* Число вспомогательных

                               элементов */

};



#define n_name   _n._n_name

#define n_zeroes _n._n_n._n_zeroes

#define n_offset _n._n_n._n_offset

#define n_nptr   _n._n_nptr[1]

Смысл значений имен пояснен во включаемом файле <syms.h>. Для описания некоторых имен требуется больше информации, чем содержится в одном элементе; в таком случае за первым элементом, описывающим имя, следуют вспомогательные элементы. Вспомогательные элементы имеют тот же размер, что и основные; их формат приведен ниже:

union auxent {

  struct {

    long x_tagndx; /* Индекс описателя структуры,

                      об единения или перечисления */

    union {

      struct {

        unsigned short x_lnno; /* Номер строки

                                  определения */

        unsigned short x_size; /* Размер массива, структуры

                                  или об единения */

      } x_lnsz;

      long x_fsize; /* Размер функции */

    } x_misc;

    union {

      struct {

        long x_lnnoptr;

        long x_endndx;

      } x_fcn;

      struct { /* Если массив, то его размерности (до 4) */

        unsigned short x_dimen [DIMNUM];

      } x_ary;

    } x_fcnary;

    unsigned short x_tvndx;

  } x_sym;

  struct {

    char x_fname [FILNMLEN]; /* Имя файла (занимает весь

                                элемент) */

  } x_file;

  struct {

    long           x_scnlen; /* Длина секции */

    unsigned short x_nreloc; /* Число  элем. с инф. о

                                настройке ссылок */

    unsigned short x_nlinno; /* Число  элем. с инф. о

                                номерах строк */

  } x_scn;

  struct {

    long           x_tvfill;

    unsigned short x_tvlen;

    unsigned short x_tvran[2];

  } x_tv;

};

СМ. ТАКЖЕ
a.out(4), linenum(4).
sdb(1) в Справочнике пользователя.

ПРЕДОСТЕРЕЖЕНИЯ
На компьютерах, у которых тип int эквивалентен типу long, вместо long в таблице имен указывается int. Таким образом, в таблице отсутствует информация о том, как на самом деле описано имя: как int или как long.