<!--
{
  "availability" : [
    "macOS: 15.4.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "FSKit",
  "identifier" : "/documentation/FSKit/FSVolume/ItemDeactivationOptions",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "FSKit"
    ],
    "preciseIdentifier" : "c:@E@FSItemDeactivationOptions"
  },
  "title" : "FSVolume.ItemDeactivationOptions"
}
-->

# FSVolume.ItemDeactivationOptions

Options to specify the item deactivation policy.

```
struct ItemDeactivationOptions
```

## Overview

Callers may want to set a deactivation policy because `FSVolume/ItemDeactivation/deactivateItem(_:)` processing blocks the kernel.
Setting a deactivation policy allows the file system to take action at a definitive point in the item’s life cycle.
These options allow the file system to instruct the FSKit kernel of which circumstances require the expense of a round-trip call to the module.

> Note: To avoid performing deactivation calls, Objective-C developers use the value `FSItemDeactivationNever`. In Swift, use an empty option set (`[]`).

## Topics

### Declaring deactivation options

[`FSItemDeactivationNever`](/documentation/FSKit/FSItemDeactivationOptions/FSItemDeactivationNever)

An option to never perform deactivation.

[`forRemovedItems`](/documentation/FSKit/FSVolume/ItemDeactivationOptions/forRemovedItems)

An option to process deactivation for open-unlinked items at the moment of last close.

[`forPreallocatedItems`](/documentation/FSKit/FSVolume/ItemDeactivationOptions/forPreallocatedItems)

An option to process deactivation for for files with preallocated space.

[`always`](/documentation/FSKit/FSVolume/ItemDeactivationOptions/always)

An option to always perform deactivation calls.

### Working with raw values

[`init(rawValue:)`](/documentation/FSKit/FSVolume/ItemDeactivationOptions/init(rawValue:))


---

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)