perlutil

СОДЕРЖАНИЕ

• НАЗВАНИЕ
• ОПИСАНИЕ
• СПИСОК УТИЛИТ
  • Документация
  • Конвертеры
  • Администрирование
  • Разработка
  • Общие инструменты
  • Установка
• СМОТРИТЕ ТАКЖЕ

НАЗВАНИЕ

perlutil — утилиты, входящие в дистрибутив Perl

ОПИСАНИЕ

Вместе с самим интерпретатором Perl, дистрибутив устанавливает ряд утилит на вашу систему. Также есть несколько утилит, используемых самим дистрибутивом Perl в процессе установки. Этот документ предназначен для перечисления всех этих утилит, объяснения их назначения и предоставления ссылок на документацию каждого модуля, если это уместно.

СПИСОК УТИЛИТ

Документация

perldoc

Основной интерфейс к документации Perl — perldoc, хотя если вы читаете это, скорее всего, вы уже его нашли. perldoc извлечёт и отформатирует документацию из любого файла в текущем каталоге, любого модуля Perl, установленного в системе, или любой из стандартных страниц документации, например, этой. Используйте perldoc <name> для получения информации об любой из утилит, описанных в этом документе.

pod2man и pod2text

Если утилита запускается из терминала, perldoc обычно вызывает pod2man для перевода POD (Plain Old Documentation — см. perlpod для объяснения) в man-страницу, а затем запускает man для её отображения; если man недоступен, будет использоваться pod2text, а вывод будет перенаправлен через ваш любимый просмотрщик.

pod2html

Помимо этих двух, существует ещё один конвертер: pod2html создаёт HTML-страницы из POD.

pod2usage

Если вам просто нужно узнать, как использовать описанные здесь утилиты, pod2usage извлечёт только раздел "USAGE"; некоторые утилиты автоматически вызовут pod2usage сами, когда вы вызовете их с -help.

podselect

pod2usage — частный случай podselect, утилиты для извлечения именованных разделов из документов, написанных в формате POD. Например, в то время как утилиты имеют разделы "USAGE", модули Perl обычно имеют разделы "SYNOPSIS": podselect -s "SYNOPSIS" ... извлечёт этот раздел для данного файла.

podchecker

Если вы пишете собственную документацию в формате POD, утилита podchecker ищет ошибки в вашем разметке.

splain

splain — интерфейс к perldiag — вставьте своё сообщение об ошибке в него, и он объяснит его для вас.

roffitall

Утилита roffitall не установлена на вашей системе, но находится в каталоге pod/ вашего набора исходных кодов Perl; она преобразует всю документацию из дистрибутива в формат *roff и создаёт отформатированный файл PostScript или текстовый файл со всем содержанием.

Конвертеры

Чтобы помочь вам переносить устаревшие программы на более современный Perl, утилита pl2pm поможет вам преобразовать библиотеки Perl 4 старого стиля в модули Perl 5 нового стиля.

Администрирование

libnetcfg

Для отображения и изменения конфигурации libnet выполните команду libnetcfg.

perlivp

Программа perlivp настраивается во время сборки исходного кода Perl для проверки версии Perl, под которой она была скомпилирована. Она может быть использована после выполнения make install (или эквивалентной процедуры вашей платформы) для проверки правильности установки perl и его библиотек.

Разработка

Есть набор утилит, которые помогают вам в разработке программ на Perl, а особенно в расширении Perl с помощью C.

perlbug

perlbug — рекомендуемый способ сообщить о ошибках в самом интерпретаторе perl или любых стандартных библиотечных модулях разработчикам; пожалуйста, внимательно прочитайте документацию для perlbug перед отправкой отчета об ошибке.

perlthanks

Эта программа предоставляет простой способ отправить сообщение благодарности авторам и разработчикам perl. Это просто perlbug, установленный под другим именем.

h2ph

До того как в Perl появился механизм XS для подключения к библиотекам C, программисты получали константы библиотек, просматривая файлы заголовков C. Вы всё ещё можете встретить require 'syscall.ph' или аналогичное — файл .ph должен быть создан путём запуска h2ph на соответствующем файле .h. См. документацию h2ph для получения дополнительной информации о том, как конвертировать сразу множество файлов заголовков.

h2xs

h2xs преобразует файлы заголовков C в модули XS и попытается создать как можно больше связей между библиотеками C и модулями Perl. Также она очень полезна для создания скелетов чисто Perl-модулей.

enc2xs

enc2xs создаёт расширение Perl для использования модулем Encode из файлов сопоставления символов Unicode (.ucm) или файлов кодировок Tcl (.enc). Помимо использования во время процесса сборки модуля Encode, вы можете использовать enc2xs для добавления вашей собственной кодировки в perl. Знание XS не требуется.

xsubpp

xsubpp — компилятор для преобразования кода Perl XS в C-код. Обычно он запускается файлами Makefile, созданными ExtUtils::MakeMaker.

xsubpp компилирует код XS в C-код, встраивая необходимые конструкции, позволяющие функциям C работать со значениями Perl, и создаёт необходимое связующее звено, позволяющее Perl обращаться к этим функциям.

prove

prove — командная строка интерфейса к функциональности запуска тестов модуля Test::Harness. Это альтернатива make test.

corelist

Командная строка интерфейс к Module::CoreList, для запроса модулей, поставляемых с определёнными версиями perl.

Общие инструменты

Несколько общих инструментов поставляются с perl, в основном потому, что они пришли вместе с модулями, включёнными в дистрибутив perl.

piconv

piconv — версия Perl для iconv, конвертера кодировок символов, широко используемого на различных Unixen сегодня. Этот скрипт был в основном демонстратором технологий для Perl v5.8.0, но вы можете использовать piconv вместо iconv практически в любом случае.

ptar

ptar — программа, похожая на tar, написанная на чистом Perl.

ptardiff

ptardiff — небольшая утилита, которая создаёт diff между извлечённым архивом и не извлечённым. (Обратите внимание, что для работы этой утилиты требуется модуль Text::Diff; этот модуль не входит в дистрибутив perl, но доступен из CPAN.)

ptargrep

ptargrep — утилита для применения сопоставления шаблонов к содержимому файлов в архиве tar.

shasum

Эта утилита, поставляемая с модулем Digest::SHA, используется для вывода или проверки контрольных сумм SHA.

zipdetails

zipdetails отображает информацию о внутренней структуре записей файла zip. Она не занимается отображением каких-либо деталей сжатых данных, хранящихся в файле zip.

Установка

Эти утилиты помогают управлять дополнительными модулями Perl, которые не входят в дистрибутив perl.

cpan

cpan — командная строка интерфейса к CPAN.pm. Она позволяет вам устанавливать модули или дистрибутивы из CPAN, или просто получать информацию о них, и многое другое. Она похожа на режим командной строки модуля CPAN.

perl -MCPAN -e shell

instmodsh

Небольшой интерфейс к ExtUtils::Installed для просмотра установленных модулей, проверки ваших файлов packlist и даже создания tar-архива из установленного модуля.

СМОТРИТЕ ТАКЖЕ

perldoc, pod2man, perlpod, pod2html, pod2usage, podselect, podchecker, splain, perldiag, roffitall|roffitall, File::Find, pl2pm, perlbug, h2ph, h2xs, enc2xs, xsubpp, cpan, instmodsh, piconv, prove, corelist, ptar, ptardiff, shasum, zipdetails