Network Working Group Spencer Shepler Internet Draft Sun Microsystems Document: draft-shepler-nfsv4-mib-00.txt May 2003 NFS version 4 MIB for Server Implementations Status of this Memo This document is an Internet-Draft and is subject to all provisions of Section 10 of RFC2026. This document is an Internet-Draft. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet- Drafts as reference material or to cite them other than as "work in progress." To view the entire list of current Internet-Drafts, please check the "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow Directories on ftp.is.co.za (Africa), ftp.nordu.net (Northern Europe), ftp.nis.garr.it (Southern Europe), munnari.oz.au (Pacific Rim), ftp.ietf.org (US East Coast), or ftp.isi.edu (US West Coast). Abstract Insert your abstract here for the document. Refer to other Internet Drafts for examples of what this is supposed to contain and length. It usually is about two or three paragraphs long. Key Words 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]. Expires: November 2003 [Page 1] Title NFS version 4 MIB May 2003 Table of Contents 1. The Internet-Standard Management Framework . . . . . . . . . 3 2. Discussion . . . . . . . . . . . . . . . . . . . . . . . . . 3 3. MIB Definitions . . . . . . . . . . . . . . . . . . . . . . 5 4. Security Considerations . . . . . . . . . . . . . . . . . 34 5. IANA Considerations . . . . . . . . . . . . . . . . . . . 34 6. Normative References . . . . . . . . . . . . . . . . . . . 35 7. Informative References . . . . . . . . . . . . . . . . . . 35 8. Author's Address . . . . . . . . . . . . . . . . . . . . . 37 9. Copyright . . . . . . . . . . . . . . . . . . . . . . . . 38 Expires: November 2003 [Page 2] Title NFS version 4 MIB May 2003 1. The Internet-Standard Management Framework For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 of RFC 3410 [RFC3410]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. MIB objects are generally accessed through the Simple Network Management Protocol (SNMP). Objects in the MIB are defined using the mechanisms defined in the Structure of Management Information (SMI). This memo specifies a MIB module that is compliant to the SMIv2, which is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580]. It is the purpose of this document to define managed objects which describe the behavior of an SNMP entity, as defined in the SNMP architecture STD 62, [RFC3411]. 2. Discussion The reader of this MIB is assumed to be familiar with the NFS version 4 protocol, as defined in [RFC3530]. In the tradition of the Simple Network Management Protocol (SNMP) this MIB defines the minimum number of objects necessary for providing as rich a set of management information. Thus, this MIB provides a set of objects from which other management information may be derived. Additionally, this MIB structure is intended to satisfy fault, configuration, performance, accounting, and security management for an NFS version 4 server implementation. There may be a need for providing a MIB for the client side implementation of the protocol, as well as intermediaries such as a file cache. This will be covered in a future MIB definition. It is currently structured around objects such as clients, filesystems and operations in the context of a filesystem. Note that while it may be possible to provide information at the granularity of a file, that would potentially increase the amount of information that would have to be collected. The root of the objects in this MIB is the nfsv4mgmt object. Below this object, the following tables exist. serverTable lists all server instances that the SNMP agent provides objects for. Expires: November 2003 [Page 3] Title NFS version 4 MIB May 2003 fsTable lists all root-level filesystem instances known. This table contains an entry for each fs_root pathname that this server would present in a fs_locations attribute. fsLockTable lists all locks and information related to locks, on a per file system basis. Each object contains a fairly standard list of statistics. Some would appear to be redundant, and could be computed from lower-level objects. However, some of the objects are transient (clients, and even filesystems), so we felt that duplicating them was not too high of a price for the availability of good information. There are no doubt still some important statistics and other information still missing; the authors would welcome any comments. One area where there could be quite a bit of value is in tracking the RPC layer as well. Expires: November 2003 [Page 4] Title NFS version 4 MIB May 2003 3. MIB Definitions nfsv4-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-IDENTITY, OBJECT-TYPE, Unsigned32, IpAddress, Counter32, Counter64, experimental -- mib-2 FROM SNMPv2-SMI TEXTUAL-CONVENTION, RowStatus, DisplayString, TruthValue, DateAndTime FROM SNMPv2-TC InterfaceIndex FROM IF-MIB MODULE-COMPLIANCE, OBJECT-GROUP -- MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF ; nfsv4Module MODULE-IDENTITY LAST-UPDATED "0305280001Z" -- May 28, 2003 ORGANIZATION "NFSv4 Working Group" CONTACT-INFO " Spencer Shepler Postal: 7808 Moonflower Drive Austin, TX USA 78750 Tel: +1 512-349-9376 E-mail: spencer.shepler@sun.com" DESCRIPTION "NFSv4 (RFC3530) MIB for Server implementations" ::= { experimental 1 } -- We need to get an experimental number for this MIB. nfsv4Objects OBJECT-IDENTITY STATUS current DESCRIPTION "NFSv4 MIB objects are all defined in this branch." ::= { nfsv4Module 1 } nfsv4ServerObjects OBJECT-IDENTITY Expires: November 2003 [Page 5] Title NFS version 4 MIB May 2003 STATUS current DESCRIPTION "NFSv4 MIB objects available at the Server implementation are all defined in this branch." ::= { nfsv4Objects 1 } nfsv4ClientObjects OBJECT-IDENTITY STATUS current DESCRIPTION "NFSv4 MIB objects available at the Client implementation are all defined in this branch." ::= { nfsv4Objects 2 } nfsv4Notifications OBJECT-IDENTITY STATUS current DESCRIPTION "NFSv4 MIB objects for providing traps and notifications." ::= { nfsv4Objects 3 } nfsv4Conformance OBJECT-IDENTITY STATUS current DESCRIPTION "NFSv4 MIB objects for describing conformance." ::= { nfsv4Objects 4 } -- Textual Conventions FsStateId ::= TEXTUAL-CONVENTION DISPLAY-HINT "255a" STATUS current DESCRIPTION "Opaque State ID." SYNTAX OCTET STRING (SIZE(0..8)) FsClientId ::= TEXTUAL-CONVENTION DISPLAY-HINT "255a" STATUS current DESCRIPTION "Opaque Client handle." SYNTAX OCTET STRING (SIZE(0..8)) FsFileHandle ::= TEXTUAL-CONVENTION DISPLAY-HINT "255a" STATUS current DESCRIPTION "Corresponds to the filehandle conventions." SYNTAX OCTET STRING (SIZE(0..128)) Expires: November 2003 [Page 6] Title NFS version 4 MIB May 2003 -- Object Definitions serverCount OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of server instances exported by the server. In a multi-homed server implementation, each interface could export a server." ::= { nfsv4ServerObjects 1 } -- -- we define an overall server table that descibes all the servers -- that are exported through this SNMP agent. In most cases, -- there is a single SNMP agent that services SNMP MIB requests -- for a multi-server, multi-homed system. serverTable OBJECT-TYPE SYNTAX SEQUENCE OF ServerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table describes overall objects and counters for each server that is exported." ::= { nfsv4ServerObjects 2 } serverEntry OBJECT-TYPE SYNTAX ServerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This describes each entry of the server table. This table is indexed by the serverIndex object." INDEX { serverIndex } ::= { serverTable 1 } -- the errors and counters maintained are per-server, regardless -- of filesystems. in most cases, these error counters are updated -- whenever the server replies with the particular error to the -- client. In some cases however, the server generates an error -- on its own, without a client request tirggering the error. ServerEntry ::= SEQUENCE { serverIndex Unsigned32, serverName DisplayString, serverDescription DisplayString, numFs Counter32, numClients Counter32, nfsOkOps Counter32, Expires: November 2003 [Page 7] Title NFS version 4 MIB May 2003 accessErrs Counter32, adminRevokedErrs Counter32, attrNotSuppErrs Counter32, badCharErrs Counter32, badCookieErrs Counter32, badHandleErrs Counter32, badNameErrs Counter32, badOwnerErrs Counter32, badRangeErrs Counter32, badSeqIdErrs Counter32, badStateIdErrs Counter32, badTypeErrs Counter32, badXdrErrs Counter32, cbPathDownErrs Counter32, clidInuseErrs Counter32, deadlockErrs Counter32, delayErrs Counter32, deniedErrs Counter32, dquotErrs Counter32, existsErrs Counter32, expiredErrs Counter32, fBigErrs Counter32, fhExpiredErrs Counter32, fileOpenErrs Counter32, graceErrs Counter32, invalErrs Counter32, ioErrs Counter32, isDirErrs Counter32, leaseMovedErrs Counter32, lockedErrs Counter32, lockNotSuppErrs Counter32, lockRangeErrs Counter32, locksHeldErrs Counter32, verMisMatchErrs Counter32, mLinkErrs Counter32, movedErrs Counter32, nameTooLongErrs Counter32, noEntErrs Counter32, noFileHandleErrs Counter32, noGraceErrs Counter32, noSpaceErrs Counter32, notDirErrs Counter32, notEmptyErrs Counter32, notSuppErrs Counter32, notSameErrs Counter32, nxIoErrs Counter32, oldStateIdErrs Counter32, openModeErrs Counter32, Expires: November 2003 [Page 8] Title NFS version 4 MIB May 2003 opIllegalErrs Counter32, permErrs Counter32, readDirNoSpcErrs Counter32, reclaimBadErrs Counter32, reclaimConflictErrs Counter32, resourceErrs Counter32, restoreFhErrs Counter32, roFsErrs Counter32, sameErrs Counter32, serverFaultErrs Counter32, shareDeniedErrs Counter32, staleErrs Counter32, staleClientIdErrs Counter32, staleStateIdErrs Counter32, symlinkErrs Counter32, wrongSecErrs Counter32, xDevErrs Counter32 } serverIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is an index into the server table." ::= { serverEntry 1 } serverName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "This is a name for the server, typically in the same form as reported by the fs_location attribute." ::= { serverEntry 2 } serverDescription OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "Descriptive text for the server." ::= { serverEntry 3 } numFs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Expires: November 2003 [Page 9] Title NFS version 4 MIB May 2003 DESCRIPTION "Number of non-pseudo filesystems exported by this server." ::= { serverEntry 4 } numClients OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of clients that have accessed this server. In order to minimize impact in counting this, the server may count the times the server issued a ClientId, regardless of whether the same ClientId was issued previously." ::= { serverEntry 5 } nfsOkOps OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Counts the number of operations that completed successfully." ::= { serverEntry 6 } accessErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Permission denied errors. The client does not have the correct permission to perform the requested." ::= { serverEntry 7 } adminRevokedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Due to administrator intervention, the lockowner's record locks, share reservations, and delegations have been revoked by the server." ::= { serverEntry 8 } attrNotSuppErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Expires: November 2003 [Page 10] Title NFS version 4 MIB May 2003 DESCRIPTION "An attribute specified is not supported by the server. Does not apply to the GETATTR operation." ::= { serverEntry 9 } badCharErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A UTF-8 string contains a character which is not supported by the server in the context in which it being used." ::= { serverEntry 10 } badHandleErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Illegal NFS file handle errors." ::= { serverEntry 11 } badNameErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A name string in a request consists of valid UTF-8 characters supported by the server but the name is not supported by the server as a valid name for current operation." ::= { serverEntry 12 } badTypeErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times an attempt was made to create an object of a type not supported by the server." ::= { serverEntry 13 } badCookieErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Expires: November 2003 [Page 11] Title NFS version 4 MIB May 2003 DESCRIPTION "number of times READDIR cookie is stale." ::= { serverEntry 14 } badOwnerErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "An owner, owner_group, or ACL attribute value can not be translated to local representation." ::= { serverEntry 15 } badSeqIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times sequence number in a locking request is neither the next expected number or the last number processed." ::= { serverEntry 16 } badStateIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times StateId was not consistant with current server instance." ::= { serverEntry 17 } badRangeErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The range for a LOCK, LOCKT, or LOCKU operation is not appropriate to the allowable range of offsets for the server." ::= { serverEntry 18 } badXdrErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The server encountered an XDR decoding error Expires: November 2003 [Page 12] Title NFS version 4 MIB May 2003 while processing an operation." ::= { serverEntry 19 } cbPathDownErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The server is unable to successfully callback to client." ::= { serverEntry 20 } clidInuseErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times Client Id requested was already in use by another client." ::= { serverEntry 21 } deadlockErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The server has been able to determine a file locking deadlock condition for a blocking lock request." ::= { serverEntry 22 } delayErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times server returned the NFS4ERR_DELAY." ::= { serverEntry 23 } deniedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the server denied an attempt to lock a file." ::= { serverEntry 24 } dquotErrs OBJECT-TYPE Expires: November 2003 [Page 13] Title NFS version 4 MIB May 2003 SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times Quota exceeded errors were generated." ::= { serverEntry 25 } existsErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "File exists errors." ::= { serverEntry 26 } expiredErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times lease has expired while processing a request." ::= { serverEntry 27 } fBigErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of File too large errors." ::= { serverEntry 28 } fhExpiredErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a volatile file handle provided in the client request has already expired at the server." ::= { serverEntry 29 } fileOpenErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The operation can not be successfully processed because a file involved in the operation is Expires: November 2003 [Page 14] Title NFS version 4 MIB May 2003 currently open." ::= { serverEntry 30 } graceErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of requests that came in which could not be serviced because the server is in its grace period." ::= { serverEntry 31 } invalErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an invalid argument was received." ::= { serverEntry 32 } ioErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of I/O errors encountered by the server." ::= { serverEntry 33 } isDirErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the caller specified a directory in a non-directory operation." ::= { serverEntry 34 } leaseMovedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a lease being renewed is associated with a file system that has been migrated to a new server." ::= { serverEntry 35 } lockedErrs OBJECT-TYPE SYNTAX Counter32 Expires: November 2003 [Page 15] Title NFS version 4 MIB May 2003 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a read or write operation was attempted on a locked file." ::= { serverEntry 36 } lockNotSuppErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Server does not support atomic upgrade or downgrade of locks." ::= { serverEntry 37 } lockRangeErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a lock request is operating on a sub-range of a current lock for the lock owner and the server does not support this type of request." ::= { serverEntry 38 } locksHeldErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A CLOSE was attempted and file locks would exist after the CLOSE." ::= { serverEntry 39 } verMisMatchErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the server has received a request that specifies an unsupported minor version. The server must return a COMPOUND4res with a zero length operations result array." ::= { serverEntry 40 } mLinkErrs OBJECT-TYPE SYNTAX Counter32 Expires: November 2003 [Page 16] Title NFS version 4 MIB May 2003 MAX-ACCESS read-only STATUS current DESCRIPTION "Count of Too many hard links errors" ::= { serverEntry 41 } movedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a request came for a filehandle that was migrated to another server." ::= { serverEntry 42 } nameTooLongErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the filename in an operation was too long." ::= { serverEntry 43 } noEntErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the file or directory name specified does not exist." ::= { serverEntry 44 } noFileHandleErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times NFS4ERR_NOFILEHANDLE was returned." ::= { serverEntry 45 } noGraceErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A reclaim of client state has fallen outside of the grace period of the server. As a result, Expires: November 2003 [Page 17] Title NFS version 4 MIB May 2003 the server can not guarantee that conflicting state has not been provided to another client." ::= { serverEntry 46 } noSpaceErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the space on server's filesystem would have exceeded." ::= { serverEntry 47 } notDirErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a directory operation was attempted on a non-directory object." ::= { serverEntry 48 } notEmptyErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an attempt was made to remove a directory that was not empty." ::= { serverEntry 48 } notSuppErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an unsupported operation was attempted." ::= { serverEntry 49 } notSameErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the attributes were not same as provided to client." ::= { serverEntry 50 } Expires: November 2003 [Page 18] Title NFS version 4 MIB May 2003 nxIoErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a No such device or address error was issued." ::= { serverEntry 51 } oldStateIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a stateid was used which was issued in an earlier instance." ::= { serverEntry 52 } openModeErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The client attempted a READ, WRITE, LOCK or SETATTR operation not sanctioned by the stateid passed (e.g., writing to a file opened only for read)." ::= { serverEntry 53 } opIllegalErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "An illegal operation value has been specified in the argop field of a COMPOUND or CB_COMPOUND procedure." ::= { serverEntry 54 } permErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a privileged user operation was attempted by a non-provileged user." ::= { serverEntry 55 } Expires: November 2003 [Page 19] Title NFS version 4 MIB May 2003 readDirNoSpcErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a READDIR response could not be delivered due to space being exceeded." ::= { serverEntry 56 } reclaimBadErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The reclaim provided by the client does not match any of the server's state consistency checks and is bad." ::= { serverEntry 57 } reclaimConflictErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The reclaim provided by the client has encountered a conflict and can not be provided. Potentially indicates a misbehaving client." ::= { serverEntry 58 } resourceErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times resource exceeded error occured while processing a COMPOUND procedure." ::= { serverEntry 59 } restoreFhErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The RESTOREFH operation does not have a saved filehandle (identified by SAVEFH) to operate upon." ::= { serverEntry 60 } Expires: November 2003 [Page 20] Title NFS version 4 MIB May 2003 roFsErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a modifying operation was issued on a Read-only file system." ::= { serverEntry 61 } sameErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times NFS4ERR_SAME was issued." ::= { serverEntry 62 } serverFaultErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an error outside an NFSv4 protocol error occurred." ::= { serverEntry 63 } shareDeniedErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times OPEN failed because of share conflict." ::= { serverEntry 64 } staleErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times an invalid file handle was sent on a request." ::= { serverEntry 65 } staleClientIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Expires: November 2003 [Page 21] Title NFS version 4 MIB May 2003 DESCRIPTION "The number of times a client id was issued in a request, which could not be identified by the server." ::= { serverEntry 66 } staleStateIdErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a client used a stateid from an earlier server instance." ::= { serverEntry 67 } symlinkErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times LOOKUP and OPEN of a path refers to a symbolic link." ::= { serverEntry 68 } wrongSecErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times wrong security mechanism was used." ::= { serverEntry 69 } xDevErrs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a cross-device hard link was attempted." ::= { serverEntry 70 } -- -- the number of non-pseudo file systems that are exported by this -- server. fsCount OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION Expires: November 2003 [Page 22] Title NFS version 4 MIB May 2003 "The number of file system instances exported by the server. In a multi-homed server implementation, each interface could export a server." ::= { nfsv4ServerObjects 3 } -- -- the file system table that descibes all the root-level file -- systems that are that are visible through this SNMP agent. -- In most cases, there is a single SNMP agent that services -- SNMP MIB requests for all file systems exported by that server. fsTable OBJECT-TYPE SYNTAX SEQUENCE OF FsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table describes overall objects and counters for each file system that is exported." ::= { nfsv4ServerObjects 4 } fsEntry OBJECT-TYPE SYNTAX FsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This describes each entry of the file system table. This table is indexed by the fsIndex object." INDEX { fsIndex } ::= { fsTable 1 } FsEntry ::= SEQUENCE { fsIndex Unsigned32, fsPath DisplayString, numPersistFh Counter32, numVolatileFh Counter32, numStateId Counter32, accessCheckReqs Counter32, closeReqs Counter32, commitReqs Counter32, createReqs Counter32, delegPurgeReqs Counter32, delegReturnReqs Counter32, getAttrReqs Counter32, getFhReqs Counter32, linkReqs Counter32, lockReqs Counter32, locktReqs Counter32, lockuReqs Counter32, lookupReqs Counter32, Expires: November 2003 [Page 23] Title NFS version 4 MIB May 2003 lookuppReqs Counter32, nverifyReqs Counter32, openReqs Counter32, openAttrReqs Counter32, openConfirmReqs Counter32, openDowngradeReqs Counter32, putFhReqs Counter32, putPubFhReqs Counter32, readReqs Counter32, readDirReqs Counter32, readLinkReqs Counter32, releaseLockownerReqs Counter32, removeReqs Counter32, renameReqs Counter32, renewReqs Counter32, restoreFhReqs Counter32, saveFhReqs Counter32, secInfoReqs Counter32, setAttrReqs Counter32, setClientIdReqs Counter32, setClientIdConfirmReqs Counter32, verifyReqs Counter32, writeReqs Counter32, cbGetAttrReqs Counter32, cbRecallReqs Counter32 } fsIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is an index into the file system table." ::= { fsEntry 1 } fsPath OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "This is a path to the file system, exported by the server and corresponds to the fs_root object of the fs_locations attribute." ::= { fsEntry 2 } numPersistFh OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only Expires: November 2003 [Page 24] Title NFS version 4 MIB May 2003 STATUS current DESCRIPTION "Number of persistent file handles that have been created." ::= { fsEntry 3 } numVolatileFh OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of volatile file handles that have been created." ::= { fsEntry 4 } numStateId OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of locks (stateIds) on file handles that have been created." ::= { fsEntry 5 } accessCheckReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of access check requests processed." ::= { fsEntry 6 } closeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of close requests processed." ::= { fsEntry 7 } commitReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of commit requests processed." ::= { fsEntry 8 } createReqs OBJECT-TYPE SYNTAX Counter32 Expires: November 2003 [Page 25] Title NFS version 4 MIB May 2003 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of create requests processed." ::= { fsEntry 9 } delegPurgeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of purge delegations requests processed." ::= { fsEntry 10 } delegReturnReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of return delegations that have been created." ::= { fsEntry 11 } getAttrReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of get attribute requests that have been processed." ::= { fsEntry 12 } getFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of get file handle requests that have been processed." ::= { fsEntry 13 } linkReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of create link requests that have been processed." ::= { fsEntry 14 } Expires: November 2003 [Page 26] Title NFS version 4 MIB May 2003 lockReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of lock requests that have been processed." ::= { fsEntry 15 } locktReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of test lock requests that have been processed." ::= { fsEntry 16 } lockuReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of unlock requests that have been processed." ::= { fsEntry 17 } lookupReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of lookup requests that have been processed." ::= { fsEntry 18 } lookuppReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of lookup parent requests that have been processed." ::= { fsEntry 19 } nverifyReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Verify Different Attribute requests that have been processed." ::= { fsEntry 20 } Expires: November 2003 [Page 27] Title NFS version 4 MIB May 2003 openReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of open requests that have been processed." ::= { fsEntry 21 } openAttrReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of open attribute requests that have been processed." ::= { fsEntry 22 } openConfirmReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of open confirm requests that have been processed." ::= { fsEntry 23 } openDowngradeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of open downgrade requests that have been processed." ::= { fsEntry 24 } putFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Set Current Filehandle requests that have been processed." ::= { fsEntry 25 } putPubFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Set Public Filehandle requests that have been processed." Expires: November 2003 [Page 28] Title NFS version 4 MIB May 2003 ::= { fsEntry 26 } readReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Read requests that have been processed." ::= { fsEntry 27 } readDirReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Read Directory requests that have been processed." ::= { fsEntry 28 } readLinkReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Read Symbolic Link requests that have been processed." ::= { fsEntry 29 } releaseLockownerReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Release Lockowner requests that have been processed." ::= { fsEntry 30 } removeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Remove Object requests that have been processed." ::= { fsEntry 31 } renameReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only Expires: November 2003 [Page 29] Title NFS version 4 MIB May 2003 STATUS current DESCRIPTION "Number of Rename Directory Entry requests that have been processed." ::= { fsEntry 33 } renewReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Renew Lease requests that have been processed." ::= { fsEntry 34 } restoreFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Restore Saved Filehandle requests that have been processed." ::= { fsEntry 35 } saveFhReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Save Current Filehandle requests that have been processed." ::= { fsEntry 36 } secInfoReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Obtain Available Security requests that have been processed." ::= { fsEntry 37 } setAttrReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Set Attribute requests that have been processed." ::= { fsEntry 38 } Expires: November 2003 [Page 30] Title NFS version 4 MIB May 2003 setClientIdReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Set ClientId requests that have been processed." ::= { fsEntry 39 } setClientIdConfirmReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Confirm ClientId requests that have been processed." ::= { fsEntry 40 } verifyReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Verify Same Attribute requests that have been processed." ::= { fsEntry 41 } writeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Write requests that have been processed." ::= { fsEntry 42 } cbGetAttrReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of Get Attribute callbacks that have been issued by the server." ::= { fsEntry 43 } cbRecallReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION Expires: November 2003 [Page 31] Title NFS version 4 MIB May 2003 "Number of times server issued a callback to recall a delegation." ::= { fsEntry 44 } -- -- the file system lock table describes the locks currently -- held by clients, per the view of the stateid in the server. -- it is available per file system. fsLockTable OBJECT-TYPE SYNTAX SEQUENCE OF FsLockEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table describes objects and counters for each lock owned by the server in a specific file system." ::= { nfsv4ServerObjects 5 } fsLockEntry OBJECT-TYPE SYNTAX FsLockEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This describes each entry of the file lock table. This table is indexed by the fsLockIndex object as well as the file system Index." INDEX { lockFsIndex, lockIndex } ::= { fsLockTable 1 } FsLockEntry ::= SEQUENCE { lockFsIndex Unsigned32, lockIndex Unsigned32, stateId FsStateId, clientId FsClientId, lockFh FsFileHandle, lockOffset Unsigned32, lockLength Unsigned32, accessTime Counter32 } lockFsIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is an index into the file system table, within which the locked filehandle resides." ::= { fsLockEntry 1 } Expires: November 2003 [Page 32] Title NFS version 4 MIB May 2003 lockIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is an index into the lock table." ::= { fsLockEntry 2 } stateId OBJECT-TYPE SYNTAX FsStateId MAX-ACCESS read-only STATUS current DESCRIPTION "This is a stateId identifying the lock." ::= { fsLockEntry 3 } clientId OBJECT-TYPE SYNTAX FsClientId MAX-ACCESS read-only STATUS current DESCRIPTION "This is the clientId that created this lock." ::= { fsLockEntry 4 } lockFh OBJECT-TYPE SYNTAX FsFileHandle MAX-ACCESS read-only STATUS current DESCRIPTION "This is the file handle on which the lock is applied." ::= { fsLockEntry 5 } lockOffset OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is the offset in file for the byte-range locking." ::= { fsLockEntry 6 } lockLength OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This is the length of the byte-range that has been locked." ::= { fsLockEntry 7 } Expires: November 2003 [Page 33] Title NFS version 4 MIB May 2003 accessTime OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The date and time that the last valid access occured to the file handle and range that was locked." ::= { fsLockEntry 8 } END 4. Security Considerations 5. IANA Considerations Expires: November 2003 [Page 34] Title NFS version 4 MIB May 2003 6. Normative References [RFC3530] S. Shepler, B. Callaghan, D. Robinson, R. Thurlow, C. Beame, M. Eisler, D. Noveck, RFC3530, "Network File System (NFS) version 4 Protocol", April 2003. 7. Informative References [RFC1155] Rose, M., and K. McCloghrie, Structure and Identification of Management Information for TCP/IP- based Internets, STD 16, RFC 1155, May 1990. [RFC1157] Case, J., Fedor, M., Schoffstall, M., and J. Davin, Simple Network Management Protocol, STD 15, RFC 1157, May 1990. [RFC1212] Rose, M., and K. McCloghrie, Concise MIB Definitions, STD 16, RFC 1212, March 1991. [RFC1215] M. Rose, A Convention for Defining Traps for use with the SNMP, RFC 1215, March 1991. [RFC1901] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, Introduction to Community-based SNMPv2, RFC 1901, January 1996. [RFC1905] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2), RFC 1905, January 1996. [RFC1906] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, Transport Mappings for Version 2 of the Simple Network Management Protocol (SNMPv2), RFC 1906, January 1996. [RFC2570] Case, J., Mundy, R., Partain, D., and B. Stewart, Introduction to Version 3 of the Internet-standard Network Management Framework, RFC 2570, April 1999. Expires: November 2003 [Page 35] Title NFS version 4 MIB May 2003 [RFC2571] Harrington, D., Presuhn, R., and B. Wijnen, An Architecture for Describing SNMP Management Frameworks, RFC 2571, April 1999. [RFC2572] Case, J., Harrington D., Presuhn R., and B. Wijnen, Message Processing and Dispatching for the Simple Network Management Protocol (SNMP), RFC 2572, April 1999. [RFC2573] Levi, D., Meyer, P., and B. Stewart, SNMPv3 Applications, RFC 2573, April 1999. [RFC2574] Blumenthal, U., and B. Wijnen, User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3), RFC 2574, April 1999. [RFC2575] Wijnen, B., Presuhn, R., and K. McCloghrie, View-based Access Control Model (VACM) for the Simple Network Management Protocol (SNMP), RFC 2575, April 1999. [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, Structure of Management Information Version 2 (SMIv2), STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, Textual Conventions for SMIv2, STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, Conformance Statements for SMIv2, STD 58, RFC 2580, April 1999. [RFC3411] Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for describing Simple Network Management Protocol (SNMP) Management Frameworks", STD 62, RFC 3411, December 2002. [RFC3414] Blumenthal, U. and B. Wijnen, "The User-Based Security Model (USM) for Version 3 of the Simple Network Management Protocol (SNMPv3)", STD 62, RFC 3414, December 2002. Expires: November 2003 [Page 36] Title NFS version 4 MIB May 2003 8. Author's Address Address comments related to this memorandum to: nfsv4@ietf.org Spencer Shepler Sun Microsystems, Inc. 7808 Moonflower Drive Austin, TX 78750 Phone: 512-349-9376 E-mail: spencer.shepler@sun.com Venkat Rangan Rhapsody Networks, Inc 3450 West Warrent Av. Fremont, CA 94859 Phone: 510-743-3000 E-mail: venkat@rhapsodynetworks.com Expires: November 2003 [Page 37] Title NFS version 4 MIB May 2003 9. Copyright "Copyright (C) The Internet Society (2003). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implmentation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE." Expires: November 2003 [Page 38]