Who - Revision history

Wiebe: /* See also */ fixed url

2007-06-04T16:29:16Z

Wiebe: in limit, added 11-13, as the max is 13 flags

2007-04-08T15:25:29Z

in limit, added 11-13, as the max is 13 flags

← Older revision		Revision as of 15:25, 8 April 2007
Line 178:		Line 178:
	9 fields returned = maximum 157 replies		9 fields returned = maximum 157 replies
	10 fields returned = maximum 146 replies		10 fields returned = maximum 146 replies
			11 fields returned = maximum 136 replies
			12 fields returned = maximum 128 replies
			13 fields returned = maximum 120 replies

Wiebe: added some more text to top

2007-04-08T15:06:39Z

added some more text to top

← Older revision		Revision as of 15:06, 8 April 2007
Line 1:		Line 1:
	{{Stub}}		{{Stub}}
	This command returns a single line of information for every user requested, and it is one of the most complex and powerful commands on ircu, no other command comes close to what it can do. Normally the information includes ''(first) channel name, user, host, server, nick, flags, distance, and realname'', and more is possible, the results can be customized and easily filtered.		This command returns a single line of information for every user requested, and it is one of the most complex and powerful commands on ircu, no other command comes close to what it can do. Normally the information includes ''(first) channel name, user, host, server, nick, flags, distance, and realname'', and more is possible, the results can be customized and easily filtered with a script.

	/WHO <mask> [[<match>][%<fields>[,<querytype>]] [:<mask>]]		/WHO <mask> [[<match>][%<fields>[,<querytype>]] [:<mask>]]

Wiebe: update description at top

2007-04-08T15:05:02Z

update description at top

← Older revision		Revision as of 15:05, 8 April 2007
Line 1:		Line 1:
	{{Stub}}		{{Stub}}
	This command returns a single line of information for every user requested, and it is one of the most complex and powerful commands on ircu, no other command comes close to what it can do.		This command returns a single line of information for every user requested, and it is one of the most complex and powerful commands on ircu, no other command comes close to what it can do. Normally the information includes ''(first) channel name, user, host, server, nick, flags, distance, and realname'', and more is possible, the results can be customized and easily filtered.

	/WHO <mask> [[<match>][%<fields>[,<querytype>]] [:<mask>]]		/WHO <mask> [[<match>][%<fields>[,<querytype>]] [:<mask>]]

Wiebe: moved things around in replies

2007-04-08T14:30:00Z

moved things around in replies

← Older revision		Revision as of 14:30, 8 April 2007
Line 151:		Line 151:

	== Replies ==		== Replies ==


			=== IAL ===
			The [[:Category:IAL\|IAL]] can only be updated with the normal replies, and not with field flags since that is using a different numeric.


	=== Flags ===		=== Flags ===
	The <flags> parameter in both type of replies is formated as <away>[<oper>][<chan>][<usermodes>]. The user's away status is indicated with a "H" (here) or a "G" (gone). IRC Operator status is indicated with a "*". The user's status on the channel in the reply is indicated with a "@" when opped, a "+" when voiced, a "!" when [[kick\|zombie]], and "<" when hidden. When using field flags to control the output, more than one of such channel status flag may be returned, while the normal replies show only one. The usermodes part shows usermode "d" and "x" to users, in addition, IRC Operators can see usermodes "i", "w" "g" and "h".		The <flags> parameter in both type of replies is formated as <away>[<oper>][<chan>][<usermodes>]. The user's away status is indicated with a "H" (here) or a "G" (gone). IRC Operator status is indicated with a "*". The user's status on the channel in the reply is indicated with a "@" when opped, a "+" when voiced, a "!" when [[kick\|zombie]], and "<" when hidden. When using field flags to control the output, more than one of such channel status flag may be returned, while the normal replies show only one. The usermodes part shows usermode "d" and "x" to users, in addition, IRC Operators can see usermodes "i", "w" "g" and "h".


			=== Modes & HIS ===
			The status of a channel private (+p) or secret (+s), and users being invisible (+i) may affect the result of /WHO. Also Head In Sand (HIS) settings may limit certain features for users (e.g. match flag "s" for server, "i" for IP), and obscure information in the replies for users (e.g. server name, idle time, hopcount, IP).


Line 170:		Line 178:
	9 fields returned = maximum 157 replies		9 fields returned = maximum 157 replies
	10 fields returned = maximum 146 replies		10 fields returned = maximum 146 replies


	~~=== Modes & HIS ===~~
	The status of a channel private (+p) or secret (+s), and users being invisible (+i) may affect the result of /WHO. Also Head In Sand (HIS) settings may limit certain features for users (e.g. match flag "s" for server, "i" for IP), and obscure information in the replies for users (e.g. server name, idle time, hopcount, IP).


	~~=== IAL ===~~
	~~The [[:Category:IAL\|IAL]] can only be updated with the normal replies, and not with field flags since that is using a different numeric.~~

Wiebe: fixed typo and restored list change by cail

2007-04-08T14:26:27Z

fixed typo and restored list change by cail

← Older revision		Revision as of 14:26, 8 April 2007
Line 170:		Line 170:
	9 fields returned = maximum 157 replies		9 fields returned = maximum 157 replies
	10 fields returned = maximum 146 replies		10 fields returned = maximum 146 replies


	=== Modes & HIS ===		=== Modes & HIS ===
Line 180:		Line 181:

	== See also ==		== See also ==
	~~External link:~~ [https://svn.quakenet.org/svn/quakenet/snircd/trunk/doc/readme.who readme.who]		* [https://svn.quakenet.org/svn/quakenet/snircd/trunk/doc/readme.who readme.who]
			* [[away\|AWAY]] [[kick\|KICK]] [[mode\|MODE]] [[whois\|WHOIS]]
	~~commands:~~ [[away\|AWAY]] [[kick\|KICK]] [[mode\|MODE]] [[whois\|WHOIS]]		* [[:Category:Raw_who\|raw numerics]]

	~~numerics:~~ [[~~raw_315~~\|~~315]] [[raw_352\|352]] [[raw_354\|354~~]]

	[Category:Basic IRC commands]][[Category:Raw_who]][[Category:IAL]]		[[Category:Basic IRC commands]][[Category:Raw_who]][[Category:IAL]]

Wiebe: changed misc, changed special reply, added category IAL, added IAL to misc, changed end of reply, added HIS, renamed misc to replies

2007-04-08T14:22:38Z

changed misc, changed special reply, added category IAL, added IAL to misc, changed end of reply, added HIS, renamed misc to replies

← Older revision		Revision as of 14:22, 8 April 2007
Line 39:		Line 39:
	u Username		u Username
	h Hostname		h Hostname
	i Numeric IP ~~(for IRC Operators only)~~		i Numeric IP
	s Servername ~~(for IRC Operators only)~~		s Servername
	r Realname		r Realname
	a Account name (new in snircd)		a Account name (new in snircd)
Line 135:		Line 135:
	; show 567, nick, user, host and flags for users on #chan		; show 567, nick, user, host and flags for users on #chan

	The querytype number is not returned ~~in the~~ [[Raw_315\|"end of ~~/WHO list~~.~~"]] reply~~, a trick can be used, but only for flat nicks and channels.		The querytype number is not returned raw numeric [[Raw_315\|315 RPL_ENDOFWHO]], which marks the end of the reply. However, a trick can be used, but only for flat nicks and channels.

	/WHO nick,123 n%nuht,123		/WHO nick,123 n%nuht,123
Line 144:		Line 144:


	=== ~~Reply~~ format ===		=== Separate reply format ===
	~~Only specified fields are returned in~~ [[~~Raw_354~~\|~~raw~~ 354]], but always in the same order:		A separate raw numeric, [[raw_354\|354 RPL_WHOSPCRPL]], is used, to avoid confusing clients with different replies, and only the specified fields are returned, but always in the same order:
			[<querytype>] [<channel>] [<user>] [<ip>] [<host>] [<server>] [<nick>] [<flags>] [<distance>]
			[<idle time>] [<account>] [<oplevel>] [:<realname>]


			== Replies ==

	~~[<querytype>] [<channel>] [<user>] [<ip>] [<host>] [<server>] [<nick>] [<flags>] [<distance>]~~
	~~[<idle time>] [<account>] [<oplevel>] [:<realname>]~~

			=== Flags ===
			The <flags> parameter in both type of replies is formated as <away>[<oper>][<chan>][<usermodes>]. The user's away status is indicated with a "H" (here) or a "G" (gone). IRC Operator status is indicated with a "*". The user's status on the channel in the reply is indicated with a "@" when opped, a "+" when voiced, a "!" when [[kick\|zombie]], and "<" when hidden. When using field flags to control the output, more than one of such channel status flag may be returned, while the normal replies show only one. The usermodes part shows usermode "d" and "x" to users, in addition, IRC Operators can see usermodes "i", "w" "g" and "h".

	~~== Misc ==~~
	The <flags> parameter in both type of replies is formated as <away>[<oper>][<chanstatus>][<usermodes>]. The user's away status is indicated with a "H" (here) or a "G" (gone). IRC Operator status is indicated with a "*". The user's status on the channel in the reply is indicated with a "@" when opped, a "+" when voiced, a "!" when [[kick\|zombie]], and "<" when hidden. When using field flags to control the output, more than one of such channel status flag may be returned, while the normal replies show only one. The usermodes part shows usermode "d" and "x" to users, IRC Operators can see usermodes "i", "w" "g" and "h" as well.

			=== Limit ===
	The maximum number of lines reported as reply for a query is "2048/(n+4)" where "n" is the number of field flags specified. This limit does not apply when the request is for a channel the client is on.		The maximum number of lines reported as reply for a query is "2048/(n+4)" where "n" is the number of field flags specified. This limit does not apply when the request is for a channel the client is on.

Line 167:		Line 171:
	10 fields returned = maximum 146 replies		10 fields returned = maximum 146 replies

	The status of a channel private (+p) or secret (+s), and users being invisible (+i) may affect the result of /WHO.		=== Modes & HIS ===
			The status of a channel private (+p) or secret (+s), and users being invisible (+i) may affect the result of /WHO. Also Head In Sand (HIS) settings may limit certain features for users (e.g. match flag "s" for server, "i" for IP), and obscure information in the replies for users (e.g. server name, idle time, hopcount, IP).


			=== IAL ===
			The [[:Category:IAL\|IAL]] can only be updated with the normal replies, and not with field flags since that is using a different numeric.


	== See also ==		== See also ==
	* External link: [https://svn.quakenet.org/svn/quakenet/snircd/trunk/doc/readme.who readme.who]		External link: [https://svn.quakenet.org/svn/quakenet/snircd/trunk/doc/readme.who readme.who]
	* Commands: [[away\|AWAY]] [[kick\|KICK]] [[mode\|MODE]] [[whois\|WHOIS]]
	* Numerics: [[raw_315\|315]] [[raw_352\|352]] [[raw_354\|354]]		commands: [[away\|AWAY]] [[kick\|KICK]] [[mode\|MODE]] [[whois\|WHOIS]]

			numerics: [[raw_315\|315]] [[raw_352\|352]] [[raw_354\|354]]

	[[Category:Raw_who]][[Category:~~Basic IRC commands~~]]		[Category:Basic IRC commands]][[Category:Raw_who]][[Category:IAL]]

Cail: made a neat list for the see also -links

2007-04-08T14:09:09Z

made a neat list for the see also -links

← Older revision		Revision as of 14:09, 8 April 2007
Line 171:		Line 171:

	== See also ==		== See also ==
	External link: [https://svn.quakenet.org/svn/quakenet/snircd/trunk/doc/readme.who readme.who]		* External link: [https://svn.quakenet.org/svn/quakenet/snircd/trunk/doc/readme.who readme.who]
			* Commands: [[away\|AWAY]] [[kick\|KICK]] [[mode\|MODE]] [[whois\|WHOIS]]
	~~commands~~: [[away\|AWAY]] [[kick\|KICK]] [[mode\|MODE]] [[whois\|WHOIS]]		* Numerics: [[raw_315\|315]] [[raw_352\|352]] [[raw_354\|354]]

	~~numerics~~: [[raw_315\|315]] [[raw_352\|352]] [[raw_354\|354]]

	[[Category:Raw_who]][[Category:Basic IRC commands]]		[[Category:Raw_who]][[Category:Basic IRC commands]]

Wiebe: removed a space, changed text around the list of match and field flags, removed case insensitive from misc

2007-04-08T13:41:19Z

removed a space, changed text around the list of match and field flags, removed case insensitive from misc

← Older revision		Revision as of 13:41, 8 April 2007
Line 24:		Line 24:


	A user is always returned only one time in the replies, even when matched by the input more than once.		A user is always returned only one time in the replies, even when matched by the input more than once.

	/WHO #chan1,#chan2		/WHO #chan1,#chan2
Line 34:		Line 34:

	== Match flags ==		== Match flags ==
			Field matching flags in parameter <match>, when one of these is specified the field in question is matched against the mask, otherwise it is not matched. When not specified, the default of "nuhsr" is used.

	n Nick		n Nick
	u Username		u Username
Line 42:		Line 44:
	a Account name (new in snircd)		a Account name (new in snircd)

			These flags are case insensitive (e.g. N is the same as n), and the order in which they are specified does not matter.
	~~Field matching~~ flags ~~in parameter <match>~~, ~~when one of these is specified~~ the ~~field~~ in ~~question is matched against the mask, otherwise it is~~ not ~~matched. When not specified, the default of "nuhsr" is used~~.

	/WHO *.org h		/WHO *.org h
Line 100:		Line 101:

	== Field flags ==		== Field flags ==
	The parameter <fields> ~~specifies~~ which fields to include in the output:		The flags given in parameter <fields> specify which fields to include in the output.

	t Include the querytype in the reply		t Include the querytype in the reply
	c Include (first) channel name (* when none can be shown)		c Include (first) channel name (* when none can be shown)
Line 114:		Line 116:
	o Include oplevel (new in snircd)		o Include oplevel (new in snircd)
	r Include real name		r Include real name

			These flags are case insensitive (e.g. N is the same as n), and the order in which they are specified does not matter.

	/WHO nick n%nuh		/WHO nick n%nuh
Line 150:		Line 154:
	The <flags> parameter in both type of replies is formated as <away>[<oper>][<chanstatus>][<usermodes>]. The user's away status is indicated with a "H" (here) or a "G" (gone). IRC Operator status is indicated with a "*". The user's status on the channel in the reply is indicated with a "@" when opped, a "+" when voiced, a "!" when [[kick\|zombie]], and "<" when hidden. When using field flags to control the output, more than one of such channel status flag may be returned, while the normal replies show only one. The usermodes part shows usermode "d" and "x" to users, IRC Operators can see usermodes "i", "w" "g" and "h" as well.		The <flags> parameter in both type of replies is formated as <away>[<oper>][<chanstatus>][<usermodes>]. The user's away status is indicated with a "H" (here) or a "G" (gone). IRC Operator status is indicated with a "*". The user's status on the channel in the reply is indicated with a "@" when opped, a "+" when voiced, a "!" when [[kick\|zombie]], and "<" when hidden. When using field flags to control the output, more than one of such channel status flag may be returned, while the normal replies show only one. The usermodes part shows usermode "d" and "x" to users, IRC Operators can see usermodes "i", "w" "g" and "h" as well.

	~~The match and field flags are case insensitive, and the order in which they are specified does not matter.~~ The maximum number of lines reported as reply for a query is "2048/(n+4)" where "n" is the number of field flags specified. This limit does not apply when the request is for a channel the client is on.		The maximum number of lines reported as reply for a query is "2048/(n+4)" where "n" is the number of field flags specified. This limit does not apply when the request is for a channel the client is on.

	1 field returned = maximum 409 replies		1 field returned = maximum 409 replies

Wiebe: removed spaces in front of x flag

2007-04-08T13:15:14Z

removed spaces in front of x flag

← Older revision		Revision as of 13:15, 8 April 2007
Line 85:		Line 85:
	Special flag:		Special flag:

	x Extended visibility of information for opers.		x Extended visibility of information for opers.

	IRC Operators may use this flag to see in private (+p) or secret (+s) channels, and see invisible (+i) users. Only IRC Operators can use this flag, else it is ignored.		IRC Operators may use this flag to see in private (+p) or secret (+s) channels, and see invisible (+i) users. Only IRC Operators can use this flag, else it is ignored.

← Older revision		Revision as of 16:29, 4 June 2007
Line 184:		Line 184:

	== See also ==		== See also ==
	* [~~https~~://~~svn~~.quakenet.org/~~svn/quakenet~~/~~snircd~~/~~trunk~~/doc/readme.who readme.who]		* [http://hg.quakenet.org/snircd/file/bd1b1df869d1/doc/readme.who readme.who]
	* [[away\|AWAY]] [[kick\|KICK]] [[mode\|MODE]] [[whois\|WHOIS]]		* [[away\|AWAY]] [[kick\|KICK]] [[mode\|MODE]] [[whois\|WHOIS]]
	* [[:Category:Raw_who\|raw numerics]]		* [[:Category:Raw_who\|raw numerics]]

	[[Category:Basic IRC commands]][[Category:Raw_who]][[Category:IAL]]		[[Category:Basic IRC commands]][[Category:Raw_who]][[Category:IAL]]