1II(1)                       General Commands Manual                      II(1)
2
3
4

NAME

6       ii - irc it or irc improved
7

DESCRIPTION

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

SYNOPSIS

21       ii <-s servername> [-p port] [-k environment variable] [-i prefix]  [-n
22       nickname] [-f realname] <-u sockname>
23

OPTIONS

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

DIRECTORIES

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

COMMANDS

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

RAW COMMANDS

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

SSL PROTOCOL SUPPORT

81       For TLS/SSL protocol support you can connect to  a  local  tunnel,  for
82       example with stunnel or socat.
83

CONTACT

85       Subscribe  to  the mailinglist and write to dev (at) suckless (dot) org
86       for suggestions, fixes, etc.
87

AUTHORS

89       ii engineers, see LICENSE file
90

SEE ALSO

92       echo(1), tail(1)
93

BUGS

95       Please report them!
96
97
98
99                                    ii-1.8                               II(1)
Impressum