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, respec-
          tively.

          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 argu-
                            ments 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 pro-
                            vided, 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 condi-
                            tions 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 pro-
                            vided.
          /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 ALSO
          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.