4 * Copyright (C) 1998 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_OBJECT_H
22 #define __WINE_SERVER_OBJECT_H
24 #ifdef HAVE_SYS_POLL_H
29 #include "wine/server_protocol.h"
30 #include "wine/list.h"
43 struct wait_queue_entry
;
56 /* operations valid on all objects */
59 /* size of this object type */
61 /* dump the object (for debugging) */
62 void (*dump
)(struct object
*,int);
63 /* return the object type */
64 struct object_type
*(*get_type
)(struct object
*);
65 /* add a thread to the object wait queue */
66 int (*add_queue
)(struct object
*,struct wait_queue_entry
*);
67 /* remove a thread from the object wait queue */
68 void (*remove_queue
)(struct object
*,struct wait_queue_entry
*);
69 /* is object signaled? */
70 int (*signaled
)(struct object
*,struct wait_queue_entry
*);
72 void (*satisfied
)(struct object
*,struct wait_queue_entry
*);
73 /* signal an object */
74 int (*signal
)(struct object
*, unsigned int);
75 /* return an fd object that can be used to read/write from the object */
76 struct fd
*(*get_fd
)(struct object
*);
77 /* map access rights to the specific rights for this object */
78 unsigned int (*map_access
)(struct object
*, unsigned int);
79 /* returns the security descriptor of the object */
80 struct security_descriptor
*(*get_sd
)( struct object
* );
81 /* sets the security descriptor of the object */
82 int (*set_sd
)( struct object
*, const struct security_descriptor
*, unsigned int );
83 /* lookup a name if an object has a namespace */
84 struct object
*(*lookup_name
)(struct object
*, struct unicode_str
*,unsigned int);
85 /* link an object's name into a parent object */
86 int (*link_name
)(struct object
*, struct object_name
*, struct object
*);
87 /* unlink an object's name from its parent */
88 void (*unlink_name
)(struct object
*, struct object_name
*);
89 /* open a file object to access this object */
90 struct object
*(*open_file
)(struct object
*, unsigned int access
, unsigned int sharing
,
91 unsigned int options
);
92 /* return list of kernel objects */
93 struct list
*(*get_kernel_obj_list
)(struct object
*);
94 /* close a handle to this object */
95 int (*close_handle
)(struct object
*,struct process
*,obj_handle_t
);
96 /* destroy on refcount == 0 */
97 void (*destroy
)(struct object
*);
102 unsigned int refcount
; /* reference count */
103 unsigned int handle_count
;/* handle count */
104 const struct object_ops
*ops
;
105 struct list wait_queue
;
106 struct object_name
*name
;
107 struct security_descriptor
*sd
;
109 struct list obj_list
;
115 struct list entry
; /* entry in the hash list */
116 struct object
*obj
; /* object owning this name */
117 struct object
*parent
; /* parent object */
118 data_size_t len
; /* name length in bytes */
122 struct wait_queue_entry
126 struct thread_wait
*wait
;
129 extern void *mem_alloc( size_t size
); /* malloc wrapper */
130 extern void *memdup( const void *data
, size_t len
);
131 extern void *alloc_object( const struct object_ops
*ops
);
132 extern void namespace_add( struct namespace *namespace, struct object_name
*ptr
);
133 extern const WCHAR
*get_object_name( struct object
*obj
, data_size_t
*len
);
134 extern WCHAR
*get_object_full_name( struct object
*obj
, data_size_t
*ret_len
);
135 extern void dump_object_name( struct object
*obj
);
136 extern struct object
*lookup_named_object( struct object
*root
, const struct unicode_str
*name
,
137 unsigned int attr
, struct unicode_str
*name_left
);
138 extern void *create_named_object( struct object
*parent
, const struct object_ops
*ops
,
139 const struct unicode_str
*name
, unsigned int attributes
,
140 const struct security_descriptor
*sd
);
141 extern void *open_named_object( struct object
*parent
, const struct object_ops
*ops
,
142 const struct unicode_str
*name
, unsigned int attributes
);
143 extern void unlink_named_object( struct object
*obj
);
144 extern void make_object_static( struct object
*obj
);
145 extern struct namespace *create_namespace( unsigned int hash_size
);
146 extern void free_kernel_objects( struct object
*obj
);
147 /* grab/release_object can take any pointer, but you better make sure */
148 /* that the thing pointed to starts with a struct object... */
149 extern struct object
*grab_object( void *obj
);
150 extern void release_object( void *obj
);
151 extern struct object
*find_object( const struct namespace *namespace, const struct unicode_str
*name
,
152 unsigned int attributes
);
153 extern struct object
*find_object_index( const struct namespace *namespace, unsigned int index
);
154 extern struct object_type
*no_get_type( struct object
*obj
);
155 extern int no_add_queue( struct object
*obj
, struct wait_queue_entry
*entry
);
156 extern void no_satisfied( struct object
*obj
, struct wait_queue_entry
*entry
);
157 extern int no_signal( struct object
*obj
, unsigned int access
);
158 extern struct fd
*no_get_fd( struct object
*obj
);
159 extern unsigned int no_map_access( struct object
*obj
, unsigned int access
);
160 extern struct security_descriptor
*default_get_sd( struct object
*obj
);
161 extern int default_set_sd( struct object
*obj
, const struct security_descriptor
*sd
, unsigned int set_info
);
162 extern int set_sd_defaults_from_token( struct object
*obj
, const struct security_descriptor
*sd
,
163 unsigned int set_info
, struct token
*token
);
164 extern struct object
*no_lookup_name( struct object
*obj
, struct unicode_str
*name
, unsigned int attributes
);
165 extern int no_link_name( struct object
*obj
, struct object_name
*name
, struct object
*parent
);
166 extern void default_unlink_name( struct object
*obj
, struct object_name
*name
);
167 extern struct object
*no_open_file( struct object
*obj
, unsigned int access
, unsigned int sharing
,
168 unsigned int options
);
169 extern struct list
*no_kernel_obj_list( struct object
*obj
);
170 extern int no_close_handle( struct object
*obj
, struct process
*process
, obj_handle_t handle
);
171 extern void no_destroy( struct object
*obj
);
173 extern void dump_objects(void);
174 extern void close_objects(void);
177 /* event functions */
182 extern struct event
*create_event( struct object
*root
, const struct unicode_str
*name
,
183 unsigned int attr
, int manual_reset
, int initial_state
,
184 const struct security_descriptor
*sd
);
185 extern struct keyed_event
*create_keyed_event( struct object
*root
, const struct unicode_str
*name
,
186 unsigned int attr
, const struct security_descriptor
*sd
);
187 extern struct event
*get_event_obj( struct process
*process
, obj_handle_t handle
, unsigned int access
);
188 extern struct keyed_event
*get_keyed_event_obj( struct process
*process
, obj_handle_t handle
, unsigned int access
);
189 extern void pulse_event( struct event
*event
);
190 extern void set_event( struct event
*event
);
191 extern void reset_event( struct event
*event
);
193 /* mutex functions */
195 extern void abandon_mutexes( struct thread
*thread
);
197 /* serial functions */
199 int get_serial_async_timeout(struct object
*obj
, int type
, int count
);
201 /* socket functions */
203 extern void sock_init(void);
205 /* debugger functions */
207 extern int set_process_debugger( struct process
*process
, struct thread
*debugger
);
208 extern void generate_debug_event( struct thread
*thread
, int code
, const void *arg
);
209 extern void generate_startup_debug_events( struct process
*process
, client_ptr_t entry
);
210 extern void debug_exit_thread( struct thread
*thread
);
212 /* registry functions */
214 extern unsigned int get_prefix_cpu_mask(void);
215 extern void init_registry(void);
216 extern void flush_registry(void);
218 /* signal functions */
220 extern void start_watchdog(void);
221 extern void stop_watchdog(void);
222 extern int watchdog_triggered(void);
223 extern void init_signals(void);
227 extern atom_t
add_global_atom( struct winstation
*winstation
, const struct unicode_str
*str
);
228 extern atom_t
find_global_atom( struct winstation
*winstation
, const struct unicode_str
*str
);
229 extern int grab_global_atom( struct winstation
*winstation
, atom_t atom
);
230 extern void release_global_atom( struct winstation
*winstation
, atom_t atom
);
232 /* directory functions */
234 extern struct object
*get_root_directory(void);
235 extern struct object
*get_directory_obj( struct process
*process
, obj_handle_t handle
);
236 extern struct object_type
*get_object_type( const struct unicode_str
*name
);
237 extern int directory_link_name( struct object
*obj
, struct object_name
*name
, struct object
*parent
);
238 extern void init_directories(void);
240 /* symbolic link functions */
242 extern struct object
*create_obj_symlink( struct object
*root
, const struct unicode_str
*name
,
243 unsigned int attr
, struct object
*target
,
244 const struct security_descriptor
*sd
);
246 /* global variables */
248 /* command-line options */
249 extern int debug_level
;
250 extern int foreground
;
251 extern timeout_t master_socket_timeout
;
252 extern const char *server_argv0
;
254 /* server start time used for GetTickCount() */
255 extern timeout_t server_start_time
;
257 #define KEYEDEVENT_WAIT 0x0001
258 #define KEYEDEVENT_WAKE 0x0002
259 #define KEYEDEVENT_ALL_ACCESS (STANDARD_RIGHTS_REQUIRED | 0x0003)
261 #endif /* __WINE_SERVER_OBJECT_H */