ii(1) [debian man page]
ii(1) General Commands Manual ii(1) NAME
ii - irc it or irc improved DESCRIPTION
ii is a minimalistic FIFO and filesystem based IRC client. It creates an irc directory tree with server, channel and nick name directo- ries. In every directory a FIFO file (in) and and normal file (out) is placed. This will be for example ~/irc/irc.freenode.net/. The in file is used to communicate with the servers and the out files includes the server messages. For every channel and every nick name there will be new in and out files. The basic idea of this is to be able to communicate with an IRC server with basic command line tools. For example if you will join a channel just do echo "/j #channel" > in and ii creates a new channel directory with in and out file. SYNOPSIS
ii [-s servername] [-p port] [-k password] [-i prefix] [-n nickname] [-f realname] OPTIONS
-s servername lets you override the default servername (irc.freenode.net) -p port lets you override the default port (6667) -k password lets you use a password to authenticate your nick on the server (be aware of the problem that this is visible in the process list, if you don't want this use a query to submit your password) -i prefix lets you override the default irc path (~/irc) -n nickname lets you override the default nick ($USER) -f realname lets you specify your real name associated with your nick DIRECTORIES
~/irc In this directory the irc tree will be created. In this directory you will find a directory for your server (default: irc.freen- ode.net) in which the FIFO and the output file will be stored. If you join a channel a new directory with the name of the channel will be created in the ~/irc/$servername/ directory. COMMANDS
/a [<message>] mark yourself as away /j #channel/nickname [<message>] join a channel or open private conversation with user /l #channel/nickname leave a channel or query /n nick change the nick name /t topic set the topic of a channel Everything which is not a command will simply be posted into the channel or to the server. So if you need /who just write /WHO as described in the RFC to the server in FIFO. out file usage Write wrappers, pagers or use your tools of choice to display the out file contents (loco, multitail, etc.). CONTACT
Write to ii (at) modprobe (dot) de for suggestions, fixes, 7|-|>< ;) etc. AUTHORS
Copyright (C) 2005-2006 by Anselm R. Garbe <garbeam (at) gmail (dot) com> and Copyright (C) 2005-2008 by Nico Golde <nico (at) ngolde (dot) de> SEE ALSO
echo(1), tail(1), ii(1)
Check Out this Related Man Page
irc(n) Low Level Tcl IRC Interface irc(n) NAME
irc - Create IRC connection and interface. SYNOPSIS
package require Tcl package require irc ?0.2? ::irc::connection hostname ::irc::config key value net registerevent event script net connect net user username localhostname userinfo net nick nick net ping net join channel net part channel net privmsg target message net send text who ?address? action target ?index? msg DESCRIPTION
This package provides low-level commands to deal with the IRC protocol (Internet Relay Chat) for immediate and interactive multi-cast com- munication. ::irc::connection hostname The command creates a new object to deal with an IRC connection. Creating this IRC object does not automatically create the network connection. It returns a new irc namespace command which can be used to interact with the new IRC connection. ::irc::config key value Sets configuration key to value. Currently, the only config key defined is the boolean flag debug which, when turned on, makes irc print more information about what is going on. Per-connection Commands In the following list of available connection methods net represents a connection command as returned by ::irc::connection. net registerevent event script Registers a callback handler for the specific event. Events available are those described in the IRC RFC: 1459. In addition, there are several other events defined. defaultcommand adds a command that is called if no other callback is present. EOF is called if the connection signals an End of File condition. script is executed in the connection namespace, which can take advantage of sev- eral commands (see Callback Commands below) to aid in the parsing of data. net connect This causes the socket to be established. ::irc::connection created the namespace and the commands to be used, but did not actually open the socket. This is done here. net user username localhostname userinfo Sends USER command to server. username is the username you want to appear. localhostname is the name of your server, and userinfo is a short description of who you are. net nick nick NICK command. nick is the nickname you wish to use for the particular connection. net ping PING the IRC server. net join channel channel is the IRC channel to join. IRC channels typically begin with a hashmark ("#"). net part channel Makes the client leave channel. net privmsg target message Sends message to target, which can be either a channel, or another user, in which case their nick is used. net send text Sends text to the IRC server. Callback Commands These commands can be used within callbacks who ?address? Returns the nick of the user who performed a command. The optional address keyword causes the command to return the user in the format "username@address". action Returns the action perfomed, such as KICK, PRIVMSG, MODE, etc... Normally not useful, as callbacks are bound to a particular event. target ?index? Returns the target of a particular command, such as the channel or user to whom a PRIVMSG is sent. In the case of multiple targets, the optional index argument may be used to specify which one to return. The default is 0. msg Returns the message portion of the command (the part after the :). SEE ALSO
rfc 1459 KEYWORDS
irc, chat irc 0.2 irc(n)