src/MultiPlayer/multiplaymgr.cxx

   1 //////////////////////////////////////////////////////////////////////
   2 //
   3 // multiplaymgr.hpp
   4 //
   5 // Written by Duncan McCreanor, started February 2003.
   6 // duncan.mccreanor@airservicesaustralia.com
   7 //
   8 // Copyright (C) 2003  Airservices Australia
   9 // Copyright (C) 2005  Oliver Schroeder
  10 // Copyright (C) 2006  Mathias Froehlich
  11 //
  12 // This program is free software; you can redistribute it and/or
  13 // modify it under the terms of the GNU General Public License as
  14 // published by the Free Software Foundation; either version 2 of the
  15 // License, or (at your option) any later version.
  16 //
  17 // This program is distributed in the hope that it will be useful, but
  18 // WITHOUT ANY WARRANTY; without even the implied warranty of
  19 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  20 // General Public License for more details.
  21 //
  22 // You should have received a copy of the GNU General Public License
  23 // along with this program; if not, write to the Free Software
  24 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  25 //
  26 // $Id$
  27 //
  28 //////////////////////////////////////////////////////////////////////
  29
  30 #ifdef HAVE_CONFIG_H
  31 #include <config.h>
  32 #endif
  33
  34 #include <iostream>
  35 #include <algorithm>
  36 #include <osg/Math>             // isNaN
  37 #include <plib/netSocket.h>
  38
  39 #include <simgear/misc/stdint.hxx>
  40 #include <simgear/timing/timestamp.hxx>
  41 #include <simgear/debug/logstream.hxx>
  42 #include <simgear/props/props.hxx>
  43
  44 #include <AIModel/AIManager.hxx>
  45 #include <Main/fg_props.hxx>
  46 #include "multiplaymgr.hxx"
  47 #include "mpmessages.hxx"
  48
  49 using std::cerr;
  50
  51 #define MAX_PACKET_SIZE 1200
  52 #define MAX_TEXT_SIZE 128
  53
  54 // These constants are provided so that the ident
  55 // command can list file versions
  56 const char sMULTIPLAYMGR_BID[] = "$Id$";
  57 const char sMULTIPLAYMGR_HID[] = MULTIPLAYTXMGR_HID;
  58
  59 // A static map of protocol property id values to property paths,
  60 // This should be extendable dynamically for every specific aircraft ...
  61 // For now only that static list
  62 FGMultiplayMgr::IdPropertyList
  63 const FGMultiplayMgr::sIdPropertyList[] = {
  64   {100, "surface-positions/left-aileron-pos-norm",  SGPropertyNode::FLOAT},
  65   {101, "surface-positions/right-aileron-pos-norm", SGPropertyNode::FLOAT},
  66   {102, "surface-positions/elevator-pos-norm",      SGPropertyNode::FLOAT},
  67   {103, "surface-positions/rudder-pos-norm",        SGPropertyNode::FLOAT},
  68   {104, "surface-positions/flap-pos-norm",          SGPropertyNode::FLOAT},
  69   {105, "surface-positions/speedbrake-pos-norm",    SGPropertyNode::FLOAT},
  70   {106, "gear/tailhook/position-norm",              SGPropertyNode::FLOAT},
  71   {107, "gear/launchbar/position-norm",             SGPropertyNode::FLOAT},
  72   {108, "gear/launchbar/state",                     SGPropertyNode::STRING},
  73   {109, "gear/launchbar/holdback-position-norm",    SGPropertyNode::FLOAT},
  74   {110, "canopy/position-norm",                     SGPropertyNode::FLOAT},
  75   {111, "surface-positions/wing-pos-norm",          SGPropertyNode::FLOAT},
  76   {112, "surface-positions/wing-fold-pos-norm",     SGPropertyNode::FLOAT},
  77
  78   {200, "gear/gear[0]/compression-norm",           SGPropertyNode::FLOAT},
  79   {201, "gear/gear[0]/position-norm",              SGPropertyNode::FLOAT},
  80   {210, "gear/gear[1]/compression-norm",           SGPropertyNode::FLOAT},
  81   {211, "gear/gear[1]/position-norm",              SGPropertyNode::FLOAT},
  82   {220, "gear/gear[2]/compression-norm",           SGPropertyNode::FLOAT},
  83   {221, "gear/gear[2]/position-norm",              SGPropertyNode::FLOAT},
  84   {230, "gear/gear[3]/compression-norm",           SGPropertyNode::FLOAT},
  85   {231, "gear/gear[3]/position-norm",              SGPropertyNode::FLOAT},
  86   {240, "gear/gear[4]/compression-norm",           SGPropertyNode::FLOAT},
  87   {241, "gear/gear[4]/position-norm",              SGPropertyNode::FLOAT},
  88
  89   {300, "engines/engine[0]/n1",  SGPropertyNode::FLOAT},
  90   {301, "engines/engine[0]/n2",  SGPropertyNode::FLOAT},
  91   {302, "engines/engine[0]/rpm", SGPropertyNode::FLOAT},
  92   {310, "engines/engine[1]/n1",  SGPropertyNode::FLOAT},
  93   {311, "engines/engine[1]/n2",  SGPropertyNode::FLOAT},
  94   {312, "engines/engine[1]/rpm", SGPropertyNode::FLOAT},
  95   {320, "engines/engine[2]/n1",  SGPropertyNode::FLOAT},
  96   {321, "engines/engine[2]/n2",  SGPropertyNode::FLOAT},
  97   {322, "engines/engine[2]/rpm", SGPropertyNode::FLOAT},
  98   {330, "engines/engine[3]/n1",  SGPropertyNode::FLOAT},
  99   {331, "engines/engine[3]/n2",  SGPropertyNode::FLOAT},
 100   {332, "engines/engine[3]/rpm", SGPropertyNode::FLOAT},
 101   {340, "engines/engine[4]/n1",  SGPropertyNode::FLOAT},
 102   {341, "engines/engine[4]/n2",  SGPropertyNode::FLOAT},
 103   {342, "engines/engine[4]/rpm", SGPropertyNode::FLOAT},
 104   {350, "engines/engine[5]/n1",  SGPropertyNode::FLOAT},
 105   {351, "engines/engine[5]/n2",  SGPropertyNode::FLOAT},
 106   {352, "engines/engine[5]/rpm", SGPropertyNode::FLOAT},
 107   {360, "engines/engine[6]/n1",  SGPropertyNode::FLOAT},
 108   {361, "engines/engine[6]/n2",  SGPropertyNode::FLOAT},
 109   {362, "engines/engine[6]/rpm", SGPropertyNode::FLOAT},
 110   {370, "engines/engine[7]/n1",  SGPropertyNode::FLOAT},
 111   {371, "engines/engine[7]/n2",  SGPropertyNode::FLOAT},
 112   {372, "engines/engine[7]/rpm", SGPropertyNode::FLOAT},
 113   {380, "engines/engine[8]/n1",  SGPropertyNode::FLOAT},
 114   {381, "engines/engine[8]/n2",  SGPropertyNode::FLOAT},
 115   {382, "engines/engine[8]/rpm", SGPropertyNode::FLOAT},
 116   {390, "engines/engine[9]/n1",  SGPropertyNode::FLOAT},
 117   {391, "engines/engine[9]/n2",  SGPropertyNode::FLOAT},
 118   {392, "engines/engine[9]/rpm", SGPropertyNode::FLOAT},
 119
 120   {800, "rotors/main/rpm", SGPropertyNode::FLOAT},
 121   {801, "rotors/tail/rpm", SGPropertyNode::FLOAT},
 122   {810, "rotors/main/blade[0]/position-deg",  SGPropertyNode::FLOAT},
 123   {811, "rotors/main/blade[1]/position-deg",  SGPropertyNode::FLOAT},
 124   {812, "rotors/main/blade[2]/position-deg",  SGPropertyNode::FLOAT},
 125   {813, "rotors/main/blade[3]/position-deg",  SGPropertyNode::FLOAT},
 126   {820, "rotors/main/blade[0]/flap-deg",  SGPropertyNode::FLOAT},
 127   {821, "rotors/main/blade[1]/flap-deg",  SGPropertyNode::FLOAT},
 128   {822, "rotors/main/blade[2]/flap-deg",  SGPropertyNode::FLOAT},
 129   {823, "rotors/main/blade[3]/flap-deg",  SGPropertyNode::FLOAT},
 130   {830, "rotors/tail/blade[0]/position-deg",  SGPropertyNode::FLOAT},
 131   {831, "rotors/tail/blade[1]/position-deg",  SGPropertyNode::FLOAT},
 132
 133   {900, "sim/hitches/aerotow/tow/length",                       SGPropertyNode::FLOAT},
 134   {901, "sim/hitches/aerotow/tow/elastic-constant",             SGPropertyNode::FLOAT},
 135   {902, "sim/hitches/aerotow/tow/weight-per-m-kg-m",            SGPropertyNode::FLOAT},
 136   {903, "sim/hitches/aerotow/tow/dist",                         SGPropertyNode::FLOAT},
 137   {904, "sim/hitches/aerotow/tow/connected-to-property-node",   SGPropertyNode::BOOL},
 138   {905, "sim/hitches/aerotow/tow/connected-to-ai-or-mp-callsign",   SGPropertyNode::STRING},
 139   {906, "sim/hitches/aerotow/tow/brake-force",                  SGPropertyNode::FLOAT},
 140   {907, "sim/hitches/aerotow/tow/end-force-x",                  SGPropertyNode::FLOAT},
 141   {908, "sim/hitches/aerotow/tow/end-force-y",                  SGPropertyNode::FLOAT},
 142   {909, "sim/hitches/aerotow/tow/end-force-z",                  SGPropertyNode::FLOAT},
 143   {930, "sim/hitches/aerotow/is-slave",                         SGPropertyNode::BOOL},
 144   {931, "sim/hitches/aerotow/speed-in-tow-direction",           SGPropertyNode::FLOAT},
 145   {932, "sim/hitches/aerotow/open",                             SGPropertyNode::BOOL},
 146   {933, "sim/hitches/aerotow/local-pos-x",                      SGPropertyNode::FLOAT},
 147   {934, "sim/hitches/aerotow/local-pos-y",                      SGPropertyNode::FLOAT},
 148   {935, "sim/hitches/aerotow/local-pos-z",                      SGPropertyNode::FLOAT},
 149
 150   {1001, "controls/flight/slats",  SGPropertyNode::FLOAT},
 151   {1002, "controls/flight/speedbrake",  SGPropertyNode::FLOAT},
 152   {1003, "controls/flight/spoilers",  SGPropertyNode::FLOAT},
 153   {1004, "controls/gear/gear-down",  SGPropertyNode::FLOAT},
 154   {1005, "controls/lighting/nav-lights",  SGPropertyNode::FLOAT},
 155   {1006, "controls/armament/station[0]/jettison-all",  SGPropertyNode::BOOL},
 156
 157   {1100, "sim/model/variant", SGPropertyNode::INT},
 158   {1101, "sim/model/livery/file", SGPropertyNode::STRING},
 159
 160   {10001, "sim/multiplay/transmission-freq-hz",  SGPropertyNode::STRING},
 161   {10002, "sim/multiplay/chat",  SGPropertyNode::STRING},
 162
 163   {10100, "sim/multiplay/generic/string[0]", SGPropertyNode::STRING},
 164   {10101, "sim/multiplay/generic/string[1]", SGPropertyNode::STRING},
 165   {10102, "sim/multiplay/generic/string[2]", SGPropertyNode::STRING},
 166   {10103, "sim/multiplay/generic/string[3]", SGPropertyNode::STRING},
 167   {10104, "sim/multiplay/generic/string[4]", SGPropertyNode::STRING},
 168   {10105, "sim/multiplay/generic/string[5]", SGPropertyNode::STRING},
 169   {10106, "sim/multiplay/generic/string[6]", SGPropertyNode::STRING},
 170   {10107, "sim/multiplay/generic/string[7]", SGPropertyNode::STRING},
 171   {10108, "sim/multiplay/generic/string[8]", SGPropertyNode::STRING},
 172   {10109, "sim/multiplay/generic/string[9]", SGPropertyNode::STRING},
 173   {10110, "sim/multiplay/generic/string[10]", SGPropertyNode::STRING},
 174   {10111, "sim/multiplay/generic/string[11]", SGPropertyNode::STRING},
 175   {10112, "sim/multiplay/generic/string[12]", SGPropertyNode::STRING},
 176   {10113, "sim/multiplay/generic/string[13]", SGPropertyNode::STRING},
 177   {10114, "sim/multiplay/generic/string[14]", SGPropertyNode::STRING},
 178   {10115, "sim/multiplay/generic/string[15]", SGPropertyNode::STRING},
 179   {10116, "sim/multiplay/generic/string[16]", SGPropertyNode::STRING},
 180   {10117, "sim/multiplay/generic/string[17]", SGPropertyNode::STRING},
 181   {10118, "sim/multiplay/generic/string[18]", SGPropertyNode::STRING},
 182   {10119, "sim/multiplay/generic/string[19]", SGPropertyNode::STRING},
 183
 184   {10200, "sim/multiplay/generic/float[0]", SGPropertyNode::FLOAT},
 185   {10201, "sim/multiplay/generic/float[1]", SGPropertyNode::FLOAT},
 186   {10202, "sim/multiplay/generic/float[2]", SGPropertyNode::FLOAT},
 187   {10203, "sim/multiplay/generic/float[3]", SGPropertyNode::FLOAT},
 188   {10204, "sim/multiplay/generic/float[4]", SGPropertyNode::FLOAT},
 189   {10205, "sim/multiplay/generic/float[5]", SGPropertyNode::FLOAT},
 190   {10206, "sim/multiplay/generic/float[6]", SGPropertyNode::FLOAT},
 191   {10207, "sim/multiplay/generic/float[7]", SGPropertyNode::FLOAT},
 192   {10208, "sim/multiplay/generic/float[8]", SGPropertyNode::FLOAT},
 193   {10209, "sim/multiplay/generic/float[9]", SGPropertyNode::FLOAT},
 194   {10210, "sim/multiplay/generic/float[10]", SGPropertyNode::FLOAT},
 195   {10211, "sim/multiplay/generic/float[11]", SGPropertyNode::FLOAT},
 196   {10212, "sim/multiplay/generic/float[12]", SGPropertyNode::FLOAT},
 197   {10213, "sim/multiplay/generic/float[13]", SGPropertyNode::FLOAT},
 198   {10214, "sim/multiplay/generic/float[14]", SGPropertyNode::FLOAT},
 199   {10215, "sim/multiplay/generic/float[15]", SGPropertyNode::FLOAT},
 200   {10216, "sim/multiplay/generic/float[16]", SGPropertyNode::FLOAT},
 201   {10217, "sim/multiplay/generic/float[17]", SGPropertyNode::FLOAT},
 202   {10218, "sim/multiplay/generic/float[18]", SGPropertyNode::FLOAT},
 203   {10219, "sim/multiplay/generic/float[19]", SGPropertyNode::FLOAT},
 204
 205   {10300, "sim/multiplay/generic/int[0]", SGPropertyNode::INT},
 206   {10301, "sim/multiplay/generic/int[1]", SGPropertyNode::INT},
 207   {10302, "sim/multiplay/generic/int[2]", SGPropertyNode::INT},
 208   {10303, "sim/multiplay/generic/int[3]", SGPropertyNode::INT},
 209   {10304, "sim/multiplay/generic/int[4]", SGPropertyNode::INT},
 210   {10305, "sim/multiplay/generic/int[5]", SGPropertyNode::INT},
 211   {10306, "sim/multiplay/generic/int[6]", SGPropertyNode::INT},
 212   {10307, "sim/multiplay/generic/int[7]", SGPropertyNode::INT},
 213   {10308, "sim/multiplay/generic/int[8]", SGPropertyNode::INT},
 214   {10309, "sim/multiplay/generic/int[9]", SGPropertyNode::INT},
 215   {10310, "sim/multiplay/generic/int[10]", SGPropertyNode::INT},
 216   {10311, "sim/multiplay/generic/int[11]", SGPropertyNode::INT},
 217   {10312, "sim/multiplay/generic/int[12]", SGPropertyNode::INT},
 218   {10313, "sim/multiplay/generic/int[13]", SGPropertyNode::INT},
 219   {10314, "sim/multiplay/generic/int[14]", SGPropertyNode::INT},
 220   {10315, "sim/multiplay/generic/int[15]", SGPropertyNode::INT},
 221   {10316, "sim/multiplay/generic/int[16]", SGPropertyNode::INT},
 222   {10317, "sim/multiplay/generic/int[17]", SGPropertyNode::INT},
 223   {10318, "sim/multiplay/generic/int[18]", SGPropertyNode::INT},
 224   {10319, "sim/multiplay/generic/int[19]", SGPropertyNode::INT},
 225 };
 226
 227 const unsigned
 228 FGMultiplayMgr::numProperties = (sizeof(FGMultiplayMgr::sIdPropertyList)
 229                                  / sizeof(FGMultiplayMgr::sIdPropertyList[0]));
 230
 231 // Look up a property ID using binary search.
 232 namespace
 233 {
 234   struct ComparePropertyId
 235   {
 236     bool operator()(const FGMultiplayMgr::IdPropertyList& lhs,
 237                     const FGMultiplayMgr::IdPropertyList& rhs)
 238     {
 239       return lhs.id < rhs.id;
 240     }
 241     bool operator()(const FGMultiplayMgr::IdPropertyList& lhs,
 242                     unsigned id)
 243     {
 244       return lhs.id < id;
 245     }
 246     bool operator()(unsigned id,
 247                     const FGMultiplayMgr::IdPropertyList& rhs)
 248     {
 249       return id < rhs.id;
 250     }
 251   };
 252
 253 }
 254 const FGMultiplayMgr::IdPropertyList* FGMultiplayMgr::findProperty(unsigned id)
 255 {
 256   std::pair<const IdPropertyList*, const IdPropertyList*> result
 257     = std::equal_range(sIdPropertyList, sIdPropertyList + numProperties, id,
 258                        ComparePropertyId());
 259   if (result.first == result.second) {
 260     return 0;
 261   } else {
 262     return result.first;
 263   }
 264 }
 265
 266 namespace
 267 {
 268   bool verifyProperties(const xdr_data_t* data, const xdr_data_t* end)
 269   {
 270     const xdr_data_t* xdr = data;
 271     while (xdr < end) {
 272       unsigned id = XDR_decode_uint32(*xdr);
 273       const FGMultiplayMgr::IdPropertyList* plist
 274         = FGMultiplayMgr::findProperty(id);
 275
 276       if (plist) {
 277         xdr++;
 278         // How we decode the remainder of the property depends on the type
 279         switch (plist->type) {
 280         case SGPropertyNode::INT:
 281         case SGPropertyNode::BOOL:
 282         case SGPropertyNode::LONG:
 283           xdr++;
 284           break;
 285         case SGPropertyNode::FLOAT:
 286         case SGPropertyNode::DOUBLE:
 287           {
 288             float val = XDR_decode_float(*xdr);
 289             if (osg::isNaN(val))
 290               return false;
 291             xdr++;
 292             break;
 293           }
 294         case SGPropertyNode::STRING:
 295         case SGPropertyNode::UNSPECIFIED:
 296           {
 297             // String is complicated. It consists of
 298             // The length of the string
 299             // The string itself
 300             // Padding to the nearest 4-bytes.
 301             // XXX Yes, each byte is padded out to a word! Too late
 302             // to change...
 303             uint32_t length = XDR_decode_uint32(*xdr);
 304             xdr++;
 305             if ((length > 0) && (length < MAX_TEXT_SIZE)) {
 306               xdr += length;
 307               // Now handle the padding
 308               while ((length % 4) != 0)
 309                 {
 310                   xdr++;
 311                   length++;
 312                   //cout << "0";
 313                 }
 314             } else {
 315               // The string appears to be invalid; bail.
 316               return false;
 317             }
 318           }
 319           break;
 320         default:
 321           // cerr << "Unknown Prop type " << id << " " << type << "\n";
 322           xdr++;
 323           break;
 324         }
 325       }
 326       else {
 327         // give up; this is a malformed property list.
 328         return false;
 329       }
 330     }
 331     return true;
 332   }
 333 }
 334 //////////////////////////////////////////////////////////////////////
 335 //
 336 //  MultiplayMgr constructor
 337 //
 338 //////////////////////////////////////////////////////////////////////
 339 FGMultiplayMgr::FGMultiplayMgr()
 340 {
 341   mSocket        = 0;
 342   mInitialised   = false;
 343   mHaveServer    = false;
 344 } // FGMultiplayMgr::FGMultiplayMgr()
 345 //////////////////////////////////////////////////////////////////////
 346
 347 //////////////////////////////////////////////////////////////////////
 348 //
 349 //  MultiplayMgr destructor
 350 //
 351 //////////////////////////////////////////////////////////////////////
 352 FGMultiplayMgr::~FGMultiplayMgr()
 353 {
 354   Close();
 355 } // FGMultiplayMgr::~FGMultiplayMgr()
 356 //////////////////////////////////////////////////////////////////////
 357
 358 //////////////////////////////////////////////////////////////////////
 359 //
 360 //  Initialise object
 361 //
 362 //////////////////////////////////////////////////////////////////////
 363 bool
 364 FGMultiplayMgr::init (void)
 365 {
 366   //////////////////////////////////////////////////
 367   //  Initialise object if not already done
 368   //////////////////////////////////////////////////
 369   if (mInitialised) {
 370     SG_LOG(SG_NETWORK, SG_WARN, "FGMultiplayMgr::init - already initialised");
 371     return false;
 372   }
 373   //////////////////////////////////////////////////
 374   //  Set members from property values
 375   //////////////////////////////////////////////////
 376   short rxPort = fgGetInt("/sim/multiplay/rxport");
 377   string rxAddress = fgGetString("/sim/multiplay/rxhost");
 378   short txPort = fgGetInt("/sim/multiplay/txport");
 379   string txAddress = fgGetString("/sim/multiplay/txhost");
 380   mCallsign = fgGetString("/sim/multiplay/callsign");
 381   if (txPort > 0 && !txAddress.empty()) {
 382     mServer.set(txAddress.c_str(), txPort);
 383     if (strncmp (mServer.getHost(), "0.0.0.0", 8) == 0) {
 384       mHaveServer = false;
 385       SG_LOG(SG_NETWORK, SG_ALERT,
 386         "FGMultiplayMgr - could not resolve '"
 387         << txAddress << "', Multiplayermode disabled");
 388     } else {
 389       mHaveServer = true;
 390     }
 391     if (rxPort <= 0)
 392       rxPort = txPort;
 393   }
 394   if (rxPort <= 0) {
 395     SG_LOG(SG_NETWORK, SG_ALERT,
 396       "FGMultiplayMgr - No receiver port, Multiplayermode disabled");
 397     return (false);
 398   }
 399   if (mCallsign.empty())
 400     mCallsign = "JohnDoe"; // FIXME: use getpwuid
 401   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-txaddress= "<<txAddress);
 402   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-txport= "<<txPort );
 403   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-rxaddress="<<rxAddress );
 404   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-rxport= "<<rxPort);
 405   SG_LOG(SG_NETWORK,SG_INFO,"FGMultiplayMgr::init-callsign= "<<mCallsign);
 406   Close(); // Should Init be called twice, close Socket first
 407            // A memory leak was reported here by valgrind
 408   mSocket = new netSocket();
 409   if (!mSocket->open(false)) {
 410     SG_LOG( SG_NETWORK, SG_ALERT,
 411             "FGMultiplayMgr::init - Failed to create data socket" );
 412     return false;
 413   }
 414   mSocket->setBlocking(false);
 415   if (mSocket->bind(rxAddress.c_str(), rxPort) != 0) {
 416     perror("bind");
 417     SG_LOG( SG_NETWORK, SG_ALERT,
 418             "FGMultiplayMgr::Open - Failed to bind receive socket" );
 419     return false;
 420   }
 421   mInitialised = true;
 422   return true;
 423 } // FGMultiplayMgr::init()
 424 //////////////////////////////////////////////////////////////////////
 425
 426 //////////////////////////////////////////////////////////////////////
 427 //
 428 //  Closes and deletes the local player object. Closes
 429 //  and deletes the tx socket. Resets the object state to unitialised.
 430 //
 431 //////////////////////////////////////////////////////////////////////
 432 void
 433 FGMultiplayMgr::Close (void)
 434 {
 435   mMultiPlayerMap.clear();
 436
 437   if (mSocket) {
 438     mSocket->close();
 439     delete mSocket;
 440     mSocket = 0;
 441   }
 442   mInitialised = false;
 443 } // FGMultiplayMgr::Close(void)
 444 //////////////////////////////////////////////////////////////////////
 445
 446 //////////////////////////////////////////////////////////////////////
 447 //
 448 //  Description: Sends the position data for the local position.
 449 //
 450 //////////////////////////////////////////////////////////////////////
 451 void
 452 FGMultiplayMgr::SendMyPosition(const FGExternalMotionData& motionInfo)
 453 {
 454   if ((! mInitialised) || (! mHaveServer))
 455         return;
 456   if (! mHaveServer) {
 457     SG_LOG( SG_NETWORK, SG_ALERT, "FGMultiplayMgr::SendMyPosition - no server");
 458     return;
 459   }
 460
 461   T_PositionMsg PosMsg;
 462
 463   memset(&PosMsg, 0, sizeof(PosMsg));
 464   strncpy(PosMsg.Model, fgGetString("/sim/model/path"), MAX_MODEL_NAME_LEN);
 465   PosMsg.Model[MAX_MODEL_NAME_LEN - 1] = '\0';
 466
 467   PosMsg.time = XDR_encode_double (motionInfo.time);
 468   PosMsg.lag = XDR_encode_double (motionInfo.lag);
 469   for (unsigned i = 0 ; i < 3; ++i)
 470     PosMsg.position[i] = XDR_encode_double (motionInfo.position(i));
 471   SGVec3f angleAxis;
 472   motionInfo.orientation.getAngleAxis(angleAxis);
 473   for (unsigned i = 0 ; i < 3; ++i)
 474     PosMsg.orientation[i] = XDR_encode_float (angleAxis(i));
 475   for (unsigned i = 0 ; i < 3; ++i)
 476     PosMsg.linearVel[i] = XDR_encode_float (motionInfo.linearVel(i));
 477   for (unsigned i = 0 ; i < 3; ++i)
 478     PosMsg.angularVel[i] = XDR_encode_float (motionInfo.angularVel(i));
 479   for (unsigned i = 0 ; i < 3; ++i)
 480     PosMsg.linearAccel[i] = XDR_encode_float (motionInfo.linearAccel(i));
 481   for (unsigned i = 0 ; i < 3; ++i)
 482     PosMsg.angularAccel[i] = XDR_encode_float (motionInfo.angularAccel(i));
 483
 484   char Msg[MAX_PACKET_SIZE];
 485   memcpy(Msg + sizeof(T_MsgHdr), &PosMsg, sizeof(T_PositionMsg));
 486
 487   char* ptr = Msg + sizeof(T_MsgHdr) + sizeof(T_PositionMsg);
 488   std::vector<FGPropertyData*>::const_iterator it;
 489   it = motionInfo.properties.begin();
 490   //cout << "OUTPUT PROPERTIES\n";
 491   while (it != motionInfo.properties.end()
 492          && ptr + 2 * sizeof(xdr_data_t) < (Msg + MAX_PACKET_SIZE)) {
 493
 494     // First elements is the ID
 495     xdr_data_t xdr = XDR_encode_uint32((*it)->id);
 496     memcpy(ptr, &xdr, sizeof(xdr_data_t));
 497     ptr += sizeof(xdr_data_t);
 498
 499     // The actual data representation depends on the type
 500     switch ((*it)->type) {
 501       case SGPropertyNode::INT:
 502       case SGPropertyNode::BOOL:
 503       case SGPropertyNode::LONG:
 504         xdr = XDR_encode_uint32((*it)->int_value);
 505         memcpy(ptr, &xdr, sizeof(xdr_data_t));
 506         ptr += sizeof(xdr_data_t);
 507         //cout << "Prop:" << (*it)->id << " " << (*it)->type << " "<< (*it)->int_value << "\n";
 508         break;
 509       case SGPropertyNode::FLOAT:
 510       case SGPropertyNode::DOUBLE:
 511         xdr = XDR_encode_float((*it)->float_value);;
 512         memcpy(ptr, &xdr, sizeof(xdr_data_t));
 513         ptr += sizeof(xdr_data_t);
 514         //cout << "Prop:" << (*it)->id << " " << (*it)->type << " "<< (*it)->float_value << "\n";
 515         break;
 516       case SGPropertyNode::STRING:
 517       case SGPropertyNode::UNSPECIFIED:
 518         {
 519           // String is complicated. It consists of
 520           // The length of the string
 521           // The string itself
 522           // Padding to the nearest 4-bytes.
 523           const char* lcharptr = (*it)->string_value;
 524
 525           if (lcharptr != 0)
 526           {
 527             // Add the length
 528             ////cout << "String length: " << strlen(lcharptr) << "\n";
 529             uint32_t len = strlen(lcharptr);
 530             // XXX This should not be using 4 bytes per character!
 531             if (ptr + (1 + len + (4 - len % 4)) * sizeof (xdr_data_t)
 532                 >= (Msg + MAX_PACKET_SIZE))
 533                 goto escape;
 534             //cout << "String length unint32: " << len << "\n";
 535             xdr = XDR_encode_uint32(len);
 536             memcpy(ptr, &xdr, sizeof(xdr_data_t));
 537             ptr += sizeof(xdr_data_t);
 538
 539             if (len != 0)
 540             {
 541
 542               // Now the text itself
 543               // XXX This should not be using 4 bytes per character!
 544               int lcount = 0;
 545               while ((*lcharptr != '\0') && (lcount < MAX_TEXT_SIZE))
 546               {
 547                 xdr = XDR_encode_int8(*lcharptr);
 548                 memcpy(ptr, &xdr, sizeof(xdr_data_t));
 549                 ptr += sizeof(xdr_data_t);
 550                 lcharptr++;
 551                 lcount++;
 552               }
 553
 554               //cout << "Prop:" << (*it)->id << " " << (*it)->type << " " << len << " " << (*it)->string_value;
 555
 556               // Now pad if required
 557               while ((lcount % 4) != 0)
 558               {
 559                 xdr = XDR_encode_int8(0);
 560                 memcpy(ptr, &xdr, sizeof(xdr_data_t));
 561                 ptr += sizeof(xdr_data_t);
 562                 lcount++;
 563                 //cout << "0";
 564               }
 565
 566               //cout << "\n";
 567             }
 568           }
 569           else
 570           {
 571             // Nothing to encode
 572             xdr = XDR_encode_uint32(0);
 573             memcpy(ptr, &xdr, sizeof(xdr_data_t));
 574             ptr += sizeof(xdr_data_t);
 575             //cout << "Prop:" << (*it)->id << " " << (*it)->type << " 0\n";
 576           }
 577
 578         }
 579         break;
 580
 581       default:
 582         //cout << " Unknown Type: " << (*it)->type << "\n";
 583         xdr = XDR_encode_float((*it)->float_value);;
 584         memcpy(ptr, &xdr, sizeof(xdr_data_t));
 585         ptr += sizeof(xdr_data_t);
 586         //cout << "Prop:" << (*it)->id << " " << (*it)->type << " "<< (*it)->float_value << "\n";
 587         break;
 588     }
 589
 590     ++it;
 591   }
 592 escape:
 593
 594   T_MsgHdr MsgHdr;
 595   FillMsgHdr(&MsgHdr, POS_DATA_ID, ptr - Msg);
 596   memcpy(Msg, &MsgHdr, sizeof(T_MsgHdr));
 597
 598   mSocket->sendto(Msg, ptr - Msg, 0, &mServer);
 599   SG_LOG(SG_NETWORK, SG_DEBUG, "FGMultiplayMgr::SendMyPosition");
 600 } // FGMultiplayMgr::SendMyPosition()
 601 //////////////////////////////////////////////////////////////////////
 602
 603 //////////////////////////////////////////////////////////////////////
 604 //
 605 //  Name: SendTextMessage
 606 //  Description: Sends a message to the player. The message must
 607 //  contain a valid and correctly filled out header and optional
 608 //  message body.
 609 //
 610 //////////////////////////////////////////////////////////////////////
 611 void
 612 FGMultiplayMgr::SendTextMessage(const string &MsgText)
 613 {
 614   if (!mInitialised || !mHaveServer)
 615     return;
 616
 617   T_MsgHdr MsgHdr;
 618   FillMsgHdr(&MsgHdr, CHAT_MSG_ID);
 619   //////////////////////////////////////////////////
 620   // Divide the text string into blocks that fit
 621   // in the message and send the blocks.
 622   //////////////////////////////////////////////////
 623   unsigned iNextBlockPosition = 0;
 624   T_ChatMsg ChatMsg;
 625
 626   char Msg[sizeof(T_MsgHdr) + sizeof(T_ChatMsg)];
 627   while (iNextBlockPosition < MsgText.length()) {
 628     strncpy (ChatMsg.Text,
 629              MsgText.substr(iNextBlockPosition, MAX_CHAT_MSG_LEN - 1).c_str(),
 630              MAX_CHAT_MSG_LEN);
 631     ChatMsg.Text[MAX_CHAT_MSG_LEN - 1] = '\0';
 632     memcpy (Msg, &MsgHdr, sizeof(T_MsgHdr));
 633     memcpy (Msg + sizeof(T_MsgHdr), &ChatMsg, sizeof(T_ChatMsg));
 634     mSocket->sendto (Msg, sizeof(T_MsgHdr) + sizeof(T_ChatMsg), 0, &mServer);
 635     iNextBlockPosition += MAX_CHAT_MSG_LEN - 1;
 636
 637   }
 638
 639
 640 } // FGMultiplayMgr::SendTextMessage ()
 641 //////////////////////////////////////////////////////////////////////
 642
 643 //////////////////////////////////////////////////////////////////////
 644 //
 645 //  Name: ProcessData
 646 //  Description: Processes data waiting at the receive socket. The
 647 //  processing ends when there is no more data at the socket.
 648 //
 649 //////////////////////////////////////////////////////////////////////
 650 void
 651 FGMultiplayMgr::Update(void)
 652 {
 653   if (!mInitialised)
 654     return;
 655
 656   /// Just for expiry
 657   SGTimeStamp timestamper;
 658   timestamper.stamp();
 659   long stamp = timestamper.get_seconds();
 660
 661   //////////////////////////////////////////////////
 662   //  Read the receive socket and process any data
 663   //////////////////////////////////////////////////
 664   int bytes;
 665   do {
 666     char Msg[MAX_PACKET_SIZE];
 667     //////////////////////////////////////////////////
 668     //  Although the recv call asks for
 669     //  MAX_PACKET_SIZE of data, the number of bytes
 670     //  returned will only be that of the next
 671     //  packet waiting to be processed.
 672     //////////////////////////////////////////////////
 673     netAddress SenderAddress;
 674     bytes = mSocket->recvfrom(Msg, sizeof(Msg), 0, &SenderAddress);
 675     //////////////////////////////////////////////////
 676     //  no Data received
 677     //////////////////////////////////////////////////
 678     if (bytes <= 0) {
 679       if (errno != EAGAIN && errno != 0) // MSVC output "NoError" otherwise
 680         perror("FGMultiplayMgr::MP_ProcessData");
 681       break;
 682     }
 683     if (bytes <= sizeof(T_MsgHdr)) {
 684       SG_LOG( SG_NETWORK, SG_ALERT, "FGMultiplayMgr::MP_ProcessData - "
 685               << "received message with insufficient data" );
 686       break;
 687     }
 688     //////////////////////////////////////////////////
 689     //  Read header
 690     //////////////////////////////////////////////////
 691     T_MsgHdr* MsgHdr = (T_MsgHdr *)Msg;
 692     MsgHdr->Magic       = XDR_decode_uint32 (MsgHdr->Magic);
 693     MsgHdr->Version     = XDR_decode_uint32 (MsgHdr->Version);
 694     MsgHdr->MsgId       = XDR_decode_uint32 (MsgHdr->MsgId);
 695     MsgHdr->MsgLen      = XDR_decode_uint32 (MsgHdr->MsgLen);
 696     MsgHdr->ReplyPort   = XDR_decode_uint32 (MsgHdr->ReplyPort);
 697     if (MsgHdr->Magic != MSG_MAGIC) {
 698       SG_LOG( SG_NETWORK, SG_ALERT, "FGMultiplayMgr::MP_ProcessData - "
 699               << "message has invalid magic number!" );
 700       break;
 701     }
 702     if (MsgHdr->Version != PROTO_VER) {
 703       SG_LOG( SG_NETWORK, SG_ALERT, "FGMultiplayMgr::MP_ProcessData - "
 704               << "message has invalid protocoll number!" );
 705       break;
 706     }
 707     if (MsgHdr->MsgLen != bytes) {
 708       SG_LOG( SG_NETWORK, SG_ALERT, "FGMultiplayMgr::MP_ProcessData - "
 709               << "message has invalid length!" );
 710       break;
 711     }
 712     //////////////////////////////////////////////////
 713     //  Process messages
 714     //////////////////////////////////////////////////
 715     switch (MsgHdr->MsgId) {
 716     case CHAT_MSG_ID:
 717       ProcessChatMsg(Msg, SenderAddress);
 718       break;
 719     case POS_DATA_ID:
 720       ProcessPosMsg(Msg, SenderAddress, bytes, stamp);
 721       break;
 722     case UNUSABLE_POS_DATA_ID:
 723     case OLD_OLD_POS_DATA_ID:
 724     case OLD_PROP_MSG_ID:
 725     case OLD_POS_DATA_ID:
 726       break;
 727     default:
 728       SG_LOG( SG_NETWORK, SG_ALERT, "FGMultiplayMgr::MP_ProcessData - "
 729               << "Unknown message Id received: " << MsgHdr->MsgId );
 730       break;
 731     }
 732   } while (bytes > 0);
 733
 734   // check for expiry
 735   MultiPlayerMap::iterator it = mMultiPlayerMap.begin();
 736   while (it != mMultiPlayerMap.end()) {
 737     if (it->second->getLastTimestamp() + 10 < stamp) {
 738       std::string name = it->first;
 739       it->second->setDie(true);
 740       mMultiPlayerMap.erase(it);
 741       it = mMultiPlayerMap.upper_bound(name);
 742     } else
 743       ++it;
 744   }
 745 } // FGMultiplayMgr::ProcessData(void)
 746 //////////////////////////////////////////////////////////////////////
 747
 748 //////////////////////////////////////////////////////////////////////
 749 //
 750 //  handle a position message
 751 //
 752 //////////////////////////////////////////////////////////////////////
 753 void
 754 FGMultiplayMgr::ProcessPosMsg(const char *Msg, netAddress & SenderAddress,
 755                               unsigned len, long stamp)
 756 {
 757   T_MsgHdr* MsgHdr = (T_MsgHdr *)Msg;
 758   if (MsgHdr->MsgLen < sizeof(T_MsgHdr) + sizeof(T_PositionMsg)) {
 759     SG_LOG( SG_NETWORK, SG_ALERT, "FGMultiplayMgr::MP_ProcessData - "
 760             << "Position message received with insufficient data" );
 761     return;
 762   }
 763   T_PositionMsg* PosMsg = (T_PositionMsg *)(Msg + sizeof(T_MsgHdr));
 764   FGExternalMotionData motionInfo;
 765   motionInfo.time = XDR_decode_double(PosMsg->time);
 766   motionInfo.lag = XDR_decode_double(PosMsg->lag);
 767   for (unsigned i = 0; i < 3; ++i)
 768     motionInfo.position(i) = XDR_decode_double(PosMsg->position[i]);
 769   SGVec3f angleAxis;
 770   for (unsigned i = 0; i < 3; ++i)
 771     angleAxis(i) = XDR_decode_float(PosMsg->orientation[i]);
 772   motionInfo.orientation = SGQuatf::fromAngleAxis(angleAxis);
 773   for (unsigned i = 0; i < 3; ++i)
 774     motionInfo.linearVel(i) = XDR_decode_float(PosMsg->linearVel[i]);
 775   for (unsigned i = 0; i < 3; ++i)
 776     motionInfo.angularVel(i) = XDR_decode_float(PosMsg->angularVel[i]);
 777   for (unsigned i = 0; i < 3; ++i)
 778     motionInfo.linearAccel(i) = XDR_decode_float(PosMsg->linearAccel[i]);
 779   for (unsigned i = 0; i < 3; ++i)
 780     motionInfo.angularAccel(i) = XDR_decode_float(PosMsg->angularAccel[i]);
 781
 782
 783   //cout << "INPUT MESSAGE\n";
 784   xdr_data_t* xdr = (xdr_data_t*)
 785                    (Msg + sizeof(T_MsgHdr) + sizeof(T_PositionMsg));
 786   // There was a bug in 1.9.0 and before: T_PositionMsg was 196 bytes
 787   // on 32 bit architectures and 200 bytes on 64 bit, and this
 788   // structure is put directly on the wire. By looking at the padding,
 789   // we can sort through the mess, mostly:
 790   // If padding is 0 (which is not a valid property type), then the
 791   // message was produced by a new client or an old 64 bit client that
 792   // happened to have 0 on the stack;
 793   // Else if the property list starting with the padding word is
 794   // well-formed, then the client is probably an old 32 bit client and
 795   // we'll go with that;
 796   // Else it is an old 64-bit client and properties start after the
 797   // padding.
 798   // There is a chance that we could be fooled by garbage in the
 799   // padding looking like a valid property, so verifyProperties() is
 800   // strict about the validity of the property values.
 801   if (PosMsg->pad != 0) {
 802     if (verifyProperties(&PosMsg->pad,
 803                          reinterpret_cast<const xdr_data_t*>(Msg + len)))
 804       xdr = &PosMsg->pad;
 805     else if (!verifyProperties(xdr,
 806                                reinterpret_cast<const xdr_data_t*>(Msg + len)))
 807       goto noprops;
 808   }
 809   while ((char*)xdr < Msg + len) {
 810     FGPropertyData* pData = new FGPropertyData;
 811     SGPropertyNode::Type type = SGPropertyNode::UNSPECIFIED;
 812
 813     // First element is always the ID
 814     pData->id = XDR_decode_uint32(*xdr);
 815     //cout << pData->id << " ";
 816     xdr++;
 817
 818     // Check the ID actually exists and get the type
 819     const IdPropertyList* plist = findProperty(pData->id);
 820
 821     if (plist)
 822     {
 823       pData->type = plist->type;
 824       // How we decode the remainder of the property depends on the type
 825       switch (pData->type) {
 826         case SGPropertyNode::INT:
 827         case SGPropertyNode::BOOL:
 828         case SGPropertyNode::LONG:
 829           pData->int_value = XDR_decode_uint32(*xdr);
 830           xdr++;
 831           //cout << pData->int_value << "\n";
 832           break;
 833         case SGPropertyNode::FLOAT:
 834         case SGPropertyNode::DOUBLE:
 835           pData->float_value = XDR_decode_float(*xdr);
 836           xdr++;
 837           //cout << pData->float_value << "\n";
 838           break;
 839         case SGPropertyNode::STRING:
 840         case SGPropertyNode::UNSPECIFIED:
 841           {
 842             // String is complicated. It consists of
 843             // The length of the string
 844             // The string itself
 845             // Padding to the nearest 4-bytes.
 846             uint32_t length = XDR_decode_uint32(*xdr);
 847             xdr++;
 848             //cout << length << " ";
 849
 850             if ((length > 0) && (length < MAX_TEXT_SIZE))
 851             {
 852               pData->string_value = new char[length + 1];
 853               //cout << " String: ";
 854
 855               for (int i = 0; i < length; i++)
 856               {
 857                 pData->string_value[i] = (char) XDR_decode_int8(*xdr);
 858                 xdr++;
 859                 //cout << pData->string_value[i];
 860               }
 861
 862               pData->string_value[length] = '\0';
 863
 864               // Now handle the padding
 865               while ((length % 4) != 0)
 866               {
 867                 xdr++;
 868                 length++;
 869                 //cout << "0";
 870               }
 871             }
 872             else
 873             {
 874               pData->string_value = new char[1];
 875               pData->string_value[0] = '\0';
 876             }
 877
 878             //cout << "\n";
 879           }
 880           break;
 881
 882         default:
 883           pData->float_value = XDR_decode_float(*xdr);
 884           cerr << "Unknown Prop type " << pData->id << " " << pData->type << "\n";
 885           xdr++;
 886           break;
 887       }
 888
 889       motionInfo.properties.push_back(pData);
 890     }
 891     else
 892     {
 893       // We failed to find the property. We'll try the next packet immediately.
 894       SG_LOG(SG_NETWORK, SG_WARN, "FGMultiplayMgr::ProcessPosMsg - "
 895              << "found unknown property id" << pData->id);
 896     }
 897   }
 898  noprops:
 899   FGAIMultiplayer* mp = getMultiplayer(MsgHdr->Callsign);
 900   if (!mp)
 901     mp = addMultiplayer(MsgHdr->Callsign, PosMsg->Model);
 902   mp->addMotionInfo(motionInfo, stamp);
 903 } // FGMultiplayMgr::ProcessPosMsg()
 904 //////////////////////////////////////////////////////////////////////
 905
 906 //////////////////////////////////////////////////////////////////////
 907 //
 908 //  handle a chat message
 909 //  FIXME: display chat message withi flightgear
 910 //
 911 //////////////////////////////////////////////////////////////////////
 912 void
 913 FGMultiplayMgr::ProcessChatMsg(const char *Msg, netAddress& SenderAddress)
 914 {
 915   T_MsgHdr* MsgHdr = (T_MsgHdr *)Msg;
 916   if (MsgHdr->MsgLen < sizeof(T_MsgHdr) + 1) {
 917     SG_LOG( SG_NETWORK, SG_ALERT, "FGMultiplayMgr::MP_ProcessData - "
 918             << "Chat message received with insufficient data" );
 919     return;
 920   }
 921
 922   char *MsgBuf = new char[MsgHdr->MsgLen - sizeof(T_MsgHdr)];
 923   strncpy(MsgBuf, ((T_ChatMsg *)(Msg + sizeof(T_MsgHdr)))->Text,
 924           MsgHdr->MsgLen - sizeof(T_MsgHdr));
 925   MsgBuf[MsgHdr->MsgLen - sizeof(T_MsgHdr) - 1] = '\0';
 926
 927   T_ChatMsg* ChatMsg = (T_ChatMsg *)(Msg + sizeof(T_MsgHdr));
 928   SG_LOG (SG_NETWORK, SG_ALERT, "Chat [" << MsgHdr->Callsign << "]"
 929            << " " << MsgBuf);
 930
 931   delete [] MsgBuf;
 932 } // FGMultiplayMgr::ProcessChatMsg ()
 933 //////////////////////////////////////////////////////////////////////
 934
 935 void
 936 FGMultiplayMgr::FillMsgHdr(T_MsgHdr *MsgHdr, int MsgId, unsigned _len)
 937 {
 938   uint32_t len;
 939   switch (MsgId) {
 940   case CHAT_MSG_ID:
 941     len = sizeof(T_MsgHdr) + sizeof(T_ChatMsg);
 942     break;
 943   case POS_DATA_ID:
 944     len = _len;
 945     break;
 946   default:
 947     len = sizeof(T_MsgHdr);
 948     break;
 949   }
 950   MsgHdr->Magic           = XDR_encode_uint32(MSG_MAGIC);
 951   MsgHdr->Version         = XDR_encode_uint32(PROTO_VER);
 952   MsgHdr->MsgId           = XDR_encode_uint32(MsgId);
 953   MsgHdr->MsgLen          = XDR_encode_uint32(len);
 954   MsgHdr->ReplyAddress    = 0; // Are obsolete, keep them for the server for
 955   MsgHdr->ReplyPort       = 0; // now
 956   strncpy(MsgHdr->Callsign, mCallsign.c_str(), MAX_CALLSIGN_LEN);
 957   MsgHdr->Callsign[MAX_CALLSIGN_LEN - 1] = '\0';
 958 }
 959
 960 FGAIMultiplayer*
 961 FGMultiplayMgr::addMultiplayer(const std::string& callsign,
 962                                const std::string& modelName)
 963 {
 964   if (0 < mMultiPlayerMap.count(callsign))
 965     return mMultiPlayerMap[callsign].get();
 966
 967   FGAIMultiplayer* mp = new FGAIMultiplayer;
 968   mp->setPath(modelName.c_str());
 969   mp->setCallSign(callsign);
 970   mMultiPlayerMap[callsign] = mp;
 971
 972   FGAIManager *aiMgr = (FGAIManager*)globals->get_subsystem("ai_model");
 973   if (aiMgr) {
 974     aiMgr->attach(mp);
 975
 976     /// FIXME: that must follow the attach ATM ...
 977     for (unsigned i = 0; i < numProperties; ++i)
 978       mp->addPropertyId(sIdPropertyList[i].id, sIdPropertyList[i].name);
 979   }
 980
 981   return mp;
 982 }
 983
 984 FGAIMultiplayer*
 985 FGMultiplayMgr::getMultiplayer(const std::string& callsign)
 986 {
 987   if (0 < mMultiPlayerMap.count(callsign))
 988     return mMultiPlayerMap[callsign].get();
 989   else
 990     return 0;
 991 }