Security/tlsnke/tlsnketest/tlssocket.h

   1 /*
   2  * Copyright (c) 2012,2014 Apple Inc. All Rights Reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. Please obtain a copy of the License at
  10  * http://www.opensource.apple.com/apsl/ and read it before using this
  11  * file.
  12  *
  13  * The Original Code and all software distributed under the License are
  14  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  15  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  16  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  18  * Please see the License for the specific language governing rights and
  19  * limitations under the License.
  20  *
  21  * @APPLE_LICENSE_HEADER_END@
  22  */
  23
  24
  25 #ifndef __TLSSOCKET_H__
  26 #define __TLSSOCKET_H__
  27
  28 #include <Security/SecureTransportPriv.h>
  29
  30 /*
  31    Attach the TLS socket filter.
  32
  33    This makes a socket a TLS socket by attaching the TLS socket filter to that socket.
  34    Return a positive TLS handle or a negative error.
  35    The return TLS handle can be used to route VPN data directly through this TLS
  36    socket
  37  */
  38 int TLSSocket_Attach(int socket);
  39
  40 /*
  41  Detach the TLS socket filter.
  42
  43  Return 0 or negative error.
  44  If the TLS Socket is used with SecureTransport, one should make sure
  45  to tear down the SecureTransport session before calling this.
  46  It is not required to use this, as closing the socket would have the same effect.
  47 */
  48 int TLSSocket_Detach(int socket);
  49
  50 /*
  51     Secure Transport Record Layer functions for TLS Sockets.
  52
  53     To use SecureTransport with a TLS kernel socket, pass this to SSLSetRecordFuncs and
  54     the socket descriptor to SSLSetRecordContext
  55  */
  56 const struct SSLRecordFuncs TLSSocket_Funcs;
  57
  58
  59 #endif