process.h 7.39 KB
Newer Older
1 2 3 4
/*
 * Wine server processes
 *
 * Copyright (C) 1999 Alexandre Julliard
5 6 7 8 9 10 11 12 13 14 15 16 17
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * 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 22 23 24 25
 */

#ifndef __WINE_SERVER_PROCESS_H
#define __WINE_SERVER_PROCESS_H

#include "object.h"

26
struct msg_queue;
27
struct atom_table;
28
struct handle_table;
29
struct startup_info;
30

31 32 33
/* process startup state */
enum startup_state { STARTUP_IN_PROGRESS, STARTUP_DONE, STARTUP_ABORTED };

34 35
/* process structures */

36 37
struct process_dll
{
38
    struct list          entry;           /* entry in per-process dll list */
39
    struct file         *file;            /* dll file */
40
    mod_handle_t         base;            /* dll base address (in process addr space) */
41
    client_ptr_t         name;            /* ptr to ptr to name (in process addr space) */
42
    data_size_t          size;            /* dll size */
43 44
    int                  dbg_offset;      /* debug info offset */
    int                  dbg_size;        /* debug info size */
45
    data_size_t          namelen;         /* length of dll file name */
46
    WCHAR               *filename;        /* dll file name */
47 48
};

49 50 51
struct process
{
    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 59
    process_id_t         id;              /* id of the process */
    process_id_t         group_id;        /* group id of the process */
60
    struct timeout_user *sigkill_timeout; /* timeout for final SIGKILL */
61
    enum cpu_type        cpu;             /* client CPU type */
62
    int                  unix_pid;        /* Unix pid for final SIGKILL */
63 64
    int                  exit_code;       /* process exit code */
    int                  running_threads; /* number of threads running in this process */
65 66
    timeout_t            start_time;      /* absolute time at process start */
    timeout_t            end_time;        /* absolute time at process end */
67
    affinity_t           affinity;        /* process affinity mask */
68 69
    int                  priority;        /* priority class */
    int                  suspend;         /* global process suspend count */
70
    int                  is_system;       /* is it a system process? */
71
    unsigned int         create_flags;    /* process creation flags */
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_input*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 78
    struct event        *idle_event;      /* event for input idle */
    struct msg_queue    *queue;           /* main message queue */
79
    obj_handle_t         winstation;      /* main handle to process window station */
80
    obj_handle_t         desktop;         /* handle to desktop to use for new threads */
81
    struct token        *token;           /* security token associated with this process */
82
    struct list          dlls;            /* list of loaded dlls */
83
    client_ptr_t         peb;             /* PEB address in client address space */
84
    client_ptr_t         ldt_copy;        /* pointer to LDT copy in client addr space */
85
    unsigned int         trace_data;      /* opaque data used by the process tracing mechanism */
86
};
87 88 89 90

struct process_snapshot
{
    struct process *process;  /* process ptr */
91
    int             count;    /* process refcount */
92 93
    int             threads;  /* number of threads */
    int             priority; /* priority class */
94
    int             handles;  /* number of handles */
95 96 97 98
};

/* process functions */

99 100 101
extern unsigned int alloc_ptid( void *ptr );
extern void free_ptid( unsigned int id );
extern void *get_ptid_entry( unsigned int id );
102
extern struct thread *create_process( int fd, struct thread *parent_thread, int inherit_all );
103
extern data_size_t init_process( struct thread *thread );
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 int process_set_debugger( struct process *process, struct thread *thread );
108
extern int debugger_detach( struct process* process, struct thread* debugger );
109
extern int set_process_debug_flag( struct process *process, int flag );
110

111 112 113 114
extern void add_process_thread( struct process *process,
                                struct thread *thread );
extern void remove_process_thread( struct process *process,
                                   struct thread *thread );
115 116
extern void suspend_process( struct process *process );
extern void resume_process( struct process *process );
117
extern void kill_process( struct process *process, int violent_death );
118
extern void kill_console_processes( struct thread *renderer, int exit_code );
119
extern void kill_debugged_processes( struct thread *debugger, int exit_code );
120
extern void break_process( struct process *process );
121
extern void detach_debugged_processes( struct thread *debugger );
122
extern struct process_snapshot *process_snap( int *count );
123
extern void enum_processes( int (*cb)(struct process*, void*), void *user);
124

125 126 127 128 129
/* console functions */
extern void inherit_console(struct thread *parent_thread, struct process *process, obj_handle_t hconin);
extern int free_console( struct process *process );
extern struct thread *console_get_renderer( struct console_input *console );

130 131 132
/* process tracing mechanism to use */
#ifdef __APPLE__
#define USE_MACH
133 134
#elif defined(__sun)
#define USE_PROCFS
135 136 137 138
#else
#define USE_PTRACE
#endif

139 140 141
extern void init_tracing_mechanism(void);
extern void init_process_tracing( struct process *process );
extern void finish_process_tracing( struct process *process );
142 143
extern int read_process_memory( struct process *process, client_ptr_t ptr, data_size_t size, char *dest );
extern int write_process_memory( struct process *process, client_ptr_t ptr, data_size_t size, const char *src );
144

145
static inline process_id_t get_process_id( struct process *process ) { return process->id; }
146

147
static inline int is_process_init_done( struct process *process )
148 149 150
{
    return process->startup_state == STARTUP_DONE;
}
151

152
static inline struct process_dll *get_process_exe_module( struct process *process )
153 154 155 156 157
{
    struct list *ptr = list_head( &process->dlls );
    return ptr ? LIST_ENTRY( ptr, struct process_dll, entry ) : NULL;
}

158
#endif  /* __WINE_SERVER_PROCESS_H */