2 * Wine server processes
4 * Copyright (C) 1999 Alexandre Julliard
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.
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.
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
21 #ifndef __WINE_SERVER_PROCESS_H
22 #define __WINE_SERVER_PROCESS_H
31 /* process startup state */
32 enum startup_state { STARTUP_IN_PROGRESS, STARTUP_DONE, STARTUP_ABORTED };
34 /* process structures */
38 struct list entry; /* entry in per-process dll list */
39 struct file *file; /* dll file */
40 void *base; /* dll base address (in process addr space) */
41 size_t size; /* dll size */
42 void *name; /* ptr to ptr to name (in process addr space) */
43 int dbg_offset; /* debug info offset */
44 int dbg_size; /* debug info size */
45 size_t namelen; /* length of dll file name */
46 WCHAR *filename; /* dll file name */
51 struct object obj; /* object header */
52 struct list entry; /* entry in system-wide process list */
53 struct process *parent; /* parent process */
54 struct list thread_list; /* thread list */
55 struct thread *debugger; /* thread debugging this process */
56 struct handle_table *handles; /* handle entries */
57 struct fd *msg_fd; /* fd for sendmsg/recvmsg */
58 process_id_t id; /* id of the process */
59 process_id_t group_id; /* group id of the process */
60 int exit_code; /* process exit code */
61 int running_threads; /* number of threads running in this process */
62 struct timeval start_time; /* absolute time at process start */
63 struct timeval end_time; /* absolute time at process end */
64 int priority; /* priority class */
65 int affinity; /* process affinity mask */
66 int suspend; /* global process suspend count */
67 unsigned int create_flags; /* process creation flags */
68 struct list locks; /* list of file locks owned by the process */
69 struct list classes; /* window classes owned by the process */
70 struct console_input*console; /* console input */
71 enum startup_state startup_state; /* startup state */
72 struct startup_info *startup_info; /* startup info while init is in progress */
73 struct event *idle_event; /* event for input idle */
74 struct msg_queue *queue; /* main message queue */
75 obj_handle_t winstation; /* main handle to process window station */
76 obj_handle_t desktop; /* handle to desktop to use for new threads */
77 struct token *token; /* security token associated with this process */
78 struct list dlls; /* list of loaded dlls */
79 void *peb; /* PEB address in client address space */
80 void *ldt_copy; /* pointer to LDT copy in client addr space */
83 struct process_snapshot
85 struct process *process; /* process ptr */
86 int count; /* process refcount */
87 int threads; /* number of threads */
88 int priority; /* priority class */
89 int handles; /* number of handles */
92 struct module_snapshot
94 void *base; /* module base addr */
95 size_t size; /* module size */
96 size_t namelen; /* length of file name */
97 WCHAR *filename; /* module file name */
100 /* process functions */
102 extern unsigned int alloc_ptid( void *ptr );
103 extern void free_ptid( unsigned int id );
104 extern void *get_ptid_entry( unsigned int id );
105 extern struct thread *create_process( int fd, struct thread *parent_thread, int inherit_all );
106 extern size_t init_process( struct thread *thread );
107 extern struct thread *get_process_first_thread( struct process *process );
108 extern struct process *get_process_from_id( process_id_t id );
109 extern struct process *get_process_from_handle( obj_handle_t handle, unsigned int access );
110 extern int process_set_debugger( struct process *process, struct thread *thread );
111 extern int debugger_detach( struct process* process, struct thread* debugger );
112 extern int set_process_debug_flag( struct process *process, int flag );
114 extern void add_process_thread( struct process *process,
115 struct thread *thread );
116 extern void remove_process_thread( struct process *process,
117 struct thread *thread );
118 extern void suspend_process( struct process *process );
119 extern void resume_process( struct process *process );
120 extern void kill_all_processes( struct process *skip, int exit_code );
121 extern void kill_process( struct process *process, struct thread *skip, int exit_code );
122 extern void kill_console_processes( struct thread *renderer, int exit_code );
123 extern void kill_debugged_processes( struct thread *debugger, int exit_code );
124 extern void break_process( struct process *process );
125 extern void detach_debugged_processes( struct thread *debugger );
126 extern struct process_snapshot *process_snap( int *count );
127 extern struct module_snapshot *module_snap( struct process *process, int *count );
128 extern void enum_processes( int (*cb)(struct process*, void*), void *user);
129 extern int read_process_memory( struct process *process, const void *ptr, size_t size, char *dest );
130 extern int write_process_memory( struct process *process, void *ptr, size_t size, const char *src );
132 inline static process_id_t get_process_id( struct process *process ) { return process->id; }
134 inline static int is_process_init_done( struct process *process )
136 return process->startup_state == STARTUP_DONE;
139 inline static struct process_dll *get_process_exe_module( struct process *process )
141 struct list *ptr = list_head( &process->dlls );
142 return ptr ? LIST_ENTRY( ptr, struct process_dll, entry ) : NULL;
145 #endif /* __WINE_SERVER_PROCESS_H */