=encoding euc-jp
=head1 NAME
=begin original
perlutil - utilities packaged with the Perl distribution
=end original
perlutil - Perl 配布と共にパッケージされているユーティリティ
=head1 DESCRIPTION
=begin original
Along with the Perl interpreter itself, the Perl distribution installs a
range of utilities on your system. There are also several utilities
which are used by the Perl distribution itself as part of the install
process. This document exists to list all of these utilities, explain
what they are for and provide pointers to each module's documentation,
if appropriate.
=end original
Perl 配布は、Perl インタプリタ自身と共に、様々なユーティリティをシステムに
インストールします。
また、Perl 配布自身がインストール処理の一部として使うユーティリティも
あります。
この文書はこれらのユーティリティの一覧を示し、何をするものかを説明し、
もしあれば各モジュールの文書へのポインタを提供するために存在しています。
=head1 LIST OF UTILITIES
(ユーティリティの一覧)
=head2 Documentation
(文書)
=over 3
=item L
=begin original
The main interface to Perl's documentation is C, although
if you're reading this, it's more than likely that you've already found
it. F will extract and format the documentation from any file
in the current directory, any Perl module installed on the system, or
any of the standard documentation pages, such as this one. Use
CnameE> to get information on any of the utilities
described in this document.
=end original
Perl 文書のメインのインターフェースは C ですが、これを読めていると
いうことは、おそらくこれをすでに発見していることでしょう。
F は、現在のディレクトリにあるファイル、システムに
インストールされた Perl モジュール、(この文書のような) 標準文書ページを
抽出およびフォーマットします。
この文書に記述されているユーティリティに関する情報を得るには、
CnameE> を使ってください。
=item L and L
(L と L)
=begin original
If it's run from a terminal, F will usually call F to
translate POD (Plain Old Documentation - see L for an
explanation) into a manpage, and then run F to display it; if
F isn't available, F will be used instead and the output
piped through your favourite pager.
=end original
端末から実行すると、F は普通は POD (Plain Old Documentation -
説明については L を参照) を man ページに変換するのに
F を使い、それからこれを表示するために F を使います;
もし F が利用できない場合は、代わりに F が使われて出力は
好みのページャにパイプされます。
=item L and L
(L と L)
=begin original
As well as these two, there are two other converters: F will
produce HTML pages from POD, and F, which produces LaTeX
files.
=end original
上述の二つと共に、もう二つのコンバータがあります: F は
POD から HTML ページを生成し、F は LaTeX ファイルを
生成します。
=item L
=begin original
If you just want to know how to use the utilities described here,
F will just extract the "USAGE" section; some of
the utilities will automatically call F on themselves when
you call them with C.
=end original
単にここに記述されているユーティリティの使い方が知りたいだけなら、
F は "USAGE" の節のみを抽出します; 一部のユーティリティは
C 付きで呼び出されたときに自動的に自分自身に対して F を
呼び出します。
=item L
=begin original
F is a special case of F, a utility to extract
named sections from documents written in POD. For instance, while
utilities have "USAGE" sections, Perl modules usually have "SYNOPSIS"
sections: C will extract this section for
a given file.
=end original
F は F の特殊ケースで、POD で書かれている文書から
特定の名前の節を抽出するためのユーティリティです。
例えば、ユーティリティには "USAGE" 節がありますが、Perl モジュールには
普通 "SYNOPSIS" 節があります: C は指定された
ファイルからこの節を抽出します。
=item L
=begin original
If you're writing your own documentation in POD, the F
utility will look for errors in your markup.
=end original
自身の文書を POD で書いたなら、F ユーティリティは
マークアップのエラーを探します。
=item L
=begin original
F is an interface to L - paste in your error message
to it, and it'll explain it for you.
=end original
F は L へのインターフェースです - エラーメッセージを
ペースとして、あなたのために説明します。
=item C
=begin original
The C utility is not installed on your system but lives in
the F directory of your Perl source kit; it converts all the
documentation from the distribution to F format, and produces a
typeset PostScript or text file of the whole lot.
=end original
C ユーティリティはシステムにはインストールされませんが、
Perl そースキットの F ディレクトリにいます; これは
配布の全ての文書を F 形式に変換して、
全体のタイプセット PostScript かテキストファイルを生成します。
=back
=head2 Converters
(コンバータ)
=begin original
To help you convert legacy programs to Perl, we've included three
conversion filters:
=end original
レガシープログラムを Perl に変換するのを助けるために、三つの変換フィルタを
同梱しています:
=over 3
=item L
=begin original
F converts F scripts to Perl programs; for example, C
on the simple F script C will produce a Perl program
based around this code:
=end original
F は F スクリプトを Perl プログラムに変換します; 例えば、
単純な F スクリプトである C を C すると、
以下のようなコードを元にした Perl プログラムを生成します:
while (<>) {
($Fld1,$Fld2) = split(/[:\n]/, $_, -1);
print $Fld2;
}
=item L and L
(L と L)
=begin original
Similarly, F converts F scripts to Perl programs. F run
on C will produce a Perl program based around this:
=end original
同様に、F は F スクリプトを Perl プログラムに変換します。
C に対して F を実行すると、以下のようなコードを
基にした Perl プログラムを生成します:
while (<>) {
chomp;
s/foo/bar/g;
print if $printit;
}
=begin original
When invoked as F, it behaves as a F implementation, written in
Perl.
=end original
F として起動すると、Perl で書かれた F 実装のように振る舞います。
=item L
=begin original
Finally, F translates C commands to Perl equivalents which
use the L module. As an example,
C produces the following callback
subroutine for C:
=end original
最後に、F は C コマンドを、L
モジュールを使った Perl の等価物に変換します。
C は、以下のような
C のためのコールバックサブルーチンを生成します:
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");
}
=back
=begin original
As well as these filters for converting other languages, the
L utility will help you convert old-style Perl 4 libraries to
new-style Perl5 modules.
=end original
他の言語を変換するためのこれらのフィルタと同様に、
L ユーティリティは古いスタイルの Perl 4 ライブラリを新しい
スタイルの Perl5 モジュールに変換するのを助けます。
=head2 Administration
(管理)
=over 3
=item L
=begin original
Query or change configuration of Perl modules that use Module::Build-based
configuration files for features and config data.
=end original
機能とデータ設定のための Module::Build ベースの設定ファイルを使っている
Perl モジュールの設定の問い合わせと変更を行う。
=item L
=begin original
To display and change the libnet configuration run the libnetcfg command.
=end original
libnet 設定の表示と変更をするには libnetcfg コマンドを実行します。
=item L
=begin original
The F program is set up at Perl source code build time to test
the Perl version it was built under. It can be used after running C (or your platform's equivalent procedure) to verify that perl
and its libraries have been installed correctly.
=end original
F プログラムはビルドされた Perl バージョンをテストするために
Perl ソースコードをビルド時に設定します。
これは、perl やライブラリが正しくインストールされているかを検証するために、
C (あるいはプラットフォームによる等価な手続き) の
後に実行されます。
=back
=head2 Development
(開発)
=begin original
There are a set of utilities which help you in developing Perl programs,
and in particular, extending Perl with C.
=end original
Perl プログラムの開発、特に Perl を C で拡張するのを助ける一群の
ユーティリティがあります。
=over 3
=item L
=begin original
F is the recommended way to report bugs in the perl interpreter
itself or any of the standard library modules back to the developers;
please read through the documentation for F thoroughly before
using it to submit a bug report.
=end original
F は、perl インタプリタ自身や標準ライブラリモジュールのバグを
開発者に報告するための推奨の方法です;
バグ報告を投稿するために使う前に、F の文書全体をよく
読んでください。
=item L
=begin original
This program provides an easy way to send a thank-you message back to the
authors and maintainers of perl. It's just F installed under
another name.
=end original
このプログラムは perl の作者とメンテナに感謝のメッセージを送るための
簡単な方法です。
単に F を別の名前でインストールしたものです。
=item L
=begin original
Back before Perl had the XS system for connecting with C libraries,
programmers used to get library constants by reading through the C
header files. You may still see C or similar
around - the F file should be created by running F on the
corresponding F file. See the F documentation for more on how
to convert a whole bunch of header files at once.
=end original
Perl に C ライブラリと接続するための XS システムができる前、
プログラマは C ヘッダファイルを読み込むことでライブラリの定数を
読み込んでいました。
今でも C のようなこともできます - F ファイルは
対応する F ファイルに対して F を実行して作成されるべきです。
ヘッダ全体を一度に変換する方法については F の文書を
参照してください。
=item L and L
(L と L)
=begin original
F and F, which are actually the same program but behave
differently depending on how they are called, provide another way of
getting at C with Perl - they'll convert C structures and union declarations
to Perl code. This is deprecated in favour of F these days.
=end original
F と F (実際には同じプログラムですがどのように
呼び出されるかで振る舞いが変わります) は、C を Perl から使うための
もう一つの方法を提供します - C 構造体と共用体定義を Perl コードに
変換します。
これは最近は F によって非推奨となっています。
=item L
=begin original
F converts C header files into XS modules, and will try and write
as much glue between C libraries and Perl modules as it can. It's also
very useful for creating skeletons of pure Perl modules.
=end original
F は C ヘッダファイルを XS モジュールに変換し、C と Perl モジュールとの
間をくっつけるコードを出来るだけ作成しようとします。
これはまた、ピュア Perl モジュールのスケルトンを作成するのにも
便利です。
=item L
=begin original
F builds a Perl extension for use by Encode from either
Unicode Character Mapping files (.ucm) or Tcl Encoding Files (.enc).
Besides being used internally during the build process of the Encode
module, you can use F to add your own encoding to perl.
No knowledge of XS is necessary.
=end original
F は Unicode Character Mapping ファイル (.ucm) か
Tcl Encoding Files (.enc) のどちらかから Encode で使うための
Perl エクステンションを構築します。
F は、Encode モジュールのビルドプロセス中での内部での使用の他に
独自のエンコーディングを perl に追加するのにも使えます。
XS の知識は不要です。
=item L
=begin original
F is a compiler to convert Perl XS code into C code.
It is typically run by the makefiles created by L.
=end original
F は Perl XS コードを C コードに変換するコンパイラです。
これは典型的には L によって作成された makefile によって
実行されます。
=begin original
F will compile XS code into C code by embedding the constructs
necessary to let C functions manipulate Perl values and creates the glue
necessary to let Perl access those functions.
=end original
F は、C の関数が Perl の値を操作するために必要な構造を
組み込むことで XS コードを C コードにコンパイルし、Perl がそれらの
関数にアクセスするために必要な糊コードを作成します。
=item L
=begin original
F is a command-line interface to the test-running functionality
of F. It's an alternative to C.
=end original
F は F のテスト実行機能へのコマンドライン
インターフェースです。
これは C の代替です。
=item L
=begin original
A command-line front-end to C, to query what modules
were shipped with given versions of perl.
=end original
C へのコマンドラインインターフェースで、あるバージョンの
perl にどのモジュールが出荷されたかを問い合わせます。
=back
=head2 General tools
(一般的なツール)
=begin original
A few general-purpose tools are shipped with perl, mostly because they
came along modules included in the perl distribution.
=end original
いくつかの一般的な用途のツールが perl と共に出荷されています; ほとんどの
場合は perl 配布に含まれているモジュールに付いているものです。
=over 3
=item L
=begin original
B is a Perl version of B, a character encoding converter
widely available for various Unixen today. This script was primarily a
technology demonstrator for Perl v5.8.0, but you can use piconv in the
place of iconv for virtually any case.
=end original
B は Perl 版の B で、最近の様々な Unix 系で幅広く
利用可能な文字エンコーディングコンバータです。
このスクリプトは元々は Perl v5.8.0 の機能デモでしたが、ほぼどのような
場合でも iconv を使う場面で piconv を使えます。
=item L
=begin original
F is a tar-like program, written in pure Perl.
=end original
F は tar 風のプログラムで、ピュア Perl で書かれています。
=item L
=begin original
F is a small utility that produces a diff between an extracted
archive and an unextracted one. (Note that this utility requires the
C module to function properly; this module isn't distributed
with perl, but is available from the CPAN.)
=end original
F は、展開されたアーカイブと展開されていないアーカイブの
差分を生成する小さいユーティリティです。
(このユーティリティは C モジュールが正しく動作することが
必要であることに注意してください; このモジュールは perl と共に配布は
されていませんが、CPAN から利用可能です。)
=item L
=begin original
F is a utility to apply pattern matching to the contents of files
in a tar archive.
=end original
F は、tar アーカイブ内のファイルの内容にパターンマッチングを
適用するユーティリティです。
=item L
=begin original
This utility, that comes with the C module, is used to print
or verify SHA checksums.
=end original
C モジュールと共に配布されているこのユーティリティは、
SHA チェックサムを表示または検証するために使われます。
=item L
=begin original
L displays information about the internal record structure of the zip file.
It is not concerned with displaying any details of the compressed data stored in the zip file.
=end original
L は zip ファイルの内部記録構造に関する情報を表示します。
これは zip ファイルに保管されている圧縮データの詳細について表示することは
考慮されていません。
=back
=head2 Installation
(インストール)
=begin original
These utilities help manage extra Perl modules that don't come with the perl
distribution.
=end original
これらのユーティリティは perl 配布に含まれていない追加の Perl モジュールの
管理を助けます。
=over 3
=item L
=begin original
F is a command-line interface to CPAN.pm. It allows you to install
modules or distributions from CPAN, or just get information about them, and
a lot more. It is similar to the command line mode of the L module,
=end original
F は CPAN.pm へのコマンドラインインターフェースです。
CPAN からモジュールやディストリビューションをインストールしたり、
単にこれらの情報を入手したり、その他にも多くの機能があります。
これは L モジュールのコマンドラインモードと似ています。
perl -MCPAN -e shell
=item L
=begin original
F is, like F, a command-line interface to the CPAN, using
the C module as a back-end. It can be used interactively or
imperatively.
=end original
F は F と同様 CPAN へのコマンドラインインターフェースで、
バックエンドとして C を使います。
対話的と命令的両方で使えます。
=item L
=begin original
F is a tool to create distributions (or packages) from CPAN
modules, then suitable for your package manager of choice. Support for
specific formats are available from CPAN as C modules.
=end original
F は CPAN モジュールからディストリビューション(または
パッケージ) を作成して、選択したパッケージマネージャに適したものにする
ツールです。
特定の形式への対応は CPAN の C モジュールから
利用可能です。
=item L
=begin original
A little interface to ExtUtils::Installed to examine installed modules,
validate your packlists and even create a tarball from an installed module.
=end original
インストールしたモジュールの検査、packlists の検証、さらに
インストールしたモジュールから tarball の作成まで出来る、
ExtUtils::Installed への簡単なインターフェースです。
=back
=head1 SEE ALSO
L, L, L,
L, L, L,
L, L, L,
C, L, L, L,
L, L, L,
L, L, L, L, L,
L, L, L, L, L, L,
L, L, L, L, L
=cut
=begin meta
Translate: SHIRAKATA Kentaro
Status: completed
=end meta