Synopsis:
userhost [<nickname> [<nickname> ...] [-cmd <command>]]
Description:
This queries the server for for address (user@hostname) of the given
nicknames. Any number of nicknames can be specified. If no nickname
is given, the user's is used (this is one way for users to verify
what address the irc server thinks they have).
USERHOST also allows its output to be used as the input for other
commands, using the -cmd flag. When using -cmd, at least one nickname
is required. The command can be anything, and multiple commands may
be used by surrounding them in curly braces.
USERHOST passes the following arguments to -cmd:
$0 - nickname
$1 - a '+' if the user is an irc operator, a '-' otherwise
$2 - a '+' if the user is marked as away, a '-' otherwise
$3 - username
$4 - hostname
Options:
-cmd take the output from /userhost as input to other commands
Examples:
To get the userhosts of JoeBob and Jimbo:
/userhost joebob jimbo
To use their userhost output as another command's input in a script:
userhost joebob jimbo -cmd {
echo $0 is $3@$4
if ( [$1] == [+] ) echo $0 is an irc operator
if ( [$2] == [+] ) echo $1 is away
}
Aliases:
HOST is identical in operation to USERHOST.
See Also:
Expressions(7)
Other Notes:
The server will only permit 5 nicknames at a time for this command.
When more than 5 are given, the client will split the command up and
issue separate queries as needed. However, most servers enable their
flood protection after receiving 5 of the same kind of command within
a short time period. This means that the user should expect a delay
in response if more than 25 nicknames are specified.