|
[ source navigation ] [ diff markup ] [ identifier search ] [ general search ] |
|||
|
001 /* Copyright (C) 2005 David Decotigny 001 /* Copyright (C) 2005 David Decotigny 002 002 003 This program is free software; you can redi 003 This program is free software; you can redistribute it and/or 004 modify it under the terms of the GNU Genera 004 modify it under the terms of the GNU General Public License 005 as published by the Free Software Foundatio 005 as published by the Free Software Foundation; either version 2 006 of the License, or (at your option) any lat 006 of the License, or (at your option) any later version. 007 007 008 This program is distributed in the hope tha 008 This program is distributed in the hope that it will be useful, 009 but WITHOUT ANY WARRANTY; without even the 009 but WITHOUT ANY WARRANTY; without even the implied warranty of 010 MERCHANTABILITY or FITNESS FOR A PARTICULAR 010 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 011 GNU General Public License for more details 011 GNU General Public License for more details. 012 012 013 You should have received a copy of the GNU 013 You should have received a copy of the GNU General Public License 014 along with this program; if not, write to t 014 along with this program; if not, write to the Free Software 015 Foundation, Inc., 59 Temple Place - Suite 3 015 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, 016 USA. 016 USA. 017 */ 017 */ 018 #ifndef _SOS_PROCESS_H_ 018 #ifndef _SOS_PROCESS_H_ 019 #define _SOS_PROCESS_H_ 019 #define _SOS_PROCESS_H_ 020 020 021 /** 021 /** 022 * @file process.h 022 * @file process.h 023 * 023 * 024 * SOS Definition of a process and associated 024 * SOS Definition of a process and associated management API. A 025 * process is basically the collection of all 025 * process is basically the collection of all the resources requested 026 * by a user program. The threads are one of t 026 * by a user program. The threads are one of these resources, the 027 * mm_context is one other example of such res 027 * mm_context is one other example of such resources. In SOS, a 028 * "process" is mainly a resource manager, a c 028 * "process" is mainly a resource manager, a container. It does not 029 * provide much advanced functionality apart f 029 * provide much advanced functionality apart from a reference counter. 030 * 030 * 031 * Only the user threads belong to a process. 031 * Only the user threads belong to a process. The kernel 032 * threads don't because the resources they ho 032 * threads don't because the resources they hold are held by the whole 033 * kernel, thus by ALL the threads (kernel AND 033 * kernel, thus by ALL the threads (kernel AND user): the notion of 034 * "process" doesn't have any meaning for them 034 * "process" doesn't have any meaning for them because they don't own 035 * any proper resource (apart from their stack 035 * any proper resource (apart from their stack). 036 */ 036 */ 037 037 038 #include <sos/errno.h> 038 #include <sos/errno.h> 039 039 040 040 041 /** 041 /** 042 * The definition of an SOS process is opaque. 042 * The definition of an SOS process is opaque. @see process.c 043 */ 043 */ 044 struct sos_process; 044 struct sos_process; 045 045 046 #include <sos/thread.h> 046 #include <sos/thread.h> 047 047 048 048 049 /** 049 /** 050 * Default size of a user stack (8 MB) 050 * Default size of a user stack (8 MB) 051 */ 051 */ 052 #define SOS_DEFAULT_USER_STACK_SIZE (8 << 20) 052 #define SOS_DEFAULT_USER_STACK_SIZE (8 << 20) 053 053 054 054 055 /** 055 /** 056 * Initialization of the process subsystem 056 * Initialization of the process subsystem 057 */ 057 */ 058 sos_ret_t sos_process_subsystem_setup(); 058 sos_ret_t sos_process_subsystem_setup(); 059 059 060 060 061 /** 061 /** 062 * Initialize a new process and return a refer !! 062 * Initialize a new (empty) process and return a reference to it. This 063 * means that: 063 * means that: 064 * - A new mm_context has been initialized 064 * - A new mm_context has been initialized 065 * - No threads belong to this process yet 065 * - No threads belong to this process yet 066 * - If do_copy_current_process is FALSE: !! 066 * - Nothing is mapped in user space 067 * - Nothing is mapped in user space !! 067 * - No other resource is used 068 * - No other resource is used << 069 * - If do_copy_current_process is TRUE: << 070 * - Same user mapping as in current threa << 071 * - Same other resources used as for curr << 072 * 068 * 073 * @return NULL on error (not enough memory) 069 * @return NULL on error (not enough memory) 074 */ 070 */ 075 struct sos_process *sos_process_create(const c !! 071 struct sos_process *sos_process_create_empty(const char *name); 076 sos_boo << 077 072 078 073 079 /** 074 /** 080 * Signal we're using another reference to a p 075 * Signal we're using another reference to a process. 081 */ 076 */ 082 sos_ret_t sos_process_ref(struct sos_process * 077 sos_ret_t sos_process_ref(struct sos_process *proc); 083 078 084 079 085 /** 080 /** 086 * Release the reference to a process. If nobo 081 * Release the reference to a process. If nobody holds a reference to 087 * it and if the process does not have any thr 082 * it and if the process does not have any thread anymore, the process 088 * is destroyed. 083 * is destroyed. 089 * 084 * 090 * @return -SOS_EBUSY when the process is stil 085 * @return -SOS_EBUSY when the process is still referenced afterwards 091 */ 086 */ 092 sos_ret_t sos_process_unref(struct sos_process 087 sos_ret_t sos_process_unref(struct sos_process *proc); 093 088 094 089 095 /** 090 /** 096 * Return the number of threads currently regi 091 * Return the number of threads currently registered in the process 097 */ 092 */ 098 sos_count_t sos_process_get_nb_threads(const s 093 sos_count_t sos_process_get_nb_threads(const struct sos_process *proc); 099 094 100 095 101 /** 096 /** 102 * Retrieve the address of the MMU configurati 097 * Retrieve the address of the MMU configuration description 103 * 098 * 104 * @return NULL on error 099 * @return NULL on error 105 */ 100 */ 106 struct sos_mm_context * 101 struct sos_mm_context * 107 sos_process_get_mm_context(const struct sos_pr 102 sos_process_get_mm_context(const struct sos_process *proc); 108 103 109 104 110 /** << 111 * Retrieve the address space for the process << 112 * << 113 * @return NULL on error << 114 */ << 115 struct sos_umem_vmm_as * << 116 sos_process_get_address_space(const struct sos << 117 << 118 << 119 /* ******************************************* 105 /* *************************************************** 120 * Restricted functions 106 * Restricted functions 121 */ 107 */ 122 108 123 109 124 /** 110 /** 125 * Change the name of the process 111 * Change the name of the process 126 */ 112 */ 127 sos_ret_t sos_process_set_name(struct sos_proc 113 sos_ret_t sos_process_set_name(struct sos_process * proc, 128 const char * ne 114 const char * new_name); 129 115 130 116 131 /** 117 /** 132 * Attach the given thread to the process 118 * Attach the given thread to the process 133 * 119 * 134 * @note This function is called internally by 120 * @note This function is called internally by thread.c . The thread 135 * is assumed to be in the "CREATED" state, ie 121 * is assumed to be in the "CREATED" state, ie one cannot attach a 136 * thread to some other process once it has be 122 * thread to some other process once it has been created. 137 */ 123 */ 138 sos_ret_t sos_process_register_thread(struct s 124 sos_ret_t sos_process_register_thread(struct sos_process *in_proc, 139 struct s 125 struct sos_thread *thr); 140 126 141 127 142 /** 128 /** 143 * Remove the given thread from the given proc 129 * Remove the given thread from the given process threads' list. When 144 * the process becomes empty (ie does not cont 130 * the process becomes empty (ie does not contain any thread anymore 145 * and is not referenced by anybody), all its 131 * and is not referenced by anybody), all its resources are released. 146 * 132 * 147 * @note This function is called internally by 133 * @note This function is called internally by thread.c . The thread 148 * is assumed to be in the "ZOMBIE" state. 134 * is assumed to be in the "ZOMBIE" state. 149 */ 135 */ 150 sos_ret_t sos_process_unregister_thread(struct 136 sos_ret_t sos_process_unregister_thread(struct sos_thread *thr); 151 << 152 << 153 /** << 154 * Replace the address space of the process by << 155 * << 156 * @note The previous address space (if any) i << 157 */ << 158 sos_ret_t sos_process_set_address_space(struct << 159 struct << 160 137 161 #endif /* _SOS_PROCESS_H_ */ 138 #endif /* _SOS_PROCESS_H_ */
[ source navigation ] | [ diff markup ] | [ identifier search ] | [ general search ] |