# sys.h

    00001 /*
    00002  * Copyright (c) 2001, Swedish Institute of Computer Science.
    00003  * All rights reserved.
    00004  *
    00005  * Redistribution and use in source and binary forms, with or without
    00006  * modification, are permitted provided that the following conditions
    00007  * are met:
    00008  * 1. Redistributions of source code must retain the above copyright
    00009  *    notice, this list of conditions and the following disclaimer.
    00010  * 2. Redistributions in binary form must reproduce the above copyright
    00011  *    notice, this list of conditions and the following disclaimer in the
    00012  *    documentation and/or other materials provided with the distribution.
    00013  * 3. Neither the name of the Institute nor the names of its contributors
    00014  *    may be used to endorse or promote products derived from this software
    00015  *    without specific prior written permission.
    00016  *
    00017  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
    00018  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    00019  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    00020  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
    00021  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    00022  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
    00023  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
    00024  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
    00025  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
    00026  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    00027  * SUCH DAMAGE.
    00028  *
    00029  * This file is part of the lwIP TCP/IP stack.
    00030  *
    00031  * Author: Adam Dunkels <adam@sics.se>
    00032  *
    00033  * $Id$
    00034  */
    00035 #ifndef __LWIP_SYS_H__
    00036 #define __LWIP_SYS_H__
    00037
    00038 #include "arch/cc.h"
    00039 #include "arch/sys_arch.h"
    00040
    00041 typedef void (* sys_timeout_handler)(void *arg);
    00042
    00043 struct sys_timeout {
    00044   struct sys_timeout *next;
    00045   uInt16 time;
    00046   sys_timeout_handler h;
    00047   void *arg;
    00048 };
    00049
    00050 struct sys_timeouts {
    00051   struct sys_timeout *next;
    00052 };
    00053
    00054 /* sys_init() must be called before anthing else. */
    00055 void sys_init(void);
    00056
    00057 /*
    00058  * sys_timeout():
    00059  *
    00060  * Schedule a timeout a specified amount of milliseconds in the
    00061  * future. When the timeout occurs, the specified timeout handler will
    00062  * be called. The handler will be passed the "arg" argument when
    00063  * called.
    00064  *
    00065  */
    00066 void sys_timeout(uInt16 msecs, sys_timeout_handler h, void *arg);
    00067 struct sys_timeouts *sys_arch_timeouts(void);
    00068
    00069 /* Semaphore functions. */
    00070 sys_sem_t sys_sem_new(uInt8 count);
    00071 void sys_sem_signal(sys_sem_t sem);
    00072 uInt16 sys_arch_sem_wait(sys_sem_t sem, uInt16 timeout);
    00073 void sys_sem_free(sys_sem_t sem);
    00074
    00075 void sys_sem_wait(sys_sem_t sem);
    00076
    00077 /* Mailbox functions. */
    00078 sys_mbox_t sys_mbox_new(void);
    00079 void sys_mbox_post(sys_mbox_t mbox, void *msg);
    00080 uInt16 sys_arch_mbox_fetch(sys_mbox_t mbox, void **msg, uInt16 timeout);
    00081 void sys_mbox_free(sys_mbox_t mbox);
    00082
    00083 void sys_mbox_fetch(sys_mbox_t mbox, void **msg);
    00084
    00085 /* Thread functions. */
    00086 void sys_thread_new(void (* thread)(void *arg), void *arg);
    00087
    00088 /* The following functions are used only in Unix code, and
    00089    can be omitted when porting the stack. */
    00090 /* Returns the current time in microseconds. */
    00091 unsigned long sys_now(void);
    00092
    00093 #endif /* __LWIP_SYS_H__ */