/* * ejabberd external authentication program * * (c) Alexander Vdolainen 2013, 2018, 2019, 2021 * * this is free software: you can redistribute it and/or modify it * under the terms of the GNU General Public License as published * by the Free Software Foundation, either version 2 of the License, or * (at your option) any later version. * * this 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 GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see ."; * */ #ifndef __TLSPORT_H__ #define __TLSPORT_H__ struct tlsport { int fd; SSL *ssl; SSL_CTX *sslctx; }; typedef enum { TLSIO_READ = 1, TLSIO_WRITE = 2, } tls_io_dir_t; /* this function shall be called before main loop */ int ssllib_init(void); /* this one after mainloop and/or on exit */ int ssllib_free(void); /* creates a TLS connection (all info is in struct tlsport). * returns -1 on error, 0 otherwise. * first string is a hostname, second is a port or service name */ int tls_connect(const char *, const char *, struct tlsport *); /* gracefully shutdown TLS connection and free resources * it's always freeing and closing, but in case of wrong * shutdown procedure returns -1, 0 otherwise. */ int tls_close(struct tlsport *); /* read or write (depends on tls_io_dir_t) data via tlsport * returns amount of bytes ridden or written, -1 in case of error */ ssize_t tls_io(struct tlsport *, void *, size_t, tls_io_dir_t); #endif /* __TLSPORT_H__ */