[irc/rqf/shadowircd.git] / help / opers / who

WHO <#channel|nick|mask> [o][%format]

The WHO command displays information about a user, 
such as their GECOS information, their user@host, 
whether they are an IRC operator or not, etc.  A
sample WHO result from a command issued like 
"WHO pokey" may look something like this:

#lamers ~pokey ppp.example.net irc.example.com pokey H :0 Jim Jones

Clients often reorder the fields; the order in the
IRC protocol is described here.

The first field indicates the last channel the user
has joined.  The second is the username and the third
is the host.  The fourth field is the server the user
is on.  The fifth is the user's nickname.  The sixth
field describes status information about the user.
The possible combinations for this field are listed
below:

H       -       The user is not away.
G       -       The user is set away.
*       -       The user is an IRC operator.
@       -       The user is a channel op in the channel listed
                in the first field.
+       -       The user is voiced in the channel listed.

The final field displays the number of server hops and 
the user's GECOS information.

This command may be executed on a channel, such as
"WHO #lamers".  The output will consist of WHO 
listings for each user on the channel.  If you are
not on the channel, it must not have cmode +s set
and users with umode +i are not shown.

If the parameter is not a nickname or a channel, users
with matching nickname, username, host, server or
GECOS information are shown.  The wildcards * and ?
can be used.  Users with umode +i set that are not
on the same channel as you are not shown.

A second parameter of a lowercase letter o ensures
only IRC operators are displayed.

The second parameter may also contain a format
specification starting with a percent sign.
This causes the output to use numeric 354,
with the selected fields:

t       -       Query type. Outputs the given number in each reply.
c       -       Channel.
u       -       Username.
i       -       IP address.
h       -       Host.
s       -       Server.
n       -       Nickname.
f       -       Status.
d       -       Hop count.
l       -       Idle time or 0 for users on other servers.
a       -       Services account name or 0 if none.
r       -       GECOS information.

"WHO #lamers %tuhnf,42" would generate a brief listing
of channel members and include the number 42 in each
line.

See also: whois, userhost, cmode, umode
Commit	Line	Data
555801db	1	WHO <#channel\|nick\|mask> [o][%format]
212380e3	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
c487e4d2 JT	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.
212380e3	13
212380e3	14	The first field indicates the last channel the user
c487e4d2 JT	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:
212380e3	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
212380e3	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
c487e4d2 JT	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.
212380e3	43
c487e4d2 JT	44	A second parameter of a lowercase letter o ensures
c487e4d2 JT	45	only IRC operators are displayed.
212380e3	46
555801db JT	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
c487e4d2	69	See also: whois, userhost, cmode, umode