From 00f7246d7c65646c0ea60325081c6586f24f9d3a Mon Sep 17 00:00:00 2001 From: Timo Sirainen Date: Tue, 24 Jul 2001 17:49:24 +0000 Subject: [PATCH] Added proxy section git-svn-id: http://svn.irssi.org/repos/irssi/trunk@1644 dbcabf3a-b0e7-0310-adc4-f8d773084564 --- docs/startup-HOWTO.html | 95 +++++++++++++++++++++++++++++++++++++++-- 1 file changed, 91 insertions(+), 4 deletions(-) diff --git a/docs/startup-HOWTO.html b/docs/startup-HOWTO.html index 5b11dfa4..0d87b17c 100644 --- a/docs/startup-HOWTO.html +++ b/docs/startup-HOWTO.html @@ -34,7 +34,8 @@
  • How can I save all texts in a window to file?
  • Logging
    • -
  • Irssi's settings
    • +
  • Proxies and IRC bouncers
    • +
  • Irssi's settings

    • 1. For all the lazy people

    @@ -136,7 +137,7 @@ want to use ALT instead of Windows key for it, use:

    And how exactly do you set these X resources? For Debian, there's /etc/X11/Xresources/xterm file where you can put them and it's read automatically when X starts. ~/.Xresources and ~/.Xdefaults files might also -work. If you can't get anything else to work, just copy&paste those lines to +work. If you can't get anything else to work, just copy&paste those lines to ~/.Xresources and directly call "xrdb -merge ~/.Xresources" in some xterm. The resources affect only the new xterms you start, not existing ones.

    @@ -500,7 +501,93 @@ logs by adding date/time formats to the file name. The formats are in

    For logging only some specific channels or nicks, see /HELP log

    -

    9. Irssi's settings

    +

    9. Proxies and IRC bouncers

    + +

    Irssi supports connecting to IRC servers via a proxy. All proxies have +these settings in common:

    + +
    +     /SET use_proxy ON
+     /SET proxy_address <Proxy host address>
+     /SET proxy_port <Proxy port>
+
    + +

    HTTP proxy

    + +

    Use these settings with HTTP proxies:

    + +
    +     /SET -clear proxy_password
+     /EVAL SET proxy_string CONNECT %s:%d\n\n
+
    + +

    Irssi proxy

    + +

    Irssi contains it's own proxy which you can build giving +--with-proxy option to configure. You'll still need to run +irssi in a screen to use it though.

    + +

    Irssi proxy is a bit different than most proxies, normally proxies create +a new connection to IRC server when you connect to it, but with irssi proxy +all the clients use the same IRC server connection (a bit like how screen -x +works).

    + +

    Irssi proxy supports sharing multiple server connections in different +ports, like you can share ircnet in port 2777 and efnet in port 2778.

    + +

    Usage in proxy side:

    + +
    +     /LOAD irc_proxy (/LOAD proxy in irssi 0.7.98.3 and older)
+     /SET irssiproxy_password <password>
+     /SET irssiproxy_ports <ircnet>=<port> ... (eg. ircnet=2777 efnet=2778)
+
    + +

    NOTE: you MUST add all the servers you +are using to server and ircnet lists with /SERVER ADD and /IRCNET ADD. +..Except if you really don't want to for some reason, and you only use +one server connection, you may simply set:

    + +
    +     /SET irssiproxy_ports *=2777 (irssi 0.7.99 and later only)
+
    + +

    Usage in client side:

    + +

    Just connect to the irssi proxy like it is a normal server with password +specified in /SET irssiproxy_password. For example:

    + +
    +     /SERVER ADD -ircnet ircnet my.irssi-proxy.org 2777 secret
+     /SERVER ADD -ircnet efnet my.irssi-proxy.org 2778 secret
+
    + +

    Irssi proxy works fine with other IRC clients as well.

    + +

    SOCKS

    + +Irssi can be compiled with socks support (--with-socks +option to configure), but I don't really know how it works, if at all. /SET +proxy settings don't have anything to do with socks however. + +

    Others

    + +

    IRC bouncers usually work like IRC servers, and want a password. You can +give it with:

    + +
    +     /SET proxy_password <password>
+
    + +

    Irssi's default for connect string is

    + +
    +     /SET proxy_string CONNECT %s %d
+
    + +

    which you can modify according to your bouncer's needs.

    + +

    10. Irssi's settings

    You probably don't like Irssi's default settings. I don't like them. But I'm still convinced that they're pretty good defaults. Here's some @@ -652,7 +739,7 @@ of them you might want to change (the default value is shown):

    Show the number of mails in your mbox in status bar. The mbox file is taken from $MAIL environment setting. Only mbox format works for now.
    - +

    Nick completion