NAME

UPnP::Common - Common constants, parameters and functions, including several internal modules, for the Perl UPnP implementation. Only documented functionality should be used outside the Perl UPnP set of packages.

DESCRIPTION

This class gives you access constants that can be used to control aspects of the behavior of Perl UPnP objects.

$LOCAL_IP

Perl UPnP needs to have access to the IP address of the network interface used for UPnP protocol exchanges. Perl UPnP will try to automatically detect the IP address of the interface if this variable is not set. However, this variable can be explictly set to the IP address to use:

$UPnP::LOCAL_IP = '192.168.0.23';

$IP_DETECT_ADDRESS

If the $LOCAL_IP variable has not been explicitly set, the UPnP implementation attempts to automatically detect the IP address of the network interface used for UPnP protocol exchanges. It does this by connecting to a well-known external address and querying the socket used for the connection. By default, this address is 'www.google.com' over port 80. An alternate IP address detection address can be specified in the following way:

$UPnP::IP_DETECT_ADDRESS = 'www.yahoo.com:80';

SEE ALSO

UPnP documentation and resources can be found at http://www.upnp.org.

The SOAP::Lite module can be found at http://www.soaplite.com.

UPnP implementations in other languages include the UPnP SDK for Linux (http://upnp.sourceforge.net/), Cyberlink for Java (http://www.cybergarage.org/net/upnp/java/index.html) and C++ (http://sourceforge.net/projects/clinkcc/), and the Microsoft UPnP SDK (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/upnp/upnp/universal_plug_and_play_start_page.asp).

AUTHOR

Vidur Apparao (vidurapparao@users.sourceforge.net)

COPYRIGHT AND LICENSE

Copyright (C) 2004-2005 by Vidur Apparao

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8 or, at your option, any later version of Perl 5 you may have available.