<!--
{
  "availability" : [
    "macOS: 15.4.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "FSKit",
  "identifier" : "/documentation/FSKit/FSItem/Attributes",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "FSKit"
    ],
    "preciseIdentifier" : "c:objc(cs)FSItemAttributes"
  },
  "title" : "FSItem.Attributes"
}
-->

# FSItem.Attributes

Attributes of an item, such as size, creation and modification times, and user and group identifiers.

```
class Attributes
```

## Overview> Important: FSKit internally maintains a unique sequence number for each set of attributes to determine the most up-to-date set of attributes of a given ``doc://FSKit/documentation/FSKit/FSItem``.
> To prevent an older set of attributes from having a newer sequence number, all attributes of a given ``doc://FSKit/documentation/FSKit/FSItem/Attributes`` object should be populated within the same synchronization context.
> This synchronization context should prevent any other thread from populating another ``doc://FSKit/documentation/FSKit/FSItem/Attributes`` object of the given ``doc://FSKit/documentation/FSKit/FSItem``.

## Topics

### Validating and invalidating attributes

[`isValid(_:)`](/documentation/FSKit/FSItem/Attributes/isValid(_:))

Returns a Boolean value that indicates whether the attribute is valid.

[`invalidateAllProperties()`](/documentation/FSKit/FSItem/Attributes/invalidateAllProperties())

Marks all attributes inactive.

### Working with identifier attributes

[`fileID`](/documentation/FSKit/FSItem/Attributes/fileID)

The item’s file identifier.

[`parentID`](/documentation/FSKit/FSItem/Attributes/parentID)

The identifier of the item’s parent.

### Working with metadata attributes

[`type`](/documentation/FSKit/FSItem/Attributes/type)

The item type, such as a regular file, directory, or symbolic link.

[`mode`](/documentation/FSKit/FSItem/Attributes/mode)

The mode of the item.

[`linkCount`](/documentation/FSKit/FSItem/Attributes/linkCount)

The number of hard links to the item.

[`uid`](/documentation/FSKit/FSItem/Attributes/uid)

The user identifier.

[`gid`](/documentation/FSKit/FSItem/Attributes/gid)

The group identifier.

[`flags`](/documentation/FSKit/FSItem/Attributes/flags)

The item’s behavior flags.

[`size`](/documentation/FSKit/FSItem/Attributes/size)

The item’s size.

[`allocSize`](/documentation/FSKit/FSItem/Attributes/allocSize)

The item’s allocated size.

[`supportsLimitedXAttrs`](/documentation/FSKit/FSItem/Attributes/supportsLimitedXAttrs)

A Boolean value that indicates whether the item supports a limited set of extended attributes.

[`inhibitKernelOffloadedIO`](/documentation/FSKit/FSItem/Attributes/inhibitKernelOffloadedIO)

A Boolean value that indicates whether the file system overrides the per-volume settings for kernel offloaded I/O for a specific file.

### Working with time attributes

[`accessTime`](/documentation/FSKit/FSItem/Attributes/accessTime)

The item’s last-accessed time.

[`modifyTime`](/documentation/FSKit/FSItem/Attributes/modifyTime)

The item’s last-modified time.

[`changeTime`](/documentation/FSKit/FSItem/Attributes/changeTime)

The item’s last-changed time.

[`birthTime`](/documentation/FSKit/FSItem/Attributes/birthTime)

The item’s creation time.

[`backupTime`](/documentation/FSKit/FSItem/Attributes/backupTime)

The item’s last-backup time.

[`addedTime`](/documentation/FSKit/FSItem/Attributes/addedTime)

The item’s added time.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)