about summary refs log tree commit diff
path: root/include/clone_internal.h
blob: 567160ebb59cdb9eac8bb28f3e66bfce0ac31e12 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
#ifndef _CLONE_INTERNAL_H
#define _CLONE_INTERNAL_H

#include <clone3.h>

/* The clone3 syscall provides a superset of the functionality of the clone
   interface.  The kernel might extend __CL_ARGS struct in the future, with
   each version with a different __SIZE.  If the child is created, it will
   start __FUNC function with __ARG arguments.

   Different than kernel, the implementation also returns EINVAL for an
   invalid NULL __CL_ARGS or __FUNC (similar to __clone).

   All callers are responsible for correctly aligning the stack.  The stack is
   not aligned prior to the syscall (this differs from the exported __clone).

   This function is only implemented if the ABI defines HAVE_CLONE3_WRAPPER.
*/
extern int __clone3 (struct clone_args *__cl_args, size_t __size,
		     int (*__func) (void *__arg), void *__arg);

/* The internal wrapper of clone/clone2 and clone3.  Different than __clone3,
   it will align the stack if required.  If __clone3 returns -1 with ENOSYS,
   fall back to clone or clone2.  */
extern int __clone_internal (struct clone_args *__cl_args,
			     int (*__func) (void *__arg), void *__arg);
/* clone3 wrapper with a sticky check to avoid re-issuing the syscall if
   it fails with ENOSYS.  */
extern int __clone3_internal (struct clone_args *cl_args,
			      int (*func) (void *args), void *arg)
     attribute_hidden;
/* The fallback code which calls clone/clone2 based on clone3 arguments.  */
extern int __clone_internal_fallback (struct clone_args *__cl_args,
				      int (*__func) (void *__arg),
				      void *__arg)
     attribute_hidden;

/* Return whether the kernel supports pid file descriptor, including clone
   with CLONE_PIDFD and waitid with P_PIDFD.  */
extern bool __clone_pidfd_supported (void) attribute_hidden;

#ifndef _ISOMAC
libc_hidden_proto (__clone3)
libc_hidden_proto (__clone_internal)
#endif

#endif