Colony » Colony Scout

/*-

 * Copyright (c) 2005-2006, Kohsuke Ohtani

 * All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions

 * are met:

 * 1. Redistributions of source code must retain the above copyright

 *    notice, this list of conditions and the following disclaimer.

 * 2. Redistributions in binary form must reproduce the above copyright

 *    notice, this list of conditions and the following disclaimer in the

 *    documentation and/or other materials provided with the distribution.

 * 3. Neither the name of the author nor the names of any co-contributors

 *    may be used to endorse or promote products derived from this software

 *    without specific prior written permission.

 *

 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND

 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE

 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY

 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

 * SUCH DAMAGE.

 */

#ifndef _TASK_H

#define _TASK_H

#include <types.h>

#include <sys/cdefs.h>

#include <sys/list.h>

#include <sys/capability.h>        /* for cap_t */

#include <sys/sysinfo.h>

#include <thread.h>

#include <timer.h>

/*

 * Task struct

 */

struct task {

        struct list        link;                /* linkage on task list in system */

        char                name[MAXTASKNAME]; /* task name */

        task_t                parent;                /* parent task */

        vm_map_t        map;                /* address space description */

        int                suscnt;                /* suspend count */

        int                flags;                /* flags defined below */

        cap_t                capability;        /* security permission flag */

        struct timer        alarm;                /* timer for alarm exception */

        void                (*handler)(int); /* pointer to exception handler */

        struct list        threads;        /* list of threads */

        struct list        objects;        /* IPC objects owned by this task */

        struct list        mutexes;        /* mutexes owned by this task */

        struct list        conds;                /* cv owned by this task */

        struct list        sems;                /* semaphores owned by this task */

        int                nthreads;        /* number of threads */

        int                nobjects;        /* number of IPC objects */

        int                nsyncs;                /* number of syncronizer objects */

};

#define curtask                (curthread->task)

/* flags */

#define TF_SYSTEM        0x00000001 /* kernel task (kern_task) */

#define        TF_TRACE        0x00000002 /* process system call tracing active */

#define        TF_PROFIL        0x00000004 /* has started profiling */

#define        TF_AUDIT        0x00000008 /* audit mode */

/* default flags */

#ifdef CONFIG_AUDIT

#define TF_DEFAULT        TF_AUDIT

#else

#define TF_DEFAULT        0

#endif

/* vm option for task_create(). */

#define VM_NEW                0        /* create new memory map */

#define VM_SHARE        1        /* share parent's memory map */

#define VM_COPY                2        /* duplicate parent's memory map */

__BEGIN_DECLS

int         task_create(task_t, int, task_t *);

int         task_terminate(task_t);

task_t         task_self(void);

int         task_suspend(task_t);

int         task_resume(task_t);

int         task_setname(task_t, const char *);

int         task_setcap(task_t, cap_t);

int         task_chkcap(task_t, cap_t);

int         task_capable(cap_t);

int         task_valid(task_t);

int         task_access(task_t);

int         task_info(struct taskinfo *);

void         task_bootstrap(void);

void         task_init(void);

__END_DECLS

#endif /* !_TASK_H */