timer.c 9.49 KB
Newer Older
1 2 3 4
/*
 * Waitable timers management
 *
 * 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
#include "config.h"
#include "wine/port.h"

24 25 26 27 28
#include <assert.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/time.h>
#include <sys/types.h>
29
#include <stdarg.h>
30

31 32
#include "ntstatus.h"
#define WIN32_NO_STATUS
33
#include "windef.h"
34
#include "winternl.h"
35 36

#include "file.h"
37 38 39 40 41 42 43 44
#include "handle.h"
#include "request.h"

struct timer
{
    struct object        obj;       /* object header */
    int                  manual;    /* manual reset */
    int                  signaled;  /* current signaled state */
45 46
    unsigned int         period;    /* timer period in ms */
    timeout_t            when;      /* next expiration */
47
    struct timeout_user *timeout;   /* timeout user */
48
    struct thread       *thread;    /* thread that set the APC function */
49 50
    client_ptr_t         callback;  /* callback APC function */
    client_ptr_t         arg;       /* callback argument */
51 52 53
};

static void timer_dump( struct object *obj, int verbose );
54
static struct object_type *timer_get_type( struct object *obj );
55 56
static int timer_signaled( struct object *obj, struct thread *thread );
static int timer_satisfied( struct object *obj, struct thread *thread );
57
static unsigned int timer_map_access( struct object *obj, unsigned int access );
58 59 60 61
static void timer_destroy( struct object *obj );

static const struct object_ops timer_ops =
{
62 63
    sizeof(struct timer),      /* size */
    timer_dump,                /* dump */
64
    timer_get_type,            /* get_type */
65 66 67 68
    add_queue,                 /* add_queue */
    remove_queue,              /* remove_queue */
    timer_signaled,            /* signaled */
    timer_satisfied,           /* satisfied */
69
    no_signal,                 /* signal */
70
    no_get_fd,                 /* get_fd */
71
    timer_map_access,          /* map_access */
72 73
    default_get_sd,            /* get_sd */
    default_set_sd,            /* set_sd */
74
    no_lookup_name,            /* lookup_name */
75
    no_open_file,              /* open_file */
76
    no_close_handle,           /* close_handle */
77
    timer_destroy              /* destroy */
78 79 80 81
};


/* create a timer object */
82 83
static struct timer *create_timer( struct directory *root, const struct unicode_str *name,
                                   unsigned int attr, int manual )
84 85 86
{
    struct timer *timer;

87
    if ((timer = create_named_object_dir( root, name, attr, &timer_ops )))
88
    {
89
        if (get_error() != STATUS_OBJECT_NAME_EXISTS)
90 91
        {
            /* initialize it if it didn't already exist */
92 93 94 95 96 97
            timer->manual   = manual;
            timer->signaled = 0;
            timer->when     = 0;
            timer->period   = 0;
            timer->timeout  = NULL;
            timer->thread   = NULL;
98 99 100 101 102 103 104 105 106 107
        }
    }
    return timer;
}

/* callback on timer expiration */
static void timer_callback( void *private )
{
    struct timer *timer = (struct timer *)private;

108 109
    /* queue an APC */
    if (timer->thread)
110
    {
111 112 113 114 115
        apc_call_t data;

        memset( &data, 0, sizeof(data) );
        if (timer->callback)
        {
116 117 118 119
            data.type       = APC_TIMER;
            data.timer.func = timer->callback;
            data.timer.time = timer->when;
            data.timer.arg  = timer->arg;
120 121 122 123
        }
        else data.type = APC_NONE;  /* wake up only */

        if (!thread_queue_apc( timer->thread, &timer->obj, &data ))
124 125 126 127 128
        {
            release_object( timer->thread );
            timer->thread = NULL;
        }
    }
129

130 131
    if (timer->period)  /* schedule the next expiration */
    {
132 133
        timer->when += (timeout_t)timer->period * 10000;
        timer->timeout = add_timeout_user( timer->when, timer_callback, timer );
134 135 136 137 138 139 140 141
    }
    else timer->timeout = NULL;

    /* wake up waiters */
    timer->signaled = 1;
    wake_up( &timer->obj, 0 );
}

142
/* cancel a running timer */
143
static int cancel_timer( struct timer *timer )
144
{
145 146
    int signaled = timer->signaled;

147 148 149 150 151 152 153
    if (timer->timeout)
    {
        remove_timeout_user( timer->timeout );
        timer->timeout = NULL;
    }
    if (timer->thread)
    {
154
        thread_cancel_apc( timer->thread, &timer->obj, APC_TIMER );
155
        release_object( timer->thread );
156 157
        timer->thread = NULL;
    }
158
    return signaled;
159 160
}

161
/* set the timer expiration and period */
162
static int set_timer( struct timer *timer, timeout_t expire, unsigned int period,
163
                      client_ptr_t callback, client_ptr_t arg )
164
{
165
    int signaled = cancel_timer( timer );
166 167 168 169 170
    if (timer->manual)
    {
        period = 0;  /* period doesn't make any sense for a manual timer */
        timer->signaled = 0;
    }
171
    timer->when     = (expire <= 0) ? current_time - expire : max( expire, current_time );
172 173 174
    timer->period   = period;
    timer->callback = callback;
    timer->arg      = arg;
175
    if (callback) timer->thread = (struct thread *)grab_object( current );
176
    timer->timeout = add_timeout_user( timer->when, timer_callback, timer );
177
    return signaled;
178 179 180 181 182 183
}

static void timer_dump( struct object *obj, int verbose )
{
    struct timer *timer = (struct timer *)obj;
    assert( obj->ops == &timer_ops );
184 185
    fprintf( stderr, "Timer manual=%d when=%s period=%u ",
             timer->manual, get_timeout_str(timer->when), timer->period );
186 187 188 189
    dump_object_name( &timer->obj );
    fputc( '\n', stderr );
}

190 191 192 193 194 195 196
static struct object_type *timer_get_type( struct object *obj )
{
    static const WCHAR name[] = {'T','i','m','e','r'};
    static const struct unicode_str str = { name, sizeof(name) };
    return get_object_type( &str );
}

197 198 199 200 201 202 203 204 205 206 207 208 209 210 211
static int timer_signaled( struct object *obj, struct thread *thread )
{
    struct timer *timer = (struct timer *)obj;
    assert( obj->ops == &timer_ops );
    return timer->signaled;
}

static int timer_satisfied( struct object *obj, struct thread *thread )
{
    struct timer *timer = (struct timer *)obj;
    assert( obj->ops == &timer_ops );
    if (!timer->manual) timer->signaled = 0;
    return 0;
}

212 213 214 215 216 217 218 219 220
static unsigned int timer_map_access( struct object *obj, unsigned int access )
{
    if (access & GENERIC_READ)    access |= STANDARD_RIGHTS_READ | SYNCHRONIZE | TIMER_QUERY_STATE;
    if (access & GENERIC_WRITE)   access |= STANDARD_RIGHTS_WRITE | TIMER_MODIFY_STATE;
    if (access & GENERIC_EXECUTE) access |= STANDARD_RIGHTS_EXECUTE;
    if (access & GENERIC_ALL)     access |= TIMER_ALL_ACCESS;
    return access & ~(GENERIC_READ | GENERIC_WRITE | GENERIC_EXECUTE | GENERIC_ALL);
}

221 222 223 224 225 226
static void timer_destroy( struct object *obj )
{
    struct timer *timer = (struct timer *)obj;
    assert( obj->ops == &timer_ops );

    if (timer->timeout) remove_timeout_user( timer->timeout );
227
    if (timer->thread) release_object( timer->thread );
228 229 230 231 232 233
}

/* create a timer */
DECL_HANDLER(create_timer)
{
    struct timer *timer;
234
    struct unicode_str name;
235
    struct directory *root = NULL;
236

237
    reply->handle = 0;
238
    get_req_unicode_str( &name );
239 240 241 242
    if (req->rootdir && !(root = get_directory_obj( current->process, req->rootdir, 0 )))
        return;

    if ((timer = create_timer( root, &name, req->attributes, req->manual )))
243
    {
244
        reply->handle = alloc_handle( current->process, timer, req->access, req->attributes );
245 246
        release_object( timer );
    }
247 248

    if (root) release_object( root );
249 250 251 252 253
}

/* open a handle to a timer */
DECL_HANDLER(open_timer)
{
254
    struct unicode_str name;
255
    struct directory *root = NULL;
256
    struct timer *timer;
257 258

    get_req_unicode_str( &name );
259 260 261
    if (req->rootdir && !(root = get_directory_obj( current->process, req->rootdir, 0 )))
        return;

262 263
    if ((timer = open_object_dir( root, &name, req->attributes, &timer_ops )))
    {
264
        reply->handle = alloc_handle( current->process, &timer->obj, req->access, req->attributes );
265 266
        release_object( timer );
    }
267 268

    if (root) release_object( root );
269 270 271 272 273 274 275 276 277 278
}

/* set a waitable timer */
DECL_HANDLER(set_timer)
{
    struct timer *timer;

    if ((timer = (struct timer *)get_handle_obj( current->process, req->handle,
                                                 TIMER_MODIFY_STATE, &timer_ops )))
    {
279
        reply->signaled = set_timer( timer, req->expire, req->period, req->callback, req->arg );
280 281 282 283 284 285 286 287 288 289 290 291
        release_object( timer );
    }
}

/* cancel a waitable timer */
DECL_HANDLER(cancel_timer)
{
    struct timer *timer;

    if ((timer = (struct timer *)get_handle_obj( current->process, req->handle,
                                                 TIMER_MODIFY_STATE, &timer_ops )))
    {
292
        reply->signaled = cancel_timer( timer );
293 294 295
        release_object( timer );
    }
}
296 297 298 299 300 301 302 303 304

/* Get information on a waitable timer */
DECL_HANDLER(get_timer_info)
{
    struct timer *timer;

    if ((timer = (struct timer *)get_handle_obj( current->process, req->handle,
                                                 TIMER_QUERY_STATE, &timer_ops )))
    {
305
        reply->when      = timer->when;
306 307 308 309
        reply->signaled  = timer->signaled;
        release_object( timer );
    }
}