source4/lib/tls/tls.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3
   4    transport layer security handling code
   5
   6    Copyright (C) Andrew Tridgell 2005
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 2 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program; if not, write to the Free Software
  20    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 */
  22
  23 #ifndef _TLS_H_
  24 #define _TLS_H_
  25
  26 /*
  27   call tls_initialise() once per task to startup the tls subsystem
  28 */
  29 struct tls_params *tls_initialise(TALLOC_CTX *mem_ctx);
  30
  31 /*
  32   call tls_init_server() on each new server connection
  33
  34   the 'plain_chars' parameter is a list of chars that when they occur
  35   as the first character from the client on the connection tell the
  36   tls code that this is a non-tls connection. This can be used to have
  37   tls and non-tls servers on the same port. If this is NULL then only
  38   tls connections will be allowed
  39 */
  40 struct socket_context *tls_init_server(struct tls_params *parms,
  41                                     struct socket_context *sock,
  42                                     struct fd_event *fde,
  43                                     const char *plain_chars);
  44
  45 /*
  46   call tls_init_client() on each new client connection
  47 */
  48 struct socket_context *tls_init_client(struct socket_context *sock,
  49                                     struct fd_event *fde);
  50
  51 /*
  52   return True if a connection used tls
  53 */
  54 BOOL tls_enabled(struct socket_context *tls);
  55
  56
  57 /*
  58   true if tls support is compiled in
  59 */
  60 BOOL tls_support(struct tls_params *parms);
  61
  62 const struct socket_ops *socket_tls_ops(enum socket_type type);
  63
  64 #endif