NM(1)

НАЗВАНИЕ

nm - вывод таблицы имен об ектного файла обычного формата

СИНТАКСИС

nm [-o] [-x] [-h] [-v] [-n] [-e] [-f] [-u] [-r] [-p] [-V] [-T] файл ...

ОПИСАНИЕ

Команда nm выдает на стандартный вывод таблицу имен для каждого об ектного файла, указанного в командной строке. Файл может быть как перемещаемым, так и абсолютным об ектным файлом, или может быть архивом из таких файлов. Для каждого элемента таблицы выдается следующая информация:

Name Value Class Type Size Line Section

Имя элемента таблицы.

Значение, выражаемое как смещение или адрес, в зависимости от класса хранения.

Класс хранения.

Информация о типе. Если элемент описывает экземпляр структуры или об единения, то за типом будет выведено имя структуры или об единения (например, struct-имя). Если элемент соответствует массиву, то размер массива будет указан за типом (например, char[n][m]). Заметим, что для наличия этой информации файл должен быть откомпилирован командой с опцией -g.

Размер в байтах, если он определен. Заметим, что для наличия этой информации файл должен быть откомпилирован командой с опцией -g.

Номер строки в файле с исходным текстом, в которой об ект определяется, если эта информация имеет смысл. Заметим, что для наличия этой информации файл должен быть откомпилирован командой с опцией -g.

Для об ектов с классом хранения статический (static) и внешний (extern) указывается секция, которой принадлежит об ект: секция команд (.text), секция инициализированных данных (.data) или секция неинициализированных данных (.bss).

Следующие опции определяют содержание и формат информации, выдаваемой командой nm:

-o -x -h -v -n -e -f -u -r -p -V -T

Выводить значение и размер в восьмеричном виде, а не в десятичном.

Выводить значение и размер в шестнадцатеричном виде, а не в десятичном.

Не выводить заголовок.

Отсортировать внешние об екты по значению.

Отсортировать внешние об екты по алфавиту.

Выдавать только статические и внешние об екты.

Выдавать всю информацию. Выводятся обычно подавляемые избыточные элементы таблицы имен (.text, .data, .lib, .bss).

Выводить только неопределенные об екты.

Добавлять в начале каждой выводимой строки имя об ектного файла или архива.

Выводить в легко обозримом, кратком формате. Перед именем каждого об екта стоит его значение (пробелы, если не определено) и одна из следующих букв: U (неопределенный), A (абсолютный), T (входит в секцию команд), D (входит в секцию данных), S (входит в секцию, определенную пользователем), R (располагается в регистре), F (файл) или C (входит в общий блок). Информация о локальных (не внешних) об ектах выдается малыми буквами.

Вывести в стандартный протокол информацию о версии команды nm.

По умолчанию команда nm выводит полные имена об ектов. Но так как об ектные файлы могут содержать имена произвольной длины, то возможен сдвиг последующих колонок. Опция -T вызывает усечение длинных имен. При этом факт усечения отмечается звездочкой в последней позиции, отведенной под имя.

Опции можно использовать в произвольном порядке, вместе или по отдельности, и в произвольном месте командной строки. Так, команды

nm f1 -e -v и nm -ve f1

работают одинаково: выдают статические и внешние об екты файла с сортировкой внешних об ектов по значению.

ФАЙЛЫ

TMPDIR/* Временные файлы.

Обычно каталог TMPDIR - это /usr/tmp, однако данное соглашение можно изменить, присвоив переменной окружения TMPDIR другое значение [см. tempnam( ) в ].

СМ. ТАКЖЕ

, , .

, a.out(4), в Справочнике программиста.

ДИАГНОСТИКА

nm: файл: cannot open Файл не удается открыть. nm: файл: bad magic Файл не является об ектным файлом обычного формата. nm: файл: no symbols Файл не содержит таблицы имен.

СЮРПРИЗЫ

В ситуации, когда выводятся все об екты, для сохранения локализации информации нужно, чтобы об екты выводились в том порядке, в каком они хранятся в таблице имен. Следовательно, опции -v и -n следует использовать только вместе с опцией -e.

Содержание раздела