1/* Licensed to the Apache Software Foundation (ASF) under one or more
2 * contributor license agreements.  See the NOTICE file distributed with
3 * this work for additional information regarding copyright ownership.
4 * The ASF licenses this file to You under the Apache License, Version 2.0
5 * (the "License"); you may not use this file except in compliance with
6 * the License.  You may obtain a copy of the License at
7 *
8 *     http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17/**
18 * @file  worker/fdqueue.h
19 * @brief fd queue declarations
20 *
21 * @addtogroup APACHE_MPM_WORKER
22 * @{
23 */
24
25#ifndef FDQUEUE_H
26#define FDQUEUE_H
27#include "httpd.h"
28#include <stdlib.h>
29#if APR_HAVE_UNISTD_H
30#include <unistd.h>
31#endif
32#include <apr_thread_mutex.h>
33#include <apr_thread_cond.h>
34#include <sys/types.h>
35#if APR_HAVE_SYS_SOCKET_H
36#include <sys/socket.h>
37#endif
38#include <apr_errno.h>
39
40typedef struct fd_queue_info_t fd_queue_info_t;
41
42apr_status_t ap_queue_info_create(fd_queue_info_t **queue_info,
43                                  apr_pool_t *pool, int max_idlers);
44apr_status_t ap_queue_info_set_idle(fd_queue_info_t *queue_info,
45                                    apr_pool_t *pool_to_recycle);
46apr_status_t ap_queue_info_wait_for_idler(fd_queue_info_t *queue_info,
47                                          apr_pool_t **recycled_pool);
48apr_status_t ap_queue_info_term(fd_queue_info_t *queue_info);
49
50struct fd_queue_elem_t {
51    apr_socket_t      *sd;
52    apr_pool_t        *p;
53};
54typedef struct fd_queue_elem_t fd_queue_elem_t;
55
56struct fd_queue_t {
57    fd_queue_elem_t    *data;
58    unsigned int       nelts;
59    unsigned int       bounds;
60    unsigned int       in;
61    unsigned int       out;
62    apr_thread_mutex_t *one_big_mutex;
63    apr_thread_cond_t  *not_empty;
64    int                 terminated;
65};
66typedef struct fd_queue_t fd_queue_t;
67
68apr_status_t ap_queue_init(fd_queue_t *queue, int queue_capacity, apr_pool_t *a);
69apr_status_t ap_queue_push(fd_queue_t *queue, apr_socket_t *sd, apr_pool_t *p);
70apr_status_t ap_queue_pop(fd_queue_t *queue, apr_socket_t **sd, apr_pool_t **p);
71apr_status_t ap_queue_interrupt_all(fd_queue_t *queue);
72apr_status_t ap_queue_term(fd_queue_t *queue);
73
74#endif /* FDQUEUE_H */
75/** @} */
76