1 /* crypto/stack/stack.h */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  *
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  *
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  *
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *   notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *   notice, this list of conditions and the following disclaimer in the
30  *   documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *   must display the following acknowledgement:
33  *   "This product includes cryptographic software written by
34  *    Eric Young (eay@cryptsoft.com)"
35  *   The word 'cryptographic' can be left out if the rouines from the library
36  *   being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from
38  *   the apps directory (application code) you must include an acknowledgement:
39  *   "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  *
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  *
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58 
59 module deimos.openssl.stack;
60 
61 import deimos.openssl._d_util;
62 import deimos.openssl.opensslv;
63 
64 extern (C):
65 nothrow:
66 
67 struct stack_st {
68 	int num;
69 	char** data;
70 	int sorted;
71 
72 	int num_alloc;
73 	ExternC!(int function(const(void)*, const(void)*)) comp;
74 	}
75 alias stack_st _STACK;  /* Use STACK_OF(...) instead */
76 
77 int M_sk_num()(_STACK* sk) { return (sk ? sk.num : -1); }
78 char* M_sk_value()(_STACK* sk, size_t n) { return (sk ? sk.data[n] : null); }
79 
80 /*******************************************************************************
81 
82     Starting from OpenSSL v1.1.0, the `sk_*` functions are prefixed with
83     `OPENSSL_`, so e.g. `sk_num` becomes `OPENSSL_sk_num`.
84 
85     To cope with that and provide downstream with an easier interface to deal
86     with, we always provide the `OPENSSL_` methods, as they are just `extern(C)`
87     anyway, and we either provide `sk_*` as `alias`es or `extern (C)`.
88 
89     The need for aliases comes from users of those binding, e.g. `safestack`.
90 
91 *******************************************************************************/
92 
93 static if (OPENSSL_VERSION_AT_LEAST(1, 1))
94 {
95     int OPENSSL_sk_num(const(_STACK)*);
96     void* OPENSSL_sk_value(const(_STACK)*, int);
97 
98     void* OPENSSL_sk_set(_STACK*, int, void*);
99 
100     _STACK* OPENSSL_sk_new(ExternC!(int function(const(void)*, const(void)*)) cmp);
101     _STACK* OPENSSL_sk_new_null();
102     void OPENSSL_sk_free(_STACK*);
103     void OPENSSL_sk_pop_free(_STACK* st, ExternC!(void function(void*)) func);
104     int OPENSSL_sk_insert(_STACK* sk, void* data, int where);
105     void* OPENSSL_sk_delete(_STACK* st, int loc);
106     void* OPENSSL_sk_delete_ptr(_STACK* st, void* p);
107     int OPENSSL_sk_find(_STACK* st, void* data);
108     int OPENSSL_sk_find_ex(_STACK* st, void* data);
109     int OPENSSL_sk_push(_STACK* st, void* data);
110     int OPENSSL_sk_unshift(_STACK* st, void* data);
111     void* OPENSSL_sk_shift(_STACK* st);
112     void* OPENSSL_sk_pop(_STACK* st);
113     void OPENSSL_sk_zero(_STACK* st);
114     int function(const(void)*, const(void)*) OPENSSL_sk_set_cmp_func(_STACK* sk, ExternC!(int function(const(void)*, const(void)*)) c);
115     _STACK* OPENSSL_sk_dup(_STACK* st);
116     void OPENSSL_sk_sort(_STACK* st);
117     int OPENSSL_sk_is_sorted(const(_STACK)* st);
118 
119     alias sk_num = OPENSSL_sk_num;
120     alias sk_value = OPENSSL_sk_value;
121     alias sk_set = OPENSSL_sk_set;
122 
123     alias sk_new = OPENSSL_sk_new;
124     alias sk_new_null = OPENSSL_sk_new_null;
125     alias sk_free = OPENSSL_sk_free;
126     alias sk_pop_free = OPENSSL_sk_pop_free;
127     alias sk_insert = OPENSSL_sk_insert;
128     alias sk_delete = OPENSSL_sk_delete;
129     alias sk_delete_ptr = OPENSSL_sk_delete_ptr;
130     alias sk_find = OPENSSL_sk_find;
131     alias sk_find_ex = OPENSSL_sk_find_ex;
132 
133     alias sk_push = OPENSSL_sk_push;
134     alias sk_unshift = OPENSSL_sk_unshift;
135     alias sk_shift = OPENSSL_sk_shift;
136     alias sk_pop = OPENSSL_sk_pop;
137     alias sk_zero = OPENSSL_sk_zero;
138     alias sk_set_cmp_func = OPENSSL_sk_set_cmp_func;
139     alias sk_dup = OPENSSL_sk_dup;
140     alias sk_sort = OPENSSL_sk_sort;
141     alias sk_is_sorted = OPENSSL_sk_is_sorted;
142 }
143 else
144 {
145     int sk_num(const(_STACK)*);
146     void* sk_value(const(_STACK)*, int);
147 
148     void* sk_set(_STACK*, int, void*);
149 
150     _STACK* sk_new(ExternC!(int function(const(void)*, const(void)*)) cmp);
151     _STACK* sk_new_null();
152     void sk_free(_STACK*);
153     void sk_pop_free(_STACK* st, ExternC!(void function(void*)) func);
154     int sk_insert(_STACK* sk, void* data, int where);
155     void* sk_delete(_STACK* st, int loc);
156     void* sk_delete_ptr(_STACK* st, void* p);
157     int sk_find(_STACK* st, void* data);
158     int sk_find_ex(_STACK* st, void* data);
159     int sk_push(_STACK* st, void* data);
160     int sk_unshift(_STACK* st, void* data);
161     void* sk_shift(_STACK* st);
162     void* sk_pop(_STACK* st);
163     void sk_zero(_STACK* st);
164     int function(const(void)*, const(void)*) sk_set_cmp_func(_STACK* sk, ExternC!(int function(const(void)*, const(void)*)) c);
165     _STACK* sk_dup(_STACK* st);
166     void sk_sort(_STACK* st);
167     int sk_is_sorted(const(_STACK)* st);
168 }