list
Differences
This shows you the differences between two versions of the page.
|
list [2006/08/01 04:13] |
list [2006/08/01 04:13] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ======Synopsis:====== | ||
| + | __list__ [<switch> [<arg>] [<switch> [<arg>] ...]] [<channel>] | ||
| + | |||
| + | ======Description:====== | ||
| + | This query asks the server about all of the public channels that exist | ||
| + | on the current network. A summary of each channel, including the channel | ||
| + | name, the number of users on the channel, and the channel's topic (if any) | ||
| + | will be displayed, one per line. | ||
| + | |||
| + | If you provide an exact channel name, then only information about that | ||
| + | channel will be returned. If you provide "*" as the channel name, then | ||
| + | the current window's current channel will be used. Otherwise the server | ||
| + | will return the entire channel list. | ||
| + | |||
| + | On large public networks with many thousands of channels, using this | ||
| + | command may be counterproductive. Even the use of the filtering rules | ||
| + | before are not helpful since the client has to ask for the entire list | ||
| + | and filter out what you don't want to see. It still all has to be sent | ||
| + | to you. In some severe situations you can be disconnected from the server | ||
| + | if you are using a slow link. | ||
| + | |||
| + | Only public channels will be shown. Private or secret channels will not | ||
| + | be shown in the result, unless you are actually a member of that channel | ||
| + | at the time you use the __LIST__ command. | ||
| + | |||
| + | ======Options:====== | ||
| + | You can refine the output by asking for only channels with certain | ||
| + | characteristics. Except when you use the -i option on undernet servers, | ||
| + | all of this filtering is done by the client and not the server. This | ||
| + | means EPIC still has to process the entire list even if you only want | ||
| + | to see a couple of channels. | ||
| + | -min <n> shows channels with no less than n users | ||
| + | -max <n> shows channels with no more than n users | ||
| + | -i Use undernet specific server-side filtering for above two | ||
| + | |||
| + | These options are always done on the client side even with the -i option: | ||
| + | -public shows public channels only | ||
| + | -private shows private channels only | ||
| + | -topic shows channels with a topic set | ||
| + | -all overrides any previous -public or -private switch | ||
| + | |||
| + | These options turn on "wide listing" which uses less vertical space: | ||
| + | -wide shows name and size using as little space as possible: | ||
| + | -name sort -wide list by channel name | ||
| + | -users sort -wide list by number of users per channel | ||
| + | |||
| + | ======Examples:====== | ||
| + | To show channels with 3 to 15 users: | ||
| + | /list -min 3 -max 15 | ||
| + | |||
| + | To show public channels with "help" in the name: | ||
| + | /list -public #*help* | ||
| + | |||
| + | To get a concise listing of channels with over 30 users, sorted by name: | ||
| + | /list -min 30 -wide -name | ||
| + | |||
| + | To see how Undernet's LIST works (and see below): | ||
| + | /quote list help | ||
list.txt ยท Last modified: 2006/08/01 04:13 (external edit)