1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
/*
* Copyright (c) 1999 The University of Utah and the Flux Group.
* All rights reserved.
*
* Contributed by the Computer Security Research division,
* INFOSEC Research and Technology Office, NSA.
*
* This file is part of the Flux OSKit. The OSKit is free software, also known
* as "open source;" you can redistribute it and/or modify it under the terms
* of the GNU General Public License (GPL), version 2, as published by the Free
* Software Foundation (FSF). To explore alternate licensing terms, contact
* the University of Utah at csl-dist@cs.utah.edu or +1-801-585-3271.
*
* The OSKit is distributed in the hope that it will be useful, but WITHOUT ANY
* WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GPL for more details. You should have
* received a copy of the GPL along with the OSKit; see the file COPYING. If
* not, write to the FSF, 59 Temple Place #330, Boston, MA 02111-1307, USA.
*/
/* FLASK */
/*
queue.h
Definition of a generic queue type.
*/
#ifndef _QUEUE_H_
#define _QUEUE_H_
typedef void* queue_element_t;
typedef struct queue_node_t* queue_node_ptr_t;
struct queue_node_t {
queue_element_t element;
queue_node_ptr_t next;
};
struct queue_info_t {
queue_node_ptr_t head;
queue_node_ptr_t tail;
};
typedef struct queue_info_t* queue_t;
queue_t queue_create(void);
int queue_insert(queue_t, queue_element_t);
int queue_push(queue_t, queue_element_t);
queue_element_t queue_remove(queue_t);
queue_element_t queue_head(queue_t);
/* Note that destroying the queue does not destroy the elements */
void queue_destroy(queue_t);
/*
Applies the specified function f to each element in the
specified queue.
In addition to passing the element to f, queue_map
passes the specified void* pointer to f on each invocation.
If f returns a non-zero status, then queue_map will cease
iterating through the hash table and will propagate the error
return to its caller.
*/
int queue_map(queue_t, int (*f)(queue_element_t,void*), void*);
/*
Same as queue_map, except that if f returns a non-zero status,
then the element will be removed from the queue and the g
function will be applied to the element.
*/
void queue_map_remove_on_error(queue_t,
int (*f)(queue_element_t,void*),
void (*g)(queue_element_t,void*),
void*);
#endif
/* FLASK */
|
