main.cpp 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571
  1. ////////////////////////////////////////////////////////////////////////////////////////////////////
  2. //
  3. #include <signal.h>
  4. #include <linux/limits.h>
  5. #include <unistd.h>
  6. #include <getopt.h>
  7. #include <gfa/gfaipc.h>
  8. #include <gfa/svc/common/strutil.h>
  9. #include <gfa/svc/common/logfile.h>
  10. #include <gfa/svc/common/fileutil.h>
  11. #include <gfa/svc/common/instance.h>
  12. #include <gfa/svc/common/processclock.h>
  13. #include <gfa/svc/common/debug.h>
  14. #include <gfa/svc/summarist/summarist.h>
  15. #include "projal.h"
  16. ////////////////////////////////////////////////////////////////////////////////////////////////////
  17. // app control
  18. #define _APPID GFA_APPCTRL_APPID_SUMMARIST
  19. #define _APPNAME "Summarist"
  20. //#define _DEPENDENCIES ((appid_t)(GFA_APPCTRL_APPID_REMANENT))
  21. #define _APP_CTRL_CYCLE_US 1000000
  22. ////////////////////////////////////////////////////////////////////////////////////////////////////
  23. //
  24. #define _TRACK_TIME 1
  25. #define _LOGFILE_NAME "summarist.log"
  26. #define _SIG_BLOCK(s) sigprocmask(SIG_BLOCK, (s), NULL)
  27. #define _SIG_UNBLOCK(s) sigprocmask(SIG_UNBLOCK, (s), NULL)
  28. #define _US_PER_SEC 1000000
  29. #ifdef _SUMMARIST_CU_SLEEP_INTERVAL
  30. #if _SUMMARIST_CU_SLEEP_INTERVAL < 10
  31. #define _CATCH_UP_SLEEP_INTERVAL 10000
  32. #else // _SUMMARIST_CU_SLEEP_INTERVAL < 10
  33. #define _CATCH_UP_SLEEP_INTERVAL (_SUMMARIST_CU_SLEEP_INTERVAL * 1000)
  34. #endif // _SUMMARIST_CU_SLEEP_INTERVAL < 10
  35. #else // _SUMMARIST_CU_SLEEP_INTERVAL
  36. #define _CATCH_UP_SLEEP_INTERVAL (_US_PER_SEC / 10)
  37. #endif // _SUMMARIST_CU_SLEEP_INTERVAL
  38. #if _TRACK_TIME
  39. #define _CLOCK_TRIGGER() g_pc.ClockTrigger(1)
  40. #define _CLOCK_TRACE(f) _TraceTime(f)
  41. #else // _TRACK_TIME
  42. #define _CLOCK_TRIGGER()
  43. #define _CLOCK_TRACE(f)
  44. #endif // _TRACK_TIME
  45. ////////////////////////////////////////////////////////////////////////////////////////////////////
  46. //
  47. static volatile bool g_fRun = false;
  48. static volatile bool g_fPauseImp = false;
  49. static volatile bool g_fPauseCmd = false;
  50. static volatile bool g_fZombie = false;
  51. //static appid_t g_nDepRunning = 0;
  52. static sigset_t g_set;
  53. static CLogfile g_lf;
  54. static int g_nLastSig = -1;
  55. static CProcessClock g_pc;
  56. ////////////////////////////////////////////////////////////////////////////////////////////////////
  57. //
  58. static const char* _GetBaseDir(std::string &rstrBaseDir)
  59. {
  60. char szBaseDir[PATH_MAX];
  61. const char *pszBaseDir = NULL;
  62. #ifdef _LOG_BASE_DIR
  63. pszBaseDir = _LOG_BASE_DIR;
  64. if(!pszBaseDir || !*pszBaseDir || !::DirectoryExist(pszBaseDir))
  65. {
  66. CLogfile::StdErr("Invalid base directory config! Using app directory!\n");
  67. pszBaseDir = ::GetAppDirectory(szBaseDir, sizeof(szBaseDir));
  68. }
  69. rstrBaseDir = pszBaseDir;
  70. #else // _LOG_BASE_DIR
  71. UNUSED(pszBaseDir);
  72. rstrBaseDir = ::GetAppDirectory(szBaseDir, sizeof(szBaseDir));
  73. #endif // _LOG_BASE_DIR
  74. rtrim(rstrBaseDir, "/");
  75. return rstrBaseDir.c_str();
  76. }
  77. ////////////////////////////////////////////////////////////////////////////////////////////////////
  78. //
  79. static void _SigHandler(int sig)
  80. {
  81. g_nLastSig = sig;
  82. g_fRun = g_fPauseImp = g_fPauseCmd = g_fZombie = false;
  83. }
  84. ////////////////////////////////////////////////////////////////////////////////////////////////////
  85. //
  86. #if _TRACK_TIME
  87. static void _TraceTime(const char *pszMsg)
  88. {
  89. TRACE("%s (%s).\n", pszMsg ? pszMsg : "", CProcessClock::Interval2String(g_pc.ClockGetElapsed(1)).c_str());
  90. }
  91. #endif // _TRACK_TIME
  92. ////////////////////////////////////////////////////////////////////////////////////////////////////
  93. static void _ProcessCtrlMessages(HAPPCTRL hAC, HAPPINFO hAI)
  94. {
  95. ctrlmsg_t nCtrlMsg;
  96. while(g_fRun && (nCtrlMsg = ::GfaIpcAppCtrlGetNextCtrlMsg(hAI)))
  97. {
  98. switch(nCtrlMsg)
  99. {
  100. case GFA_APPCTRL_CTRLMSG_STOP:
  101. g_fRun = false;
  102. g_fPauseImp = false;
  103. g_fPauseCmd = false;
  104. g_fZombie = false;
  105. g_lf.Info("Received Control Message 'Stop'\n");
  106. return;
  107. case GFA_APPCTRL_CTRLMSG_PAUSE:
  108. if(!g_fPauseCmd)
  109. {
  110. g_fPauseCmd = true;
  111. if(!g_fPauseImp)
  112. {
  113. ::GfaIpcAppCtrlSetState(hAC, GIAS_Paused);
  114. g_lf.Info("Received Control Message 'Pause'\n");
  115. g_lf.Info("Enter state %s ...\n", ::GfaIpcAppCtrlGetStateText(GIAS_Paused));
  116. TRACE("%-8s: State: %s\n", "Me", ::GfaIpcAppCtrlGetStateText(GIAS_Paused));
  117. }
  118. }
  119. break;
  120. case GFA_APPCTRL_CTRLMSG_RESUME:
  121. if(g_fPauseCmd)
  122. {
  123. g_fPauseCmd = false;
  124. if(!g_fPauseImp)
  125. {
  126. g_lf.Info("Received Control Message 'Resume'\n");
  127. g_lf.Info("Enter state %s ...\n", ::GfaIpcAppCtrlGetStateText(GIAS_Running));
  128. ::GfaIpcAppCtrlSetState(hAC, GIAS_Running);
  129. TRACE("%-8s: State: %s\n", "Me", ::GfaIpcAppCtrlGetStateText(GIAS_Running));
  130. }
  131. }
  132. break;
  133. default:
  134. break;
  135. }
  136. }
  137. }
  138. ////////////////////////////////////////////////////////////////////////////////////////////////////
  139. /*
  140. static void _ProcessStateEvents(HAPPCTRL hAC, HAPPINFO hAI)
  141. {
  142. appid_t nAppIdSrc;
  143. bool fOldPaused = g_fPauseImp;
  144. char szDispName[128];
  145. while(g_fRun && (nAppIdSrc = ::GfaIpcAppCtrlGetNextStateEvtSrc(hAI)))
  146. {
  147. GfaIpcAppStates state = ::GfaIpcAppCtrlGetState(hAC, nAppIdSrc);
  148. GfaIpcAppCtrlGetDisplayName(hAC, nAppIdSrc, szDispName, sizeof(szDispName));
  149. TRACE("%-8s: State: %s\n", szDispName, ::GfaIpcAppCtrlGetStateText(state));
  150. if(nAppIdSrc & _DEPENDENCIES)
  151. {
  152. if(state == GIAS_Running)
  153. {
  154. g_lf.Info("%s -> %s.\n", szDispName, ::GfaIpcAppCtrlGetStateText(state));
  155. g_nDepRunning |= nAppIdSrc;
  156. }
  157. else
  158. {
  159. g_lf.Warning("%s -> %s.\n", szDispName, ::GfaIpcAppCtrlGetStateText(state));
  160. g_nDepRunning &= ~nAppIdSrc;
  161. }
  162. }
  163. }
  164. if(g_fRun)
  165. {
  166. g_fPauseImp = (g_nDepRunning != _DEPENDENCIES);
  167. if(!g_fPauseCmd && (fOldPaused != g_fPauseImp))
  168. {
  169. fOldPaused = g_fPauseImp;
  170. GfaIpcAppStates newState = g_fPauseImp ? GIAS_Paused : GIAS_Running;
  171. ::GfaIpcAppCtrlSetState(hAC, newState);
  172. if(g_fPauseImp)
  173. g_lf.Warning("Enter state %s ...\n", ::GfaIpcAppCtrlGetStateText(newState));
  174. else
  175. g_lf.Info("Enter state %s ...\n", ::GfaIpcAppCtrlGetStateText(newState));
  176. }
  177. }
  178. }*/
  179. void _AppCtrlUsleep(HAPPCTRL hAC, unsigned long nUsSleep, unsigned long long nUsWorkTime)
  180. {
  181. HAPPINFO hAI;
  182. while(nUsSleep > _APP_CTRL_CYCLE_US)
  183. {
  184. nUsSleep -= _APP_CTRL_CYCLE_US;
  185. usleep(_APP_CTRL_CYCLE_US);
  186. if((hAI = ::GfaIpcAppCtrlInfoUpdate(hAC, nUsWorkTime)))
  187. {
  188. _ProcessCtrlMessages(hAC, hAI);
  189. if(!g_fRun)
  190. return;
  191. // _ProcessStateEvents(hAC, hAI);
  192. }
  193. }
  194. if(nUsSleep)
  195. {
  196. usleep(nUsSleep);
  197. }
  198. }
  199. ////////////////////////////////////////////////////////////////////////////////////////////////////
  200. //
  201. int main(int argc, char **argv)
  202. {
  203. CProcessInstance pi;
  204. HAPPCTRL hAC = NULL;
  205. HAPPINFO hAI;
  206. char szLogFile[PATH_MAX];
  207. std::string strBaseDir;
  208. const char *pszBaseDir = NULL;
  209. bool bDropTables = false;
  210. int c, ca;
  211. CProcessClock pcWork;
  212. unsigned long long nUsWorkTime = 0;
  213. ////////////////////////////////////////////////////////////////////////////////////////////////
  214. // check for multiple instances
  215. if(!pi.LockInstance(UUID_SHM))
  216. {
  217. CLogfile::StdErr("Failed to start instance!\n");
  218. return -1;
  219. }
  220. ////////////////////////////////////////////////////////////////////////////////////////////////
  221. while((c = getopt(argc, argv, "d:")) != -1)
  222. {
  223. switch(c)
  224. {
  225. case 'd':
  226. if((ca = atoi(optarg)) == 666)
  227. bDropTables = true;
  228. break;
  229. }
  230. }
  231. ////////////////////////////////////////////////////////////////////////////////////////////////
  232. // configure signal handling
  233. struct sigaction sa;
  234. ::sigfillset(&g_set);
  235. sigaddset(&g_set, SIGUSR1);
  236. memset(&sa, 0, sizeof(sa));
  237. sa.sa_handler = _SigHandler;
  238. sigaction(SIGHUP, &sa, NULL); // handles user's terminal disconnect
  239. sigaction(SIGQUIT, &sa, NULL); // handles Ctrl + '\'
  240. sigaction(SIGTERM, &sa, NULL); // handles normal termination
  241. sigaction(SIGABRT, &sa, NULL); // handles abnormal termination (i.e. abort())
  242. sigaction(SIGINT, &sa, NULL); // handles Ctrl + 'C'
  243. sa.sa_handler = SIG_IGN;
  244. sigaction(SIGTSTP, &sa, NULL); // ignores Ctrl + 'Z'
  245. sigaction(SIGSTOP, &sa, NULL); // ignores Stop
  246. sigaction(SIGCONT, &sa, NULL); // ignores Continue
  247. sigaction(SIGCHLD, &sa, NULL); // ignores child process termination
  248. sigaction(0, &sa, NULL); // ignores shell termination
  249. do
  250. {
  251. g_fZombie = true;
  252. ////////////////////////////////////////////////////////////////////////////////////////////
  253. // get the base directory for output files
  254. if(!pszBaseDir)
  255. pszBaseDir = _GetBaseDir(strBaseDir);
  256. CLogfile::StdOut("Using base directory \"%s\".\n", pszBaseDir);
  257. ////////////////////////////////////////////////////////////////////////////////////////////
  258. // initialize log file
  259. sprintf(szLogFile, "%s/%s", pszBaseDir, _LOGFILE_NAME);
  260. if(!g_lf.Open(szLogFile))
  261. {
  262. CLogfile::StdErr("Failed to create/open log file!\n");
  263. break;
  264. }
  265. #if _SUMMARIST_ENABLED
  266. g_lf.Info("Process started.\n");
  267. ////////////////////////////////////////////////////////////////////////////////////////////
  268. // initialize app control
  269. g_lf.Info("Acquire AppCtrl-Handle.\n");
  270. if(!(hAC = ::GfaIpcAppCtrlAcquire(_APPID, _APPNAME, _APP_CTRL_CYCLE_US, _APP_CTRL_CYCLE_US * 3)))
  271. {
  272. g_lf.Error("Failed to acquire AppCtrl-Handle!\n");
  273. break;
  274. }
  275. ::GfaIpcAppCtrlSetState(hAC, GIAS_Initializing);
  276. g_lf.Info("Enter state %s ...\n", ::GfaIpcAppCtrlGetStateText(GIAS_Initializing));
  277. /* if(!::GfaIpcAppCtrlSubscribeStateEvents(hAC, _DEPENDENCIES))
  278. {
  279. g_lf.Error("Failed to subscribe state event notifications!\n");
  280. break;
  281. }*/
  282. ////////////////////////////////////////////////////////////////////////////////////////////
  283. if(strlen(_DLOG_DB_NAME) >= _SUM_MAX_DB_NAME_LENGTH)
  284. {
  285. g_lf.Error("Database name too long!\n");
  286. break;
  287. }
  288. if(strlen(_DLOG_DB_USER) >= _SUM_MAX_DB_USER_LENGTH)
  289. {
  290. g_lf.Error("Database username too long!\n");
  291. break;
  292. }
  293. if(strlen(_DLOG_DB_PASS) >= _SUM_MAX_DB_PASS_LENGTH)
  294. {
  295. g_lf.Error("Database password too long!\n");
  296. break;
  297. }
  298. if(strlen(_DLOG_TAGS_TABLE) >= _SUM_MAX_TABLE_NAME_LENGTH)
  299. {
  300. g_lf.Error("Tag table name too long!\n");
  301. break;
  302. }
  303. if(strlen(_DLOG_LOGS_TABLE) >= _SUM_MAX_TABLE_NAME_LENGTH)
  304. {
  305. g_lf.Error("Log table name too long!\n");
  306. break;
  307. }
  308. ////////////////////////////////////////////////////////////////////////////////////////////
  309. // initialize summarist
  310. SUMMARIST_PARAMS sup;
  311. memset(&sup, 0, sizeof(sup));
  312. strncpy(sup.szDBName, _DLOG_DB_NAME, _SUM_MAX_DB_NAME_LENGTH - 1);
  313. strncpy(sup.szDBUser, _DLOG_DB_USER, _SUM_MAX_DB_USER_LENGTH - 1);
  314. strncpy(sup.szDBPass, _DLOG_DB_PASS, _SUM_MAX_DB_PASS_LENGTH - 1);
  315. strncpy(sup.szTagsTable, _DLOG_TAGS_TABLE, _SUM_MAX_TABLE_NAME_LENGTH - 1);
  316. strncpy(sup.szLogsTable, _DLOG_LOGS_TABLE, _SUM_MAX_TABLE_NAME_LENGTH - 1);
  317. strcpy(sup.szITagsView, "ilTags");
  318. sup.nSampleIntv = _DLOG_INTV_SAMPLE;
  319. sup.nLogIntv = _DLOG_INTV_LOG;
  320. sup.nWriteIntv = _DLOG_INTV_WRITE;
  321. CSummarist sum(&sup, g_lf);
  322. if(!sum.Initialze(g_timeWnds, _countof(g_timeWnds), bDropTables))
  323. break;
  324. else if(bDropTables)
  325. {
  326. g_fZombie = false;
  327. break;
  328. }
  329. ////////////////////////////////////////////////////////////////////////////////////////////
  330. // do work
  331. CMySqlDB db;
  332. time_t tsMinLogs, tsMaxLogs, tsBase, tsNext;
  333. #if _SUMMARIST_PROCESS_OUTDATED
  334. time_t tsLastOutdated = 0;
  335. #endif // _SUMMARIST_PROCESS_OUTDATED
  336. g_fZombie = false;
  337. g_fRun = true;
  338. ::GfaIpcAppCtrlSetState(hAC, GIAS_Running);
  339. g_lf.Info("Enter state %s ...\n", ::GfaIpcAppCtrlGetStateText(GIAS_Running));
  340. while(g_fRun)
  341. {
  342. ////////////////////////////////////////////////////////////////////////////////////////
  343. // update app control info
  344. if((hAI = ::GfaIpcAppCtrlInfoUpdate(hAC, nUsWorkTime)))
  345. {
  346. _ProcessCtrlMessages(hAC, hAI);
  347. if(!g_fRun)
  348. break;
  349. // _ProcessStateEvents(hAC, hAI);
  350. }
  351. ////////////////////////////////////////////////////////////////////////////////////////
  352. if(!g_fPauseImp && !g_fPauseCmd)
  353. {
  354. if(sum.Connect(db))
  355. {
  356. pcWork.ClockTrigger();
  357. unsigned long nUsSleep = sum.GetProcessingFrequenzy() * _US_PER_SEC;
  358. if(sum.GetMinMaxTimestampFromLogs(db, tsMinLogs, tsMaxLogs))
  359. {
  360. if((tsMinLogs != _SUM_INVALID_TIMESTAMP_VALUE) && (tsMaxLogs != _SUM_INVALID_TIMESTAMP_VALUE))
  361. {
  362. tsBase = sum.GetBaseTimestamp(tsMinLogs);
  363. for(size_t i = 0; (i < sum.TimeWndCount()) && g_fRun; ++i)
  364. {
  365. time_t tSumLast, tWndFrom, tWndTo;
  366. if(!sum.GetLastSummarizeTimestamp(db, i, tSumLast))
  367. {
  368. g_fZombie = true;
  369. g_fRun = false;
  370. break;
  371. }
  372. if(sum.GetNextTimeFrame(db, i, tSumLast, tsBase, tWndFrom, tWndTo))
  373. {
  374. if((tWndFrom <= tsMaxLogs) && (tWndTo <= time(NULL)))
  375. {
  376. _SIG_BLOCK(&g_set);
  377. _CLOCK_TRIGGER();
  378. if(g_fRun)
  379. g_fRun = sum.Summarize(db, i, tWndFrom, tWndTo);
  380. _CLOCK_TRACE("Summarize");
  381. _SIG_UNBLOCK(&g_set);
  382. }
  383. sum.SetNextTimeFrameStart(i, tWndTo);
  384. }
  385. }
  386. if((tsNext = sum.GetNextDueTimeFrameStart()) != _SUM_INVALID_TIMESTAMP_VALUE)
  387. {
  388. time_t tsNow = time(NULL);
  389. if(tsNext > tsNow)
  390. nUsSleep = ((tsNext - tsNow) + 1) * _US_PER_SEC;
  391. else if(tsNext < tsMaxLogs)
  392. nUsSleep = _CATCH_UP_SLEEP_INTERVAL;
  393. }
  394. #if _SUMMARIST_PROCESS_OUTDATED
  395. if(g_fRun && (nUsSleep > _CATCH_UP_SLEEP_INTERVAL) && (tsLastOutdated < tsMinLogs)) // not in catch-up mode
  396. {
  397. g_pc.ClockTrigger();
  398. pc_time64_t nElapsed;
  399. for(size_t i = 0; g_fRun && (i < sum.TimeWndCount()); ++i)
  400. {
  401. _SIG_BLOCK(&g_set);
  402. _CLOCK_TRIGGER();
  403. sum.ProcessOutdated(db, i, tsMinLogs);
  404. _CLOCK_TRACE("ProcessOutdated");
  405. _SIG_UNBLOCK(&g_set);
  406. }
  407. nElapsed = g_pc.ClockGetElapsed() / 1000LL;
  408. if((pc_time64_t)nUsSleep > nElapsed)
  409. nUsSleep -= (unsigned long)nElapsed;
  410. tsLastOutdated = tsMinLogs;
  411. }
  412. #endif // _SUMMARIST_PROCESS_OUTDATED
  413. }
  414. else
  415. {
  416. TRACE("GetMinMaxTimestampFromLogs: timestamps invalid - no logs so far?\n");
  417. g_lf.Warning("GetMinMaxTimestampFromLogs: timestamps invalid - no logs so far?\n");
  418. }
  419. }
  420. else
  421. {
  422. TRACE("GetMinMaxTimestampFromLogs failed!\n");
  423. g_fZombie = true;
  424. g_fRun = false;
  425. }
  426. sum.Close(db);
  427. nUsWorkTime = pcWork.ClockGetElapsed() / 1000;
  428. if(g_fRun)
  429. {
  430. TRACE("Sleep: %s ...\n", CProcessClock::Interval2String((pc_time64_t)nUsSleep * 1000LL).c_str());
  431. _AppCtrlUsleep(hAC, nUsSleep, nUsWorkTime);
  432. }
  433. }
  434. else
  435. {
  436. TRACE("Database connection failed!\n");
  437. g_fZombie = true;
  438. g_fRun = false;
  439. }
  440. }
  441. else
  442. {
  443. _AppCtrlUsleep(hAC, _APP_CTRL_CYCLE_US, 0);
  444. }
  445. } // while(g_fRun)
  446. }
  447. while(false);
  448. ////////////////////////////////////////////////////////////////////////////////////////////////
  449. if(g_nLastSig >= 0)
  450. {
  451. g_lf.Info("Received signal '%s'.\n", strsignal(g_nLastSig));
  452. g_nLastSig = -1;
  453. }
  454. if(g_fZombie)
  455. {
  456. if(hAC)
  457. ::GfaIpcAppCtrlSetState(hAC, GIAS_Zombie);
  458. TRACE("Enter Zombie state ...\n");
  459. g_lf.Warning("Enter Zombie state ...\n");
  460. g_lf.Flush();
  461. pause();
  462. if(g_nLastSig >= 0)
  463. g_lf.Info("Received signal '%s'.\n", strsignal(g_nLastSig));
  464. }
  465. if(hAC)
  466. {
  467. g_lf.Info("Enter state %s ...\n", ::GfaIpcAppCtrlGetStateText(GIAS_Terminating));
  468. ::GfaIpcAppCtrlSetState(hAC, GIAS_Terminating);
  469. g_lf.Info("Releasing App Control ...\n");
  470. ::GfaIpcAppCtrlRelease(hAC);
  471. }
  472. g_lf.Info("Normal process exit.\n\n");
  473. g_lf.Close();
  474. CLogfile::StdErr("Summarist exit.\n");
  475. return 0;
  476. #else // _SUMMARIST_ENABLED
  477. g_lf.Info("Summarist disabled!\n");
  478. return -1;
  479. #endif // _SUMMARIST_ENABLED
  480. }