Server for Information Technologies Сервер поддерживается
Центром Информационных Технологий
(095) 932-9212, 932-9213, 939-0783
E-mail: info@citforum.ru
Сервер содержит море(!) аналитической информации CIT Forum CD-ROM

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;
};
Элементы таблицы имен нумеруются, начиная с 0.

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

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

Comments: info@citmgu.ru
Designed by Andrey Novikov
Copyright © CIT
Обновлено: 13.03.2015