PEAR Manual
Prev |  | Next

# Net_Portscan::checkPortRange()

Net_Portscan::checkPortRange() -- check for available services

## Synopsis

    require_once 'Net/Portscan.php';

``array Net_Portscan::checkPortRange` (string $host, integer $minPort, integer $maxPort [, integer $timeout = 30])`

## Description

This function checks if there are services available at the specified ports on the specified machine.

## Parameter

- `string $host` - address of the host to check

- `string $minPort` - lowest port to test to check

- `string $maxPort` - highest port to test to check

- `string $timeout` - time in seconds to wait for every response from host

  > Important: If you run into timeout problems despite setting this parameter to a reasonably high value, you need to make sure that the configuration directive `default_socket_timeout` in the `php.ini` configuration file does not force the maximum timeout down to a lower value.

## Return value

`array` - An associative array containing the scanning results for each port.

## Note

This function can be called statically.

## Example

Example 48-1. Using checkPortRange
    require_once "Net_Portscan/Portscan.php";

    echo "Scanning localhost ports 70-90\n";
    $result = Net_Portscan::checkPortRange("localhost", 70, 90);

    foreach ($result as $port => $element) {
        if ($element == NET_PORTSCAN_SERVICE_FOUND) {
            echo "A service has been found on port " . $port . ".\n";
        } else {
            echo "No service has been found on port " . $port . ".\n";
        }
    }

Prev | Home | Next
Net_Portscan::checkPort() | Up | Net_Portscan::getPort()