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

# FSContainerStatus

A type that represents a container’s status.

```
class FSContainerStatus
```

## Overview

This type contains two properties:

- The [`state`](/documentation/FSKit/FSContainerStatus/state) value that indicates the state of the container, such as [`FSContainerState.ready`](/documentation/FSKit/FSContainerState/ready) or [`FSContainerState.blocked`](/documentation/FSKit/FSContainerState/blocked).
- The [`status`](/documentation/FSKit/FSContainerStatus/status) is an error (optional in Swift, nullable in Objective-C) that provides further information about the state, such as why the container is blocked.

Examples of statuses that require intervention include errors that indicate the container isn’t ready (POSIX `EAGAIN` or `ENOTCONN`), the container needs authentication (`ENEEDAUTH`), or that authentication failed (`EAUTH`).
The status can also be an informative error, such as the FSKit error [`FSError.Code.statusOperationInProgress`](/documentation/FSKit/FSError/Code/statusOperationInProgress).

## Topics

### Creating a container status instance

[`active(status:)`](/documentation/FSKit/FSContainerStatus/active(status:))

Returns a active container status instance with the provided error status.

[`blocked(status:)`](/documentation/FSKit/FSContainerStatus/blocked(status:))

Returns a blocked container status instance with the provided error status.

[`notReady(status:)`](/documentation/FSKit/FSContainerStatus/notReady(status:))

Returns a not-ready container status instance with the provided error status.

[`ready(status:)`](/documentation/FSKit/FSContainerStatus/ready(status:))

Returns a ready container status instance with the provided error status.

### Inspecting status properties

[`state`](/documentation/FSKit/FSContainerStatus/state)

A value that represents the container state, such as ready, active, or blocked.

[`FSContainerState`](/documentation/FSKit/FSContainerState)

An enumeration of container state values.

[`status`](/documentation/FSKit/FSContainerStatus/status)

An optional error that provides further information about the state.

### Using common status values

[`active`](/documentation/FSKit/FSContainerStatus/active)

A status that represents an active container with no error.

[`ready`](/documentation/FSKit/FSContainerStatus/ready)

A status that represents a ready container with no error.


---

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)