FreeBSD Status Report

Report Entry

Process Descriptor API completion

Contact: Konstantin Belousov <kib@FreeBSD.org>

FreeBSD offered the Process Descriptors facility for long time. Its main use is in the Capsicum sandboxes where the handle is required to operate on an object, and process descriptor provided such handle. Other operating systems provide similar facility under the same name. The offered API was not complete, main lacking part being the pdwait(2) system call, the analog of wait(2) family, which operates on the process descriptor instead of the process id.

The described project added pdwait(2) call. Another important addition was the pdrfork(2) call, which provides the same fine-grained support for process copy construction as rfork(2), but also returns the process descriptor as the handle, like pdfork(2).

After pdwait and pdrfork addition, the natural extensions for the posix_spawn(3) facilities were possible. Now the posix_spawnattr_setprocdescp_np(3) attribute requests that posix_spawn(3) returned process descriptor. Another natural addition was posix_spawnattr_setexecfd_np(3) which specifies the executable image by file descriptor instead of the name.

Together, the newly added features make the process descriptor complete and allow the use of posix_spawn in the sandboxes.

Sponsor: The FreeBSD Foundation


Last modified on: April 2, 2026 by Konstantin Belousov