1II(1) General Commands Manual II(1)
2
3
4
6 ii - irc it or irc improved
7
9 ii is a minimalistic FIFO and filesystem based IRC client. It creates
10 an irc directory tree with server, channel and nick name directories.
11 In every directory a FIFO file (in) and normal file (out) is placed.
12 This will be for example ~/irc/irc.freenode.net/. The in file is used
13 to communicate with the servers and the out files includes the server
14 messages. For every channel and every nick name there will be new in
15 and out files. The basic idea of this is to be able to communicate
16 with an IRC server with basic command line tools. For example if you
17 will join a channel just do echo "/j #channel" > in and ii creates a
18 new channel directory with in and out file.
19
21 ii <-s servername> [-p port] [-k environment variable] [-i prefix] [-n
22 nickname] [-f realname] <-u sockname>
23
25 -s servername
26 server to connect to, for example: irc.freenode.net
27
28 -u sockname
29 connect to a UNIX domain socket instead of directly to a server.
30
31 -p port
32 lets you override the default port (6667)
33
34 -k environment variable
35 lets you specify an environment variable that contains your IRC
36 password, e.g. IIPASS="foobar" ii -k IIPASS. This is done in
37 order to prevent other users from eavesdropping the server pass‐
38 word via the process list.
39
40 -i prefix
41 lets you override the default irc path (~/irc)
42
43 -n nickname
44 lets you override the default nick ($USER)
45
46 -f realname
47 lets you specify your real name associated with your nick
48
50 ~/irc In this directory the irc tree will be created. In this direc‐
51 tory you will find a directory for your server (default:
52 irc.freenode.net) in which the FIFO and the output file will be
53 stored. If you join a channel a new directory with the name of
54 the channel will be created in the ~/irc/$servername/ directory.
55
57 /a [<message>]
58 mark yourself as away
59
60 /j #channel/nickname [<message>]
61 join a channel or open private conversation with user
62
63 /l [reason]
64 leave a channel or query
65
66 /n nick
67 change the nick name
68
69 /q [reason]
70 quit ii
71
72 /t topic
73 set the topic of a channel
74
76 Everything which is not a command will be posted into the channel or to
77 the server. So if you need /who just write /WHO as described in
78 RFC#1459 to the server in FIFO.
79
81 For TLS/SSL protocol support you can connect to a local tunnel, for
82 example with stunnel or socat.
83
85 Subscribe to the mailinglist and write to dev (at) suckless (dot) org
86 for suggestions, fixes, etc.
87
89 ii engineers, see LICENSE file
90
92 echo(1), tail(1)
93
95 Please report them!
96
97
98
99 ii-1.8 II(1)