libnet-1.12 > libnetFAQ

libnet-1.12

誤訳の報告

名前
説明
- このドキュメントはどこで手に入りますか
- このドキュメントに貢献する方法は
作者および著作権情報(=Author and Copyright Information)
- 放棄声明(Disclaimer)
libnetの取得とインストール
Net::FTPの使い方
Net::SMTPの使い方
スクリプトのデバッグ方法
- Net::*モジュールを使うスクリプトをデバッグするにはどうすればいいですか？
作者と著作権(AUTHOR AND COPYRIGHT)

名前¶

libnetFAQ - libnetでよく聞かれる質問(Frequently Asked Questions)

説明¶

このドキュメントはどこで手に入りますか¶

このドキュメントはlibnetディストリビューションと一緒に配布されます。また下記のlibnet Webページからも取得することが出来ます

    http://www.pobox.com/~gbarr/libnet/

このドキュメントに貢献する方法は¶

修正、追加そして提案を私にメールすることができます [email protected].

作者および著作権情報(=Author and Copyright Information)¶

放棄声明(Disclaimer)¶

この情報は正しいという信念のもとに、そしてこれが便利であるようにという希望をもって提供されています。しかし正しく、最新で、どのような特定の目的に対しても適切であるということは保障されません。作者はこの情報あるいは利用について何の責任も負いません。

libnetの取得とインストール¶

libnetって何？¶

libnetperl5モジュールの集合体で、それらは全てネットワークプログラムに関連します。利用できるモジュールの多くはインターネット・コミュニティで使われる、ポピュラーなサーバー-クライアントプロトコルでのクライアント側を提供します。

どのバージョンのperlが必要ですか？¶

libnetはperlのバージョン5.002以降で動くことがわかっています。しかしあなたのperlのバージョンがperl5.004より前であれば、CPANからIO ディストリビューションを取得し、インストールする必要があります。もしperl5.004やそれ以降をもっていればIOモジュール群は既にインストールされています。しかしCPANには更新されているものがあるかもしれません。

他に必要なモジュールは何ですか？¶

あなたがインストールする必要があるモジュールはIOディストリビューションのモジュールだけです。perl5.004以降を持っているのであれば、それらのモジュールは既に持っていることになります。

どのマシンがlibnetをサポートしていますか？¶

libnetそれ自身は完全にperlで書かれた(perl-code)ディストリビューションです。そのためperlが実行できる全てのマシンで動くでしょう。しかしIOはいくつかのマシンそしてperlの前のバージョンでは動かないかもしれません。しかし perlバージョン5.004以降では、そのようなことはないでしょう。

最新のlibnetリリースはどこで手に入りますか？¶

最新のlibnetリリースは常にCPANにあります。それは以下のところで見つかるでしょう

 http://www.cpan.org/modules/by-module/Net/

最新のリリースと情報は常にlibnet webページにもあります

 http://www.pobox.com/~gbarr/libnet/

Net::FTPの使い方¶

FTPサーバからファイルをダウンロードする方法は？¶

comp.lang.perl.miscにポストされた記事からの例

    #!/your/path/to/perl

    # 人生を楽にしてくれるモジュール

    use Net::FTP;

    # デバッグ用: $ftp = Net::FTP->new('site','Debug',10);
    # 接続をオープンし、ログイン!

    $ftp = Net::FTP->new('target_site.somewhere.xxx');
    $ftp->login('username','password');

    # 転送モードをバイナリに設定

    $ftp->binary();

    # ftp側のディレクトリを変更

    $ftp->cwd('/some/path/to/somewhere/');

    foreach $name ('file1', 'file2', 'file3') {

    # getの引数は以下の順番:
    # ftpサーバーのファイル名
    # 転送によりローカルマシン上に保存されるファイル名
    # 同じ名前にしたければ、単純にget($name)とすることもできます

      $ftp->get($name,$name);
    }

    # ftp 終了!

    $ftp->quit;

バイナリ・モードでファイルを転送する方法は？¶

<LF><CR>の変換なしに転送するため、Net::FTPはbinaryメソッドを提供しています。

    $ftp->binary;

リモートのFTPサーバ上にあるファイルの大きさを取得する方法は？¶

リモートのFTPサーバ上にあるファイルの更新日時を取得する方法は？¶

リモートのFTPサーバ上にあるファイルのパーミッションを取得する方法は？¶

FTPプロトコルはリモート・サーバ上のファイルのパーミッションを変更するためのコマンドを持っていません。しかしいくつかのftpサーバーはSITEコマンドを通してchmodコマンドを発行することを許すかもしれません。例えば

    $ftp->quot('site chmod 0777',$filename);

しかしこれは動くことが保障されません。

ftpコマンドのような再取得(reget)操作はできますか？¶

FTPサーバーからディレクトリのリストを取得する方法は？¶

""にディレクトリを変更することは失敗しませんか？¶

->cwd()に""という引数を渡すことは、引数なしで->cwd()を呼び出すのと同じ効果を持ちます。Debug(下記参照)を有効にすれば、何が起きるかがわかるでしょう

    $ftp = Net::FTP->new($host, Debug => 1);
    $ftp->login;
    $ftp->cwd("");

以下のようになります

    Net::FTP=GLOB(0x82196d8)>>> CWD /
    Net::FTP=GLOB(0x82196d8)<<< 250 CWD command successful.

SOCKSファイアウォールの内側にいます。しかしFirewallオプションが機能しません？¶

Firewallオプションは１種類のファイアウォールをサポートしています。そのサポートされている種類はftp proxyです。

Net::FTPやlibnetディストリビューションに入っているその他のモジュールを SOCKSファイアウォールを通して利用するためには、 socksライブラリと一緒にperlをコンパイルすることにより socks対応された(socks-ified) perl 実行形式を作成しなければなりません。

FTPプロキシー・ファイアウォールの内側にいますが、外側のマシンにアクセスできません¶

Net::FTPはほとんどのポピュラーなftpプロキシー・ファイアウォール・アプローチを実装してます。実装されている概要は、あなたがファイアウォールにuser@hostnameでログインすることです。

あるアカウントでファイアウォールにログインし、次にuser@hostnameでログインすることを要求する他の種類のファイアウォールがあることを聞いたことがあります。それでもNet::FTPを使って、これらのファイアウォールを通ることが出来ます。しかしより手作業のアプローチを取らなければなりません。eg

    $ftp = Net::FTP->new($firewall) or die $@;
    $ftp->login($firewall_user, $firewall_passwd) or die $ftp->message;
    $ftp->login($ext_user . '@' . $ext_host, $ext_passwd) or die $ftp->message.

私のファイアウォールはポート21をリスンしません¶

他のどのFTPサーバーと同じようにFTPサーバーは通常、同じポート番号、ポート21をリスンします。しかしそうしなければいけない理由はありません。

Net::FTPにポート番号を渡すと、それが最終的な出力先のポート番号だと想定します。デフォルトではNet::FTPは常にポート21でファイアウォールに接続しようとします。

Net::FTPは接続をオープンするためにIO::Socketを利用します。そしてIO::Socketはポート番号をホスト名の一部として指定されることを許しています。このためのこの問題は"hostname:1234"のようにFirewallオプションを渡すか、同じ形式でNet::Configでのftp_firewallを設定するかのどちらかによって解決することができます。

FTPサーバー上のファイルのパーミッションを変更することはできますか？¶

この答えは"多分"です。FTPプロトコルはリモートホスト上のファイル・パーミッションを変更するためのコマンドを指定していません。しかし多くのサーバーはSITEコマンドを通してchmodコマンドを実行することを許しています。これは以下のようになります

  $ftp->site('chmod','0775',$file);

メソッドmessageを呼んでいるスクリプトを見たことがありますが、ドキュメントに見当たりません？¶

libnetに入っているほかのパッケージと同じようにNet::FTPはNet::Cmdを継承しています。そのためNet::Cmdで記述されている全てのメソッドもNet::FTPオブジェクトで利用することができます。

なぜNet::FTPはmputとmgetメソッドを実装していないのですか？¶

簡単な答えは、あなた自身で実装するのが簡単だからです。長い答えはこれらを複数のプラットホームが正しくサポートされるように書くことはあまりにも多くのコードが必要となるからです。いかにあなた自身がそれらをどのように実装できるかの例をいくつか示します。

sub mput { my($ftp,$pattern) = @_; foreach my $file (glob($pattern)) { $ftp->put($file) or warn $ftp->message; } }

sub mget { my($ftp,$pattern) = @_; foreach my $file ($ftp->ls($pattern)) { $ftp->get($file) or warn $ftp->message; } }

Net::SMTPの使い方¶

@から後ろのEmailアドレスの部分をホスト名として使えないのはなぜですか？¶

Emailアドレスでの@からの後ろ部分は必ずしもホスト名ではありません。それはメールドメインです。メールドメインに接続するためのホストの名前を見つけるためは、DNS MX lookupをする必要があります。

Net::SMTPがDNS MX lookupをしないのはなぜですか？¶

Net::SMTPはSMTPプロトコルを実装します。DNS MX lookupはそのプロトコルの一部ではありません。

verifyが常にtrueを返すのはなぜですか？¶

それはそんな風に見えてしまうかもしれませんが、そうではありません。そのコマンドが成功すると、verifyメソッドはtrueを返します。サーバーが通常、他のマシンに転送しなければならないアドレスをverifyに渡すと、コマンドは以下のように成功します

    252 Couldn't verify <someone@there> but will attempt delivery anyway
    （<someone@there>を確認することはできませんが、いずれにせよ配送しようとします）

このコマンドは、そのサーバーが直接配送するドメインにあるアドレスを渡し、それが存在しない場合にのみ失敗します。

スクリプトのデバッグ方法¶

Net::*モジュールを使うスクリプトをデバッグするにはどうすればいいですか？¶

libnetクライアントクラスのほとんどは、コンストラクタにオプションを渡すことができます。ほとんどの場合、あるオプションはDebugと呼ばれます。このオプションを0以外の値を渡すと、プロトコルのトレースを有効とし、それらはSTDERRに送られます。このトレースはリモート・サーバーに送られるコマンド、返され受け取られる応答が何かを見るのに便利です。

    #!/your/path/to/perl

    use Net::FTP;

    my $ftp = new Net::FTP($host, Debug => 1);
    $ftp->login('gbarr','password');
    $ftp->quit;

このスクリプトは以下のように出力するでしょう

 Net::FTP: Net::FTP(2.22)
 Net::FTP:   Exporter
 Net::FTP:   Net::Cmd(2.0801)
 Net::FTP:   IO::Socket::INET
 Net::FTP:     IO::Socket(1.1603)
 Net::FTP:       IO::Handle(1.1504)

 Net::FTP=GLOB(0x8152974)<<< 220 imagine FTP server (Version wu-2.4(5) Tue Jul 29 11:17:18 CDT 1997) ready.
 Net::FTP=GLOB(0x8152974)>>> user gbarr
 Net::FTP=GLOB(0x8152974)<<< 331 Password required for gbarr.
 Net::FTP=GLOB(0x8152974)>>> PASS ....
 Net::FTP=GLOB(0x8152974)<<< 230 User gbarr logged in.  Access restrictions apply.
 Net::FTP=GLOB(0x8152974)>>> QUIT
 Net::FTP=GLOB(0x8152974)<<< 221 Goodbye.

最初の数行はNet::FTPが利用するモジュールとそのバージョンを伝えます。これはユーザーがバグを報告するとき、私にとって有効なデータです。最後の7行はサーバとの通信を表しています。各行には3つの部分があります。最初の部分はオブジェクトそのものです。これはもし複数のオブジェクトを使っているならば、出力を切り分けるために有効です。2番目の部分はサーバからのデータを示す<<<< あるいはサーバーにいくデータを示す&gt&gt&gt&gtのどちらかになります。行の残りは送信されるコマンドもしくは受け取られた応答になります。

作者と著作権(AUTHOR AND COPYRIGHT)¶

$Id$