IRCRC(1)IRCRC(1)
NAME
ircrc – internet relay chat client
SYNOPSIS
ircrc
[
-p
port
]
[
-r
realname
]
[
-t
target
]
[
-n
nick
]
[
-u
user
]
[
-U
]
[
server
]
DESCRIPTION
Ircrc
is an IRC client.
Messages are sent from standard input and
received from standard output.
The default server is
irc.oftc.net,
and TLS is used by default through
tlsclient
(see
tlssrv(8)).
The arguments
bitlbee
and
oftc
are expanded to
im.bitlbee.org
and
irc.oftc.net,
respectively.
The NickServ and server passwords are read if
available via the authentication agent
factotum(4)
and are searched for using the following keyspecs,
respectively:
proto=pass server=$server service=irc user=$nick
proto=pass server=$server service=ircsrv user=$nick
The options are:
-p port
Change the default port
(6697).
-r realname
Change the default name
(<nil>).
-t target
Set and join the target channel.
If multiple channels are specified,
only the last one will be set as
target.
Messages are sent to
target
unless they are commands.
-n nick
Change the default nickname
($user).
-u user
Change the default username
($user).
-U
Disable TLS.
Commands
Ircrc
commands begin with a slash.
Unrecognized commands result in an error message
and send nothing to the server.
The commands are:
/! cmd
Send the output of the shell command
cmd
to the current target.
/M target \(+-flag…
MODE:
set
(+)
or remove
(-)
a mode
flag
for
target.
Multiple flags may be joined together and followed by an optional arguments list.
/N target msg
NOTICE:
send the notice
msg
to
target.
/T chan [ :topic ]
TOPIC:
set the channel
chan’s
topic,
or clear it if empty.
With only the
chan
argument,
print the current topic.
/W [ server ] user
WHOIS:
query
server
for information about
user.
If
server
is unspecified, query the current server.
/a [ text ]
AWAY:
set away status to
text
if provided, or clear it otherwise.
/j chans [ keys ]
JOIN:
join a comma-separated channel list
chans,
optionally providing a corresponding key list
keys
in the same order and format.
Providing channel name
0
parts all joined channels.
/l [ chans ]
LIST:
list information about visible channels in the comma-separated list
chans
or all visible channels if empty.
The argument may instead be a list of conditions to filter results by.
/m target text
PRIVMSG:
send the message
text
to
target.
/n name
NICK:
change nickname to
name.
/p chans [ msg ]
PART:
part comma-separated channel list
chans,
with parting message
msg
if provided.
/q cmd
Send the raw IRC command
cmd
to the server.
/t [ targets ]
Push all subsequent messages to a comma-separated list of
targets,
or clear if empty.
/u [ server ]
USERS:
query user statistics for
server,
or current one if empty.
/w mask
WHO:
query for visible users matching
mask,
or if
mask
is a channel, list it’s members.
/x [ message ]
QUIT:
terminate the session with a quit
message
if provided.
Control-D also sends this command.
Unless noted otherwise, command targets may be either users or channels.
EXAMPLES
Default usage:
% ircrc
Join
irc.oftc.net
as a different user:
% ircrc -r glenda -n glenda irc.oftc.net
Join two channels on login:
% ircrc -t '#cat-v,#plan9'
SOURCE
/rc/bin/ircrc
SEE
factotum(4),
tlssrv(8)
http://tools.ietf.org/html/rfc1459
http://tools.ietf.org/html/rfc2812
https://modern.ircdocs.horse
HELP command and specific server documentation.
BUGS
Some fonts do not support the nickname delimiters.
If the connection is lost,
ircrc
waits for input before exiting.