Annotation of embedaddon/ntp/lib/isc/event.c, revision 1.1

1.1     ! misho       1: /*
        !             2:  * Copyright (C) 2004, 2005, 2007  Internet Systems Consortium, Inc. ("ISC")
        !             3:  * Copyright (C) 1998-2001  Internet Software Consortium.
        !             4:  *
        !             5:  * Permission to use, copy, modify, and/or distribute this software for any
        !             6:  * purpose with or without fee is hereby granted, provided that the above
        !             7:  * copyright notice and this permission notice appear in all copies.
        !             8:  *
        !             9:  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
        !            10:  * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
        !            11:  * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
        !            12:  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
        !            13:  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
        !            14:  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
        !            15:  * PERFORMANCE OF THIS SOFTWARE.
        !            16:  */
        !            17: 
        !            18: /* $Id: event.c,v 1.21 2007/06/19 23:47:17 tbox Exp $ */
        !            19: 
        !            20: /*!
        !            21:  * \file
        !            22:  * \author Principal Author: Bob Halley
        !            23:  */
        !            24: 
        !            25: #include <config.h>
        !            26: 
        !            27: #include <isc/event.h>
        !            28: #include <isc/mem.h>
        !            29: #include <isc/util.h>
        !            30: 
        !            31: /***
        !            32:  *** Events.
        !            33:  ***/
        !            34: 
        !            35: static void
        !            36: destroy(isc_event_t *event) {
        !            37:        isc_mem_t *mctx = event->ev_destroy_arg;
        !            38: 
        !            39:        isc_mem_put(mctx, event, event->ev_size);
        !            40: }
        !            41: 
        !            42: isc_event_t *
        !            43: isc_event_allocate(isc_mem_t *mctx, void *sender, isc_eventtype_t type,
        !            44:                   isc_taskaction_t action, const void *arg, size_t size)
        !            45: {
        !            46:        isc_event_t *event;
        !            47:        void *deconst_arg;
        !            48: 
        !            49:        REQUIRE(size >= sizeof(struct isc_event));
        !            50:        REQUIRE(action != NULL);
        !            51: 
        !            52:        event = isc_mem_get(mctx, size);
        !            53:        if (event == NULL)
        !            54:                return (NULL);
        !            55: 
        !            56:        /*
        !            57:         * Removing the const attribute from "arg" is the best of two
        !            58:         * evils here.  If the event->ev_arg member is made const, then
        !            59:         * it affects a great many users of the task/event subsystem
        !            60:         * which are not passing in an "arg" which starts its life as
        !            61:         * const.  Changing isc_event_allocate() and isc_task_onshutdown()
        !            62:         * to not have "arg" prototyped as const (which is quite legitimate,
        !            63:         * because neither of those functions modify arg) can cause
        !            64:         * compiler whining anytime someone does want to use a const
        !            65:         * arg that they themselves never modify, such as with
        !            66:         * gcc -Wwrite-strings and using a string "arg".
        !            67:         */
        !            68:        DE_CONST(arg, deconst_arg);
        !            69: 
        !            70:        ISC_EVENT_INIT(event, size, 0, NULL, type, action, deconst_arg,
        !            71:                       sender, destroy, mctx);
        !            72: 
        !            73:        return (event);
        !            74: }
        !            75: 
        !            76: void
        !            77: isc_event_free(isc_event_t **eventp) {
        !            78:        isc_event_t *event;
        !            79: 
        !            80:        REQUIRE(eventp != NULL);
        !            81:        event = *eventp;
        !            82:        REQUIRE(event != NULL);
        !            83: 
        !            84:        if (event->ev_destroy != NULL)
        !            85:                (event->ev_destroy)(event);
        !            86: 
        !            87:        *eventp = NULL;
        !            88: }

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>