/* * Copyright (c) 2006-2021, RT-Thread Development Team * * SPDX-License-Identifier: Apache-2.0 * * Change Logs: * Date Author Notes * 2018-06-29 heyuanjie first version * 2019-10-12 Jesven Add MMU and userspace support * 2020-10-08 Bernard Architecture and code cleanup * 2021-08-26 linzhenxing add lwp_setcwd\lwp_getcwd */ /* * RT-Thread light-weight process */ #ifndef __LWP_H__ #define __LWP_H__ #include #include #include #include #include "lwp_arch.h" #include "lwp_pid.h" #include "lwp_ipc.h" #include "lwp_signal.h" #include "lwp_syscall.h" #include "lwp_avl.h" #include "mm_aspace.h" #ifdef RT_USING_MUSLLIBC #include "libc_musl.h" #endif /* RT_USING_MUSLLIBC */ #ifdef ARCH_MM_MMU #include "lwp_shm.h" #include #include "mmu.h" #include "page.h" #else #include "lwp_mpu.h" #endif /* ARCH_MM_MMU */ #ifdef RT_USING_MUSLLIBC #include #endif /* RT_USING_MUSLLIBC */ #ifdef RT_USING_TTY struct tty_struct; #endif /* RT_USING_TTY */ #ifdef __cplusplus extern "C" { #endif #define LWP_MAGIC 0x5A #define LWP_TYPE_FIX_ADDR 0x01 #define LWP_TYPE_DYN_ADDR 0x02 #define LWP_ARG_MAX 8 struct rt_lwp_objs { rt_aspace_t source; struct rt_mem_obj mem_obj; }; struct rt_lwp_notify { void (*notify)(rt_wqueue_t *signalfd_queue, int signo); rt_wqueue_t *signalfd_queue; rt_slist_t list_node; }; #ifdef RT_USING_MUSLLIBC #define LWP_CREATE_STAT(exit_code) (((exit_code) & 0xff) << 8) #else #error "No compatible lwp set status provided for this libc" #endif struct rt_lwp { #ifdef ARCH_MM_MMU size_t end_heap; rt_aspace_t aspace; #else #ifdef ARCH_MM_MPU struct rt_mpu_info mpu_info; #endif /* ARCH_MM_MPU */ #endif /* ARCH_MM_MMU */ #ifdef RT_USING_SMP int bind_cpu; #endif uint8_t lwp_type; uint8_t reserv[3]; struct rt_lwp *parent; struct rt_lwp *first_child; struct rt_lwp *sibling; rt_list_t wait_list; rt_bool_t terminated; rt_bool_t background; int lwp_ret; void *text_entry; uint32_t text_size; void *data_entry; uint32_t data_size; rt_atomic_t ref; void *args; uint32_t args_length; pid_t pid; pid_t __pgrp; /*Accessed via process_group()*/ pid_t tty_old_pgrp; pid_t session; rt_list_t t_grp; rt_list_t timer; /* POSIX timer object binding to a process */ int leader; /* boolean value for session group_leader*/ struct dfs_fdtable fdt; char cmd[RT_NAME_MAX]; /* POSIX signal */ struct lwp_signal signal; struct lwp_avl_struct *object_root; struct rt_mutex object_mutex; struct rt_user_context user_ctx; struct rt_wqueue wait_queue; /*for console */ struct tty_struct *tty; /* NULL if no tty */ struct lwp_avl_struct *address_search_head; /* for addressed object fast search */ char working_directory[DFS_PATH_MAX]; int debug; rt_uint32_t bak_first_inst; /* backup of first instruction */ struct rt_mutex lwp_lock; rt_slist_t signalfd_notify_head; #ifdef LWP_ENABLE_ASID uint64_t generation; unsigned int asid; #endif }; typedef struct rt_lwp *rt_lwp_t; struct rt_lwp *lwp_self(void); rt_err_t lwp_children_register(struct rt_lwp *parent, struct rt_lwp *child); rt_err_t lwp_children_unregister(struct rt_lwp *parent, struct rt_lwp *child); enum lwp_exit_request_type { LWP_EXIT_REQUEST_NONE = 0, LWP_EXIT_REQUEST_TRIGGERED, LWP_EXIT_REQUEST_IN_PROCESS, }; struct termios *get_old_termios(void); void lwp_setcwd(char *buf); char *lwp_getcwd(void); void lwp_request_thread_exit(rt_thread_t thread_to_exit); int lwp_check_exit_request(void); void lwp_terminate(struct rt_lwp *lwp); void lwp_wait_subthread_exit(void); int lwp_tid_init(void); int lwp_tid_get(void); void lwp_tid_put(int tid); /** * @brief Automatically get a thread and increase a reference count * * @param tid queried thread ID * @return rt_thread_t */ rt_thread_t lwp_tid_get_thread_and_inc_ref(int tid); /** * @brief Decrease a reference count * * @param thread target thread */ void lwp_tid_dec_ref(rt_thread_t thread); void lwp_tid_set_thread(int tid, rt_thread_t thread); int lwp_execve(char *filename, int debug, int argc, char **argv, char **envp); /*create by lwp_setsid.c*/ int setsid(void); #ifdef ARCH_MM_MMU void lwp_aspace_switch(struct rt_thread *thread); #endif void lwp_user_setting_save(rt_thread_t thread); void lwp_user_setting_restore(rt_thread_t thread); void lwp_uthread_ctx_save(void *ctx); void lwp_uthread_ctx_restore(void); int lwp_setaffinity(pid_t pid, int cpu); /* ctime lwp API */ int timer_list_free(rt_list_t *timer_list); struct rt_futex; rt_err_t lwp_futex(struct rt_lwp *lwp, struct rt_futex *futex, int *uaddr, int op, int val, const struct timespec *timeout); #ifdef ARCH_MM_MMU struct __pthread { /* Part 1 -- these fields may be external or * * internal (accessed via asm) ABI. Do not change. */ struct pthread *self; uintptr_t *dtv; struct pthread *prev, *next; /* non-ABI */ uintptr_t sysinfo; uintptr_t canary, canary2; /* Part 2 -- implementation details, non-ABI. */ int tid; int errno_val; volatile int detach_state; volatile int cancel; volatile unsigned char canceldisable, cancelasync; unsigned char tsd_used:1; unsigned char dlerror_flag:1; unsigned char *map_base; size_t map_size; void *stack; size_t stack_size; size_t guard_size; void *result; struct __ptcb *cancelbuf; void **tsd; struct { volatile void *volatile head; long off; volatile void *volatile pending; } robust_list; volatile int timer_id; locale_t locale; volatile int killlock[1]; char *dlerror_buf; void *stdio_locks; /* Part 3 -- the positions of these fields relative to * * the end of the structure is external and internal ABI. */ uintptr_t canary_at_end; uintptr_t *dtv_copy; }; #endif #ifdef __cplusplus } #endif #ifndef AUX_ARRAY_ITEMS_NR #define AUX_ARRAY_ITEMS_NR 32 #endif /* aux key */ #define AT_NULL 0 #define AT_IGNORE 1 #define AT_EXECFD 2 #define AT_PHDR 3 #define AT_PHENT 4 #define AT_PHNUM 5 #define AT_PAGESZ 6 #define AT_BASE 7 #define AT_FLAGS 8 #define AT_ENTRY 9 #define AT_NOTELF 10 #define AT_UID 11 #define AT_EUID 12 #define AT_GID 13 #define AT_EGID 14 #define AT_CLKTCK 17 #define AT_PLATFORM 15 #define AT_HWCAP 16 #define AT_FPUCW 18 #define AT_DCACHEBSIZE 19 #define AT_ICACHEBSIZE 20 #define AT_UCACHEBSIZE 21 #define AT_IGNOREPPC 22 #define AT_SECURE 23 #define AT_BASE_PLATFORM 24 #define AT_RANDOM 25 #define AT_HWCAP2 26 #define AT_EXECFN 31 struct process_aux_item { size_t key; size_t value; }; struct process_aux { struct process_aux_item item[AUX_ARRAY_ITEMS_NR]; }; struct lwp_args_info { char **argv; char **envp; int argc; int envc; int size; }; struct dbg_ops_t { int (*dbg)(int argc, char **argv); uint32_t (*arch_get_ins)(void); void (*arch_activate_step)(void); void (*arch_deactivate_step)(void); int (*check_debug_event)(struct rt_hw_exp_stack *regs, unsigned long esr); rt_channel_t (*gdb_get_server_channel)(void); int (*gdb_get_step_type)(void); void (*lwp_check_debug_attach_req)(void *pc); int (*lwp_check_debug_suspend)(void); }; extern struct dbg_ops_t *rt_dbg_ops; int dbg_thread_in_debug(void); void dbg_register(struct dbg_ops_t *dbg_ops); uint32_t dbg_get_ins(void); void dbg_activate_step(void); void dbg_deactivate_step(void); int dbg_check_event(struct rt_hw_exp_stack *regs, unsigned long arg); rt_channel_t gdb_server_channel(void); int dbg_step_type(void); void dbg_attach_req(void *pc); int dbg_check_suspend(void); void rt_hw_set_process_id(int pid); /* backtrace service */ rt_err_t lwp_backtrace_frame(rt_thread_t uthread, struct rt_hw_backtrace_frame *frame); #endif