Page MenuHomeFreeBSD

D56221.1795135252.diff
No OneTemporary

Authored By
Unknown
Size
1 KB
Referenced Files
None
Subscribers
None

D56221.1795135252.diff

diff --git a/website/content/en/status/report-2026-01-2026-03/pdwait.adoc b/website/content/en/status/report-2026-01-2026-03/pdwait.adoc
new file mode 100644
--- /dev/null
+++ b/website/content/en/status/report-2026-01-2026-03/pdwait.adoc
@@ -0,0 +1,13 @@
+=== 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(2) and pdrfork(2) 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(3) in the sandboxes.
+
+Sponsor: The FreeBSD Foundation

File Metadata

Mime Type
text/plain
Expires
Fri, Nov 20, 12:40 AM (7 h, 27 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
41855971
Default Alt Text
D56221.1795135252.diff (1 KB)

Event Timeline