NOME

perlutil - utilidades que vem embutida na distribuição Perl

DESCRIÇÃO

Junto do interpretador Perl em si, a distribuição Perl instala uma série de utilitários em seu sistema. Há vários utilitários que são usados pela distribuição Perl em si como parte do processo de instalação. Este documento existe para listar todos estes utilitários, explicar o que eles são e prover links para cada a documentação de cada módulo, se preciso.

DOCUMENTAÇÃO

perldoc: A principal interface para a documentação perl é perldoc, se você; está lendo isso, você já achou-o. perldoc vai extrair e formatar a documentação; de qualquer arquivo no diretório atual, qualquer móduo Perl instalado no seu sistema ou; qualquer uma das páginas de documentação padrão, como essa. Use perldoc <name>; para ter informação de qualquer um dos utilitários descritos nesse documento.
pod2man e pod2text: Se rodado de um terminal, perldoc vai normalmente chamar pod2man; para traduzir POD (Plain Old Documentation - veja the perlpod manpage para uma explicação); em uma página do man, e então rodar man para exibir. Se man não estiver disponível,; pod2text será usado em vez de man e a saída redirecionada para seu pager favorito.
pod2html e pod2latex: Assim como esses dois, há outros dois conversores: pod2html vai produzir páginas HTML; a partiro do código POD, e pod2latex, que produz arquivos LaTeX? .
pod2usage: Se você simplesmente quer saber como usar o utilitário descrito aqui,; pod2usage vai simplesmente extrair a seção ``USAGE''; algumas dos utilitários; vão automaticamente chamar pod2usage neles mesmos quando você chamá-los; com a opção -help.
podselect: pod2usage é um tipo especial de podselect, um utilitário que extrai; seções nomeadas de documentos escritos em POD. Enquanto utilitários tem seções ``USAGE'', módulos Perl; tem seções ``SYNOPSIS'': podselect -s "SYNOPSIS ... irá extrair esta seção para do arquivo passado; como parâmetro.
podchecker: Se você está escrevendo sua própria documentação em POD, o utilitário podchecker vai; procurar por erros na marcação.
splain: splain é uma interface para the perldiag manpage - copia sua mensagem de erro nele, e ele o explicará para você.
roffitall: O utilitário roffitall não está instalado, mas viva dentro do diretório pod/; do código-fonte de Perl. Ele converte toda a documentação da distribuição; para o formato *roff e produz um typeset PostScript? ou um arquivo de texto de tudo.

CONVERSORES

Para ajudar a conversão de programas antigos em Perl, nós incluímos três filtros de conversão:

a2p

a2p converte scripts em awk para programs em Perl. Por exemplo, a2p -F: executado no seguinte script awk {print $2} vai produzir um programa em Perl baseado neste código:

    while (<>) {

        ($Fld1,$Fld2) = split(/[:\n]/, $_, 9999);

        print $Fld2;

s2p

De modo similar, s2p converte scripts sed para programas Perl. s2p rodado em s/foo/bar vai produzir um programa Perl baseado nisso:

    while (<>) {

        chomp;

        s/foo/bar/g;

        print if $printit;

find2perl

Finalmente, find2perl traduz comandos find para equivalentes em Perl que usam o módulo File::Find.

Por exemplo,

find2perl . -user root -perm 4000 -print produz o seguinte retorno

Subrotina para File::Find:

    sub wanted {

        my ($dev,$ino,$mode,$nlink,$uid,$gid);

        (($dev,$ino,$mode,$nlink,$uid,$gid) = lstat($_)) &&

        $uid == $uid{'root'}) &&

        (($mode & 0777) == 04000);

        print("$name\n");

Assim como esses filtros para converter para outras linguagens, o utilitário pl2pm vai ajudar você a converter as bibliotecas (velho estilo) de Perl 4 para módulos (novo estilo) de Perl5.

Administração

libnetcfg: Para mostrar e mudar a configuração do libnet, rode o comando libnetcfg.

Desenvolvimento

Há uma variedade de utilitários que vão ajudar a você desenvolver programas em Perl e em particular, extender Perl com C.

perlbug: perlbug é o modo recomendado de reportar bugs no interpretador perl em si; ou em qualquer módulos de biblioteca padrão aos desenvolvedores. Por favor, procure pela; documentação sobre perlbug antes de usar o mesmo para mandar um aviso de bug.
h2ph: Voltando ao tempo que Perl tinha o sistema XS para se conectar com bibliotecas em C,; os programadores se acostumaram a pegar as constantes da biblioteca lendo os cabeçalhos C.; Você talvez ainda veja require 'syscall.ph' ou algo parecido por aí - o arquivo .ph deve ser criado; rodando h2ph no arquivo .h correspondente. Veja a documentação do h2ph para entender; mais como converter vários cabeçalhos de uma vez só.
c2ph e pstruct: c2ph e pstruct, que na realidade são o mesmo programa mas se comportam; diferente dependendo de como são chamados providem outra maneira de se ligar a C com Perl -; eles irão converter estruturas em C e declarações union para código Perl. Esses dias, eles estão; inutilizados em favor de h2xs.
h2xs: h2xs converte cabeçalhos C para módulos XS, e vai tentar e escrever quantas ligações entre; as bibliotecas de C e módulos Perl permitirem. É também muito útil para criar esqueletos de módulos Perl puros.
dprofpp: Perl vem com um gerador de relatórios, o módulo Devel::DProf. O utilitário dprofpp analiza a; saída do gerador e diz a você qual subrotina está tomando a maior parte do tempo de execução. Veja the Devel::DProf manpage; para mais informações.
perlcc: perlcc é a interface para a suíte experimental do compilador Perl.