目次

NIST IR 7695 日本語訳

英語タイトル : Common Platform Enumeration: Naming Specification Version 2.3
日本語タイトル : 共通プラットフォーム列挙:命名仕様 バージョン 2.3
公開日 : 2011-08-19
原文URL : https://csrc.nist.gov/pubs/ir/7695/final
翻訳編集 : 自動生成(有志による非公式の日本語訳), 原文取得日 : 2026-10-31, 訳文 : 500 / 549 ブロック

[要約] NIST IR 7695 は、Common Platform Enumeration(CPE)Naming バージョン 2.3 仕様を定義する報告書です。CPE Naming 仕様は、IT 製品の記述と命名に関するさまざまなユースケースを支援する CPE 仕様群の一部であり、IT 製品クラスの名前の論理構造と、これらの名前を機械可読なエンコーディングへバインドし、またそこからアンバインドする手順を定義します。本書は、WFN と名前バインディングの要件を含め、CPE Naming の実装が同仕様への適合を主張するために満たさなければならない要件も定義し、説明します。適用されるのは CPE Naming のバージョン 2.3 のみで、他のバージョンや CPE Naming 以外の CPE 仕様は適用範囲外とされています。

図表
[NIST logo — not reproduced on this unofficial site]

[NIST のロゴ。公的な標章のため、この非公式サイトには掲載していません。原本 PDF を参照してください。]

NIST Interagency Report 7695

NIST Interagency Report 7695

Common Platform Enumeration: Naming Specification Version 2.3

Common Platform Enumeration: Naming Specification Version 2.3

Brant A. Cheikes
David Waltermire
Karen Scarfone

Brant A. Cheikes
David Waltermire
Karen Scarfone

NIST Interagency Report 7695

NIST Interagency Report 7695

Common Platform Enumeration: Naming Specification Version 2.3

Common Platform Enumeration: Naming Specification Version 2.3

Brant A. Cheikes
David Waltermire
Karen Scarfone

Brant A. Cheikes
David Waltermire
Karen Scarfone

COMPUTER SECURITY

COMPUTER SECURITY

Computer Security Division
Information Technology Laboratory
National Institute of Standards and Technology
Gaithersburg, MD 20899-8930

Computer Security Division
Information Technology Laboratory
National Institute of Standards and Technology
Gaithersburg, MD 20899-8930

August 2011

August 2011

U.S. Department of Commerce
Rebecca M. Blank, Acting Secretary

米国商務省
Rebecca M. Blank 長官代行

National Institute of Standards and Technology
Patrick D. Gallagher, Under Secretary for Standards and Technology and Director

国立標準技術研究所(National Institute of Standards and Technology)
Patrick D. Gallagher、標準・技術担当次官兼所長

Reports on Computer Systems Technology

コンピュータシステム技術に関する報告書

The Information Technology Laboratory (ITL) at the National Institute of Standards and Technology (NIST) promotes the U.S. economy and public welfare by providing technical leadership for the nation’s measurement and standards infrastructure. ITL develops tests, test methods, reference data, proof of concept implementations, and technical analysis to advance the development and productive use of information technology. ITL’s responsibilities include the development of technical, physical, administrative, and management standards and guidelines for the cost-effective security and privacy of sensitive unclassified information in Federal computer systems. This Interagency Report discusses ITL’s research, guidance, and outreach efforts in computer security and its collaborative activities with industry, government, and academic organizations.

国立標準技術研究所(NIST)の情報技術研究所(ITL)は、国の計測・標準インフラに対する技術的なリーダーシップを提供することにより、米国の経済と公共の福祉を促進しています。ITL は、情報技術の開発と生産的な利用を推進するため、試験、試験方法、参照データ、概念実証の実装、技術分析を開発しています。ITL の責務には、連邦コンピュータシステムにおける機密扱いでない情報のセキュリティとプライバシーを費用対効果よく確保するための、技術的、物理的、管理的、運用管理上の標準およびガイドラインの策定が含まれます。この Interagency Report は、コンピュータセキュリティにおける ITL の研究、ガイダンス、アウトリーチ活動と、産業界、政府、学術機関との協力活動について述べています。

National Institute of Standards and Technology Interagency Report 7695
49 pages (Aug. 2011)

National Institute of Standards and Technology Interagency Report 7695
49 pages (Aug. 2011)

Certain commercial entities, equipment, or materials may be identified in this document in order to describe an experimental procedure or concept adequately. Such identification is not intended to imply recommendation or endorsement by the National Institute of Standards and Technology, nor is it intended to imply that the entities, materials, or equipment are necessarily the best available for the purpose.

この文書では、実験の手順や概念を適切に説明するために、特定の商業組織、機器、材料に言及している場合があります。このような言及は、国立標準技術研究所による推奨や支持を意味するものではなく、また、それらの組織、材料、機器が目的に対して必ずしも最良のものであることを意味するものでもありません。

Acknowledgments

謝辞

The authors, Brant A. Cheikes of The MITRE Corporation, David Waltermire of the National Institute of Standards and Technology (NIST), and Karen Scarfone of Scarfone Cybersecurity wish to thank their colleagues who reviewed drafts of this document and contributed to its technical content. The authors would like to acknowledge Harold Booth and Paul Cichonski of NIST, Adam Halbardier and David Lee of Booz Allen Hamilton, Seth Hanford of Cisco Systems, Inc., Tim Keanini of nCircle, Kent Landfield of McAfee, Inc., Mary Parmelee of The MITRE Corporation, Jim Ronayne of Varen Technologies, Shane Shaffer of G2, Inc., and Joseph L. Wolfkiel of the US Department of Defense for their insights and support throughout the development of the document.

著者である The MITRE Corporation の Brant A. Cheikes、国立標準技術研究所(NIST)の David Waltermire、Scarfone Cybersecurity の Karen Scarfone は、この文書の草案をレビューし、その技術的内容に貢献してくれた同僚に感謝します。文書の作成を通じて、洞察と支援を寄せてくれた NIST の Harold Booth と Paul Cichonski、Booz Allen Hamilton の Adam Halbardier と David Lee、Cisco Systems, Inc. の Seth Hanford、nCircle の Tim Keanini、McAfee, Inc. の Kent Landfield、The MITRE Corporation の Mary Parmelee、Varen Technologies の Jim Ronayne、G2, Inc. の Shane Shaffer、米国国防総省の Joseph L. Wolfkiel に、著者は謝意を表します。

Abstract

要旨

This report defines the Common Platform Enumeration (CPE) Naming version 2.3 specification. The CPE Naming specification is a part of a stack of CPE specifications that support a variety of use cases relating to IT product description and naming. The CPE Naming specification defines the logical structure of names for IT product classes and the procedures for binding and unbinding these names to and from machine-readable encodings. This report also defines and explains the requirements that IT products must meet for conformance with the CPE Naming version 2.3 specification.

この報告書は、Common Platform Enumeration(CPE)Naming バージョン 2.3 仕様を定義します。CPE Naming 仕様は、IT 製品の記述と命名に関するさまざまなユースケースを支援する、CPE 仕様群の一部です。CPE Naming 仕様は、IT 製品クラスの名前の論理構造と、これらの名前を機械可読なエンコーディングへバインドし、またそこからアンバインドする手順を定義します。この報告書は、IT 製品が CPE Naming バージョン 2.3 仕様に適合するために満たさなければならない要件も定義し、説明します。

Trademark Information

商標情報

CPE is a trademark of The MITRE Corporation.

CPE は The MITRE Corporation の商標です。

All other registered trademarks or trademarks belong to their respective organizations.

その他のすべての登録商標または商標は、それぞれの組織に帰属します。

Table of Contents

目次

List of Figures and Tables

図表一覧

1. Introduction

1. はじめに

Common Platform Enumeration (CPE) is a standardized method of describing and identifying classes of applications, operating systems, and hardware devices present among an enterprise’s computing assets. CPE can be used as a source of information for enforcing and verifying IT management policies relating to these assets, such as vulnerability, configuration, and remediation policies. IT management tools can collect information about installed products, identify products using their CPE names, and use this standardized information to help make fully or partially automated decisions regarding the assets.

Common Platform Enumeration(CPE)は、エンタープライズのコンピューティング資産に存在するアプリケーション、オペレーティングシステム、ハードウェアデバイスの種類を記述し識別するための、標準化された方法です。CPE は、脆弱性、構成、修復に関する方針など、これらの資産に関する IT 管理方針を実施し検証するための情報源として使用できます。IT 管理ツールは、インストールされている製品に関する情報を収集し、CPE 名を使って製品を識別し、この標準化された情報を使って、資産に関する完全または部分的に自動化された判断を行うのに役立てることができます。

CPE consists of several modular specifications. Combinations of the specifications work together in layers to perform various functions. This specification, CPE Naming, defines standardized methods for assigning names to IT product classes. An example is the following name representing Microsoft Internet Explorer 8.0.6001 Beta:

CPE は、いくつかのモジュール型の仕様で構成されています。これらの仕様の組み合わせは、層をなして連携し、さまざまな機能を実行します。この仕様である CPE Naming は、IT 製品クラスに名前を付けるための標準化された方法を定義します。たとえば、次の名前は Microsoft Internet Explorer 8.0.6001 Beta を表します。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.0\.6001",update="beta"]
原文のみ

This method of naming is known as a well-formed CPE name (WFN). It is an abstract logical construction. The CPE Naming specification defines procedures for binding WFNs to machine-readable encodings, as well as unbinding those encodings back to WFNs. One of the bindings, called a Uniform Resource Identifier (URI) binding, is included in CPE version 2.3 for backward compatibility with CPE version 2.2 [CPE22]. The URI binding representation of the WFN above is:

この命名方法は、整形式 CPE 名(WFN)として知られています。これは抽象的な論理構造です。CPE Naming 仕様は、WFN を機械可読なエンコーディングへバインドし、またそのエンコーディングを WFN へアンバインドする手順を定義します。バインディングの 1 つである Uniform Resource Identifier(URI)バインディングは、CPE バージョン 2.2 [CPE22] との後方互換性のために CPE バージョン 2.3 に含まれています。上記の WFN の URI バインディングによる表現は次のとおりです。

cpe:/a:microsoft:internet_explorer:8.0.6001:beta
原文のみ

The second binding defined in CPE 2.3 is called a formatted string binding. It has a somewhat different syntax than the URI binding, and it also supports additional product attributes. With the formatted string binding, the WFN above can be represented by the following.

CPE 2.3 で定義されている 2 つ目のバインディングは、書式化文字列バインディングと呼ばれます。これは URI バインディングとは構文がやや異なり、追加の製品属性もサポートします。書式化文字列バインディングでは、上記の WFN を次のように表現できます。

cpe:2.3:a:microsoft:internet_explorer:8.0.6001:beta:*:*:*:*:*:*
原文のみ

The WFN concept and the bindings defined by the CPE Naming specification are the fundamental building blocks at the core of all CPE functionality.

CPE Naming 仕様が定義する WFN の概念とバインディングは、CPE のあらゆる機能の中核にある基本的な構成要素です。

1.1 Purpose and Scope

1.1 目的と適用範囲

This report defines the specification for CPE Naming version 2.3, including the requirements for WFNs and name bindings. This report also defines and explains the requirements that CPE Naming implementations, such as software and services, must meet to claim conformance with the CPE Naming version 2.3 specification.

この報告書は、WFN と名前バインディングの要件を含め、CPE Naming バージョン 2.3 の仕様を定義します。また、この報告書は、ソフトウェアやサービスなどの CPE Naming の実装が、CPE Naming バージョン 2.3 仕様への適合を主張するために満たさなければならない要件も定義し、説明します。

This report only applies to version 2.3 of CPE Naming. All other versions are out of the scope of this report, as are all CPE specifications other than CPE Naming.

この報告書は、CPE Naming のバージョン 2.3 にのみ適用されます。その他のすべてのバージョンは、CPE Naming 以外のすべての CPE 仕様と同様に、この報告書の適用範囲外です。

1.2 Document Structure

1.2 文書の構成

The remainder of this report is organized into the following major sections:

この報告書の残りの部分は、次の主要な節で構成されています。

•Section 2 defines selected terms and abbreviations used in this specification.

•第 2 節では、この仕様で使用される主な用語と略語を定義します。

•Section 3 provides an overview of related specifications and standards.

•第 3 節では、関連する仕様と標準の概要を示します。

•Section 4 defines the high-level conformance rules for this specification.

•第 4 節では、この仕様の上位レベルの適合性ルールを定義します。

•Section 5 defines the WFN data model.

•第 5 節では、WFN データモデルを定義します。

•Section 6 defines the procedures for binding and unbinding WFNs into and out of the URI and formatted string bindings.

•第 6 節では、WFN を URI バインディングおよび書式化文字列バインディングへバインドし、またそこからアンバインドする手順を定義します。

•Section 7 defines the procedures for converting between bound forms.

•第 7 節では、バインド済みの形式の間で変換する手順を定義します。

•Appendix A lists normative and informative references.

•付録 A では、規範的参考文献と参考情報の参考文献を示します。

•Appendix B provides a change log that documents significant changes to major drafts of the specification.

•付録 B では、この仕様の主要な草案に対する重要な変更を記録した変更履歴を示します。

1.3 Document Conventions

1.3 文書の表記規則

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」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、「OPTIONAL」というキーワードは、[RFC2119] に記載されているとおりに解釈されます。

Text intended to represent computing system input, output, or algorithmic processing is presented in fixed-width Courier font.

コンピューティングシステムの入力、出力、またはアルゴリズム処理を表すことを意図したテキストは、fixed-width Courier font で示します。

Normative references are listed in Appendix A. The following reference citation conventions are used in the text of this document:

規範的参考文献は付録 A に記載されています。この文書の本文では、次の参考文献の引用規則を使用します。

•For normative references, a square bracket notation containing an abbreviation of the overall reference citation, followed by a colon and subsection citation where applicable (e.g. [CPE22:7] is a citation for the CPE 2.2 Naming specification, Section 7);

•規範的参考文献については、参考文献全体の引用の略称を含む角括弧の表記に、コロンと、該当する場合は小節の引用を続けたものを用います(たとえば、[CPE22:7] は、CPE 2.2 Naming 仕様の第 7 節の引用です)。

•For references within this document (internal references) and non-normative references, a parenthetical notation containing the “cf.” (compare) abbreviation followed by a section number for internal references or an external reference, (e.g. (cf. 5.3.1) is a citation for Section 5.3.1 of this document).

•この文書内の参照(内部参照)と非規範的な参照については、「cf.」(compare、参照)の略語に続けて、内部参照の場合は節番号、外部参照の場合は外部参考文献を含む括弧書きの表記を用います(たとえば、(cf. 5.3.1) は、この文書の第 5.3.1 節の引用です)。

This document uses an abstract pseudocode programming language to specify expected computational behavior. Pseudocode is intended to be straightforwardly readable and translatable into actual programming language statements. Note, however, that pseudocode specifications are not necessarily intended to illustrate efficient or optimized programming code; rather, their purpose is to clearly define the desired behavior, leaving it to implementers to choose the best language-specific design which respects that behavior. In some cases, particularly where standardized implementations exist for a given pseudocode function, we describe the function's behavior in prose.

この文書では、期待される計算上の動作を規定するために、抽象的な擬似コードのプログラミング言語を使用します。擬似コードは、わかりやすく読め、実際のプログラミング言語の文に容易に変換できることを意図しています。ただし、擬似コードによる規定は、必ずしも効率的または最適化されたプログラムコードを示すことを意図したものではありません。その目的は、望ましい動作を明確に定義することであり、その動作を守る、言語ごとの最良の設計の選択は実装者に委ねられています。場合によっては、特に所定の擬似コード関数に標準化された実装が存在する場合には、その関数の動作を散文で説明します。

When reading pseudocode the following should be kept in mind:

擬似コードを読む際は、次の点に留意すべきです。

•All pseudocode functions are pass by value, meaning that any changes applied to the supplied arguments within the scope of the function do not affect the values of the variables in the caller’s scope.

•すべての擬似コード関数は値渡しです。これは、関数のスコープ内で、渡された引数に加えた変更が、呼び出し元のスコープにある変数の値に影響しないことを意味します。

•In a few cases, the pseudocode functions reference (more or less) standard library functions, particularly to support string handling. In most cases semantically equivalent functions can be found in the GNU C library, cf. http://www.gnu.org/software/libc/manual/html_node/index.html#toc_String-and-Array-Utilities.

•一部の擬似コード関数は、特に文字列処理を支援するために、(おおむね)標準的なライブラリ関数を参照しています。ほとんどの場合、意味的に同等の関数は GNU C ライブラリにあります(cf. http://www.gnu.org/software/libc/manual/html_node/index.html#toc_String-and-Array-Utilities)。

2. Definitions and Abbreviations

2. 定義と略語

This section defines a set of common terms used within the document. Many terms have been imported from Section 4 of [ISO19770-2]. These are indicated by appending the particular subsection citation to the overall reference citation separated by a colon, e.g., [ISO19770-2:4.1.1]. This section also defines selected abbreviations, including acronyms, used within the document.

この節では、この文書で使用される共通の用語の集合を定義します。多くの用語は [ISO19770-2] の第 4 節から取り込まれています。これらは、参考文献全体の引用に、コロンで区切って個別の小節の引用を付けることで示されています(たとえば、[ISO19770-2:4.1.1])。この節では、この文書で使用される、頭字語を含む選択された略語も定義します。

2.1 Definitions

2.1 定義

Application: A system for collecting, saving, processing, and presenting data by means of a computer [ISO19770-2:4.1.1]. The term application is generally used when referring to a component of software that can be executed. The terms application and software application are often used synonymously.

Application: コンピュータを用いてデータを収集、保存、処理、提示するためのシステム [ISO19770-2:4.1.1]。application という用語は、一般に、実行可能なソフトウェアの構成要素を指す場合に使われます。application と software application という用語は、しばしば同義で使われます。

Bind: To deterministically transform a logical construct into a machine-readable representation suitable for machine interchange and processing. The result of this transformation is called a binding. A binding may also be referred to as the “bound form” of its associated logical construct.

Bind: 論理構造を、機械間の交換と処理に適した機械可読な表現へ、決定論的に変換すること。この変換の結果をバインディングと呼びます。バインディングは、対応する論理構造の「バインド済みの形式」と呼ばれることもあります。

Component: An entity with discrete structure, such as an assembly or software module, within a system considered at a particular level of analysis [ISO19770-2:4.1.3]. Component refers to a part of a whole, such as a component of a software product, a component of a software identification tag, etc.

Component: 特定の分析レベルで考慮されるシステム内の、アセンブリやソフトウェアモジュールなど、個別の構造を持つ実体 [ISO19770-2:4.1.3]。component は、ソフトウェア製品の構成要素、ソフトウェア識別タグの構成要素など、全体の一部を指します。

Computing Device: A functional unit that can perform substantial computations, including numerous arithmetic operations and logic operations without human intervention [ISO19770-2:4.1.4]. A computing device can consist of a standalone unit or several interconnected units. It can also be a device that provides a specific set of functions, such as a phone or a personal organizer, or more general functions such as a laptop or desktop computer.

Computing Device: 人手を介さずに、多数の算術演算や論理演算を含む相当量の計算を実行できる機能単位 [ISO19770-2:4.1.4]。コンピューティングデバイスは、単体のユニットで構成される場合もあれば、相互接続された複数のユニットで構成される場合もあります。また、電話や個人用情報端末のように特定の機能の集合を提供するデバイスである場合もあれば、ラップトップやデスクトップコンピュータのようにより汎用的な機能を提供するデバイスである場合もあります。

Configuration Item: An item or aggregation of hardware or software or both that is designed to be managed as a single entity [ISO19770-2:4.1.5]. Configuration items may vary widely in complexity, size and type, ranging from an entire system including all hardware, software and documentation, to a single module, a minor hardware component or a single software package.

Configuration Item: 単一の実体として管理されるよう設計された、ハードウェアまたはソフトウェア、あるいはその両方の項目または集合体 [ISO19770-2:4.1.5]。構成アイテムは、すべてのハードウェア、ソフトウェア、文書を含むシステム全体から、単一のモジュール、小さなハードウェア部品、単一のソフトウェアパッケージまで、複雑さ、規模、種類が大きく異なる場合があります。

Hardware Device: A discrete physical component of an information technology system or infrastructure. A hardware device may or may not be a computing device (e.g., a network hub, a webcam, a keyboard, a mouse).

Hardware Device: 情報技術システムまたはインフラストラクチャを構成する、個別の物理的な構成要素。ハードウェアデバイスは、コンピューティングデバイスである場合もそうでない場合もあります(たとえば、ネットワークハブ、ウェブカメラ、キーボード、マウス)。

Operating System: A computer program, implemented in either software or firmware, which acts as an intermediary between users of a computer and the computer hardware. The purpose of an operating system is to provide an environment in which a user can execute applications [Silberschatz].

Operating System: ソフトウェアまたはファームウェアで実装され、コンピュータの利用者とコンピュータのハードウェアとの間の仲介役として動作するコンピュータプログラム。オペレーティングシステムの目的は、利用者がアプリケーションを実行できる環境を提供することです [Silberschatz]。

Platform: A computer or hardware device and/or associated operating system, or a virtual environment, on which software can be installed or run [ISO19770-2:4.1.17]. Examples of platforms include Linux™, Microsoft Windows Vista®, and Java™.

Platform: ソフトウェアをインストールまたは実行できる、コンピュータまたはハードウェアデバイスおよび/または関連するオペレーティングシステム、あるいは仮想環境 [ISO19770-2:4.1.17]。プラットフォームの例には、Linux™、Microsoft Windows Vista®、Java™ があります。

Product: A complete set of computer programs, procedures and associated documentation and data designed for delivery to a software consumer [ISO19770-2:4.1.19].

Product: ソフトウェアの消費者への提供を目的として設計された、コンピュータプログラム、手順、関連する文書とデータの完全な集合 [ISO19770-2:4.1.19]。

Release: A collection of new and/or changed configuration items which are tested and introduced into a production environment together [ISO19770-2:4.1.21].

Release: テストされ、一緒に本番環境へ導入される、新規および/または変更された構成アイテムの集まり [ISO19770-2:4.1.21]。

Software: All or part of the programs, procedures, rules, and associated documentation of an information processing system [ISO19770-2:4.1.25].

Software: 情報処理システムのプログラム、手順、規則、関連する文書の全体または一部 [ISO19770-2:4.1.25]。

Unbind: To deterministically transform a binding into its logical-form construct.

Unbind: バインディングを、その論理形式の構造へ決定論的に変換すること。

Uniform Resource Identifier (URI): A compact sequence of characters that identifies an abstract or physical resource available on the Internet. The syntax used for URIs is defined in [RFC3986].

Uniform Resource Identifier (URI): インターネット上で利用可能な抽象的または物理的なリソースを識別する、簡潔な文字列。URI に使われる構文は [RFC3986] で定義されています。

2.2 Abbreviations

2.2 略語

ABNFAugmented Backus-Naur Form
ASCIIAmerican Standard Code for Information Interchange
CPECommon Platform Enumeration
IECInternational Electrotechnical Commission
IRInteragency Report
ISOInternational Organization for Standardization
ITInformation Technology
ITLInformation Technology Laboratory
NISTNational Institute of Standards and Technology
RFCRequest for Comment
URIUniform Resource Identifier
UTF-8Unicode Transformation Format-8
WFNWell-Formed CPE Name
XMLExtensible Markup Language
ABNFAugmented Backus-Naur Form
ASCIIAmerican Standard Code for Information Interchange
CPECommon Platform Enumeration
IECInternational Electrotechnical Commission
IR省庁間報告書
ISOInternational Organization for Standardization
IT情報技術
ITLInformation Technology Laboratory
NISTNational Institute of Standards and Technology
RFCRequest for Comment
URIUniform Resource Identifier
UTF-8Unicode Transformation Format-8
WFN整形式 CPE 名
XMLExtensible Markup Language

3. Relationship to Existing Specifications and Standards

3. 既存の仕様および標準との関係

This section explains the relationships between this specification and related specifications or standards.

この節では、この仕様と、関連する仕様や標準との関係を説明します。

3.1 Other CPE Version 2.3 Specifications

3.1 その他の CPE バージョン 2.3 仕様

CPE version 2.3 was constructed using a modular, stack-based approach, with each major component defined in a separate specification. Functional capabilities are built by layering these modular specifications. This architecture opens opportunities for innovation, as novel capabilities can be defined by combining only the needed specifications, and the impacts of change can be better compartmentalized and managed.

CPE バージョン 2.3 は、モジュール型でスタックに基づくアプローチで構築されており、各主要コンポーネントが個別の仕様で定義されています。機能的な能力は、これらのモジュール型の仕様を階層化することで構築されます。このアーキテクチャは、必要な仕様のみを組み合わせることで新しい能力を定義でき、変更の影響をより適切に区分して管理できるため、イノベーションの機会を広げます。

The CPE Naming version 2.3 specification defines the lowest layer of the stack; all other CPE specifications build upon it.

CPE Naming バージョン 2.3 仕様はスタックの最下層を定義しており、他のすべての CPE 仕様はこれを基礎として構築されます。

3.2 CPE Version 2.2

3.2 CPE バージョン 2.2

The CPE version 2.3 specifications, including this specification, collectively replace [CPE22]. CPE version 2.3 is intended to provide all the capabilities made available by [CPE22] while adding new features suggested by the CPE user community.

この仕様を含む CPE バージョン 2.3 の仕様は、全体として [CPE22] を置き換えます。CPE バージョン 2.3 は、[CPE22] が提供するすべての能力を提供するとともに、CPE ユーザーコミュニティから提案された新機能を追加することを意図しています。

There have been significant changes in naming from CPE version 2.2 to 2.3. [CPE22] defines the CPE name as a multi-component URI obeying a specified grammar. CPE Naming version 2.3 departs significantly from that practice by introducing the WFN construct and defining procedures for binding and unbinding this construct to and from machine-readable representations.

CPE バージョン 2.2 から 2.3 にかけて、命名には大きな変更がありました。[CPE22] は、CPE 名を、規定された文法に従う複数コンポーネントの URI として定義しています。CPE Naming バージョン 2.3 は、WFN という構造を導入し、この構造を機械可読な表現へバインドし、またそこからアンバインドする手順を定義することで、その慣行から大きく離れています。

The principal motivation for this change was to create opportunities for future growth and innovation in the ways in which machines exchange product descriptions. During CPE version 2.3’s development, a clear need was recognized to define at least two different machine-readable representations for product descriptions, one for backward compatibility with prior releases of the CPE specifications, and a second to provide critical new features demanded by the user community. As work advanced, community members proposed additional transport representations for consideration. As the inventory of potential representations increased, it became clear that there could be serious challenges involved in defining numerous conversions among transports and procedures for pair-wise comparison. Consequently, an abstract canonical form—a kind of interlingua—was chosen to serve as the standardized form for processing CPE information. Using this interlingua it is possible to define conversions simply in terms of transforms into and out of the canonical form, and to define matching and other higher-level processes in generic rather than representation-specific terms. The WFN form lays the foundation for new binding forms to be introduced in the future without affecting other specifications defined in terms of the canonical form.

この変更の主な動機は、機械が製品の記述を交換する方法における、将来の成長とイノベーションの機会を作ることでした。CPE バージョン 2.3 の開発中に、製品記述のための機械可読な表現を少なくとも 2 つ定義する明確な必要性が認識されました。1 つは CPE 仕様の以前のリリースとの後方互換性のため、もう 1 つはユーザーコミュニティが求める重要な新機能を提供するためです。作業が進むにつれて、コミュニティのメンバーは検討対象として追加の転送用表現を提案しました。可能性のある表現の数が増えるにつれて、転送形式間の多数の変換や、2 つずつの比較の手順を定義することには、深刻な課題が伴う可能性があることが明らかになりました。そこで、CPE 情報を処理するための標準化された形式として、抽象的な正準形式、いわば一種の中間言語が選ばれました。この中間言語を使うと、変換を、正準形式への変換と正準形式からの変換という観点だけで定義でき、照合などの上位の処理も、表現ごとの用語ではなく汎用的な用語で定義できます。WFN 形式は、正準形式を基準に定義された他の仕様に影響を与えることなく、将来、新しいバインディング形式を導入するための基盤となります。

3.3 ISO/IEC 19770-2

3.3 ISO/IEC 19770-2

The International Organization for Standardization (ISO) and the International Electrotechnical Commission (IEC) have published ISO/IEC-19770 Part 2, “Software Identification Tag”. As explained in the introduction to the standard, “The software identification tag is an XML file containing authoritative identification and management information about a software product. The software identification tag is installed and managed on a computing device together with the software product.” [ISO19770-2], p. vi.

International Organization for Standardization(ISO)と International Electrotechnical Commission(IEC)は、ISO/IEC-19770 Part 2「Software Identification Tag」を発行しています。この標準の序文で説明されているとおり、「ソフトウェア識別タグは、ソフトウェア製品に関する信頼できる識別情報と管理情報を含む XML ファイルです。ソフトウェア識別タグは、ソフトウェア製品とともにコンピューティングデバイスにインストールされ、管理されます。」[ISO19770-2]、p. vi。

Both CPE and ISO/IEC-19770-2 address the need to standardize the way products are identified. There are many areas in which the two efforts overlap or complement each other, but CPE differs in a number of respects:

CPE と ISO/IEC-19770-2 はどちらも、製品を識別する方法を標準化する必要性に対応しています。両者の取り組みが重なる、または補完し合う領域は数多くありますが、CPE にはいくつかの点で違いがあります。

•CPE’s scope is broader; it includes hardware devices, and it distinguishes operating systems from general software applications.

•CPE は適用範囲が広く、ハードウェアデバイスを含み、オペレーティングシステムを一般的なソフトウェアアプリケーションと区別します。

•CPE emphasizes the development and use of “common identifiers” that enable a wide variety of information about the same product or class of products to be correlated.

•CPE は、同じ製品または製品クラスに関する多様な情報を相互に関連づけられるようにする「共通識別子」の開発と利用を重視しています。

•CPE provides support for the creation of product descriptions (names for sets of products) as well as product identifiers (names for individual products).

•CPE は、製品識別子(個々の製品の名前)だけでなく、製品記述(製品の集合の名前)を作成するための支援も提供します。

4. Conformance

4. 適合性

Products may want to claim conformance with this specification for a variety of reasons. This section provides the high-level requirements that must be met by any implementation seeking to claim conformance with this specification. These requirements are intended to guarantee that a conformant implementation not only can produce and/or consume the newly-introduced formatted string binding form as needed to interoperate with other implementations, but also can process legacy product identifiers as well.

製品は、さまざまな理由から、この仕様への適合を主張したい場合があります。この節では、この仕様への適合を主張しようとするあらゆる実装が満たさなければならない、上位レベルの要件を示します。これらの要件は、適合する実装が、他の実装と相互運用するために必要に応じて、新たに導入された書式化文字列バインディング形式を生成および/または利用できるだけでなく、従来の製品識別子も処理できることを保証することを意図しています。

The following apply to all implementations claiming conformance with this specification:

この仕様への適合を主張するすべての実装には、次が適用されます。

1.An implementation MUST make an explicit claim of conformance to this specification in any documentation provided to end users.

1.実装は、エンドユーザーに提供するあらゆる文書で、この仕様への適合を明示的に主張しなければなりません(MUST)。

2.If the implementation produces (i.e., generates as an output) CPE names, it MUST produce syntactically correct formatted string bindings as needed to describe or identify applications, operating systems, and hardware devices (cf. 6.2).

2.実装が CPE 名を生成する(すなわち、出力として作り出す)場合、アプリケーション、オペレーティングシステム、ハードウェアデバイスを記述または識別するために必要な、構文的に正しい書式化文字列バインディングを生成しなければなりません(MUST)(cf. 6.2)。

3.If the implementation produces CPE names in URI form, it MUST produce URIs that adhere to the syntax rules specified in Figure 6-1, and it SHOULD produce URIs that adhere to the more constrained rules specified in Figure 6-2.

3.実装が URI 形式の CPE 名を生成する場合、図 6-1 に規定された構文規則に従う URI を生成しなければならず(MUST)、図 6-2 に規定された、より制約の強い規則に従う URI を生成すべきです(SHOULD)。

4.If the implementation consumes (i.e., accepts as valid input) CPE names, (a) it MUST consume syntactically correct formatted string bindings as needed to describe or identify applications, operating systems, and hardware devices (cf. 6.2); (b) it SHOULD be able to consume any CPE name that meets the syntax requirements specified in Figure 6-1 or Figure 6-2; and (c) it SHOULD be able to convert input CPE names in URI form to syntactically correct formatted string bindings (cf. 7.1).

4.実装が CPE 名を利用する(すなわち、有効な入力として受け付ける)場合、(a) アプリケーション、オペレーティングシステム、ハードウェアデバイスを記述または識別するために必要な、構文的に正しい書式化文字列バインディングを利用しなければならず(MUST)(cf. 6.2)、(b) 図 6-1 または図 6-2 に規定された構文要件を満たすあらゆる CPE 名を利用できるべきであり(SHOULD)、(c) URI 形式の入力 CPE 名を、構文的に正しい書式化文字列バインディングへ変換できるべきです(SHOULD)(cf. 7.1)。

5.It is OPTIONAL for implementations to be able to convert any syntactically correct formatted string binding to a valid CPE name that meets the requirements specified in [CPE22] (cf. 7.2). An implementation that offers this functionality SHOULD implement the procedure defined in Section 7.2. This functionality may enable an implementation to interoperate to a limited extent with implementations conforming to [CPE22] and possibly prior releases as well.

5.構文的に正しい任意の書式化文字列バインディングを、[CPE22] に規定された要件を満たす有効な CPE 名へ変換できることは、実装にとって任意(OPTIONAL)です(cf. 7.2)。この機能を提供する実装は、第 7.2 節で定義された手順を実装すべきです(SHOULD)。この機能により、実装が [CPE22] に適合する実装、場合によってはそれ以前のリリースに適合する実装とも、限定的に相互運用できるようになる場合があります。

5. Well-Formed CPE Name Data Model

5. 整形式 CPE 名データモデル

This section defines the foundational logical construct of CPE—the well-formed CPE name (WFN). WFNs can be used to describe a set of products or to identify an individual product. Describing an entity involves enumerating a set of attributes and their values to distinguish that entity from other entities in a domain. For example, Joe might describe his car as a “2004 Subaru Outback with a black leather interior”. Conceptually, this description could be modeled as a set of attribute=value pairs: [year=2004, maker=subaru, model=outback, interior_color=black, interior_material=leather]

この節では、CPE の基礎となる論理構造である整形式 CPE 名(WFN)を定義します。WFN は、製品の集合を記述するためにも、個々の製品を識別するためにも使用できます。実体を記述するには、その実体を領域内の他の実体と区別するための、属性とその値の集合を列挙します。たとえば、Joe は自分の車を「黒い革の内装の 2004 年式 Subaru Outback」と記述するかもしれません。概念的には、この記述は属性=値のペアの集合としてモデル化できます。[year=2004, maker=subaru, model=outback, interior_color=black, interior_material=leather]

A description is said to be ambiguous for a domain when it cannot be used to distinguish a unique entity possessing all specified attributes and values. The above description is ambiguous for a broad domain, such as all automobiles registered in the state of Massachusetts, but might not be ambiguous for a narrower domain, such as all automobiles registered in a particular nine-digit United States postal code region. To identify an entity is to describe it uniquely regardless of the domain it is in.

記述が、指定されたすべての属性と値を持つ唯一の実体を区別するために使えない場合、その記述はある領域に対して曖昧であるといいます。上記の記述は、マサチューセッツ州に登録されたすべての自動車のような広い領域に対しては曖昧ですが、特定の 9 桁の米国郵便番号の地域に登録されたすべての自動車のような、より狭い領域に対しては曖昧ではない場合があります。実体を識別するとは、それがどの領域にあるかにかかわらず、その実体を一意に記述することです。

WFNs are used to describe and identify product classes. An example of a product class is a Lenovo ThinkPad X61; this class could be used to identify a hardware device’s class. More general product classes, such as Lenovo Thinkpads or Lenovo laptops, could be used as class descriptions, not class identifiers. The CPE Naming specification leaves all decisions about what distinguishes identifiers and descriptions to the users. All names constitute descriptions of product classes, and a description becomes an identifier when it contains sufficient information to select a single entity from the universe of possibilities.

WFN は、製品クラスを記述し識別するために使用されます。製品クラスの例は Lenovo ThinkPad X61 であり、このクラスはハードウェアデバイスのクラスを識別するために使用できます。Lenovo Thinkpad や Lenovo ラップトップのような、より一般的な製品クラスは、クラスの識別子ではなく、クラスの記述として使用できます。CPE Naming 仕様は、識別子と記述を何によって区別するかに関するあらゆる判断を、ユーザーに委ねています。すべての名前は製品クラスの記述を構成し、記述は、あらゆる可能性の全体から単一の実体を選択するのに十分な情報を含んだときに、識別子になります。

WFNs are used solely for product classes. They cannot identify product instances, which are unique, physically discernible entities in the world, such as a specific licensed and configured installation of a product on a particular computing device owned by XYZ Corp. and physically installed in a particular location in the world. Other aspects of product naming and description that are outside the scope of the CPE Naming specification are:

WFN は、製品クラスにのみ使用されます。製品インスタンスを識別することはできません。製品インスタンスとは、世界に存在する、一意で物理的に判別可能な実体のことで、たとえば、XYZ Corp. が所有し、世界の特定の場所に物理的に設置された特定のコンピューティングデバイスにある、特定のライセンスと構成を持つ製品のインストールが該当します。製品の命名と記述に関する、CPE Naming 仕様の適用範囲外のその他の側面は次のとおりです。

•Representing relationships (e.g., part of, bundled with, released before/after, same as) between products

•製品間の関係(たとえば、一部である、バンドルされている、前後にリリースされた、同一である)の表現

•Representing user-defined configurations of installed products

•インストールされた製品に対するユーザー定義の構成の表現

•Representing entitlement/licensing information about products

•製品に関する権利・ライセンス情報の表現

•Defining procedures and guidelines for assigning “correct” or “valid” values to attributes of product descriptions or identifiers

•製品の記述または識別子の属性に「正しい」または「有効な」値を割り当てるための手順とガイドラインの定義

•Defining procedures and guidelines for creating or maintaining valid-values lists.

•有効な値のリストを作成または維持するための手順とガイドラインの定義。

5.1 Definitions and Notation

5.1 定義と表記

A WFN is an unordered set of attribute-value pairs that collectively (a) describe or identify a software application, operating system, or hardware device, and (b) satisfy the criteria specified in Section 5.2. Unordered means that there is no prescribed order for the attribute-value pairs, and there is no specified relationship (hierarchical, set-theoretic, or otherwise) among attributes or attribute-value pairs.

WFN は、属性値ペアの順序のない集合であり、全体として (a) ソフトウェアアプリケーション、オペレーティングシステム、またはハードウェアデバイスを記述または識別し、かつ (b) 第 5.2 節に規定された基準を満たします。順序がないとは、属性値ペアに規定された順序がなく、属性や属性値ペアの間に、階層的、集合論的、その他を問わず、規定された関係がないことを意味します。

The WFN is a logical construct only. The WFN is not intended to be a data format, encoding, or any other kind of machine-readable representation for machine interchange and processing. Rather, it is a conceptual data structure—an abstract canonical form—used to clearly and unambiguously specify desired implementations and behaviors. There is no requirement that CPE-conformant tools create or manipulate WFN-like data structures internally to their implementations. Section 6 describes procedures for binding WFNs to machine-readable representations for interchange and processing.

WFN は論理構造にすぎません。WFN は、機械間の交換と処理のためのデータ形式、エンコーディング、その他あらゆる種類の機械可読な表現を意図したものではありません。むしろ、望ましい実装と動作を明確かつ曖昧さなく規定するために用いられる、概念的なデータ構造、すなわち抽象的な正準形式です。CPE に適合するツールが、その実装の内部で WFN のようなデータ構造を作成または操作する必要はありません。第 6 節では、交換と処理のために WFN を機械可読な表現へバインドする手順を説明します。

An attribute-value pair is a tuple a=v in which a (the attribute) is an alphanumeric label (used to represent a property or state of some entity), and v (the value) is the value assigned to the attribute. Lexical case SHALL NOT distinguish attributes from one another, e.g., the attributes Foo, foo, FOO, etc., SHALL be considered equivalent. By convention, attributes will be written in all lowercase letters, with the underscore (“_”) character used to separate distinct words within an attribute.

属性値ペアは、a=v という組で、a(属性)は(ある実体の性質または状態を表すために用いられる)英数字のラベル、v(値)はその属性に割り当てられた値です。属性同士を字句上の大文字小文字で区別してはなりません(SHALL NOT)。たとえば、属性 Foo、foo、FOO などは等価であるとみなされなければなりません(SHALL)。慣例として、属性はすべて小文字で書き、属性内で別々の語を区切るにはアンダースコア(「_」)を使用します。

The following are examples of attribute-value pairs:

属性値ペアの例を次に示します。

•color=“red”

•color=“red”

•vehicle_length=“6”

•vehicle_length=“6”

•unit=“meter”

•unit=“meter”

•nickname=“Zippy”

•nickname=“Zippy”

This document uses the following notation to illustrate WFNs:

この文書では、WFN を示すために次の表記を使用します。

wfn:[a1=v1, a2=v2, …, an=vn]
原文のみ

That is, WFNs will be notated as lists of attribute-value pairs enclosed in square brackets, prefixed with the string “wfn:”. This notation is used solely for the purposes of explaining and illustrating the concepts and procedures specified herein. There is no requirement that implementations represent WFNs explicitly or use this notation in any way.

すなわち、WFN は、角括弧で囲まれ、文字列「wfn:」が前に付いた属性値ペアのリストとして表記されます。この表記は、ここで規定する概念と手順を説明し示す目的でのみ使用されます。実装が WFN を明示的に表現したり、この表記を何らかの形で使用したりする必要はありません。

5.2 WFN Attributes

5.2 WFN の属性

WFNs MUST satisfy these criteria:

WFN は、次の基準を満たさなければなりません(MUST)。

1.Only the following attributes SHALL be permitted in a WFN attribute-value pair:

1.WFN の属性として許可されるのは、次の属性のみです(SHALL)。

a.part

b.vendor

b.vendor

c.product

c.product

d.version

d.version

e.update

e.update

f.edition

f.edition

g.language

g.language

h.sw_edition

h.sw_edition

i.target_sw

i.target_sw

j.target_hw

j.target_hw

k.other

k.other

2.Each permitted attribute MAY be used at most once in a WFN. If an attribute is not used in a WFN, it is said to be unspecified, and its value SHALL default to the logical value ANY (cf. 5.3.1).

2.許可された各属性は、WFN 内で 1 回まで使用してもよいです(MAY)。属性が WFN で使用されない場合、その属性は未指定と呼ばれ、その値は論理値 ANY でなければなりません(SHALL)(cf. 5.3.1)。

3.Attribute values of WFNs MUST satisfy the requirements specified in Section 5.3.

3.WFN の属性値は、第 5.3 節に規定された要件を満たさなければなりません(MUST)。

The attributes sw_edition, target_sw, target_hw, and other are newly introduced in this specification and are referred to collectively as the extended attributes.

属性 sw_edition、target_sw、target_hw、other は、この仕様で新たに導入されたものであり、まとめて拡張属性と呼びます。

5.3 WFN Attribute Values

5.3 WFN の属性値

Attributes of WFNs SHALL be assigned one of the following values:

WFN の属性には、次のいずれかの値が割り当てられなければなりません(SHALL)。

1.A logical value specified in Section 5.3.1

1.第 5.3.1 節に規定された論理値

2.A character string satisfying both (a) the requirements on string values specified in Section 5.3.2, and (b) the per-attribute value restrictions specified in Section 5.5.3.

2.(a) 第 5.3.2 節に規定された文字列値に関する要件と、(b) 第 5.5.3 節に規定された属性ごとの値の制限の両方を満たす文字列。

5.3.1 Logical values
5.3.1 論理値

An attribute of a WFN MAY be assigned one of these logical values:

WFN の属性には、次の論理値のいずれかを割り当ててもよいです(MAY)。

1.ANY (i.e., “any value”). The logical value ANY SHOULD be assigned to an attribute when there are no restrictions on acceptable values for that attribute.

1.ANY(すなわち「任意の値」)。ある属性について、許容される値に制限がない場合は、論理値 ANY をその属性に割り当てるべきです(SHOULD)。

2.NA (i.e., “not applicable/not used”). The logical value NA SHOULD be assigned when there is no legal or meaningful value for that attribute, or when that attribute is not used as part of the description. This includes the situation in which an attribute has an obtainable value that is null.

2.NA(すなわち「該当なし/未使用」)。その属性に、正当な値や意味のある値がない場合、またはその属性が記述の一部として使用されない場合は、論理値 NA を割り当てるべきです(SHOULD)。これには、属性に取得可能な値があるものの、それが null である場合も含まれます。

In WFNs, these logical values will be written in all uppercase characters, without surrounding quotation marks, on the right side of the equal sign, as in these examples:

WFN では、これらの論理値は、次の例のように、等号の右側に、引用符で囲まずにすべて大文字で書きます。

•wfn:[…,update=ANY,…]

•wfn:[…,update=ANY,…]

•wfn:[…,update=NA,…]

•wfn:[…,update=NA,…]

5.3.2 Restrictions on attribute-value strings
5.3.2 属性値文字列に対する制限

Value strings assigned to attributes of WFNs SHALL be non-empty contiguous strings of bytes encoded using printable Unicode Transformation Format-8 (UTF-8) characters with hexadecimal values between x00 and x7F [RFC3629].

WFN の属性に割り当てられる値文字列は、x00 から x7F までの 16 進値を持つ印字可能な Unicode Transformation Format-8(UTF-8)文字を用いてエンコードされた、空でない連続したバイト列でなければなりません(SHALL)[RFC3629]。

In WFNs, attribute-value strings will be enclosed in double quotes as in the examples below. The quotation marks are, of course, not considered part of the string values themselves.

WFN では、属性値文字列は、以下の例のように二重引用符で囲まれます。引用符自体は、もちろん、文字列値の一部とはみなされません。

•wfn:[…,update="sr1",…]

•wfn:[…,update="sr1",…]

•wfn:[…,target_hw="x64",update="sp2"]

•wfn:[…,target_hw="x64",update="sp2"]

Value strings in WFNs SHALL satisfy all of the following requirements:

WFN の値文字列は、次のすべての要件を満たさなければなりません(SHALL)。

1.Uppercase letters, lowercase letters or digit characters MAY be used (ASCII x41-x5a, x30-x39 and x61-x7a).

1.大文字、小文字、または数字を使用してもよいです(MAY)(ASCII x41-x5a、x30-x39、および x61-x7a)。

2.The underscore (x5f) MAY be used, and it SHOULD be used in place of whitespace characters (which SHALL NOT be used).

2.アンダースコア(x5f)を使用してもよく(MAY)、空白文字の代わりに使用すべきです(SHOULD)(空白文字は使用してはなりません(SHALL NOT))。

3.The backslash (x5c) MAY be used, and is designated the escape character. It SHOULD be used in a value string when required to modify the interpretation of the character that immediately follows (see below). In these circumstances, the character following the backslash is said to be quoted.

3.バックスラッシュ(x5c)を使用してもよく(MAY)、これはエスケープ文字として指定されています。直後の文字の解釈を変更する必要がある場合は、値文字列内でバックスラッシュを使用すべきです(SHOULD)(以下を参照)。この場合、バックスラッシュに続く文字は、クォートされているといいます。

4.The asterisk (x2a) and the question mark (x3f) MAY be used, and are designated special characters. These two characters MAY be assigned special interpretations by other CPE specifications. To block special interpretation of these characters, precede them with the escape character, otherwise leave them unquoted in the value string. A special character MAY be included at the beginning of an otherwise non-empty value string, and/or at the end of the string. A special character MUST NOT be embedded within a value string. A single asterisk MUST NOT be used by itself as an attribute value. The asterisk MUST NOT be used more than once in sequence. A single question mark MAY be used by itself as an attribute value. The question mark MAY be used more than once in sequence.

4.アスタリスク(x2a)とクエスチョンマーク(x3f)を使用してもよく(MAY)、これらは特殊文字として指定されています。この 2 つの文字には、他の CPE 仕様によって特別な解釈が割り当てられる場合があります(MAY)。これらの文字の特別な解釈を妨げるには、前にエスケープ文字を置きます。そうでなければ、値文字列内でクォートせずにそのままにします。特殊文字は、それ以外は空でない値文字列の先頭、および/または末尾に含めてもよいです(MAY)。特殊文字を値文字列の途中に埋め込んではなりません(MUST NOT)。アスタリスク 1 つだけを属性値として単独で使用してはなりません(MUST NOT)。アスタリスクを連続して複数回使用してはなりません(MUST NOT)。クエスチョンマーク 1 つだけを属性値として単独で使用してもよいです(MAY)。クエスチョンマークを連続して複数回使用してもよいです(MAY)。

5.All other printable non-alphanumeric characters (i.e., all punctuation marks, brackets, delimiters and other special purpose symbols, except for the special characters defined above) MUST be quoted when embedded in value strings.

5.その他の印字可能な英数字以外の文字(すなわち、上で定義した特殊文字を除く、すべての句読点、括弧、区切り文字、その他の特殊用途の記号)は、値文字列に埋め込む場合はクォートされなければなりません(MUST)。

6.A quoted hyphen MUST NOT be used by itself as a value string.

6.クォートされたハイフンを、値文字列として単独で使用してはなりません(MUST NOT)。

These requirements are summarized by the Augmented Backus-Naur Form (ABNF) grammar [RFC2234] for avstring shown in Figure 5-1.

これらの要件は、図 5-1 に示す avstring の Augmented Backus-Naur Form(ABNF)文法 [RFC2234] に要約されています。

avstring      = ( body / ( spec_chrs *body2 )) *1spec_chrs
spec_chrs     = 1*spec1 / spec2
spec1         = "?"
spec2         = "*"
body          = ( body1 *body2 ) / 2*body2
body1         = unreserved / quoted1
body2         = unreserved / quoted2
unreserved    = ALPHA / DIGIT / "_"
quoted1       = escape (escape / special / punc-no-dash)
quoted2       = escape (escape / special / punc-w-dash)
escape        = "\"
special       = spec1 / spec2
dash          = "-"
punc-no-dash  = "!" / DQUOTE / "#"/ "$"/ "%" / "&" / "'" /
                "(" / ")" / "+" / "," / "." / "/" /
                ":" / ";" / "<" / "=" / ">" / "@" / "[" /
                "]" / "^" / "`" / "{" / "|" / "}" / "~"
punc-w-dash   = punc-no-dash / dash
DQUOTE        = %x22 ; double quote
ALPHA         = %x41-5a / %x61-7A   ; A-Z or a-z
DIGIT         = %x30-39    ; 0-9
原文のみ

Figure 5-1. ABNF Grammar for Attribute-Value Strings

図 5-1. 属性値文字列の ABNF 文法

The following are examples of allowable value strings in WFNs:

WFN で許容される値文字列の例を次に示します。

•"foo\-bar" (hyphen is quoted)

•"foo\-bar"(ハイフンはクォートされている)

•"Acrobat_Reader"

•"Acrobat_Reader"

•"\"oh_my\!\"" (quotation marks and exclamation point are quoted)

•"\"oh_my\!\""(引用符と感嘆符はクォートされている)

•"g\+\+" (plus signs are quoted)

•"g\+\+"(プラス記号はクォートされている)

•"9\.?" (period is quoted, question mark is unquoted)

•"9\.?"(ピリオドはクォートされ、クエスチョンマークはクォートされていない)

•"sr*" (asterisk is unquoted)

•"sr*"(アスタリスクはクォートされていない)

•"big\$money" (dollar sign is quoted)

•"big\$money"(ドル記号はクォートされている)

•"foo\:bar" (colon is quoted)

•"foo\:bar"(コロンはクォートされている)

•"back\\slash_software" (backslash is quoted)

•"back\\slash_software"(バックスラッシュはクォートされている)

•"with_quoted\~tilde" (tilde is quoted)

•"with_quoted\~tilde"(チルダはクォートされている)

•"*SOFT*" (single unquoted asterisk at beginning and end)

•"*SOFT*"(先頭と末尾にクォートされていないアスタリスクが 1 つずつ)

•"8\.??" (two unquoted question marks at end)

•"8\.??"(末尾にクォートされていないクエスチョンマークが 2 つ)

•"*8\.??" (one unquoted asterisk at beginning, two unquoted question marks at end)

•"*8\.??"(先頭にクォートされていないアスタリスクが 1 つ、末尾にクォートされていないクエスチョンマークが 2 つ)

5.3.3 Per-attribute value restrictions
5.3.3 属性ごとの値の制限

This section specifies value restrictions on each WFN attribute and provides recommendations for how suitable value strings should be chosen.

この節では、各 WFN 属性に対する値の制限を規定し、適切な値文字列をどのように選ぶべきかについての推奨事項を示します。

5.3.3.1 Part
5.3.3.1 Part

The part attribute SHALL have one of these three string values:

part 属性には、次の 3 つの文字列値のいずれかを設定しなければなりません(SHALL)。

•The value “a”, when the WFN is for a class of applications.

•WFN がアプリケーションのクラスを表す場合は、値「a」。

•The value “o”, when the WFN is for a class of operating systems.

•WFN がオペレーティングシステムのクラスを表す場合は、値「o」。

•The value “h”, when the WFN is for a class of hardware devices.

•WFN がハードウェアデバイスのクラスを表す場合は、値「h」。

5.3.3.2 Vendor
5.3.3.2 Vendor

Values for this attribute SHOULD describe or identify the person or organization that manufactured or created the product. Values for this attribute SHOULD be selected from an attribute-specific valid-values list, which MAY be defined by other specifications that utilize this specification. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性の値は、製品を製造または作成した個人または組織を記述または識別すべきです(SHOULD)。この属性の値は、属性固有の有効値リストから選択すべきです(SHOULD)。このリストは、この仕様を利用する他の仕様によって定義される場合があります(MAY)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.3.3.3 Product
5.3.3.3 Product

Values for this attribute SHOULD describe or identify the most common and recognizable title or name of the product. Values for this attribute SHOULD be selected from an attribute-specific valid-values list, which MAY be defined by other specifications that utilize this specification. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性の値は、製品の最も一般的で認識しやすいタイトルまたは名称を記述または識別すべきです(SHOULD)。この属性の値は、属性固有の有効値リストから選択すべきです(SHOULD)。このリストは、この仕様を利用する他の仕様によって定義される場合があります(MAY)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.3.3.4 Version
5.3.3.4 Version

Values for this attribute SHOULD be vendor-specific alphanumeric strings characterizing the particular release version of the product. Version information SHOULD be copied directly (with escaping of printable non-alphanumeric characters as required) from discoverable data and SHOULD NOT be truncated or otherwise modified. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性の値は、製品の特定のリリースバージョンを特徴づける、ベンダー固有の英数字文字列であるべきです(SHOULD)。バージョン情報は、検出可能なデータから(必要に応じて、印字可能な英数字以外の文字をエスケープしたうえで)そのままコピーすべきであり(SHOULD)、切り詰めたり、その他の方法で変更したりすべきではありません(SHOULD NOT)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.3.3.5 Update
5.3.3.5 Update

Values for this attribute SHOULD be vendor-specific alphanumeric strings characterizing the particular update, service pack, or point release of the product. Values for this attribute SHOULD be selected from an attribute-specific valid-values list, which MAY be defined by other specifications that utilize this specification. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性の値は、製品の特定のアップデート、サービスパック、またはポイントリリースを特徴づける、ベンダー固有の英数字文字列であるべきです(SHOULD)。この属性の値は、属性固有の有効値リストから選択すべきです(SHOULD)。このリストは、この仕様を利用する他の仕様によって定義される場合があります(MAY)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.3.3.6 Edition
5.3.3.6 Edition

The edition attribute is considered deprecated in this specification, and it SHOULD be assigned the logical value ANY except where required for backward compatibility with version 2.2 of the CPE specification. This attribute is referred to as the “legacy edition” attribute.

edition 属性は、この仕様では非推奨とみなされており、CPE 仕様のバージョン 2.2 との後方互換性のために必要な場合を除き、論理値 ANY を割り当てるべきです(SHOULD)。この属性は「レガシー edition」属性と呼ばれます。

If this attribute is used, values for this attribute SHOULD capture edition-related terms applied by the vendor to the product. Values for this attribute SHOULD be selected from an attribute-specific valid-values list, which MAY be defined by other specifications that utilize this specification. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性を使用する場合、その値は、ベンダーが製品に付けたエディションに関する用語を捉えるべきです(SHOULD)。この属性の値は、属性固有の有効値リストから選択すべきです(SHOULD)。このリストは、この仕様を利用する他の仕様によって定義される場合があります(MAY)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.3.3.7 SW_Edition
5.3.3.7 SW_Edition

Values for this attribute SHOULD characterize how the product is tailored to a particular market or class of end users. Values for this attribute SHOULD be selected from an attribute-specific valid-values list, which MAY be defined by other specifications that utilize this specification. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性の値は、製品が特定の市場またはエンドユーザーのクラスに合わせてどのように調整されているかを特徴づけるべきです(SHOULD)。この属性の値は、属性固有の有効値リストから選択すべきです(SHOULD)。このリストは、この仕様を利用する他の仕様によって定義される場合があります(MAY)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.3.3.8 Target_SW
5.3.3.8 Target_SW

Values for this attribute SHOULD characterize the software computing environment within which the product operates. Values for this attribute SHOULD be selected from an attribute-specific valid-values list, which MAY be defined by other specifications that utilize this specification. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性の値は、製品が動作するソフトウェアのコンピューティング環境を特徴づけるべきです(SHOULD)。この属性の値は、属性固有の有効値リストから選択すべきです(SHOULD)。このリストは、この仕様を利用する他の仕様によって定義される場合があります(MAY)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.3.3.9 Target_HW
5.3.3.9 Target_HW

Values for this attribute SHOULD characterize the instruction set architecture (e.g., x86) on which the product being described or identified by the WFN operates. Bytecode-intermediate languages, such as Java bytecode for the Java Virtual Machine or Microsoft Common Intermediate Language for the Common Language Runtime virtual machine, SHALL be considered instruction set architectures. Values for this attribute SHOULD be selected from an attribute-specific valid-values list, which MAY be defined by other specifications that utilize this specification. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性の値は、WFN で記述または識別される製品が動作する命令セットアーキテクチャ(たとえば x86)を特徴づけるべきです(SHOULD)。Java 仮想マシンの Java バイトコードや、Common Language Runtime 仮想マシンの Microsoft Common Intermediate Language のようなバイトコード中間言語は、命令セットアーキテクチャとみなされなければなりません(SHALL)。この属性の値は、属性固有の有効値リストから選択すべきです(SHOULD)。このリストは、この仕様を利用する他の仕様によって定義されてもよいです(MAY)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.3.3.10 Language
5.3.3.10 言語

Values for this attribute SHALL be valid language tags as defined by [RFC5646], and SHOULD be used to define the language supported in the user interface of the product being described. Although any valid language tag MAY be used, only tags containing language and region codes SHOULD be used.

この属性の値は、[RFC5646] で定義された有効な言語タグでなければならず(SHALL)、記述される製品のユーザーインタフェースでサポートされる言語を定義するために使用すべきです(SHOULD)。有効な言語タグであればどれを使用してもよいですが(MAY)、言語コードと地域コードを含むタグのみを使用すべきです(SHOULD)。

5.3.3.11 Other
5.3.3.11 その他

Values for this attribute SHOULD capture any other general descriptive or identifying information which is vendor- or product-specific and which does not logically fit in any other attribute value. Values SHOULD NOT be used for storing instance-specific data (e.g., globally-unique identifiers or Internet Protocol addresses). Values for this attribute SHOULD be selected from a valid-values list that is refined over time; this list MAY be defined by other specifications that utilize this specification. Any character string meeting the requirements for WFNs (cf. 5.3.2) MAY be specified as the value of the attribute.

この属性の値は、ベンダー固有または製品固有で、他のどの属性値にも論理的に当てはまらない、その他の一般的な記述情報または識別情報を捉えるべきです(SHOULD)。値は、インスタンス固有のデータ(たとえば、グローバル一意識別子やインターネットプロトコルアドレス)の格納に使用すべきではありません(SHOULD NOT)。この属性の値は、時間をかけて洗練される有効値リストから選択すべきです(SHOULD)。このリストは、この仕様を利用する他の仕様によって定義される場合があります(MAY)。WFN の要件(cf. 5.3.2)を満たす任意の文字列を、この属性の値として指定してもよいです(MAY)。

5.4 Operations on WFNs

5.4 WFN に対する操作

Three functions are defined over WFNs: new, get, and set. These functions are used in defining binding and unbinding procedures in Section 6.

WFN に対しては、new、get、set の 3 つの関数が定義されています。これらの関数は、第 6 節のバインドおよびアンバインドの手順の定義に使用されます。

5.4.1 Function new()
5.4.1 関数 new()

The new() function takes no arguments. It returns an empty WFN (a WFN containing no attribute-value pairs).

new() 関数は引数を取りません。空の WFN(属性値ペアを含まない WFN)を返します。

Example:

例:

new() → wfn:[]
原文のみ
5.4.2 Function get(w,a)
5.4.2 関数 get(w,a)

The get(w,a) function takes two arguments, a WFN w and an attribute a, and returns the value of a. If the attribute a is unspecified in w, get(w,a) returns the default value ANY.

get(w,a) 関数は、WFN w と属性 a の 2 つの引数を取り、a の値を返します。属性 a が w で未指定の場合、get(w,a) は既定値 ANY を返します。

Examples:

例:

•get(wfn:[vendor="microsoft",product="internet_explorer"],vendor) → "microsoft"

•get(wfn:[vendor="microsoft",product="internet_explorer"],vendor) → "microsoft"

•get(wfn:[vendor="microsoft",product="internet_explorer"],version) → ANY

•get(wfn:[vendor="microsoft",product="internet_explorer"],version) → ANY

5.4.3 Function set(w,a,v)
5.4.3 関数 set(w,a,v)

The set(w,a,v) function takes three arguments, a WFN w, an attribute a, and a value v. If the attribute a is unspecified in w, set(w,a,v) adds the attribute-value pair a=v to w. If the attribute a is specified in w, set(w,a,v) replaces its value with v. If v is nil, set(w,a,v) deletes a from w if a is specified in w, otherwise has no effect. The function always returns the new value of w.

set(w,a,v) 関数は、WFN w、属性 a、値 v の 3 つの引数を取ります。属性 a が w で未指定の場合、set(w,a,v) は属性値ペア a=v を w に追加します。属性 a が w で指定されている場合、set(w,a,v) はその値を v に置き換えます。v が nil の場合、set(w,a,v) は、a が w で指定されていれば w から a を削除し、そうでなければ何の効果もありません。この関数は常に w の新しい値を返します。

Examples:

例:

•set(wfn:[],vendor,"microsoft") → wfn:[vendor="microsoft"]

•set(wfn:[],vendor,"microsoft") → wfn:[vendor="microsoft"]

•set(wfn:[vendor="microsoft"],vendor,"adobe") → wfn:[vendor="adobe"]

•set(wfn:[vendor="microsoft"],vendor,"adobe") → wfn:[vendor="adobe"]

•set(wfn:[vendor="microsoft"],update,ANY) → wfn:[vendor="microsoft",update=ANY]

•set(wfn:[vendor="microsoft"],update,ANY) → wfn:[vendor="microsoft",update=ANY]

•set(wfn:[vendor="microsoft"],vendor,nil) → wfn:[]

•set(wfn:[vendor="microsoft"],vendor,nil) → wfn:[]

5.5 WFN Examples

5.5 WFN の例

This section illustrates a variety of WFNs. The examples below are intended only to illustrate names that are well formed according to the rules defined above. These examples do not necessarily illustrate “correct” or “valid” assignments of values to attributes.

この節では、さまざまな WFN を示します。以下の例は、上で定義した規則に従って整形式である名前を示すことのみを目的としています。これらの例は、属性への値の「正しい」または「有効な」割り当てを必ずしも示すものではありません。

•Microsoft Internet Explorer 8.0.6001 Beta (no edition):
wfn:[part="a",vendor="microsoft",product="internet_explorer",version="8\.0\.6001",update="beta",edition=NA]

•Microsoft Internet Explorer 8.0.6001 Beta(edition なし):
wfn:[part="a",vendor="microsoft",product="internet_explorer",version="8\.0\.6001",update="beta",edition=NA]

•Microsoft Internet Explorer 8.* SP? (no edition, any language):
wfn:[part="a",vendor="microsoft",product="internet_explorer",version="8\.*",update="sp?",edition=NA,language=ANY]

•Microsoft Internet Explorer 8.* SP?(edition なし、任意の言語):
wfn:[part="a",vendor="microsoft",product="internet_explorer",version="8\.*",update="sp?",edition=NA,language=ANY]

•Identifier for HP Insight Diagnostics 7.4.0.1570 Online Edition for Windows 2003 x64:
wfn:[part="a",vendor="hp",product="insight_diagnostics",version="7\.4\.0\.1570",sw_edition="online",target_sw="windows_2003",target_hw="x64"]

•HP Insight Diagnostics 7.4.0.1570 Online Edition for Windows 2003 x64 の識別子:
wfn:[part="a",vendor="hp",product="insight_diagnostics",version="7\.4\.0\.1570",sw_edition="online",target_sw="windows_2003",target_hw="x64"]

•Identifier for HP OpenView Network Manager 7.51 (no update) for Linux:
wfn:[part="a",vendor="hp",product="openview_network_manager",version="7\.51",update=NA,target_sw="linux"]

•HP OpenView Network Manager 7.51(update なし)for Linux の識別子:
wfn:[part="a",vendor="hp",product="openview_network_manager",version="7\.51",update=NA,target_sw="linux"]

•Foo\Bar Systems Big$Money 2010 Special Edition for iPod Touch:
wfn:[part="a",vendor="foo\\bar",product="big\$money_2010",sw_edition="special",target_sw="ipod_touch"]

•Foo\Bar Systems Big$Money 2010 Special Edition for iPod Touch:
wfn:[part="a",vendor="foo\\bar",product="big\$money_2010",sw_edition="special",target_sw="ipod_touch"]

6. Name Binding and Unbinding

6. 名前のバインドとアンバインド

This section defines the procedures for binding (cf. 2.1) and unbinding (cf. 2.1) WFNs to and from machine-readable representations. Section 6.1 addresses URI binding/unbinding, and Section 6.2 covers formatted string binding/unbinding.

この節では、WFN を機械可読な表現へバインド(cf. 2.1)し、またそこからアンバインド(cf. 2.1)する手順を定義します。第 6.1 節では URI のバインドとアンバインドを、第 6.2 節では書式化文字列のバインドとアンバインドを扱います。

This section defines the formats for acceptable bound CPE names. The XML schema implementation of these format requirements, which is the authoritative XML binding definition, can be found at http://scap.nist.gov/schema/cpe/2.3/cpe-naming_2.3.xsd.

この節では、許容されるバインド済みの CPE 名の形式を定義します。これらの形式要件の XML スキーマ実装は、XML バインディングの正式な定義であり、http://scap.nist.gov/schema/cpe/2.3/cpe-naming_2.3.xsd にあります。

6.1 URI Binding

6.1 URI バインディング

The URI Binding is included in this specification for backward compatibility with prior CPE versions. Section 5.1 of [CPE22] specifies that a CPE name is a percent-encoded URI [RFC3986] with each name having the URI scheme name “cpe:”. The procedure defined here for creating a URI binding ensures that when a WFN is bound to a URI, it will satisfy the requirements of [CPE22] for CPE names. Section 6.1.1 defines the syntax of a valid URI binding. Section 6.1.2 specifies the procedure for binding a WFN to a URI. Section 6.1.3 specifies the procedure for unbinding a URI into a WFN.

URI バインディングは、以前の CPE バージョンとの後方互換性のために、この仕様に含まれています。[CPE22] の第 5.1 節は、CPE 名をパーセントエンコードされた URI [RFC3986] とし、各名前が URI スキーム名「cpe:」を持つと規定しています。ここで定義する URI バインディングの作成手順により、WFN を URI にバインドしたときに、それが CPE 名に関する [CPE22] の要件を満たすことが保証されます。第 6.1.1 節では、有効な URI バインディングの構文を定義します。第 6.1.2 節では、WFN を URI にバインドする手順を規定します。第 6.1.3 節では、URI を WFN にアンバインドする手順を規定します。

6.1.1 URI Binding Syntax
6.1.1 URI バインディングの構文

The syntax of legal CPE v2.2 URIs is specified in Appendix A of [CPE22]. For ease of reference it is shown in Figure 6-1, using ABNF notation [RFC2234].

正当な CPE v2.2 URI の構文は、[CPE22] の付録 A に規定されています。参照しやすいように、ABNF 表記 [RFC2234] を用いて図 6-1 に示します。

cpe-name   = "cpe:/" component-list

component-list  = part ":" vendor ":" product ":" version ":" update ":"
  edition ":" lang
component-list  /= part ":" vendor ":" product ":" version ":" update ":"
   edition
component-list  /= part ":" vendor ":" product ":" version ":" update
component-list  /= part ":" vendor ":" product ":" version
component-list  /= part ":" vendor ":" product
component-list  /= part ":" vendor
component-list  /= part
component-list /= empty
part   = "h" / "o" / "a" / empty
vendor  = string
product  = string
version  = string
update  = string
edition  = string
lang   = LANGTAG / empty
string  = *( unreserved / pct-encoded )
empty             = ""
unreserved  = ALPHA / DIGIT / "-" / "." / "_" / "˜"
pct-encoded  = "%" HEXDIG HEXDIG
ALPHA        = %x41-5a / %x61-7a   ; A-Z or a-z
DIGIT   = %x30-39  ; 0-9
HEXDIG  = DIGIT / "a" / "b" / "c" / "d" / "e" / "f"
LANGTAG  = cf. [RFC5646]
原文のみ

Figure 6-1. ABNF for v2.2-Compatible URI Binding

図 6-1. v2.2 互換 URI バインディングの ABNF

This syntax specification is less restrictive than suggested by other text in [CPE22] as well as current CPE operational practice. Specifically, it allows any character in the range %01-ff to be percent-encoded, but Section 5.4 of [CPE22] suggests that only certain printable non-alphanumeric characters should be percent-encoded. In practice, CPE names appearing in the v2.2 Official CPE Dictionary apply percent-encoding only to a limited set of printable non-alphanumeric characters.

この構文の規定は、[CPE22] の他の記述や現在の CPE の運用慣行から示唆されるものよりも制約が緩くなっています。具体的には、%01-ff の範囲の任意の文字をパーセントエンコードできますが、[CPE22] の第 5.4 節は、印字可能な英数字以外の特定の文字のみをパーセントエンコードすべきだと示唆しています。実際には、v2.2 の公式 CPE ディクショナリに現れる CPE 名は、印字可能な英数字以外の限られた文字の集合にのみパーセントエンコードを適用しています。

To ensure full backward compatibility with [CPE22], any implementation that consumes URIs and claims to be conformant with this Naming specification MUST accept as valid input any URI that obeys the full syntax shown in Figure 6-1.

[CPE22] との完全な後方互換性を確保するため、URI を利用し、この Naming 仕様への適合を主張するあらゆる実装は、図 6-1 に示す完全な構文に従う任意の URI を、有効な入力として受け付けなければなりません(MUST)。

cpe-name   = "cpe:/" component-list

component-list  = part ":" vendor ":" product ":" version ":" update ":"
  edition ":" lang
component-list  /= part ":" vendor ":" product ":" version ":" update ":"
   edition
component-list  /= part ":" vendor ":" product ":" version ":" update
component-list  /= part ":" vendor ":" product ":" version
component-list  /= part ":" vendor ":" product
component-list  /= part ":" vendor
component-list  /= part
component-list /= empty
part   = "h" / "o" / "a" / empty
vendor  = string
product  = string
version  = string
update  = string
edition  = string / packed
lang   = LANGTAG / empty
string  = str_wo_special / str_w_special
str_wo_special = *( unreserved / pct-encoded )
str_w_special = *1spec_chrs 1*( unreserved / pct-encoded ) *1spec_chrs
spec_chrs         = 1*spec1 / spec2
packed  = "~" string "~" string "~" string "~" string "~" string
empty             = ""
unreserved  = ALPHA / DIGIT / "-" / "." / "_"
special  = spec1 / spec2
spec1             = "%01"
spec2             = "%02"
pct-encoded  = "%21" / "%22" / "%23" / "%24" / "%25" / "%26" / "%27" /
   = "%28" / "%29" / "%2a" / "%2b" / "%2c" / "%2f" / "%3a" /
   = "%3b" / "%3c" / "%3d" / "%3e" / "%3f" / "%40" / "%5b" /
   = "%5c" / "%5d" / "%5e" / "%60" / "%7b" / "%7c" / "%7d" /
   = "%7e"
ALPHA        = %x41-5a / %x61-7a  ; A-Z or a-z
DIGIT   = %x30-39  ; 0-9
LANGTAG       = language ["-" region] ; cf. [RFC5646]
language          = 2*3ALPHA              ; shortest ISO 639 code
region            = 2ALPHA / 3DIGIT       ; ISO 3166-1 code or UN M.49 code
原文のみ

Figure 6-2. ABNF for Preferred URI Binding

図 6-2. 推奨 URI バインディングの ABNF

Although the freer syntax is allowed as valid input, CPE URIs SHOULD obey the more restricted syntax shown in Figure 6-2. The syntax shown in Figure 6-2 has the following features:

より自由な構文も有効な入力として許容されますが、CPE の URI は、図 6-2 に示すより制限された構文に従うべきです(SHOULD)。図 6-2 に示す構文には、次の特徴があります。

•It introduces support for “packing” multiple attribute values into the edition component.

•複数の属性値を edition コンポーネントに「パック」することをサポートします。

•It introduces support for the use of special characters.

•特殊文字の使用をサポートします。

•It strictly enumerates the allowed percent-encoded forms.

•許容されるパーセントエンコード形式を厳密に列挙します。

The bind_to_URI procedure (cf. 6.1.2) is designed to produce URIs that obey the syntax shown in Figure 6-2. The unbind_URI procedure (cf. 6.1.3) is designed to accept as valid input URIs that obey the syntax shown in either Figure 6-1 or Figure 6-2.

bind_to_URI 手順(cf. 6.1.2)は、図 6-2 に示す構文に従う URI を生成するように設計されています。unbind_URI 手順(cf. 6.1.3)は、図 6-1 または図 6-2 のいずれかに示す構文に従う URI を、有効な入力として受け付けるように設計されています。

6.1.2 Binding a WFN to a URI
6.1.2 WFN の URI へのバインド

The procedure to bind a given WFN to a URI is specified in pseudocode below. The top-level binding function, bind_to_URI, is called with the WFN to be bound as its only argument. The pseudocode references the defined operations on WFNs (cf. 5.4) as well as a number of helper functions also defined in pseudocode. Section 6.1.2.1 provides some important notes on the binding procedure. Section 6.1.2.2 summarizes the algorithm in prose. Section 6.1.2.3 provides the pseudocode for the algorithm. Section 6.1.2.4 provides examples of binding WFNs to URIs. The algorithm defined here assumes that the input WFN complies with the requirements defined in Section 5.2. The behavior of bind_to_URI is undefined if its input is not well formed.

指定された WFN を URI にバインドする手順は、以下の擬似コードで規定されています。最上位のバインド関数 bind_to_URI は、バインドする WFN だけを引数として呼び出されます。この擬似コードは、WFN に対して定義された操作(cf. 5.4)と、同じく擬似コードで定義された多数の補助関数を参照します。第 6.1.2.1 節では、バインド手順に関する重要な注意事項を示します。第 6.1.2.2 節では、アルゴリズムを散文で要約します。第 6.1.2.3 節では、アルゴリズムの擬似コードを示します。第 6.1.2.4 節では、WFN を URI にバインドする例を示します。ここで定義するアルゴリズムは、入力の WFN が第 5.2 節で定義された要件に適合していることを前提としています。入力が整形式でない場合、bind_to_URI の動作は未定義です。

It is OPTIONAL for implementations of URI binding to follow the pseudocode, processes, and other non-normative information provided in this section. However, the result of an implementation performing a URI binding MUST produce the same result as the suggested pseudocode, processes, etc. would produce.

URI バインディングの実装が、この節で示す擬似コード、処理、その他の非規範的な情報に従うことは、任意(OPTIONAL)です。ただし、URI バインディングを実行する実装の結果は、提案された擬似コードや処理などが生成する結果と同じ結果を生成しなければなりません(MUST)。

6.1.2.1 Notes on URI binding procedure
6.1.2.1 URI バインド手順に関する注意事項

The procedure for binding WFNs to URIs MUST address the following issues:

WFN を URI にバインドする手順は、次の問題に対処しなければなりません(MUST)。

1.Handling logical values

1.論理値の扱い

2.Handling non-alphanumeric and special characters

2.英数字以外の文字と特殊文字の扱い

3.“Packing” extended attributes.

3.拡張属性の「パック」。

6.1.2.1.1 Handling logical values
6.1.2.1.1 論理値の扱い

The logical values ANY and NA are defined as possible attribute values in WFNs. The logical value ANY SHALL bind to what [CPE22] calls a “blank” (i.e., an empty component, indicated by two sequential colons) in the URI. The logical value NA SHALL bind to a single hyphen.

論理値 ANY と NA は、WFN の属性値として取り得るものとして定義されています。論理値 ANY は、URI 内で [CPE22] が「空白」(すなわち、2 つの連続したコロンで示される空のコンポーネント)と呼ぶものにバインドされなければなりません(SHALL)。論理値 NA は、単一のハイフンにバインドされなければなりません(SHALL)。

6.1.2.1.2 Handling non-alphanumeric and special characters
6.1.2.1.2 英数字以外の文字と特殊文字の扱い

In WFN attribute-value strings, non-alphanumeric characters generally MUST be quoted, with the exception that the special characters “*” and “?” MAY appear without quoting. When forming the URI binding, certain transformations MUST be applied. In most cases, quoted non-alphanumeric characters are bound to a percent-encoded form; certain quoted non-alphanumeric characters, however, are passed through without percent-encoding. When special characters appear without quoting, they are mapped to special percent-encoded forms. This behavior is summarized as follows.

WFN の属性値文字列では、一般に、英数字以外の文字はクォートされなければなりません(MUST)。ただし、特殊文字「*」と「?」は、クォートなしで現れてもよいです(MAY)。URI バインディングを作成する際には、特定の変換を適用しなければなりません(MUST)。ほとんどの場合、クォートされた英数字以外の文字は、パーセントエンコードされた形式にバインドされます。ただし、クォートされた英数字以外の一部の文字は、パーセントエンコードされずにそのまま通されます。特殊文字がクォートなしで現れる場合は、特別なパーセントエンコード形式に対応づけられます。この動作は次のように要約されます。

Following Table 6-1, the binding procedure SHALL replace quoted non-alphanumeric substrings shown under the columns labeled IN with the substitute character or percent-encoded string shown to its right under the columns labeled OUT. So, for example, if the substring "\(" (exclusive of double quotes) is encountered within an attribute-value string, it would be bound to the substring "%28". As a second example, if the substring "\-" is encountered within an attribute-value string, it would be bound to the single character "-".

表 6-1 に従い、バインド手順は、IN と書かれた列にあるクォートされた英数字以外の部分文字列を、その右の OUT と書かれた列にある代替文字またはパーセントエンコードされた文字列に置き換えなければなりません(SHALL)。たとえば、属性値文字列内に部分文字列 "\("(二重引用符は含みません)が現れた場合、それは部分文字列 "%28" にバインドされます。2 つ目の例として、属性値文字列内に部分文字列 "\-" が現れた場合、それは単一の文字 "-" にバインドされます。

INOUTINOUTINOUTINOUTINOUTINOUTINOUT
\!%21\"%22\#%23\$%24\%%25\&%26\'%27
\(%28\)%29\*%2a\+%2b\,%2c\--\..
\/%2f\:%3a\;%3b\<%3c\=%3d\>%3e\?%3f
\@%40\[%5b\\%5c\]%5d\^%5e\`%60\{%7b
\|%7c\}%7d\~%7e
INOUTINOUTINOUTINOUTINOUTINOUTINOUT
\!%21\"%22\#%23\$%24\%%25\&%26\'%27
\(%28\)%29\*%2a\+%2b\,%2c\--\..
\/%2f\:%3a\;%3b\<%3c\=%3d\>%3e\?%3f
\@%40\[%5b\\%5c\]%5d\^%5e\`%60\{%7b
\|%7c\}%7d\~%7e

Table 6-1. Bindings for Quoted Non-Alphanumeric Characters

表 6-1. クォートされた英数字以外の文字のバインディング

When an unquoted special character is encountered in an attribute-value string, it SHALL be bound to the special percent-encoded form shown in Table 6-2.

属性値文字列内でクォートされていない特殊文字が現れた場合、それは表 6-2 に示す特別なパーセントエンコード形式にバインドされなければなりません(SHALL)。

INOUT
?%01
*%02
INOUT
?%01
*%02

Table 6-2. Bindings for Unquoted Special Characters

表 6-2. クォートされていない特殊文字のバインディング

6.1.2.1.3 Packing extended attributes
6.1.2.1.3 拡張属性のパック

The version 2.3 specification introduces four new attributes—the extended attributes—that have no assigned position in the URI binding. When these attributes have values other than ANY in the WFN, they are “packed” in a special format, and in a specified order, into the edition component of the URI. This special format uses the tilde character “~” (without percent-encoding) as a sub-delimiter.

バージョン 2.3 仕様は、URI バインディングに割り当てられた位置を持たない 4 つの新しい属性、すなわち拡張属性を導入しています。これらの属性が WFN 内で ANY 以外の値を持つ場合、それらは特別な形式で、規定された順序で、URI の edition コンポーネントに「パック」されます。この特別な形式では、チルダ文字「~」(パーセントエンコードなし)を副区切り文字として使用します。

The capability to bind WFNs to URIs is provided primarily for use by CPE dictionary creators and maintainers, to allow them to create new CPE names that take full advantage of all features introduced in this specification, while still having a backward-compatible path for creating approximate names that conform to [CPE22]. This capability should be used with care, as CPE v2.2-conformant tools may be unable to properly match names that differ in terms of packed attribute values.

WFN を URI にバインドする機能は、主に CPE ディクショナリの作成者と保守者が使用するために提供されています。これにより、この仕様で導入されたすべての機能を十分に活用した新しい CPE 名を作成しつつ、[CPE22] に適合する近似的な名前を作成するための後方互換の手段も確保できます。CPE v2.2 に適合するツールは、パックされた属性値が異なる名前を適切に照合できない場合があるため、この機能は注意して使用すべきです。

6.1.2.2 Summary of algorithm
6.1.2.2 アルゴリズムの要約

The URI binding procedure is summarized as follows:

URI バインド手順は次のように要約されます。

1.Initialize the output URI binding to the string "cpe:/".

1.出力の URI バインディングを文字列 "cpe:/" で初期化します。

2.Begin loop: Iterate over the seven attributes corresponding to the seven components in a v2.2 CPE URI [CPE22:5.2]. Get the value of each attribute and perform steps 3 through 7.

2.ループを開始します。v2.2 の CPE URI [CPE22:5.2] の 7 つのコンポーネントに対応する 7 つの属性を順に処理します。各属性の値を取得し、手順 3 から 7 を実行します。

3.Special handling of edition: When binding to a 2.2 URI, the edition component (the sixth element of the URI) is used as the location to “pack” five attribute values in the WFN: (legacy) edition, sw_edition, target_sw, target_hw, and other. The “packing” process involves concatenating the five values together, prefixed and separated by the tilde. The leading tilde serves as a flag indicating that the contents of the edition field are a packed representation of five separate values, and the internal tildes are used to aid parsing the values out. In the special case in which the four extended attributes are not specified, or all are ANY, only the edition attribute is used and no packing is performed.

3.edition の特別な扱い: 2.2 の URI にバインドする場合、edition コンポーネント(URI の 6 番目の要素)は、WFN 内の 5 つの属性値((レガシー)edition、sw_edition、target_sw、target_hw、other)を「パック」する場所として使われます。「パック」の処理では、5 つの値を連結し、それぞれの前にチルダを付けて区切ります。先頭のチルダは、edition フィールドの内容が 5 つの個別の値をパックした表現であることを示すフラグとして機能し、内部のチルダは値の解析を助けるために使われます。4 つの拡張属性が指定されていない、またはすべてが ANY である特別な場合には、edition 属性のみが使われ、パックは行われません。

4.Bind attribute values:

4.属性値をバインドします。

a.For all attributes other than (legacy) “edition”, inspect the value and convert logical values appropriately. If the attribute is unspecified, or its logical value is ANY, bind it to blank (“”) in the URI. If the logical value is NA, bind it to the hyphen (“-”).

a.(レガシー)「edition」以外のすべての属性について、値を調べ、論理値を適切に変換します。属性が未指定であるか、その論理値が ANY の場合、URI 内で空のコンポーネント(「」)にバインドします。論理値が NA の場合、ハイフン(「-」)にバインドします。

b.Scan the attribute value for any quoted non-alphanumeric characters and bind them as specified in Table 6-1.

b.属性値内にクォートされた英数字以外の文字がないか走査し、表 6-1 の規定に従ってバインドします。

c.Scan the attribute value for any unquoted special characters and bind them as specified in Table 6-2.

c.属性値内にクォートされていない特殊文字がないか走査し、表 6-2 の規定に従ってバインドします。

5.Append the attribute-value string to the output URI, followed by a trailing colon.

5.属性値の文字列を出力の URI に追加し、続けて末尾のコロンを追加します。

6.END LOOP.

6.END LOOP。

7.Return the output URI, trimming away all trailing colons for compactness.

7.出力の URI を返します。簡潔にするため、末尾のコロンはすべて取り除きます。

6.1.2.3 Pseudocode for algorithm
6.1.2.3 アルゴリズムの擬似コード
function bind_to_URI(w)
  ;; Top-level function used to bind a WFN w to a URI.
  ;; Initialize the output with the CPE v2.2 URI prefix.
  uri := "cpe:/".
  foreach a in {part,vendor,product,version,update,edition,language}
    do
      if a = edition
        then
          ;; Call the pack() helper function to compute the proper
          ;; binding for the edition element.
          ed := bind_value_for_URI(get(w,edition)).
          sw_ed := bind_value_for_URI(get(w,sw_edition)).
          t_sw := bind_value_for_URI(get(w,target_sw)).
          t_hw := bind_value_for_URI(get(w,target_hw)).
          oth := bind_value_for_URI(get(w,other)).
          v := pack(ed,sw_ed,t_sw,t_hw,oth).
        else
          ;; Get the value for a in w, then bind to a string
          ;; for inclusion in the URI.
          v := bind_value_for_URI(get(w,a)).
      endif.
    ;; Append v to the URI then add a colon.
    uri := strcat(uri, v, ":").
  end.
  ;; Return the URI string, with trailing colons trimmed.
  return trim(uri).
end.

function bind_value_for_URI(s)
  ;; Takes a string s and converts it to the proper string for
  ;; inclusion in a CPE v2.2-conformant URI.  The logical value ANY
  ;; binds to the blank in the 2.2-conformant URI.
  if s = ANY then return("").
  ;; The value NA binds to a single hyphen.
  if s = NA then return("-").
  ;; If we get here, we’re dealing with a string value.
  return transform_for_uri(s).
end.

function transform_for_uri(s)
  ;; Scans an input string s and applies the following
  ;; transformations:
  ;; - Pass alphanumeric characters thru untouched
  ;; - Percent-encode quoted non-alphanumerics as needed
  ;; - Unquoted special characters are mapped to their special forms.
  result := "".
  idx := 0.
  while (idx < strlen(s)) do
    thischar := substr(s,idx,idx).  ; get the idx’th character of s.
    ;; alphanumerics (incl. underscore) pass untouched.
    if (is_alphanum(thischar))
      then
        result := strcat(result,thischar).
        idx := idx + 1.
        continue.
    endif.
    if (thischar = "\") ; escape character
      then
        idx := idx + 1.
        nxtchar := substr(s,idx,idx).
        result := strcat(result,pct_encode(nxtchar)).
        idx := idx + 1.
        continue.
    endif.
    ;; Bind the unquoted '?' special character to "%01".
    if (thischar = "?") then result := strcat(result,"%01").
    ;; Bind the unquoted '*' special character to "%02".
    if (thischar = "*") then result := strcat(result,"%02").
    idx := idx + 1.
  end.
  return result.
end.

function pct_encode(c)
  ;; Return the appropriate percent-encoding of character c.
  ;; Certain characters are returned without encoding.
  case c:
    '!': return "%21".
    '"': return "%22".
    '#': return "%23".
    '$': return "%24".
    '%': return "%25".
    '&': return "%26".
    ''': return "%27".
    '(': return "%28".
    ')': return "%29".
    '*': return "%2a".
    '+': return "%2b".
    ',': return "%2c".
    '-': return c. ; bound without encoding
    '.': return c. ; bound without encoding
    '/': return "%2f".
    ':': return "%3a".
    ';': return "%3b".
    '<': return "%3c".
    '=': return "%3d".
    '>': return "%3e".
    '?': return "%3f".
    '@': return "%40".
    '[': return "%5b".
    '\': return "%5c".
    ']': return "%5d".
    '^': return "%5e".
    '`': return "%60".
    '{': return "%7b".
    '|': return "%7c".
    '}': return "%7d".
    '~': return "%7e".
  end case.
end.

function pack(ed,sw_ed,t_sw,t_hw,oth)
  ;; “Pack” the values of the five arguments into the single edition
  ;; component. If all the values are blank, just return a blank.
  if (sw_ed = "" and t_sw = "" and t_hw = "" and oth = "")
    then
      ;; All the extended attributes are blank, so don’t do
      ;; any packing, just return ed.
      return ed.
  end.
  ;; Otherwise, pack the five values into a single string
  ;; prefixed and internally delimited with the tilde.
  return strcat('~',ed,'~',sw_ed,'~',t_sw,'~',t_hw,'~',oth).
end.

function trim(s)
  ;; Remove trailing colons from the URI back to the first non-colon.
  s1 := reverse(s).
  idx := 0.
  for i := 0 to strlen(s1) do
    if substr(s1,i,i) = ":"
      then idx := idx + 1.
      else break.
  end.
  ;; Return the substring after all trailing colons,
  ;; reversed back to its original character order.
  return reverse(substr(s1,idx,strlen(s1)-1)).
end.
function strcat(s1,s2,...sn)
  ;; Returns a copy of the string s1 with the strings s2 to sn
  ;; appended in the order given.
  ;; Cf. the GNU C definition of strcat. This function shown
  ;; here differs only in that it can take a variable number
  ;; of arguments. This is really just shorthand for,
  ;; strcat(s1, strcat(s2, strcat(s3, … ))).
end.

function strlen(s)
  ;; Defined as in GNU C, returns the length of string s.
  ;; Returns zero if the string is empty.
end.

function substr(s,b,e)
  ;; Returns a substring of s, beginning at the b’th character,
  ;; with 0 being the first character, and ending at the e’th
  ;; character. b must be <= e. Returns nil if b >= strlen(s).
end.

function reverse(s)
  ;; Returns a reverse copy of string s, i.e., the last character
  ;; becomes the first character, the second-to-last becomes the
  ;; second character, etc.
end.

function is_alphanum(c)
  ;; Returns TRUE iff c is an uppercase letter, a lowercase letter,
  ;; a digit, or the underscore, otherwise FALSE.
end.
原文のみ
6.1.2.4 Examples of binding a WFN to a URI
6.1.2.4 WFN の URI へのバインド例

This section presents several examples of binding WFNs to URIs.

この節では、WFN を URI にバインドする例をいくつか示します。

6.1.2.4.1 Example 1
6.1.2.4.1 例 1

Suppose one had created the WFN below to describe this product: Microsoft Internet Explorer 8.0.6001 Beta (any edition):

次の製品を記述するために、以下の WFN を作成したとします。Microsoft Internet Explorer 8.0.6001 Beta(任意の edition):

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.0\.6001",update="beta",edition=ANY]
原文のみ

This WFN binds to the following URI:

この WFN は、次の URI にバインドされます。

cpe:/a:microsoft:internet_explorer:8.0.6001:beta
原文のみ

Note how the trailing colons are removed, such that the “edition=ANY” effectively disappears.

末尾のコロンが取り除かれ、「edition=ANY」が事実上消えることに注目してください。

6.1.2.4.2 Example 2
6.1.2.4.2 例 2

Suppose one had created the WFN below to describe this product: Microsoft Internet Explorer 8.* SP?:

次の製品を記述するために、以下の WFN を作成したとします。Microsoft Internet Explorer 8.* SP?:

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.*",update="sp?"]
原文のみ

This WFN binds to the following URI:

この WFN は、次の URI にバインドされます。

cpe:/a:microsoft:internet_explorer:8.%02:sp%01
原文のみ

Note how the unquoted special characters in the WFN get percent-encoded in the URI. The otherwise prohibited percent-encoded forms "%01" and "%02" are used in the URI to represent the unquoted "?" and "*", respectively.

WFN 内のクォートされていない特殊文字が、URI ではパーセントエンコードされることに注目してください。URI では、クォートされていない "?" と "*" を表すために、本来は禁止されているパーセントエンコード形式 "%01" と "%02" がそれぞれ使われています。

6.1.2.4.3 Example 3
6.1.2.4.3 例 3

Suppose one had created the WFN below to describe this product: HP Insight Diagnostics 7.4.0.1570 Online Edition for Windows 2003 x64:

次の製品を記述するために、以下の WFN を作成したとします。HP Insight Diagnostics 7.4.0.1570 Online Edition for Windows 2003 x64:

wfn:[part="a",vendor="hp",product="insight_diagnostics",
version="7\.4\.0\.1570",update=NA,
sw_edition="online",target_sw="win2003",target_hw="x64"]
原文のみ

This WFN binds to the following URI:

この WFN は、次の URI にバインドされます。

cpe:/a:hp:insight_diagnostics:7.4.0.1570:-:~~online~win2003~x64~
原文のみ

Note how the legacy edition attribute as well as the four extended attributes are packed into the edition component of the URI.

レガシー edition 属性と 4 つの拡張属性が、URI の edition コンポーネントにパックされることに注目してください。

6.1.2.4.4 Example 4
6.1.2.4.4 例 4

Suppose one had created the WFN below to describe this product: HP OpenView Network Manager 7.51 (any update) for Linux:

次の製品を記述するために、以下の WFN を作成したとします。HP OpenView Network Manager 7.51(任意の update)for Linux:

wfn:[part="a",vendor="hp",product="openview_network_manager",
version="7\.51",target_sw="linux"]
原文のみ

This WFN binds to the following URI:

この WFN は、次の URI にバインドされます。

cpe:/a:hp:openview_network_manager:7.51::~~~linux~~
原文のみ

Note how the unspecified update attribute binds to a blank in the URI, and how packing occurs in the edition component when only the target_sw attribute is specified.

未指定の update 属性が URI 内で空の値にバインドされること、また target_sw 属性のみが指定されている場合でも edition コンポーネントでパックが行われることに注目してください。

6.1.2.4.5 Example 5
6.1.2.4.5 例 5

Suppose one had created the WFN below to describe this product: Foo\Bar Big$Money Manager 2010 Special Edition for iPod Touch 80GB:

次の製品を記述するために、以下の WFN を作成したとします。Foo\Bar Big$Money Manager 2010 Special Edition for iPod Touch 80GB:

wfn:[part="a",vendor="foo\\bar",product="big\$money_manager_2010",
sw_edition="special",target_sw="ipod_touch",target_hw="80gb"]
原文のみ

This WFN binds to the following URI:

この WFN は、次の URI にバインドされます。

cpe:/a:foo%5cbar:big%24money_manager_2010:::~~special~ipod_touch~80gb~
原文のみ

Note how the \\ becomes a percent-encoded backslash. Also note how the dollar sign is percent-encoded, and how the extended attributes are packed.

\\ がパーセントエンコードされたバックスラッシュになることに注目してください。また、ドル記号がパーセントエンコードされること、拡張属性がパックされることにも注目してください。

6.1.3 Unbinding a URI to a WFN
6.1.3 URI の WFN へのアンバインド

Given a CPE v2.2-conformant URI, the procedure to unbind it to a WFN is specified in pseudocode below. The top-level unbinding function, unbind_URI, is called with the URI to be unbound as its only argument. The pseudocode references the defined operations on WFNs (cf. 5.4) as well as a number of helper functions also defined in pseudocode. Section 6.1.3.1 summarizes the algorithm in prose. Section 6.1.3.2 provides the pseudocode for the algorithm. Section 6.1.3.3 provides examples of unbinding URIs to WFNs. Note that the pseudocode below reuses a number of helper functions defined above in Section 6.1.2.3. The algorithm expects that the syntax of the input URI conforms to the ABNF in Figure 6-1 or Figure 6-2. (This is guaranteed if the URI is the result of binding a WFN.) The algorithm performs some limited error checking and handling: (1) if an illegal percent-encoded form is encountered, an error is raised; (2) if unquoted special characters are used in a way that violates the legal syntax, an error is raised. A fully robust implementation of the unbinding procedure SHOULD implement additional syntax checks, such as making sure that non-alphanumeric characters do not appear without percent-encoding.

CPE v2.2 に適合する URI が与えられたとき、それを WFN にアンバインドする手順は、以下の擬似コードで規定されています。最上位のアンバインド関数 unbind_URI は、アンバインドする URI だけを引数として呼び出されます。この擬似コードは、WFN に対して定義された操作(cf. 5.4)と、同じく擬似コードで定義された多数の補助関数を参照します。第 6.1.3.1 節では、アルゴリズムを散文で要約します。第 6.1.3.2 節では、アルゴリズムの擬似コードを示します。第 6.1.3.3 節では、URI を WFN にアンバインドする例を示します。以下の擬似コードは、上の第 6.1.2.3 節で定義された多数の補助関数を再利用していることに注意してください。このアルゴリズムは、入力の URI の構文が図 6-1 または図 6-2 の ABNF に適合していることを前提としています(URI が WFN をバインドした結果であれば、これは保証されます)。このアルゴリズムは、限定的なエラーチェックと処理を行います。(1) 不正なパーセントエンコード形式に遭遇した場合は、エラーが発生します。(2) クォートされていない特殊文字が正当な構文に違反する形で使われている場合は、エラーが発生します。アンバインド手順を完全に堅牢に実装するには、英数字以外の文字がパーセントエンコードなしで現れないことを確認するなど、追加の構文チェックを実装すべきです(SHOULD)。

It is OPTIONAL for implementations of URI unbinding to follow the pseudocode, processes, and other non-normative information provided in this section. However, the result of an implementation performing a URI unbinding MUST produce the same result as the suggested pseudocode, processes, etc. would produce.

URI アンバインディングの実装が、この節で示す擬似コード、処理、その他の非規範的な情報に従うことは、任意(OPTIONAL)です。ただし、URI アンバインディングを実行する実装の結果は、提案された擬似コードや処理などが生成する結果と同じ結果を生成しなければなりません(MUST)。

6.1.3.1 Summary of algorithm
6.1.3.1 アルゴリズムの要約

The procedure for unbinding a URI is straightforward:

URI をアンバインドする手順は単純です。

1.Loop over the seven attributes corresponding to the seven CPE v2.2 components, performing steps 2 through 7.

1.CPE v2.2 の 7 つのコンポーネントに対応する 7 つの属性を順に処理し、手順 2 から 7 を実行します。

2.For URI components 1-5 and 7, decode the string and set the corresponding WFN attribute value. Decoding entails: converting sole "" to ANY, sole "-" to NA, adding quoting to embedded periods and hyphens, and decoding percent-encoded forms.

2.URI のコンポーネント 1〜5 と 7 については、文字列をデコードし、対応する WFN の属性値を設定します。デコードでは、単独の "" を ANY に、単独の "-" を NA に変換し、埋め込まれたピリオドとハイフンにクォートを追加し、パーセントエンコードされた形式をデコードします。

3.The edition component is "unpacked" if a leading tilde indicates it contains a packed collection of five attribute values.

3.先頭のチルダが、edition コンポーネントに 5 つの属性値をパックしたものが含まれていることを示している場合、その edition コンポーネントを「アンパック」します。

6.1.3.2 Pseudocode for algorithm
6.1.3.2 アルゴリズムの擬似コード
function unbind_URI(uri)
  ;; Top-level function used to unbind a URI uri to a WFN.
  ;; Initialize the empty WFN.
  result := new().
  for i := 1 to 7
    do
      v := get_comp_uri(uri,i). ; get the i’th component of uri
      ;; unbind the parsed string.
      case i:
        1: result := set(result,part,decode(v)).
        2: result := set(result,vendor,decode(v)).
        3: result := set(result,product,decode(v)).
        4: result := set(result,version,decode(v)).
        5: result := set(result,update,decode(v)).
        6: ;; Special handling for edition component.
           ;; Unpack edition if needed.
           if (v = "" or v = "-" or substr(v,0,0) != "~")
             then
               ;; Just a logical value or a non-packed value.
               ;; So unbind to legacy edition, leaving other
               ;; extended attributes unspecified.
               result := set(result,edition,decode(v)).
             else
               ;; We have five values packed together here
               result := unpack(v,result).
           end.
        7: result := set(result,language,decode(v)).
      end.
  end.
  return result.
end.

function get_comp_uri(uri,i)
  ;; Return the i’th CPE component of the URI. If i=0,
  ;; return the URI scheme. For example, given URI:
  ;; cpe:/a:foo::bar:-
  ;; get_comp_uri(uri,0) = "cpe:"
  ;; get_comp_uri(uri,1) = "a"
  ;; get_comp_uri(uri,2) = "foo"
  ;; get_comp_uri(uri,3) = ""
  ;; get_comp_uri(uri,4) = "bar"
  ;; get_comp_uri(uri,5) = "-"
  ;; get_comp_uri(uri,6) = ""
  ;; etc.
end.

function decode(s)
  ;; This function scans the string s and returns a copy
  ;; with all percent-encoded characters decoded. This
  ;; function is the inverse of pct_encode(s) defined in
  ;; Section 6.1.2.3. Only legal percent-encoded forms are
  ;; decoded.  Others raise an error.
  ;; Decode a blank to logical ANY, and hyphen to logical NA.
  if (s = '') then return ANY.
  if (s = '-') then return NA.
  ;; Start the scanning loop.
  ;; Normalize: convert all uppercase letters to lowercase first.
  s := to_lowercase(s).
  result := "".
  idx := 0.
  embedded := false.
  while (idx < strlen(s))
    do
      c := substr(s,idx,idx).  ; get the idx’th character of s.
      ;; deal with dot, hyphen and tilde: decode with quoting
      if ((c = '.') or (c = '-') or (c = '~')) then
        result := strcat(result,"\\",c).
        idx := idx + 1.
        embedded := true.  ; a non-%01 encountered.
        continue.
      endif.
      if (c != '%') then
        result := strcat(result,c).
        idx := idx + 1.
        embedded := true.  ; a non-%01 encountered.
        continue.
      endif.
      ;; we get here if we have a substring starting w/ '%'.
      form := substr(s,idx,idx+2).   ; get the three-char sequence
      case form:
        ;; pseudocode below uses \ within quotes as escape char
        "%01": if ;; %01 legal at beginning or end
                  (((idx = 0) or (idx = (strlen(s)-3))) or
                   ;; embedded is false, so must be preceded by %01
                   (!embedded and (substr(s,idx-3,idx-1) = "%01")) or
                   ;; embedded is true, so must be followed by %01
                   (embedded and (strlen(s) >= idx+6) and
                    (substr(s,idx+3,idx+5) = "%01")))
                 then
                   ;; A percent-encoded question mark is found
                   ;; at the beginning or the end of the string,
                   ;; or embedded in sequence as required.
                   ;; Decode to unquoted form.
                   result := strcat(result,"?").
                   idx := idx + 3.
                   continue.
                 else
                   error.  ;; raise an exception
               endif.
        "%02": if ((idx = 0) or (idx = (strlen(s)-3)))
                 then
                   ;; Percent-encoded asterisk is at the beginning
                   ;; or the end of the string, as required.
                   ;; Decode to unquoted form.
                   result := strcat(result,"*").
                 else
                   error.  ;; raise an exception
               endif.
        "%21": result := strcat(result,"\\!").
        "%22": result := strcat(result,"\\\"").
        "%23": result := strcat(result,"\\#").
        "%24": result := strcat(result,"\\$").
        "%25": result := strcat(result,"\\%").
        "%26": result := strcat(result,"\\&").
        "%27": result := strcat(result,"\\'").
        "%28": result := strcat(result,"\\(").
        "%29": result := strcat(result,"\\)").
        "%2a": result := strcat(result,"\\*").
        "%2b": result := strcat(result,"\\+").
        "%2c": result := strcat(result,"\\,").
        "%2f": result := strcat(result,"\\/").
        "%3a": result := strcat(result,"\\:").
        "%3b": result := strcat(result,"\\;").
        "%3c": result := strcat(result,"\\<").
        "%3d": result := strcat(result,"\\=").
        "%3e": result := strcat(result,"\\>").
        "%3f": result := strcat(result,"\\?").
        "%40": result := strcat(result,"\\@").
        "%5b": result := strcat(result,"\\[").
        "%5c": result := strcat(result,"\\\\").
        "%5d": result := strcat(result,"\\]").
        "%5e": result := strcat(result,"\\^").
        "%60": result := strcat(result,"\\`").
        "%7b": result := strcat(result,"\\{").
        "%7c": result := strcat(result,"\\|").
        "%7d": result := strcat(result,"\\}").
        "%7e": result := strcat(result,"\\~").
        else: error.  ; any other form is an error
      end case.
    idx := idx + 3.
    embedded := true. ; a non-%01 encountered.
  end.
  return result.
end.

function unpack(s,wfn).
  ;; Argument s is a packed edition string, wfn is a WFN.
  ;; Unpack its elements and set the attributes in wfn accordingly.
  ;; Parse out the five elements.
  start := 1.
  end := strchr(s,'~',start).
  if (start = end)
    then ed := "".
    else ed := substr(s,start,end-1).
  end.
  start := end+1.
  end := strchr(s,'~',start).
  if (start = end)
    then sw_ed := "".
    else sw_ed := substr(s,start,end-1).
  end.
  start := end+1.
  end := strchr(s,'~',start).
  if (start = end)
    then t_sw := "".
    else t_sw := substr(s,start,end-1).
  end.
  start := end+1.
  end := strchr(s,'~',start).
  if (start = end)
    then t_hw := "".
    else t_hw := substr(s,start,end-1).
  end.
  start := end+1.
  if (start >= strlen(s))
    then oth := "".
    else oth := substr(s,start,strlen(s)-1).
  end.
  wfn := set(wfn,edition,decode(ed)).
  wfn := set(wfn,sw_edition,decode(sw_ed)).
  wfn := set(wfn,target_sw,decode(t_sw)).
  wfn := set(wfn,target_hw,decode(t_hw)).
  wfn := set(wfn,other,decode(oth)).
  return wfn.
end.

function strchr(str,chr,off)
  ;; Searches the string str for the character chr starting
  ;; at offset off into the string. Returns the offset of
  ;; the chr if found, otherwise nil.
  ;; Defined similar to the standard C function strchr.
  ;; But this version takes a third argument off, which
  ;; is an offset into the str to begin the search.
end.

function to_lowercase(s)
  ;; convert all alphabetic characters to lowercase.
end.
原文のみ
6.1.3.3 Examples of unbinding a URI to a WFN
6.1.3.3 URI の WFN へのアンバインド例

This section provides a number of examples illustrating the results of unbinding a URI to a WFN.

この節では、URI を WFN にアンバインドした結果を示す例を多数示します。

6.1.3.3.1 Example 1
6.1.3.3.1 例 1

URI: cpe:/a:microsoft:internet_explorer:8.0.6001:beta

URI: cpe:/a:microsoft:internet_explorer:8.0.6001:beta

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.0\.6001",update="beta",edition=ANY,
language=ANY]
原文のみ

Notice how the legacy edition and language attributes are unbound to the logical value ANY.

レガシー edition 属性と language 属性が、論理値 ANY にアンバインドされることに注目してください。

6.1.3.3.2 Example 2
6.1.3.3.2 例 2

URI: cpe:/a:microsoft:internet_explorer:8.%2a:sp%3f

URI: cpe:/a:microsoft:internet_explorer:8.%2a:sp%3f

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.\*",update="sp\?",edition=ANY,language=ANY]
原文のみ

Note how the two percent-encoded characters are unbound with added quoting. Although the percent-encoded characters are the same as the special characters, the added quoting blocks their interpretation in the WFN.

2 つのパーセントエンコードされた文字が、クォートを追加してアンバインドされることに注目してください。パーセントエンコードされた文字は特殊文字と同じですが、クォートを追加することで、WFN 内での解釈が妨げられます。

6.1.3.3.3 Example 3
6.1.3.3.3 例 3

URI: cpe:/a:microsoft:internet_explorer:8.%02:sp%01

URI: cpe:/a:microsoft:internet_explorer:8.%02:sp%01

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.*",update="sp?",edition=ANY,language=ANY]
原文のみ

Note how the two percent-encoded special characters are unbound without quoting.

2 つのパーセントエンコードされた特殊文字が、クォートなしでアンバインドされることに注目してください。

6.1.3.3.4 Example 4
6.1.3.3.4 例 4

URI: cpe:/a:hp:insight_diagnostics:7.4.0.1570::~~online~win2003~x64~

URI: cpe:/a:hp:insight_diagnostics:7.4.0.1570::~~online~win2003~x64~

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="hp",product="insight_diagnostics",
version="7\.4\.0\.1570",update=ANY,edition=ANY,
sw_edition="online",target_sw="win2003",target_hw="x64",
other=ANY,language=ANY]
原文のみ

Note how the legacy edition attribute as well as the four extended attributes are unpacked from the edition component of the URI.

レガシー edition 属性と 4 つの拡張属性が、URI の edition コンポーネントからアンパックされることに注目してください。

6.1.3.3.5 Example 5
6.1.3.3.5 例 5

URI: cpe:/a:hp:openview_network_manager:7.51:-:~~~linux~~

URI: cpe:/a:hp:openview_network_manager:7.51:-:~~~linux~~

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="hp",product="openview_network_manager",
version="7\.51",update=NA,edition=ANY,sw_edition=ANY,
target_sw="linux",target_HW=ANY,other=ANY,language=ANY]
原文のみ

Note how the lone hyphen in the update component is unbound to the logical value NA, and how all the other blanks embedded in the packed edition component unbind to ANY, with only the target_sw attribute actually specified.

update コンポーネント内の単独のハイフンが論理値 NA にアンバインドされること、またパックされた edition コンポーネントに埋め込まれたその他のすべての空白が ANY にアンバインドされ、実際に指定されるのは target_sw 属性のみであることに注目してください。

6.1.3.3.6 Example 6
6.1.3.3.6 例 6

URI: cpe:/a:foo%5cbar:big%24money_2010%07:::~~special~ipod_touch~80gb~

URI: cpe:/a:foo%5cbar:big%24money_2010%07:::~~special~ipod_touch~80gb~

An error is raised when this URI is unbound, because it contains an illegal percent-encoded form, "%07".

この URI には不正なパーセントエンコード形式 "%07" が含まれているため、アンバインド時にエラーが発生します。

6.1.3.3.7 Example 7
6.1.3.3.7 例 7

URI: cpe:/a:foo~bar:big%7emoney_2010

URI: cpe:/a:foo~bar:big%7emoney_2010

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="foo\~bar",product="big\~money_2010",
version=ANY,update=ANY,edition=ANY,language=ANY]
原文のみ

Note how both the tildes (unencoded as well as percent-encoded) are handled: both are quoted in the WFN. The original v2.2 URI syntax allows tildes to appear without encoding, but the preferred URI syntax is for tildes to be encoded like any other printable non-alphanumeric character.

(エンコードされていないものも、パーセントエンコードされたものも)両方のチルダがどのように扱われるかに注目してください。WFN では、どちらもクォートされます。元の v2.2 の URI 構文では、チルダはエンコードなしで現れてもよいとされていますが、推奨される URI 構文では、チルダは他の印字可能な英数字以外の文字と同様にエンコードされます。

6.1.3.3.8 Example 8
6.1.3.3.8 例 8

URI: cpe:/a:foo:bar:12.%02.1234

URI: cpe:/a:foo:bar:12.%02.1234

An error is raised when this URI is unbound, because it contains a special character ("%02") embedded within a value string.

この URI には、値文字列の途中に埋め込まれた特殊文字("%02")が含まれているため、アンバインド時にエラーが発生します。

6.2 Formatted String Binding

6.2 書式化文字列バインディング

The formatted string binding is new to CPE version 2.3. In keeping with the spirit of the v2.2 specification, the formatted string binding looks similar to the URI binding; however, it is defined simply to be a “formatted string” rather than a URI in order to relax the requirements that typically apply to URIs as specified in [RFC3986].

書式化文字列バインディングは、CPE バージョン 2.3 で新たに導入されたものです。v2.2 仕様の精神に沿って、書式化文字列バインディングは URI バインディングに似ていますが、[RFC3986] で規定されているとおり、通常 URI に適用される要件を緩和するため、URI ではなく単に「書式化文字列」として定義されています。

The formatted string binding is a colon-delimited list of fields prefixed with the string "cpe:2.3:". Use of a prefix distinct from the v2.2 URI binding enables tools to inspect a given input string and use a simple syntactic test to determine whether to process the input as a URI or as a formatted string. The formal syntax of the formatted string binding is presented in ABNF in Section 6.2.1.

書式化文字列バインディングは、文字列 "cpe:2.3:" を前に付けた、コロン区切りのフィールドのリストです。v2.2 の URI バインディングとは異なるプレフィックスを使うことで、ツールは、与えられた入力文字列を調べ、単純な構文テストによって、その入力を URI として処理するか書式化文字列として処理するかを判断できます。書式化文字列バインディングの正式な構文は、第 6.2.1 節で ABNF により示します。

Similar to the URI binding, the formatted string binds the attributes in a WFN in a fixed order, separated by the colon character:

URI バインディングと同様に、書式化文字列は WFN の属性を、コロン文字で区切って、固定の順序でバインドします。

cpe:2.3: part : vendor : product : version : update : edition :
       language : sw_edition : target_sw : target_hw : other
原文のみ

In a formatted string binding, the alphanumeric characters plus hyphen (“-”), period (“.”) and underscore (“_”) appear unquoted. When used alone, the asterisk (“*”) represents the logical value ANY, and the hyphen (“-”) represents the logical value NA. All other non-alphanumeric characters, if used, MUST be quoted (preceded by the backslash). The special characters asterisk and question mark may appear without quoting, in which case they are open to special interpretation by other CPE specifications. Note that all eleven (11) attribute values MUST appear in the formatted string binding.

書式化文字列バインディングでは、英数字に加えて、ハイフン(「-」)、ピリオド(「.」)、アンダースコア(「_」)がクォートなしで現れます。アスタリスク(「*」)は単独で使用された場合、論理値 ANY を表し、ハイフン(「-」)は論理値 NA を表します。その他の英数字以外の文字は、使用する場合、すべてクォートされなければなりません(MUST)(前にバックスラッシュを付けます)。特殊文字であるアスタリスクとクエスチョンマークはクォートなしで現れてもよく、その場合、他の CPE 仕様による特別な解釈の対象となります。11 個すべての属性値が書式化文字列バインディングに現れなければなりません(MUST)。

6.2.1 Syntax for Formatted String Binding
6.2.1 書式化文字列バインディングの構文

The syntax of the formatted string binding is shown in Figure 6-3.

書式化文字列バインディングの構文を図 6-3 に示します。

formstring      = "cpe:2.3:" component-list

component-list  = part ":" vendor ":" product ":" version ":" update ":"
edition ":" lang ":" sw_edition ":" target_sw ":"
                  target_hw ":" other

part      = "h" / "o" / "a" / logical
vendor     = avstring
product     = avstring
version     = avstring
update     = avstring
edition     = avstring
lang      = LANGTAG / logical
sw_edition     = avstring
target_sw     = avstring
target_hw     = avstring
other      = avstring
avstring     = *1spec_chrs 1*( unreserved / quoted ) *1spec_chrs / logical
spec_chrs       = 1*spec1 / spec2
logical     = "*" / "-"
special     = spec1 / spec2
spec1           = "?"
spec2           = "*"
unreserved     = ALPHA / DIGIT / "-" / "." / "_"
quoted     = escape (escape / special / punc)
escape          = "\"
punc        = "!" / DQUOTE / "#" / "$" / "%" / "&" / "'" / "(" / ")" /
                  "+" / "," / "/" / ":" / ";" / "<" / "=" / ">" / "@" /
                  "[" / "]" / "^" / "`" / "{" / "|" / "}" / "~"
ALPHA           = %x41-5a / %x61-7A   ; a-z
DIGIT      = %x30-39  ; 0-9
DQUOTE     = %x22  ; double-quote
LANGTAG     = language ["-" region] ; cf. [RFC5646]
language        = 2*3ALPHA              ; shortest ISO 639 code
region          = 2ALPHA / 3DIGIT       ; ISO 3166-1 code or UN M.49 code
原文のみ

Figure 6-3. ABNF for Formatted String Binding

図 6-3. 書式化文字列バインディングの ABNF

6.2.2 Binding a WFN to a formatted string
6.2.2 WFN の書式化文字列へのバインド

This section specifies the procedure that SHALL be followed when binding a WFN to a formatted string. Section 6.2.2.1 summarizes the algorithm in prose. Section 6.2.2.2 presents the pseudocode for the algorithm. Section 6.2.2.3 presents examples illustrating the results of binding various WFNs to formatted strings.

この節では、WFN を書式化文字列にバインドする際に従わなければならない(SHALL)手順を規定します。第 6.2.2.1 節では、アルゴリズムを散文で要約します。第 6.2.2.2 節では、アルゴリズムの擬似コードを示します。第 6.2.2.3 節では、さまざまな WFN を書式化文字列にバインドした結果を示す例を示します。

It is OPTIONAL for implementations of formatted string binding to follow the pseudocode, processes, and other non-normative information provided in this section. However, the result of an implementation performing a formatted string binding MUST produce the same result as the suggested pseudocode, processes, etc. would produce.

書式化文字列バインディングの実装が、この節で示す擬似コード、処理、その他の非規範的な情報に従うことは、任意(OPTIONAL)です。ただし、書式化文字列バインディングを実行する実装の結果は、提案された擬似コード、処理などが生成する結果と同じ結果を生成しなければなりません(MUST)。

6.2.2.1 Summary of algorithm
6.2.2.1 アルゴリズムの要約

The procedure iterates over the eleven allowed attributes in a fixed order. Corresponding attribute values are obtained from the input WFN and conversions of logical values are applied. A result string is formed by concatenating the attribute values separated by colons.

この手順は、許可されている 11 個の属性を固定の順序で順に処理します。入力の WFN から対応する属性値を取得し、論理値の変換を適用します。属性値をコロンで区切って連結することで、結果の文字列を作成します。

6.2.2.2 Pseudocode for algorithm
6.2.2.2 アルゴリズムの擬似コード
function bind_to_fs(w)
  ;; Top-level function used to bind WFN w to formatted string.
  ;; Initialize the output with the CPE v2.3 string prefix.
  fs := "cpe:2.3:".
  foreach a in {part,vendor,product,version,update,edition,language,
                sw_edition,target_sw,target_hw,other}
    do
      v := bind_value_for_fs(get(w,a)).
      fs := strcat(fs,v).
      ;; add a colon except at the very end
      if (a != other) then fs := strcat(fs,":").
  end.
  return fs.
end.

function bind_value_for_fs(v)
  ;; Convert the value v to its proper string representation for
  ;; insertion into the formatted string.
  case v:
    ANY: return("*").
    NA: return("-").
    else: return process_quoted_chars(v).
  end.
end.

function process_quoted_chars(s)
  ;; Inspect each character in string s. Certain nonalpha
  ;; characters pass thru without escaping into the result,
  ;; but most retain escaping.
  result := "".
  idx := 0.
  while (idx < strlen(s))
    do
      c := substr(s,idx,idx).  ; get the idx’th character of s.
      if c != "\"
        then
          ;; unquoted characters pass thru unharmed
          result := strcat(result,c).
        else
          ;; Escaped characters are examined
          nextchr := substr(s,idx+1,idx+1).
          case nextchr:
            ;; the period, hyphen and underscore pass unharmed.
            ".":
            "-":
            "_": result := strcat(result,nextchr).
                 idx = idx + 2.
            else:
              ;; all others retain escaping
              result := strcat(result,"\",nextchr).
              idx := idx + 2.
              continue.
          end.
      endif.
      idx := idx + 1.
  end.
  return result.
end.
原文のみ
6.2.2.3 Examples of binding a WFN to a formatted string
6.2.2.3 WFN の書式化文字列へのバインド例

This section presents examples illustrating the results of binding various WFNs to formatted strings.

この節では、さまざまな WFN を書式化文字列にバインドした結果を示す例を示します。

6.2.2.3.1 Example 1
6.2.2.3.1 例 1

Suppose one had created the WFN below to describe this product: Microsoft Internet Explorer 8.0.6001 Beta (any edition):

次の製品を記述するために、以下の WFN を作成したとします。Microsoft Internet Explorer 8.0.6001 Beta(任意の edition):

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.0\.6001",update="beta",edition=ANY]
原文のみ

This WFN binds to the following formatted string:

この WFN は、次の書式化文字列にバインドされます。

cpe:2.3:a:microsoft:internet_explorer:8.0.6001:beta:*:*:*:*:*:*
原文のみ

Note how the unspecified attributes bind to “*” in the formatted string binding.

未指定の属性が、書式化文字列バインディングでは「*」にバインドされることに注目してください。

6.2.2.3.2 Example 2
6.2.2.3.2 例 2

Suppose one had created the WFN below to describe this product: Microsoft Internet Explorer 8.* SP? (any edition):

次の製品を記述するために、以下の WFN を作成したとします。Microsoft Internet Explorer 8.* SP?(任意のエディション):

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.*",update="sp?",edition=ANY]
原文のみ

This WFN binds to the following formatted string:

この WFN は、次の書式化文字列にバインドされます。

cpe:2.3:a:microsoft:internet_explorer:8.*:sp?:*:*:*:*:*:*
原文のみ

Note how the unspecified attributes default to ANY and are thus bound to “*”. Also note how the unquoted special characters in the WFN are carried over into the formatted string. Their special functionality in the WFN is preserved in the binding. If it was desired to block the special interpretation of the asterisk, it should be preceded by the escape character in the WFN:

未指定の属性が既定で ANY となり、したがって「*」にバインドされることに注目してください。また、WFN 内のクォートされていない特殊文字が書式化文字列にそのまま引き継がれることにも注目してください。WFN での特別な機能は、バインディングでも保持されます。アスタリスクの特別な解釈を妨げたい場合は、WFN 内でアスタリスクの前にエスケープ文字を置くべきです。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.\*",update="sp?"]
原文のみ

This WFN binds to the following formatted string:

この WFN は、次の書式化文字列にバインドされます。

cpe:2.3:a:microsoft:internet_explorer:8.\*:sp?:*:*:*:*:*:*
原文のみ

In this case, the escape character appears explicitly in the binding, blocking the interpretation of the asterisk. The unquoted question mark retains any special interpretation it may have in the binding.

この場合、エスケープ文字がバインディングに明示的に現れ、アスタリスクの解釈を妨げます。クォートされていないクエスチョンマークは、バインディングにおいても、それが持つ可能性のある特別な解釈を保持します。

6.2.2.3.3 Example 3
6.2.2.3.3 例 3

Suppose one had created the WFN below to describe this product: HP Insight 7.4.0.1570 Online Edition for Windows 2003 x64:

次の製品を記述するために、以下の WFN を作成したとします。HP Insight 7.4.0.1570 Online Edition for Windows 2003 x64:

wfn:[part="a",vendor="hp",product="insight",
version="7\.4\.0\.1570",update=NA,
sw_edition="online",target_sw="win2003",target_hw="x64"]
原文のみ

This WFN binds to the following formatted string:

この WFN は、次の書式化文字列にバインドされます。

cpe:2.3:a:hp:insight:7.4.0.1570:-:*:*:online:win2003:x64:*
原文のみ

Notice how the NA binds to the lone hyphen, the unspecified edition, language and other all bind to the asterisk, and the extended attributes appear in their own fields.

NA が単独のハイフンにバインドされること、未指定の edition、language、other がすべてアスタリスクにバインドされること、拡張属性がそれぞれ専用のフィールドに現れることに注目してください。

6.2.2.3.4 Example 4
6.2.2.3.4 例 4

Suppose one had created the WFN below to describe this product: HP OpenView Network Manager 7.51 (any update) for Linux:

次の製品を記述するために、以下の WFN を作成したとします。HP OpenView Network Manager 7.51(任意のアップデート)、Linux 用:

wfn:[part="a",vendor="hp",product="openview_network_manager",
version="7\.51",target_sw="linux"]
原文のみ

This WFN binds to the following formatted string:

この WFN は、次の書式化文字列にバインドされます。

cpe:2.3:a:hp:openview_network_manager:7.51:*:*:*:*:linux:*:*
原文のみ

Note how the unspecified attributes update, edition, language, sw_edition, target_hw, and other each bind to an asterisk in the formatted string.

未指定の属性である update、edition、language、sw_edition、target_hw、other が、書式化文字列内でそれぞれアスタリスクにバインドされることに注目してください。

6.2.2.3.5 Example 5
6.2.2.3.5 例 5

Suppose one had created the WFN below to describe this product: Foo\Bar Big$Money 2010 Special Edition for iPod Touch 80GB:

次の製品を記述するために、以下の WFN を作成したとします。Foo\Bar Big$Money 2010 Special Edition for iPod Touch 80GB:

wfn:[part="a",vendor="foo\\bar",product="big\$money_2010",
sw_edition="special",target_sw="ipod_touch",target_hw="80gb"]
原文のみ

This WFN binds to the following formatted string:

この WFN は、次の書式化文字列にバインドされます。

cpe:2.3:a:foo\\bar:big\$money_2010:*:*:*:*:special:ipod_touch:80gb:*
原文のみ

Note how the \\ and \$ carry over into the binding, and how all the other unspecified attributes bind to the asterisk.

\\ と \$ がバインディングにそのまま引き継がれること、またその他の未指定の属性がすべてアスタリスクにバインドされることに注目してください。

6.2.3 Unbinding a formatted string to a WFN
6.2.3 書式化文字列の WFN へのアンバインド

Given a formatted string binding, the procedure that SHALL be followed to unbind it to a WFN is specified in pseudocode below. The top-level unbinding function, unbind_fs, is called with the formatted string to be unbound as its only argument. The pseudocode references the defined operations on WFNs (cf. 5.4) as well as a number of helper functions also defined in pseudocode. Section 6.2.3.1 summarizes the algorithm in prose. Section 6.2.3.2 provides the pseudocode for the algorithm. Section 6.2.3.3 provides examples of unbinding formatted strings to WFNs.

書式化文字列バインディングが与えられたとき、それを WFN にアンバインドするために従わなければならない(SHALL)手順を、以下の擬似コードに示します。最上位のアンバインド関数 unbind_fs は、アンバインドする書式化文字列だけを引数として呼び出します。この擬似コードは、WFN に対して定義された操作(cf. 5.4)と、同じく擬似コードで定義された複数の補助関数を参照します。第 6.2.3.1 節では、アルゴリズムを散文で要約します。第 6.2.3.2 節では、アルゴリズムの擬似コードを示します。第 6.2.3.3 節では、書式化文字列を WFN にアンバインドする例を示します。

It is OPTIONAL for implementations of formatted string unbinding to follow the pseudocode, processes, and other non-normative information provided in this section. However, the result of an implementation performing a formatted string unbinding MUST produce the same result as the suggested pseudocode, processes, etc. would produce.

書式化文字列アンバインディングの実装が、この節で示す擬似コード、処理、その他の非規範的な情報に従うことは、任意(OPTIONAL)です。ただし、書式化文字列アンバインディングを実行する実装の結果は、提案された擬似コードや処理などが生成する結果と同じ結果を生成しなければなりません(MUST)。

6.2.3.1 Summary of algorithm
6.2.3.1 アルゴリズムの要約

Unbinding a formatted string is straightforward, since the attribute values are encoded explicitly and in a fixed left-to-right order in the binding, delimited by colons. (Because a colon may appear embedded in a value string if preceded by the escape character, the parsing function needs to ignore escaped colons.) The algorithm parses the eleven fields of the formatted string, then unbinds each string result. If a field contains only an asterisk, it is unbound to the logical value ANY. If a field contains only a hyphen, it is unbound to the logical value NA. Quoting of non-alphanumeric characters is restored as needed, but the two special characters (asterisk and question mark) are permitted to appear without a preceding escape character. The unbinding procedure performs limited error checking, only ensuring that unquoted special characters adhere to syntax requirements specified in Figure 5-1.

書式化文字列のアンバインドは単純です。これは、属性値がバインディング内で、コロンで区切られ、明示的かつ左から右への固定の順序でエンコードされているためです。(コロンは、前にエスケープ文字が付いていれば値文字列に埋め込まれて現れる場合があるため、解析関数はエスケープされたコロンを無視する必要があります。)このアルゴリズムは、書式化文字列の 11 個のフィールドを解析し、次に各文字列の結果をアンバインドします。フィールドがアスタリスクのみを含む場合は、論理値 ANY にアンバインドされます。フィールドがハイフンのみを含む場合は、論理値 NA にアンバインドされます。英数字以外の文字のクォートは必要に応じて復元されますが、2 つの特殊文字(アスタリスクとクエスチョンマーク)は、前にエスケープ文字がなくても現れることが許されています。アンバインド手順は限定的なエラーチェックを行い、クォートされていない特殊文字が図 5-1 に規定された構文要件に従っていることのみを確認します。

6.2.3.2 Pseudocode for algorithm
6.2.3.2 アルゴリズムの擬似コード
function unbind_fs(fs)
  ;; Top-level function to unbind a formatted string fs to a wfn.
  result := new().
  ;; NB: the cpe scheme is the 0th component, the cpe version is the
  ;; 1st. So we start parsing at the 2nd component.
  for a = 2 to 12
    do
      v := get_comp_fs(fs,a). ; get the a’th field string
      v := unbind_value_fs(v). ; unbind the string
      ;; set the value of the corresponding attribute.
      case a:
        2: result := set(result,part,v).
        3: result := set(result,vendor,v).
        4: result := set(result,product,v).
        5: result := set(result,version,v).
        6: result := set(result,update,v).
        7: result := set(result,edition,v).
        8: result := set(result,language,v).
        9: result := set(result,sw_edition,v).
       10: result := set(result,target_sw,v).
       11: result := set(result,target_hw,v).
       12: result := set(result,other,v).
      end.
  end.
  return result.
end.

function get_comp_fs(fs,i)
  ;; Return the i’th field of the formatted string.  If i=0,
  ;; return the string to the left of the first forward slash.
  ;; The colon is the field delimiter unless prefixed by a
  ;; backslash.
  ;; For example, given the formatted string:
  ;; cpe:2.3:a:foo:bar\:mumble:1.0:*:…
  ;; get_comp_fs(fs,0) = "cpe"
  ;; get_comp_fs(fs,1) = "2.3"
  ;; get_comp_fs(fs,2) = "a"
  ;; get_comp_fs(fs,3) = "foo"
  ;; get_comp_fs(fs,4) = "bar\:mumble"
  ;; get_comp_fs(fs,5) = "1.0"
  ;; etc.
end.

function unbind_value_fs(s)
  ;; Takes a string value s and returns the appropriate logical
  ;; value if s is the bound form of a logical value. If s is some
  ;; general value string, add quoting of non-alphanumerics as
  ;; needed.
  case s:
    "*": return ANY.
    "-": return NA.
    else:
      ;; add quoting to any unquoted non-alphanumeric characters,
      ;; but leave the two special characters alone, as they may
      ;; appear quoted or unquoted.
      return add_quoting(s).
  end.
end.

function add_quoting(s)
  ;; Inspect each character in string s. Copy quoted characters,
  ;; with their escaping, into the result. Look for unquoted non
  ;; alphanumerics and if not "*" or "?", add escaping.
  result := "".
  idx := 0.
  embedded := false.
  while (idx < strlen(s))
    do
      c := substr(s,idx,idx).  ; get the idx’th character of s.
      if (is_alphanum(c) or c = "_") then
        ;; Alphanumeric characters pass untouched.
        result := strcat(result,c).
        idx := idx + 1.
        embedded := true.
        continue.
      endif.
      if c = "\" then
        ;; Anything quoted in the bound string stays quoted
        ;; in the unbound string.
        result := strcat(result,substr(s,idx,idx+1)).
        idx := idx + 2.
        embedded := true.
        continue.
      endif.
      if (c = "*") then
        ;; An unquoted asterisk must appear at the beginning or
        ;; end of the string.
        if (idx = 0 or idx = (strlen(s)-1)) then
          result := strcat(result,c).
          idx := idx + 1.
          embedded := true.
          continue.
        else error.
      endif.
      if (c = "?") then
        ;; An unquoted question mark must appear at the beginning or
        ;; end of the string, or in a leading or trailing sequence.
        if ;; ? legal at beginning or end
           (((idx = 0) or (idx = (strlen(s)-1))) or
            ;; embedded is false, so must be preceded by ?
            (!embedded and (substr(s,idx-1,idx-1) = "?")) or
            ;; embedded is true, so must be followed by ?
            (embedded and (substr(s,idx+1,idx+1) = "?"))) then
          result := strcat(result,c).
          idx := idx + 1.
          embedded := false.
          continue.
        else error.
      endif.
      ;; all other characters must be quoted
      result := strcat(result,"\",c).
      idx := idx + 1.
      embedded := true.
  end.
  return result.
end.
原文のみ
6.2.3.3 Examples of unbinding a formatted string to a WFN
6.2.3.3 書式化文字列の WFN へのアンバインド例

This section provides a number of examples illustrating the results of unbinding a formatted string to a WFN.

この節では、書式化文字列を WFN にアンバインドした結果を示す例を多数示します。

6.2.3.3.1 Example 1
6.2.3.3.1 例 1

FS: cpe:2.3:a:microsoft:internet_explorer:8.0.6001:beta:*:*:*:*:*:*

FS: cpe:2.3:a:microsoft:internet_explorer:8.0.6001:beta:*:*:*:*:*:*

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.0\.6001",update="beta",edition=ANY,language=ANY,
sw_edition=ANY,target_sw=ANY,target_hw=ANY,other=ANY]
原文のみ

Notice how the periods in the version string are quoted in the WFN, and all the asterisks are unbound to the logical value ANY.

バージョン文字列内のピリオドが WFN ではクォートされること、またすべてのアスタリスクが論理値 ANY にアンバインドされることに注目してください。

6.2.3.3.2 Example 2
6.2.3.3.2 例 2

FS: cpe:2.3:a:microsoft:internet_explorer:8.*:sp?:*:*:*:*:*:*

FS: cpe:2.3:a:microsoft:internet_explorer:8.*:sp?:*:*:*:*:*:*

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="microsoft",product="internet_explorer",
version="8\.*",update="sp?",edition=ANY,language=ANY,
sw_edition=ANY,target_sw=ANY,target_hw=ANY,other=ANY]
原文のみ

Note how the embedded special characters are unbound untouched in the WFN.

埋め込まれた特殊文字が、WFN にそのままアンバインドされることに注目してください。

6.2.3.3.3 Example 3
6.2.3.3.3 例 3

FS: cpe:2.3:a:hp:insight_diagnostics:7.4.0.1570:-:*:*:online:win2003:x64:*

FS: cpe:2.3:a:hp:insight_diagnostics:7.4.0.1570:-:*:*:online:win2003:x64:*

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="hp",product="insight_diagnostics",
version="7\.4\.0\.1570",update=NA,edition=ANY,language=ANY,
sw_edition="online",target_sw="win2003",target_hw="x64",
other=ANY]
原文のみ

Note how the lone hyphen in the update field unbinds to the logical value NA, and how the lone asterisks unbind to the logical value ANY.

update フィールド内の単独のハイフンが論理値 NA にアンバインドされること、また単独のアスタリスクが論理値 ANY にアンバインドされることに注目してください。

Contrast the above example with the modified version below:

上の例を、以下の変更版と比較してください。

FS: cpe:2.3:a:hp:insight_diagnostics:7.4.*.1570:*:*:*:*:*:*

FS: cpe:2.3:a:hp:insight_diagnostics:7.4.*.1570:*:*:*:*:*:*

This raises an error during unbinding, due to the embedded unquoted asterisk in the version attribute.

version 属性内に、クォートされていないアスタリスクが埋め込まれているため、アンバインド時にエラーが発生します。

6.2.3.3.4 Example 4
6.2.3.3.4 例 4

FS: cpe:2.3:a:foo\\bar:big\$money:2010:*:*:*:special:ipod_touch:80gb:*

FS: cpe:2.3:a:foo\\bar:big\$money:2010:*:*:*:special:ipod_touch:80gb:*

Unbinds to this WFN:

次の WFN にアンバインドされます。

wfn:[part="a",vendor="foo\\bar",product="big\$money",
version="2010",update=ANY,edition=ANY,language=ANY,
sw_edition="special",target_sw="ipod_touch",target_hw="80gb",
other=ANY]
原文のみ

Note how the quoted special characters retain their quoting in the WFN.

クォートされた特殊文字が、WFN でもクォートを保持することに注目してください。

7. Bound Name Conversions

7. バインド済み名前の変換

This section specifies the procedures that SHOULD be followed when converting between the two required bound forms of WFNs. Section 7.1 specifies the procedure for converting a URI binding to a formatted string binding, and Section 7.2 specifies the inverse conversion. Both conversions are round-trip safe, meaning that taking one of the two bound forms, converting it to the other form, then converting that back to the original binding form, will result in the original binding.

この節では、WFN の 2 つの必須のバインド済み形式の間で変換する際に従うべき手順を規定します(SHOULD)。第 7.1 節では、URI バインディングを書式化文字列バインディングに変換する手順を規定し、第 7.2 節では、その逆の変換を規定します。どちらの変換も往復変換で安全です。これは、2 つのバインド済み形式の一方を取り、もう一方の形式に変換し、さらにそれを元のバインディング形式に変換し戻すと、元のバインディングが得られることを意味します。

7.1 Converting a URI to a Formatted String

7.1 URI から書式化文字列への変換

Given a URI u which conforms to the CPE v2.2 specification, the procedure for converting it to a formatted string fs has two steps:

CPE v2.2 仕様に適合する URI u が与えられたとき、それを書式化文字列 fs に変換する手順は 2 つのステップからなります。

function convert_uri_to_fs(u)
  w := unbind_uri(u).
  fs := bind_to_fs(w).
  return fs.
end.
原文のみ

7.2 Converting a Formatted String to a URI

7.2 書式化文字列から URI への変換

Given a formatted string fs which conforms to the description in Section 6.2.2, the procedure for converting it to a URI has two steps:

第 6.2.2 節の記述に適合する書式化文字列 fs が与えられたとき、それを URI に変換する手順は 2 つのステップからなります。

function convert_fs_to_uri(fs)
  w := unbind_fs(fs).
  uri := bind_to_uri(w).
  return uri.
end.
原文のみ

Appendix A—References

付録 A—参考文献

The following documents are indispensable references for understanding the application of this specification.

次の文書は、この仕様の適用を理解するために欠かせない参考文献です。

A.1 Normative References

A.1 規範的参考文献

[CPE22] Buttner, A. and N. Ziring, Common Platform Enumeration (CPE)—Specification, Version 2.2, March 11, 2009. See http://cpe.mitre.org/specification/archive/version2.2/cpe-specification_2.2.pdf.

[CPE22] Buttner, A. and N. Ziring, Common Platform Enumeration (CPE)—Specification, Version 2.2, March 11, 2009. 参照: http://cpe.mitre.org/specification/archive/version2.2/cpe-specification_2.2.pdf.

[RFC2119] Bradner, S. (1997). Key words for use in RFCs to Indicate Requirement Levels. March 1997. See http://www.ietf.org/rfc/rfc2119.txt.

[RFC2119] Bradner, S. (1997). Key words for use in RFCs to Indicate Requirement Levels. March 1997. 参照: http://www.ietf.org/rfc/rfc2119.txt.

[RFC2234] Crocker, D. and P. Overell. (1997). Augmented BNF for Syntax Specifications: ABNF. Internet RFC 2234, November 1997. See http://www.ietf.org/rfc/rfc2234.txt.

[RFC2234] Crocker, D. and P. Overell. (1997). Augmented BNF for Syntax Specifications: ABNF. Internet RFC 2234, November 1997. 参照: http://www.ietf.org/rfc/rfc2234.txt.

[RFC3629] Yergeau, F. (2003). UTF-8, a transformation format of ISO 10646. Internet RFC 3629, November 2003. See http://www.ietf.org/rfc/rfc3629.txt.

[RFC3629] Yergeau, F. (2003). UTF-8, a transformation format of ISO 10646. Internet RFC 3629, November 2003. 参照: http://www.ietf.org/rfc/rfc3629.txt.

[RFC3986] Berners-Lee, T., Fielding, R. and L. Masinger. (2005). Uniform Resource Identifier (URI): Generic Syntax. Internet RFC 3986, January 2005. See http://www.ietf.org/rfc/rfc3986.txt.

[RFC3986] Berners-Lee, T., Fielding, R. and L. Masinger. (2005). Uniform Resource Identifier (URI): Generic Syntax. Internet RFC 3986, January 2005. 参照: http://www.ietf.org/rfc/rfc3986.txt.

[RFC5646] Phillips, A. and M. Davis. (2009). Tags for Identifying Languages. RFC 5646, September 2009. See http://www.ietf.org/rfc/rfc5646.txt.

[RFC5646] Phillips, A. and M. Davis. (2009). Tags for Identifying Languages. RFC 5646, September 2009. 参照: http://www.ietf.org/rfc/rfc5646.txt.

A.2 Informative References

A.2 参考情報の文献

[ISO19770-2] ISO/IEC 19770-2. (2009). Software Identification Tag. November 2009. See http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=53670.

[ISO19770-2] ISO/IEC 19770-2. (2009). Software Identification Tag. November 2009. 参照: http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=53670.

[Silberschatz] Silberschatz, A., Peterson, J. L., and Galvin, P. B. Operating System Concepts—Third Edition. Reading, MA: Addison-Wesley, 1991.

[Silberschatz] Silberschatz, A., Peterson, J. L., and Galvin, P. B. Operating System Concepts—Third Edition. Reading, MA: Addison-Wesley, 1991.

[SP800-117] Quinn, S., Scarfone, K., Barrett, M., and Johnson, C., NIST Special Publication 800-117, Guide to Adopting and Using the Security Content Automation Protocol, July 2010. See http://csrc.nist.gov/publications/PubsSPs.html#800-117.

[SP800-117] Quinn, S., Scarfone, K., Barrett, M., and Johnson, C., NIST Special Publication 800-117, Guide to Adopting and Using the Security Content Automation Protocol, July 2010. 参照: http://csrc.nist.gov/publications/PubsSPs.html#800-117.

[SP800-126] Waltermire, D., Quinn, S., Scarfone, K., and Halbardier, A., NIST Special Publication 800-126 Revision 2, The Technical Specification for the Security Content Automation Protocol (SCAP): SCAP Version 1.2, July 2011. See http://csrc.nist.gov/publications/PubsSPs.html#800-126.

[SP800-126] Waltermire, D., Quinn, S., Scarfone, K., and Halbardier, A., NIST Special Publication 800-126 Revision 2, The Technical Specification for the Security Content Automation Protocol (SCAP): SCAP Version 1.2, July 2011. 参照: http://csrc.nist.gov/publications/PubsSPs.html#800-126.

[TUCA] Common Platform Enumeration (CPE) Technical Use Case Analysis, The MITRE Corporation, November 2008. See http://cpe.mitre.org/about/use_cases.html.

[TUCA] Common Platform Enumeration (CPE) Technical Use Case Analysis, The MITRE Corporation, November 2008. 参照: http://cpe.mitre.org/about/use_cases.html.

Appendix B—Change Log

付録 B—変更履歴

Release 0 – 9 June 2010

リリース 0 – 2010 年 6 月 9 日

•Initial draft specification released to the CPE community as a read ahead for the CPE Developer Days Workshop.

•CPE Developer Days Workshop の事前資料として、初期ドラフトの仕様を CPE コミュニティに公開しました。

Release 1 – 23 June 2010

リリース 1 – 2010 年 6 月 23 日

•Minor edits to audience description.

•対象読者の説明に軽微な編集を加えました。

•Minor editorial changes throughout the document.

•文書全体に軽微な編集上の変更を加えました。

•In section on Conformance, added a requirement that claims of conformance be made explicit in product documentation. Modified the third clause to allow conformers to "produce and/or consume", that is, an "and" became an "and/or", since some applications only need to produce and others only need to consume. Relaxed the requirement to consume legacy CPE names from a MUST to a SHOULD, since some applications may have no need to consume legacy content.

•適合性の節で、適合の主張を製品の文書に明示することを求める要件を追加しました。3 つ目の項を変更し、適合を主張する実装が「生成および/または利用」できるようにしました。すなわち、「および」を「および/または」としました。これは、生成のみが必要なアプリケーションと、利用のみが必要なアプリケーションがあるためです。従来の CPE 名を利用するという要件を MUST から SHOULD に緩和しました。これは、従来のコンテンツを利用する必要がないアプリケーションがあるためです。

•Added an ABNF grammar to define character strings permitted as attribute values in WFNs.

•WFN の属性値として許可される文字列を定義するために、ABNF 文法を追加しました。

•Switched to using the words/phrases "to quote" and "quoting" in place of "to escape" and "escaping" when referring to use of the escape character, to be more consistent with standard regular expression usage.

•エスケープ文字の使用に言及する際に、標準的な正規表現での用法とより整合させるため、「エスケープする」「エスケープ」の代わりに「クォートする」「クォート」という語句を使うようにしました。

•Removed all mention of and support for the logical value UNKNOWN.

•論理値 UNKNOWN への言及とサポートをすべて削除しました。

•Clarified the view that the logical value NA should also be used if an attribute value is assessed to be null.

•属性値が null と評価される場合にも論理値 NA を使うべきであるという見解を明確にしました。

Release 2 – 22 April 2011

リリース 2 – 2011 年 4 月 22 日

•Reorganized the sequence of several sections and sub-sections.

•いくつかの節と小節の順序を並べ替えました。

•Narrowed the specification of the permitted character set for attribute-value strings.

•属性値文字列に許可される文字集合の規定を絞り込みました。

•Restricted the use of special characters to the beginning and/or end of attribute-value strings.

•特殊文字の使用を、属性値文字列の先頭および/または末尾に限定しました。

•Clarified the specification of percent-encoding in the URI binding.

•URI バインディングにおけるパーセントエンコードの規定を明確にしました。

•Changed the prefix of the formatted string binding from "cpe23:" to "cpe:2.3:".

•書式化文字列バインディングのプレフィックスを "cpe23:" から "cpe:2.3:" に変更しました。

•Added support for binding special characters into the URI by re-purposing the otherwise- proscribed "%00" and "%01" percent-encoding forms.

•本来は禁止されている "%00" と "%01" のパーセントエンコード形式を転用することで、特殊文字を URI にバインドする機能のサポートを追加しました。

•Revised pseudocode to support new features (percent encoding and decoding, binding and unbinding of special characters).

•新機能(パーセントエンコードとデコード、特殊文字のバインドとアンバインド)をサポートするように擬似コードを改訂しました。

•Ensured that uppercase letters are transformed to lowercase in unbind_URI.

•unbind_URI で、大文字が小文字に変換されることを確実にしました。

•Added and revised examples for consistency.

•整合性のために例を追加および改訂しました。

•Minor editorial changes throughout the document.

•文書全体に軽微な編集上の変更を加えました。

•Added a reference to a new XML schema that defines the acceptable CPE bound name formats.

•受け入れ可能な CPE バインド済み名前の形式を定義する、新しい XML スキーマへの参照を追加しました。

Release 3 – 11 July 2011

リリース 3 – 2011 年 7 月 11 日

•Clarified guidelines on use of legacy edition attribute.

•レガシー edition 属性の使用に関するガイドラインを明確にしました。

•Bugfixes to pseudocode for binding and unbinding.

•バインドとアンバインドの擬似コードのバグを修正しました。

•Changed the “%00” and “%01” forms to “%01” and “%02”, respectively, in response to community feedback.

•コミュニティからのフィードバックを受けて、「%00」と「%01」の形式を、それぞれ「%01」と「%02」に変更しました。

Release 4 – 30 August 2011

リリース 4 – 2011 年 8 月 30 日

•Final release of CPE Naming 2.3 specification.

•CPE Naming 2.3 仕様の最終リリース。

•Made minor editorial changes.

•軽微な編集上の変更を加えました。

•Clarified requirements involving attribute-specific valid-values lists.

•属性固有の有効値リストに関する要件を明確にしました。

•Explained that binding and unbinding implementations must achieve the same results as the provided pseudocode, processes, etc., but do not have to implement the pseudocode, processes, etc.

•バインドとアンバインドの実装は、提供された擬似コードや処理などと同じ結果を達成しなければなりませんが、その擬似コードや処理などを実装する必要はないことを説明しました。