=encoding euc-jp =head1 名前 Net::Netrc - ユーザnetrcファイルへのOOインターフェース =head1 概要 use Net::Netrc; $mach = Net::Netrc->lookup('some.machine'); $login = $mach->login; ($login, $password, $account) = $mach->lpa; =head1 説明 Cはftpプログラムによって使われる.netrcファイルへの 簡単なインターフェースを実装するクラスです。 Cはちょうどftpプログラムのようなセキュリティ・チェックも 実装します。これらのチェックは、第一に.netrcファイルがユーザによって 所有されていなければならないこと、第二に所有者だけが読み込みと書込みの アクセスを持っているような所有パーミッションになっていなければならないことです。 もしこれらの条件が合わなければ、警告が出力され、.netrcは読み込まれません。 =head1 .netrcファイル .netrcファイルには自動ログイン処理によって利用されるログインと初期化情報が 入っています。それはユーザのホームディレクトリにあります。 以下のトークンが理解されます;これらはスペース、タブ、改行で区切ることが出来ます: =over 4 =item machine name リモートのマシン名を識別します。自動ログイン処理は 指定されたリモートマシンにマッチするmachineトークンを .netrcファイルで検索します。一度マッチができると、その後の .netrcトークンが処理されます。ファイルの終わりまで来るか、 他のmachineあるいはdefaultトークンにぶつかると止まります。 =item default これはdefaultがすべての名前にマッチする点を除いて、 machine nameと同じです。defaultトークンはただ一つだけです。 そしてそれは全てのmachineトークンの後でなければなりません。 これは通常以下のように使われます: default login anonymous password user@site これによって.netrcで指定されないマシンへの自動anonymousログインに ユーザを与えます。 =item login name リモートマシンでのユーザを識別します。このトークンがあると、 自動ログイン処理は指定された名前を使ってログインを開始します。 =item password string パスワードを提供します。このトークンがあると、自動ログイン処理は リモートサーバーがログイン処理の一部として、パスワードを要求すると 指定された文字列を提供します。 =item account string 追加のアカウント・パスワードを提供します。このトークンがあると、 もしリモートサーバが追加のアカウント・パスワードを要求すると、 自動ログイン処理は指定された文字列を提供します。 =item macdef name マクロを定義します。Cは、このフィールドがIと互換性が あるかを解析するだけです。 =back =head1 コンストラクタ Cオブジェクトのコンストラクタはnewで呼ばれません。 というのもこれは本当には新しいオブジェクトを作らないからです。 しかしその代わりに、基本的にはそれが行うようにCが呼ばれます。 =over 4 =item lookup ( MACHINE [, LOGIN ]) 検索しCのためのエントリへのリファレンスを返します。 Cが与えられると、返されるエントリは与えられたログインを持っているでしょう。 もしCが与えられないと、.netrcファイルでのCのための最初のエントリが 返されます。 マッチするエントリが見つからず、defaultエントリがあると、 defaultエントリへのリファレンスが返されます。 マッチするエントリが見つからず、defaultエントリも定義されていない、あるいは .netrcファイルが見つからなければ、Cが返されます。 =back =head1 =over 4 =item login () netrcエントリのためのログインIDを返します =item password () netrcエントリのためのパスワードを返します =item account () netrcエントリのためのアカウント情報を返します =item lpa () netrcエントリのためのログイン、パスワード、アカウント情報のリストを返します =back =head1 作者 Graham Barr =head1 参考資料 L L =head1 著作権(COPYRIGHT) Copyright (c) 1995-1998 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. =for html
$Id: Netrc.pod,v 1.2 2011/01/27 13:15:11 iwai Exp $