semaphore.h

Go to the documentation of this file.
00001 /*
00002  * Copyright (C) 2000-2004 by ETH Zurich
00003  *
00004  * Redistribution and use in source and binary forms, with or without
00005  * modification, are permitted provided that the following conditions
00006  * are met:
00007  *
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 copyright holders nor the names of
00014  *    contributors may be used to endorse or promote products derived
00015  *    from this software without specific prior written permission.
00016  *
00017  * THIS SOFTWARE IS PROVIDED BY ETH ZURICH AND CONTRIBUTORS
00018  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
00019  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
00020  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ETH ZURICH
00021  * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
00022  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
00023  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
00024  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
00025  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00026  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
00027  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00028  * SUCH DAMAGE.
00029  *
00030  * For additional information see http://www.ethernut.de/
00031  *
00032  */
00033 
00034 /* sempahore.h - a nut/os implementation of semaphore functions
00035  *
00036  * 2004.05.06 Matthias Ringwald <matthias.ringwald@inf.ethz.ch>
00037  *
00038  */
00039 /*
00040  * $Log: semaphore.h,v $
00041  * Revision 1.5  2007/08/29 07:43:54  haraldkipp
00042  * Documentation updated and corrected.
00043  *
00044  * Revision 1.4  2005/08/02 17:46:49  haraldkipp
00045  * Major API documentation update.
00046  *
00047  * Revision 1.3  2004/06/02 16:43:36  olereinhardt
00048  * fixed bug (integer overflow) in semaphore implementation
00049  *
00050  * Revision 1.2  2004/05/18 18:38:14  drsung
00051  * Added $Log keyword for CVS and avoid multiple inclusion of header file.
00052  *
00053  */
00054  
00055 #ifndef _SYS_SEMAPHORE_H
00056 #define _SYS_SEMAPHORE_H
00057 
00058 #include <sys/types.h>
00059 #include <sys/thread.h>
00060 
00065 
00066 #ifdef __cplusplus
00067 extern "C" {
00068 #endif
00069 
00073     typedef struct _SEM SEM;
00074 
00080     struct _SEM {
00081         HANDLE qhp;           
00082         short value;          
00083     };
00084 
00085     extern void NutSemInit(SEM * sem, short value);
00086     extern void NutSemWait(SEM * sem);
00087     extern int NutSemTryWait(SEM * sem);
00088     extern void NutSemPost(SEM * sem);
00089     extern int NutSemDestroy(SEM * sem);
00090 
00091 #ifdef __cplusplus
00092 }
00093 #endif
00094 
00097 #endif /* #ifndef _SYS_SEMAPHORE_H */

© 2000-2007 by egnite Software GmbH - visit http://www.ethernut.de/