Site Tools


who
no way to compare when less than two revisions

Differences

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


who [2008/07/28 05:15] (current) – created - external edit 127.0.0.1
Line 1: Line 1:
 +# $EPIC: who.txt,v 1.3 2008/07/28 05:15:51 jnelson Exp $
 +
 +======Synopsis:======
 +__who__ [<option> ...] [<target|pattern>]
 +
 +======Description:======
 +The __WHO__ command queries detailed information about a target or
 +wildcard pattern.  For each user it will return a single line containing
 +their nickname, userhost address, realname (IRCNAME), their current
 +channel (if it is public), whether they are a chanop or chanvoice there,
 +whether they are here or gone, and whether they are an irc operator.
 +
 +The __WHO__ command uses the same rules as [[NAMES]] and [[LIST]] to
 +determine which users will be returned.  Invisible users will never be
 +returned, and users on secret or private channels are never returned.
 +Notwithstanding this, if you are on the same channel as someone else,
 +they will be returned.
 +
 +The client can do client-side filtering, to reduce the number of users shown.
 +
 +Undernet and Dalnet each have (incompatible) server-side filtering.
 +
 +======Options:======
 +Options may be abbreviated, so long as they are not ambiguous.
 +If you specify any unrecognized options, the entire request is aborted.
 +
 +<file>
 +   - Universal server-side filtering options:
 +  -oper     Show only irc operators
 +     Only one of the following options may be used in each request:
 +  -host <hostname>        Show only users from this host
 +  -server <servername>  Show only users on this server
 +  -name <username>  Show only users with this username
 +  -realname <username>  Show only users with this IRCNAME
 +  -nick <nickname>        Show only users with this nickname
 +
 +   - Undernet-specific server-side filtering options:
 +   -u-i      Show invisible users (restricted to opers)
 +   -ux       Send an "Undernet Extended" who request
 +        (Cannot be used with any other options)
 +
 +   - Dalnet-specific server-side filtering options:
 +   -dx     Send a "Dalnet Extended" who request
 +           (Cannot be used with any other options)
 +
 +   - Client-side filtering options:
 +  -lusers                 Show only non-operators
 +  -chops                  Show only channel operators
 +  -nochops    Show only non-channel operators
 +  -here     Show only non-away users
 +  -away     Show only away users
 +
 +    - Reply processing:
 +  -line {...}   Execute the code for each line and DO NOT
 +        hook /on WHO.
 +    The parameters to -line are exactly the same as the
 +    parameters to [[ON WHO]].
 +
 +  -end {...}    Execute the code for the last line and DO 
 +        NOT hook /on 315.
 +    The parameters to -end are as follows:
 +      $0   name of server queried
 +      $1   body of the query
 +
 +   - Debugging:
 +  -literal    Send a query exactly as specified to the 
 +        server with no client processing of the
 +        request.  (Cannot be used with other options)
 +  -flush      Flush the WHO queue (dangerous!)
 +  -diagnose   Display the WHO queue
 +</file>
 +
 +======Examples:======
 +To list all irc operators on servers from foo.com:
 +      /who -o -s *.foo.com
 +
 +To list the channel operators on channel #blah, which you are on:
 +      /who -c #blah
 +
 +To list all users from Russia, saving it to a file:
 +      /who -h *.ru -f ru.users
 +
 +To list all non-opers and say something at the end:
 +      /who -lusers -end { echo sheesh. that's a lot of lusers! }
  
who.txt · Last modified: 2008/07/28 05:15 by 127.0.0.1