1Net.startTLS(3kaya)          Kaya module reference         Net.startTLS(3kaya)
2
3
4

NAME

6       Net::startTLS - Convert an existing connection to use TLS.
7

SYNOPSIS

9       Void startTLS( NetHandle h, [String] certfiles=[] )
10

ARGUMENTS

12       h The connection handle
13
14       certs  An  optional list of certificate files for TLS encrypted connec‐
15       tions. Each file should contain one or  more  PEM-encoded  certificates
16       for  a  trusted  certification  authority.  If  this list is empty (the
17       default), no certificate verification will be  performed  on  encrypted
18       connections, which is insecure.
19

DESCRIPTION

21       Begins  TLS  encryption  on an existing connection equivilant to having
22       set usetls to true when creating it. Useful  for  secure  SMTP  connec‐
23       tions. This function will fail silently if TLS encryption is already in
24       use on the connection.
25
26       Note that this function is only designed for client connections started
27       with Net.connect (3kaya) rather than server connections from Net.accept
28       (3kaya)
29
30

AUTHORS

32       Kaya  standard  library  by  Edwin  Brady,  Chris  Morris  and   others
33       (kaya@kayalang.org). For further information see http://kayalang.org/
34

LICENSE

36       The  Kaya  standard  library  is free software; you can redistribute it
37       and/or modify it under the terms  of  the  GNU  Lesser  General  Public
38       License  (version  2.1  or  any later version) as published by the Free
39       Software Foundation.
40

42       Net.NetHandle (3kaya)
43       Net.connect (3kaya)
44
45
46
47Kaya                             December 2010             Net.startTLS(3kaya)
Impressum