]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/ircrc
exec(2): fix prototypes
[plan9front.git] / sys / man / 1 / ircrc
1 .TH IRCRC 1
2 .SH NAME
3 ircrc \- internet relay chat client
4 .SH SYNOPSIS
5 .B ircrc
6 [
7 .B -p
8 .I port
9 ]
10 [
11 .B -r
12 .I realname
13 ]
14 [
15 .B -t
16 .I target
17 ]
18 [
19 .B -n
20 .I nick
21 ]
22 [
23 .B -T
24 ] [
25 .I server
26 ]
27 .SH DESCRIPTION
28 .I Ircrc
29 is an IRC client.
30 Messages are sent from standard input and
31 received from standard output.
32 The default server is
33 .BR irc.freenode.net .
34 The arguments
35 .B bitlbee
36 and
37 .B oftc
38 are expanded to
39 .B im.bitlbee.org
40 and
41 .BR irc.oftc.net ,
42 respectively.
43 The options are:
44 .TP
45 .BI -p " port
46 Change the default port
47 .RB ( 6667 ).
48 .TP
49 .BI -r " realname
50 Change the default name
51 .RB ( <nil> ).
52 .TP
53 .BI -t " target
54 Set and join the target channel.
55 If multiple channels are specified,
56 only the last one will be set as
57 .IR target .
58 Messages are sent to
59 .I target
60 unless they are commands.
61 .TP
62 .BI -n " nick
63 Change the default nickname
64 .RB ( $user ).
65 .TP
66 .BI -T
67 .br
68 Use tls through
69 .IR tlssrv (8).
70 .SS Commands
71 .I Ircrc
72 commands begin with a slash.
73 Unrecognized commands result in an error message
74 and send nothing to the server.
75 The commands are:
76 .TP
77 .BI /! " cmd
78 Send the output of the shell command
79 .I cmd
80 to the current target.
81 .TP
82 .B /M
83 .B MODE
84 command.
85 .TP
86 .B /N
87 .B NOTICE
88 command.
89 .TP
90 .B /T
91 .B TOPIC
92 command.
93 .TP
94 .B /W
95 .B WHOIS
96 command.
97 .TP
98 .B /a
99 .B AWAY
100 command.
101 .TP
102 .B /j
103 .B JOIN
104 command.
105 .TP
106 .B /l
107 .B LIST
108 command.
109 .TP
110 .B /m
111 .B PRIVMSG
112 command.
113 .TP
114 .B /n
115 .B NICK
116 command.
117 .TP
118 .B /p
119 .B PART
120 command.
121 .TP
122 .BI /q " cmd
123 Send the raw IRC command
124 .I cmd
125 to the server.
126 .TP
127 .BI /t " target
128 Set
129 .IR target .
130 If
131 .I target
132 is more than one channel,
133 any messages are sent to all of them.
134 .TP
135 .B /u
136 .B USERS
137 command.
138 .TP
139 .B /w
140 .B WHO
141 command.
142 .TP
143 .B /x
144 .B QUIT
145 command.
146 Control-D also sends this command.
147 .PP
148 See RFC 1459 and RFC 2812 for detailed information about
149 IRC commands.
150 .SH EXAMPLES
151 Default usage:
152 .IP
153 .EX
154 % ircrc
155 .EE
156 .PP
157 Join
158 .B irc.oftc.net
159 as a different user:
160 .IP
161 .EX
162 % ircrc -r glenda -n glenda irc.oftc.net
163 .EE
164 .PP
165 Join two channels on login:
166 .IP
167 .EX
168 % ircrc -t '#cat-v,#plan9'
169 .EE
170 .SH SOURCE
171 .B /rc/bin/ircrc
172 .SH SEE ALSO
173 .B http://tools.ietf.org/html/rfc1459
174 .br
175 .B http://tools.ietf.org/html/rfc2812
176 .SH BUGS
177 .PP
178 Some fonts do not support the nickname delimiters.
179 .PP
180 If the connection is lost,
181 .I ircrc
182 waits for input before exiting.