RFC 7533 - Administration Protocol for Federated File Systems 日本語訳

原文URL : https://datatracker.ietf.org/doc/html/rfc7533
タイトル : RFC 7533 - 統合ファイルシステムの管理プロトコル
翻訳編集 : 自動生成

[要約] RFC 7533は、連邦ファイルシステムの管理プロトコルに関するものであり、要約すると、連邦ファイルシステムの管理と操作を効率化するためのプロトコルです。目的は、異なるファイルシステム間の統合と相互運用性を向上させることです。

Internet Engineering Task Force (IETF)                        J. Lentini
Request for Comments: 7533                                        NetApp
Category: Standards Track                                      R. Tewari
ISSN: 2070-1721                                              IBM Almaden
                                                           C. Lever, Ed.
                                                      Oracle Corporation
                                                              March 2015

Administration Protocol for Federated File Systems

統合ファイルシステムの管理プロトコル

Abstract

概要

This document describes the administration protocol for a federated file system (FedFS) that enables file access and namespace traversal across collections of independently administered fileservers. The protocol specifies a set of interfaces by which fileservers with different administrators can form a fileserver federation that provides a namespace composed of the file systems physically hosted on and exported by the constituent fileservers.

このドキュメントでは、独立して管理されているファイルサーバーのコレクション間でのファイルアクセスと名前空間トラバーサルを可能にする統合ファイルシステム（FedFS）の管理プロトコルについて説明します。プロトコルは、さまざまな管理者がいるファイルサーバーが、構成要素のファイルサーバーで物理的にホストされ、エクスポートされるファイルシステムで構成される名前空間を提供するファイルサーバーフェデレーションを形成できる一連のインターフェースを指定します。

Status of This Memo

本文書の状態

This is an Internet Standards Track document.

これはInternet Standards Trackドキュメントです。

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 5741.

このドキュメントは、IETF（Internet Engineering Task Force）の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ（IESG）による公開が承認されました。インターネット標準の詳細については、RFC 5741のセクション2をご覧ください。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc7533.

このドキュメントの現在のステータス、エラータ、およびフィードバックの提供方法に関する情報は、http：//www.rfc-editor.org/info/rfc7533で入手できます。

著作権表示

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

この文書は、BCP 78およびIETF文書に関するIETFトラストの法的規定（http://trustee.ietf.org/license-info）の対象であり、この文書の発行日に有効です。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、Trust Legal Provisionsのセクション4.eに記載されているSimplified BSD Licenseのテキストが含まれている必要があり、Simplified BSD Licenseに記載されているように保証なしで提供されます。

This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.

このドキュメントには、2008年11月10日より前に公開または公開されたIETFドキュメントまたはIETFコントリビューションの素材が含まれている場合があります。 IETF標準プロセス外。このような資料の著作権を管理する人から適切なライセンスを取得せずに、このドキュメントをIETF標準プロセス外で変更したり、その派生物をIETF標準プロセス外で作成したりすることはできません。 RFCとして、またはそれを英語以外の言語に翻訳するための出版物。

Table of Contents

   1. Introduction ....................................................4
      1.1. Definitions ................................................4
      1.2. Requirements Language ......................................6
   2. Protocol ........................................................7
   3. Error Values ...................................................12
   4. Data Types .....................................................15
      4.1. FedFsNsdbName Equality ....................................17
   5. Procedures .....................................................17
      5.1. FEDFS_NULL ................................................18
           5.1.1. Synopsis ...........................................18
           5.1.2. Description ........................................18
           5.1.3. Errors .............................................18
      5.2. FEDFS_CREATE_JUNCTION .....................................18
           5.2.1. Synopsis ...........................................18
           5.2.2. Description ........................................18
           5.2.3. Errors .............................................20
      5.3. FEDFS_DELETE_JUNCTION .....................................20
           5.3.1. Synopsis ...........................................20
           5.3.2. Description ........................................20
           5.3.3. Errors .............................................22
      5.4. FEDFS_LOOKUP_JUNCTION .....................................22
           5.4.1. Synopsis ...........................................22
           5.4.2. Description ........................................22
           5.4.3. Errors .............................................25
      5.5. FEDFS_CREATE_REPLICATION ..................................26
           5.5.1. Synopsis ...........................................26
           5.5.2. Description ........................................26
           5.5.3. Errors .............................................27
      5.6. FEDFS_DELETE_REPLICATION ..................................27
           5.6.1. Synopsis ...........................................27
           5.6.2. Description ........................................27
           5.6.3. Errors .............................................28
      5.7. FEDFS_LOOKUP_REPLICATION ..................................28
           5.7.1. Synopsis ...........................................28
           5.7.2. Description ........................................28
           5.7.3. Errors .............................................29
      5.8. FEDFS_SET_NSDB_PARAMS .....................................30
           5.8.1. Synopsis ...........................................30
           5.8.2. Description ........................................30
           5.8.3. Errors .............................................31
      5.9. FEDFS_GET_NSDB_PARAMS .....................................31
           5.9.1. Synopsis ...........................................31
           5.9.2. Description ........................................31
           5.9.3. Errors .............................................32
      5.10. FEDFS_GET_LIMITED_NSDB_PARAMS ............................32
           5.10.1. Synopsis ..........................................32

           5.10.2. Description .......................................32
           5.10.3. Errors ............................................33
   6. Security Considerations ........................................33
   7. IANA Considerations ............................................34
   8. References .....................................................34
      8.1. Normative References ......................................34
      8.2. Informative References ....................................35
   Acknowledgments ...................................................36
   Authors' Addresses ................................................37

1. Introduction

1. はじめに

A federated file system enables file access and namespace traversal in a uniform, secure, and consistent manner across multiple independent fileservers within an enterprise (and possibly across multiple enterprises) with reasonably good performance.

フェデレーテッドファイルシステムは、企業内の複数の独立したファイルサーバー間（および場合によっては複数の企業間）で均一で安全な一貫した方法でファイルアクセスとネームスペーストラバーサルを可能にし、適度なパフォーマンスを実現します。

Traditionally, building a namespace that spans multiple fileservers has been difficult for two reasons. First, the fileservers that export pieces of the namespace are often not in the same administrative domain. Second, there is no standard mechanism for the fileservers to cooperatively present the namespace. Fileservers might provide proprietary management tools, and in some cases, an administrator might be able to use the proprietary tools to build a shared namespace out of the exported file systems. Relying on vendor-proprietary tools does not work in larger enterprises or when collaborating across enterprises because it is likely that the system will contain fileservers running different software, each with their own protocols, with no common protocol to manage the namespace or exchange namespace information.

従来、複数のファイルサーバーにまたがる名前空間を構築することは、2つの理由で困難でした。まず、名前空間の一部をエクスポートするファイルサーバーは、多くの場合、同じ管理ドメインにありません。第2に、ファイルサーバーが協調的に名前空間を提示するための標準的なメカニズムはありません。ファイルサーバーは独自の管理ツールを提供する場合があり、場合によっては、管理者が独自のツールを使用して、エクスポートされたファイルシステムから共有名前空間を構築できることがあります。ベンダー独自のツールに依存することは、大企業では機能しません。また、企業間でコラボレーションする場合、システムには、それぞれ独自のプロトコルを備えたファイルサーバーが含まれ、名前空間を管理したり名前空間情報を交換したりするための共通のプロトコルはありません。

The requirements for federated namespaces are described in [RFC5716].

連合名前空間の要件は、[RFC5716]で説明されています。

The protocol for federated file systems described in [RFC7532] allows fileservers from different vendors and/or with different administrators to cooperatively build a namespace.

[RFC7532]で説明されているフェデレーションファイルシステムのプロトコルにより、さまざまなベンダーのファイルサーバーや、さまざまな管理者がファイルサーバーを共同で名前空間を構築できます。

This document describes the protocol used by administrators to configure the fileservers and construct the namespace.

このドキュメントでは、管理者がファイルサーバーを構成して名前空間を構築するために使用するプロトコルについて説明します。

1.1. Definitions

1.1. 定義

Administrator: A user with the necessary authority to initiate administrative tasks on one or more servers.

管理者：1つ以上のサーバーで管理タスクを開始するために必要な権限を持つユーザー。

Admin Entity: A server or agent that administers a collection of fileservers and persistently stores the namespace information.

管理エンティティ：ファイルサーバーのコレクションを管理し、名前空間情報を永続的に保存するサーバーまたはエージェント。

File-Access Client: Standard off-the-shelf, network-attached storage (NAS) client software that communicates with fileservers using a standard file-access protocol.

ファイルアクセスクライアント：標準のファイルアクセスプロトコルを使用してファイルサーバーと通信する、標準の既製のネットワーク接続ストレージ（NAS）クライアントソフトウェア。

Federation: A set of fileserver collections and singleton fileservers that use a common set of interfaces and protocols in order to provide to file-access clients a federated namespace accessible through a file system access protocol.

フェデレーション：ファイルシステムアクセスプロトコルを介してアクセス可能なフェデレーション名前空間をファイルアクセスクライアントに提供するために、共通のインターフェイスとプロトコルのセットを使用する一連のファイルサーバーコレクションとシングルトンファイルサーバー。

Fileserver: A server that stores physical fileset data or refers file-access clients to other fileservers. A fileserver provides access to its shared file system data via a file-access protocol.

ファイルサーバー：物理ファイルセットデータを保存するサーバー、またはファイルアクセスクライアントを他のファイルサーバーに参照させるサーバー。ファイルサーバーは、ファイルアクセスプロトコルを介して共有ファイルシステムデータへのアクセスを提供します。

Fileset: The abstraction of a set of files and the directory tree that contains them. A fileset is the fundamental unit of data management in the federation.

ファイルセット：ファイルのセットとそれらを含むディレクトリツリーの抽象化。ファイルセットは、連携におけるデータ管理の基本的な単位です。

Note that all files within a fileset are descendants of one directory and that filesets do not span file systems.

ファイルセット内のすべてのファイルは1つのディレクトリの子孫であり、ファイルセットはファイルシステムにまたがらないことに注意してください。

File System: A self-contained unit of export for a fileserver and the mechanism used to implement filesets. The fileset does not need to be rooted at the root of the file system, nor at the export point for the file system.

ファイルシステム：ファイルサーバーの自己完結型のエクスポート単位、およびファイルセットの実装に使用されるメカニズム。ファイルセットは、ファイルシステムのルートまたはファイルシステムのエクスポートポイントをルートにする必要はありません。

A single file system MAY implement more than one fileset, if the file-access protocol and the fileserver permit this.

単一のファイルシステムは、ファイルアクセスプロトコルとファイルサーバーで許可されている場合、複数のファイルセットを実装できます（MAY）。

File-Access Protocol: A network file system access protocol such as the Network File System (NFS) version 4 [RFC7530] or the Common Internet File System (CIFS) [MS-SMB] [MS-SMB2] [MS-CIFS].

ファイルアクセスプロトコル：Network File System（NFS）バージョン4 [RFC7530]やCommon Internet File System（CIFS）[MS-SMB] [MS-SMB2] [MS-CIFS]などのネットワークファイルシステムアクセスプロトコル。

FSL (Fileset Location): The location of the implementation of a fileset at a particular moment in time. An FSL MUST be something that can be translated into a protocol-specific description of a resource that a file-access client can access directly, such as an fs_locations attribute (for NFSv4) or a share name (for CIFS).

FSL（ファイルセットの場所）：特定の時点でのファイルセットの実装の場所。 FSLは、fs_locations属性（NFSv4の場合）または共有名（CIFSの場合）など、ファイルアクセスクライアントが直接アクセスできるリソースのプロトコル固有の説明に変換できるものである必要があります。

FSN (Fileset Name): A platform-independent and globally unique name for a fileset. Two FSLs that implement replicas of the same fileset MUST have the same FSN, and if a fileset is migrated from one location to another, the FSN of that fileset MUST remain the same.

FSN（ファイルセット名）：ファイルセットのプラットフォームに依存しないグローバルに一意の名前。同じファイルセットのレプリカを実装する2つのFSLは同じFSNを持つ必要があり、ファイルセットがある場所から別の場所に移行される場合、そのファイルセットのFSNは同じままである必要があります。

Junction: A file system object used to link a directory name in the current fileset with an object within another fileset. The server-side "link" from a leaf node in one fileset to the root of another fileset.

ジャンクション：現在のファイルセットのディレクトリ名を別のファイルセット内のオブジェクトとリンクするために使用されるファイルシステムオブジェクト。あるファイルセットのリーフノードから別のファイルセットのルートへのサーバー側「リンク」。

Namespace: A filename/directory tree that a sufficiently authorized file-access client can observe.

名前空間：十分に承認されたファイルアクセスクライアントが監視できるファイル名/ディレクトリツリー。

NSDB (Namespace Database) Service: A service that maps FSNs to FSLs. The NSDB may also be used to store other information, such as annotations for these mappings and their components.

NSDB（名前空間データベース）サービス：FSNをFSLにマップするサービス。 NSDBは、これらのマッピングとそのコンポーネントの注釈など、他の情報を格納するためにも使用できます。

NSDB Node: The name or location of a server that implements part of the NSDB service and is responsible for keeping track of the FSLs (and related information) that implement a given partition of the FSNs.

NSDBノード：NSDBサービスの一部を実装し、FSNの特定のパーティションを実装するFSL（および関連情報）を追跡するサーバーの名前または場所。

Referral: A server response to a file-access client access that directs the client to evaluate the current object as a reference to an object at a different location (specified by an FSL) in another fileset and possibly hosted on another fileserver. The client re-attempts the access to the object at the new location.

参照：ファイルアクセスクライアントアクセスに対するサーバーの応答。クライアントに、現在のオブジェクトを別のファイルセットの別の場所（FSLで指定）にあるオブジェクトへの参照として評価し、別のファイルサーバーでホストされている可能性があることを通知します。クライアントは、新しい場所でオブジェクトへのアクセスを再試行します。

Replica: A redundant implementation of a fileset. Each replica shares the same FSN but has a different FSL.

レプリカ：ファイルセットの冗長実装。各レプリカは同じFSNを共有しますが、FSLは異なります。

Replicas may be used to increase availability or performance. Updates to replicas of the same fileset MUST appear to occur in the same order; therefore, each replica is self-consistent at any moment.

レプリカを使用して、可用性またはパフォーマンスを向上させることができます。同じファイルセットのレプリカへの更新は、同じ順序で行われるように見える必要があります。したがって、各レプリカはいつでも自己矛盾がありません。

We do not assume that updates to each replica occur simultaneously. If a replica is offline or unreachable, the other replicas may be updated.

各レプリカの更新が同時に発生するとは想定していません。レプリカがオフラインまたはアクセスできない場合、他のレプリカが更新される可能性があります。

Server Collection: A set of fileservers administered as a unit. A server collection may be administered with vendor-specific software.

サーバーコレクション：ユニットとして管理されるファイルサーバーのセット。サーバーコレクションは、ベンダー固有のソフトウェアで管理できます。

The namespace provided by a server collection could be part of the federated namespace.

サーバーコレクションによって提供される名前空間は、フェデレーション名前空間の一部である可能性があります。

Singleton Server: A server collection containing only one server; a stand-alone fileserver.

シングルトンサーバー：サーバーを1つだけ含むサーバーコレクション。スタンドアロンのファイルサーバー。

1.2. Requirements Language

1.2. 要件言語

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

このドキュメントのキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、および「OPTIONAL」は、 [RFC2119]で説明されているように解釈されます。

2. Protocol

2. プロトコル

The Remote Procedure Call (RPC) protocol used to convey administration operations is the Open Network Computing (ONC) RPC protocol [RFC5531]. The data structures used for the parameters and return values of these procedures are expressed in this document in External Data Representation (XDR) [RFC4506].

管理操作を伝えるために使用されるリモートプロシージャコール（RPC）プロトコルは、オープンネットワークコンピューティング（ONC）RPCプロトコル[RFC5531]です。これらのプロシージャのパラメータと戻り値に使用されるデータ構造は、このドキュメントでは外部データ表現（XDR）[RFC4506]で表現されています。

The XDR definitions below are formatted to allow the reader to easily extract them from the document. The reader can use the following shell script to extract the definitions:

以下のXDR定義は、読者が文書から簡単に抽出できるようにフォーマットされています。読者は次のシェルスクリプトを使用して定義を抽出できます。

<コード開始>

             #!/bin/sh
             grep '^ *///' | sed 's?^ */// ??' | sed 's?^ *///$??'

<コード終了>

If the above script is stored in a file called "extract.sh" and this document is in a file called "spec.txt", then the reader can do:

上記のスクリプトが「extract.sh」というファイルに保存されていて、このドキュメントが「spec.txt」というファイルにある場合、リーダーは次のことを実行できます。

<コード開始>

sh extract.sh < spec.txt > admin1.xdr

sh extract.sh <spec.txt> admin1.xdr

<コード終了>

The effect of the script is to remove leading white space from each line, plus a sentinel sequence of "///".

スクリプトの効果は、各行から先頭の空白と、 "///"のセンチネルシーケンスを削除することです。

The protocol definition in XDR notation is shown below. We begin by defining basic constants and structures used by the protocol. We then present the procedures defined by the protocol.

XDR表記のプロトコル定義を以下に示します。最初に、プロトコルで使用される基本的な定数と構造を定義します。次に、プロトコルで定義された手順を示します。

<コード開始>

    /// /*
    ///  * Copyright (c) 2015 IETF Trust and the persons identified
    ///  * as authors of the code.  All rights reserved.
    ///  *
    ///  * The authors of the code are:
    ///  * J. Lentini, C. Everhart, D. Ellard, R. Tewari, and M. Naik.
    ///  *
    ///  * Redistribution and use in source and binary forms, with
    ///  * or without modification, are permitted provided that the
    ///  * following conditions are met:
    ///  *

    ///  * - Redistributions of source code must retain the above
    ///  *   copyright notice, this list of conditions and the
    ///  *   following disclaimer.
    ///  *
    ///  * - Redistributions in binary form must reproduce the above
    ///  *   copyright notice, this list of conditions and the
    ///  *   following disclaimer in the documentation and/or other
    ///  *   materials provided with the distribution.
    ///  *
    ///  * - Neither the name of Internet Society, IETF or IETF
    ///  *   Trust, nor the names of specific contributors, may be
    ///  *   used to endorse or promote products derived from this
    ///  *   software without specific prior written permission.
    ///  *
    ///  *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS
    ///  *   AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
    ///  *   WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    ///  *   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
    ///  *   FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
    ///  *   EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
    ///  *   LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
    ///  *   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
    ///  *   NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
    ///  *   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
    ///  *   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
    ///  *   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
    ///  *   OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
    ///  *   IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
    ///  *   ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    ///  */
    ///
    /// enum FedFsStatus {
    ///  FEDFS_OK                                 = 0,
    ///  FEDFS_ERR_ACCESS                         = 1,
    ///  FEDFS_ERR_BADCHAR                        = 2,
    ///  FEDFS_ERR_BADNAME                        = 3,
    ///  FEDFS_ERR_NAMETOOLONG                    = 4,
    ///  FEDFS_ERR_LOOP                           = 5,
    ///  FEDFS_ERR_BADXDR                         = 6,
    ///  FEDFS_ERR_EXIST                          = 7,
    ///  FEDFS_ERR_INVAL                          = 8,
    ///  FEDFS_ERR_IO                             = 9,
    ///  FEDFS_ERR_NOSPC                          = 10,
    ///  FEDFS_ERR_NOTJUNCT                       = 11,
    ///  FEDFS_ERR_NOTLOCAL                       = 12,
    ///  FEDFS_ERR_PERM                           = 13,
    ///  FEDFS_ERR_ROFS                           = 14,
    ///  FEDFS_ERR_SVRFAULT                       = 15,

    ///  FEDFS_ERR_NOTSUPP                        = 16,
    ///  FEDFS_ERR_NSDB_ROUTE                     = 17,
    ///  FEDFS_ERR_NSDB_DOWN                      = 18,
    ///  FEDFS_ERR_NSDB_CONN                      = 19,
    ///  FEDFS_ERR_NSDB_AUTH                      = 20,
    ///  FEDFS_ERR_NSDB_LDAP                      = 21,
    ///  FEDFS_ERR_NSDB_LDAP_VAL                  = 22,
    ///  FEDFS_ERR_NSDB_NONCE                     = 23,
    ///  FEDFS_ERR_NSDB_NOFSN                     = 24,
    ///  FEDFS_ERR_NSDB_NOFSL                     = 25,
    ///  FEDFS_ERR_NSDB_RESPONSE                  = 26,
    ///  FEDFS_ERR_NSDB_FAULT                     = 27,
    ///  FEDFS_ERR_NSDB_PARAMS                    = 28,
    ///  FEDFS_ERR_NSDB_LDAP_REFERRAL             = 29,
    ///  FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL         = 30,
    ///  FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED = 31,
    ///  FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL      = 32,
    ///  FEDFS_ERR_PATH_TYPE_UNSUPP               = 33,
    ///  FEDFS_ERR_DELAY                          = 34,
    ///  FEDFS_ERR_NO_CACHE                       = 35,
    ///  FEDFS_ERR_UNKNOWN_CACHE                  = 36,
    ///  FEDFS_ERR_NO_CACHE_UPDATE                = 37
    /// };
    ///
    /// typedef opaque                 utf8string<>;
    /// typedef utf8string             ascii_REQUIRED4;
    /// typedef utf8string             utf8val_REQUIRED4;
    ///
    /// typedef opaque FedFsUuid[16];
    ///
    /// struct FedFsNsdbName {
    ///         unsigned int           port;
    ///         utf8val_REQUIRED4      hostname;
    /// };
    ///
    /// typedef ascii_REQUIRED4 FedFsPathComponent;
    /// typedef FedFsPathComponent FedFsPathName<>;
    ///
    /// struct FedFsFsn {
    ///         FedFsUuid              fsnUuid;
    ///         FedFsNsdbName          nsdbName;
    /// };
    ///
    /// enum FedFsFslType {
    ///  FEDFS_NFS_FSL = 0
    /// };
    ///
    /// struct FedFsNfsFsl {

    ///         FedFsUuid              fslUuid;
    ///         unsigned int           port;
    ///         utf8val_REQUIRED4      hostname;
    ///         FedFsPathName          path;
    /// };
    ///
    /// union FedFsFsl switch(FedFsFslType type) {
    ///  case FEDFS_NFS_FSL:
    ///         FedFsNfsFsl            nfsFsl;
    /// };
    ///
    /// enum FedFsPathType {
    ///  FEDFS_PATH_SYS = 0,
    ///  FEDFS_PATH_NFS = 1
    /// };
    ///
    /// union FedFsPath switch(FedFsPathType type) {
    ///  case FEDFS_PATH_SYS: /* administrative path */
    ///         FedFsPathName          adminPath;
    ///  case FEDFS_PATH_NFS: /* NFS namespace path */
    ///         FedFsPathName          nfsPath;
    /// };
    ///
    /// struct FedFsCreateArgs {
    ///         FedFsPath              path;
    ///         FedFsFsn               fsn;
    /// };
    ///
    /// enum FedFsResolveType {
    ///  FEDFS_RESOLVE_NONE  = 0,
    ///  FEDFS_RESOLVE_CACHE = 1,
    ///  FEDFS_RESOLVE_NSDB  = 2
    /// };
    ///
    /// struct FedFsLookupArgs {
    ///         FedFsPath              path;
    ///         FedFsResolveType       resolve;
    /// };
    ///
    /// struct FedFsLookupResOk {
    ///         FedFsFsn               fsn;
    ///         FedFsFsl               fsl<>;
    /// };
    ///
    /// struct FedFsLookupResReferralVal {
    ///         FedFsNsdbName          targetNsdb;
    ///         unsigned int           ldapResultCode;
    /// };

    ///
    /// union FedFsLookupRes switch (FedFsStatus status) {
    ///  case FEDFS_OK:
    ///  case FEDFS_ERR_NO_CACHE_UPDATE:
    ///         FedFsLookupResOk           resok;
    ///  case FEDFS_ERR_NSDB_LDAP_VAL:
    ///         unsigned int               ldapResultCode;
    ///  case FEDFS_ERR_NSDB_LDAP_REFERRAL:
    ///  case FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL:
    ///         FedFsNsdbName              targetNsdb;
    ///  case FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL:
    ///         FedFsLookupResReferralVal  resReferralVal;
    ///  default:
    ///         void;
    /// };
    ///
    /// enum FedFsConnectionSec {
    ///  FEDFS_SEC_NONE = 0,
    ///  FEDFS_SEC_TLS = 1 /* StartTLS mechanism; RFC 4513, Section 3 */
    /// };
    ///
    /// union FedFsNsdbParams switch (FedFsConnectionSec secType) {
    ///  case FEDFS_SEC_TLS:
    ///         opaque                   secData<>;
    ///  default:
    ///         void;
    /// };
    ///
    /// struct FedFsSetNsdbParamsArgs {
    ///         FedFsNsdbName            nsdbName;
    ///         FedFsNsdbParams          params;
    /// };
    ///
    /// union FedFsGetNsdbParamsRes switch (FedFsStatus status) {
    ///  case FEDFS_OK:
    ///         FedFsNsdbParams          params;
    ///  default:
    ///         void;
    /// };
    ///
    /// union FedFsGetLimitedNsdbParamsRes switch (FedFsStatus status) {
    ///  case FEDFS_OK:
    ///         FedFsConnectionSec       secType;
    ///  default:
    ///         void;
    /// };
    ///
    /// program FEDFS_PROG {

    ///  version FEDFS_V1 {
    ///      void FEDFS_NULL(void) = 0;
    ///      FedFsStatus FEDFS_CREATE_JUNCTION(
    ///                   FedFsCreateArgs) = 1;
    ///      FedFsStatus FEDFS_DELETE_JUNCTION(
    ///                   FedFsPath) = 2;
    ///      FedFsLookupRes FEDFS_LOOKUP_JUNCTION(
    ///                   FedFsLookupArgs) = 3;
    ///      FedFsStatus FEDFS_CREATE_REPLICATION(
    ///                   FedFsCreateArgs) = 7;
    ///      FedFsStatus FEDFS_DELETE_REPLICATION(
    ///                   FedFsPath) = 8;
    ///      FedFsLookupRes FEDFS_LOOKUP_REPLICATION(
    ///                   FedFsLookupArgs) = 9;
    ///      FedFsStatus FEDFS_SET_NSDB_PARAMS(
    ///                   FedFsSetNsdbParamsArgs) = 4;
    ///      FedFsGetNsdbParamsRes FEDFS_GET_NSDB_PARAMS(
    ///                   FedFsNsdbName) = 5;
    ///      FedFsGetLimitedNsdbParamsRes FEDFS_GET_LIMITED_NSDB_PARAMS(
    ///                   FedFsNsdbName) = 6;
    ///  } = 1;
    /// } = 100418;

<コード終了>

3. Error Values

3. エラー値

The results of successful operations will consist of a status of FEDFS_OK. The results of unsuccessful operations will begin with a status, other than FEDFS_OK, that indicates the reason why the operation failed.

成功した操作の結果は、FEDFS_OKのステータスで構成されます。失敗した操作の結果は、操作が失敗した理由を示すFEDFS_OK以外のステータスで始まります。

Many of the error status names and meanings (and the prose for their descriptions) are taken from the specification for NFSv4 [RFC7530]. Note, however, that the numeric values for the status codes are different. For example, the name and meaning of FEDFS_ERR_ACCESS was inspired by NFSv4's NFS4ERR_ACCESS, but their numeric values are different.

エラーステータスの名前と意味（およびその説明の散文）の多くは、NFSv4 [RFC7530]の仕様に基づいています。ただし、ステータスコードの数値は異なります。たとえば、FEDFS_ERR_ACCESSの名前と意味はNFSv4のNFS4ERR_ACCESSに触発されましたが、それらの数値は異なります。

The status of an unsuccessful operation will generally only indicate the first error encountered during the attempt to execute the operation.

失敗した操作のステータスは、通常、操作の実行の試行中に発生した最初のエラーのみを示します。

FEDFS_OK: No errors were encountered. The operation was a success.

FEDFS_OK：エラーは発生しませんでした。手術は成功した。

FEDFS_ERR_ACCESS: Permission denied. The caller does not have the correct permission to perform the requested operation.

FEDFS_ERR_ACCESS：権限が拒否されました。呼び出し元には、要求された操作を実行するための適切な権限がありません。

FEDFS_ERR_BADCHAR: A UTF-8 string contains a character that is not supported by the server in the context in which it being used.

FEDFS_ERR_BADCHAR：UTF-8文字列には、使用されているコンテキストでサーバーがサポートしていない文字が含まれています。

FEDFS_ERR_BADNAME: A name string in a request consisted of valid UTF-8 characters supported by the server, but the name is not supported by the server as a valid name for the current operation.

FEDFS_ERR_BADNAME：リクエストの名前文字列はサーバーでサポートされている有効なUTF-8文字で構成されていますが、サーバーで現在の操作の有効な名前としてサポートされていません。

FEDFS_ERR_NAMETOOLONG: Returned when the pathname in an operation exceeds the server's implementation limit.

FEDFS_ERR_NAMETOOLONG：操作のパス名がサーバーの実装制限を超えたときに返されます。

FEDFS_ERR_LOOP: Returned when too many symbolic links were encountered in resolving pathname.

FEDFS_ERR_LOOP：パス名の解決でシンボリックリンクが多すぎる場合に返されます。

FEDFS_ERR_BADXDR: The server encountered an XDR decoding error while processing an operation.

FEDFS_ERR_BADXDR：サーバーは、操作の処理中にXDRデコードエラーを検出しました。

FEDFS_ERR_EXIST: The junction specified already exists.

FEDFS_ERR_EXIST：指定されたジャンクションは既に存在します。

FEDFS_ERR_INVAL: Invalid argument for an operation.

FEDFS_ERR_INVAL：操作の引数が無効です。

FEDFS_ERR_IO: A hard error occurred while processing the requested operation.

FEDFS_ERR_IO：要求された操作の処理中にハードエラーが発生しました。

FEDFS_ERR_NOSPC: The requested operation would have caused the server's file system to exceed some limit (for example, if there is a fixed number of junctions per fileset or per server).

FEDFS_ERR_NOSPC：要求された操作により、サーバーのファイルシステムがいくつかの制限を超えた可能性があります（たとえば、ファイルセットごとまたはサーバーごとに固定数のジャンクションがある場合）。

FEDFS_ERR_NOTJUNCT: The caller specified a path that does not end in a junction as the operand for an operation that requires the last component of the path to be a junction.

FEDFS_ERR_NOTJUNCT：呼び出し元が、パスの最後のコンポーネントがジャンクションである必要がある操作のオペランドとして、ジャンクションで終わっていないパスを指定しました。

FEDFS_ERR_NOTLOCAL: The caller specified a path that contains a junction in any position other than the last component.

FEDFS_ERR_NOTLOCAL：呼び出し元が、最後のコンポーネント以外の任意の位置にジャンクションを含むパスを指定しました。

FEDFS_ERR_PERM: The operation was not allowed because the caller is either not a privileged user or not the owner of an object that would be modified by the operation.

FEDFS_ERR_PERM：呼び出し元が特権ユーザーではないか、操作によって変更されるオブジェクトの所有者ではないため、操作は許可されませんでした。

FEDFS_ERR_ROFS: A modifying operation was attempted on a read-only file system.

FEDFS_ERR_ROFS：読み取り専用ファイルシステムで変更操作が試行されました。

FEDFS_ERR_SVRFAULT: An unanticipated non-protocol error occurred on the server.

FEDFS_ERR_SVRFAULT：サーバーで予期しないプロトコルエラーが発生しました。

FEDFS_ERR_NSDB_ROUTE: The fileserver was unable to find a route to the NSDB.

FEDFS_ERR_NSDB_ROUTE：ファイルサーバーはNSDBへのルートを見つけることができませんでした。

FEDFS_ERR_NSDB_DOWN: The fileserver determined that the NSDB was down.

FEDFS_ERR_NSDB_DOWN：ファイルサーバーは、NSDBがダウンしていると判断しました。

FEDFS_ERR_NSDB_CONN: The fileserver was unable to establish a connection with the NSDB.

FEDFS_ERR_NSDB_CONN：ファイルサーバーはNSDBとの接続を確立できませんでした。

FEDFS_ERR_NSDB_AUTH: The fileserver was unable to authenticate and establish a secure connection with the NSDB.

FEDFS_ERR_NSDB_AUTH：ファイルサーバーは認証できず、NSDBとの安全な接続を確立できませんでした。

FEDFS_ERR_NSDB_LDAP: A Lightweight Directory Access Protocol (LDAP) error occurred on the connection between the fileserver and NSDB.

FEDFS_ERR_NSDB_LDAP：ファイルサーバーとNSDB間の接続でライトウェイトディレクトリアクセスプロトコル（LDAP）エラーが発生しました。

FEDFS_ERR_NSDB_LDAP_VAL: Indicates the same error as FEDFS_ERR_NSDB_LDAP and allows the LDAP protocol error value to be returned back to an ADMIN protocol client.

FEDFS_ERR_NSDB_LDAP_VAL：FEDFS_ERR_NSDB_LDAPと同じエラーを示し、LDAPプロトコルエラー値をADMINプロトコルクライアントに返すことができます。

FEDFS_ERR_NSDB_NONCE: The fileserver was unable to locate the NSDB Container Entry (NCE) in the appropriate NSDB.

FEDFS_ERR_NSDB_NONCE：ファイルサーバーは、適切なNSDBでNSDBコンテナエントリ（NCE）を見つけることができませんでした。

FEDFS_ERR_NSDB_NOFSN: The fileserver was unable to locate the given FSN in the appropriate NSDB.

FEDFS_ERR_NSDB_NOFSN：ファイルサーバーは、適切なNSDBで指定されたFSNを見つけることができませんでした。

FEDFS_ERR_NSDB_NOFSL: The fileserver was unable to locate any FSLs for the given FSN in the appropriate NSDB.

FEDFS_ERR_NSDB_NOFSL：ファイルサーバーは、適切なNSDBで指定されたFSNのFSLを見つけることができませんでした。

FEDFS_ERR_NSDB_RESPONSE: The fileserver received a malformed response from the NSDB. This includes situations when an NSDB entry (e.g., FSN or FSL) is missing a required attribute.

FEDFS_ERR_NSDB_RESPONSE：ファイルサーバーがNSDBから不正な形式の応答を受信しました。これには、NSDBエントリ（FSNまたはFSLなど）に必要な属性が欠落している状況が含まれます。

FEDFS_ERR_NSDB_FAULT: An unanticipated error related to the NSDB occurred.

FEDFS_ERR_NSDB_FAULT：NSDBに関連する予期しないエラーが発生しました。

FEDFS_ERR_NSDB_PARAMS: The fileserver does not have any connection parameters on record for the specified NSDB.

FEDFS_ERR_NSDB_PARAMS：ファイルサーバーには、指定されたNSDBのレコードに接続パラメーターがありません。

FEDFS_ERR_NSDB_LDAP_REFERRAL: The fileserver received an LDAP referral that it was unable to follow.

FEDFS_ERR_NSDB_LDAP_REFERRAL：ファイルサーバーは、追跡できないLDAP参照を受信しました。

FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL: Indicates the same error as FEDFS_ERR_NSDB_LDAP_REFERRAL and allows the LDAP protocol error value to be returned back to an ADMIN protocol client.

FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL：FEDFS_ERR_NSDB_LDAP_REFERRALと同じエラーを示し、LDAPプロトコルエラー値をADMINプロトコルクライアントに返すことができます。

FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED: The fileserver received an LDAP referral that it chose not to follow, either because the fileserver does not support following LDAP referrals or LDAP referral following is disabled.

FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED：ファイルサーバーがLDAP紹介を受信しました。ファイルサーバーがLDAP紹介をサポートしていないか、LDAP紹介が無効になっているためです。

FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL: The fileserver received an LDAP referral that it chose not to follow because the fileserver had no NSDB parameters for the NSDB targeted by the LDAP referral.

FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL：ファイルサーバーに、LDAP参照の対象となるNSDBのNSDBパラメーターがなかったため、追跡しないことを選択したLDAP参照を受け取りました。

FEDFS_ERR_PATH_TYPE_UNSUPP: The fileserver does not support the specified FedFsPathType value.

FEDFS_ERR_PATH_TYPE_UNSUPP：ファイルサーバーは、指定されたFedFsPathType値をサポートしていません。

FEDFS_ERR_NOTSUPP: The fileserver does not support the specified procedure.

FEDFS_ERR_NOTSUPP：ファイルサーバーは指定された手順をサポートしていません。

FEDFS_ERR_DELAY: The fileserver initiated the request but was not able to complete it in a timely fashion. The ADMIN protocol client should wait and then try the request with a new RPC transaction ID.

FEDFS_ERR_DELAY：ファイルサーバーがリクエストを開始しましたが、タイムリーに完了することができませんでした。 ADMINプロトコルクライアントは待機してから、新しいRPCトランザクションIDを使用して要求を試行する必要があります。

FEDFS_ERR_NO_CACHE: The fileserver does not implement an FSN-to-FSL cache.

FEDFS_ERR_NO_CACHE：ファイルサーバーはFSNからFSLへのキャッシュを実装していません。

FEDFS_ERR_UNKNOWN_CACHE: The software receiving the ONC RPC request is unaware if the fileserver implements an FSN-to-FSL cache or is unable to communicate with the FSN-to-FSL cache if it exists.

FEDFS_ERR_UNKNOWN_CACHE：ONC RPC要求を受信するソフトウェアは、ファイルサーバーがFSNからFSLへのキャッシュを実装しているか、FSNからFSLへのキャッシュ（存在する場合）と通信できない場合、認識しません。

FEDFS_ERR_NO_CACHE_UPDATE: The fileserver was unable to update its FSN-to-FSL cache.

FEDFS_ERR_NO_CACHE_UPDATE：ファイルサーバーはFSNからFSLへのキャッシュを更新できませんでした。

4. Data Types

4. データ型

The basic data types defined above are formatted as follows:

上記で定義された基本的なデータ型は、次のようにフォーマットされます。

FedFsUuid: A universally unique identifier (UUID) as described in [RFC4122] as a version 4 UUID. The UUID MUST be formatted in network byte order.

FedFsUuid：バージョン4のUUIDとして[RFC4122]で説明されているユニバーサルユニーク識別子（UUID）。 UUIDはネットワークバイトオーダーでフォーマットする必要があります。

FedFsNsdbName: A (hostname, port) pair.

FedFsNsdbName：（ホスト名、ポート）ペア。

The hostname is a variable-length UTF-8 string that represents an NSDB's network location in DNS name notation. It SHOULD be prepared using the domain name rules defined in Section 12.6 ("Types with Processing Defined by Other Internet Areas") of [RFC7530]. The DNS name MUST be represented using a fully qualified domain name.

ホスト名は可変長UTF-8文字列で、NSDBのネットワークロケーションをDNS名表記で表します。 [RFC7530]のセクション12.6（「他のインターネット領域によって処理が定義されているタイプ」）で定義されているドメイン名規則を使用して準備する必要があります。 DNS名は、完全修飾ドメイン名を使用して表す必要があります。

The port value in the FedFsNsdbName indicates the LDAP port on the NSDB (see [RFC4511]). The value MUST be in the range 0 to 65535. A value of 0 indicates that the standard LDAP port number, 389, MUST be assumed.

FedFsNsdbNameのポート値は、NSDBのLDAPポートを示します（[RFC4511]を参照）。値は0から65535の範囲でなければなりません。値0は、標準のLDAPポート番号389を想定する必要があることを示します。

FSNs are immutable and invariant. The attributes of an FSN, including the fedfsNsdbName, are expected to remain constant. Therefore, a FedFsNsdbName MUST NOT contain a network address, such as an IPv4 or IPv6 address, as this would indefinitely assign the network address.

FSNは不変で不変です。 fedfsNsdbNameを含むFSNの属性は、一定のままであることが期待されます。したがって、FedFsNsdbNameにIPv4またはIPv6アドレスなどのネットワークアドレスを含めることはできません。これは、ネットワークアドレスを無期限に割り当てるためです。

FedFsPathComponent: A case-sensitive UTF-8 string containing a file system path component. The component names of an NFSv4 pathname MUST be prepared using the component name rules defined in Section 12 ("Internationalization") of [RFC7530] prior to encoding the path component of an NFS URI.

FedFsPathComponent：ファイルシステムパスコンポーネントを含む、大文字と小文字が区別されるUTF-8文字列。 NFSv4パス名のコンポーネント名は、NFS URIのパスコンポーネントをエンコードする前に、[RFC7530]のセクション12（「国際化」）で定義されたコンポーネント名規則を使用して準備する必要があります。

FedFsPathName: A variable-length array of FedFsPathComponent values representing a file system path. The path's first component is stored at the first position of the array, the second component is stored at the second position of the array, and so on.

FedFsPathName：ファイルシステムパスを表すFedFsPathComponent値の可変長配列。パスの最初のコンポーネントは配列の最初の位置に格納され、2番目のコンポーネントは配列の2番目の位置に格納され、以下同様に続きます。

The path "/" MUST be encoded as an array with zero components.

パス「/」は、コンポーネントがゼロの配列としてエンコードする必要があります。

A FedFsPathName MUST NOT contain any zero-length components.

FedFsPathNameには、長さゼロのコンポーネントを含めてはなりません（MUST NOT）。

FedFsPath: A pathname container. The format and semantics of the pathname are defined by the FedFsPathType value.

FedFsPath：パス名コンテナ。パス名の形式とセマンティクスは、FedFsPathType値によって定義されます。

FedFsPathType: The type-specific description of a pathname.

FedFsPathType：パス名のタイプ固有の説明。

A FEDFS_PATH_SYS is an implementation-dependent administrative pathname. For example, it could be a local file system path.

FEDFS_PATH_SYSは、実装に依存する管理パス名です。たとえば、ローカルファイルシステムのパスなどです。

A FEDFS_PATH_NFS is a pathname in the NFSv4 server's single-server namespace.

FEDFS_PATH_NFSは、NFSv4サーバーの単一サーバー名前空間のパス名です。

FedFsNsdbParams: A set of parameters for connecting to an NSDB. Conceptually, the fileserver contains a data structure that maps an NSDB name (DNS name and port value) to these LDAP connection parameters.

FedFsNsdbParams：NSDBに接続するためのパラメーターのセット。概念的には、ファイルサーバーには、NSDB名（DNS名とポート値）をこれらのLDAP接続パラメーターにマップするデータ構造が含まれています。

The secType field indicates the security mechanism that MUST be used to protect all connections to the NSDB with the connection parameters.

secTypeフィールドは、接続パラメーターを使用してNSDBへのすべての接続を保護するために使用する必要があるセキュリティメカニズムを示します。

A value of FEDFS_SEC_NONE indicates that a transport security mechanism MUST NOT be used when connecting to the NSDB. In this case, the secData array will have a length of zero.

FEDFS_SEC_NONEの値は、NSDBに接続するときにトランスポートセキュリティメカニズムを使用してはならないことを示します。この場合、secData配列の長さはゼロになります。

A value of FEDFS_SEC_TLS indicates that the StartTLS security mechanism [RFC4513] MUST be used to protect all connections to the NSDB. In this case, the secData array will contain an X.509v3 root certificate in binary DER format [RFC5280] fulfilling the Transport Layer Security (TLS) requirement that root keys be distributed independently from the TLS protocol. The certificate MUST be used by the fileserver as a trust anchor to validate the NSDB's TLS server certificate list chain (see Section 7.4.2 of [RFC5246]) and thus authenticate the identity of the NSDB. The certificate could be that of a certificate authority or a self-signed certificate. To ensure that this security configuration information does not cause vulnerabilities for other services, trust anchors provided through secData MUST only be used for the NSDB service (as opposed to being installed as system-wide trust anchors for other services). Most popular TLS libraries provide ways in which this can be done, such as denoting a private file system location for the certificates.

FEDFS_SEC_TLSの値は、StartTLSセキュリティメカニズム[RFC4513]を使用してNSDBへのすべての接続を保護する必要があることを示します。この場合、secData配列には、ルートキーがTLSプロトコルから独立して配布されるというトランスポート層セキュリティ（TLS）要件を満たすバイナリDER形式[RFC5280]のX.509v3ルート証明書が含まれます。証明書は、NSDBのTLSサーバー証明書リストチェーン（[RFC5246]のセクション7.4.2を参照）を検証し、NSDBのIDを認証するためのトラストアンカーとしてファイルサーバーによって使用される必要があります。証明書は、認証局または自己署名証明書の場合があります。このセキュリティ構成情報が他のサービスに脆弱性を引き起こさないようにするには、secDataを通じて提供されるトラストアンカーをNSDBサービスにのみ使用する必要があります（他のサービスのシステム全体のトラストアンカーとしてインストールされるのではありません）。最も一般的なTLSライブラリは、証明書のプライベートファイルシステムの場所を示すなど、これを実行できる方法を提供します。

4.1. FedFsNsdbName Equality

Two FedFsNsdbNames are considered equal if their respective hostname and port fields contain the same values. The only exception to this rule is that a value of 0 in the port field always matches the standard LDAP port number, 389.

2つのFedFsNsdbNamesは、それぞれのホスト名フィールドとポートフィールドに同じ値が含まれている場合、等しいと見なされます。このルールの唯一の例外は、ポートフィールドの値0が常に標準のLDAPポート番号389と一致することです。

Therefore, the FedFsNsdbName "(nsdb.example.com, 0)" is considered equal to "(nsdb.example.com, 389)" but not equal to "(nsdb.example.com, 1066)" since the port numbers are different or "(nsdb.foo.example.com, 389)" since the hostnames are different.

したがって、FedFsNsdbName "（nsdb.example.com、0）"は "（nsdb.example.com、389）"と等しいと見なされますが、 "（nsdb.example.com、1066）"とは見なされません。ホスト名が異なるため、「（nsdb.foo.example.com、389）」とは異なります。

5. Procedures

5. 手続き

The procedures defined in Section 2 are described in detail in the following sections.

セクション2で定義された手順については、次のセクションで詳しく説明します。

Fileservers that participate as "internal" nodes in the federated namespace MUST implement the following procedures:

フェデレーテッド名前空間の「内部」ノードとして参加するファイルサーバーは、次の手順を実装する必要があります。

FEDFS_NULL FEDFS_CREATE_JUNCTION FEDFS_DELETE_JUNCTION FEDFS_LOOKUP_JUNCTION FEDFS_SET_NSDB_PARAMS FEDFS_GET_NSDB_PARAMS FEDFS_GET_LIMITED_NSDB_PARAMS

Furthermore, they SHOULD implement the following procedures:

さらに、次の手順を実装する必要があります。

FEDFS_CREATE_REPLICATION FEDFS_DELETE_REPLICATION FEDFS_LOOKUP_REPLICATION

Fileservers that participate as "leaf" nodes in the namespace (i.e., fileservers that host filesets that are the target of junctions but that do not contain any junctions) are not required to implement any of these operations.

名前空間の「リーフ」ノードとして参加するファイルサーバー（つまり、ジャンクションのターゲットであるが、ジャンクションを含まないファイルセットをホストするファイルサーバー）は、これらの操作を実装する必要はありません。

Operations that modify the state of a replicated fileset MUST result in the update of all of the replicas in a consistent manner. Ideally, all of the replicas SHOULD be updated before any operation returns. If one or more of the replicas are unavailable, the operation MAY succeed, but the changes MUST be applied before the unavailable replicas are brought back online. We assume that replicas are updated via some protocol that permits state changes to be reflected consistently across the set of replicas in such a manner that the replicas will converge to a consistent state within a bounded number of successful message exchanges between the servers hosting the replicas.

複製されたファイルセットの状態を変更する操作は、一貫した方法ですべてのレプリカを更新する必要があります。理想的には、操作が戻る前に、すべてのレプリカを更新する必要があります。 1つ以上のレプリカが使用できない場合、操作は成功する可能性がありますが、使用できないレプリカをオンラインに戻す前に変更を適用する必要があります。レプリカは、レプリカをホストするサーバー間で成功したメッセージ交換の制限された数内で一貫した状態に収束するような方法で、一連のレプリカ全体に一貫して状態変化を反映できるようにするプロトコルを介して更新されると想定しています。

5.1. FEDFS_NULL

5.1.1. Synopsis

5.1.1. あらすじ

The standard NULL procedure.

標準のNULLプロシージャ。

5.1.2. Description

5.1.2. 説明

The null RPC, which is included, by convention, in every ONC RPC protocol. This procedure does not take any arguments and does not produce a result.

規則により、すべてのONC RPCプロトコルに含まれているnull RPC。このプロシージャは引数を取らず、結果も生成しません。

5.1.3. Errors

5.1.3. エラー

None.

なし。

5.2. FEDFS_CREATE_JUNCTION

5.2.1. Synopsis

5.2.1. あらすじ

Create a new junction from some location on the server (defined as a pathname) to an FSN.

サーバー上のある場所（パス名として定義）からFSNへの新しいジャンクションを作成します。

5.2.2. Description

5.2.2. 説明

This operation creates a junction from a server-relative path to a (potentially) remote fileset named by the given FSN.

この操作は、サーバー相対パスから、指定されたFSNによって指定された（潜在的に）リモートファイルセットへのジャンクションを作成します。

The junction directory on the server is identified by a pathname in the form of an array of one or more UTF-8 path component strings. It is not required that this path be accessible in any other manner (e.g., to a file-access client). This path does not appear in the federated namespace, except by coincidence; there is no requirement that the global namespace parallel the server namespace, nor is it required that this path be relative to the server pseudo-root. It does not need to be a path that is accessible via NFS (although the junction will be of limited utility if the directory specified by the path is not also accessible via NFS).

サーバー上のジャンクションディレクトリは、1つ以上のUTF-8パスコンポーネント文字列の配列形式のパス名で識別されます。このパスが他の方法（ファイルアクセスクライアントなど）でアクセス可能である必要はありません。このパスは、偶然を除いて、フェデレーテッド名前空間に表示されません。グローバル名前空間がサーバー名前空間に対応している必要はありません。また、このパスがサーバーの疑似ルートに相対的である必要もありません。 NFS経由でアクセスできるパスである必要はありません（パスで指定されたディレクトリにNFS経由でもアクセスできない場合、ジャンクションのユーティリティは制限されます）。

If the fileset is read-only, then this operation MUST indicate this with a status of FEDFS_ERR_ROFS.

ファイルセットが読み取り専用の場合、この操作はFEDFS_ERR_ROFSのステータスでこれを示しなければなりません。

If the path contains a character that is not supported by the server, then status FEDFS_ERR_BADCHAR MUST be returned.

パスにサーバーでサポートされていない文字が含まれている場合は、ステータスFEDFS_ERR_BADCHARを返す必要があります。

The path is REQUIRED to exist and be completely local to the server. It MUST NOT contain a junction. If the last component of the path is a junction (i.e., this operation is attempting to create a junction where one already exists), then this operation MUST return the error FEDFS_ERR_EXIST (even if the requested junction is identical to the current junction). If any other component of the path is a junction, then this operation MUST fail with status FEDFS_ERR_NOTLOCAL. The path might contain a symbolic link (if supported by the local server), but the traversal of the path MUST remain within the server-local namespace.

パスは存在し、サーバーに対して完全にローカルであることが必要です。ジャンクションを含めることはできません。パスの最後のコンポーネントがジャンクションである場合（つまり、このオペレーションがジャンクションをすでに作成している場所に作成しようとしている場合）、このオペレーションはエラーFEDFS_ERR_EXISTを返さなければなりません（要求されたジャンクションが現在のジャンクションと同じであっても）。パスの他のコンポーネントがジャンクションである場合、この操作はステータスFEDFS_ERR_NOTLOCALで失敗する必要があります。パスにはシンボリックリンクが含まれている可能性がありますが（ローカルサーバーでサポートされている場合）、パスのトラバーサルはサーバーローカルの名前空間内にとどまる必要があります。

If any component of the path does not exist, then the operation MUST fail with status FEDFS_ERR_INVAL.

パスのいずれかのコンポーネントが存在しない場合、操作はステータスFEDFS_ERR_INVALで失敗する必要があります。

The server MAY enforce the local permissions on the path, including the final component. If a server wishes to report that a path cannot be traversed because of insufficient permissions, or the final component is an unexecutable or unwritable directory, then the operation MUST fail with status FEDFS_ERR_ACCESS.

サーバーは、最終的なコンポーネントを含め、パスにローカルのアクセス許可を適用できます（MAY）。アクセス許可が不十分なためにパスを通過できないことをサーバーが報告したい場合、または最終コンポーネントが実行不可または書き込み不可のディレクトリである場合、操作はステータスFEDFS_ERR_ACCESSで失敗する必要があります。

The operation SHOULD fail with status FEDFS_ERR_NSDB_PARAMS if the fileserver does not have any connection parameters on record for the specified NSDB, or the server may allow the operation to proceed using some set of default NSDB connection parameters.

ファイルサーバーに指定されたNSDBのレコードに接続パラメーターがない場合、またはサーバーがデフォルトのNSDB接続パラメーターのセットを使用して操作を続行できる場合、操作はステータスFEDFS_ERR_NSDB_PARAMSで失敗します（SHOULD）。

The association between the path and the FSN MUST be durable before the operation returns successfully. If the operation return code indicates success, then the junction was successfully created and is immediately accessible.

パスとFSN間の関連付けは、操作が正常に戻る前に永続的である必要があります。操作の戻りコードが成功を示している場合、ジャンクションは正常に作成されており、すぐにアクセスできます。

If successful, subsequent references via NFSv4.0 [RFC7530] or NFSv4.1 [RFC5661] clients to the directory that has been replaced by the junction will result in a referral to a current location of the target fileset [RFC7532].

成功すると、NFSv4.0 [RFC7530]またはNFSv4.1 [RFC5661]クライアントを介して、ジャンクションによって置き換えられたディレクトリを参照すると、ターゲットファイルセット[RFC7532]の現在の場所が参照されます。

The effective permissions of the directory that is converted, by this operation, into a junction are the permissions of the root directory of the target fileset. The original permissions of the directory (and any other attributes it might have) are subsumed by the junction.

この操作によってジャンクションに変換されるディレクトリの有効な権限は、ターゲットファイルセットのルートディレクトリの権限です。ディレクトリーの元の許可（およびディレクトリーが持つ可能性のあるその他の属性）は、ジャンクションによって包含されます。

This operation does not create a fileset at the location targeted by the junction. If the target fileset does not exist, the junction will still be created. An NFS client will discover the missing fileset when it traverses the junction.

この操作では、ジャンクションのターゲットとなる場所にファイルセットは作成されません。ターゲットファイルセットが存在しない場合でも、ジャンクションは作成されます。 NFSクライアントは、ジャンクションを通過するときに欠落しているファイルセットを検出します。

5.2.3. Errors

5.2.3. エラー

FEDFS_ERR_ACCESS FEDFS_ERR_BADCHAR FEDFS_ERR_BADNAME FEDFS_ERR_NAMETOOLONG FEDFS_ERR_LOOP FEDFS_ERR_BADXDR FEDFS_ERR_EXIST FEDFS_ERR_INVAL FEDFS_ERR_IO FEDFS_ERR_NOSPC FEDFS_ERR_NOTLOCAL FEDFS_ERR_PERM FEDFS_ERR_ROFS FEDFS_ERR_SVRFAULT FEDFS_ERR_PATH_TYPE_UNSUPP FEDFS_ERR_NOTSUPP FEDFS_ERR_DELAY

5.3. FEDFS_DELETE_JUNCTION

5.3.1. Synopsis

5.3.1. あらすじ

Delete an existing junction from some location on the server (defined as a pathname).

サーバー上のある場所（パス名として定義）から既存のジャンクションを削除します。

5.3.2. Description

5.3.2. 説明

This operation removes a junction specified by a server-relative path.

この操作は、サーバー相対パスで指定されたジャンクションを削除します。

As with FEDFS_CREATE_JUNCTION, the junction on the server is identified by a pathname in the form of an array of one or more UTF-8 path component strings. It is not required that this path be accessible in any other manner (e.g., to a file-access client). This path does not appear in the federated namespace, except by coincidence; there is no requirement that the global namespace reflect the server namespace, nor is it required that this path be relative to the server pseudo-root. It does not need to be a path that is accessible via NFS.

FEDFS_CREATE_JUNCTIONと同様に、サーバー上のジャンクションは、1つ以上のUTF-8パスコンポーネント文字列の配列の形式のパス名によって識別されます。このパスが他の方法（ファイルアクセスクライアントなど）でアクセス可能である必要はありません。このパスは、偶然を除いて、フェデレーテッド名前空間に表示されません。グローバル名前空間がサーバーの名前空間を反映する必要はなく、このパスがサーバーの疑似ルートからの相対パスである必要もありません。 NFS経由でアクセスできるパスである必要はありません。

If the fileset is read-only, then this operation MUST indicate this with a status of FEDFS_ERR_ROFS.

ファイルセットが読み取り専用の場合、この操作はFEDFS_ERR_ROFSのステータスでこれを示しなければなりません。

If the path contains a character that is not supported by the server, then status FEDFS_ERR_BADCHAR MUST be returned.

パスにサーバーでサポートされていない文字が含まれている場合は、ステータスFEDFS_ERR_BADCHARを返す必要があります。

The path used to delete a junction might not be the same path that was used to create the junction. If the namespace on the server has changed, then the junction might now appear at a different path than where it was created. If there is more than one valid path to the junction, any of them can be used.

ジャンクションの削除に使用されたパスは、ジャンクションの作成に使用されたパスと同じでない可能性があります。サーバーのネームスペースが変更された場合、junctionは作成された場所とは異なるパスに表示される可能性があります。ジャンクションへの有効なパスが複数ある場合は、それらのいずれかを使用できます。

The path is REQUIRED to exist and be completely local to the server. It MUST NOT contain a junction, except as the final component, which MUST be a junction. If any other component of the path is a junction, then this operation MUST fail with status FEDFS_ERR_NOTLOCAL. If the last component of the path is not a junction, then this operation MUST return status FEDFS_ERR_NOTJUNCT. The path might contain a symbolic link (if supported by the local server), but the traversal of the path MUST remain within the server-local namespace.

パスは存在し、サーバーに対して完全にローカルであることが必要です。ジャンクションでなければならない最後のコンポーネントを除いて、ジャンクションを含んではいけません。パスの他のコンポーネントがジャンクションである場合、この操作はステータスFEDFS_ERR_NOTLOCALで失敗する必要があります。パスの最後のコンポーネントがジャンクションでない場合、この操作はステータスFEDFS_ERR_NOTJUNCTを返さなければなりません（MUST）。パスにはシンボリックリンクが含まれている可能性がありますが（ローカルサーバーでサポートされている場合）、パスのトラバーサルはサーバーローカルの名前空間内にとどまる必要があります。

The removal of the association between the path and the FSN MUST be durable before the operation returns successfully. If the operation return code indicates success, then the junction was successfully destroyed.

パスとFSNの間の関連付けの削除は、操作が正常に戻る前に永続的である必要があります。操作の戻りコードが成功を示している場合、ジャンクションは正常に破棄されました。

The effective permissions and other attributes of the directory that is restored by this operation SHOULD be identical to their value prior to the creation of the junction.

この操作によって復元されるディレクトリーの有効な許可およびその他の属性は、ジャンクションを作成する前の値と同一である必要があります（SHOULD）。

After removal of the junction, the fileserver MAY check if any of its existing junctions reference the NSDB specified in the removed junction's FSN. If the NSDB is not referenced, the fileserver MAY delete the connection parameters of the unreferenced NSDB.

ジャンクションを削除した後、ファイルサーバーは、既存のジャンクションのいずれかが削除されたジャンクションのFSNで指定されたNSDBを参照しているかどうかをチェックできます（MAY）。 NSDBが参照されていない場合、ファイルサーバーは参照されていないNSDBの接続パラメーターを削除できます（MAY）。

5.3.3. Errors

5.3.3. エラー

FEDFS_ERR_ACCESS FEDFS_ERR_BADCHAR FEDFS_ERR_BADNAME FEDFS_ERR_NAMETOOLONG FEDFS_ERR_LOOP FEDFS_ERR_BADXDR FEDFS_ERR_INVAL FEDFS_ERR_IO FEDFS_ERR_NOTJUNCT FEDFS_ERRFSFERR_FEND_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FFS_ERRFS_ERRFS_FERR_FFS_FFS_FFS_FFS_FFS_FFS_FFS_FFS

5.4. FEDFS_LOOKUP_JUNCTION

5.4.1. Synopsis

5.4.1. あらすじ

Query the server to discover the current value of the junction (if any) at a given path in the server namespace.

サーバーを照会して、サーバー名前空間の特定のパスにあるジャンクション（存在する場合）の現在の値を検出します。

5.4.2. Description

5.4.2. 説明

This operation queries a server to determine whether a given path ends in a junction. If it does, the FSN to which the junction refers and the fileserver's ability to resolve the junction is returned.

この操作は、サーバーにクエリを実行して、特定のパスがジャンクションで終了しているかどうかを判断します。その場合、ジャンクションが参照するFSNと、ジャンクションを解決するファイルサーバーの機能が返されます。

Ordinary NFSv4 operations do not provide any general mechanism to determine whether an object is a junction -- there is no encoding specified by the NFSv4 protocol that can represent this information.

通常のNFSv4操作は、オブジェクトがジャンクションであるかどうかを判別する一般的なメカニズムを提供しません-この情報を表すことができるNFSv4プロトコルによって指定されたエンコーディングはありません。

As with FEDFS_CREATE_JUNCTION, the pathname MUST be in the form of an array of one or more UTF-8 path component strings. It is not required that this path be accessible in any other manner (e.g., to a file-access client). This path does not appear in the federated namespace, except by coincidence; there is no requirement that the global namespace reflect the server namespace, nor is it required that this path be relative to the server pseudo-root. It does not need to be a path that is accessible via NFS.

FEDFS_CREATE_JUNCTIONと同様に、パス名は1つ以上のUTF-8パスコンポーネント文字列の配列の形式である必要があります。このパスが他の方法（ファイルアクセスクライアントなど）でアクセス可能である必要はありません。このパスは、偶然を除いて、フェデレーテッド名前空間に表示されません。グローバル名前空間がサーバーの名前空間を反映する必要はなく、このパスがサーバーの疑似ルートからの相対パスである必要もありません。 NFS経由でアクセスできるパスである必要はありません。

If the path contains a character that is not supported by the server, then status FEDFS_ERR_BADCHAR MUST be returned.

パスにサーバーでサポートされていない文字が含まれている場合は、ステータスFEDFS_ERR_BADCHARを返す必要があります。

The path used to look up a junction might not be the same path that was used to create the junction. If the namespace on the server has changed, then a junction might now appear at a different path than where it was created. If there is more than one valid path to the junction, any of them might be used.

ジャンクションのルックアップに使用されたパスは、ジャンクションの作成に使用されたパスと同じでない場合があります。サーバーのネームスペースが変更された場合、ジャンクションが作成された場所とは異なるパスに表示される可能性があります。ジャンクションへの有効なパスが複数ある場合は、それらのいずれかが使用される可能性があります。

The path is REQUIRED to exist and be completely local to the server. It MUST NOT contain a junction, except as the final component. If any other component of the path is a junction, then this operation MUST fail with status FEDFS_ERR_NOTLOCAL. If the last component of the path is not a junction, then this operation MUST return the status FEDFS_ERR_NOTJUNCT. The path might contain a symbolic link (if supported by the local server), but the traversal of the path MUST remain within the server-local namespace.

パスは存在し、サーバーに対して完全にローカルであることが必要です。最終コンポーネントとしての場合を除き、ジャンクションを含めることはできません。パスの他のコンポーネントがジャンクションである場合、この操作はステータスFEDFS_ERR_NOTLOCALで失敗する必要があります。パスの最後のコンポーネントがジャンクションでない場合、この操作はステータスFEDFS_ERR_NOTJUNCTを返さなければなりません（MUST）。パスにはシンボリックリンクが含まれている可能性がありますが（ローカルサーバーでサポートされている場合）、パスのトラバーサルはサーバーローカルの名前空間内にとどまる必要があります。

If the junction exists, the resolve parameter allows for testing the fileserver's ability to resolve the junction. If the junction does not exist, the fileserver will ignore the resolve parameter.

ジャンクションが存在する場合、resolveパラメーターを使用すると、ジャンクションを解決するファイルサーバーの機能をテストできます。ジャンクションが存在しない場合、ファイルサーバーはresolveパラメーターを無視します。

If the junction exists and the resolve parameter is set to FEDFS_RESOLVE_NONE, the fileserver MUST NOT attempt to resolve the FSN. This will allow an administrator to obtain the junction's FSN even if the resolution would fail. Therefore, on success, the result of a FEDFS_RESOLVE_NONE call will return a zero-length fsl list in the FedFsLookupResOk structure.

ジャンクションが存在し、resolveパラメーターがFEDFS_RESOLVE_NONEに設定されている場合、ファイルサーバーはFSNの解決を試みてはなりません（MUST NOT）。これにより、解決が失敗した場合でも、管理者はジャンクションのFSNを取得できます。したがって、成功した場合、FEDFS_RESOLVE_NONE呼び出しの結果は、FedFsLookupResOk構造体で長さ0のfslリストを返します。

If the junction exists and the resolve parameter is set to FEDFS_RESOLVE_CACHE, the fileserver MUST attempt to resolve the FSN using its FSL cache, if one exists. The fileserver MUST NOT resolve the FSN by contacting the appropriate NSDB. If the fileserver's cache does not have a mapping for the FSN in question, the result of the operation MUST be FEDFS_OK with 0 elements in the FedFsLookupResOk structure's fsl array. The operation MAY fail with status FEDFS_ERR_NO_CACHE if the fileserver does not contain an FSN-to-FSL cache or with status FEDFS_ERR_UNKNOWN_CACHE if the state of the cache is unknown.

ジャンクションが存在し、resolveパラメーターがFEDFS_RESOLVE_CACHEに設定されている場合、ファイルサーバーは、FSLキャッシュ（存在する場合）を使用してFSNを解決しようとする必要があります。ファイルサーバーは、適切なNSDBにアクセスしてFSNを解決してはなりません（MUST NOT）。ファイルサーバーのキャッシュに問題のFSNのマッピングがない場合、操作の結果は、FedFsLookupResOk構造体のfsl配列の要素が0のFEDFS_OKである必要があります。ファイルサーバーにFSNからFSLへのキャッシュが含まれていない場合、操作はステータスFEDFS_ERR_NO_CACHEで失敗する可能性があり、キャッシュの状態が不明の場合、ステータスFEDFS_ERR_UNKNOWN_CACHEで失敗する可能性があります。

If the junction exists and the resolve parameter is set to FEDFS_RESOLVE_NSDB, the fileserver MUST attempt to resolve the FSN by contacting the appropriate NSDB. The FSN MUST NOT be resolved using cached information. The resolution MAY fail with FEDFS_ERR_NSDB_ROUTE, FEDFS_ERR_NSDB_DOWN, FEDFS_ERR_NSDB_CONN, FEDFS_ERR_NSDB_AUTH, FEDFS_ERR_NSDB_LDAP, FEDFS_ERR_NSDB_LDAP_VAL, FEDFS_ERR_NSDB_NOFSN, FEDFS_ERR_NSDB_NOFSL, FEDFS_ERR_NSDB_NONCE, FEDFS_ERR_NSDB_RESPONSE, FEDFS_ERR_NSDB_FAULT, FEDFS_ERR_NSDB_LDAP_REFERRAL, FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL, FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED, or FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL, depending on the nature of the failure.

ジャンクションが存在し、resolveパラメーターがFEDFS_RESOLVE_NSDBに設定されている場合、ファイルサーバーは適切なNSDBに接続してFSNの解決を試みる必要があります。 FSNは、キャッシュされた情報を使用して解決してはなりません。解像度は、障害の性質に応じて、FEDFS_ERR_NSDB_ROUTE、FEDFS_ERR_NSDB_DOWN、FEDFS_ERR_NSDB_CONN、FEDFS_ERR_NSDB_AUTH、FEDFS_ERR_NSDB_LDAP、FEDFS_ERR_NSDB_LDAP_VAL、FEDFS_ERR_NSDB_NOFSN、FEDFS_ERR_NSDB_NOFSL、FEDFS_ERR_NSDB_NONCE、FEDFS_ERR_NSDB_RESPONSE、FEDFS_ERR_NSDB_FAULT、FEDFS_ERR_NSDB_LDAP_REFERRAL、FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL、FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED、またはFEDFS_ERR_NSDB_PARAMS_LDAP_REFERRALで失敗することがあります。

In the case of an LDAP failure, the fileserver MUST return either FEDFS_ERR_NSDB_LDAP or FEDFS_ERR_NSDB_LDAP_VAL. FEDFS_ERR_NSDB_LDAP indicates that an LDAP protocol error occurred during the resolution. FEDFS_ERR_NSDB_LDAP_VAL also indicates that an LDAP protocol error occurred during the resolution and allows the LDAP protocol error value to be returned in the FedFsLookupRes's ldapResultCode field (see the resultCode values in Section 4.1.9 of [RFC4511]).

LDAP障害の場合、ファイルサーバーはFEDFS_ERR_NSDB_LDAPまたはFEDFS_ERR_NSDB_LDAP_VALを返す必要があります。 FEDFS_ERR_NSDB_LDAPは、解決中にLDAPプロトコルエラーが発生したことを示します。 FEDFS_ERR_NSDB_LDAP_VALは、解決中にLDAPプロトコルエラーが発生したことも示し、LDAPプロトコルエラー値をFedFsLookupResのldapResultCodeフィールドに返すことができます（[RFC4511]のセクション4.1.9のresultCode値を参照）。

If the NSDB responds with an LDAP referral, either the Referral type defined in Section 4.1.10 of [RFC4511] or the SearchResultReference type defined in Section 4.5.3 of [RFC4511], the fileserver SHOULD process the LDAP referral using the same policies as the fileserver's file-access protocol server. The fileserver MUST indicate a failure while processing the LDAP referral using FEDFS_ERR_NSDB_LDAP_REFERRAL, FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL, FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED, or FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL. The FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL is analogous to the FEDFS_ERR_NSDB_LDAP_VAL error and allows the LDAP protocol error value to be returned in the FedFsLookupResReferralVal's ldapResultCode field. The FEDFS_ERR_NSDB_LDAP_REFERRAL and FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL errors allow the NSDB targeted by the LDAP referral to be returned in the FedFsLookupRes's targetNsdb field. Similarly, the FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL error includes this information in the FedFsLookupResReferralVal's targetNsdb.

NSDBが[RFC4511]のセクション4.1.10で定義された紹介タイプまたは[RFC4511]のセクション4.5.3で定義されたSearchResultReferenceタイプのLDAP紹介で応答する場合、ファイルサーバーは、同じポリシーを使用してLDAP紹介を処理する必要があります（SHOULD）。ファイルサーバーのファイルアクセスプロトコルサーバー。ファイルサーバーは、FEDFS_ERR_NSDB_LDAP_REFERRAL、FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL、FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED、またはFEDFS_ERR_NSDB_PARAMS_LDAP_REFERRALを使用してLDAP参照を処理しているときに障害を示す必要があります。 FEDFS_ERR_NSDB_LDAP_REFERRAL_VALはFEDFS_ERR_NSDB_LDAP_VALエラーに類似しており、LDAPプロトコルエラー値をFedFsLookupResReferralValのldapResultCodeフィールドに返すことができます。 FEDFS_ERR_NSDB_LDAP_REFERRALおよびFEDFS_ERR_NSDB_PARAMS_LDAP_REFERRALエラーにより、LDAP参照の対象となるNSDBをFedFsLookupResのtargetNsdbフィールドに返すことができます。同様に、FEDFS_ERR_NSDB_LDAP_REFERRAL_VALエラーには、FedFsLookupResReferralValのtargetNsdbにこの情報が含まれています。

If the fileserver has a cache of FSL records, the process of resolving an FSN using an NSDB SHOULD result in the cache being updated. A failure to update the cache MAY be indicated with the FEDFS_ERR_NO_CACHE_UPDATE status value, or the operation may complete successfully.

ファイルサーバーにFSLレコードのキャッシュがある場合、NSDBを使用してFSNを解決するプロセスでは、キャッシュが更新される必要があります（SHOULD）。キャッシュの更新の失敗は、FEDFS_ERR_NO_CACHE_UPDATEステータス値で示される場合があります。そうでない場合、操作は正常に完了する可能性があります。

When updating the cache, new FSLs for the given FSN SHOULD be added to the cache, and deleted FSLs SHOULD be removed from the cache. This behavior is desirable because it allows an administrator to proactively request that the fileserver refresh its FSL cache. For example, an administrator might like to refresh the fileserver's cache when changes are made to an FSN's FSLs.

キャッシュを更新するとき、与えられたFSNの新しいFSLはキャッシュに追加されるべきで（SHOULD）、削除されたFSLはキャッシュから削除されるべきです（SHOULD）。この動作により、管理者はファイルサーバーがFSLキャッシュを更新することをプロアクティブに要求できます。たとえば、管理者はFSNのFSLに変更が加えられたときにファイルサーバーのキャッシュを更新したい場合があります。

If the junction is resolved, the fileserver will include a list of UUIDs for the FSN's FSLs in the FedFsLookupResOk structure's fsl array.

ジャンクションが解決されると、ファイルサーバーはFedFsLookupResOk構造体のfsl配列にFSNのFSLのUUIDのリストを含めます。

5.4.3. Errors

5.4.3. エラー

FEDFS_ERR_ACCESS FEDFS_ERR_BADCHAR FEDFS_ERR_BADNAME FEDFS_ERR_NAMETOOLONG FEDFS_ERR_LOOP FEDFS_ERR_BADXDR FEDFS_ERR_INVAL FEDFS_ERR_IO FEDFS_ERR_NOTJUNCT FEDFS_ERR_NOTLOCAL FEDFS_ERR_PERM FEDFS_ERR_SVRFAULT FEDFS_ERR_NSDB_ROUTE FEDFS_ERR_NSDB_DOWN FEDFS_ERR_NSDB_CONN FEDFS_ERR_NSDB_AUTH FEDFS_ERR_NSDB_LDAP FEDFS_ERR_NSDB_LDAP_VAL FEDFS_ERR_NSDB_NONCE FEDFS_ERR_NSDB_NOFSN FEDFS_ERR_NSDB_NOFSL FEDFS_ERR_NSDB_RESPONSE FEDFS_ERR_NSDB_FAULT FEDFS_ERR_NSDB_PARAMS FEDFS_ERR_NSDB_LDAP_REFERRAL FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL FEDFS_ERR_PATH_TYPE_UNSUPP FEDFS_ERR_NOTSUPP FEDFS_ERR_DELAY FEDFS_ERR_NO_CACHE FEDFS_ERR_UNKNOWN_CACHE FEDFS_ERR_NO_CACHE_UPDATE

5.5. FEDFS_CREATE_REPLICATION

5.5.1. Synopsis

5.5.1. あらすじ

Set an FSN representing the replication information for the fileset containing the pathname.

パス名を含むファイルセットの複製情報を表すFSNを設定します。

5.5.2. Description

5.5.2. 説明

This operation indicates the replication information to be returned for a particular fileset. An NFSv4 client might request fs_locations or fs_locations_info at any time to detect other copies of this fileset, and this operation supports this by supplying the FSN the fileserver should use to respond. This FSN should be associated with the entire fileset in which the path resides and should be used to satisfy fs_locations or fs_locations_info attribute requests whenever no junction is being accessed; if a junction is being accessed, the FSN specified by FEDFS_CREATE_JUNCTION will take precedence. Setting the replication FSN on a fileset that already has a replication FSN set is allowed.

この操作は、特定のファイルセットについて返される複製情報を示します。 NFSv4クライアントは、このファイルセットの他のコピーを検出するために、いつでもfs_locationsまたはfs_locations_infoを要求する可能性があり、この操作は、ファイルサーバーが応答に使用するFSNを提供することでこれをサポートします。このFSNは、パスが存在するファイルセット全体に関連付けられている必要があり、ジャンクションにアクセスしていないときは常に、fs_locationsまたはfs_locations_info属性要求を満たすために使用する必要があります。ジャンクションにアクセスしている場合、FEDFS_CREATE_JUNCTIONで指定されたFSNが優先されます。すでにレプリケーションFSNセットが設定されているファイルセットにレプリケーションFSNを設定することができます。

This operation differs from FEDFS_CREATE_JUNCTION in that it controls a fileset-wide attribute not associated with a junction.

この操作は、ジャンクションに関連付けられていないファイルセット全体の属性を制御するという点でFEDFS_CREATE_JUNCTIONとは異なります。

The server SHOULD permit this operation even on read-only filesets but MUST return FEDFS_ERR_ROFS if this is not possible.

サーバーは、読み取り専用のファイルセットでもこの操作を許可する必要があります（SHOULD）が、これが不可能な場合はFEDFS_ERR_ROFSを返す必要があります。

If the path contains a character that is not supported by the server, then status FEDFS_ERR_BADCHAR MUST be returned.

パスにサーバーでサポートされていない文字が含まれている場合は、ステータスFEDFS_ERR_BADCHARを返す必要があります。

The path is REQUIRED to exist and be completely local to the server. It MUST NOT contain a junction. If any component of the path is a junction, then this operation MUST fail with status FEDFS_ERR_NOTLOCAL. The path might contain a symbolic link (if supported by the local server), but the traversal of the path MUST remain within the server-local namespace.

パスは存在し、サーバーに対して完全にローカルであることが必要です。ジャンクションを含めることはできません。パスのいずれかのコンポーネントがジャンクションである場合、この操作はステータスFEDFS_ERR_NOTLOCALで失敗する必要があります。パスにはシンボリックリンクが含まれている可能性がありますが（ローカルサーバーでサポートされている場合）、パスのトラバーサルはサーバーローカルの名前空間内にとどまる必要があります。

The same FSN value SHOULD be associated with all replicas of a file system. Depending on the underlying representation, the FSN associated with a file system might or might not be replicated automatically with the file system replication mechanism. Therefore, if FEDFS_CREATE_REPLICATION is used on one replica of a file system, it SHOULD be used on all replicas.

同じFSN値は、ファイルシステムのすべてのレプリカに関連付けられる必要があります（SHOULD）。基礎となる表現に応じて、ファイルシステムに関連付けられたFSNは、ファイルシステムレプリケーションメカニズムで自動的にレプリケートされる場合とされない場合があります。したがって、ファイルシステムの1つのレプリカでFEDFS_CREATE_REPLICATIONを使用する場合は、すべてのレプリカで使用する必要があります（SHOULD）。

5.5.3. Errors

5.5.3. エラー

5.6. FEDFS_DELETE_REPLICATION

5.6.1. Synopsis

5.6.1. あらすじ

Remove the replication information for the fileset containing the pathname.

パス名を含むファイルセットの複製情報を削除します。

5.6.2. Description

5.6.2. 説明

This operation removes any replication information from the fileset in which the path resides, such that NFSv4 client requests for fs_locations or fs_locations_info in the absence of a junction will not be satisfied.

この操作により、パスが存在するファイルセットからレプリケーション情報が削除され、ジャンクションがない場合にNFSv4クライアントがfs_locationsまたはfs_locations_infoを要求することはできなくなります。

This operation differs from FEDFS_DELETE_JUNCTION in that it controls a fileset-wide attribute not associated with a junction.

この操作は、ジャンクションに関連付けられていないファイルセット全体の属性を制御するという点でFEDFS_DELETE_JUNCTIONとは異なります。

The server SHOULD permit this operation even on read-only filesets but MUST return FEDFS_ERR_ROFS if this is not possible.

If the path contains a character that is not supported by the server, then status FEDFS_ERR_BADCHAR MUST be returned.

パスにサーバーでサポートされていない文字が含まれている場合は、ステータスFEDFS_ERR_BADCHARを返す必要があります。

パスは存在し、サーバーに対して完全にローカルであることが必要です。ジャンクションを含めることはできません。パスのいずれかのコンポーネントがジャンクションである場合、この操作はステータスFEDFS_ERR_NOTLOCALで失敗する必要があります。

5.6.3. Errors

5.6.3. エラー

FEDFS_ERR_ACCESS FEDFS_ERR_BADCHAR FEDFS_ERR_BADNAME FEDFS_ERR_NAMETOOLONG FEDFS_ERR_LOOP FEDFS_ERR_BADXDR FEDFS_ERR_INVAL FEDFS_ERR_IO FEDFS_ERR_NOTJUNCT FEDFS_ERRFSFERR_FEND_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FERR_FFS_ERRFS_ERRFS_FERR_FFS_FFS_FFS_FFS_FFS_FFS_FFS_FFS

5.7. FEDFS_LOOKUP_REPLICATION

5.7.1. Synopsis

5.7.1. あらすじ

Query the server to discover the current replication information (if any) at the given path.

サーバーに照会して、指定されたパスで現在のレプリケーション情報（存在する場合）を検出します。

5.7.2. Description

5.7.2. 説明

This operation queries a server to determine whether a fileset containing the given path has replication information associated with it. If it does, the FSN for that replication information is returned.

この操作はサーバーに照会して、指定されたパスを含むファイルセットに複製情報が関連付けられているかどうかを判断します。含まれている場合、そのレプリケーション情報のFSNが返されます。

This operation differs from FEDFS_LOOKUP_JUNCTION in that it inquires about a fileset-wide attribute not associated with a junction.

この操作は、ジャンクションに関連付けられていないファイルセット全体の属性について照会するという点でFEDFS_LOOKUP_JUNCTIONとは異なります。

If the path contains a character that is not supported by the server, then status FEDFS_ERR_BADCHAR MUST be returned.

パスにサーバーでサポートされていない文字が含まれている場合は、ステータスFEDFS_ERR_BADCHARを返す必要があります。

Interpretation of the resolve parameter and the procedure's results shall be the same as specified in Section 5.4 for the FEDFS_LOOKUP_JUNCTION operation.

resolveパラメータとプロシージャの結果の解釈は、FEDFS_LOOKUP_JUNCTION操作のセクション5.4で指定されたものと同じでなければなりません。

5.7.3. Errors

5.7.3. エラー

FEDFS_ERR_ACCESS FEDFS_ERR_BADCHAR FEDFS_ERR_BADNAME FEDFS_ERR_NAMETOOLONG FEDFS_ERR_LOOP FEDFS_ERR_BADXDR FEDFS_ERR_INVAL FEDFS_ERR_IO FEDFS_ERR_NOTJUNCT FEDFS_ERR_NOTLOCAL FEDFS_ERR_PERM FEDFS_ERR_SVRFAULT FEDFS_ERR_NSDB_ROUTE FEDFS_ERR_NSDB_DOWN FEDFS_ERR_NSDB_CONN FEDFS_ERR_NSDB_AUTH FEDFS_ERR_NSDB_LDAP FEDFS_ERR_NSDB_LDAP_VAL FEDFS_ERR_NSDB_NONCE FEDFS_ERR_NSDB_NOFSN FEDFS_ERR_NSDB_NOFSL FEDFS_ERR_NSDB_RESPONSE FEDFS_ERR_NSDB_FAULT FEDFS_ERR_NSDB_PARAMS FEDFS_ERR_NSDB_LDAP_REFERRAL FEDFS_ERR_NSDB_LDAP_REFERRAL_VAL FEDFS_ERR_NSDB_LDAP_REFERRAL_NOTFOLLOWED FEDFS_ERR_NSDB_PARAMS_LDAP_REFERRAL FEDFS_ERR_PATH_TYPE_UNSUPP FEDFS_ERR_NOTSUPP FEDFS_ERR_DELAY FEDFS_ERR_NO_CACHE FEDFS_ERR_UNKNOWN_CACHE

5.8. FEDFS_SET_NSDB_PARAMS

5.8.1. Synopsis

5.8.1. あらすじ

Set the connection parameters for the specified NSDB.

指定されたNSDBの接続パラメーターを設定します。

5.8.2. Description

5.8.2. 説明

This operation allows an administrator to set the connection parameters for a given NSDB.

この操作により、管理者は特定のNSDBの接続パラメーターを設定できます。

If a record for the given NSDB does not exist, a new record is created with the specified connection parameters.

指定されたNSDBのレコードが存在しない場合、指定された接続パラメータを使用して新しいレコードが作成されます。

If a record for the given NSDB does exist, the existing connection parameters are replaced with the specified connection parameters.

指定されたNSDBのレコードが存在する場合、既存の接続パラメーターは指定された接続パラメーターに置き換えられます。

An NSDB is specified using a FedFsNsdbName. The rules in Section 4.1 define when two FedFsNsdbNames are considered equal.

NSDBは、FedFsNsdbNameを使用して指定されます。セクション4.1のルールは、2つのFedFsNsdbNamesが等しいと見なされるタイミングを定義します。

The given NSDB need not be referenced by any junctions on the fileserver. This situation will occur when connection parameters for a new NSDB are installed.

指定されたNSDBは、ファイルサーバー上のジャンクションによって参照される必要はありません。この状況は、新しいNSDBの接続パラメーターがインストールされるときに発生します。

The format of the connection parameters is described in Section 4.

接続パラメータの形式については、セクション4で説明します。

On success, this operation returns FEDFS_OK. When the operation returns, the new connection parameters SHOULD be used for all subsequent LDAP connections to the given NSDB. Existing connections MAY be terminated and re-established using the new connection parameters. The connection parameters SHOULD be durable across fileserver reboots.

成功した場合、この操作はFEDFS_OKを返します。操作が戻ると、新しい接続パラメータは、指定されたNSDBへの後続のすべてのLDAP接続に使用されるべきです（SHOULD）。新しい接続パラメーターを使用して、既存の接続を終了して再確立することができます（MAY）。接続パラメータは、ファイルサーバーの再起動後も持続する必要があります（SHOULD）。

On failure, an error value indicating the type of error is returned. If the operation's associated user does not have sufficient permissions to create/modify NSDB connection parameters, the operation MUST return FEDFS_ERR_ACCESS.

失敗すると、エラーのタイプを示すエラー値が返されます。操作に関連付けられたユーザーに、NSDB接続パラメーターを作成/変更するための十分な権限がない場合、操作はFEDFS_ERR_ACCESSを返す必要があります。

5.8.3. Errors

5.8.3. エラー

FEDFS_ERR_ACCESS FEDFS_ERR_BADCHAR FEDFS_ERR_BADNAME FEDFS_ERR_BADXDR FEDFS_ERR_INVAL FEDFS_ERR_IO FEDFS_ERR_NOSPC FEDFS_ERR_SVRFAULT FEDFS_ERR_NOTSUPP FEDFS_ERR_DELAY

5.9. FEDFS_GET_NSDB_PARAMS

5.9.1. Synopsis

5.9.1. あらすじ

Get the connection parameters for the specified NSDB.

指定されたNSDBの接続パラメーターを取得します。

5.9.2. Description

5.9.2. 説明

This operations allows an administrator to retrieve connection parameters, if they exist, for the given NSDB.

この操作により、管理者は、指定されたNSDBの接続パラメーターが存在する場合、それらを取得できます。

An NSDB is specified using a FedFsNsdbName. The rules in Section 4.1 define when two FedFsNsdbNames are considered equal.

NSDBは、FedFsNsdbNameを使用して指定されます。セクション4.1のルールは、2つのFedFsNsdbNamesが等しいと見なされるタイミングを定義します。

A set of connection parameters is considered a match if their associated NSDB is equal (as defined in Section 4.1) to the operation's NSDB argument. Therefore, there is at most one set of connection parameters that can match the query described by this operation.

関連付けられたNSDBがオペレーションのNSDB引数と等しい（4.1節で定義されている）場合、一連の接続パラメータは一致と見なされます。したがって、この操作で記述されたクエリに一致できる接続パラメーターのセットは最大で1つです。

The format of the connection parameters is described in Section 4.

接続パラメータの形式については、セクション4で説明します。

On success, this operation returns FEDFS_OK and the connection parameters on record for the given NSDB.

成功すると、この操作はFEDFS_OKと、指定されたNSDBのレコードの接続パラメーターを返します。

On failure, an error value indicating the type of error is returned. This operation MUST return FEDFS_ERR_NSDB_PARAMS to indicate that there are no connection parameters on record for the given NSDB. If the operation's associated user does not have sufficient permissions to view NSDB connection parameters, the operation MUST return FEDFS_ERR_ACCESS.

失敗すると、エラーのタイプを示すエラー値が返されます。この操作はFEDFS_ERR_NSDB_PARAMSを返して、指定されたNSDBのレコードに接続パラメータがないことを示す必要があります。操作に関連付けられたユーザーにNSDB接続パラメーターを表示するための十分な権限がない場合、操作はFEDFS_ERR_ACCESSを返す必要があります。

5.9.3. Errors

5.9.3. エラー

FEDFS_ERR_ACCESS FEDFS_ERR_BADCHAR FEDFS_ERR_BADNAME FEDFS_ERR_BADXDR FEDFS_ERR_INVAL FEDFS_ERR_IO FEDFS_ERR_SVRFAULT FEDFS_ERR_NSDB_PARAMS FEDFS_ERR_NOTSUPP FEDFS_ERR_DELAY

5.10. FEDFS_GET_LIMITED_NSDB_PARAMS

5.10.1. Synopsis

5.10.1. あらすじ

Get a limited subset of the connection parameters for the specified NSDB.

指定されたNSDBの接続パラメータの限定されたサブセットを取得します。

5.10.2. Description

5.10.2. 説明

This operation allows an administrator to retrieve a limited subset of information on the connection parameters, if they exist, for the given NSDB.

この操作により、管理者は、指定されたNSDBの接続パラメータが存在する場合、接続パラメータに関する限られた情報を取得できます。

An NSDB is specified using a FedFsNsdbName. The rules in Section 4.1 define when two FedFsNsdbNames are considered equal.

NSDBは、FedFsNsdbNameを使用して指定されます。セクション4.1のルールは、2つのFedFsNsdbNamesが等しいと見なされるタイミングを定義します。

This operation returns a limited subset of the connection parameters. Only the FedFsConnectionSec mechanism that is used to protect communication between the fileserver and NSDB is returned.

この操作は、接続パラメーターの限られたサブセットを返します。ファイルサーバーとNSDB間の通信を保護するために使用されるFedFsConnectionSecメカニズムのみが返されます。

Viewing the limited subset of NSDB connection parameters returned by FEDFS_GET_LIMITED_NSDB_PARAMS MAY be a less privileged operation than viewing the entire set of NSDB connection parameters returned by FEDFS_GET_NSDB_PARAMS. For example, the full contents of an NSDB's connection parameters could contain sensitive information for some security mechanisms. FEDFS_GET_LIMITED_NSDB_PARAMS allows the fileserver to communicate a subset of the connection parameters (the security mechanism) to users with sufficient permissions without revealing more sensitive information.

FEDFS_GET_LIMITED_NSDB_PARAMSによって返されたNSDB接続パラメーターの制限されたサブセットを表示することは、FEDFS_GET_NSDB_PARAMSによって返されたNSDB接続パラメーターのセット全体を表示することよりも、特権の少ない操作になる場合があります。たとえば、NSDBの接続パラメータの完全な内容には、一部のセキュリティメカニズムの機密情報が含まれる場合があります。 FEDFS_GET_LIMITED_NSDB_PARAMSを使用すると、ファイルサーバーは、より機密性の高い情報を公開することなく、十分な権限を持つユーザーに接続パラメーターのサブセット（セキュリティメカニズム）を伝達できます。

On success, this operation returns FEDFS_OK and the FedFsConnectionSec value on record for the given NSDB.

成功した場合、この操作は、指定されたNSDBのレコードのFEDFS_OKおよびFedFsConnectionSec値を返します。

On failure, an error value indicating the type of error is returned. This operation MUST return FEDFS_ERR_NSDB_PARAMS to indicate that there are no connection parameters on record for the given NSDB. If the operation's associated user does not have sufficient permissions to view the subset of NSDB connection parameters returned by this procedure, the operation MUST return FEDFS_ERR_ACCESS.

失敗すると、エラーのタイプを示すエラー値が返されます。この操作はFEDFS_ERR_NSDB_PARAMSを返して、指定されたNSDBのレコードに接続パラメータがないことを示す必要があります。操作に関連付けられたユーザーに、このプロシージャによって返されるNSDB接続パラメーターのサブセットを表示するための十分な権限がない場合、操作はFEDFS_ERR_ACCESSを返す必要があります。

5.10.3. Errors

5.10.3. エラー

FEDFS_ERR_ACCESS FEDFS_ERR_BADCHAR FEDFS_ERR_BADNAME FEDFS_ERR_BADXDR FEDFS_ERR_INVAL FEDFS_ERR_IO FEDFS_ERR_SVRFAULT FEDFS_ERR_NSDB_PARAMS FEDFS_ERR_NOTSUPP FEDFS_ERR_DELAY

6. Security Considerations

6. セキュリティに関する考慮事項

The security considerations of [RFC5531] apply to the protocol described in this document. The ONC RPC protocol supports authentication, integrity, and privacy via the RPCSEC_GSS framework [RFC2203]. Fileservers that support the FedFS administration protocol described in this document MUST support RPCSEC_GSS.

[RFC5531]のセキュリティに関する考慮事項は、このドキュメントで説明されているプロトコルに適用されます。 ONC RPCプロトコルは、RPCSEC_GSSフレームワーク[RFC2203]を介して認証、整合性、およびプライバシーをサポートします。このドキュメントで説明されているFedFS管理プロトコルをサポートするファイルサーバーは、RPCSEC_GSSをサポートする必要があります。

As with NFSv4.1 (see Section 2.2.1.1.1.1 of [RFC5661]), FedFS administration protocol clients and servers MUST support RPCSEC_GSS's integrity and authentication services. FedFS administration protocol servers MUST support RPCSEC_GSS's privacy service. FedFS administration protocol clients SHOULD support RPCSEC_GSS's privacy service. When RPCSEC_GSS is employed on behalf of the FedFS administration protocol, RPCSEC_GSS data integrity SHOULD be used.

NFSv4.1（[RFC5661]のセクション2.2.1.1.1.1を参照）と同様に、FedFS管理プロトコルのクライアントとサーバーは、RPCSEC_GSSの整合性と認証サービスをサポートする必要があります。 FedFS管理プロトコルサーバーは、RPCSEC_GSSのプライバシーサービスをサポートする必要があります。 FedFS管理プロトコルクライアントは、RPCSEC_GSSのプライバシーサービスをサポートする必要があります（SHOULD）。 FedFS管理プロトコルの代わりにRPCSEC_GSSを使用する場合は、RPCSEC_GSSデータ整合性を使用する必要があります（SHOULD）。

It is strongly RECOMMENDED that an Access Control Service be employed to restrict access to a fileserver's FedFS administration configuration data via the FedFS administrative protocol to prevent FedFS namespace corruption and protect NSDB communication parameters.

FedFS管理プロトコルを介したファイルサーバーのFedFS管理構成データへのアクセスを制限し、FedFS名前空間の破損を防ぎ、NSDB通信パラメーターを保護するために、アクセスコントロールサービスを使用することを強くお勧めします。

For example, when the FedFsNsdbParams secType field value FEDFS_SEC_TLS is chosen, the payload is used to provision the trust anchor root certificate for TLS secure communication between the fileserver and the NSDB. In this case, RPCSEC_GSS with data integrity SHOULD be employed along with an Access Control Service to restrict access to domain administrators.

たとえば、FedFsNsdbParams secTypeフィールド値FEDFS_SEC_TLSが選択されている場合、ペイロードは、ファイルサーバーとNSDB間のTLSセキュア通信用のトラストアンカールート証明書をプロビジョニングするために使用されます。この場合、データ整合性を備えたRPCSEC_GSSを、ドメイン管理者へのアクセスを制限するためのアクセス制御サービスと共に使用する必要があります（SHOULD）。

FEDFS_GET_LIMITED_NSDB_PARAMS's interaction with the NSDB's connection parameters is discussed in Section 5.10.2.

FEDFS_GET_LIMITED_NSDB_PARAMSとNSDBの接続パラメータの相互作用については、5.10.2項で説明しています。

7. IANA Considerations

7. IANAに関する考慮事項

A range of ONC RPC program numbers were assigned for use by FedFS using the procedure described in Section 8.3 ("Program Number Assignment") of [RFC5531]. The FedFS range is:

[RFC5531]のセクション8.3（「プログラム番号の割り当て」）で説明されている手順を使用して、FedFSで使用するためにさまざまなONC RPCプログラム番号が割り当てられました。 FedFSの範囲は次のとおりです。

IETF NFSv4 Working Group - FedFS 100418 - 100421

IETF NFSv4ワーキンググループ-FedFS 100418-100421

Program 100418 has been removed from the reserved FedFS range and assigned to version 1 of the ONC RPC program (100418) described in this document with the short name "fedfs_admin", a Description of "FedFS Administration", and a reference to RFC 7533.

プログラム100418は予約済みのFedFS範囲から削除され、このドキュメントで説明されているONC RPCプログラム（100418）のバージョン1に、「fedfs_admin」という短い名前、「FedFS管理」の説明、およびRFC 7533への参照とともに割り当てられています。

8. References

8. 参考文献

8.1. Normative References

8.1. 引用文献

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, <http://www.rfc-editor.org/info/rfc2119>.

[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、1997年3月、<http://www.rfc-editor.org/info/rfc2119>。

[RFC2203] Eisler, M., Chiu, A., and L. Ling, "RPCSEC_GSS Protocol Specification", RFC 2203, September 1997, <http://www.rfc-editor.org/info/rfc2203>.

[RFC2203] Eisler、M.、Chiu、A。、およびL. Ling、「RPCSEC_GSS Protocol Specification」、RFC 2203、1997年9月、<http://www.rfc-editor.org/info/rfc2203>。

[RFC4122] Leach, P., Mealling, M., and R. Salz, "A Universally Unique IDentifier (UUID) URN Namespace", RFC 4122, July 2005, <http://www.rfc-editor.org/info/rfc4122>.

[RFC4122] Leach、P.、Mealling、M。、およびR. Salz、「Universally Unique IDentifier（UUID）URN Namespace」、RFC 4122、2005年7月、<http://www.rfc-editor.org/info / rfc4122>。

[RFC4506] Eisler, M., Ed., "XDR: External Data Representation Standard", STD 67, RFC 4506, May 2006, <http://www.rfc-editor.org/info/rfc4506>.

[RFC4506] Eisler、M。、編、「XDR：外部データ表現標準」、STD 67、RFC 4506、2006年5月、<http://www.rfc-editor.org/info/rfc4506>。

[RFC4511] Sermersheim, J., Ed., "Lightweight Directory Access Protocol (LDAP): The Protocol", RFC 4511, June 2006, <http://www.rfc-editor.org/info/rfc4511>.

[RFC4511] Sermersheim、J。、編、「ライトウェイトディレクトリアクセスプロトコル（LDAP）：プロトコル」、RFC 4511、2006年6月、<http://www.rfc-editor.org/info/rfc4511>。

[RFC4513] Harrison, R., Ed., "Lightweight Directory Access Protocol (LDAP): Authentication Methods and Security Mechanisms", RFC 4513, June 2006, <http://www.rfc-editor.org/info/rfc4513>.

[RFC4513] Harrison、R。、編、「Lightweight Directory Access Protocol（LDAP）：Authentication Methods and Security Mechanisms」、RFC 4513、2006年6月、<http://www.rfc-editor.org/info/rfc4513> 。

[RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security (TLS) Protocol Version 1.2", RFC 5246, August 2008, <http://www.rfc-editor.org/info/rfc5246>.

[RFC5246] Dierks、T。およびE. Rescorla、「The Transport Layer Security（TLS）Protocol Version 1.2」、RFC 5246、2008年8月、<http://www.rfc-editor.org/info/rfc5246>。

[RFC5280] Cooper, D., Santesson, S., Farrell, S., Boeyen, S., Housley, R., and W. Polk, "Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", RFC 5280, May 2008, <http://www.rfc-editor.org/info/rfc5280>.

[RFC5280] Cooper、D.、Santesson、S.、Farrell、S.、Boeyen、S.、Housley、R。、およびW. Polk、「Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List（CRL）Profile "、RFC 5280、2008年5月、<http://www.rfc-editor.org/info/rfc5280>。

[RFC5531] Thurlow, R., "RPC: Remote Procedure Call Protocol Specification Version 2", RFC 5531, May 2009, <http://www.rfc-editor.org/info/rfc5531>.

[RFC5531] Thurlow、R。、「RPC：Remote Procedure Call Protocol Specification Version 2」、RFC 5531、2009年5月、<http://www.rfc-editor.org/info/rfc5531>。

[RFC7530] Haynes, T., Ed. and D. Noveck, Ed., "Network File System (NFS) Version 4 Protocol", RFC 7530, March 2015, <http://www.rfc-editor.org/info/rfc7530>.

[RFC7530]ヘインズ、T。、エド。およびD. Noveck、編、「ネットワークファイルシステム（NFS）バージョン4プロトコル」、RFC 7530、2015年3月、<http://www.rfc-editor.org/info/rfc7530>。

8.2. Informative References

8.2. 参考引用

[MS-CIFS] Microsoft Corporation, "Common Internet File System (CIFS) Protocol Specification", MS-CIFS 24.0, May 2014.

[MS-CIFS] Microsoft Corporation、「Common Internet File System（CIFS）Protocol Specification」、MS-CIFS 24.0、2014年5月。

[MS-SMB] Microsoft Corporation, "Server Message Block (SMB) Protocol Specification", MS-SMB 43.0, May 2014.

[MS-SMB] Microsoft Corporation、「Server Message Block（SMB）Protocol Specification」、MS-SMB 43.0、2014年5月。

[MS-SMB2] Microsoft Corporation, "Server Message Block (SMB) Version 2 Protocol Specification", MS-SMB2 46.0, May 2014.

[MS-SMB2] Microsoft Corporation、「Server Message Block（SMB）Version 2 Protocol Specification」、MS-SMB2 46.0、2014年5月。

[RFC5661] Shepler, S., Ed., Eisler, M., Ed., and D. Noveck, Ed., "Network File System (NFS) Version 4 Minor Version 1 Protocol", RFC 5661, January 2010, <http://www.rfc-editor.org/info/rfc5661>.

[RFC5661] Shepler、S.、Ed。、Eisler、M.、Ed。、and D. Noveck、Ed。、 "Network File System（NFS）Version 4 Minor Version 1 Protocol"、RFC 5661、January 2010、<http ：//www.rfc-editor.org/info/rfc5661>。

[RFC5662] Shepler, S., Ed., Eisler, M., Ed., and D. Noveck, Ed., "Network File System (NFS) Version 4 Minor Version 1 External Data Representation Standard (XDR) Description", RFC 5662, January 2010, <http://www.rfc-editor.org/info/rfc5662>.

[RFC5662] Shepler、S。、編、Eisler、M。、編、およびD. Noveck、編、「ネットワークファイルシステム（NFS）バージョン4マイナーバージョン1外部データ表現標準（XDR）の説明」、RFC 5662、2010年1月、<http://www.rfc-editor.org/info/rfc5662>。

[RFC5716] Lentini, J., Everhart, C., Ellard, D., Tewari, R., and M. Naik, "Requirements for Federated File Systems", RFC 5716, January 2010, <http://www.rfc-editor.org/info/rfc5716>.

[RFC5716] Lentini、J.、Everhart、C.、Ellard、D.、Tewari、R。、およびM. Naik、「Federated File Systems」の要件、RFC 5716、2010年1月、<http：//www.rfc -editor.org/info/rfc5716>。

[RFC7532] Lentini, J., Tewari, R., and C. Lever, Ed., "Namespace Database (NSDB) Protocol for Federated File Systems", RFC 7532, March 2015, <http://www.rfc-editor.org/info/rfc7532>.

[RFC7532] Lentini、J.、Tewari、R。、およびC. Lever、編、「フェデレーテッドファイルシステムのネームスペースデータベース（NSDB）プロトコル」、RFC 7532、2015年3月、<http：//www.rfc-editor .org / info / rfc7532>。

Acknowledgments

謝辞

Daniel Ellard contributed significant parts of this document.

Daniel Ellardがこのドキュメントの重要な部分を寄稿しました。

The authors and editor would like to thank Craig Everhart and Manoj Naik, who were co-authors of an earlier draft version of this document. In addition, we would like to thank Paul Lemahieu, Mario Wurzl, and Robert Thurlow for helping to author this document.

著者と編集者は、このドキュメントの以前のドラフトバージョンの共著者であるCraig EverhartとManoj Naikに感謝します。また、このドキュメントの作成を支援してくれたPaul Lemahieu、Mario Wurzl、およびRobert Thurlowに感謝します。

We would like to thank Trond Myklebust for suggesting improvements to the FSL pathname format, David Noveck for his suggestions on internationalization and path encoding rules, and Nicolas Williams for his suggestions.

FSLパス名形式の改善を提案してくれたTrond Myklebustに、国際化とパスエンコーディングルールの提案にDavid Noveckが、提案にNicolas Williamsに感謝します。

The editor gratefully acknowledges the IESG reviewers, whose constructive comments helped make this a much stronger document.

編集者はIESGレビュアーに感謝します。その建設的なコメントにより、これはより強力なドキュメントになりました。

Finally, we would like to thank Andy Adamson, Rob Thurlow, and Tom Haynes for helping to get this document out the door.

最後に、このドキュメントの公開を支援してくれたAndy Adamson、Rob Thurlow、Tom Haynesに感謝します。

The extract.sh shell script and formatting conventions were first described by the authors of the NFSv4.1 XDR specification [RFC5662].

extract.shシェルスクリプトとフォーマット規則は、NFSv4.1 XDR仕様[RFC5662]の作成者によって最初に説明されました。

Authors' Addresses

著者のアドレス

James Lentini NetApp 1601 Trapelo Rd, Suite 16 Waltham, MA 02451 United States

James Lentini NetApp 1601 Trapelo Rd、Suite 16 Waltham、MA 02451アメリカ合衆国

   Phone: +1 781-768-5359
   EMail: jlentini@netapp.com

Renu Tewari IBM Almaden 650 Harry Rd San Jose, CA 95120 United States

Renu Tewari IBM Almaden 650 Harry Rd San Jose、CA 95120アメリカ合衆国

   EMail: tewarir@us.ibm.com

Charles Lever (editor) Oracle Corporation 1015 Granger Avenue Ann Arbor, MI 48104 United States

Charles Lever（editor）Oracle Corporation 1015 Granger Avenue Ann Arbor、MI 48104 United States

   Phone: +1 248-614-5091
   EMail: chuck.lever@oracle.com