Prose\FromHost::getDetails PHP Method

    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;
    }