--- libaitsess/inc/aitsess.h 2008/09/30 20:19:48 1.1.1.1.2.1 +++ libaitsess/inc/aitsess.h 2011/04/30 22:02:59 1.2.2.1 @@ -3,9 +3,46 @@ * by Michael Pounov * * $Author: misho $ -* $Id: aitsess.h,v 1.1.1.1.2.1 2008/09/30 20:19:48 misho Exp $ +* $Id: aitsess.h,v 1.2.2.1 2011/04/30 22:02:59 misho Exp $ * -*************************************************************************/ +************************************************************************** +The ELWIX and AITNET software is distributed under the following +terms: + +All of the documentation and software included in the ELWIX and AITNET +Releases is copyrighted by ELWIX - Sofia/Bulgaria + +Copyright 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 + by Michael Pounov . 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. All advertising materials mentioning features or use of this software + must display the following acknowledgement: +This product includes software developed by Michael Pounov +ELWIX - Embedded LightWeight unIX and its contributors. +4. Neither the name of AITNET nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY AITNET 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 REGENTS 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 __AITSESS_H #define __AITSESS_H @@ -126,6 +163,14 @@ inline void *ipc_attachSession(tagSess * __restrict s, inline void ipc_detachSession(tagSess * __restrict s); /* + * isAttached() Check for mapped/(attached) shared memory + * @s = Session item + * return: -1 null session item, 0 not attached, 1 attached memory +*/ +inline int isAttached(tagSess * __restrict s); + + +/* * map_notSemaphore() MMAP negative block if semaphore isn`t signaled * @s = Session item */ @@ -173,13 +218,14 @@ inline int ipc_addSemaphore(tagSess * __restrict s); */ inline int ipc_decSemaphore(tagSess * __restrict s); + // --------------------------------------------------------- // // Lazy macros for lazy programmers :-) by Michael Pounov; Optimizing work with sessions! // #define DESTROY_SESSION(fname, s) do { \ - switch ((s)->type) { \ + switch (((*s))->type) { \ case SHARED_IPC: \ ipc_destroySession((fname), (s)); \ break; \ @@ -189,13 +235,13 @@ inline int ipc_decSemaphore(tagSess * __restrict s); } \ } while(0) -#define ATTACH_MEMORY(s, shared) do { \ +#define ATTACH_MEMORY(s) do { \ switch ((s)->type) { \ case SHARED_IPC: \ - (shared) = ipc_attachSession((s), 0); \ + ipc_attachSession((s), 0); \ break; \ case SHARED_MAP: \ - (shared) = map_attachSession((s), 0); \ + map_attachSession((s), 0); \ break; \ } \ } while(0) @@ -263,6 +309,19 @@ inline int ipc_decSemaphore(tagSess * __restrict s); // --------------------------------------------------------- +/* + * sess_FreeValues() Free all values from value array allocated from sess_GetValues() + * @ppsVals = Array strings + * return: none +*/ +inline void sess_FreeValues(char *** __restrict ppsVals); +/* + * sess_GetValues() Get all values from session shared memory + * @s = Session item + * @ppsVals = Return array strings + * return: -1 error: in parameter, !=-1 count of returned strings in ppsVals (must be free after use!) +*/ +int sess_GetValues(tagSess * __restrict s, char ***ppsVals); /* * sess_GetValue() Get value from session shared memory from attribute * @s = Session item