---
name: "Net::UPnP::ControlPoint"
section: "3pm"
platform: "linux"
package: "libnet-upnp-perl"
version: "1.4.6-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net::UPnP::ControlPoint"
---

# Net::UPnP::ControlPoint(3pm)

Perl extension for UPnP control point.

## NAME

Net::UPnP::ControlPoint - Perl extension for UPnP control point.

## SYNOPSIS

```
    use Net::UPnP::ControlPoint;
    my $obj = Net::UPnP::ControlPoint->new();
    @dev_list = $obj->search(st =>'upnp:rootdevice', mx => 3);
    $devNum= 0;
    foreach $dev (@dev_list) {
        $device_type = $dev->getdevicetype();
        if  ($device_type ne 'urn:schemas-upnp-org:device:MediaServer:1') {
            next;
        }
        print "[$devNum] : " . $dev->getfriendlyname() . "\n";
        unless ($dev->getservicebyname('urn:schemas-upnp-org:service:ContentDirectory:1')) {
            next;
        }
        $condir_service = $dev->getservicebyname('urn:schemas-upnp-org:service:ContentDirectory:1');
        unless (defined(condir_service)) {
            next;
        }
        %action_in_arg = (
                'ObjectID' => 0,
                'BrowseFlag' => 'BrowseDirectChildren',
                'Filter' => '*',
                'StartingIndex' => 0,
                'RequestedCount' => 0,
                'SortCriteria' => '',
            );
        $action_res = $condir_service->postcontrol('Browse', \%action_in_arg);
        $actrion_out_arg = $action_res->getargumentlist();
        unless ($actrion_out_arg->{'Result'}) {
            next;
        }
        $result = $actrion_out_arg->{'Result'};
        while ($result =~ m/<dc:title>(.*?)<\/dc:title>/sgi) {
            print "\t$1\n";
        }
        $devNum++;
    }
```

## DESCRIPTION

The package can search UPnP devices in the local network and get the device list of Net::UPnP::Device.

## METHODS

- **new** - create new Net::UPnP::ControlPoint

  ```
      $ctrlPoint = Net::UPnP::ControlPoint();
  ```

  Creates a new object. Read \`perldoc perlboot\` if you don't understand that.

- **search** - search UPnP devices

  ```
      @device_list = $ctrlPoint->search();
      @device_list = $ctrlPoint->search(
                  [st => $search_target], # 'upnp:rootdevice'
                  [mx => $maximum_wait] # 3
                  );
  ```

  Search UPnP devices and return the device list. Please see Net::UPnP::Device too.

## SEE ALSO

Net::UPnP::Device

## AUTHOR

Satoshi Konno skonno@cybergarage.org

CyberGarage http://www.cybergarage.org

## COPYRIGHT AND LICENSE

Copyright (C) 2005 by Satoshi Konno

It may be used, redistributed, and/or modified under the terms of BSD License.