h2ph

СОДЕРЖАНИЕ

• ИМЯ
• СИНОПСИС
• ОПИСАНИЕ
• ПАРАМЕТРЫ
• СРЕДА
• ФАЙЛЫ
• АВТОР
• СМОТРИ ТАКЖЕ
• ДИАГНОСТИКА
• НЕДОСТАТКИ

ИМЯ

h2ph - преобразование заголовочных файлов C (.h) в заголовочные файлы Perl (.ph)

СИНОПСИС

h2ph [-d каталог_назначения] [-r | -a] [-l] [-h] [-e] [-D] [-Q] [файлы_заголовков]

ОПИСАНИЕ

h2ph преобразует указанные файлы заголовков C в соответствующий формат заголовочных файлов Perl. Его проще всего запустить в /usr/include:

cd /usr/include; h2ph * sys/*

или

cd /usr/include; h2ph * sys/* arpa/* netinet/*

или

cd /usr/include; h2ph -r -l .

Выходные файлы размещаются в иерархии, укоренённой в каталоге библиотеки Perl, зависящем от архитектуры. Вы можете указать другую иерархию с помощью переключателя -d.

Если запустить без аргументов, выполняется фильтрация стандартного ввода в стандартный вывод.

ПАРАМЕТРЫ

-d каталог_назначения

Разместить результирующие файлы .ph в каталоге каталог_назначения вместо стандартного расположения библиотек Perl ($Config{'installsitearch'}).

-r

Рекурсивный режим; если любой из файлов_заголовков является каталогом, то h2ph запускается для всех файлов в этих каталогах (и их подкаталогах и т.д.). -r и -a взаимно исключают друг друга.

-a

Автоматический режим; преобразовать файлы_заголовков, а также любые файлы .h, которые они включают. Этот параметр будет искать файлы .h во всех каталогах, которые обычно использует ваш компилятор C. -a и -r взаимно исключают друг друга.

-l

Символические ссылки будут дублированы в каталоге назначения. Если -l не указан, то ссылки пропускаются.

-h

Добавить "подсказки" в файлы .ph, которые помогут в поиске проблем с h2ph. В тех случаях, когда вам требуется .ph-файл, содержащий синтаксические ошибки, вместо криптической информации

[ some error condition ] at (eval mmm) line nnn

вы увидите немного более полезную информацию

[ some error condition ] at filename.ph line nnn

Однако, файлы .ph почти удваиваются в размере при построении с использованием -h.

-e

В случае возникновения ошибки во время преобразования выходной файл будет удалён, и вместо немедленного завершения преобразования будет выведено предупреждение.

-D

Включить код из файла .h в качестве комментария в файл .ph. Это в основном используется для отладки h2ph.

-Q

Режим "Тихо"; не выводить имена преобразуемых файлов.

СРЕДА

Переменные среды не используются.

ФАЙЛЫ

/usr/include/*.h
/usr/include/sys/*.h

и т.д.

АВТОР

Larry Wall

СМОТРИ ТАКЖЕ

perl(1)

ДИАГНОСТИКА

Обычные предупреждения, если не удаётся прочитать или записать вовлечённые файлы.

НЕДОСТАТКИ

Не создаёт массив %sizeof для вас.

Он не обрабатывает все конструкции C, но пытается изолировать определения внутри evals, чтобы вы могли получить определения, которые он может перевести.

Предназначен только как приблизительный инструмент. Возможно, вам придётся поработать с созданными файлами.

Вы должны запускать эту программу вручную; она не запускается в рамках установки Perl.

Не обрабатывает сложные выражения, собранные по частям, например:

enum {
    FIRST_VALUE,
    SECOND_VALUE,
#ifdef ABC
    THIRD_VALUE
#endif
};

Не обязательно находит все внутренне определённые символы вашего компилятора C.