neale
/
rcirc
mirror of https://github.com/nealey/rcirc
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated Home (markdown)

nealey 2010-12-06 12:11:28 -08:00
parent 526cc58f45
commit b7e78f0c82
1 changed files with 39 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
Home.md

@ -1 +1,39 @@
Welcome to the rcirc wiki! rcirc `:connect-function` fork
====================
My fork of rcirc supports a new `:connect-function` parameter in `rcirc-server-alist`. By overriding the default connect function (`open-network-stream`), you can specify any arbitrary method to connect to an IRC server.
Connecting with SSL
-------------------------------
This example defines a new `irc-open-tls-stream` function which calls out to the `socat` program to establish an SSL
connection:
(defun irc-open-tls-stream (name buffer host service)
(start-process name buffer "socat" "STDIO" (concat "OPENSSL:" host ":" service ",verify=0")))
(define rcirc-server-alist '(("irc.freenode.net" :port 6697 :connect-function irc-open-tls-stream :channels ("#rcirc"))))
Connecting through an HTTP proxy
---------------------------------------------------
The `proxychains` program does some magic tricks to get network activity to go out through an HTTP proxy. This example
uses `proxychains` in front of `socat` to make a plain (non-SSL) connection:
(define irc-open-proxied-stream (name buffer host service)
(start-process name buffer "proxychains" "socat" "STDIO" (concat "TCP:" host ":" service)))
(define rcirc-server-alist '(("irc.freenode.net" :connect-function irc-open-proxied-stream :channels ("#rcirc"))))
Connecting with SSL, presenting a client certificate, with an SSH connection to a remote server
-----------------------------------------------------------------
This crazy example (which I actually use) first establshes an SSH connection to a remote host, then runs `socat`
from that machine, presenting a client certificate to the IRC server to authenticate. It also makes sure the remote
host presents a valid SSL certificate.
(define irc-open-crazy-stream (name buffer host service)
(start-process name buffer "ssh" "remotehost" "socat" "STDIO"
(concat "OPENSSL:" host ":" service ",cert=/home/neale/ircauth.key,cafile=/home/neale/irc.pem")))
(define rcirc-server-alist '(("irc.wotzit.net" :port 994 :connect-function irc-open-crazy-stream)))