server/process.h

   1 /*
   2  * Wine server processes
   3  *
   4  * Copyright (C) 1999 Alexandre Julliard
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #ifndef __WINE_SERVER_PROCESS_H
  22 #define __WINE_SERVER_PROCESS_H
  23
  24 #include "object.h"
  25
  26 struct atom_table;
  27 struct handle_table;
  28 struct startup_info;
  29 struct job;
  30
  31 /* process startup state */
  32 enum startup_state { STARTUP_IN_PROGRESS, STARTUP_DONE, STARTUP_ABORTED };
  33
  34 /* process structures */
  35
  36 struct rawinput_device_entry
  37 {
  38     struct list            entry;
  39     struct rawinput_device device;
  40 };
  41
  42 struct process
  43 {
  44     struct object        obj;             /* object header */
  45     struct list          entry;           /* entry in system-wide process list */
  46     process_id_t         parent_id;       /* parent process id (at the time of creation) */
  47     struct list          thread_list;     /* thread list */
  48     struct debug_obj    *debug_obj;       /* debug object debugging this process */
  49     struct debug_event  *debug_event;     /* debug event being sent to debugger */
  50     struct handle_table *handles;         /* handle entries */
  51     struct fd           *msg_fd;          /* fd for sendmsg/recvmsg */
  52     process_id_t         id;              /* id of the process */
  53     process_id_t         group_id;        /* group id of the process */
  54     struct timeout_user *sigkill_timeout; /* timeout for final SIGKILL */
  55     enum cpu_type        cpu;             /* client CPU type */
  56     int                  unix_pid;        /* Unix pid for final SIGKILL */
  57     int                  exit_code;       /* process exit code */
  58     int                  running_threads; /* number of threads running in this process */
  59     timeout_t            start_time;      /* absolute time at process start */
  60     timeout_t            end_time;        /* absolute time at process end */
  61     affinity_t           affinity;        /* process affinity mask */
  62     int                  priority;        /* priority class */
  63     int                  suspend;         /* global process suspend count */
  64     unsigned int         is_system:1;     /* is it a system process? */
  65     unsigned int         debug_children:1;/* also debug all child processes */
  66     unsigned int         is_terminating:1;/* is process terminating? */
  67     data_size_t          imagelen;        /* length of image path in bytes */
  68     WCHAR               *image;           /* main exe image full path */
  69     struct job          *job;             /* job object ascoicated with this process */
  70     struct list          job_entry;       /* list entry for job object */
  71     struct list          asyncs;          /* list of async object owned by the process */
  72     struct list          locks;           /* list of file locks owned by the process */
  73     struct list          classes;         /* window classes owned by the process */
  74     struct console      *console;         /* console input */
  75     enum startup_state   startup_state;   /* startup state */
  76     struct startup_info *startup_info;    /* startup info while init is in progress */
  77     struct event        *idle_event;      /* event for input idle */
  78     obj_handle_t         winstation;      /* main handle to process window station */
  79     obj_handle_t         desktop;         /* handle to desktop to use for new threads */
  80     struct token        *token;           /* security token associated with this process */
  81     struct list          views;           /* list of memory views */
  82     client_ptr_t         peb;             /* PEB address in client address space */
  83     client_ptr_t         ldt_copy;        /* pointer to LDT copy in client addr space */
  84     struct dir_cache    *dir_cache;       /* map of client-side directory cache */
  85     unsigned int         trace_data;      /* opaque data used by the process tracing mechanism */
  86     struct list          rawinput_devices;/* list of registered rawinput devices */
  87     const struct rawinput_device *rawinput_mouse; /* rawinput mouse device, if any */
  88     const struct rawinput_device *rawinput_kbd;   /* rawinput keyboard device, if any */
  89     struct list          kernel_object;   /* list of kernel object pointers */
  90 };
  91
  92 #define CPU_FLAG(cpu) (1 << (cpu))
  93 #define CPU_64BIT_MASK (CPU_FLAG(CPU_x86_64) | CPU_FLAG(CPU_ARM64))
  94
  95 /* process functions */
  96
  97 extern unsigned int alloc_ptid( void *ptr );
  98 extern void free_ptid( unsigned int id );
  99 extern void *get_ptid_entry( unsigned int id );
 100 extern struct process *create_process( int fd, struct process *parent, int inherit_all, const startup_info_t *info,
 101                                        const struct security_descriptor *sd, const obj_handle_t *handles,
 102                                        unsigned int handle_count, struct token *token );
 103 extern data_size_t get_process_startup_info_size( struct process *process );
 104 extern struct thread *get_process_first_thread( struct process *process );
 105 extern struct process *get_process_from_id( process_id_t id );
 106 extern struct process *get_process_from_handle( obj_handle_t handle, unsigned int access );
 107 extern struct debug_obj *get_debug_obj( struct process *process, obj_handle_t handle, unsigned int access );
 108 extern int process_set_debugger( struct process *process, struct thread *thread );
 109 extern void debugger_detach( struct process *process, struct debug_obj *debug_obj );
 110 extern int set_process_debug_flag( struct process *process, int flag );
 111
 112 extern void add_process_thread( struct process *process,
 113                                 struct thread *thread );
 114 extern void remove_process_thread( struct process *process,
 115                                    struct thread *thread );
 116 extern void suspend_process( struct process *process );
 117 extern void resume_process( struct process *process );
 118 extern void kill_process( struct process *process, int violent_death );
 119 extern void kill_console_processes( struct thread *renderer, int exit_code );
 120 extern void detach_debugged_processes( struct debug_obj *debug_obj, int exit_code );
 121 extern void enum_processes( int (*cb)(struct process*, void*), void *user);
 122
 123 /* console functions */
 124 extern struct thread *console_get_renderer( struct console *console );
 125
 126 /* process tracing mechanism to use */
 127 #ifdef __APPLE__
 128 #define USE_MACH
 129 #elif defined(__sun)
 130 #define USE_PROCFS
 131 #else
 132 #define USE_PTRACE
 133 #endif
 134
 135 extern void init_tracing_mechanism(void);
 136 extern void init_process_tracing( struct process *process );
 137 extern void finish_process_tracing( struct process *process );
 138 extern int read_process_memory( struct process *process, client_ptr_t ptr, data_size_t size, char *dest );
 139 extern int write_process_memory( struct process *process, client_ptr_t ptr, data_size_t size, const char *src );
 140
 141 static inline process_id_t get_process_id( struct process *process ) { return process->id; }
 142
 143 static inline int is_process_init_done( struct process *process )
 144 {
 145     return process->startup_state == STARTUP_DONE;
 146 }
 147
 148 #endif  /* __WINE_SERVER_PROCESS_H */