Class CIM_FileSystemSetting
extends CIM_SettingData

The FileSystemSetting describes the attribute values set when creating a FileSystem by a FileSystemConfigurationService. These settings can be associated via the ElementSettingData association with the created FileSystem. If the setting is associated via SettingAssociatedToCapabilities to a FileSystemCapabilities, it is one of the canned settings supported by this capabilities instance. A setting can also be an embedded instance parameter to a method (for instance, when used as a Goal parameter). A NULL value for a property in a canned setting indicates support for a vendor-specific default. A NULL value for a property when the setting is used as a Goal parameter to a method indicates that the client does not care what value that property will have on creation and will accept any vendor-supplied default. When used with a FileSystem, a NULL value for a property must be interpreted as "Unknown". The ActualFileSystemType property cannot have a default value in any context. If this Setting is associated with a FileSystemCapabilities element via SettingAssociatedToCapabilities, the value of ActualFileSystemType in the Setting and the Capabilities MUST match. This class also supports persistence and recoverability of a FileSystem and its contained elements as defined in CIM 2.8 for the use of DatabaseStorageArea.

Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods


Class Hierarchy

CIM_ManagedElement
   |
   +--CIM_SettingData
   |
   +--CIM_FileSystemSetting

Direct Known Subclasses

Class Qualifiers

NameData TypeValue
DescriptionstringThe FileSystemSetting describes the attribute values set when creating a FileSystem by a FileSystemConfigurationService. These settings can be associated via the ElementSettingData association with the created FileSystem. If the setting is associated via SettingAssociatedToCapabilities to a FileSystemCapabilities, it is one of the canned settings supported by this capabilities instance. A setting can also be an embedded instance parameter to a method (for instance, when used as a Goal parameter). A NULL value for a property in a canned setting indicates support for a vendor-specific default. A NULL value for a property when the setting is used as a Goal parameter to a method indicates that the client does not care what value that property will have on creation and will accept any vendor-supplied default. When used with a FileSystem, a NULL value for a property must be interpreted as "Unknown". The ActualFileSystemType property cannot have a default value in any context. If this Setting is associated with a FileSystemCapabilities element via SettingAssociatedToCapabilities, the value of ActualFileSystemType in the Setting and the Capabilities MUST match. This class also supports persistence and recoverability of a FileSystem and its contained elements as defined in CIM 2.8 for the use of DatabaseStorageArea.
Experimentalbooleantrue
UMLPackagePathstringCIM::System::FilesystemServices
Versionstring2.10.0

Class Properties

Local Class Properties

NameData TypeDefault ValueQualifiers
NameData TypeValue
ActualFileSystemTypeuint160
DescriptionstringAn enumerated value that indicates the file system implementation type supported by this Setting. This property MUST exist and have a value.
ModelCorrespondencestringCIM_FileSystemCapabilities.ActualFileSystemType
Readbooleantrue
ValueMapstring0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, .., 0x8000..
ValuesstringUnknown, UFS, HFS, FAT, FAT16, FAT32, NTFS4, NTFS5, XFS, AFS, EXT2, EXT3, REISERFS, DMTF Reserved, Vendor Defined
CopyTargetuint160
DescriptionstringAn enumerated value that specifies if this FileSystem can be a target for synchronization with or mirror of another FileSystem, or if it cannot be a target.
Readbooleantrue
ValueMapstring0, 1, 2, 3, 4, 5, .., 0x8000..
ValuesstringUnknown, Can be a Primary only, Can be a Mirror only, Can be a Synchronization Target, Can be a Backup Target, Write Once, DMTF Reserved, Vendor Defined
DataExtentsSharinguint160
DescriptionstringAn enumerated value that specifies if the FileSystem supports or enforces sharing of data extents between objects.
Readbooleantrue
ValueMapstring0, 1, 2, 3, .., 0x8000..
ValuesstringUnknown, No Sharing, Sharing Possible/Optional, Sharing Enforced, DMTF Reserved, Vendor Defined
FilenameCaseAttributesuint160
DescriptionstringAn enumerated value that specifies how this FileSystem supports the case of characters in the Filename. Note that the host and the service may support multiple conflicting features, but each FileSystem must be configured with only one of the supported features.
Readbooleantrue
ValueMapstring0, 1, 2, 3, 4, 5, .., 0x8000..
ValuesstringUnknown, Case-sensitive, Case-forced to upper case, Case-forced to lower-case, Case-indifferent but lost, Case-indifferent but preserved, DMTF Reserved, Vendor Defined
FilenameFormatsuint16[]
ArrayTypestringIndexed
DescriptionstringAn array of enumerated values that specify the filename formats supported on this FileSystem for naming files. Some common formats are: a) DOS 8.3 b) VMS 'name.extension;version' where the extension specifies a file type c) Unix name (file type is not specified in the name) d) Windows 'name{.ext}*' where any of the exts can specify a file type For each entry in this array there is an associated maximum length for the name and an associated reserved set of characters. The interpretation of the maximum length of the name as well as the FilenameReservedCharacterSet string is vendor-specific.
ModelCorrespondencestringCIM_FileSystemSetting.FilenameLengthMax, CIM_FileSystemSetting.FilenameReservedCharacterSet
Readbooleantrue
ValueMapstring1, 2, 3, 4, .., 0x8000..
ValuesstringDOS8.3, Unix, VMS, Windows LongNames, DMTF Reserved, Vendor Defined
FilenameLengthMaxuint16[]
ArrayTypestringIndexed
DescriptionstringAn array of integers that specify the maximum number of characters in a filename corresponding to an entry in the FilenameFormats property. An entry of '0xFFFF' (the largest 16-bit integer) is interpreted as an indefinite length.
ModelCorrespondencestringCIM_FileSystemSetting.FilenameFormats
Readbooleantrue
FilenameReservedCharacterSetstring[]
ArrayTypestringIndexed
DescriptionstringAn array of strings that specifies the characters that may not appear in the name of any file contained by this FileSystem corresponding to the entry in the FilenameFormats property. Note: It is not clear exactly how this works with the FilenameStreamFormats property above, since the format implicitly specifies the set of allowed characters.
ModelCorrespondencestringCIM_FileSystemSetting.FilenameFormats
Readbooleantrue
FilenameStreamFormatsuint16[]
ArrayTypestringIndexed
DescriptionstringAn array of enumerated integers representing the filename stream formats that the file system can support for access. The interpretation of these stream formats can be specific to vendors, or provided by some standard. But even within those constraints, the interpretation could be locale-specific or version-specific. For instance, Bytestream is locale-specific and is interpreted as ASCII for NFS v2 and v3 but UTF-8 in NFS v4. This additional information will normally be provided in the setting for the protocol used to access an element of this file system.
Readbooleantrue
ValueMapstring1, 2, 3, 4, 5, 6, 7, 8, .., 0x8000..
ValuesstringASCII, WideChar, MBCS, UTF-8, UNICODE UCS-16, UNICODE UCS-32, CIFS Client-interpreted, Bytestream, DMTF Reserved, Vendor Defined
NumberOfObjectsuint64[]
ArrayTypestringIndexed
DescriptionstringAn array of integers that specifies the number of objects (corresponding to the entry in the ObjectTypes array) that this FileSystem will "normally" contain. A value of 0 implies that there is no specific number associated with this setting. When the Setting is associated with a FileSystemCapabilities element, this is the default; When the Setting is associated with a FileSystem element, this is the expected value; When the Setting is used as an embedded parameter to a method this is the goal.
ModelCorrespondencestringCIM_FileSystemSetting.ObjectTypes
Readbooleantrue
NumberOfObjectsMaxuint64[]
ArrayTypestringIndexed
DescriptionstringAn array of integers that specifies the maximum number of objects (corresponding to the entry in the ObjectTypes array) that this FileSystem MUST be able to contain. A value of 0 implies that there is no specific maximum associated with this setting.
ModelCorrespondencestringCIM_FileSystemSetting.ObjectTypes
Readbooleantrue
NumberOfObjectsMinuint64[]
ArrayTypestringIndexed
DescriptionstringAn array of integers that specifies the minimum number of objects (corresponding to the entry in the ObjectTypes array) that this FileSystem MUST be able to contain. A value of 0 implies that there is no specific minimum associated with this setting.
ModelCorrespondencestringCIM_FileSystemSetting.ObjectTypes
Readbooleantrue
ObjectSizeuint64[]
ArrayTypestringIndexed
DescriptionstringAn array of integers that specifies the size of objects (corresponding to the entry in the ObjectTypes array) that this FileSystem will "normally" contain. A value of 0 implies that there is no specific number associated with this setting. When the Setting is associated with a FileSystemCapabilities element, this is the default; When the Setting is associated with a FileSystem element, this is the expected value; When the Setting is used as an embedded parameter to a method this is the goal.
ModelCorrespondencestringCIM_FileSystemSetting.ObjectTypes
PUnitstringbyte
Readbooleantrue
UnitsstringBytes
ObjectSizeMaxuint64[]
ArrayTypestringIndexed
DescriptionstringAn array of integers that specifies the maximum size of objects (corresponding to the entry in the ObjectTypes array) that this FileSystem will "normally" contain. A value of 0 implies that there is no specific maximum associated with this setting.
ModelCorrespondencestringCIM_FileSystemSetting.ObjectTypes
PUnitstringbyte
Readbooleantrue
UnitsstringBytes
ObjectSizeMinuint64[]
ArrayTypestringIndexed
DescriptionstringAn array of integers that specifies the minimum size of objects (corresponding to the entry in the ObjectTypes array) that this FileSystem will "normally" contain. A value of 0 implies that there is no specific minimum associated with this setting.
ModelCorrespondencestringCIM_FileSystemSetting.ObjectTypes
PUnitstringbyte
Readbooleantrue
UnitsstringBytes
ObjectTypesuint16[]
ArrayTypestringIndexed
DescriptionstringAn array of enumerated values that specifies the set of object types that this FileSystem supports. This array is associated with a number of correspondingly indexed properties that specify the size and number of such objects. When used as a goal, the client needs to specify only the subset of objects that they wish to specify; when used in a Setting associated with the FileSystem, this should contain all the types that the provider knows about; when used in a Setting associated with a Capabilities, this may only contain the types that the client can modify. "inodes" indicates that the number of required inodes is specified."files" indicates that the number of required files is specified."directories" indicates that the number of required directories is specified."links" indicates that the number of required links is specified."devices" indicates that the number of required devices is specified."files/directories" indicates that the number of required files and directories is specified."blocks" indicates that the size of required storage in client-specific storage units is specified. This represents the desired size of available space in the filesystem, exclusive of space reserved for meta-data and for other system functions. If "blocks" is specified, the corresponding ObjectSize properties must all be the same and must specify the intended size of the blocks in bytes.
ModelCorrespondencestringCIM_FileSystemSetting.NumberOfObjects, CIM_FileSystemSetting.NumberOfObjectsMax, CIM_FileSystemSetting.NumberOfObjectsMin, CIM_FileSystemSetting.ObjectSize, CIM_FileSystemSetting.ObjectSizeMax, CIM_FileSystemSetting.ObjectSizeMin
Readbooleantrue
ValueMapstring2, 3, 4, 5, 6, 7, 8, .., 0x8000..
Valuesstringinodes, files, directories, links, devices, files/directories, Blocks, DMTF Reserved, Vendor Defined
OtherPersistenceTypesstring[]
ArrayTypestringIndexed
DescriptionstringAn array of strings describing the persistence attributes where the corresponding entry in the PersistenceTypes property has a value of "Other". This value is ignored in all other cases.
ModelCorrespondencestringCIM_FileSystemSetting.PersistenceTypes, CIM_FileSystem.OtherPersistenceType
PersistenceTypesuint16[]
ArrayTypestringIndexed
DescriptionstringAn array of enumerated values representing the persistence attributes of the FileSystem. A value of "Persistent" indicates that the FileSystem supports persistence, can be preserved through an orderly shutdown and could be protected. A value of "Temporary" indicates that the FileSystem supports non-persistence, may not be protected and may not survive a shutdown. A value of "External" indicates that the FileSystem could controlled outside of the operating environment and may need to be protected by specialized means. A value of "Other" is provided to allow for additional persistence types, to be described in the corresponding entry of the OtherPersistenceTypes property, and is expected to be rarely, if ever, used.
ModelCorrespondencestringCIM_FileSystemSetting.OtherPersistenceTypes, CIM_FileSystem.PersistenceType
ValueMapstring0, 1, 2, 3, 4, 5..
ValuesstringUnknown, Other, Persistent, Temporary, External, DMTF Reserved
SupportedAuthenticationProtocolsuint16[]
ArrayTypestringIndexed
DescriptionstringAn array of enumerated values that represent the authentication protocols that the FileSystem will support for access to objects by users, groups, accounts, etc.. An entry of '0' is not allowed. A FileSystem can support more than one authentication protocol.
Readbooleantrue
ValueMapstring1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, .., 0x8000..
ValuesstringAUTH_NONE, AUTH_SYS, AUTH_DH, AUTH_KRB4, AUTH_KRB5, RPCSEC_GSS LIPKEY, RPCSEC_GSS SPKM-3, RPCSEC_GSS Challenge-Response, NTLM v1, NTLM v2, Plain Text, DMTF Reserved, Vendor Defined
SupportedAuthorizationProtocolsuint16[]
ArrayTypestringIndexed
DescriptionstringAn array of enumerated values that represent the authorization protocols that the FileSystem will support for access to objects by users, groups, accounts, etc. A FileSystem can support more than one authorization protocol.
Readbooleantrue
ValueMapstring1, 2, 3, 4, 5, .., 0x8000..
ValuesstringPosix Permissions, Posix ACLs, NFSv4 ACLs, NTFS4, NTFS5, DMTF Reserved, Vendor Defined
SupportedLockingSemanticsuint16[]
ArrayTypestringIndexed
DescriptionstringAn array of enumerated values that represent the locking semantics that the FileSystem can support for controlled access. A file system can support more than one locking model. Just because a file system supports more than one model does not imply that it supports them simultaneously for an element.
Readbooleantrue
ValueMapstring1, 2, 3, 4, 5, 6, 7, 8, .., 0x8000..
ValuesstringNLM/NFSv3, NFSv4 Share Reservations, NFSv4 Byte-range locking, NFSv4 Delegations, CIFS Sharing locks, CIFS Byte-range locks, CIFS Exclusive/Batch oplocks, CIFS Level II oplocks, DMTF Reserved, Vendor Defined

Inherited Properties

NameData TypeClass Origin
CaptionstringCIM_ManagedElement
ChangeableTypeuint16CIM_SettingData
ConfigurationNamestringCIM_SettingData
DescriptionstringCIM_ManagedElement
ElementNamestringCIM_SettingData
Generationuint64CIM_ManagedElement
InstanceIDstringCIM_SettingData
SoIDstringCIM_SettingData
SoOrgIDstringCIM_SettingData
ComponentSettingstring[]CIM_SettingData

Class Methods