]> jfr.im git - irc/rqf/shadowircd.git/blob - help/opers/who
Update NEWS.
[irc/rqf/shadowircd.git] / help / opers / who
1 WHO <#channel|nick|mask> [o][%format]
2
3 The WHO command displays information about a user,
4 such as their GECOS information, their user@host,
5 whether they are an IRC operator or not, etc. A
6 sample WHO result from a command issued like
7 "WHO pokey" may look something like this:
8
9 #lamers ~pokey ppp.example.net irc.example.com pokey H :0 Jim Jones
10
11 Clients often reorder the fields; the order in the
12 IRC protocol is described here.
13
14 The first field indicates the last channel the user
15 has joined. The second is the username and the third
16 is the host. The fourth field is the server the user
17 is on. The fifth is the user's nickname. The sixth
18 field describes status information about the user.
19 The possible combinations for this field are listed
20 below:
21
22 H - The user is not away.
23 G - The user is set away.
24 * - The user is an IRC operator.
25 @ - The user is a channel op in the channel listed
26 in the first field.
27 + - The user is voiced in the channel listed.
28
29 The final field displays the number of server hops and
30 the user's GECOS information.
31
32 This command may be executed on a channel, such as
33 "WHO #lamers". The output will consist of WHO
34 listings for each user on the channel. If you are
35 not on the channel, it must not have cmode +s set
36 and users with umode +i are not shown.
37
38 If the parameter is not a nickname or a channel, users
39 with matching nickname, username, host, server or
40 GECOS information are shown. The wildcards * and ?
41 can be used. Users with umode +i set that are not
42 on the same channel as you are not shown.
43
44 A second parameter of a lowercase letter o ensures
45 only IRC operators are displayed.
46
47 The second parameter may also contain a format
48 specification starting with a percent sign.
49 This causes the output to use numeric 354,
50 with the selected fields:
51
52 t - Query type. Outputs the given number in each reply.
53 c - Channel.
54 u - Username.
55 i - IP address.
56 h - Host.
57 s - Server.
58 n - Nickname.
59 f - Status.
60 d - Hop count.
61 l - Idle time or 0 for users on other servers.
62 a - Services account name or 0 if none.
63 r - GECOS information.
64
65 "WHO #lamers %tuhnf,42" would generate a brief listing
66 of channel members and include the number 42 in each
67 line.
68
69 See also: whois, userhost, cmode, umode