First public contribution.
1 /* crypto/bio/bio_lib.c */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
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.
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).
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.
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
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)"
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
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.]
61 #include <openssl/crypto.h>
63 #include <openssl/bio.h>
64 #include <openssl/stack.h>
66 EXPORT_C BIO *BIO_new(BIO_METHOD *method)
70 ret=(BIO *)OPENSSL_malloc(sizeof(BIO));
73 BIOerr(BIO_F_BIO_NEW,ERR_R_MALLOC_FAILURE);
77 memset(ret,0,sizeof(BIO));
79 if (!BIO_set(ret,method))
87 EXPORT_C int BIO_set(BIO *bio, BIO_METHOD *method)
103 CRYPTO_new_ex_data(CRYPTO_EX_INDEX_BIO, bio, &bio->ex_data);
104 if (method->create != NULL)
105 if (!method->create(bio))
107 CRYPTO_free_ex_data(CRYPTO_EX_INDEX_BIO, bio,
114 EXPORT_C int BIO_free(BIO *a)
118 if (a == NULL) return(0);
120 i=CRYPTO_add(&a->references,-1,CRYPTO_LOCK_BIO);
124 if (i > 0) return(1);
128 fprintf(stderr,"BIO_free, bad reference count\n");
132 if ((a->callback != NULL) &&
133 ((i=(int)a->callback(a,BIO_CB_FREE,NULL,0,0L,1L)) <= 0))
136 CRYPTO_free_ex_data(CRYPTO_EX_INDEX_BIO, a, &a->ex_data);
138 if ((a->method == NULL) || (a->method->destroy == NULL)) return(1);
139 ret=a->method->destroy(a);
144 EXPORT_C void BIO_vfree(BIO *a)
147 EXPORT_C void BIO_clear_flags(BIO *b, int flags)
152 EXPORT_C int BIO_test_flags(const BIO *b, int flags)
154 return (b->flags & flags);
157 EXPORT_C void BIO_set_flags(BIO *b, int flags)
162 EXPORT_C long (*BIO_get_callback(const BIO *b))(struct bio_st *,int,const char *,int, long,long)
167 EXPORT_C void BIO_set_callback(BIO *b, long (*cb)(struct bio_st *,int,const char *,int, long,long))
172 EXPORT_C void BIO_set_callback_arg(BIO *b, char *arg)
177 EXPORT_C char * BIO_get_callback_arg(const BIO *b)
182 EXPORT_C const char * BIO_method_name(const BIO *b)
184 return b->method->name;
187 EXPORT_C int BIO_method_type(const BIO *b)
189 return b->method->type;
191 EXPORT_C int BIO_read(BIO *b, void *out, int outl)
194 long (*cb)(BIO *,int,const char *,int,long,long);
196 if ((b == NULL) || (b->method == NULL) || (b->method->bread == NULL))
198 BIOerr(BIO_F_BIO_READ,BIO_R_UNSUPPORTED_METHOD);
204 ((i=(int)cb(b,BIO_CB_READ,out,outl,0L,1L)) <= 0))
209 BIOerr(BIO_F_BIO_READ,BIO_R_UNINITIALIZED);
213 i=b->method->bread(b,out,outl);
215 if (i > 0) b->num_read+=(unsigned long)i;
218 i=(int)cb(b,BIO_CB_READ|BIO_CB_RETURN,out,outl,
223 EXPORT_C int BIO_write(BIO *b, const void *in, int inl)
226 long (*cb)(BIO *,int,const char *,int,long,long);
232 if ((b->method == NULL) || (b->method->bwrite == NULL))
234 BIOerr(BIO_F_BIO_WRITE,BIO_R_UNSUPPORTED_METHOD);
239 ((i=(int)cb(b,BIO_CB_WRITE,in,inl,0L,1L)) <= 0))
244 BIOerr(BIO_F_BIO_WRITE,BIO_R_UNINITIALIZED);
248 i=b->method->bwrite(b,in,inl);
250 if (i > 0) b->num_write+=(unsigned long)i;
253 i=(int)cb(b,BIO_CB_WRITE|BIO_CB_RETURN,in,inl,
258 EXPORT_C int BIO_puts(BIO *b, const char *in)
261 long (*cb)(BIO *,int,const char *,int,long,long);
263 if ((b == NULL) || (b->method == NULL) || (b->method->bputs == NULL))
265 BIOerr(BIO_F_BIO_PUTS,BIO_R_UNSUPPORTED_METHOD);
272 ((i=(int)cb(b,BIO_CB_PUTS,in,0,0L,1L)) <= 0))
277 BIOerr(BIO_F_BIO_PUTS,BIO_R_UNINITIALIZED);
281 i=b->method->bputs(b,in);
283 if (i > 0) b->num_write+=(unsigned long)i;
286 i=(int)cb(b,BIO_CB_PUTS|BIO_CB_RETURN,in,0,
291 EXPORT_C int BIO_gets(BIO *b, char *in, int inl)
294 long (*cb)(BIO *,int,const char *,int,long,long);
296 if ((b == NULL) || (b->method == NULL) || (b->method->bgets == NULL))
298 BIOerr(BIO_F_BIO_GETS,BIO_R_UNSUPPORTED_METHOD);
305 ((i=(int)cb(b,BIO_CB_GETS,in,inl,0L,1L)) <= 0))
310 BIOerr(BIO_F_BIO_GETS,BIO_R_UNINITIALIZED);
314 i=b->method->bgets(b,in,inl);
317 i=(int)cb(b,BIO_CB_GETS|BIO_CB_RETURN,in,inl,
322 EXPORT_C int BIO_indent(BIO *b,int indent,int max)
329 if(BIO_puts(b," ") != 1)
334 EXPORT_C long BIO_int_ctrl(BIO *b, int cmd, long larg, int iarg)
339 return(BIO_ctrl(b,cmd,larg,(char *)&i));
342 EXPORT_C char *BIO_ptr_ctrl(BIO *b, int cmd, long larg)
346 if (BIO_ctrl(b,cmd,larg,(char *)&p) <= 0)
352 EXPORT_C long BIO_ctrl(BIO *b, int cmd, long larg, void *parg)
355 long (*cb)(BIO *,int,const char *,int,long,long);
357 if (b == NULL) return(0);
359 if ((b->method == NULL) || (b->method->ctrl == NULL))
361 BIOerr(BIO_F_BIO_CTRL,BIO_R_UNSUPPORTED_METHOD);
368 ((ret=cb(b,BIO_CB_CTRL,parg,cmd,larg,1L)) <= 0))
371 ret=b->method->ctrl(b,cmd,larg,parg);
374 ret=cb(b,BIO_CB_CTRL|BIO_CB_RETURN,parg,cmd,
379 EXPORT_C long BIO_callback_ctrl(BIO *b, int cmd, void (*fp)(struct bio_st *, int, const char *, int, long, long))
382 long (*cb)(BIO *,int,const char *,int,long,long);
384 if (b == NULL) return(0);
386 if ((b->method == NULL) || (b->method->callback_ctrl == NULL))
388 BIOerr(BIO_F_BIO_CALLBACK_CTRL,BIO_R_UNSUPPORTED_METHOD);
395 ((ret=cb(b,BIO_CB_CTRL,(void *)&fp,cmd,0,1L)) <= 0))
398 ret=b->method->callback_ctrl(b,cmd,fp);
401 ret=cb(b,BIO_CB_CTRL|BIO_CB_RETURN,(void *)&fp,cmd,
406 /* It is unfortunate to duplicate in functions what the BIO_(w)pending macros
407 * do; but those macros have inappropriate return type, and for interfacing
408 * from other programming languages, C macros aren't much of a help anyway. */
409 EXPORT_C size_t BIO_ctrl_pending(BIO *bio)
411 return BIO_ctrl(bio, BIO_CTRL_PENDING, 0, NULL);
414 EXPORT_C size_t BIO_ctrl_wpending(BIO *bio)
416 return BIO_ctrl(bio, BIO_CTRL_WPENDING, 0, NULL);
420 /* put the 'bio' on the end of b's list of operators */
421 EXPORT_C BIO *BIO_push(BIO *b, BIO *bio)
425 if (b == NULL) return(bio);
427 while (lb->next_bio != NULL)
432 /* called to do internal processing */
433 BIO_ctrl(b,BIO_CTRL_PUSH,0,NULL);
437 /* Remove the first and return the rest */
438 EXPORT_C BIO *BIO_pop(BIO *b)
442 if (b == NULL) return(NULL);
445 BIO_ctrl(b,BIO_CTRL_POP,0,NULL);
447 if (b->prev_bio != NULL)
448 b->prev_bio->next_bio=b->next_bio;
449 if (b->next_bio != NULL)
450 b->next_bio->prev_bio=b->prev_bio;
457 EXPORT_C BIO *BIO_get_retry_BIO(BIO *bio, int *reason)
464 if (!BIO_should_retry(b)) break;
467 if (b == NULL) break;
469 if (reason != NULL) *reason=last->retry_reason;
473 EXPORT_C int BIO_get_retry_reason(BIO *bio)
475 return(bio->retry_reason);
478 EXPORT_C BIO *BIO_find_type(BIO *bio, int type)
482 if(!bio) return NULL;
485 if (bio->method != NULL)
487 mt=bio->method->type;
491 if (mt & type) return(bio);
497 } while (bio != NULL);
501 EXPORT_C BIO *BIO_next(BIO *b)
507 EXPORT_C void BIO_free_all(BIO *bio)
518 /* Since ref count > 1, don't free anyone else. */
523 EXPORT_C BIO *BIO_dup_chain(BIO *in)
525 BIO *ret=NULL,*eoc=NULL,*bio,*new;
527 for (bio=in; bio != NULL; bio=bio->next_bio)
529 if ((new=BIO_new(bio->method)) == NULL) goto err;
530 new->callback=bio->callback;
531 new->cb_arg=bio->cb_arg;
533 new->shutdown=bio->shutdown;
534 new->flags=bio->flags;
536 /* This will let SSL_s_sock() work with stdin/stdout */
539 if (!BIO_dup_state(bio,(char *)new))
546 if (!CRYPTO_dup_ex_data(CRYPTO_EX_INDEX_BIO, &new->ex_data,
568 EXPORT_C void BIO_copy_next_retry(BIO *b)
570 BIO_set_flags(b,BIO_get_retry_flags(b->next_bio));
571 b->retry_reason=b->next_bio->retry_reason;
574 EXPORT_C int BIO_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
575 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func)
577 return CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_BIO, argl, argp,
578 new_func, dup_func, free_func);
581 EXPORT_C int BIO_set_ex_data(BIO *bio, int idx, void *data)
583 return(CRYPTO_set_ex_data(&(bio->ex_data),idx,data));
586 EXPORT_C void *BIO_get_ex_data(BIO *bio, int idx)
588 return(CRYPTO_get_ex_data(&(bio->ex_data),idx));
591 EXPORT_C unsigned long BIO_number_read(BIO *bio)
593 if(bio) return bio->num_read;
597 EXPORT_C unsigned long BIO_number_written(BIO *bio)
599 if(bio) return bio->num_write;
603 IMPLEMENT_STACK_OF(BIO)