public function getDetails()
{
// what are we doing?
$log = usingLog()->startAction("retrieve details for host '{$this->args[0]}'");
// get the host details
$hostDetails = $this->getHostDetails();
// we already have details - are they valid?
if (isset($hostDetails->invalidHost) && $hostDetails->invalidHost) {
$msg = "there are no details about host '{$hostDetails->hostId}'";
$log->endAction($msg);
throw new E5xx_ActionFailed(__METHOD__, $msg);
}
// return the details
$log->endAction();
return $hostDetails;
}