Network Working Group                                          T. Taylor
Request for Comments: 4735                                        Nortel
Category: Standards Track                                   October 2006
        
              Example Media Types for Use in Documentation
        

Status of This Memo

このメモのステータス

This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited.

この文書は、インターネットコミュニティのためのインターネット標準トラックプロトコルを指定し、改善のための議論と提案を要求します。このプロトコルの標準化状態と状態への「インターネット公式プロトコル標準」(STD 1)の最新版を参照してください。このメモの配布は無制限です。

Copyright Notice

著作権表示

Copyright (C) The Internet Society (2006).

著作権(C)インターネット協会(2006)。

Abstract

抽象

   This document is registration for the 'example' media type and
   'example' subtypes within the standards tree.  The 'example/*' and
   '*/example' media types are defined for documentation purposes only.
        
1. Introduction
1. はじめに

From time to time, documents created by the IETF or by other standards bodies show examples involving the use of media types, where the actual media type is not relevant. It would be useful in such cases to be able to show a media type whose illustrative role in the example is clear. In the worst case, this can be useful to debug implementations where the designer mistook the example for a requirement of the protocol concerned.

時々、IETFによって、または他の標準化団体によって作成された文書は、実際のメディアタイプは関係ありませんメディアタイプの使用を伴う例を示しました。その説明の役割の例でも明らかなメディアタイプを表示できるようにするには、このような場合に有用であろう。最悪の場合、これは、設計者が、当該プロトコルの要件のための一例を間違えたデバッグの実装に有用であり得ます。

To meet this need, this document registers the following media types:

このニーズを満たすために、このドキュメントでは、次のメディアタイプを登録します。

o the 'example' media type;

「例」メディアタイプO;

o the 'application/example', 'audio/example', 'image/example', 'message/example', 'model/example', 'multipart/example', 'text/example', and 'video/example' media subtypes.

「アプリケーション/たとえば」、「オーディオ/例」、「画像/たとえば」、「メッセージ/たとえば」、「モデル/例」、「マルチパート/例」、「テキスト/例」、および「ビデオ/例をO」メディアサブタイプ。

It is suggested that compilers of illustrative examples involving media types in trees other than the standards tree might also incorporate the string "example" into their hypothetical media types.

規格木以外の木にメディアタイプを含む例示的実施例のコンパイラは、また、その仮想的なメディアタイプに文字列「例」を組み込む可能性が示唆されます。

2. Terminology
2.用語

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119].

この文書のキーワード "MUST"、 "MUST NOT"、 "REQUIRED"、、、、 "べきではない" "べきである" "ないもの" "ものとし"、 "推奨"、 "MAY"、および "OPTIONAL" はあります[RFC2119]に記載されているように解釈されます。

3. Registration of the 'example' Media Type
「例えば、」メディアタイプの3登録

This section registers the 'example' media type in accordance with the requirements of RFC 4288.

このセクションでは、RFC 4288の要件に応じて、「例」メディアタイプを登録します。

Type name: example.

型名:例。

Subtype name: any subtype may be used with the 'example' type. However, IANA MUST NOT register any subtypes for the 'example' media type.

サブタイプ名:任意のサブタイプは、「例」タイプと一緒に使用することができます。しかし、IANAは、「example」というメディアタイプのいずれかのサブタイプを登録してはなりません。

Required parameters: as invented by the user.

必須パラメータ:ユーザーによって発明として。

Optional parameters: as invented by the user.

オプションのパラメータ:ユーザーによって発明として。

Encoding considerations: as invented by the user.

エンコードの考慮事項:ユーザーによって発明として。

Security considerations: The 'example' media type is defined for use in documentation only. It MUST NOT be implemented. Its appearance in real code could lead to unpredictable results and therefore open up security holes.

セキュリティの考慮事項:「例のメディアタイプのみのドキュメントで使用するために定義されています。それは実装されてはなりません。実際のコードでは、その外観は、予期しない結果になるので、セキュリティホールを開くことができます。

Interoperability considerations: Any attempt to negotiate or send the 'example' media type is bound to lead to interoperability problems.

相互運用性に関する注意事項:交渉や「例」メディアタイプは、相互運用性の問題を引き起こすためにバインドされて送信しようとします。

Published specification: this document.

公開された仕様:このドキュメント。

Applications that use this media type: as invented by the user.

ユーザーによって発明として:このメディアタイプを使用するアプリケーション。

Additional information: Magic number(s): not applicable. File extension(s): not applicable. Macintosh file type code(s): not applicable.

追加情報:マジックナンバー(S):適用されません。ファイルの拡張子(S):適用されません。 Macintoshのファイルタイプコード(S):適用されません。

Person & email address to contact for further information: ietf-types@iana.org.

ietf-types@iana.org:人とEメールアドレスは、詳細のために連絡します。

Intended usage: LIMITED USE.

意図している用法:限定使用。

Restrictions on usage: This type is intended only for use in documents providing examples involving specification of some media type, where the actual media type used is irrelevant.

使用に関する制限事項:このタイプにのみ使用される実際のメディアタイプが無関係であるいくつかのメディアタイプの仕様を伴う例を提供するドキュメントで使用するためのものです。

Author: Internet Engineering Task Force

著者:インターネットエンジニアリングタスクフォース

Change controller: Internet Engineering Task Force

変更コントローラ:インターネットエンジニアリングタスクフォース

4. Registration of the 'application/example', 'audio/example', 'image/example', 'message/example', 'model/example', 'multipart/example', 'text/example', and 'video/example' Subtypes

4.「アプリケーション/例」の登録、「オーディオ/例」、「画像/たとえば」、「メッセージ/たとえば」、「モデル/例」、「マルチパート/例」、「テキスト/たとえば」、及び「ビデオ/例」サブタイプ

    This section registers 'example' media subtypes in accordance with
    the requirements of RFC 4288.
        

Type name: 'application', 'audio', 'image', 'message', 'model', 'multipart', 'text', and 'video'.

型名:「アプリケーション」、「オーディオ」、「画像」、「メッセージ」、「モデル」、「マルチパート」、「テキスト」、および「ビデオ」。

Subtype name: 'example'.

サブタイプ名: 'example' という。

Required parameters: those required by the type and any others as invented by the user.

必須パラメータ:タイプとユーザーによって発明として任意の他の人が必要とします。

Optional parameters: those offered by the type and any others as invented by the user.

オプションのパラメータ:タイプとユーザーによって発明として他のものによって提供されるもの。

Encoding considerations: as invented by the user.

エンコードの考慮事項:ユーザーによって発明として。

Security considerations: The 'example' media subtypes are defined for use in documentation only. They MUST NOT be implemented. Their appearance in real code could lead to unpredictable results and therefore open up security holes.

セキュリティの考慮事項:「例のメディアサブタイプは、ドキュメントだけで使用するために定義されています。彼らは実装されてはなりません。実際のコードでは、その外観は、予期しない結果になるので、セキュリティホールを開くことができます。

Interoperability considerations: Any attempt to negotiate or send one of these 'example' media subtypes is bound to lead to interoperability problems.

相互運用性に関する注意事項:交渉するか、これらの「例のメディアサブタイプのいずれかを送信しようとする試みは、相互運用性の問題を引き起こすにバインドされています。

Published specification: this document.

公開された仕様:このドキュメント。

Applications that use this media type: as invented by the user.

ユーザーによって発明として:このメディアタイプを使用するアプリケーション。

Additional information: Magic number(s): not applicable. File extension(s): not applicable. Macintosh file type code(s): not applicable.

追加情報:マジックナンバー(S):適用されません。ファイルの拡張子(S):適用されません。 Macintoshのファイルタイプコード(S):適用されません。

Person & email address to contact for further information: ietf-types@iana.org.

ietf-types@iana.org:人とEメールアドレスは、詳細のために連絡します。

Intended usage: LIMITED USE.

意図している用法:限定使用。

Restrictions on usage: These subtypes are intended only for use in documents providing examples involving specification of some subtype of the given media type, where the actual subtype used is irrelevant.

使用上の制限は、これらのサブタイプのみ使用される実際のサブタイプは無関係である所定のメディアタイプのいくつかのサブタイプの仕様を含む実施例を提供するドキュメントで使用するために意図されています。

Author: Internet Engineering Task Force

著者:インターネットエンジニアリングタスクフォース

Change controller: Internet Engineering Task Force

変更コントローラ:インターネットエンジニアリングタスクフォース

5. Security Considerations
5.セキュリティについての考慮事項

The 'example' media type and subtypes are defined for use in documentation only. They MUST NOT be implemented. Any attempt to implement them in real code could lead to unpredictable results and thus potentially open up security holes.

「例のメディアタイプおよびサブタイプは、ドキュメントだけで使用するために定義されています。彼らは実装されてはなりません。実際のコードでそれらを実装しようとすると、予期しない結果になるため、潜在的なセキュリティホールを開くことができます。

6. IANA Considerations
6. IANAの考慮事項

This document specifies and registers the 'example' media type and the 'application/example', 'audio/example', 'image/example', 'message/example', 'model/example', 'multipart/example', 'text/example', and 'video/example' subtypes.

この文書では、指定し「例」メディアタイプと「アプリケーション/たとえば」、「オーディオ/例」、「画像/たとえば」、「メッセージ/たとえば」、「モデル/例」、「マルチパート/例」、 "レジスタテキスト/例」、および 『ビデオ/例』のサブタイプ。

7. Acknowledgements
7.謝辞

This document sprang from Magnus Westerland's expression of need and Rod Walsh's support and suggestions for generalization. Warnings against implementation in the Security Considerations and Interoperability Considerations sections and the 'multipart/example' subtype were added at John Klensin's suggestion. Some editing touchups and strengthening of the language in the Security Considerations section were done in response to the Gen-ART reviewer, Sharon Chisholm.

この文書では、必要性のマグナスウェスターの表現と一般化のためのロッド・ウォルシュのサポートや提案からはねました。セキュリティの考慮事項および相互運用性に関する注意事項セクションでの実装と「マルチパート/例」サブタイプに対する警告は、ジョン・クレンシンの提案で添加しました。一部の編集touchupsおよびセキュリティに関する注意事項のセクションでの言語の強化はジェンART投稿者、シャロンチザムに応じて行われました。

8. Normative References
8.引用規格

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.

[RFC2119]ブラドナーの、S.、 "要件レベルを示すためにRFCsにおける使用のためのキーワード"、BCP 14、RFC 2119、1997年3月。

[RFC4288] Freed, N. and J. Klensin, "Media Type Specifications and Registration Procedures", BCP 13, RFC 4288, December 2005.

[RFC4288]解放され、N.とJ. Klensin、 "メディアタイプの仕様と登録手順"、BCP 13、RFC 4288、2005年12月。

Author's Address

著者のアドレス

Tom Taylor Nortel 1852 Lorraine Ave Ottawa, Ontario K1H 6Z8 Canada

トムテイラーノーテル1852ロレーヌアヴェオタワ、オンタリオ州K1H 6Z8カナダ

EMail: taylor@nortel.com

メールアドレス:taylor@nortel.com

Full Copyright Statement

完全な著作権声明

Copyright (C) The Internet Society (2006).

著作権(C)インターネット協会(2006)。

This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.

この文書では、BCP 78に含まれる権利と許可と制限の適用を受けており、その中の記載を除いて、作者は彼らのすべての権利を保有します。

This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

この文書とここに含まれている情報は、基礎とCONTRIBUTOR「そのまま」、ORGANIZATION HE / SHEが表すまたはインターネットソサエティおよびインターネット・エンジニアリング・タスク・フォース放棄すべての保証、明示または、(もしあれば)後援ISに設けられています。黙示、情報の利用は、特定の目的に対する権利または商品性または適合性の黙示の保証を侵害しない任意の保証含むがこれらに限定されません。

Intellectual Property

知的財産

The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.

IETFは、本書またはそのような権限下で、ライセンスがたりないかもしれない程度に記載された技術の実装や使用に関係すると主張される可能性があります任意の知的財産権やその他の権利の有効性または範囲に関していかなる位置を取りません利用可能です。またそれは、それがどのような権利を確認する独自の取り組みを行ったことを示すものでもありません。 RFC文書の権利に関する手続きの情報は、BCP 78およびBCP 79に記載されています。

Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.

IPRの開示のコピーが利用できるようにIETF事務局とライセンスの保証に行われた、または本仕様の実装者または利用者がそのような所有権の使用のための一般的なライセンスまたは許可を取得するために作られた試みの結果を得ることができますhttp://www.ietf.org/iprのIETFのオンラインIPRリポジトリから。

The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org.

IETFは、その注意にこの標準を実装するために必要とされる技術をカバーすることができる任意の著作権、特許または特許出願、またはその他の所有権を持ってすべての利害関係者を招待します。 ietf-ipr@ietf.orgのIETFに情報を記述してください。

Acknowledgement

謝辞

Funding for the RFC Editor function is provided by the IETF Administrative Support Activity (IASA).

RFCエディタ機能のための資金は、IETF管理サポート活動(IASA)によって提供されます。