<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "macCatalyst: -",
    "macOS: -",
    "tvOS: -",
    "visionOS: -",
    "watchOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "Dispatch",
  "identifier" : "/documentation/Dispatch/DispatchSourceFileSystemObject",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Dispatch"
    ],
    "preciseIdentifier" : "c:objc(pl)OS_dispatch_source_vnode"
  },
  "title" : "DispatchSourceFileSystemObject"
}
-->

# DispatchSourceFileSystemObject

A dispatch source that monitors events associated with a file descriptor.

```
protocol DispatchSourceFileSystemObject : DispatchSourceProtocol, Sendable
```

## Overview

You do not adopt this protocol in your objects. Instead, use the [`makeFileSystemObjectSource(fileDescriptor:eventMask:queue:)`](/documentation/Dispatch/DispatchSource/makeFileSystemObjectSource(fileDescriptor:eventMask:queue:)) method to create an object that adopts this protocol.

## Topics

### Getting the Data Handle

[`handle`](/documentation/Dispatch/DispatchSourceFileSystemObject/handle)

The file descriptor of the file or socket.

### Getting the Event Data

[`data`](/documentation/Dispatch/DispatchSourceFileSystemObject/data)

The type of the last file system event.

[`mask`](/documentation/Dispatch/DispatchSourceFileSystemObject/mask)

The file descriptor attributes being monitored by the dispatch source.


---

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)