X-Git-Url: http://git.silcnet.org/gitweb/?p=silc.git;a=blobdiff_plain;f=lib%2Fsilcutil%2Fsilcstack.h;h=3543de2af26bf3ac91a35d7bff5f38bb7994abfd;hp=b10bb600f3441c8b8bb8c1d51bf1d07e43df8a00;hb=52e57c880aba9c5e89f59d962eb9af75670b76e0;hpb=ae1482a76c29db9fdcd6ed6cf63d312a37a5cb01 diff --git a/lib/silcutil/silcstack.h b/lib/silcutil/silcstack.h index b10bb600..3543de2a 100644 --- a/lib/silcutil/silcstack.h +++ b/lib/silcutil/silcstack.h @@ -4,7 +4,7 @@ Author: Pekka Riikonen - Copyright (C) 2003 - 2006 Pekka Riikonen + Copyright (C) 2003 - 2007 Pekka Riikonen This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -48,6 +48,7 @@ * * The data stack is not thread-safe. If the same stack context must be * used in multithreaded environment concurrency control must be employed. + * Each thread should allocate their own SilcStack. * ***/ @@ -81,11 +82,11 @@ typedef struct SilcStackStruct *SilcStack; * Static stack frame context that optionally can be used as stack * frame in SilcStack. By default silc_stack_push use pre-allocated * stack frame (or allocates new one if all frames are reserved), but - * user may also use staticly allocated SilcStackFrame instead. This + * user may also use statically allocated SilcStackFrame instead. This * is recommended when using SilcStack in recursive routine and the * recursion may become deep. Using static frame assures that during * recursion frames never run out and silc_stack_push never allocates - * any memory. In other normal usage staticly allocated SilcStackFrame + * any memory. In other normal usage statically allocated SilcStackFrame * is not needed, unless performance is critical. * ***/ @@ -142,10 +143,10 @@ void silc_stack_free(SilcStack stack); * If this returns zero (0) the system is out of memory. * * If the `frame' is non-NULL then that SilcStackFrame is used as - * stack frame. Usually `frame' is set to NULL by user. Staticly + * stack frame. Usually `frame' is set to NULL by user. Statically * allocated SilcStackFrame should be used when using silc_stack_push * in recursive function and the recursion may become deep. In this - * case using staticly allocated SilcStackFrame is recommended since + * case using statically allocated SilcStackFrame is recommended since * it assures that frames never run out and silc_stack_push never * allocates any memory. If your routine is not recursive then * setting `frame' to NULL is recommended, unless performance is @@ -169,8 +170,8 @@ void silc_stack_free(SilcStack stack); * silc_foo_parse_packet(packet, stack); * silc_stack_pop(stack); * - * Another example with recursion and using staticly allocated - * SilcStackFrame. After popping the staticly allocated frame can + * Another example with recursion and using statically allocated + * SilcStackFrame. After popping the statically allocated frame can * be reused if necessary. * * void silc_foo_this_function(SilcStack stack)