server/thread.h

   1 /*
   2  * Wine server threads
   3  *
   4  * Copyright (C) 1998 Alexandre Julliard
   5  */
   6
   7 #ifndef __WINE_SERVER_THREAD_H
   8 #define __WINE_SERVER_THREAD_H
   9
  10 #include "object.h"
  11
  12 /* thread structure */
  13
  14 struct process;
  15 struct thread_wait;
  16 struct thread_apc;
  17 struct mutex;
  18 struct debug_ctx;
  19 struct debug_event;
  20 struct startup_info;
  21 struct msg_queue;
  22
  23 enum run_state
  24 {
  25     RUNNING,    /* running normally */
  26     TERMINATED  /* terminated */
  27 };
  28
  29 struct apc_queue
  30 {
  31     struct thread_apc *head;
  32     struct thread_apc *tail;
  33 };
  34
  35 /* descriptor for fds currently in flight from client to server */
  36 struct inflight_fd
  37 {
  38     int client;  /* fd on the client side (or -1 if entry is free) */
  39     int server;  /* fd on the server side */
  40 };
  41 #define MAX_INFLIGHT_FDS 16  /* max number of fds in flight per thread */
  42
  43 struct thread
  44 {
  45     struct object       obj;       /* object header */
  46     struct thread      *next;      /* system-wide thread list */
  47     struct thread      *prev;
  48     struct thread      *proc_next; /* per-process thread list */
  49     struct thread      *proc_prev;
  50     struct process     *process;
  51     struct mutex       *mutex;       /* list of currently owned mutexes */
  52     struct debug_ctx   *debug_ctx;   /* debugger context if this thread is a debugger */
  53     struct debug_event *debug_event; /* debug event being sent to debugger */
  54     struct msg_queue   *queue;       /* message queue */
  55     struct startup_info*info;        /* startup info for child process */
  56     struct thread_wait *wait;        /* current wait condition if sleeping */
  57     struct apc_queue    system_apc;  /* queue of system async procedure calls */
  58     struct apc_queue    user_apc;    /* queue of user async procedure calls */
  59     struct inflight_fd  inflight[MAX_INFLIGHT_FDS];  /* fds currently in flight */
  60     unsigned int        error;       /* current error code */
  61     struct object      *request_fd;  /* fd for receiving client requests */
  62     int                 reply_fd;    /* fd to send a reply to a client */
  63     int                 wait_fd;     /* fd to use to wake a sleeping client */
  64     enum run_state      state;     /* running state */
  65     int                 attached;  /* is thread attached with ptrace? */
  66     int                 exit_code; /* thread exit code */
  67     int                 unix_pid;  /* Unix pid of client */
  68     CONTEXT            *context;   /* current context if in an exception handler */
  69     void               *teb;       /* TEB address (in client address space) */
  70     int                 priority;  /* priority level */
  71     int                 affinity;  /* affinity mask */
  72     int                 suspend;   /* suspend count */
  73     void               *buffer;    /* buffer for communication with the client */
  74 };
  75
  76 struct thread_snapshot
  77 {
  78     struct thread  *thread;    /* thread ptr */
  79     int             count;     /* thread refcount */
  80     int             priority;  /* priority class */
  81 };
  82
  83 extern struct thread *current;
  84
  85 /* thread functions */
  86
  87 extern struct thread *create_thread( int fd, struct process *process );
  88 extern struct thread *get_thread_from_id( void *id );
  89 extern struct thread *get_thread_from_handle( handle_t handle, unsigned int access );
  90 extern struct thread *get_thread_from_pid( int pid );
  91 extern int suspend_thread( struct thread *thread, int check_limit );
  92 extern int resume_thread( struct thread *thread );
  93 extern int add_queue( struct object *obj, struct wait_queue_entry *entry );
  94 extern void remove_queue( struct object *obj, struct wait_queue_entry *entry );
  95 extern void kill_thread( struct thread *thread, int violent_death );
  96 extern void wake_up( struct object *obj, int max );
  97 extern int thread_queue_apc( struct thread *thread, struct object *owner, void *func,
  98                              enum apc_type type, int system, int nb_args, ... );
  99 extern void thread_cancel_apc( struct thread *thread, struct object *owner, int system );
 100 extern int thread_add_inflight_fd( struct thread *thread, int client, int server );
 101 extern int thread_get_inflight_fd( struct thread *thread, int client );
 102 extern struct thread_snapshot *thread_snap( int *count );
 103
 104 /* ptrace functions */
 105
 106 extern void sigchld_handler();
 107 extern void wait4_thread( struct thread *thread, int signal );
 108 extern void stop_thread( struct thread *thread );
 109 extern void continue_thread( struct thread *thread );
 110 extern void detach_thread( struct thread *thread, int sig );
 111 extern int suspend_for_ptrace( struct thread *thread );
 112 extern int read_thread_int( struct thread *thread, const int *addr, int *data );
 113 extern int write_thread_int( struct thread *thread, int *addr, int data, unsigned int mask );
 114 extern void *get_thread_ip( struct thread *thread );
 115 extern int get_thread_single_step( struct thread *thread );
 116
 117 extern unsigned int global_error;  /* global error code for when no thread is current */
 118
 119 static inline unsigned int get_error(void)       { return current ? current->error : global_error; }
 120 static inline void set_error( unsigned int err ) { global_error = err; if (current) current->error = err; }
 121 static inline void clear_error(void)    { set_error(0); }
 122
 123 static inline void *get_thread_id( struct thread *thread ) { return thread; }
 124
 125 #endif  /* __WINE_SERVER_THREAD_H */