PEAR Manual
PrevNext

Net_Finger::query()

Net_Finger::query() -- does a finger query

Synopsis

require_once 'Net/Finger.php';

string Net_Finger::query (string $server, string $query)

Description

Execute a finger query on a server

Parameter

Return value

string - the data from the finger request.

Throws

The returned PEAR_Error object in case of an error is unspecific, so you can ignore the error code and/or message. The reason for a failure could be a failed connection to the server or the server did not run a finger service.

Note: You will not get a PEAR_Error, if the query fails due to a not existing finger object. This can be only done by checking the data returned by query().

Note

This function can be called statically.

Example

Example 48-1. Using query()

<?php

$server = "localhost" ; // or IP adress to use
$query  = "ralph" ;     // Username to look up

$data = Net_Finger::query( $server, $query) ;
echo $data ; 

?>
PrevHomeNext
Net_FingerUpNet_FTP