X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=sasl-ja.texi;h=cafa3e77443bbb8da920fc03b7f3d34f58a7ac7d;hb=d8655d3d176e30078e56dd3218e212fe6d049047;hp=9a883f25b71704094989938f54a2c1ac629114d5;hpb=bc2ca8c1a65acaf43333fc7f069762d8ce8cd6bb;p=elisp%2Fgnus-doc-ja.git diff --git a/sasl-ja.texi b/sasl-ja.texi index 9a883f2..cafa3e7 100644 --- a/sasl-ja.texi +++ b/sasl-ja.texi @@ -1,250 +1,275 @@ \input texinfo @c -*-texinfo-*- +@include gnus-overrides-ja.texi + @setfilename sasl-ja +@iftex +@firstparagraphindent insert +@end iftex @set VERSION 0.2 - -@dircategory Emacs -@direntry -* SASL: (sasl-ja). The Emacs SASL library. -@end direntry - @settitle Emacs SASL Library @value{VERSION} -@ifinfo -This file describes the Emacs SASL library. +@copying +このファイルは Emacs SASL ライブラリー、バージョン @value{VERSION} を説 +明します。 -Copyright (C) 2000 Daiki Ueno. +Copyright @copyright{} 2000, 2004-2012 +Free Software Foundation, Inc. +@quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license is included in the section entitled "GNU -Free Documentation License". -@end ifinfo - -@tex +Invariant Sections, with the Front-Cover texts being ``A GNU Manual'', +and with the Back-Cover Texts as in (a) below. A copy of the license +is included in the section entitled ``GNU Free Documentation License''. + +この文書を、フリーソフトウェア財団発行の GNU フリー文書利用許諾契約書 +第 1.3 版またはそれ以降の版が定める条件の下で複製、配布、あるいは変更す +ることを許可します。変更不可部分は指定しません。“A GNU Manual”は表表紙 +テキスト、以下の (a) は裏表紙テキストです。この利用許諾契約書の複写は +「GNU フリー文書利用許諾契約書」という章に含まれています。 + +(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and +modify this GNU manual. Buying copies from the FSF supports it in +developing GNU and promoting software freedom.'' + +(a) FSF の裏表紙テキスト:「あなたにはこの GNU Manual を複製したり変更す +る自由があります。FSF からの複写の購入は GNU の開発とソフトウェアの自由 +の促進を支援します。」 + +This document is part of a collection distributed under the GNU Free +Documentation License. If you want to distribute this document +separately from the collection, you can do so by adding a copy of the +license to the document, as described in section 6 of the license. + +この文書は「GNU フリー文書利用許諾契約書」に基づいて配布された収集著作物 +の一部です。もしあなたがこの文書を収集著作物から分離して配布したいときは、 +契約書の第 6 項に記述されているように、文書に契約書の複写を付加すること +によって、行なうことができます。 +@end quotation +@end copying + +@dircategory Emacs network features +@direntry +* SASL-ja: (sasl-ja). The Emacs SASL library (Japanese). +@end direntry @titlepage -@title Emacs SASL Library +@ifset WEBHACKDEVEL +@title Emacs SASL Library @value{VERSION} (DEVELOPMENT VERSION) +@end ifset +@ifclear WEBHACKDEVEL +@title Emacs SASL Library @value{VERSION} +@end ifclear @author by Daiki Ueno @page @vskip 0pt plus 1filll -Copyright @copyright{} 2000 Daiki Ueno. - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license is included in the section entitled "GNU -Free Documentation License". +@insertcopying @end titlepage -@page - -@end tex @node Top @top Emacs SASL -This manual describes the Emacs SASL library. -A common interface to share several authentication mechanisms between -applications using different protocols. +SASL は異なるプロトコルを使うアプリケーション間で、複数の認証メカニズム +を共有するための共通インターフェースです。 + +@ifnottex +@insertcopying +@end ifnottex @menu -* Overview:: What Emacs SASL library is. -* How to use:: Adding authentication support to your applications. -* Data types:: -* Back end drivers:: Writing your own drivers. -* Index:: -* Function Index:: -* Variable Index:: +* Overview:: Emacs SASL ライブラリーとは +* How to use:: アプリケーションに認証サポートを追加する +* Data types:: +* Back end drivers:: 独自のドライバーを書く +* Index:: +* Function Index:: +* Variable Index:: @end menu @node Overview -@chapter Overview +@chapter 大要 -@sc{sasl} is short for @dfn{Simple Authentication and Security Layer}. -This standard is documented in RFC2222. It provides a simple method for -adding authentication support to various application protocols. +@sc{sasl} は @dfn{Simple Authentication and Security Layer} の略です。標 +準は RFC2222 に文書化されています。これは、さまざまなアプリケーション・ +プロトコルに、認証サポートを追加するための簡単な手段を提供します。 -The toplevel interface of this library is inspired by Java @sc{sasl} -Application Program Interface. It defines an abstraction over a series -of authentication mechanism drivers (@ref{Back end drivers}). +このライブラリーの最上位のインターフェースは、Java @sc{sasl} Application +Program Interface によって触発されました。それは、抽象化した一連の認証メ +カニズムのドライバーを定義します。 -Back end drivers are designed to be close as possible to the -authentication mechanism. You can access the additional configuration -information anywhere from the implementation. +バックエンドのドライバーは、なるべく認証メカニズムに密接していることを目 +指しています。どこにある追加の設定情報にも、この実装からアクセスすること +ができます。 @node How to use -@chapter How to use +@chapter 使い方 -(Not yet written). +(まだ書かれていません)。 -To use Emacs SASL library, please evaluate following expression at the -beginning of your application program. +Emacs SASL ライブラリーを使うには、アプリケーション・プログラムの最初で、 +以下の式を評価してください。 @lisp (require 'sasl) @end lisp -If you want to check existence of sasl.el at runtime, instead you -can list autoload settings for functions you want. +実行時にのみ sasl.el が存在していることを検査したいならば、代わりに必要 +な関数の autoload の設定を並べておいても構いません。 @node Data types -@chapter Data types +@chapter データの型 -There are three data types to be used for carrying a negotiated -security layer---a mechanism, a client parameter and an authentication -step. +ネゴシエートされたセキュリティー層の伝送に使われる三つのデータの型として、 +メカニズム、クライアント・パラメーター、および認証ステップがあります。 @menu -* Mechanisms:: -* Clients:: -* Steps:: +* Mechanisms:: +* Clients:: +* Steps:: @end menu @node Mechanisms -@section Mechanisms +@section メカニズム -A mechanism (@code{sasl-mechanism} object) is a schema of the @sc{sasl} -authentication mechanism driver. +メカニズム (@code{sasl-mechanism} オブジェクト) が、@sc{sasl} 認証メカニ +ズムのドライバーのスキームです。 @defvar sasl-mechanisms -A list of mechanism names. +メカニズム名のリスト。 @end defvar @defun sasl-find-mechanism mechanisms +適切なメカニズムを取得します。@* +この関数は @var{mechanisms} と @code{sasl-mechanisms} を比較して、適切 +な @code{sasl-mechanism} オブジェクトを返します。 -Retrieve an apropriate mechanism. -This function compares @var{mechanisms} and @code{sasl-mechanisms} then -returns apropriate @code{sasl-mechanism} object. - -@example +@lisp (let ((sasl-mechanisms '("CRAM-MD5" "DIGEST-MD5"))) (setq mechanism (sasl-find-mechanism server-supported-mechanisms))) -@end example - +@end lisp @end defun @defun sasl-mechanism-name mechanism -Return name of mechanism, a string. +メカニズムの名前を文字列で返します。 @end defun -If you want to write an authentication mechanism driver (@ref{Back end -drivers}), use @code{sasl-make-mechanism} and modify -@code{sasl-mechanisms} and @code{sasl-mechanism-alist} correctly. +認証メカニズムのドライバー (@ref{Back end drivers}) を書きたければ、 +@code{sasl-make-mechanism} を使い、@code{sasl-mechanisms} およ +び @code{sasl-mechanism-alist} を正しく変更してください。 @defun sasl-make-mechanism name steps -Allocate a @code{sasl-mechanism} object. -This function takes two parameters---name of the mechanism, and a list -of authentication functions. +@code{sasl-mechanism} オブジェクトを割り当てます。@* +この関数は二つのパラメーター、すなわちメカニズムの名前、および認証するた +めの関数のリストを受け取ります。 -@example +@lisp (defconst sasl-anonymous-steps - '(identity ;no initial response + '(identity ; 最初は応答無し sasl-anonymous-response)) (put 'sasl-anonymous 'sasl-mechanism (sasl-make-mechanism "ANONYMOUS" sasl-anonymous-steps)) -@end example - +@end lisp @end defun @node Clients -@section Clients +@section クライアント -A client (@code{sasl-client} object) initialized with four -parameters---a mechanism, a user name, name of the service and name of -the server. +クライアント (@code{sasl-client} オブジェクト) は四つのパラメーター、す +なわちメカニズム、ユーザー名、サービス名、およびサーバー名によって初期化 +されます。 @defun sasl-make-client mechanism name service server -Prepare a @code{sasl-client} object. +@code{sasl-client} オブジェクトを用意します。 @end defun @defun sasl-client-mechanism client -Return the mechanism (@code{sasl-mechanism} object) of client. +クライアントのメカニズム (@code{sasl-mechanism} オブジェクト) を返します。 @end defun @defun sasl-client-name client -Return the authorization name of client, a string. +クライアントの認証名を文字列で返します。 @end defun @defun sasl-client-service client -Return the service name of client, a string. +クライアントのサービス名を文字列で返します。 @end defun @defun sasl-client-server client -Return the server name of client, a string. +クライアントのサーバー名を文字列で返します。 @end defun -If you want to specify additional configuration properties, please use -@code{sasl-client-set-property}. +属性の設定を追加したい場合は、@code{sasl-client-set-property} を使ってく +ださい。 @defun sasl-client-set-property client property value -Add the given property/value to client. +与えられた属性およびその値をクライアントに追加します。 @end defun @defun sasl-client-property client property -Return the value of the property of client. +クライントの属性の値を返します。 @end defun @defun sasl-client-set-properties client plist -Destructively set the properties of client. -The second argument is the new property list. +クライアントの属性を破壊的に設定します。@* +第二引数は新しいプロパティー・リスト (plist) です。 @end defun @defun sasl-client-properties client -Return the whole property list of client configuration. +クライアントの設定のプロパティー・リストを、まるごと返します。 @end defun @node Steps -@section Steps +@section ステップ -A step (@code{sasl-step} object) is an abstraction of authentication -``step'' which holds the response value and the next entry point for the -authentication process (the latter is not accessible). +ステップ (@code{sasl-step} オブジェクト) は認証「ステップ」の抽象化です。 +それは、応答の値と次回の認証処理の入り口を保持します (後者はアクセスでき +ません)。 @defun sasl-step-data step -Return the data which @var{step} holds, a string. +@var{step} が保持するデータを文字列で返します。 @end defun @defun sasl-step-set-data step data -Store @var{data} string to @var{step}. +@var{step} に @var{data} の文字列を格納します。 @end defun -To get the initial response, you should call the function -@code{sasl-next-step} with the second argument @code{nil}. +最初の応答を得るには、第二引数を @code{nil} にして関 +数 @code{sasl-next-step} を呼ばなければなりません。 -@example +@lisp (setq name (sasl-mechanism-name mechanism)) -@end example +@end lisp -At this point we could send the command which starts a SASL -authentication protocol exchange. For example, +この段階で、SASL の認証プロトコルの交換を開始するコマンドを送ることがで +きます。例です。 -@example +@lisp (process-send-string process - (if (sasl-step-data step) ;initial response - (format "AUTH %s %s\r\n" name (base64-encode-string (sasl-step-data step) t)) + (if (sasl-step-data step) ; 最初の応答 + (format "AUTH %s %s\r\n" + name (base64-encode-string (sasl-step-data step) t)) (format "AUTH %s\r\n" name))) -@end example +@end lisp -To go on with the authentication process, all you have to do is call -@code{sasl-next-step} consecutively. +認証処理を続けるために行なわなければならないことは、連続し +て @code{sasl-next-step} を呼ぶことです。 @defun sasl-next-step client step -Perform the authentication step. -At the first time @var{step} should be set to @code{nil}. +認証ステップを実行します。@* +最初は @var{step} を @code{nil} に設定しなければなりません。 @end defun @node Back end drivers -@chapter Back end drivers +@chapter バックエンド・ドライバー -(Not yet written). +(まだ書かれていません)。 @node Index @chapter Index