[PATCH v2 1/5] man/man2/prctl.2, PR_FUTEX_HASH_SET_SLOTS.2const: Document PR_FUTEX_HASH_SET_SLOTS
From: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
Date: 2025-09-15 14:13:09
Also in:
lkml
Subsystem:
the rest · Maintainer:
Linus Torvalds
Signed-off-by: Sebastian Andrzej Siewior <bigeasy@linutronix.de> --- man/man2const/PR_FUTEX_HASH_SET_SLOTS.2const | 67 ++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 man/man2const/PR_FUTEX_HASH_SET_SLOTS.2const
diff --git a/man/man2const/PR_FUTEX_HASH_SET_SLOTS.2const b/man/man2const/PR_FUTEX_HASH_SET_SLOTS.2const
new file mode 100644
index 0000000000000..1605c18c6985b
--- /dev/null
+++ b/man/man2const/PR_FUTEX_HASH_SET_SLOTS.2const@@ -0,0 +1,67 @@ +.\" Copyright, the authors of the Linux man-pages project +.\" +.\" SPDX-License-Identifier: Linux-man-pages-copyleft +.\" +.TH PR_FUTEX_HASH_SET_SLOTS 2const (date) "Linux man-pages (unreleased)" +.SH NAME +PR_FUTEX_HASH_SET_SLOTS +\- +set the size of the private hash +.SH LIBRARY +Standard C library +.RI ( libc ,\~ \-lc ) +.SH SYNOPSIS +.nf +.BR "#include <linux/prctl.h>" " /* Definition of " PR_* " constants */" +.B #include <sys/prctl.h> +.P +.B int prctl(PR_FUTEX_HASH, PR_FUTEX_HASH_SET_SLOTS, +.BI " unsigned long " size ", unsigned long " flags "); +.fi +.SH DESCRIPTION +Set the number of slots to use for the private hash. +.TP +.I size +Specify the size of private hash to allocate. +.RS +.TP +.I 0 +Use the global hash. +This is the behaviour used before 6.17. +.TP +.I >0 +Specify the number of slots to allocate. +The value must be power of two, and the lowest possible value is 2. +The upper limit depends on the available memory in the system. +Each slot requires 64 bytes of memory. +Kernels compiled with +.I CONFIG_PROVE_LOCKING +will consume more than that. +.RE +.TP +.I flags +.RS +The argument must be 0. +.SH RETURN VALUE +On success, +0 is returned. +On error, \-1 is returned, and +.I errno +is set to indicate the error. +.SH ERRORS +.TP +.B EINVAL +An argument is invalid. +.TP +.B ENOMEM +Failed to allocate memory. +.TP +.B EBUSY +The global hash is in use and can not be changed. +.SH STANDARDS +Linux. +.SH HISTORY +Linux 6.17. +.SH SEE ALSO +.BR prctl (2), +.BR PR_FUTEX_HASH (2const)
--
2.51.0