Page MenuHomeFreeBSD

D56221.1795135239.diff
No OneTemporary

Authored By
Unknown
Size
1 KB
Referenced Files
None
Subscribers
None

D56221.1795135239.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,19 @@
+=== 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
41855968
Default Alt Text
D56221.1795135239.diff (1 KB)

Event Timeline