---
title: "xpc_fd_create(_:)"
framework: xpc
role: symbol
role_heading: Function
path: "xpc/xpc_fd_create(_:)"
---

# xpc_fd_create(_:)

Creates an XPC object that represents a POSIX file descriptor.

## Declaration

```swift
func xpc_fd_create(_ fd: Int32) -> xpc_object_t?
```

## Parameters

- `fd`: The file descriptor which is to be boxed.

## Return Value

Return Value A new file descriptor object. NULL if sufficient memory could not be allocated or if the given file descriptor was not valid.

## Discussion

Discussion This method performs the equivalent of a dup(2) on the descriptor, so it is safe to call close(2) on the descriptor after boxing it with a file descriptor object. important: Pointer equality is the ONLY valid test for equality between two file descriptor objects. There is no reliable way to determine whether two file descriptors refer to the same inode with the same capabilities, so two file descriptor objects created from the same underlying file descriptor number will not compare equally with xpc_equal(_:_:). This is also true of a file descriptor object created using xpc_copy(_:) and the original. This also implies that two collections containing file descriptor objects cannot be equal unless the exact same object was inserted into both.

## See Also

### File Descriptor objects

- [xpc_fd_dup(_:)](xpc/xpc_fd_dup(_:).md)