Extended version of the LIST command that returns additional channel properties. Channels with extended names will be returned, even to non-IRCX clients. Some channel modes and the PICS rating string are included with the result. Only the channel modes that do not define an additional argument (TOPICOP, NOEXTERN, etc.) are included in the <modes> field. Clients should use the query limit to avoid overloading the client or having the connection dropped by the server.
Syntax 1:
LISTX [<channel list>]
Syntax 2:
LISTX <query list> [<query limit>]
<channel list> A list of channels may be specified in order to find the PICS ratings or modes of those channels. If no channels are specified, the server will send the entire matching list of channels.
<query list> One or more query terms separated by spaces or commas.
Table 3.2. Query terms for LIST command
| Query Term | Description |
|---|---|
| <# | Select channels with less than # members. |
| ># | Select channels with more than # members. |
| C<# | Select channels created less than # minutes ago. |
| C># | Select channels created greater than # minutes ago. |
| L=<mask> | Select channels with language property matching the mask string. |
| N=<mask> | Select channels with name matching the mask string. |
| R=0 | Select unregistered channels. |
| R=1 | Select registered channels. |
| S=<mask> | Select channels with subject matching the mask string. |
| T<# | Select channels with a topic changed less than # minutes ago. |
| T># | Select channels with a topic changed greater than # minutes ago. |
| T=<mask> | Select channels that topic matches the mask string. |
| <query limit> | Maximum number of channels to be returned. |
| <mask> | Sequence of characters that is used to select a matching channel name or topic. The character * and ? are used for wildcard searches. |
To compose a mask, use this character escaping scheme.
Table 3.3. Character escaping in mask-string
| Escaped Character | Description |
|---|---|
| \b | For " " blank |
| \c | for "," |
| \\ | for "\" |
| \* | for "*" (not wildcard) |
| \? | for "?" (not wildcard) |
The PICS property is only returned if not null.
A record limit of '0' (zero) or blank will be interpreted as unlimited.