| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 1 | /* | 
|  | 2 | * Copyright (C) 2014 The Android Open Source Project | 
|  | 3 | * | 
|  | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); | 
|  | 5 | * you may not use this file except in compliance with the License. | 
|  | 6 | * You may obtain a copy of the License at | 
|  | 7 | * | 
|  | 8 | *      http://www.apache.org/licenses/LICENSE-2.0 | 
|  | 9 | * | 
|  | 10 | * Unless required by applicable law or agreed to in writing, software | 
|  | 11 | * distributed under the License is distributed on an "AS IS" BASIS, | 
|  | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 
|  | 13 | * See the License for the specific language governing permissions and | 
|  | 14 | * limitations under the License. | 
|  | 15 | */ | 
|  | 16 |  | 
| Mark Salyzyn | b75cce0 | 2015-11-30 11:35:56 -0800 | [diff] [blame] | 17 | #include <errno.h> | 
| Mark Salyzyn | 8daa9af | 2014-04-28 14:07:23 -0700 | [diff] [blame] | 18 | #include <sys/prctl.h> | 
|  | 19 |  | 
| Mark Salyzyn | 5a34d6e | 2017-03-10 08:44:14 -0800 | [diff] [blame] | 20 | #include <private/android_logger.h> | 
|  | 21 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 22 | #include "FlushCommand.h" | 
|  | 23 | #include "LogBuffer.h" | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 24 | #include "LogReader.h" | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 25 | #include "LogTimes.h" | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 26 |  | 
|  | 27 | pthread_mutex_t LogTimeEntry::timesLock = PTHREAD_MUTEX_INITIALIZER; | 
|  | 28 |  | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 29 | LogTimeEntry::LogTimeEntry(LogReader& reader, SocketClient* client, | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 30 | bool nonBlock, unsigned long tail, | 
| Mark Salyzyn | 5a34d6e | 2017-03-10 08:44:14 -0800 | [diff] [blame] | 31 | unsigned int logMask, pid_t pid, log_time start, | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 32 | uint64_t timeout) | 
|  | 33 | : mRefCount(1), | 
|  | 34 | mRelease(false), | 
|  | 35 | mError(false), | 
|  | 36 | threadRunning(false), | 
|  | 37 | leadingDropped(false), | 
|  | 38 | mReader(reader), | 
|  | 39 | mLogMask(logMask), | 
|  | 40 | mPid(pid), | 
|  | 41 | mCount(0), | 
|  | 42 | mTail(tail), | 
|  | 43 | mIndex(0), | 
|  | 44 | mClient(client), | 
|  | 45 | mStart(start), | 
|  | 46 | mNonBlock(nonBlock), | 
| Mark Salyzyn | 5a34d6e | 2017-03-10 08:44:14 -0800 | [diff] [blame] | 47 | mEnd(log_time(android_log_clockid())) { | 
| Mark Salyzyn | b75cce0 | 2015-11-30 11:35:56 -0800 | [diff] [blame] | 48 | mTimeout.tv_sec = timeout / NS_PER_SEC; | 
|  | 49 | mTimeout.tv_nsec = timeout % NS_PER_SEC; | 
| Mark Salyzyn | 7718778 | 2015-05-12 15:21:31 -0700 | [diff] [blame] | 50 | pthread_cond_init(&threadTriggeredCondition, NULL); | 
|  | 51 | cleanSkip_Locked(); | 
| Mark Salyzyn | a16f761 | 2014-08-07 08:16:52 -0700 | [diff] [blame] | 52 | } | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 53 |  | 
|  | 54 | void LogTimeEntry::startReader_Locked(void) { | 
| Mark Salyzyn | 765f782 | 2014-04-04 12:47:44 -0700 | [diff] [blame] | 55 | pthread_attr_t attr; | 
|  | 56 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 57 | threadRunning = true; | 
| Mark Salyzyn | 765f782 | 2014-04-04 12:47:44 -0700 | [diff] [blame] | 58 |  | 
|  | 59 | if (!pthread_attr_init(&attr)) { | 
|  | 60 | if (!pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED)) { | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 61 | if (!pthread_create(&mThread, &attr, LogTimeEntry::threadStart, | 
|  | 62 | this)) { | 
| Mark Salyzyn | 765f782 | 2014-04-04 12:47:44 -0700 | [diff] [blame] | 63 | pthread_attr_destroy(&attr); | 
|  | 64 | return; | 
|  | 65 | } | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 66 | } | 
| Mark Salyzyn | 765f782 | 2014-04-04 12:47:44 -0700 | [diff] [blame] | 67 | pthread_attr_destroy(&attr); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 68 | } | 
| Mark Salyzyn | 765f782 | 2014-04-04 12:47:44 -0700 | [diff] [blame] | 69 | threadRunning = false; | 
|  | 70 | if (mClient) { | 
|  | 71 | mClient->decRef(); | 
|  | 72 | } | 
|  | 73 | decRef_Locked(); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 74 | } | 
|  | 75 |  | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 76 | void LogTimeEntry::threadStop(void* obj) { | 
|  | 77 | LogTimeEntry* me = reinterpret_cast<LogTimeEntry*>(obj); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 78 |  | 
|  | 79 | lock(); | 
|  | 80 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 81 | if (me->mNonBlock) { | 
|  | 82 | me->error_Locked(); | 
|  | 83 | } | 
|  | 84 |  | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 85 | SocketClient* client = me->mClient; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 86 |  | 
|  | 87 | if (me->isError_Locked()) { | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 88 | LogReader& reader = me->mReader; | 
|  | 89 | LastLogTimes& times = reader.logbuf().mTimes; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 90 |  | 
|  | 91 | LastLogTimes::iterator it = times.begin(); | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 92 | while (it != times.end()) { | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 93 | if (*it == me) { | 
|  | 94 | times.erase(it); | 
| Mark Salyzyn | c348416 | 2016-03-01 14:59:32 -0800 | [diff] [blame] | 95 | me->release_nodelete_Locked(); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 96 | break; | 
|  | 97 | } | 
|  | 98 | it++; | 
|  | 99 | } | 
|  | 100 |  | 
|  | 101 | me->mClient = NULL; | 
|  | 102 | reader.release(client); | 
|  | 103 | } | 
|  | 104 |  | 
|  | 105 | if (client) { | 
|  | 106 | client->decRef(); | 
|  | 107 | } | 
|  | 108 |  | 
| Mark Salyzyn | a16f761 | 2014-08-07 08:16:52 -0700 | [diff] [blame] | 109 | me->threadRunning = false; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 110 | me->decRef_Locked(); | 
|  | 111 |  | 
|  | 112 | unlock(); | 
|  | 113 | } | 
|  | 114 |  | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 115 | void* LogTimeEntry::threadStart(void* obj) { | 
| Mark Salyzyn | 8daa9af | 2014-04-28 14:07:23 -0700 | [diff] [blame] | 116 | prctl(PR_SET_NAME, "logd.reader.per"); | 
|  | 117 |  | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 118 | LogTimeEntry* me = reinterpret_cast<LogTimeEntry*>(obj); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 119 |  | 
|  | 120 | pthread_cleanup_push(threadStop, obj); | 
|  | 121 |  | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 122 | SocketClient* client = me->mClient; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 123 | if (!client) { | 
|  | 124 | me->error(); | 
| Mark Salyzyn | a16f761 | 2014-08-07 08:16:52 -0700 | [diff] [blame] | 125 | return NULL; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 126 | } | 
|  | 127 |  | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 128 | LogBuffer& logbuf = me->mReader.logbuf(); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 129 |  | 
|  | 130 | bool privileged = FlushCommand::hasReadLogs(client); | 
| Mark Salyzyn | 8fa8896 | 2016-01-26 14:32:35 -0800 | [diff] [blame] | 131 | bool security = FlushCommand::hasSecurityLogs(client); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 132 |  | 
| Mark Salyzyn | 047cc07 | 2015-06-04 13:35:30 -0700 | [diff] [blame] | 133 | me->leadingDropped = true; | 
|  | 134 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 135 | lock(); | 
|  | 136 |  | 
| Mark Salyzyn | 5a34d6e | 2017-03-10 08:44:14 -0800 | [diff] [blame] | 137 | log_time start = me->mStart; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 138 |  | 
| Mark Salyzyn | de4bb9c | 2015-09-16 15:34:00 -0700 | [diff] [blame] | 139 | while (me->threadRunning && !me->isError_Locked()) { | 
| Mark Salyzyn | b75cce0 | 2015-11-30 11:35:56 -0800 | [diff] [blame] | 140 | if (me->mTimeout.tv_sec || me->mTimeout.tv_nsec) { | 
|  | 141 | if (pthread_cond_timedwait(&me->threadTriggeredCondition, | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 142 | ×Lock, &me->mTimeout) == ETIMEDOUT) { | 
| Mark Salyzyn | b75cce0 | 2015-11-30 11:35:56 -0800 | [diff] [blame] | 143 | me->mTimeout.tv_sec = 0; | 
|  | 144 | me->mTimeout.tv_nsec = 0; | 
|  | 145 | } | 
|  | 146 | if (!me->threadRunning || me->isError_Locked()) { | 
|  | 147 | break; | 
|  | 148 | } | 
|  | 149 | } | 
|  | 150 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 151 | unlock(); | 
|  | 152 |  | 
|  | 153 | if (me->mTail) { | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 154 | logbuf.flushTo(client, start, privileged, security, FilterFirstPass, | 
|  | 155 | me); | 
| Mark Salyzyn | 047cc07 | 2015-06-04 13:35:30 -0700 | [diff] [blame] | 156 | me->leadingDropped = true; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 157 | } | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 158 | start = logbuf.flushTo(client, start, privileged, security, | 
|  | 159 | FilterSecondPass, me); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 160 |  | 
| Mark Salyzyn | a16f761 | 2014-08-07 08:16:52 -0700 | [diff] [blame] | 161 | lock(); | 
|  | 162 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 163 | if (start == LogBufferElement::FLUSH_ERROR) { | 
| Mark Salyzyn | a16f761 | 2014-08-07 08:16:52 -0700 | [diff] [blame] | 164 | me->error_Locked(); | 
| Mark Salyzyn | de4bb9c | 2015-09-16 15:34:00 -0700 | [diff] [blame] | 165 | break; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 166 | } | 
|  | 167 |  | 
| Mark Salyzyn | 5a34d6e | 2017-03-10 08:44:14 -0800 | [diff] [blame] | 168 | me->mStart = start + log_time(0, 1); | 
| Mark Salyzyn | de4bb9c | 2015-09-16 15:34:00 -0700 | [diff] [blame] | 169 |  | 
| Mark Salyzyn | a16f761 | 2014-08-07 08:16:52 -0700 | [diff] [blame] | 170 | if (me->mNonBlock || !me->threadRunning || me->isError_Locked()) { | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 171 | break; | 
|  | 172 | } | 
|  | 173 |  | 
| TraianX Schiau | da6495d | 2014-12-17 10:53:41 +0200 | [diff] [blame] | 174 | me->cleanSkip_Locked(); | 
|  | 175 |  | 
| Mark Salyzyn | b75cce0 | 2015-11-30 11:35:56 -0800 | [diff] [blame] | 176 | if (!me->mTimeout.tv_sec && !me->mTimeout.tv_nsec) { | 
|  | 177 | pthread_cond_wait(&me->threadTriggeredCondition, ×Lock); | 
|  | 178 | } | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 179 | } | 
|  | 180 |  | 
|  | 181 | unlock(); | 
|  | 182 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 183 | pthread_cleanup_pop(true); | 
|  | 184 |  | 
|  | 185 | return NULL; | 
|  | 186 | } | 
|  | 187 |  | 
|  | 188 | // A first pass to count the number of elements | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 189 | int LogTimeEntry::FilterFirstPass(const LogBufferElement* element, void* obj) { | 
|  | 190 | LogTimeEntry* me = reinterpret_cast<LogTimeEntry*>(obj); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 191 |  | 
|  | 192 | LogTimeEntry::lock(); | 
|  | 193 |  | 
| Mark Salyzyn | 047cc07 | 2015-06-04 13:35:30 -0700 | [diff] [blame] | 194 | if (me->leadingDropped) { | 
|  | 195 | if (element->getDropped()) { | 
|  | 196 | LogTimeEntry::unlock(); | 
|  | 197 | return false; | 
|  | 198 | } | 
|  | 199 | me->leadingDropped = false; | 
|  | 200 | } | 
|  | 201 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 202 | if (me->mCount == 0) { | 
| Mark Salyzyn | 5a34d6e | 2017-03-10 08:44:14 -0800 | [diff] [blame] | 203 | me->mStart = element->getRealTime(); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 204 | } | 
|  | 205 |  | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 206 | if ((!me->mPid || (me->mPid == element->getPid())) && | 
|  | 207 | (me->isWatching(element->getLogId()))) { | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 208 | ++me->mCount; | 
|  | 209 | } | 
|  | 210 |  | 
|  | 211 | LogTimeEntry::unlock(); | 
|  | 212 |  | 
|  | 213 | return false; | 
|  | 214 | } | 
|  | 215 |  | 
|  | 216 | // A second pass to send the selected elements | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 217 | int LogTimeEntry::FilterSecondPass(const LogBufferElement* element, void* obj) { | 
|  | 218 | LogTimeEntry* me = reinterpret_cast<LogTimeEntry*>(obj); | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 219 |  | 
|  | 220 | LogTimeEntry::lock(); | 
|  | 221 |  | 
| Mark Salyzyn | 5a34d6e | 2017-03-10 08:44:14 -0800 | [diff] [blame] | 222 | me->mStart = element->getRealTime(); | 
| TraianX Schiau | da6495d | 2014-12-17 10:53:41 +0200 | [diff] [blame] | 223 |  | 
|  | 224 | if (me->skipAhead[element->getLogId()]) { | 
|  | 225 | me->skipAhead[element->getLogId()]--; | 
| Mark Salyzyn | 8d7656b | 2014-06-05 15:58:43 -0700 | [diff] [blame] | 226 | goto skip; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 227 | } | 
|  | 228 |  | 
| Mark Salyzyn | 047cc07 | 2015-06-04 13:35:30 -0700 | [diff] [blame] | 229 | if (me->leadingDropped) { | 
|  | 230 | if (element->getDropped()) { | 
|  | 231 | goto skip; | 
|  | 232 | } | 
|  | 233 | me->leadingDropped = false; | 
|  | 234 | } | 
|  | 235 |  | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 236 | // Truncate to close race between first and second pass | 
|  | 237 | if (me->mNonBlock && me->mTail && (me->mIndex >= me->mCount)) { | 
| Mark Salyzyn | f7c0f75 | 2015-03-03 13:39:37 -0800 | [diff] [blame] | 238 | goto stop; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 239 | } | 
|  | 240 |  | 
| TraianX Schiau | da6495d | 2014-12-17 10:53:41 +0200 | [diff] [blame] | 241 | if (!me->isWatching(element->getLogId())) { | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 242 | goto skip; | 
|  | 243 | } | 
|  | 244 |  | 
|  | 245 | if (me->mPid && (me->mPid != element->getPid())) { | 
|  | 246 | goto skip; | 
|  | 247 | } | 
|  | 248 |  | 
|  | 249 | if (me->isError_Locked()) { | 
| Mark Salyzyn | f7c0f75 | 2015-03-03 13:39:37 -0800 | [diff] [blame] | 250 | goto stop; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 251 | } | 
|  | 252 |  | 
|  | 253 | if (!me->mTail) { | 
|  | 254 | goto ok; | 
|  | 255 | } | 
|  | 256 |  | 
|  | 257 | ++me->mIndex; | 
|  | 258 |  | 
|  | 259 | if ((me->mCount > me->mTail) && (me->mIndex <= (me->mCount - me->mTail))) { | 
|  | 260 | goto skip; | 
|  | 261 | } | 
|  | 262 |  | 
|  | 263 | if (!me->mNonBlock) { | 
|  | 264 | me->mTail = 0; | 
|  | 265 | } | 
|  | 266 |  | 
|  | 267 | ok: | 
| TraianX Schiau | da6495d | 2014-12-17 10:53:41 +0200 | [diff] [blame] | 268 | if (!me->skipAhead[element->getLogId()]) { | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 269 | LogTimeEntry::unlock(); | 
|  | 270 | return true; | 
|  | 271 | } | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 272 | // FALLTHRU | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 273 |  | 
|  | 274 | skip: | 
|  | 275 | LogTimeEntry::unlock(); | 
|  | 276 | return false; | 
| Mark Salyzyn | f7c0f75 | 2015-03-03 13:39:37 -0800 | [diff] [blame] | 277 |  | 
|  | 278 | stop: | 
|  | 279 | LogTimeEntry::unlock(); | 
|  | 280 | return -1; | 
| Mark Salyzyn | 0175b07 | 2014-02-26 09:50:16 -0800 | [diff] [blame] | 281 | } | 
| TraianX Schiau | da6495d | 2014-12-17 10:53:41 +0200 | [diff] [blame] | 282 |  | 
|  | 283 | void LogTimeEntry::cleanSkip_Locked(void) { | 
| Mark Salyzyn | 501c373 | 2017-03-10 14:31:54 -0800 | [diff] [blame] | 284 | for (log_id_t i = LOG_ID_MIN; i < LOG_ID_MAX; i = (log_id_t)(i + 1)) { | 
| TraianX Schiau | da6495d | 2014-12-17 10:53:41 +0200 | [diff] [blame] | 285 | skipAhead[i] = 0; | 
|  | 286 | } | 
|  | 287 | } |