X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=sched.h;h=35e2503e383be3611fc302f5a732e45cf322d506;hp=0b7df7e8fd72f9d90f531bcec37ddb4922f72fb7;hb=ac1f19d550a81c8408c8fce2e237996c950253ab;hpb=deb3326320166531abc35ce805dee4df6b49e936 diff --git a/sched.h b/sched.h index 0b7df7e8..35e2503e 100644 --- a/sched.h +++ b/sched.h @@ -1,8 +1,4 @@ -/* - * Copyright (C) 2006-2014 Andre Noll - * - * Licensed under the GPL v2. For licencing details see COPYING. - */ +/* Copyright (C) 2006 Andre Noll , see file COPYING. */ /** \file sched.h Sched and task structures and exported symbols from sched.c. */ @@ -33,33 +29,7 @@ struct sched { struct list_head task_list; }; -/** - * Paraslash's task structure. - * - * This is considered an internal structure and will eventually be made private. - * - * \sa \ref sched. - */ -struct task { - /** Copied from the task_info struct during task_register(). */ - void (*pre_select)(struct sched *s, struct task *t); - /** Copied from the task_info struct during task_register(). */ - int (*post_select)(struct sched *s, struct task *t); - /** Whether this task is active (>=0) or in error state (<0). */ - int error; - /** Position of the task in the task list of the scheduler. */ - struct list_head node; - /** The task name supplied when the task was registered(). */ - char status[255]; - /** If less than zero, the task was notified by another task. */ - int notification; - /** Whether the task structure should be freed in sched_shutdown(). */ - bool owned_by_sched; - /** True if task is in error state and exit status has been queried. */ - bool dead; - /** Usually a pointer to the struct containing this task. */ - void *context; -}; +struct task; /** Information that must be supplied by callers of \ref task_register(). */ struct task_info { @@ -71,7 +41,7 @@ struct task_info { * Its purpose is to add file descriptors to the fd sets of the * scheduler and to decrease the select timeout if necessary. */ - void (*pre_select)(struct sched *s, struct task *t); + void (*pre_select)(struct sched *s, void *context); /** * The mandatory post select method. * @@ -79,12 +49,11 @@ struct task_info { * select call. If this function returns a negative value, the * scheduler unregisters the task. */ - int (*post_select)(struct sched *s, struct task *t); + int (*post_select)(struct sched *s, void *context); /** - * This pointer is saved when the task is register(ed). It may be - * queried from ->pre_select() and ->post_select() via \ref - * task_context(). Usually this is a pointer to the struct owned by the - * caller which contains the task pointer as one member. + * This pointer is saved when the task is registered. It is passed to + * ->pre_select() and ->post_select(). Usually this is a pointer to the + * struct owned by the caller which contains the task pointer. */ void *context; }; @@ -95,16 +64,16 @@ struct task_info { * scheduler are allowed to block, this value should be accurate enough so that * there is no need to call clock_gettime() directly. */ -extern struct timeval *now; +extern const struct timeval *now; struct task *task_register(struct task_info *info, struct sched *s); -void *task_context(struct task *t); int schedule(struct sched *s); void sched_shutdown(struct sched *s); char *get_task_list(struct sched *s); void task_notify(struct task *t, int err); void task_notify_all(struct sched *s, int err); int task_get_notification(const struct task *t); +int task_status(const struct task *t); int task_reap(struct task **tptr); void sched_min_delay(struct sched *s); void sched_request_timeout(struct timeval *to, struct sched *s);