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