1 // -----------------------------------------------------------------------
2 // Copyright (C) 2006 - 2007 FRESCOR consortium partners:
4 // Universidad de Cantabria, SPAIN
5 // University of York, UK
6 // Scuola Superiore Sant'Anna, ITALY
7 // Kaiserslautern University, GERMANY
8 // Univ. Politécnica Valencia, SPAIN
9 // Czech Technical University in Prague, CZECH REPUBLIC
11 // Thales Communication S.A. FRANCE
12 // Visual Tools S.A. SPAIN
13 // Rapita Systems Ltd UK
16 // See http://www.frescor.org for a link to partners' websites
18 // FRESCOR project (FP6/2005/IST/5-034026) is funded
19 // in part by the European Union Sixth Framework Programme
20 // The European Union is not liable of any use that may be
24 // based on previous work (FSF) done in the FIRST project
26 // Copyright (C) 2005 Mälardalen University, SWEDEN
27 // Scuola Superiore S.Anna, ITALY
28 // Universidad de Cantabria, SPAIN
29 // University of York, UK
31 // FSF API web pages: http://marte.unican.es/fsf/docs
32 // http://shark.sssup.it/contrib/first/docs/
34 // This file is part of FRSH API
36 // FRSH API is free software; you can redistribute it and/or modify
37 // it under the terms of the GNU General Public License as published by
38 // the Free Software Foundation; either version 2, or (at your option)
41 // FRSH API is distributed in the hope that it will be useful, but
42 // WITHOUT ANY WARRANTY; without even the implied warranty of
43 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
44 // General Public License for more details.
46 // You should have received a copy of the GNU General Public License
47 // distributed with FRSH API; see file COPYING. If not, write to the
48 // Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
51 // As a special exception, if you include this header file into source
52 // files to be compiled, this header file does not by itself cause
53 // the resulting executable to be covered by the GNU General Public
54 // License. This exception does not however invalidate any other
55 // reasons why the executable file might be covered by the GNU General
57 // -----------------------------------------------------------------------
59 //==============================================
60 // ******** ******* ******** ** **
61 // **///// /**////** **////// /** /**
62 // ** /** /** /** /** /**
63 // ******* /******* /********* /**********
64 // **//// /**///** ////////** /**//////**
65 // ** /** //** /** /** /**
66 // ** /** //** ******** /** /**
67 // // // // //////// // //
69 // FRSH(FRescor ScHeduler), pronounced "fresh"
70 //==============================================
71 #ifndef _FRSH_THREADS_H_
72 #define _FRSH_THREADS_H_
74 #include "frsh_core_types.h"
75 #include "frsh_core.h"
80 * @file frsh_thread_attrs.h
84 * @defgroup threadfunc FRSH thread functions.
87 * These functions are used to manage frsh_thread_t and
88 * frsh_thread_attr_t used in the public API of FRSH.
94 /*************************
96 *************************/
99 * frsh_thread_attr_init()
101 * Initialize a thread attributes object
103 * This function initializes the object pointed to by attr to all
104 * the default values defined by FRSH
106 * @return 0 if successful; otherwise it returns \n
107 * FOSA_ENOMEM: insufficient memory exists to initialize the thread
110 static inline int frsh_thread_attr_init(frsh_thread_attr_t *attr)
112 return fosa_thread_attr_init(attr);
116 * frsh_thread_attr_destroy()
118 * Destroy a thread attributes object
120 * This function is used to destroy the thread attributes object,
121 * pointed to by attr, and deallocate any system resources allocated for it
125 static inline int frsh_thread_attr_destroy(frsh_thread_attr_t *attr)
127 return fosa_thread_attr_destroy(attr);
131 * frsh_thread_attr_set_stacksize()
133 * Set the thread minimum stack size in a thread attributes object
135 * This function sets the minimum stack size of the thread attributes
136 * object attr to the value given by stacksize, in bytes. This
137 * function has no runtime effect on the stack size, except when the
138 * attributes object is used to create a thread, when it will be
139 * created with the specified minimum stack size
141 * @return 0 if successful, or the following error code:
142 * FOSA_EINVAL: the specified stacksize value is not supported in
143 * this implementation
145 static inline int frsh_thread_attr_set_stacksize(frsh_thread_attr_t *attr, size_t stacksize)
147 return fosa_thread_attr_set_stacksize(attr, stacksize);
151 * frsh_thread_attr_get_stacksize()
153 * Get the thread minimum stack size from a thread attributes object
155 * This function sets the variable pointed to by stacksize to the
156 * minimum stack size stored in the thread attributes object attr.
160 static inline int frsh_thread_attr_get_stacksize
161 (const frsh_thread_attr_t *attr, size_t *stacksize)
163 return fosa_thread_attr_get_stacksize(attr, stacksize);