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