Table of Contents

Synopsis:

names [<switch> [<arg>] [<switch> [<arg>] …]] [<channel>]

Description:

NAMES is similar to LIST except it will show nicknames in addition to channel names. Only visible users on public channels are returned.

If a nickname is prefixed with a +, that means they are a channel voice (mode +v) on that channel. If a nickname is prefixed with @, that means they are a channel operator (mode +o) on that channel.

If an exact channel name is given, only that channel is queried. If the “*” channel is given, your current window's current channel is used. In all other circumstances, the client requests information about ALL channels, and the problems incurred with global LIST requests apply.

NAMES supports client-side filtering, but just as with LIST you still run the risk of flooding yourself off the server if the network is huge and has thousands of channels. (Servers do not always tolerate users who use up lots of resources asking for large amounts of data.)

Channels that are not public (Either +p or +s) will not show up at all. Users that are invisible (User mode +i, or are a member of a non-public channel) will not show up at all.

You can always do a NAMES request on any channel you are a member of without regard to any of the above restrictions.

Options:

-min <n> shows channels with no less than n users
-max <n> shows channels with no more than n users
-public shows public channels only
-private shows private channels only
-all overrides any previous -public or -private switch

Examples:

To show users on all channels with 3 to 15 users:

    /names -min 3 -max 15

To show users on public channels with “help” in the name:

    /names -public #*help*