README.SSL
1 SSL support for EPIC
2 --------------------
3
4Connecting
5----------
6
7In order to connect to an SSL-enabled server, a given server's "server-spec"
8must be defined correctly in order for /CONNECT to establish the connection.
9
10Example:
11
12<some SSL-enabled server>:<port>:<pass>:<nick>:<group>:IRC-SSL
13
14(Please note that only the first and last fields are mandatory to establish
15an SSL connection.)
16
17Alternatively, you may use the function $serverctl(SET <refnum> SSL) to change
18the connection strategy for a server that already exists in your server list.
19
20
21Scripting support
22-----------------
23
24The function, cipher(), will return cipher type used in an already established
25SSL server connection.
26
27The function, isencrypted(), is supplied to determine whether or not a given
28server connection is SSL-enabled or not.
29
30The hook, SSL_SERVER_CERT, will return server certificate information (if any)
31after a server connection is established. WARNING: This is hook is subject
32to change in the future. Please do not rely on the output you receive from
33this hook. You have been warned.
34
35A new status indicator, %|, has been added to show a server SSL/RAW connection
36status.
37
38
39Credits
40-------
41
42Original SSL support for EPIC was written by Juraj Bednar. You may find the
43details of that project at http://epicssl.sourceforge.net for the original
44source material.
45
46Further modification was done by B. Thomas Frazier for inclusion into the
47regular distriubtion.
48