basic: add comments about raw_clone() calls not supporting threads/malloc in child

2023-06-23 10:02:15 +02:00
parent c26d7837bb
commit 01ab446c35
2 changed files with 12 additions and 2 deletions
@@ -27,6 +27,11 @@
 * Additionally, as this function does not pass the ptid, newtls and ctid parameters to the kernel, flags must not
 * contain CLONE_PARENT_SETTID, CLONE_CHILD_SETTID, CLONE_CHILD_CLEARTID or CLONE_SETTLS.
 *
+ * WARNING: 💣 this call (just like glibc's own clone() wrapper) will not synchronize on glibc's malloc
+ *          locks, which means they will be in an undefined state in the child if the parent is
+ *          threaded. This means: the parent must either never use threads, or the child cannot use memory
+ *          allocation itself. This is a major pitfall, hence be careful! 💣
+ *
 * Returns: 0 in the child process and the child process id in the parent.
 */
 static inline pid_t raw_clone(unsigned long flags) {