1  /* The clone3 kernel interface definitions.
       2     Copyright (C) 2021-2023 Free Software Foundation, Inc.
       3     This file is part of the GNU C Library.
       4  
       5     The GNU C Library is free software; you can redistribute it and/or
       6     modify it under the terms of the GNU Lesser General Public
       7     License as published by the Free Software Foundation; either
       8     version 2.1 of the License, or (at your option) any later version.
       9  
      10     The GNU C Library is distributed in the hope that it will be useful,
      11     but WITHOUT ANY WARRANTY; without even the implied warranty of
      12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
      13     Lesser General Public License for more details.
      14  
      15     You should have received a copy of the GNU Lesser General Public
      16     License along with the GNU C Library.  If not, see
      17     <https://www.gnu.org/licenses/>.  */
      18  
      19  #ifndef _CLONE3_H
      20  #define _CLONE3_H	1
      21  
      22  #include <features.h>
      23  #include <stddef.h>
      24  #include <bits/types.h>
      25  
      26  
      27  /* Flags for the clone3 syscall.  */
      28  #define CLONE_CLEAR_SIGHAND 0x100000000ULL /* Clear any signal handler and
      29  					      reset to SIG_DFL.  */
      30  #define CLONE_INTO_CGROUP 0x200000000ULL /* Clone into a specific cgroup given
      31  					    the right permissions.  */
      32  
      33  /* The unsigned 64-bit and 8-byte aligned integer type.  */
      34  typedef __U64_TYPE __aligned_uint64_t __attribute__ ((__aligned__ (8)));
      35  
      36  /* This struct should only be used in an argument to the clone3 system
      37     call (along with its size argument).  It may be extended with new
      38     fields in the future.  */
      39  
      40  struct clone_args
      41  {
      42    /* Flags bit mask.  */
      43    __aligned_uint64_t flags;
      44    /* Where to store PID file descriptor (pid_t *).  */
      45    __aligned_uint64_t pidfd;
      46    /* Where to store child TID, in child's memory (pid_t *).  */
      47    __aligned_uint64_t child_tid;
      48    /* Where to store child TID, in parent's memory (int *). */
      49    __aligned_uint64_t parent_tid;
      50    /* Signal to deliver to parent on child termination */
      51    __aligned_uint64_t exit_signal;
      52    /* The lowest address of stack.  */
      53    __aligned_uint64_t stack;
      54    /* Size of stack.  */
      55    __aligned_uint64_t stack_size;
      56    /* Location of new TLS.  */
      57    __aligned_uint64_t tls;
      58    /* Pointer to a pid_t array (since Linux 5.5).  */
      59    __aligned_uint64_t set_tid;
      60    /* Number of elements in set_tid (since Linux 5.5). */
      61    __aligned_uint64_t set_tid_size;
      62    /* File descriptor for target cgroup of child (since Linux 5.7).  */
      63    __aligned_uint64_t cgroup;
      64  };
      65  
      66  #endif /* clone3.h */