misc/unix/start.c

/* ====================================================================
 * Copyright (c) 1999 The Apache Group.  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 acknowledgment:
 *    "This product includes software developed by the Apache Group
 *    for use in the Apache HTTP server project (http://www.apache.org/)."
 *
 * 4. The names "Apache Server" and "Apache Group" must not be used to
 *    endorse or promote products derived from this software without
 *    prior written permission. For written permission, please contact
 *    apache@apache.org.
 *
 * 5. Products derived from this software may not be called "Apache"
 *    nor may "Apache" appear in their names without prior written
 *    permission of the Apache Group.
 *
 * 6. Redistributions of any form whatsoever must retain the following
 *    acknowledgment:
 *    "This product includes software developed by the Apache Group
 *    for use in the Apache HTTP server project (http://www.apache.org/)."
 *
 * THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY
 * EXPRESSED 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 APACHE GROUP OR
 * ITS 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.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of the Apache Group.
 * For more information on the Apache Group and the Apache HTTP server
 * project, please see <http://www.apache.org/>.
 *
 */

#include "apr_general.h"
#include "apr_errno.h"
#include "apr_pools.h"
#include "misc.h"
#include <pthread.h>
#include <signal.h>
#include <errno.h>
#include <string.h>

/* ***APRDOC********************************************************
 * ap_status_t ap_create_context(ap_context_t *, void *, ap_context_t **)
 *    Create a new context.
 * arg 1) The parent context.  If this is NULL, the new context is a root
 *        context.  If it is non-NULL, the new context will inherit all
 *        of it's parent context's attributes, except the pool will be a
 *        sub-pool.
 * arg 2) Any data to be assocaited with the context.  If this is a 
 *        sub-context, and this value is NULL, the new context will
 *        inherit the data from it's parent.
 * arg 3) The context we have just created.
 */
ap_status_t ap_create_context(struct context_t *cont, void *data, 
                              struct context_t **newcont)
{
    struct context_t *new;
    ap_pool_t *pool;

    if (cont) {
        pool = ap_make_sub_pool(cont->pool);
    }
    else {
        pool = ap_init_alloc();;
    }
        
    if (pool == NULL) {
        return APR_ENOPOOL;
    }   

    if (cont) { 
        new = (struct context_t *)ap_palloc(cont, sizeof(struct context_t));
    }
    else {
        new = (struct context_t *)malloc(sizeof(struct context_t));
    }

    new->pool = pool;
    if (data == NULL && cont) {
        new->prog_data = cont->prog_data;
    }
    else {
        new->prog_data = data;
    }
    if (cont) { 
        new->signal_safe = cont->signal_safe;
        new->cancel_safe = cont->cancel_safe;
    }
    else {
        new->signal_safe = 0;
        new->cancel_safe = 0;
    }
 
    *newcont = new;
    return APR_SUCCESS;
}

/* ***APRDOC********************************************************
 * ap_status_t ap_set_signal_safe(ap_context_t *, ap_int16_t)
 *    Set the signal safe attribute of the program.  If this bit-is on, then
 *    any apr function which uses this context IS signal safe.
 * arg 1) The context to modify.
 * arg 2) Should functions be signal safe or not?
 */
ap_status_t ap_set_signal_safe(struct context_t *cont, ap_int16_t safe)
{
    if (cont) { 
        cont->signal_safe = safe;
        return APR_SUCCESS;
    }
    return APR_ENOCONT;
}

/* ***APRDOC********************************************************
 * ap_status_t ap_set_cancel_safe(ap_context_t *, ap_int16_t)
 *    Set the cancel safe attribute of the program.  If this bit-is off, then
 *    any thread which is in a function using this context IS NOT allowed
 *    to be cancelled.
 * arg 1) The context to modify.
 * arg 2) Should functions be cancellable or not?
 */
ap_status_t ap_set_cancel_safe(struct context_t *cont, ap_int16_t safe)
{
    if (cont) {
        cont->cancel_safe = safe;
        return APR_SUCCESS;
    }
    return APR_ENOCONT;
}

/* ***APRDOC********************************************************
 * ap_status_t ap_destroy_context(ap_context_t *)
 *    Free the context and all of it's child contexts'.
 * arg 1) The context to free.
 */
ap_status_t ap_destroy_context(struct context_t *cont)
{
    ap_destroy_pool(cont);
    return APR_SUCCESS;
}

/* ***APRDOC********************************************************
 * ap_status_t ap_set_userdata(ap_context_t *, void *)
 *    Set the data associated with the current context.
 * arg 1) The current context.
 * arg 2) The user data associated with the context.
 */
ap_status_t ap_set_userdata(struct context_t *cont, void *data)
{
    if (cont) { 
        cont->prog_data = data;
        return APR_SUCCESS;
    }
    return APR_ENOCONT;
}

/* ***APRDOC********************************************************
 * ap_status_t ap_get_userdata(ap_context_t *, void **)
 *    Return the data associated with the current context.
 * arg 1) The current context.
 * arg 2) The user data associated with the context.
 */
ap_status_t ap_get_userdata(struct context_t *cont, void **data)
{
    if (cont) { 
        (*data) = cont->prog_data;
        return APR_SUCCESS;
    }
    return APR_ENOCONT;
}

/* ***APRDOC********************************************************
 * ap_status_t ap_initialize()
 *    Setup any APR internal data structures.  This MUST be the first
 *    function called for any APR program.
 */
ap_status_t ap_initialize(void)
{
#ifdef HAVE_PTHREAD_H 
    sigset_t sigset;

    sigfillset(&sigset);
    pthread_sigmask(SIG_BLOCK, &sigset, NULL);
#endif
    return APR_SUCCESS;
}