public function getIpAddress()
{
// what are we doing?
$log = usingLog()->startAction("get IP address of host '{$this->args[0]}'");
// make sure we have valid host details
$hostDetails = $this->getHostDetails();
// all done
$log->endAction("IP address is '{$hostDetails->ipAddress}'");
return $hostDetails->ipAddress;
}