名前¶

perlmodinstall - CPAN モジュールのインストール

説明¶

モジュールは、再利用可能な Perl コードの基本単位と考えることができます; 詳しくは、perlmod を参照してください。 誰かが世界に役立つと思う Perl コードの塊を作成したら、 https://www.cpan.org/modules/04pause.html に Perl 開発者として登録し、 CPAN にコードをアップロードできるようにします。 CPAN は Comprehensive Perl Archive Network で、 https://www.cpan.org/ でアクセスでき、https://metacpan.org/ で 検索できます。

この文書は、CPAN モジュールをダウンロードして自分のコンピュータに インストールしたい人のためのものです。

PREAMBLE¶

まず、モジュールがまだシステムにインストールされていないことを 確認しましたか? perl -MFoo -e 1 を試してみてください。 ("Foo" をモジュールの名前に置き換え、 例えば perl -MCGI::Carp -e 1 のようにします。)

エラーメッセージが表示されない場合は、モジュールがあります (エラーメッセージが表示された場合は、モジュールはまだありますが、 そのモジュールがパスにない可能性があります。 パスは perl -e "print qq(@INC)" で表示できます)。 この文書の残りの部分では、そのモジュールは実際に本当に絶対に インストールされておらず、 しかし CPAN 上にはモジュールがあると仮定します。

それで、今あなたは .tar.gz (または、それほど頻繁ではありませんが .zip)で 終わるファイルを持っています。 中においしいモジュールがあることは知っています。 次の四つのステップを踏む必要があります:

DECOMPRESS the file

(ファイルを 伸張 する)

UNPACK the file into a directory

(ファイルをディレクトリに 展開 する)

BUILD the module (sometimes unnecessary)

(モジュールを ビルド する (不要の場合もあります))

INSTALL the module.

(モジュールを インストール する)

ここでは、各オペレーティングシステムに対して各ステップを実行する方法を 説明します。 これは、モジュールに付属している README ファイルと INSTALL ファイルを 読む代わりでは <ありません>!

また、これらの指示は、システムの Perl モジュールのリポジトリにモジュールを インストールするように調整されていることにも注意してください; ただし、モジュールは任意のディレクトリにインストールできます。 例えば、perl Makefile.PL の場合、 /my/perl_directory にインストールするために perl Makefile.PL PREFIX=/my/perl_directory と 置き換えることができます。 次に、Perl プログラムのモジュールを use lib "/my/perl_directory/lib/site_perl"; で使用することもできますし、 場合によっては単に use "/my/perl_directory"; で使用することもできます。 perl -e "print qq(@INC)" と入力したときに表示されるディレクトリに モジュールをインストールするためにスーパーユーザー /root アクセスを 必要とするシステムを使用している場合は、ローカルディレクトリ (ホームディレクトリなど)にモジュールをインストールし、 この方法を使用します。

• If you're on a Unix or Unix-like system,

  Unix または Unix 風のシステムの場合

  You can use Andreas Koenig's CPAN module ( https://metacpan.org/release/CPAN ) to automate the following steps, from DECOMPRESS through INSTALL.

  Andreas Koenig の CPAN モジュール (http://www.cpan.org/modules/by-module/CPAN) を使えば、 DECOMPRESS から INSTALL までのステップを自動化することができます。

  A. DECOMPRESS

  A. 伸張

  Decompress the file with gzip -d yourmodule.tar.gz

  gzip -d yourmodule.tar.gz でファイルを伸張します。

  You can get gzip from ftp://prep.ai.mit.edu/pub/gnu/

  ftp://prep.ai.mit.edu/pub/gnu/ から gzip を入手できます。

  Or, you can combine this step with the next to save disk space:

  または、この手順と次の手順を組み合わせてディスク領域を節約することもできます:

       gzip -dc yourmodule.tar.gz | tar -xof -

  B. UNPACK

  B. 展開

  Unpack the result with tar -xof yourmodule.tar

  結果 をtar -xof yourmodule.tar で展開します。

  C. BUILD

  C. ビルド

  Go into the newly-created directory and type:

  新しく作成されたディレクトリに移動し、次のように入力します:

        perl Makefile.PL
        make test

  or

  または

        perl Makefile.PL PREFIX=/my/perl_directory

  to install it locally. (Remember that if you do this, you'll have to put use lib "/my/perl_directory"; near the top of the program that is to use this module.

  とするとローカルにインストールします。 (これを行う場合は、このモジュールを使うプログラムの先頭近くに use lib "/my/perl_directory"; を置かなければならないことを 覚えておいてください。)

  D. INSTALL

  D. インストール

  While still in that directory, type:

  そのディレクトリにある状態で、次のように入力します:

        make install

  Make sure you have the appropriate permissions to install the module in your Perl 5 library directory. Often, you'll need to be root.

  モジュールを Perl 5 ライブラリーディレクトリにインストールするための 適切な許可を持っていることを確認してください。 多くの場合、root になる必要があります。

  That's all you need to do on Unix systems with dynamic linking. Most Unix systems have dynamic linking. If yours doesn't, or if for another reason you have a statically-linked perl, and the module requires compilation, you'll need to build a new Perl binary that includes the module. Again, you'll probably need to be root.

  動的リンク機能を備えた Unix システムで行う必要があるのはこれだけです。 ほとんどの Unix システムには動的リンク機能があります。 動的リンク機能がない場合や、別の理由で静的にリンクされた perl を 持っていて、かつ モジュールをコンパイルする必要がある場合は、 このモジュールを含む新しい Perl バイナリを作成する必要があります。 ここでもおそらく root になる必要があります。

• If you're running ActivePerl (Win95/98/2K/NT/XP, Linux, Solaris),

  ActivePerl (Win95/98/2K/NT/XP, Linux, Solaris) を実行している場合

  First, type ppm from a shell and see whether ActiveState's PPM repository has your module. If so, you can install it with ppm and you won't have to bother with any of the other steps here. You might be able to use the CPAN instructions from the "Unix or Linux" section above as well; give it a try. Otherwise, you'll have to follow the steps below.

  まず、シェルから ppm と入力して、ActiveState の PPM リポジトリに あなたのモジュールがあるかどうかを確認します。 もしあるなら、ppm と一緒にインストールすることができますし、 ここで他の手順に煩わされることもありません。 上の「Unix または Linux」セクションにある CPAN の指示も 使えるかもしれません; 試してみてください。 そうでなければ、以下の手順に従わなければなりません。

     A. DECOMPRESS

  You can use the open source 7-zip ( https://www.7-zip.org/ ) or the shareware Winzip ( https://www.winzip.com ) to decompress and unpack modules.

  オープンソースの 7-zip (https://www.7-zip.org/) か シェアウェアの Winzip (https://www.winzip.com) を使用して、 モジュールを伸張および展開できます。

     B. UNPACK

  If you used WinZip, this was already done for you.

  WinZip を使用している場合は、これは既に行われています。

     C. BUILD

  You'll need either nmake or gmake.

  nmake か gmake のどちらかが必要です。

  Does the module require compilation (i.e. does it have files that end in .xs, .c, .h, .y, .cc, .cxx, or .C)? If it does, life is now officially tough for you, because you have to compile the module yourself (no easy feat on Windows). You'll need a compiler such as Visual C++. Alternatively, you can download a pre-built PPM package from ActiveState. http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/

  モジュールをコンパイルする必要がありますか (.xs, .c, .h, .y, .cc, .cxx, .C で終わるファイルがありますか)? もしそうなら、人生は公式に厳しいものです; なぜなら、自分でモジュールをコンパイルしなければなりません (Windows では簡単にはできません)。 Visual C++ などのコンパイラが必要になります。 あるいは、ActiveState からビルド済みの PPM パッケージを ダウンロードすることもできます。 http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/

  Go into the newly-created directory and type:

  新しく作成されたディレクトリに移動し、次のように入力します:

        perl Makefile.PL
        nmake test
  
     D. INSTALL

  While still in that directory, type:

  そのディレクトリにいる状態で、次のように入力します。

        nmake install

• If you're on the DJGPP port of DOS,

  DOS の DJGPP 版を使っているなら

     A. DECOMPRESS

  djtarx ( ftp://ftp.delorie.com/pub/djgpp/current/v2/ ) will both uncompress and unpack.

  djtarx ( ftp://ftp.delorie.com/pub/djgpp/current/v2/ ) は 伸張と展開の両方を行います。

     B. UNPACK

  See above.

  上記を参照してください。

     C. BUILD

  Go into the newly-created directory and type:

  新しく作成されたディレクトリに移動し、次のように入力します:

        perl Makefile.PL
        make test

  You will need the packages mentioned in README.dos in the Perl distribution.

  Perl ディストリビューションの README.dos に記載されているパッケージが 必要です。

     D. INSTALL

  While still in that directory, type:

  そのディレクトリにいる状態で、次のように入力します:

       make install       

  You will need the packages mentioned in README.dos in the Perl distribution.

  Perl ディストリビューションの README.dos に記載されているパッケージが 必要です。

• If you're on OS/2,

  OS/2 を使用している場合

  Get the EMX development suite and gzip/tar from Hobbes ( http://hobbes.nmsu.edu/h-browse.php?dir=/pub/os2/dev/emx/v0.9d ), and then follow the instructions for Unix.

  Hobbes (http://hobbes.nmsu.edu/h-browse.php?dir=/pub/os2/dev/emx/v0.9d) から EMX 開発スイートと gzip/tar を入手し、Unix 用の指示に従ってください。

• If you're on VMS,

  VMS を使用している場合

  When downloading from CPAN, save your file with a .tgz extension instead of .tar.gz. All other periods in the filename should be replaced with underscores. For example, Your-Module-1.33.tar.gz should be downloaded as Your-Module-1_33.tgz.

  CPAN からダウンロードする場合は、ファイルを .tar.gz ではなく .tgz 拡張子で保存します。 ファイル名の他のすべてのピリオドはアンダースコアに置き換える必要があります。 たとえば、Your-Module-1.33.tar.gz は Your-Module-1_33.tgz として ダウンロードする必要があります。

  A. DECOMPRESS

  A. 伸張

  Type

  次のように入力します:

      gzip -d Your-Module.tgz

  or, for zipped modules, type

  または、zip モジュールの場合は、次のように入力します:

      unzip Your-Module.zip

  Executables for gzip, zip, and VMStar:

  gzip, zip, VMStar 用の実行可能ファイル:

      http://www.hp.com/go/openvms/freeware/

  and their source code:

  ソースコード:

      http://www.fsf.org/order/ftp.html

  Note that GNU's gzip/gunzip is not the same as Info-ZIP's zip/unzip package. The former is a simple compression tool; the latter permits creation of multi-file archives.

  GNU の gzip/gunzip は Info-ZIP の zip/unzip パッケージと 同じではないことに注意してください。 前者は単純な圧縮ツールです; 後者は複数ファイルの アーカイブの作成を可能にします。

  B. UNPACK

  B. 展開

  If you're using VMStar:

  VMStar を使用する場合:

       VMStar xf Your-Module.tar

  Or, if you're fond of VMS command syntax:

  あるいは、VMS コマンドの文法が好きなら:

       tar/extract/verbose Your_Module.tar

  C. BUILD

  C. ビルド

  Make sure you have MMS (from Digital) or the freeware MMK ( available from MadGoat at http://www.madgoat.com ). Then type this to create the DESCRIP.MMS for the module:

  MMS(Digital から)かフリーウェアの MMK(MadGoat http://www.madgoat.com から 入手可能)があることを確認してください。 次に次のように入力してモジュール用の DESIPP.MMS を作成します:

      perl Makefile.PL

  Now you're ready to build:

  これでビルドの準備ができました:

      mms test

  Substitute mmk for mms above if you're using MMK.

  MMK を使っている場合は、上記の mms を mmk に置き換えてください。

  D. INSTALL

  D. インストール

  Type

  次のように入力します:

      mms install

  Substitute mmk for mms above if you're using MMK.

  MMK を使っている場合は、上記の mms を mmk に置き換えてください。

• If you're on MVS,

  MVS を使っている場合

  Introduce the .tar.gz file into an HFS as binary; don't translate from ASCII to EBCDIC.

  .tar.gz ファイルをバイナリとして HFS に導入します。 ASCII から EBCDIC に変換しないでください。

  A. DECOMPRESS

  A. 伸張

  Decompress the file with gzip -d yourmodule.tar.gz

  gzip -d yourmodule.tar.gz でファイルを伸張します。

  You can get gzip from http://www.s390.ibm.com/products/oe/bpxqp1.html

  gzip は http://www.s390.ibm.com/products/oe/bpxqp1.html から入手できます。

  B. UNPACK

  B. 展開

  Unpack the result with

  結果を次のように展開します。

       pax -o to=IBM-1047,from=ISO8859-1 -r < yourmodule.tar

  The BUILD and INSTALL steps are identical to those for Unix. Some modules generate Makefiles that work better with GNU make, which is available from http://www.mks.com/s390/gnu/

  BUILD と INSTALL の手順は Unix の場合と同じです。 いくつかのモジュールは GNU make でより良く動作する Makefile を生成します; これは http://www.mks.com/s390/gnu/ から入手できます。

移植性¶

すべてのモジュールがすべてのプラットフォームで 動作するわけではないことに注意してください。 移植性の問題についての詳細は perlport を参照してください。 モジュールがお使いのシステムで動作するかどうかは、 文書を読んで確認してください。 すべてのプラットフォームで「そのままで」動作しないモジュールには、 基本的に三つのカテゴリがあります(重複する可能性もあります):

• Those that should, but don't. These need to be fixed; consider contacting the author and possibly writing a patch.

  動作するはずなのに動作しない。 これらは修正する必要があります; 作者に連絡してパッチを書くことを検討してください。

• Those that need to be compiled, where the target platform doesn't have compilers readily available. (These modules contain .xs or .c files, usually.) You might be able to find existing binaries on the CPAN or elsewhere, or you might want to try getting compilers and building it yourself, and then release the binary for other poor souls to use.

  コンパイルする必要があるけれども、ターゲットプラットフォームに はすぐに入手できるコンパイラがない。 (これらのモジュールには、通常 .xs または .c ファイルが含まれています。) CPAN やその他の場所で既存のバイナリを見つけることができるかもしれませんし、 あるいはコンパイラを入手して自分でビルドしてみて、他の不運な人々が 使えるようにバイナリをリリースすることもできます。

• Those that are targeted at a specific platform. (Such as the Win32:: modules.) If the module is targeted specifically at a platform other than yours, you're out of luck, most likely.

  特定のプラットフォームをターゲットにしたモジュール。 (Win32:: モジュールなど。) モジュールがあなたのものでないプラットフォームをターゲットにしている場合は、 おそらく運がありません。

モジュールがあなたのプラットフォームで 動作するはずなのに期待通りに動作しないか、またはモジュールが あなたのプラットフォームで動作するかどうか分からない場合は、 CPAN Testers をチェックしてください。 必要なモジュールがリストにない場合は、自分でテストして CPAN Testers に知らせたり、CPAN Testers に参加したり、テストを リクエストしたりできます。

    https://cpantesters.org/

HEY¶

このページで提案された変更点がありましたら、お知らせください。 モジュールのインストール方法に関するヘルプを求めるメールを私に 送らないでください。 モジュールは多すぎ、Orwants は少なすぎます; 私はあなたの質問に答えることも、すべての質問に答えることもできません。 モジュールの作成者に問い合わせるか、 オペレーティングシステムの Perl に精通した人に尋ねて、 どれもうまく行かなかった場合は、https://rt.cpan.org/ にチケットを 登録してください。

作者¶

Jon Orwant

[email protected]

Chris Nandor からの貴重な支援、そして Brandon Allbery, Charles Bailey, Graham Barr, Dominic Dunlop, Jarkko Hietaniemi, Ben Holzman, Tom Horsley, Nick Ing-Simmons, Tuomas J. Lukka, Laszlo Molnar, Alan Olsen, Peter Prymmer, Gurusamy Sarathy, Christoph Spalinger, Dan Sugalski, Larry Virden, Ilya Zakharevich からの 価値ある助けと共に。

First version July 22, 1998; last revised November 21, 2001.

コピーライト¶

Copyright (C) 1998, 2002, 2003 Jon Orwant. All Rights Reserved.

This document may be distributed under the same terms as Perl itself.