Site Tools


list
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


list [2006/08/01 04:13] (current) – created - external edit 127.0.0.1
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 by 127.0.0.1