gupnp_root_device_new(3) [php man page]

GUPNP_ROOT_DEVICE_NEW(3)						 1						  GUPNP_ROOT_DEVICE_NEW(3)

gupnp_root_device_new - Create a new root device

SYNOPSIS

       resource gupnp_root_device_new (resource  $context, string  $location, string  $description_dir)

DESCRIPTION

	Create a new root device, automatically downloading and parsing location.

PARAMETERS

	      o $context
		- A context identifier, returned by gupnp_context_new(3).

	      o $location
		- Location of the description file for this device, relative to the HTTP root

RETURN VALUES

	A root device identifier.

EXAMPLES

       Example #1

	      Create new UPnP context and get device info service

	      <?php

	      /* Create the UPnP context */
	      $context = gupnp_context_new();

	      if (!$context) {
	       die("Error creating the GUPnP context
");
	      }

	      /* Create root device */
	      $location = "/BinaryLight1.xml";
	      $dev = gupnp_root_device_new($context, $location);

	      ?>

SEE ALSO

       gupnp_root_device_set_available(3), gupnp_root_device_start(3), gupnp_root_device_stop(3).

PHP Documentation Group 												  GUPNP_ROOT_DEVICE_NEW(3)

GUPNP_CONTEXT_TIMEOUT_ADD(3)						 1					      GUPNP_CONTEXT_TIMEOUT_ADD(3)

gupnp_context_timeout_add - Sets a function to be called at regular intervals

SYNOPSIS

       bool gupnp_context_timeout_add (resource  $context, int	$timeout, mixed  $callback, [mixed  $arg])

DESCRIPTION

	Sets a function to be called at regular intervals.

PARAMETERS

	      o $context
		- A context identifier, returned by gupnp_context_new(3).

	      o $timeout
		- A timeout in miliseconds.

	      o $callback
		- The callback function calling every $timeout period of time. Typically, callback function takes on $arg parameter.

	      o $arg
		- User data for $callback.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Create new UPnP context and set callback

	      <?php

	      $user_data = "user data";

	      function timeout_cb($arg)
	      {
		  printf("Call timeout_cb, user data: '%s'", $arg);
		  return true;
	      }

	      /* Create the UPnP context */
	      $context = gupnp_context_new();

	      if (!$context) {
	       die("Error creating the GUPnP context
");
	      }

	      /* Create root device */
	      $dev = gupnp_root_device_new($context, "/devicedesc.xml");

	      /* Set callback for timeout */
	      gupnp_context_timeout_add($context, 5000, "timeout_cb", $user_data);

	      /* Run the main loop */
	      gupnp_root_device_start($dev);

	      ?>

ERRORS
/EXCEPTIONS
	Issues E_WARNING with not valid callback function.

SEE ALSO

       gupnp_context_new(3).

PHP Documentation Group 											      GUPNP_CONTEXT_TIMEOUT_ADD(3)