pt_tls_server.h 1.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. /*
  2. * Copyright (C) 2012 Martin Willi
  3. * Copyright (C) 2012 revosec AG
  4. *
  5. * This program is free software; you can redistribute it and/or modify it
  6. * under the terms of the GNU General Public License as published by the
  7. * Free Software Foundation; either version 2 of the License, or (at your
  8. * option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
  9. *
  10. * This program is distributed in the hope that it will be useful, but
  11. * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  12. * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
  13. * for more details.
  14. */
  15. /**
  16. * @defgroup pt_tls_server pt_tls_server
  17. * @{ @ingroup pt_tls
  18. */
  19. #ifndef PT_TLS_SERVER_H_
  20. #define PT_TLS_SERVER_H_
  21. #include <utils/identification.h>
  22. #include <tnc/tnccs/tnccs.h>
  23. #include "pt_tls.h"
  24. typedef struct pt_tls_server_t pt_tls_server_t;
  25. /**
  26. * IF-T for TLS aka PT-TLS transport server.
  27. */
  28. struct pt_tls_server_t {
  29. /**
  30. * Handle assessment data read from socket.
  31. *
  32. * @return
  33. * - NEED_MORE if more exchanges required,
  34. * - SUCCESS if assessment complete
  35. * - FAILED if assessment failed
  36. */
  37. status_t (*handle)(pt_tls_server_t *this);
  38. /**
  39. * Get the underlying client connection socket.
  40. *
  41. * @return socket fd, suitable to select()
  42. */
  43. int (*get_fd)(pt_tls_server_t *this);
  44. /**
  45. * Destroy a pt_tls_server_t.
  46. */
  47. void (*destroy)(pt_tls_server_t *this);
  48. };
  49. /**
  50. * Create a pt_tls_server connection instance.
  51. *
  52. * @param server TLS server identity
  53. * @param fd client connection socket
  54. * @param auth client authentication requirements
  55. * @param tnccs inner TNCCS protocol handler to use for this connection
  56. * @return PT-TLS server
  57. */
  58. pt_tls_server_t *pt_tls_server_create(identification_t *server, int fd,
  59. pt_tls_auth_t auth, tnccs_t *tnccs);
  60. #endif /** PT_TLS_SERVER_H_ @}*/