NAME

target_parent - Lookup the frameserver VID of the parent to a subsegment

SYNOPSIS

vid
target_parent( vid )

DESCRIPTION

This function can be used to determine if a specific vid is a subsegment to a frameserver, and if so, get the primary vid associated with that frameserver.

NOTES

1: It is not guaranteed that the returned vid points to a valid frameserver or vid if the connection has been pacified or terminated externally.

EXAMPLE

function target_parent0()
      local a = target_alloc("test", function() end);
      b = target_alloc(a, function() end);
      if (target_parent(b) != a) then
            shutdown("reported subsegment parent is invalid", -1);
      else
            shutdown("");
      end
end

EXAMPLE

function target_parent1()
      local a = target_alloc("test", function() end);
      if (valid_vid(target_parent(a))) then
            shutdown("connection point should not have a parent", -1);
      else
            shutdown("");
      end
end

NAME

SYNOPSIS

DESCRIPTION

NOTES

EXAMPLE

EXAMPLE

SEE ALSO: