Remove NOPROTO definitions and error code comments.
[openssl.git] / crypto / bio / bio.h
index 300b330e00db9ace3cd17ace75b77608b89dfd85..0915c8885d57c09d6d4ce56d1e8740ab6eba8429 100644 (file)
@@ -63,7 +63,8 @@
 extern "C" {
 #endif
 
-#include "crypto.h"
+#include <stdio.h>
+#include <openssl/crypto.h>
 
 /* These are the 'types' of BIOs */
 #define BIO_TYPE_NONE          0
@@ -84,6 +85,7 @@ extern "C" {
 #define BIO_TYPE_PROXY_SERVER  (15|0x0200)             /* server proxy BIO */
 #define BIO_TYPE_NBIO_TEST     (16|0x0200)             /* server proxy BIO */
 #define BIO_TYPE_NULL_FILTER   (17|0x0200)
+#define BIO_TYPE_BER           (18|0x0200)             /* BER -> bin filter */
 
 #define BIO_TYPE_DESCRIPTOR    0x0100  /* socket, fd, connect or accept */
 #define BIO_TYPE_FILTER                0x0200
@@ -202,7 +204,7 @@ extern "C" {
 typedef struct bio_method_st
        {
        int type;
-       char *name;
+       const char *name;
        int (*bwrite)();
        int (*bread)();
        int (*bputs)();
@@ -215,7 +217,7 @@ typedef struct bio_method_st
 typedef struct bio_method_st
        {
        int type;
-       char *name;
+       const char *name;
        int (_far *bwrite)();
        int (_far *bread)();
        int (_far *bputs)();
@@ -229,12 +231,8 @@ typedef struct bio_method_st
 typedef struct bio_st
        {
        BIO_METHOD *method;
-#ifndef NOPROTO
        /* bio, mode, argp, argi, argl, ret */
-       long (*callback)(struct bio_st *,int,char *,int, long,long);
-#else
-       long (*callback)();
-#endif
+       long (*callback)(struct bio_st *,int,const char *,int, long,long);
        char *cb_arg; /* first argument for the callback */
 
        int init;
@@ -276,7 +274,7 @@ typedef struct bio_f_buffer_ctx_struct
 #define BIO_CONN_S_OK                  6
 #define BIO_CONN_S_BLOCKED_CONNECT     7
 #define BIO_CONN_S_NBIO                        8
-#define BIO_CONN_get_param_hostname    BIO_ctrl
+/*#define BIO_CONN_get_param_hostname  BIO_ctrl */
 
 #define BIO_number_read(b)     ((b)->num_read)
 #define BIO_number_written(b)  ((b)->num_write)
@@ -309,18 +307,19 @@ typedef struct bio_f_buffer_ctx_struct
 #define BIO_C_SET_SSL_RENEGOTIATE_BYTES                125
 #define BIO_C_GET_SSL_NUM_RENEGOTIATES         126
 #define BIO_C_SET_SSL_RENEGOTIATE_TIMEOUT      127
+#define BIO_C_FILE_SEEK                                128
+#define BIO_C_GET_CIPHER_CTX                   129
+#define BIO_C_SET_BUF_MEM_EOF_RETURN           130/*return end of input value*/
+#define BIO_C_SET_BIND_MODE                    131
+#define BIO_C_GET_BIND_MODE                    132
+#define BIO_C_FILE_TELL                                133
+#define BIO_C_GET_SOCKS                                134
+#define BIO_C_SET_SOCKS                                135
 
 #define BIO_set_app_data(s,arg)                BIO_set_ex_data(s,0,(char *)arg)
 #define BIO_get_app_data(s)            BIO_get_ex_data(s,0)
 
-int BIO_get_ex_num(BIO *bio);
-int BIO_set_ex_data(BIO *bio,int idx,char *data);
-char *BIO_get_ex_data(BIO *bio,int idx);
-void BIO_set_ex_free_func(BIO *bio,int idx,void (*cb)());
-int BIO_get_ex_new_index(long argl, char *argp, int (*new_func)(),
-       int (*dup_func)(), void (*free_func)());
-
-/* BIO_s_connect_socket() */
+/* BIO_s_connect() and BIO_s_socks4a_connect() */
 #define BIO_set_conn_hostname(b,name) BIO_ctrl(b,BIO_C_SET_CONNECT,0,(char *)name)
 #define BIO_set_conn_port(b,port) BIO_ctrl(b,BIO_C_SET_CONNECT,1,(char *)port)
 #define BIO_set_conn_ip(b,ip)    BIO_ctrl(b,BIO_C_SET_CONNECT,2,(char *)ip)
@@ -328,7 +327,8 @@ int BIO_get_ex_new_index(long argl, char *argp, int (*new_func)(),
 #define BIO_get_conn_hostname(b)  BIO_ptr_ctrl(b,BIO_C_GET_CONNECT,0)
 #define BIO_get_conn_port(b)      BIO_ptr_ctrl(b,BIO_C_GET_CONNECT,1)
 #define BIO_get_conn_ip(b,ip) BIO_ptr_ctrl(b,BIO_C_SET_CONNECT,2)
-#define BIO_get_conn_int port(b,port) BIO_int_ctrl(b,BIO_C_SET_CONNECT,3,port)
+#define BIO_get_conn_int_port(b,port) BIO_int_ctrl(b,BIO_C_SET_CONNECT,3,port)
+
 
 #define BIO_set_nbio(b,n)      BIO_ctrl(b,BIO_C_SET_NBIO,(n),NULL)
 
@@ -339,6 +339,12 @@ int BIO_get_ex_new_index(long argl, char *argp, int (*new_func)(),
 #define BIO_set_nbio_accept(b,n) BIO_ctrl(b,BIO_C_SET_ACCEPT,1,(n)?"a":NULL)
 #define BIO_set_accept_bios(b,bio) BIO_ctrl(b,BIO_C_SET_ACCEPT,2,(char *)bio)
 
+#define BIO_BIND_NORMAL                        0
+#define BIO_BIND_REUSEADDR_IF_UNUSED   1
+#define BIO_BIND_REUSEADDR             2
+#define BIO_set_bind_mode(b,mode) BIO_ctrl(b,BIO_C_SET_BIND_MODE,mode,NULL)
+#define BIO_get_bind_mode(b,mode) BIO_ctrl(b,BIO_C_GET_BIND_MODE,0,NULL)
+
 #define BIO_do_connect(b)      BIO_do_handshake(b)
 #define BIO_do_accept(b)       BIO_do_handshake(b)
 #define BIO_do_handshake(b)    BIO_ctrl(b,BIO_C_DO_STATE_MACHINE,0,NULL)
@@ -364,12 +370,26 @@ int BIO_get_ex_new_index(long argl, char *argp, int (*new_func)(),
 #define BIO_set_fp(b,fp,c)     BIO_ctrl(b,BIO_C_SET_FILE_PTR,c,(char *)fp)
 #define BIO_get_fp(b,fpp)      BIO_ctrl(b,BIO_C_GET_FILE_PTR,0,(char *)fpp)
 
+#define BIO_seek(b,ofs)        (int)BIO_ctrl(b,BIO_C_FILE_SEEK,ofs,NULL)
+#define BIO_tell(b)    (int)BIO_ctrl(b,BIO_C_FILE_TELL,0,NULL)
+
+/* name is cast to lose const, but might be better to route through a function
+   so we can do it safely */
+#ifdef CONST_STRICT
+/* If you are wondering why this isn't defined, its because CONST_STRICT is
+ * purely a compile-time kludge to allow const to be checked.
+ */
+int BIO_read_filename(BIO *b,const char *name);
+#else
 #define BIO_read_filename(b,name) BIO_ctrl(b,BIO_C_SET_FILENAME, \
-               BIO_CLOSE|BIO_FP_READ,name)
+               BIO_CLOSE|BIO_FP_READ,(char *)name)
+#endif
 #define BIO_write_filename(b,name) BIO_ctrl(b,BIO_C_SET_FILENAME, \
                BIO_CLOSE|BIO_FP_WRITE,name)
 #define BIO_append_filename(b,name) BIO_ctrl(b,BIO_C_SET_FILENAME, \
                BIO_CLOSE|BIO_FP_APPEND,name)
+#define BIO_rw_filename(b,name) BIO_ctrl(b,BIO_C_SET_FILENAME, \
+               BIO_CLOSE|BIO_FP_READ|BIO_FP_WRITE,name)
 
 /* WARNING WARNING, this ups the reference count on the read bio of the
  * SSL structure.  This is because the ssl read BIO is now pointed to by
@@ -388,8 +408,11 @@ int BIO_get_ex_new_index(long argl, char *argp, int (*new_func)(),
 /* defined in evp.h */
 /* #define BIO_set_md(b,md)    BIO_ctrl(b,BIO_C_SET_MD,1,(char *)md) */
 
+#define BIO_get_mem_data(b,pp) BIO_ctrl(b,BIO_CTRL_INFO,0,(char *)pp)
 #define BIO_set_mem_buf(b,bm,c)        BIO_ctrl(b,BIO_C_SET_BUF_MEM,c,(char *)bm)
 #define BIO_get_mem_ptr(b,pp)  BIO_ctrl(b,BIO_C_GET_BUF_MEM_PTR,0,(char *)pp)
+#define BIO_set_mem_eof_return(b,v) \
+                               BIO_ctrl(b,BIO_C_SET_BUF_MEM_EOF_RETURN,v,NULL)
 
 /* For the BIO_f_buffer() type */
 #define BIO_get_buffer_num_lines(b)    BIO_ctrl(b,BIO_C_GET_BUFF_NUM_LINES,0,NULL)
@@ -418,7 +441,15 @@ int BIO_get_ex_new_index(long argl, char *argp, int (*new_func)(),
 #define NO_FP_API
 #endif
 
-#ifndef NOPROTO
+
+/* These two aren't currently implemented */
+/* int BIO_get_ex_num(BIO *bio); */
+/* void BIO_set_ex_free_func(BIO *bio,int idx,void (*cb)()); */
+int BIO_set_ex_data(BIO *bio,int idx,char *data);
+char *BIO_get_ex_data(BIO *bio,int idx);
+int BIO_get_ex_new_index(long argl, char *argp, int (*new_func)(),
+       int (*dup_func)(), void (*free_func)());
+
 #  if defined(WIN16) && defined(_WINDLL)
 BIO_METHOD *BIO_s_file_internal(void);
 BIO *BIO_new_file_internal(char *filename, char *mode);
@@ -434,32 +465,13 @@ BIO *BIO_new_fp(FILE *stream, int close_flag);
 #    define BIO_new_file_internal      BIO_new_file
 #    define BIO_new_fp_internal                BIO_s_file
 #  endif /* FP_API */
-#else
-#  if defined(WIN16) && defined(_WINDLL)
-BIO_METHOD *BIO_s_file_internal();
-BIO *BIO_new_file_internal();
-BIO *BIO_new_fp_internal();
-#    define BIO_s_file BIO_s_file_internal
-#    define BIO_new_file       BIO_new_file_internal
-#    define BIO_new_fp BIO_new_fp_internal
-#  else /* FP_API */
-BIO_METHOD *BIO_s_file();
-BIO *BIO_new_file();
-BIO *BIO_new_fp();
-#    define BIO_s_file_internal                BIO_s_file
-#    define BIO_new_file_internal      BIO_new_file
-#    define BIO_new_fp_internal                BIO_s_file
-#  endif /* FP_API */
-#endif
-
-#ifndef NOPROTO
 BIO *  BIO_new(BIO_METHOD *type);
 int    BIO_set(BIO *a,BIO_METHOD *type);
 int    BIO_free(BIO *a);
-int    BIO_read(BIO *b, char *data, int len);
+int    BIO_read(BIO *b, void *data, int len);
 int    BIO_gets(BIO *bp,char *buf, int size);
-int    BIO_write(BIO *b, char *data, int len);
-int    BIO_puts(BIO *bp,char *buf);
+int    BIO_write(BIO *b, const char *data, int len);
+int    BIO_puts(BIO *bp,const char *buf);
 long   BIO_ctrl(BIO *bp,int cmd,long larg,char *parg);
 char * BIO_ptr_ctrl(BIO *bp,int cmd,long larg);
 long   BIO_int_ctrl(BIO *bp,int cmd,long larg,int iarg);
@@ -472,10 +484,10 @@ int       BIO_get_retry_reason(BIO *bio);
 BIO *  BIO_dup_chain(BIO *in);
 
 #ifndef WIN16
-long BIO_debug_callback(BIO *bio,int cmd,char *argp,int argi,
+long BIO_debug_callback(BIO *bio,int cmd,const char *argp,int argi,
        long argl,long ret);
 #else
-long _far _loadds BIO_debug_callback(BIO *bio,int cmd,char *argp,int argi,
+long _far _loadds BIO_debug_callback(BIO *bio,int cmd,const char *argp,int argi,
        long argl,long ret);
 #endif
 
@@ -484,23 +496,26 @@ BIO_METHOD *BIO_s_socket(void);
 BIO_METHOD *BIO_s_connect(void);
 BIO_METHOD *BIO_s_accept(void);
 BIO_METHOD *BIO_s_fd(void);
+BIO_METHOD *BIO_s_log(void);
 BIO_METHOD *BIO_s_null(void);
 BIO_METHOD *BIO_f_null(void);
-BIO_METHOD *BIO_f_nbio_test(void);
 BIO_METHOD *BIO_f_buffer(void);
+BIO_METHOD *BIO_f_nbio_test(void);
+/* BIO_METHOD *BIO_f_ber(void); */
 
 int BIO_sock_should_retry(int i);
 int BIO_sock_non_fatal_error(int error);
 int BIO_fd_should_retry(int i);
 int BIO_fd_non_fatal_error(int error);
-int BIO_dump(BIO *b,char *bytes,int len);
+int BIO_dump(BIO *b,const char *bytes,int len);
 
-struct hostent *BIO_gethostbyname(char *name);
+struct hostent *BIO_gethostbyname(const char *name);
 int BIO_sock_error(int sock);
 int BIO_socket_ioctl(int fd, long type, unsigned long *arg);
-int BIO_get_port(char *str, short *port_ptr);
-int BIO_get_host_ip(char *str, unsigned char *ip);
-int BIO_get_accept_socket(char *host_port);
+int BIO_socket_nbio(int fd,int mode);
+int BIO_get_port(const char *str, unsigned short *port_ptr);
+int BIO_get_host_ip(const char *str, unsigned char *ip);
+int BIO_get_accept_socket(char *host_port,int mode);
 int BIO_accept(int sock,char **ip_port);
 int BIO_sock_init(void );
 void BIO_sock_cleanup(void);
@@ -517,75 +532,8 @@ void BIO_copy_next_retry(BIO *b);
 
 long BIO_ghbn_ctrl(int cmd,int iarg,char *parg);
 
-#else
-
-BIO *  BIO_new();
-int    BIO_set();
-int    BIO_free();
-int    BIO_read();
-int    BIO_gets();
-int    BIO_write();
-int    BIO_puts();
-char * BIO_ptr_ctrl();
-long   BIO_ctrl();
-long   BIO_int_ctrl();
-BIO *  BIO_push();
-BIO *  BIO_pop();
-void   BIO_free_all();
-BIO *  BIO_find_type();
-BIO *  BIO_get_retry_BIO();
-int    BIO_get_retry_reason();
-BIO *  BIO_dup_chain();
-
-#ifndef WIN16
-long BIO_debug_callback();
-#else
-long _far _loadds BIO_debug_callback();
-#endif
-
-BIO_METHOD *BIO_s_mem();
-BIO_METHOD *BIO_s_socket();
-BIO_METHOD *BIO_s_connect();
-BIO_METHOD *BIO_s_accept();
-BIO_METHOD *BIO_s_fd();
-BIO_METHOD *BIO_s_null();
-BIO_METHOD *BIO_f_null();
-BIO_METHOD *BIO_f_buffer();
-BIO_METHOD *BIO_f_nbio_test();
-
-int BIO_sock_should_retry();
-int BIO_sock_non_fatal_error();
-int BIO_fd_should_retry();
-int BIO_fd_non_fatal_error();
-int BIO_dump();
-
-struct hostent *BIO_gethostbyname();
-int BIO_sock_error();
-int BIO_socket_ioctl();
-int BIO_get_port();
-int BIO_get_host_ip();
-int BIO_get_accept_socket();
-int BIO_accept();
-int BIO_sock_init();
-void BIO_sock_cleanup();
-int BIO_set_tcp_ndelay();
-
-void ERR_load_BIO_strings();
-
-BIO *BIO_new_socket();
-BIO *BIO_new_fd();
-BIO *BIO_new_connect();
-BIO *BIO_new_accept();
-
-void BIO_copy_next_retry();
-
-int BIO_ghbn_ctrl();
-
-#endif
-
 /* Tim Hudson's portable varargs stuff */
 
-#ifndef NOPROTO
 #define VAR_ANSI       /* select ANSI version by default */
 #endif
 
@@ -605,57 +553,35 @@ int BIO_ghbn_ctrl();
 #define VAR_ARG(args,type,arg) arg=va_arg(args,type)
 #define VAR_END(args)          va_end(args);
 
-#else
-
-/* K&R version of a "portable" macro set for variable length args */
-#ifndef __VARARGS_H__
-#include <varargs.h>
-#endif
-
-#define VAR_PLIST(arg1type,arg1)       va_alist
-#define VAR_PLIST2(arg1type,arg1,arg2type,arg2) va_alist
-#define VAR_ALIST              va_dcl
-#define VAR_BDEFN(args,arg1type,arg1)  va_list args; arg1type arg1
-#define VAR_BDEFN2(args,arg1type,arg1,arg2type,arg2)    va_list args; \
-       arg1type arg1; arg2type arg2
-#define VAR_INIT(args,arg1type,arg1)   va_start(args); \
-       arg1=va_arg(args,arg1type);
-#define VAR_INIT2(args,arg1type,arg1,arg2type,arg2) va_start(args); \
-       arg1=va_arg(args,arg1type);     arg2=va_arg(args,arg2type);
-#define VAR_ARG(args,type,arg)         arg=va_arg(args,type)
-#define VAR_END(args)                  va_end(args);
-
-#endif
-
-#ifndef NOPROTO
 int BIO_printf( VAR_PLIST( BIO *, bio ) );
-#else
-int BIO_printf();
-#endif
-
 /* BEGIN ERROR CODES */
+/* The following lines are auto generated by the script mkerr.pl. Any changes
+ * made after this point may be overwritten when the script is next run.
+ */
+
 /* Error codes for the BIO functions. */
 
 /* Function codes. */
 #define BIO_F_ACPT_STATE                                100
 #define BIO_F_BIO_ACCEPT                                101
-#define BIO_F_BIO_CTRL                                  102
-#define BIO_F_BIO_GETS                                  103
-#define BIO_F_BIO_GET_ACCEPT_SOCKET                     104
-#define BIO_F_BIO_GET_HOST_IP                           105
-#define BIO_F_BIO_GET_PORT                              106
-#define BIO_F_BIO_NEW                                   107
-#define BIO_F_BIO_NEW_FILE                              108
-#define BIO_F_BIO_PUTS                                  109
-#define BIO_F_BIO_READ                                  110
-#define BIO_F_BIO_SOCK_INIT                             111
-#define BIO_F_BIO_WRITE                                         112
-#define BIO_F_BUFFER_CTRL                               113
-#define BIO_F_CONN_STATE                                114
-#define BIO_F_FILE_CTRL                                         115
-#define BIO_F_MEM_WRITE                                         116
-#define BIO_F_SSL_NEW                                   117
-#define BIO_F_WSASTARTUP                                118
+#define BIO_F_BIO_BER_GET_HEADER                        102
+#define BIO_F_BIO_CTRL                                  103
+#define BIO_F_BIO_GETS                                  104
+#define BIO_F_BIO_GET_ACCEPT_SOCKET                     105
+#define BIO_F_BIO_GET_HOST_IP                           106
+#define BIO_F_BIO_GET_PORT                              107
+#define BIO_F_BIO_NEW                                   108
+#define BIO_F_BIO_NEW_FILE                              109
+#define BIO_F_BIO_PUTS                                  110
+#define BIO_F_BIO_READ                                  111
+#define BIO_F_BIO_SOCK_INIT                             112
+#define BIO_F_BIO_WRITE                                         113
+#define BIO_F_BUFFER_CTRL                               114
+#define BIO_F_CONN_STATE                                115
+#define BIO_F_FILE_CTRL                                         116
+#define BIO_F_MEM_WRITE                                         117
+#define BIO_F_SSL_NEW                                   118
+#define BIO_F_WSASTARTUP                                119
 
 /* Reason codes. */
 #define BIO_R_ACCEPT_ERROR                              100
@@ -670,17 +596,18 @@ int BIO_printf();
 #define BIO_R_KEEPALIVE                                         109
 #define BIO_R_NBIO_CONNECT_ERROR                        110
 #define BIO_R_NO_ACCEPT_PORT_SPECIFIED                  111
-#define BIO_R_NO_HOSTHNAME_SPECIFIED                    112
+#define BIO_R_NO_HOSTNAME_SPECIFIED                     112
 #define BIO_R_NO_PORT_DEFINED                           113
 #define BIO_R_NO_PORT_SPECIFIED                                 114
 #define BIO_R_NULL_PARAMETER                            115
-#define BIO_R_UNABLE_TO_BIND_SOCKET                     116
-#define BIO_R_UNABLE_TO_CREATE_SOCKET                   117
-#define BIO_R_UNABLE_TO_LISTEN_SOCKET                   118
-#define BIO_R_UNINITALISED                              119
-#define BIO_R_UNSUPPORTED_METHOD                        120
-#define BIO_R_WSASTARTUP                                121
+#define BIO_R_TAG_MISMATCH                              116
+#define BIO_R_UNABLE_TO_BIND_SOCKET                     117
+#define BIO_R_UNABLE_TO_CREATE_SOCKET                   118
+#define BIO_R_UNABLE_TO_LISTEN_SOCKET                   119
+#define BIO_R_UNINITIALIZED                             120
+#define BIO_R_UNSUPPORTED_METHOD                        121
+#define BIO_R_WSASTARTUP                                122
+
 #ifdef  __cplusplus
 }
 #endif