summaryrefslogtreecommitdiffstats
path: root/docs/help/server
blob: 4a9e5ae62c48d2b0ed661b82688f5ef1cdd50f3b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
%9Syntax:%9

SERVER CONNECT %|[-4 | -6] [-tls | -notls] [-tls_cert <cert>] [-tls_pkey <pkey>] [-tls_pass <password>] [-tls_verify | -notls_verify] [-tls_cafile <cafile>] [-tls_capath <capath>] [-tls_ciphers <list>] [-tls_pinned_cert <fingerprint>] [-tls_pinned_pubkey <fingerprint>] [-!] [-noautosendcmd] [-nocap] [-noproxy] [-network <network>] [-host <hostname>] [-rawlog <file>] [+]<address>|<chatnet> [<port> [<password> [<nick>]]]
SERVER REMOVE %|<address> [<port>] [<network>]
SERVER ADD%||MODIFY [-4 | -6] [-cap | -nocap] [-tls_cert <cert>] [-tls_pkey <pkey>] [-tls_pass <password>] [-tls_verify] [-tls_cafile <cafile>] [-tls_capath <capath>] [-tls_ciphers <list>] [-tls | -notls] [-starttls | -nostarttls | -disallow_starttls | -nodisallow_starttls] [-auto | -noauto] [-network <network>] [-host <hostname>] [-cmdspeed <ms>] [-cmdmax <count>] [-port <port>] <address> [<port> [<password>]]
SERVER LIST%|
SERVER PURGE %|[<target>]

%9Parameters:%9

    LIST:               Displays the list of servers you have configured.
    CONNECT:            Connects to the given server.
    ADD:                Adds a server to your configuration.
    MODIFY:             Modifies a server in your configuration.
    REMOVE:             Removes a server from your configuration.
    PURGE:              Purges the commands queued to be sent to the server.

    -!:                 Doesn't autojoin the channels.
    -4:                 Connects using IPv4.
    -6:                 Connects using IPv6.
    -tls:               Connects using TLS encryption.
    -notls:             Connect without TLS encrption.
    -tls_cert:          The TLS client certificate file.
    -tls_pkey:          The TLS client private key, if not included in the
                        certificate file.
    -tls_pass:          The password for the TLS client private key or certificate.
    -tls_verify:        Verifies the TLS certificate of the server.	
    -notls_verify:      Doesn't verify the TLS certificate of the server.
    -tls_cafile:        The file with the list of CA certificates.
    -tls_capath:        The directory which contains the CA certificates.
    -tls_ciphers:       TLS cipher suite preference lists.
    -tls_pinned_cert:   Pinned x509 certificate fingerprint.
    -tls_pinned_pubkey: Pinned public key fingerprint.
    -auto:              Automatically connects to the server on startup.
    -noauto:            Doesn't connect to the server on startup.
    -cap:               Enable CAPREQ for server.
    -nocap:             Disable CAPREQ for server.
    -network:           The network the server belongs to.
    -host:              The hostname you would like to connect from.
    -cmdspeed:          Specifies the minimum amount of time, expressed in
                        milliseconds, that the client must wait before sending
                        additional commands to the server.
    -cmdmax:            Specifies the maximum number of commands to perform
                        before starting the internal flood protection.
    -port:              Specifies the port to connect to the server.
    -noproxy:           Ignores the global proxy configuration.
    -rawlog:            Immediately open rawlog after connecting.
    -noautosendcmd:     Doesn't execute autosendcmd.

    The server, port and network to add, modify or remove; if no argument is
    given, the list of servers you are connected to will be returned.

%9Description:%9

    Displays, adds, modifies or removes the network configuration of IRC
    servers.

    When using the ADD parameter on a server that already exists, the
    configuration will be merged with each other.

    When using the CONNECT parameter, it will connect to the specified
    server; the server in the active window will be disconnected
    unless you prepend the server with the '+' character.

    Specify '-' as password to remove a server password

%9Examples:%9

    /SERVER
    /SERVER CONNECT irc.libera.chat
    /SERVER CONNECT +irc.libera.chat
    /SERVER ADD -network liberachat -noautosendcmd irc.libera.chat
    /SERVER ADD -! -auto -host staff.irssi.org -4 -network liberachat -noproxy irc.libera.chat 6667
    /SERVER MODIFY -network liberachat -noauto irc.libera.chat
    /SERVER MODIFY -network liberachat irc.libera.chat 6697 -
    /SERVER REMOVE irc.libera.chat 6667 liberachat
    /SERVER PURGE
    /SERVER PURGE irc.libera.chat

%9See also:%9 CHANNEL, CONNECT, DISCONNECT, NETWORK, RECONNECT, RMRECONNS