1 //===-- lib/Semantics/check-omp-structure.cpp -----------------------------===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 9 #include "check-omp-structure.h" 10 #include "flang/Parser/parse-tree.h" 11 #include "flang/Semantics/tools.h" 12 #include <algorithm> 13 14 namespace Fortran::semantics { 15 16 // Use when clause falls under 'struct OmpClause' in 'parse-tree.h'. 17 #define CHECK_SIMPLE_CLAUSE(X, Y) \ 18 void OmpStructureChecker::Enter(const parser::OmpClause::X &) { \ 19 CheckAllowed(llvm::omp::Clause::Y); \ 20 } 21 22 #define CHECK_REQ_CONSTANT_SCALAR_INT_CLAUSE(X, Y) \ 23 void OmpStructureChecker::Enter(const parser::OmpClause::X &c) { \ 24 CheckAllowed(llvm::omp::Clause::Y); \ 25 RequiresConstantPositiveParameter(llvm::omp::Clause::Y, c.v); \ 26 } 27 28 #define CHECK_REQ_SCALAR_INT_CLAUSE(X, Y) \ 29 void OmpStructureChecker::Enter(const parser::OmpClause::X &c) { \ 30 CheckAllowed(llvm::omp::Clause::Y); \ 31 RequiresPositiveParameter(llvm::omp::Clause::Y, c.v); \ 32 } 33 34 // Use when clause don't falls under 'struct OmpClause' in 'parse-tree.h'. 35 #define CHECK_SIMPLE_PARSER_CLAUSE(X, Y) \ 36 void OmpStructureChecker::Enter(const parser::X &) { \ 37 CheckAllowed(llvm::omp::Y); \ 38 } 39 40 // 'OmpWorkshareBlockChecker' is used to check the validity of the assignment 41 // statements and the expressions enclosed in an OpenMP Workshare construct 42 class OmpWorkshareBlockChecker { 43 public: 44 OmpWorkshareBlockChecker(SemanticsContext &context, parser::CharBlock source) 45 : context_{context}, source_{source} {} 46 47 template <typename T> bool Pre(const T &) { return true; } 48 template <typename T> void Post(const T &) {} 49 50 bool Pre(const parser::AssignmentStmt &assignment) { 51 const auto &var{std::get<parser::Variable>(assignment.t)}; 52 const auto &expr{std::get<parser::Expr>(assignment.t)}; 53 const auto *lhs{GetExpr(var)}; 54 const auto *rhs{GetExpr(expr)}; 55 if (lhs && rhs) { 56 Tristate isDefined{semantics::IsDefinedAssignment( 57 lhs->GetType(), lhs->Rank(), rhs->GetType(), rhs->Rank())}; 58 if (isDefined == Tristate::Yes) { 59 context_.Say(expr.source, 60 "Defined assignment statement is not " 61 "allowed in a WORKSHARE construct"_err_en_US); 62 } 63 } 64 return true; 65 } 66 67 bool Pre(const parser::Expr &expr) { 68 if (const auto *e{GetExpr(expr)}) { 69 for (const Symbol &symbol : evaluate::CollectSymbols(*e)) { 70 const Symbol &root{GetAssociationRoot(symbol)}; 71 if (IsFunction(root) && 72 !(root.attrs().test(Attr::ELEMENTAL) || 73 root.attrs().test(Attr::INTRINSIC))) { 74 context_.Say(expr.source, 75 "User defined non-ELEMENTAL function " 76 "'%s' is not allowed in a WORKSHARE construct"_err_en_US, 77 root.name()); 78 } 79 } 80 } 81 return false; 82 } 83 84 private: 85 SemanticsContext &context_; 86 parser::CharBlock source_; 87 }; 88 89 class OmpCycleChecker { 90 public: 91 OmpCycleChecker(SemanticsContext &context, std::int64_t cycleLevel) 92 : context_{context}, cycleLevel_{cycleLevel} {} 93 94 template <typename T> bool Pre(const T &) { return true; } 95 template <typename T> void Post(const T &) {} 96 97 bool Pre(const parser::DoConstruct &dc) { 98 cycleLevel_--; 99 const auto &labelName{std::get<0>(std::get<0>(dc.t).statement.t)}; 100 if (labelName) { 101 labelNamesandLevels_.emplace(labelName.value().ToString(), cycleLevel_); 102 } 103 return true; 104 } 105 106 bool Pre(const parser::CycleStmt &cyclestmt) { 107 std::map<std::string, std::int64_t>::iterator it; 108 bool err{false}; 109 if (cyclestmt.v) { 110 it = labelNamesandLevels_.find(cyclestmt.v->source.ToString()); 111 err = (it != labelNamesandLevels_.end() && it->second > 0); 112 } 113 if (cycleLevel_ > 0 || err) { 114 context_.Say(*cycleSource_, 115 "CYCLE statement to non-innermost associated loop of an OpenMP DO construct"_err_en_US); 116 } 117 return true; 118 } 119 120 bool Pre(const parser::Statement<parser::ActionStmt> &actionstmt) { 121 cycleSource_ = &actionstmt.source; 122 return true; 123 } 124 125 private: 126 SemanticsContext &context_; 127 const parser::CharBlock *cycleSource_; 128 std::int64_t cycleLevel_; 129 std::map<std::string, std::int64_t> labelNamesandLevels_; 130 }; 131 132 bool OmpStructureChecker::IsCloselyNestedRegion(const OmpDirectiveSet &set) { 133 // Definition of close nesting: 134 // 135 // `A region nested inside another region with no parallel region nested 136 // between them` 137 // 138 // Examples: 139 // non-parallel construct 1 140 // non-parallel construct 2 141 // parallel construct 142 // construct 3 143 // In the above example, construct 3 is NOT closely nested inside construct 1 144 // or 2 145 // 146 // non-parallel construct 1 147 // non-parallel construct 2 148 // construct 3 149 // In the above example, construct 3 is closely nested inside BOTH construct 1 150 // and 2 151 // 152 // Algorithm: 153 // Starting from the parent context, Check in a bottom-up fashion, each level 154 // of the context stack. If we have a match for one of the (supplied) 155 // violating directives, `close nesting` is satisfied. If no match is there in 156 // the entire stack, `close nesting` is not satisfied. If at any level, a 157 // `parallel` region is found, `close nesting` is not satisfied. 158 159 if (CurrentDirectiveIsNested()) { 160 int index = dirContext_.size() - 2; 161 while (index != -1) { 162 if (set.test(dirContext_[index].directive)) { 163 return true; 164 } else if (llvm::omp::parallelSet.test(dirContext_[index].directive)) { 165 return false; 166 } 167 index--; 168 } 169 } 170 return false; 171 } 172 173 bool OmpStructureChecker::HasInvalidWorksharingNesting( 174 const parser::CharBlock &source, const OmpDirectiveSet &set) { 175 // set contains all the invalid closely nested directives 176 // for the given directive (`source` here) 177 if (IsCloselyNestedRegion(set)) { 178 context_.Say(source, 179 "A worksharing region may not be closely nested inside a " 180 "worksharing, explicit task, taskloop, critical, ordered, atomic, or " 181 "master region"_err_en_US); 182 return true; 183 } 184 return false; 185 } 186 187 void OmpStructureChecker::HasInvalidDistributeNesting( 188 const parser::OpenMPLoopConstruct &x) { 189 bool violation{false}; 190 191 OmpDirectiveSet distributeSet{llvm::omp::Directive::OMPD_distribute, 192 llvm::omp::Directive::OMPD_distribute_parallel_do, 193 llvm::omp::Directive::OMPD_distribute_parallel_do_simd, 194 llvm::omp::Directive::OMPD_distribute_parallel_for, 195 llvm::omp::Directive::OMPD_distribute_parallel_for_simd, 196 llvm::omp::Directive::OMPD_distribute_simd}; 197 198 const auto &beginLoopDir{std::get<parser::OmpBeginLoopDirective>(x.t)}; 199 const auto &beginDir{std::get<parser::OmpLoopDirective>(beginLoopDir.t)}; 200 if (distributeSet.test(beginDir.v)) { 201 // `distribute` region has to be nested 202 if (!CurrentDirectiveIsNested()) { 203 violation = true; 204 } else { 205 // `distribute` region has to be strictly nested inside `teams` 206 if (!llvm::omp::teamSet.test(GetContextParent().directive)) { 207 violation = true; 208 } 209 } 210 } 211 if (violation) { 212 context_.Say(beginDir.source, 213 "`DISTRIBUTE` region has to be strictly nested inside `TEAMS` region."_err_en_US); 214 } 215 } 216 217 void OmpStructureChecker::HasInvalidTeamsNesting( 218 const llvm::omp::Directive &dir, const parser::CharBlock &source) { 219 OmpDirectiveSet allowedSet{llvm::omp::Directive::OMPD_parallel, 220 llvm::omp::Directive::OMPD_parallel_do, 221 llvm::omp::Directive::OMPD_parallel_do_simd, 222 llvm::omp::Directive::OMPD_parallel_for, 223 llvm::omp::Directive::OMPD_parallel_for_simd, 224 llvm::omp::Directive::OMPD_parallel_master, 225 llvm::omp::Directive::OMPD_parallel_master_taskloop, 226 llvm::omp::Directive::OMPD_parallel_master_taskloop_simd, 227 llvm::omp::Directive::OMPD_parallel_sections, 228 llvm::omp::Directive::OMPD_parallel_workshare, 229 llvm::omp::Directive::OMPD_distribute, 230 llvm::omp::Directive::OMPD_distribute_parallel_do, 231 llvm::omp::Directive::OMPD_distribute_parallel_do_simd, 232 llvm::omp::Directive::OMPD_distribute_parallel_for, 233 llvm::omp::Directive::OMPD_distribute_parallel_for_simd, 234 llvm::omp::Directive::OMPD_distribute_simd}; 235 236 if (!allowedSet.test(dir)) { 237 context_.Say(source, 238 "Only `DISTRIBUTE` or `PARALLEL` regions are allowed to be strictly nested inside `TEAMS` region."_err_en_US); 239 } 240 } 241 242 void OmpStructureChecker::CheckPredefinedAllocatorRestriction( 243 const parser::CharBlock &source, const parser::Name &name) { 244 if (const auto *symbol{name.symbol}) { 245 const auto *commonBlock{FindCommonBlockContaining(*symbol)}; 246 const auto &scope{context_.FindScope(symbol->name())}; 247 const Scope &containingScope{GetProgramUnitContaining(scope)}; 248 if (!isPredefinedAllocator && 249 (IsSave(*symbol) || commonBlock || 250 containingScope.kind() == Scope::Kind::Module)) { 251 context_.Say(source, 252 "If list items within the ALLOCATE directive have the " 253 "SAVE attribute, are a common block name, or are " 254 "declared in the scope of a module, then only " 255 "predefined memory allocator parameters can be used " 256 "in the allocator clause"_err_en_US); 257 } 258 } 259 } 260 261 void OmpStructureChecker::CheckPredefinedAllocatorRestriction( 262 const parser::CharBlock &source, 263 const parser::OmpObjectList &ompObjectList) { 264 for (const auto &ompObject : ompObjectList.v) { 265 std::visit( 266 common::visitors{ 267 [&](const parser::Designator &designator) { 268 if (const auto *dataRef{ 269 std::get_if<parser::DataRef>(&designator.u)}) { 270 if (const auto *name{std::get_if<parser::Name>(&dataRef->u)}) { 271 CheckPredefinedAllocatorRestriction(source, *name); 272 } 273 } 274 }, 275 [&](const parser::Name &name) { 276 CheckPredefinedAllocatorRestriction(source, name); 277 }, 278 }, 279 ompObject.u); 280 } 281 } 282 283 void OmpStructureChecker::Enter(const parser::OpenMPConstruct &x) { 284 // Simd Construct with Ordered Construct Nesting check 285 // We cannot use CurrentDirectiveIsNested() here because 286 // PushContextAndClauseSets() has not been called yet, it is 287 // called individually for each construct. Therefore a 288 // dirContext_ size `1` means the current construct is nested 289 if (dirContext_.size() >= 1) { 290 if (GetDirectiveNest(SIMDNest) > 0) { 291 CheckSIMDNest(x); 292 } 293 if (GetDirectiveNest(TargetNest) > 0) { 294 CheckTargetNest(x); 295 } 296 } 297 } 298 299 void OmpStructureChecker::Enter(const parser::OpenMPLoopConstruct &x) { 300 const auto &beginLoopDir{std::get<parser::OmpBeginLoopDirective>(x.t)}; 301 const auto &beginDir{std::get<parser::OmpLoopDirective>(beginLoopDir.t)}; 302 303 // check matching, End directive is optional 304 if (const auto &endLoopDir{ 305 std::get<std::optional<parser::OmpEndLoopDirective>>(x.t)}) { 306 const auto &endDir{ 307 std::get<parser::OmpLoopDirective>(endLoopDir.value().t)}; 308 309 CheckMatching<parser::OmpLoopDirective>(beginDir, endDir); 310 } 311 312 PushContextAndClauseSets(beginDir.source, beginDir.v); 313 if (llvm::omp::simdSet.test(GetContext().directive)) { 314 EnterDirectiveNest(SIMDNest); 315 } 316 317 if (beginDir.v == llvm::omp::Directive::OMPD_do) { 318 // 2.7.1 do-clause -> private-clause | 319 // firstprivate-clause | 320 // lastprivate-clause | 321 // linear-clause | 322 // reduction-clause | 323 // schedule-clause | 324 // collapse-clause | 325 // ordered-clause 326 327 // nesting check 328 HasInvalidWorksharingNesting( 329 beginDir.source, llvm::omp::nestedWorkshareErrSet); 330 } 331 SetLoopInfo(x); 332 333 if (const auto &doConstruct{ 334 std::get<std::optional<parser::DoConstruct>>(x.t)}) { 335 const auto &doBlock{std::get<parser::Block>(doConstruct->t)}; 336 CheckNoBranching(doBlock, beginDir.v, beginDir.source); 337 } 338 CheckDoWhile(x); 339 CheckLoopItrVariableIsInt(x); 340 CheckCycleConstraints(x); 341 HasInvalidDistributeNesting(x); 342 if (CurrentDirectiveIsNested() && 343 llvm::omp::teamSet.test(GetContextParent().directive)) { 344 HasInvalidTeamsNesting(beginDir.v, beginDir.source); 345 } 346 if ((beginDir.v == llvm::omp::Directive::OMPD_distribute_parallel_do_simd) || 347 (beginDir.v == llvm::omp::Directive::OMPD_distribute_simd)) { 348 CheckDistLinear(x); 349 } 350 } 351 const parser::Name OmpStructureChecker::GetLoopIndex( 352 const parser::DoConstruct *x) { 353 using Bounds = parser::LoopControl::Bounds; 354 return std::get<Bounds>(x->GetLoopControl()->u).name.thing; 355 } 356 void OmpStructureChecker::SetLoopInfo(const parser::OpenMPLoopConstruct &x) { 357 if (const auto &loopConstruct{ 358 std::get<std::optional<parser::DoConstruct>>(x.t)}) { 359 const parser::DoConstruct *loop{&*loopConstruct}; 360 if (loop && loop->IsDoNormal()) { 361 const parser::Name &itrVal{GetLoopIndex(loop)}; 362 SetLoopIv(itrVal.symbol); 363 } 364 } 365 } 366 void OmpStructureChecker::CheckDoWhile(const parser::OpenMPLoopConstruct &x) { 367 const auto &beginLoopDir{std::get<parser::OmpBeginLoopDirective>(x.t)}; 368 const auto &beginDir{std::get<parser::OmpLoopDirective>(beginLoopDir.t)}; 369 if (beginDir.v == llvm::omp::Directive::OMPD_do) { 370 if (const auto &doConstruct{ 371 std::get<std::optional<parser::DoConstruct>>(x.t)}) { 372 if (doConstruct.value().IsDoWhile()) { 373 const auto &doStmt{std::get<parser::Statement<parser::NonLabelDoStmt>>( 374 doConstruct.value().t)}; 375 context_.Say(doStmt.source, 376 "The DO loop cannot be a DO WHILE with DO directive."_err_en_US); 377 } 378 } 379 } 380 } 381 382 void OmpStructureChecker::CheckLoopItrVariableIsInt( 383 const parser::OpenMPLoopConstruct &x) { 384 if (const auto &loopConstruct{ 385 std::get<std::optional<parser::DoConstruct>>(x.t)}) { 386 387 for (const parser::DoConstruct *loop{&*loopConstruct}; loop;) { 388 if (loop->IsDoNormal()) { 389 const parser::Name &itrVal{GetLoopIndex(loop)}; 390 if (itrVal.symbol) { 391 const auto *type{itrVal.symbol->GetType()}; 392 if (!type->IsNumeric(TypeCategory::Integer)) { 393 context_.Say(itrVal.source, 394 "The DO loop iteration" 395 " variable must be of the type integer."_err_en_US, 396 itrVal.ToString()); 397 } 398 } 399 } 400 // Get the next DoConstruct if block is not empty. 401 const auto &block{std::get<parser::Block>(loop->t)}; 402 const auto it{block.begin()}; 403 loop = it != block.end() ? parser::Unwrap<parser::DoConstruct>(*it) 404 : nullptr; 405 } 406 } 407 } 408 409 void OmpStructureChecker::CheckSIMDNest(const parser::OpenMPConstruct &c) { 410 // Check the following: 411 // The only OpenMP constructs that can be encountered during execution of 412 // a simd region are the `atomic` construct, the `loop` construct, the `simd` 413 // construct and the `ordered` construct with the `simd` clause. 414 // TODO: Expand the check to include `LOOP` construct as well when it is 415 // supported. 416 417 // Check if the parent context has the SIMD clause 418 // Please note that we use GetContext() instead of GetContextParent() 419 // because PushContextAndClauseSets() has not been called on the 420 // current context yet. 421 // TODO: Check for declare simd regions. 422 bool eligibleSIMD{false}; 423 std::visit(Fortran::common::visitors{ 424 // Allow `!$OMP ORDERED SIMD` 425 [&](const parser::OpenMPBlockConstruct &c) { 426 const auto &beginBlockDir{ 427 std::get<parser::OmpBeginBlockDirective>(c.t)}; 428 const auto &beginDir{ 429 std::get<parser::OmpBlockDirective>(beginBlockDir.t)}; 430 if (beginDir.v == llvm::omp::Directive::OMPD_ordered) { 431 const auto &clauses{ 432 std::get<parser::OmpClauseList>(beginBlockDir.t)}; 433 for (const auto &clause : clauses.v) { 434 if (std::get_if<parser::OmpClause::Simd>(&clause.u)) { 435 eligibleSIMD = true; 436 break; 437 } 438 } 439 } 440 }, 441 [&](const parser::OpenMPSimpleStandaloneConstruct &c) { 442 const auto &dir{ 443 std::get<parser::OmpSimpleStandaloneDirective>(c.t)}; 444 if (dir.v == llvm::omp::Directive::OMPD_ordered) { 445 const auto &clauses{std::get<parser::OmpClauseList>(c.t)}; 446 for (const auto &clause : clauses.v) { 447 if (std::get_if<parser::OmpClause::Simd>(&clause.u)) { 448 eligibleSIMD = true; 449 break; 450 } 451 } 452 } 453 }, 454 // Allowing SIMD construct 455 [&](const parser::OpenMPLoopConstruct &c) { 456 const auto &beginLoopDir{ 457 std::get<parser::OmpBeginLoopDirective>(c.t)}; 458 const auto &beginDir{ 459 std::get<parser::OmpLoopDirective>(beginLoopDir.t)}; 460 if ((beginDir.v == llvm::omp::Directive::OMPD_simd) || 461 (beginDir.v == llvm::omp::Directive::OMPD_do_simd)) { 462 eligibleSIMD = true; 463 } 464 }, 465 [&](const parser::OpenMPAtomicConstruct &c) { 466 // Allow `!$OMP ATOMIC` 467 eligibleSIMD = true; 468 }, 469 [&](const auto &c) {}, 470 }, 471 c.u); 472 if (!eligibleSIMD) { 473 context_.Say(parser::FindSourceLocation(c), 474 "The only OpenMP constructs that can be encountered during execution " 475 "of a 'SIMD'" 476 " region are the `ATOMIC` construct, the `LOOP` construct, the `SIMD`" 477 " construct and the `ORDERED` construct with the `SIMD` clause."_err_en_US); 478 } 479 } 480 481 void OmpStructureChecker::CheckTargetNest(const parser::OpenMPConstruct &c) { 482 // 2.12.5 Target Construct Restriction 483 bool eligibleTarget{true}; 484 llvm::omp::Directive ineligibleTargetDir; 485 std::visit( 486 common::visitors{ 487 [&](const parser::OpenMPBlockConstruct &c) { 488 const auto &beginBlockDir{ 489 std::get<parser::OmpBeginBlockDirective>(c.t)}; 490 const auto &beginDir{ 491 std::get<parser::OmpBlockDirective>(beginBlockDir.t)}; 492 if (beginDir.v == llvm::omp::Directive::OMPD_target_data) { 493 eligibleTarget = false; 494 ineligibleTargetDir = beginDir.v; 495 } 496 }, 497 [&](const parser::OpenMPStandaloneConstruct &c) { 498 std::visit( 499 common::visitors{ 500 [&](const parser::OpenMPSimpleStandaloneConstruct &c) { 501 const auto &dir{ 502 std::get<parser::OmpSimpleStandaloneDirective>(c.t)}; 503 if (dir.v == llvm::omp::Directive::OMPD_target_update || 504 dir.v == 505 llvm::omp::Directive::OMPD_target_enter_data || 506 dir.v == 507 llvm::omp::Directive::OMPD_target_exit_data) { 508 eligibleTarget = false; 509 ineligibleTargetDir = dir.v; 510 } 511 }, 512 [&](const auto &c) {}, 513 }, 514 c.u); 515 }, 516 [&](const auto &c) {}, 517 }, 518 c.u); 519 if (!eligibleTarget) { 520 context_.Say(parser::FindSourceLocation(c), 521 "If %s directive is nested inside TARGET region, the behaviour " 522 "is unspecified"_en_US, 523 parser::ToUpperCaseLetters( 524 getDirectiveName(ineligibleTargetDir).str())); 525 } 526 } 527 528 std::int64_t OmpStructureChecker::GetOrdCollapseLevel( 529 const parser::OpenMPLoopConstruct &x) { 530 const auto &beginLoopDir{std::get<parser::OmpBeginLoopDirective>(x.t)}; 531 const auto &clauseList{std::get<parser::OmpClauseList>(beginLoopDir.t)}; 532 std::int64_t orderedCollapseLevel{1}; 533 std::int64_t orderedLevel{0}; 534 std::int64_t collapseLevel{0}; 535 536 for (const auto &clause : clauseList.v) { 537 if (const auto *collapseClause{ 538 std::get_if<parser::OmpClause::Collapse>(&clause.u)}) { 539 if (const auto v{GetIntValue(collapseClause->v)}) { 540 collapseLevel = *v; 541 } 542 } 543 if (const auto *orderedClause{ 544 std::get_if<parser::OmpClause::Ordered>(&clause.u)}) { 545 if (const auto v{GetIntValue(orderedClause->v)}) { 546 orderedLevel = *v; 547 } 548 } 549 } 550 if (orderedLevel >= collapseLevel) { 551 orderedCollapseLevel = orderedLevel; 552 } else { 553 orderedCollapseLevel = collapseLevel; 554 } 555 return orderedCollapseLevel; 556 } 557 558 void OmpStructureChecker::CheckCycleConstraints( 559 const parser::OpenMPLoopConstruct &x) { 560 std::int64_t ordCollapseLevel{GetOrdCollapseLevel(x)}; 561 OmpCycleChecker ompCycleChecker{context_, ordCollapseLevel}; 562 parser::Walk(x, ompCycleChecker); 563 } 564 565 void OmpStructureChecker::CheckDistLinear( 566 const parser::OpenMPLoopConstruct &x) { 567 568 const auto &beginLoopDir{std::get<parser::OmpBeginLoopDirective>(x.t)}; 569 const auto &clauses{std::get<parser::OmpClauseList>(beginLoopDir.t)}; 570 571 semantics::UnorderedSymbolSet indexVars; 572 573 // Collect symbols of all the variables from linear clauses 574 for (const auto &clause : clauses.v) { 575 if (const auto *linearClause{ 576 std::get_if<parser::OmpClause::Linear>(&clause.u)}) { 577 578 std::list<parser::Name> values; 579 // Get the variant type 580 if (std::holds_alternative<parser::OmpLinearClause::WithModifier>( 581 linearClause->v.u)) { 582 const auto &withM{ 583 std::get<parser::OmpLinearClause::WithModifier>(linearClause->v.u)}; 584 values = withM.names; 585 } else { 586 const auto &withOutM{std::get<parser::OmpLinearClause::WithoutModifier>( 587 linearClause->v.u)}; 588 values = withOutM.names; 589 } 590 for (auto const &v : values) { 591 indexVars.insert(*(v.symbol)); 592 } 593 } 594 } 595 596 if (!indexVars.empty()) { 597 // Get collapse level, if given, to find which loops are "associated." 598 std::int64_t collapseVal{GetOrdCollapseLevel(x)}; 599 // Include the top loop if no collapse is specified 600 if (collapseVal == 0) { 601 collapseVal = 1; 602 } 603 604 // Match the loop index variables with the collected symbols from linear 605 // clauses. 606 if (const auto &loopConstruct{ 607 std::get<std::optional<parser::DoConstruct>>(x.t)}) { 608 for (const parser::DoConstruct *loop{&*loopConstruct}; loop;) { 609 if (loop->IsDoNormal()) { 610 const parser::Name &itrVal{GetLoopIndex(loop)}; 611 if (itrVal.symbol) { 612 // Remove the symbol from the collcted set 613 indexVars.erase(*(itrVal.symbol)); 614 } 615 collapseVal--; 616 if (collapseVal == 0) { 617 break; 618 } 619 } 620 // Get the next DoConstruct if block is not empty. 621 const auto &block{std::get<parser::Block>(loop->t)}; 622 const auto it{block.begin()}; 623 loop = it != block.end() ? parser::Unwrap<parser::DoConstruct>(*it) 624 : nullptr; 625 } 626 } 627 628 // Show error for the remaining variables 629 for (auto var : indexVars) { 630 const Symbol &root{GetAssociationRoot(var)}; 631 context_.Say(parser::FindSourceLocation(x), 632 "Variable '%s' not allowed in `LINEAR` clause, only loop iterator can be specified in `LINEAR` clause of a construct combined with `DISTRIBUTE`"_err_en_US, 633 root.name()); 634 } 635 } 636 } 637 638 void OmpStructureChecker::Leave(const parser::OpenMPLoopConstruct &) { 639 if (llvm::omp::simdSet.test(GetContext().directive)) { 640 ExitDirectiveNest(SIMDNest); 641 } 642 dirContext_.pop_back(); 643 } 644 645 void OmpStructureChecker::Enter(const parser::OmpEndLoopDirective &x) { 646 const auto &dir{std::get<parser::OmpLoopDirective>(x.t)}; 647 ResetPartialContext(dir.source); 648 switch (dir.v) { 649 // 2.7.1 end-do -> END DO [nowait-clause] 650 // 2.8.3 end-do-simd -> END DO SIMD [nowait-clause] 651 case llvm::omp::Directive::OMPD_do: 652 case llvm::omp::Directive::OMPD_do_simd: 653 SetClauseSets(dir.v); 654 break; 655 default: 656 // no clauses are allowed 657 break; 658 } 659 } 660 661 void OmpStructureChecker::Enter(const parser::OpenMPBlockConstruct &x) { 662 const auto &beginBlockDir{std::get<parser::OmpBeginBlockDirective>(x.t)}; 663 const auto &endBlockDir{std::get<parser::OmpEndBlockDirective>(x.t)}; 664 const auto &beginDir{std::get<parser::OmpBlockDirective>(beginBlockDir.t)}; 665 const auto &endDir{std::get<parser::OmpBlockDirective>(endBlockDir.t)}; 666 const parser::Block &block{std::get<parser::Block>(x.t)}; 667 668 CheckMatching<parser::OmpBlockDirective>(beginDir, endDir); 669 670 PushContextAndClauseSets(beginDir.source, beginDir.v); 671 if (GetContext().directive == llvm::omp::Directive::OMPD_target) { 672 EnterDirectiveNest(TargetNest); 673 } 674 675 if (CurrentDirectiveIsNested()) { 676 CheckIfDoOrderedClause(beginDir); 677 if (llvm::omp::teamSet.test(GetContextParent().directive)) { 678 HasInvalidTeamsNesting(beginDir.v, beginDir.source); 679 } 680 if (GetContext().directive == llvm::omp::Directive::OMPD_master) { 681 CheckMasterNesting(x); 682 } 683 // A teams region can only be strictly nested within the implicit parallel 684 // region or a target region. 685 if (GetContext().directive == llvm::omp::Directive::OMPD_teams && 686 GetContextParent().directive != llvm::omp::Directive::OMPD_target) { 687 context_.Say(parser::FindSourceLocation(x), 688 "%s region can only be strictly nested within the implicit parallel " 689 "region or TARGET region"_err_en_US, 690 ContextDirectiveAsFortran()); 691 } 692 // If a teams construct is nested within a target construct, that target 693 // construct must contain no statements, declarations or directives outside 694 // of the teams construct. 695 if (GetContext().directive == llvm::omp::Directive::OMPD_teams && 696 GetContextParent().directive == llvm::omp::Directive::OMPD_target && 697 !GetDirectiveNest(TargetBlockOnlyTeams)) { 698 context_.Say(GetContextParent().directiveSource, 699 "TARGET construct with nested TEAMS region contains statements or " 700 "directives outside of the TEAMS construct"_err_en_US); 701 } 702 } 703 704 CheckNoBranching(block, beginDir.v, beginDir.source); 705 706 switch (beginDir.v) { 707 case llvm::omp::Directive::OMPD_target: 708 if (CheckTargetBlockOnlyTeams(block)) { 709 EnterDirectiveNest(TargetBlockOnlyTeams); 710 } 711 break; 712 case llvm::omp::OMPD_workshare: 713 case llvm::omp::OMPD_parallel_workshare: 714 CheckWorkshareBlockStmts(block, beginDir.source); 715 HasInvalidWorksharingNesting( 716 beginDir.source, llvm::omp::nestedWorkshareErrSet); 717 break; 718 case llvm::omp::Directive::OMPD_single: 719 // TODO: This check needs to be extended while implementing nesting of 720 // regions checks. 721 HasInvalidWorksharingNesting( 722 beginDir.source, llvm::omp::nestedWorkshareErrSet); 723 break; 724 default: 725 break; 726 } 727 } 728 729 void OmpStructureChecker::CheckMasterNesting( 730 const parser::OpenMPBlockConstruct &x) { 731 // A MASTER region may not be `closely nested` inside a worksharing, loop, 732 // task, taskloop, or atomic region. 733 // TODO: Expand the check to include `LOOP` construct as well when it is 734 // supported. 735 if (IsCloselyNestedRegion(llvm::omp::nestedMasterErrSet)) { 736 context_.Say(parser::FindSourceLocation(x), 737 "`MASTER` region may not be closely nested inside of `WORKSHARING`, " 738 "`LOOP`, `TASK`, `TASKLOOP`," 739 " or `ATOMIC` region."_err_en_US); 740 } 741 } 742 743 void OmpStructureChecker::CheckIfDoOrderedClause( 744 const parser::OmpBlockDirective &blkDirective) { 745 if (blkDirective.v == llvm::omp::OMPD_ordered) { 746 // Loops 747 if (llvm::omp::doSet.test(GetContextParent().directive) && 748 !FindClauseParent(llvm::omp::Clause::OMPC_ordered)) { 749 context_.Say(blkDirective.source, 750 "The ORDERED clause must be present on the loop" 751 " construct if any ORDERED region ever binds" 752 " to a loop region arising from the loop construct."_err_en_US); 753 } 754 // Other disallowed nestings, these directives do not support 755 // ordered clause in them, so no need to check 756 else if (IsCloselyNestedRegion(llvm::omp::nestedOrderedErrSet)) { 757 context_.Say(blkDirective.source, 758 "`ORDERED` region may not be closely nested inside of " 759 "`CRITICAL`, `ORDERED`, explicit `TASK` or `TASKLOOP` region."_err_en_US); 760 } 761 } 762 } 763 764 void OmpStructureChecker::Leave(const parser::OpenMPBlockConstruct &) { 765 if (GetDirectiveNest(TargetBlockOnlyTeams)) { 766 ExitDirectiveNest(TargetBlockOnlyTeams); 767 } 768 if (GetContext().directive == llvm::omp::Directive::OMPD_target) { 769 ExitDirectiveNest(TargetNest); 770 } 771 dirContext_.pop_back(); 772 } 773 774 void OmpStructureChecker::ChecksOnOrderedAsBlock() { 775 if (FindClause(llvm::omp::Clause::OMPC_depend)) { 776 context_.Say(GetContext().clauseSource, 777 "DEPEND(*) clauses are not allowed when ORDERED construct is a block" 778 " construct with an ORDERED region"_err_en_US); 779 } 780 } 781 782 void OmpStructureChecker::Leave(const parser::OmpBeginBlockDirective &) { 783 switch (GetContext().directive) { 784 case llvm::omp::Directive::OMPD_ordered: 785 // [5.1] 2.19.9 Ordered Construct Restriction 786 ChecksOnOrderedAsBlock(); 787 break; 788 default: 789 break; 790 } 791 } 792 793 void OmpStructureChecker::Enter(const parser::OpenMPSectionsConstruct &x) { 794 const auto &beginSectionsDir{ 795 std::get<parser::OmpBeginSectionsDirective>(x.t)}; 796 const auto &endSectionsDir{std::get<parser::OmpEndSectionsDirective>(x.t)}; 797 const auto &beginDir{ 798 std::get<parser::OmpSectionsDirective>(beginSectionsDir.t)}; 799 const auto &endDir{std::get<parser::OmpSectionsDirective>(endSectionsDir.t)}; 800 CheckMatching<parser::OmpSectionsDirective>(beginDir, endDir); 801 802 PushContextAndClauseSets(beginDir.source, beginDir.v); 803 const auto §ionBlocks{std::get<parser::OmpSectionBlocks>(x.t)}; 804 for (const auto &block : sectionBlocks.v) { 805 CheckNoBranching(block, beginDir.v, beginDir.source); 806 } 807 HasInvalidWorksharingNesting( 808 beginDir.source, llvm::omp::nestedWorkshareErrSet); 809 } 810 811 void OmpStructureChecker::Leave(const parser::OpenMPSectionsConstruct &) { 812 dirContext_.pop_back(); 813 } 814 815 void OmpStructureChecker::Enter(const parser::OmpEndSectionsDirective &x) { 816 const auto &dir{std::get<parser::OmpSectionsDirective>(x.t)}; 817 ResetPartialContext(dir.source); 818 switch (dir.v) { 819 // 2.7.2 end-sections -> END SECTIONS [nowait-clause] 820 case llvm::omp::Directive::OMPD_sections: 821 PushContextAndClauseSets( 822 dir.source, llvm::omp::Directive::OMPD_end_sections); 823 break; 824 default: 825 // no clauses are allowed 826 break; 827 } 828 } 829 830 // TODO: Verify the popping of dirContext requirement after nowait 831 // implementation, as there is an implicit barrier at the end of the worksharing 832 // constructs unless a nowait clause is specified. Only OMPD_end_sections is 833 // popped becuase it is pushed while entering the EndSectionsDirective. 834 void OmpStructureChecker::Leave(const parser::OmpEndSectionsDirective &x) { 835 if (GetContext().directive == llvm::omp::Directive::OMPD_end_sections) { 836 dirContext_.pop_back(); 837 } 838 } 839 840 void OmpStructureChecker::CheckThreadprivateOrDeclareTargetVar( 841 const parser::OmpObjectList &objList) { 842 for (const auto &ompObject : objList.v) { 843 std::visit( 844 common::visitors{ 845 [&](const parser::Designator &) { 846 if (const auto *name{parser::Unwrap<parser::Name>(ompObject)}) { 847 const auto &declScope{ 848 GetProgramUnitContaining(name->symbol->GetUltimate())}; 849 const auto *sym = 850 declScope.parent().FindSymbol(name->symbol->name()); 851 if (sym && 852 (sym->has<MainProgramDetails>() || 853 sym->has<ModuleDetails>())) { 854 context_.Say(name->source, 855 "The module name or main program name cannot be in a %s " 856 "directive"_err_en_US, 857 ContextDirectiveAsFortran()); 858 } else if (name->symbol->GetUltimate().IsSubprogram()) { 859 if (GetContext().directive == 860 llvm::omp::Directive::OMPD_threadprivate) 861 context_.Say(name->source, 862 "The procedure name cannot be in a %s " 863 "directive"_err_en_US, 864 ContextDirectiveAsFortran()); 865 // TODO: Check for procedure name in declare target directive. 866 } else if (name->symbol->attrs().test(Attr::PARAMETER)) { 867 if (GetContext().directive == 868 llvm::omp::Directive::OMPD_threadprivate) 869 context_.Say(name->source, 870 "The entity with PARAMETER attribute cannot be in a %s " 871 "directive"_err_en_US, 872 ContextDirectiveAsFortran()); 873 else if (GetContext().directive == 874 llvm::omp::Directive::OMPD_declare_target) 875 context_.Say(name->source, 876 "The entity with PARAMETER attribute is used in a %s " 877 "directive"_en_US, 878 ContextDirectiveAsFortran()); 879 } else if (FindCommonBlockContaining(*name->symbol)) { 880 context_.Say(name->source, 881 "A variable in a %s directive cannot be an element of a " 882 "common block"_err_en_US, 883 ContextDirectiveAsFortran()); 884 } else if (!IsSave(*name->symbol) && 885 declScope.kind() != Scope::Kind::MainProgram && 886 declScope.kind() != Scope::Kind::Module) { 887 context_.Say(name->source, 888 "A variable that appears in a %s directive must be " 889 "declared in the scope of a module or have the SAVE " 890 "attribute, either explicitly or implicitly"_err_en_US, 891 ContextDirectiveAsFortran()); 892 } else if (FindEquivalenceSet(*name->symbol)) { 893 context_.Say(name->source, 894 "A variable in a %s directive cannot appear in an " 895 "EQUIVALENCE statement"_err_en_US, 896 ContextDirectiveAsFortran()); 897 } else if (name->symbol->test(Symbol::Flag::OmpThreadprivate) && 898 GetContext().directive == 899 llvm::omp::Directive::OMPD_declare_target) { 900 context_.Say(name->source, 901 "A THREADPRIVATE variable cannot appear in a %s " 902 "directive"_err_en_US, 903 ContextDirectiveAsFortran()); 904 } 905 } 906 }, 907 [&](const parser::Name &) {}, // common block 908 }, 909 ompObject.u); 910 } 911 } 912 913 void OmpStructureChecker::Enter(const parser::OpenMPThreadprivate &c) { 914 const auto &dir{std::get<parser::Verbatim>(c.t)}; 915 PushContextAndClauseSets( 916 dir.source, llvm::omp::Directive::OMPD_threadprivate); 917 } 918 919 void OmpStructureChecker::Leave(const parser::OpenMPThreadprivate &c) { 920 const auto &dir{std::get<parser::Verbatim>(c.t)}; 921 const auto &objectList{std::get<parser::OmpObjectList>(c.t)}; 922 CheckIsVarPartOfAnotherVar(dir.source, objectList); 923 CheckThreadprivateOrDeclareTargetVar(objectList); 924 dirContext_.pop_back(); 925 } 926 927 void OmpStructureChecker::Enter(const parser::OpenMPDeclareSimdConstruct &x) { 928 const auto &dir{std::get<parser::Verbatim>(x.t)}; 929 PushContextAndClauseSets(dir.source, llvm::omp::Directive::OMPD_declare_simd); 930 } 931 932 void OmpStructureChecker::Leave(const parser::OpenMPDeclareSimdConstruct &) { 933 dirContext_.pop_back(); 934 } 935 936 void OmpStructureChecker::Enter(const parser::OpenMPDeclarativeAllocate &x) { 937 isPredefinedAllocator = true; 938 const auto &dir{std::get<parser::Verbatim>(x.t)}; 939 const auto &objectList{std::get<parser::OmpObjectList>(x.t)}; 940 PushContextAndClauseSets(dir.source, llvm::omp::Directive::OMPD_allocate); 941 CheckIsVarPartOfAnotherVar(dir.source, objectList); 942 } 943 944 void OmpStructureChecker::Leave(const parser::OpenMPDeclarativeAllocate &x) { 945 const auto &dir{std::get<parser::Verbatim>(x.t)}; 946 const auto &objectList{std::get<parser::OmpObjectList>(x.t)}; 947 CheckPredefinedAllocatorRestriction(dir.source, objectList); 948 dirContext_.pop_back(); 949 } 950 951 void OmpStructureChecker::Enter(const parser::OmpClause::Allocator &x) { 952 CheckAllowed(llvm::omp::Clause::OMPC_allocator); 953 // Note: Predefined allocators are stored in ScalarExpr as numbers 954 // whereas custom allocators are stored as strings, so if the ScalarExpr 955 // actually has an int value, then it must be a predefined allocator 956 isPredefinedAllocator = GetIntValue(x.v).has_value(); 957 RequiresPositiveParameter(llvm::omp::Clause::OMPC_allocator, x.v); 958 } 959 960 void OmpStructureChecker::Enter(const parser::OpenMPDeclareTargetConstruct &x) { 961 const auto &dir{std::get<parser::Verbatim>(x.t)}; 962 PushContext(dir.source, llvm::omp::Directive::OMPD_declare_target); 963 const auto &spec{std::get<parser::OmpDeclareTargetSpecifier>(x.t)}; 964 if (std::holds_alternative<parser::OmpDeclareTargetWithClause>(spec.u)) { 965 SetClauseSets(llvm::omp::Directive::OMPD_declare_target); 966 } 967 } 968 969 void OmpStructureChecker::Leave(const parser::OpenMPDeclareTargetConstruct &x) { 970 const auto &dir{std::get<parser::Verbatim>(x.t)}; 971 const auto &spec{std::get<parser::OmpDeclareTargetSpecifier>(x.t)}; 972 if (const auto *objectList{parser::Unwrap<parser::OmpObjectList>(spec.u)}) { 973 CheckIsVarPartOfAnotherVar(dir.source, *objectList); 974 CheckThreadprivateOrDeclareTargetVar(*objectList); 975 } else if (const auto *clauseList{ 976 parser::Unwrap<parser::OmpClauseList>(spec.u)}) { 977 for (const auto &clause : clauseList->v) { 978 if (const auto *toClause{std::get_if<parser::OmpClause::To>(&clause.u)}) { 979 CheckIsVarPartOfAnotherVar(dir.source, toClause->v); 980 CheckThreadprivateOrDeclareTargetVar(toClause->v); 981 } else if (const auto *linkClause{ 982 std::get_if<parser::OmpClause::Link>(&clause.u)}) { 983 CheckIsVarPartOfAnotherVar(dir.source, linkClause->v); 984 CheckThreadprivateOrDeclareTargetVar(linkClause->v); 985 } 986 } 987 } 988 dirContext_.pop_back(); 989 } 990 991 void OmpStructureChecker::Enter(const parser::OpenMPExecutableAllocate &x) { 992 isPredefinedAllocator = true; 993 const auto &dir{std::get<parser::Verbatim>(x.t)}; 994 const auto &objectList{std::get<std::optional<parser::OmpObjectList>>(x.t)}; 995 PushContextAndClauseSets(dir.source, llvm::omp::Directive::OMPD_allocate); 996 if (objectList) { 997 CheckIsVarPartOfAnotherVar(dir.source, *objectList); 998 } 999 } 1000 1001 void OmpStructureChecker::Leave(const parser::OpenMPExecutableAllocate &x) { 1002 const auto &dir{std::get<parser::Verbatim>(x.t)}; 1003 const auto &objectList{std::get<std::optional<parser::OmpObjectList>>(x.t)}; 1004 if (objectList) 1005 CheckPredefinedAllocatorRestriction(dir.source, *objectList); 1006 dirContext_.pop_back(); 1007 } 1008 1009 void OmpStructureChecker::CheckBarrierNesting( 1010 const parser::OpenMPSimpleStandaloneConstruct &x) { 1011 // A barrier region may not be `closely nested` inside a worksharing, loop, 1012 // task, taskloop, critical, ordered, atomic, or master region. 1013 // TODO: Expand the check to include `LOOP` construct as well when it is 1014 // supported. 1015 if (GetContext().directive == llvm::omp::Directive::OMPD_barrier) { 1016 if (IsCloselyNestedRegion(llvm::omp::nestedBarrierErrSet)) { 1017 context_.Say(parser::FindSourceLocation(x), 1018 "`BARRIER` region may not be closely nested inside of `WORKSHARING`, " 1019 "`LOOP`, `TASK`, `TASKLOOP`," 1020 "`CRITICAL`, `ORDERED`, `ATOMIC` or `MASTER` region."_err_en_US); 1021 } 1022 } 1023 } 1024 1025 void OmpStructureChecker::ChecksOnOrderedAsStandalone() { 1026 if (FindClause(llvm::omp::Clause::OMPC_threads) || 1027 FindClause(llvm::omp::Clause::OMPC_simd)) { 1028 context_.Say(GetContext().clauseSource, 1029 "THREADS, SIMD clauses are not allowed when ORDERED construct is a " 1030 "standalone construct with no ORDERED region"_err_en_US); 1031 } 1032 1033 bool isSinkPresent{false}; 1034 int dependSourceCount{0}; 1035 auto clauseAll = FindClauses(llvm::omp::Clause::OMPC_depend); 1036 for (auto itr = clauseAll.first; itr != clauseAll.second; ++itr) { 1037 const auto &dependClause{ 1038 std::get<parser::OmpClause::Depend>(itr->second->u)}; 1039 if (std::get_if<parser::OmpDependClause::Source>(&dependClause.v.u)) { 1040 dependSourceCount++; 1041 if (isSinkPresent) { 1042 context_.Say(itr->second->source, 1043 "DEPEND(SOURCE) is not allowed when DEPEND(SINK: vec) is present " 1044 "on ORDERED directive"_err_en_US); 1045 } 1046 if (dependSourceCount > 1) { 1047 context_.Say(itr->second->source, 1048 "At most one DEPEND(SOURCE) clause can appear on the ORDERED " 1049 "directive"_err_en_US); 1050 } 1051 } else if (std::get_if<parser::OmpDependClause::Sink>(&dependClause.v.u)) { 1052 isSinkPresent = true; 1053 if (dependSourceCount > 0) { 1054 context_.Say(itr->second->source, 1055 "DEPEND(SINK: vec) is not allowed when DEPEND(SOURCE) is present " 1056 "on ORDERED directive"_err_en_US); 1057 } 1058 } else { 1059 context_.Say(itr->second->source, 1060 "Only DEPEND(SOURCE) or DEPEND(SINK: vec) are allowed when ORDERED " 1061 "construct is a standalone construct with no ORDERED " 1062 "region"_err_en_US); 1063 } 1064 } 1065 } 1066 1067 void OmpStructureChecker::Enter( 1068 const parser::OpenMPSimpleStandaloneConstruct &x) { 1069 const auto &dir{std::get<parser::OmpSimpleStandaloneDirective>(x.t)}; 1070 PushContextAndClauseSets(dir.source, dir.v); 1071 CheckBarrierNesting(x); 1072 } 1073 1074 void OmpStructureChecker::Leave( 1075 const parser::OpenMPSimpleStandaloneConstruct &) { 1076 switch (GetContext().directive) { 1077 case llvm::omp::Directive::OMPD_ordered: 1078 // [5.1] 2.19.9 Ordered Construct Restriction 1079 ChecksOnOrderedAsStandalone(); 1080 break; 1081 default: 1082 break; 1083 } 1084 dirContext_.pop_back(); 1085 } 1086 1087 void OmpStructureChecker::Enter(const parser::OpenMPFlushConstruct &x) { 1088 const auto &dir{std::get<parser::Verbatim>(x.t)}; 1089 PushContextAndClauseSets(dir.source, llvm::omp::Directive::OMPD_flush); 1090 } 1091 1092 void OmpStructureChecker::Leave(const parser::OpenMPFlushConstruct &x) { 1093 if (FindClause(llvm::omp::Clause::OMPC_acquire) || 1094 FindClause(llvm::omp::Clause::OMPC_release) || 1095 FindClause(llvm::omp::Clause::OMPC_acq_rel)) { 1096 if (const auto &flushList{ 1097 std::get<std::optional<parser::OmpObjectList>>(x.t)}) { 1098 context_.Say(parser::FindSourceLocation(flushList), 1099 "If memory-order-clause is RELEASE, ACQUIRE, or ACQ_REL, list items " 1100 "must not be specified on the FLUSH directive"_err_en_US); 1101 } 1102 } 1103 dirContext_.pop_back(); 1104 } 1105 1106 void OmpStructureChecker::Enter(const parser::OpenMPCancelConstruct &x) { 1107 const auto &dir{std::get<parser::Verbatim>(x.t)}; 1108 const auto &type{std::get<parser::OmpCancelType>(x.t)}; 1109 PushContextAndClauseSets(dir.source, llvm::omp::Directive::OMPD_cancel); 1110 CheckCancellationNest(dir.source, type.v); 1111 } 1112 1113 void OmpStructureChecker::Leave(const parser::OpenMPCancelConstruct &) { 1114 dirContext_.pop_back(); 1115 } 1116 1117 void OmpStructureChecker::Enter(const parser::OpenMPCriticalConstruct &x) { 1118 const auto &dir{std::get<parser::OmpCriticalDirective>(x.t)}; 1119 const auto &endDir{std::get<parser::OmpEndCriticalDirective>(x.t)}; 1120 PushContextAndClauseSets(dir.source, llvm::omp::Directive::OMPD_critical); 1121 const auto &block{std::get<parser::Block>(x.t)}; 1122 CheckNoBranching(block, llvm::omp::Directive::OMPD_critical, dir.source); 1123 const auto &dirName{std::get<std::optional<parser::Name>>(dir.t)}; 1124 const auto &endDirName{std::get<std::optional<parser::Name>>(endDir.t)}; 1125 const auto &ompClause{std::get<parser::OmpClauseList>(dir.t)}; 1126 if (dirName && endDirName && 1127 dirName->ToString().compare(endDirName->ToString())) { 1128 context_ 1129 .Say(endDirName->source, 1130 parser::MessageFormattedText{ 1131 "CRITICAL directive names do not match"_err_en_US}) 1132 .Attach(dirName->source, "should be "_en_US); 1133 } else if (dirName && !endDirName) { 1134 context_ 1135 .Say(dirName->source, 1136 parser::MessageFormattedText{ 1137 "CRITICAL directive names do not match"_err_en_US}) 1138 .Attach(dirName->source, "should be NULL"_en_US); 1139 } else if (!dirName && endDirName) { 1140 context_ 1141 .Say(endDirName->source, 1142 parser::MessageFormattedText{ 1143 "CRITICAL directive names do not match"_err_en_US}) 1144 .Attach(endDirName->source, "should be NULL"_en_US); 1145 } 1146 if (!dirName && !ompClause.source.empty() && 1147 ompClause.source.NULTerminatedToString() != "hint(omp_sync_hint_none)") { 1148 context_.Say(dir.source, 1149 parser::MessageFormattedText{ 1150 "Hint clause other than omp_sync_hint_none cannot be specified for an unnamed CRITICAL directive"_err_en_US}); 1151 } 1152 } 1153 1154 void OmpStructureChecker::Leave(const parser::OpenMPCriticalConstruct &) { 1155 dirContext_.pop_back(); 1156 } 1157 1158 void OmpStructureChecker::Enter( 1159 const parser::OpenMPCancellationPointConstruct &x) { 1160 const auto &dir{std::get<parser::Verbatim>(x.t)}; 1161 const auto &type{std::get<parser::OmpCancelType>(x.t)}; 1162 PushContextAndClauseSets( 1163 dir.source, llvm::omp::Directive::OMPD_cancellation_point); 1164 CheckCancellationNest(dir.source, type.v); 1165 } 1166 1167 void OmpStructureChecker::Leave( 1168 const parser::OpenMPCancellationPointConstruct &) { 1169 dirContext_.pop_back(); 1170 } 1171 1172 void OmpStructureChecker::CheckCancellationNest( 1173 const parser::CharBlock &source, const parser::OmpCancelType::Type &type) { 1174 if (CurrentDirectiveIsNested()) { 1175 // If construct-type-clause is taskgroup, the cancellation construct must be 1176 // closely nested inside a task or a taskloop construct and the cancellation 1177 // region must be closely nested inside a taskgroup region. If 1178 // construct-type-clause is sections, the cancellation construct must be 1179 // closely nested inside a sections or section construct. Otherwise, the 1180 // cancellation construct must be closely nested inside an OpenMP construct 1181 // that matches the type specified in construct-type-clause of the 1182 // cancellation construct. 1183 1184 OmpDirectiveSet allowedTaskgroupSet{ 1185 llvm::omp::Directive::OMPD_task, llvm::omp::Directive::OMPD_taskloop}; 1186 OmpDirectiveSet allowedSectionsSet{llvm::omp::Directive::OMPD_sections, 1187 llvm::omp::Directive::OMPD_parallel_sections}; 1188 OmpDirectiveSet allowedDoSet{llvm::omp::Directive::OMPD_do, 1189 llvm::omp::Directive::OMPD_distribute_parallel_do, 1190 llvm::omp::Directive::OMPD_parallel_do, 1191 llvm::omp::Directive::OMPD_target_parallel_do, 1192 llvm::omp::Directive::OMPD_target_teams_distribute_parallel_do, 1193 llvm::omp::Directive::OMPD_teams_distribute_parallel_do}; 1194 OmpDirectiveSet allowedParallelSet{llvm::omp::Directive::OMPD_parallel, 1195 llvm::omp::Directive::OMPD_target_parallel}; 1196 1197 bool eligibleCancellation{false}; 1198 switch (type) { 1199 case parser::OmpCancelType::Type::Taskgroup: 1200 if (allowedTaskgroupSet.test(GetContextParent().directive)) { 1201 eligibleCancellation = true; 1202 if (dirContext_.size() >= 3) { 1203 // Check if the cancellation region is closely nested inside a 1204 // taskgroup region when there are more than two levels of directives 1205 // in the directive context stack. 1206 if (GetContextParent().directive == llvm::omp::Directive::OMPD_task || 1207 FindClauseParent(llvm::omp::Clause::OMPC_nogroup)) { 1208 for (int i = dirContext_.size() - 3; i >= 0; i--) { 1209 if (dirContext_[i].directive == 1210 llvm::omp::Directive::OMPD_taskgroup) { 1211 break; 1212 } 1213 if (allowedParallelSet.test(dirContext_[i].directive)) { 1214 eligibleCancellation = false; 1215 break; 1216 } 1217 } 1218 } 1219 } 1220 } 1221 if (!eligibleCancellation) { 1222 context_.Say(source, 1223 "With %s clause, %s construct must be closely nested inside TASK " 1224 "or TASKLOOP construct and %s region must be closely nested inside " 1225 "TASKGROUP region"_err_en_US, 1226 parser::ToUpperCaseLetters( 1227 parser::OmpCancelType::EnumToString(type)), 1228 ContextDirectiveAsFortran(), ContextDirectiveAsFortran()); 1229 } 1230 return; 1231 case parser::OmpCancelType::Type::Sections: 1232 if (allowedSectionsSet.test(GetContextParent().directive)) { 1233 eligibleCancellation = true; 1234 } 1235 break; 1236 case Fortran::parser::OmpCancelType::Type::Do: 1237 if (allowedDoSet.test(GetContextParent().directive)) { 1238 eligibleCancellation = true; 1239 } 1240 break; 1241 case parser::OmpCancelType::Type::Parallel: 1242 if (allowedParallelSet.test(GetContextParent().directive)) { 1243 eligibleCancellation = true; 1244 } 1245 break; 1246 } 1247 if (!eligibleCancellation) { 1248 context_.Say(source, 1249 "With %s clause, %s construct cannot be closely nested inside %s " 1250 "construct"_err_en_US, 1251 parser::ToUpperCaseLetters(parser::OmpCancelType::EnumToString(type)), 1252 ContextDirectiveAsFortran(), 1253 parser::ToUpperCaseLetters( 1254 getDirectiveName(GetContextParent().directive).str())); 1255 } 1256 } else { 1257 // The cancellation directive cannot be orphaned. 1258 switch (type) { 1259 case parser::OmpCancelType::Type::Taskgroup: 1260 context_.Say(source, 1261 "%s %s directive is not closely nested inside " 1262 "TASK or TASKLOOP"_err_en_US, 1263 ContextDirectiveAsFortran(), 1264 parser::ToUpperCaseLetters( 1265 parser::OmpCancelType::EnumToString(type))); 1266 break; 1267 case parser::OmpCancelType::Type::Sections: 1268 context_.Say(source, 1269 "%s %s directive is not closely nested inside " 1270 "SECTION or SECTIONS"_err_en_US, 1271 ContextDirectiveAsFortran(), 1272 parser::ToUpperCaseLetters( 1273 parser::OmpCancelType::EnumToString(type))); 1274 break; 1275 case Fortran::parser::OmpCancelType::Type::Do: 1276 context_.Say(source, 1277 "%s %s directive is not closely nested inside " 1278 "the construct that matches the DO clause type"_err_en_US, 1279 ContextDirectiveAsFortran(), 1280 parser::ToUpperCaseLetters( 1281 parser::OmpCancelType::EnumToString(type))); 1282 break; 1283 case parser::OmpCancelType::Type::Parallel: 1284 context_.Say(source, 1285 "%s %s directive is not closely nested inside " 1286 "the construct that matches the PARALLEL clause type"_err_en_US, 1287 ContextDirectiveAsFortran(), 1288 parser::ToUpperCaseLetters( 1289 parser::OmpCancelType::EnumToString(type))); 1290 break; 1291 } 1292 } 1293 } 1294 1295 void OmpStructureChecker::Enter(const parser::OmpEndBlockDirective &x) { 1296 const auto &dir{std::get<parser::OmpBlockDirective>(x.t)}; 1297 ResetPartialContext(dir.source); 1298 switch (dir.v) { 1299 // 2.7.3 end-single-clause -> copyprivate-clause | 1300 // nowait-clause 1301 case llvm::omp::Directive::OMPD_single: 1302 PushContextAndClauseSets(dir.source, llvm::omp::Directive::OMPD_end_single); 1303 break; 1304 // 2.7.4 end-workshare -> END WORKSHARE [nowait-clause] 1305 case llvm::omp::Directive::OMPD_workshare: 1306 PushContextAndClauseSets( 1307 dir.source, llvm::omp::Directive::OMPD_end_workshare); 1308 break; 1309 default: 1310 // no clauses are allowed 1311 break; 1312 } 1313 } 1314 1315 // TODO: Verify the popping of dirContext requirement after nowait 1316 // implementation, as there is an implicit barrier at the end of the worksharing 1317 // constructs unless a nowait clause is specified. Only OMPD_end_single and 1318 // end_workshareare popped as they are pushed while entering the 1319 // EndBlockDirective. 1320 void OmpStructureChecker::Leave(const parser::OmpEndBlockDirective &x) { 1321 if ((GetContext().directive == llvm::omp::Directive::OMPD_end_single) || 1322 (GetContext().directive == llvm::omp::Directive::OMPD_end_workshare)) { 1323 dirContext_.pop_back(); 1324 } 1325 } 1326 1327 void OmpStructureChecker::Enter(const parser::OpenMPAtomicConstruct &x) { 1328 std::visit( 1329 common::visitors{ 1330 [&](const auto &someAtomicConstruct) { 1331 const auto &dir{std::get<parser::Verbatim>(someAtomicConstruct.t)}; 1332 PushContextAndClauseSets( 1333 dir.source, llvm::omp::Directive::OMPD_atomic); 1334 }, 1335 }, 1336 x.u); 1337 } 1338 1339 void OmpStructureChecker::Leave(const parser::OpenMPAtomicConstruct &) { 1340 dirContext_.pop_back(); 1341 } 1342 1343 // Clauses 1344 // Mainly categorized as 1345 // 1. Checks on 'OmpClauseList' from 'parse-tree.h'. 1346 // 2. Checks on clauses which fall under 'struct OmpClause' from parse-tree.h. 1347 // 3. Checks on clauses which are not in 'struct OmpClause' from parse-tree.h. 1348 1349 void OmpStructureChecker::Leave(const parser::OmpClauseList &) { 1350 // 2.7.1 Loop Construct Restriction 1351 if (llvm::omp::doSet.test(GetContext().directive)) { 1352 if (auto *clause{FindClause(llvm::omp::Clause::OMPC_schedule)}) { 1353 // only one schedule clause is allowed 1354 const auto &schedClause{std::get<parser::OmpClause::Schedule>(clause->u)}; 1355 if (ScheduleModifierHasType(schedClause.v, 1356 parser::OmpScheduleModifierType::ModType::Nonmonotonic)) { 1357 if (FindClause(llvm::omp::Clause::OMPC_ordered)) { 1358 context_.Say(clause->source, 1359 "The NONMONOTONIC modifier cannot be specified " 1360 "if an ORDERED clause is specified"_err_en_US); 1361 } 1362 if (ScheduleModifierHasType(schedClause.v, 1363 parser::OmpScheduleModifierType::ModType::Monotonic)) { 1364 context_.Say(clause->source, 1365 "The MONOTONIC and NONMONOTONIC modifiers " 1366 "cannot be both specified"_err_en_US); 1367 } 1368 } 1369 } 1370 1371 if (auto *clause{FindClause(llvm::omp::Clause::OMPC_ordered)}) { 1372 // only one ordered clause is allowed 1373 const auto &orderedClause{ 1374 std::get<parser::OmpClause::Ordered>(clause->u)}; 1375 1376 if (orderedClause.v) { 1377 CheckNotAllowedIfClause( 1378 llvm::omp::Clause::OMPC_ordered, {llvm::omp::Clause::OMPC_linear}); 1379 1380 if (auto *clause2{FindClause(llvm::omp::Clause::OMPC_collapse)}) { 1381 const auto &collapseClause{ 1382 std::get<parser::OmpClause::Collapse>(clause2->u)}; 1383 // ordered and collapse both have parameters 1384 if (const auto orderedValue{GetIntValue(orderedClause.v)}) { 1385 if (const auto collapseValue{GetIntValue(collapseClause.v)}) { 1386 if (*orderedValue > 0 && *orderedValue < *collapseValue) { 1387 context_.Say(clause->source, 1388 "The parameter of the ORDERED clause must be " 1389 "greater than or equal to " 1390 "the parameter of the COLLAPSE clause"_err_en_US); 1391 } 1392 } 1393 } 1394 } 1395 } 1396 1397 // TODO: ordered region binding check (requires nesting implementation) 1398 } 1399 } // doSet 1400 1401 // 2.8.1 Simd Construct Restriction 1402 if (llvm::omp::simdSet.test(GetContext().directive)) { 1403 if (auto *clause{FindClause(llvm::omp::Clause::OMPC_simdlen)}) { 1404 if (auto *clause2{FindClause(llvm::omp::Clause::OMPC_safelen)}) { 1405 const auto &simdlenClause{ 1406 std::get<parser::OmpClause::Simdlen>(clause->u)}; 1407 const auto &safelenClause{ 1408 std::get<parser::OmpClause::Safelen>(clause2->u)}; 1409 // simdlen and safelen both have parameters 1410 if (const auto simdlenValue{GetIntValue(simdlenClause.v)}) { 1411 if (const auto safelenValue{GetIntValue(safelenClause.v)}) { 1412 if (*safelenValue > 0 && *simdlenValue > *safelenValue) { 1413 context_.Say(clause->source, 1414 "The parameter of the SIMDLEN clause must be less than or " 1415 "equal to the parameter of the SAFELEN clause"_err_en_US); 1416 } 1417 } 1418 } 1419 } 1420 } 1421 // A list-item cannot appear in more than one aligned clause 1422 semantics::UnorderedSymbolSet alignedVars; 1423 auto clauseAll = FindClauses(llvm::omp::Clause::OMPC_aligned); 1424 for (auto itr = clauseAll.first; itr != clauseAll.second; ++itr) { 1425 const auto &alignedClause{ 1426 std::get<parser::OmpClause::Aligned>(itr->second->u)}; 1427 const auto &alignedNameList{ 1428 std::get<std::list<parser::Name>>(alignedClause.v.t)}; 1429 for (auto const &var : alignedNameList) { 1430 if (alignedVars.count(*(var.symbol)) == 1) { 1431 context_.Say(itr->second->source, 1432 "List item '%s' present at multiple ALIGNED clauses"_err_en_US, 1433 var.ToString()); 1434 break; 1435 } 1436 alignedVars.insert(*(var.symbol)); 1437 } 1438 } 1439 } // SIMD 1440 1441 // 2.7.3 Single Construct Restriction 1442 if (GetContext().directive == llvm::omp::Directive::OMPD_end_single) { 1443 CheckNotAllowedIfClause( 1444 llvm::omp::Clause::OMPC_copyprivate, {llvm::omp::Clause::OMPC_nowait}); 1445 } 1446 1447 auto testThreadprivateVarErr = [&](Symbol sym, parser::Name name, 1448 llvmOmpClause clauseTy) { 1449 if (sym.test(Symbol::Flag::OmpThreadprivate)) 1450 context_.Say(name.source, 1451 "A THREADPRIVATE variable cannot be in %s clause"_err_en_US, 1452 parser::ToUpperCaseLetters(getClauseName(clauseTy).str())); 1453 }; 1454 1455 // [5.1] 2.21.2 Threadprivate Directive Restriction 1456 OmpClauseSet threadprivateAllowedSet{llvm::omp::Clause::OMPC_copyin, 1457 llvm::omp::Clause::OMPC_copyprivate, llvm::omp::Clause::OMPC_schedule, 1458 llvm::omp::Clause::OMPC_num_threads, llvm::omp::Clause::OMPC_thread_limit, 1459 llvm::omp::Clause::OMPC_if}; 1460 for (auto it : GetContext().clauseInfo) { 1461 llvmOmpClause type = it.first; 1462 const auto *clause = it.second; 1463 if (!threadprivateAllowedSet.test(type)) { 1464 if (const auto *objList{GetOmpObjectList(*clause)}) { 1465 for (const auto &ompObject : objList->v) { 1466 std::visit( 1467 common::visitors{ 1468 [&](const parser::Designator &) { 1469 if (const auto *name{ 1470 parser::Unwrap<parser::Name>(ompObject)}) 1471 testThreadprivateVarErr( 1472 name->symbol->GetUltimate(), *name, type); 1473 }, 1474 [&](const parser::Name &name) { 1475 if (name.symbol) { 1476 for (const auto &mem : 1477 name.symbol->get<CommonBlockDetails>().objects()) { 1478 testThreadprivateVarErr(mem->GetUltimate(), name, type); 1479 break; 1480 } 1481 } 1482 }, 1483 }, 1484 ompObject.u); 1485 } 1486 } 1487 } 1488 } 1489 1490 CheckRequireAtLeastOneOf(); 1491 } 1492 1493 void OmpStructureChecker::Enter(const parser::OmpClause &x) { 1494 SetContextClause(x); 1495 } 1496 1497 // Following clauses do not have a separate node in parse-tree.h. 1498 CHECK_SIMPLE_CLAUSE(AcqRel, OMPC_acq_rel) 1499 CHECK_SIMPLE_CLAUSE(Acquire, OMPC_acquire) 1500 CHECK_SIMPLE_CLAUSE(AtomicDefaultMemOrder, OMPC_atomic_default_mem_order) 1501 CHECK_SIMPLE_CLAUSE(Affinity, OMPC_affinity) 1502 CHECK_SIMPLE_CLAUSE(Allocate, OMPC_allocate) 1503 CHECK_SIMPLE_CLAUSE(Capture, OMPC_capture) 1504 CHECK_SIMPLE_CLAUSE(Copyin, OMPC_copyin) 1505 CHECK_SIMPLE_CLAUSE(Default, OMPC_default) 1506 CHECK_SIMPLE_CLAUSE(Depobj, OMPC_depobj) 1507 CHECK_SIMPLE_CLAUSE(Destroy, OMPC_destroy) 1508 CHECK_SIMPLE_CLAUSE(Detach, OMPC_detach) 1509 CHECK_SIMPLE_CLAUSE(Device, OMPC_device) 1510 CHECK_SIMPLE_CLAUSE(DeviceType, OMPC_device_type) 1511 CHECK_SIMPLE_CLAUSE(DistSchedule, OMPC_dist_schedule) 1512 CHECK_SIMPLE_CLAUSE(DynamicAllocators, OMPC_dynamic_allocators) 1513 CHECK_SIMPLE_CLAUSE(Exclusive, OMPC_exclusive) 1514 CHECK_SIMPLE_CLAUSE(Final, OMPC_final) 1515 CHECK_SIMPLE_CLAUSE(Flush, OMPC_flush) 1516 CHECK_SIMPLE_CLAUSE(From, OMPC_from) 1517 CHECK_SIMPLE_CLAUSE(Full, OMPC_full) 1518 CHECK_SIMPLE_CLAUSE(Hint, OMPC_hint) 1519 CHECK_SIMPLE_CLAUSE(InReduction, OMPC_in_reduction) 1520 CHECK_SIMPLE_CLAUSE(Inclusive, OMPC_inclusive) 1521 CHECK_SIMPLE_CLAUSE(Match, OMPC_match) 1522 CHECK_SIMPLE_CLAUSE(Nontemporal, OMPC_nontemporal) 1523 CHECK_SIMPLE_CLAUSE(Order, OMPC_order) 1524 CHECK_SIMPLE_CLAUSE(Read, OMPC_read) 1525 CHECK_SIMPLE_CLAUSE(ReverseOffload, OMPC_reverse_offload) 1526 CHECK_SIMPLE_CLAUSE(Threadprivate, OMPC_threadprivate) 1527 CHECK_SIMPLE_CLAUSE(Threads, OMPC_threads) 1528 CHECK_SIMPLE_CLAUSE(Inbranch, OMPC_inbranch) 1529 CHECK_SIMPLE_CLAUSE(IsDevicePtr, OMPC_is_device_ptr) 1530 CHECK_SIMPLE_CLAUSE(Link, OMPC_link) 1531 CHECK_SIMPLE_CLAUSE(Mergeable, OMPC_mergeable) 1532 CHECK_SIMPLE_CLAUSE(Nogroup, OMPC_nogroup) 1533 CHECK_SIMPLE_CLAUSE(Notinbranch, OMPC_notinbranch) 1534 CHECK_SIMPLE_CLAUSE(Nowait, OMPC_nowait) 1535 CHECK_SIMPLE_CLAUSE(Partial, OMPC_partial) 1536 CHECK_SIMPLE_CLAUSE(ProcBind, OMPC_proc_bind) 1537 CHECK_SIMPLE_CLAUSE(Release, OMPC_release) 1538 CHECK_SIMPLE_CLAUSE(Relaxed, OMPC_relaxed) 1539 CHECK_SIMPLE_CLAUSE(SeqCst, OMPC_seq_cst) 1540 CHECK_SIMPLE_CLAUSE(Simd, OMPC_simd) 1541 CHECK_SIMPLE_CLAUSE(Sizes, OMPC_sizes) 1542 CHECK_SIMPLE_CLAUSE(TaskReduction, OMPC_task_reduction) 1543 CHECK_SIMPLE_CLAUSE(To, OMPC_to) 1544 CHECK_SIMPLE_CLAUSE(UnifiedAddress, OMPC_unified_address) 1545 CHECK_SIMPLE_CLAUSE(UnifiedSharedMemory, OMPC_unified_shared_memory) 1546 CHECK_SIMPLE_CLAUSE(Uniform, OMPC_uniform) 1547 CHECK_SIMPLE_CLAUSE(Unknown, OMPC_unknown) 1548 CHECK_SIMPLE_CLAUSE(Untied, OMPC_untied) 1549 CHECK_SIMPLE_CLAUSE(UseDevicePtr, OMPC_use_device_ptr) 1550 CHECK_SIMPLE_CLAUSE(UsesAllocators, OMPC_uses_allocators) 1551 CHECK_SIMPLE_CLAUSE(Update, OMPC_update) 1552 CHECK_SIMPLE_CLAUSE(UseDeviceAddr, OMPC_use_device_addr) 1553 CHECK_SIMPLE_CLAUSE(Write, OMPC_write) 1554 CHECK_SIMPLE_CLAUSE(Init, OMPC_init) 1555 CHECK_SIMPLE_CLAUSE(Use, OMPC_use) 1556 CHECK_SIMPLE_CLAUSE(Novariants, OMPC_novariants) 1557 CHECK_SIMPLE_CLAUSE(Nocontext, OMPC_nocontext) 1558 CHECK_SIMPLE_CLAUSE(Filter, OMPC_filter) 1559 CHECK_SIMPLE_CLAUSE(When, OMPC_when) 1560 CHECK_SIMPLE_CLAUSE(AdjustArgs, OMPC_adjust_args) 1561 CHECK_SIMPLE_CLAUSE(AppendArgs, OMPC_append_args) 1562 CHECK_SIMPLE_CLAUSE(MemoryOrder, OMPC_memory_order) 1563 CHECK_SIMPLE_CLAUSE(Bind, OMPC_bind) 1564 CHECK_SIMPLE_CLAUSE(Align, OMPC_align) 1565 CHECK_SIMPLE_CLAUSE(Compare, OMPC_compare) 1566 1567 CHECK_REQ_SCALAR_INT_CLAUSE(Grainsize, OMPC_grainsize) 1568 CHECK_REQ_SCALAR_INT_CLAUSE(NumTasks, OMPC_num_tasks) 1569 CHECK_REQ_SCALAR_INT_CLAUSE(NumTeams, OMPC_num_teams) 1570 CHECK_REQ_SCALAR_INT_CLAUSE(NumThreads, OMPC_num_threads) 1571 CHECK_REQ_SCALAR_INT_CLAUSE(Priority, OMPC_priority) 1572 CHECK_REQ_SCALAR_INT_CLAUSE(ThreadLimit, OMPC_thread_limit) 1573 1574 CHECK_REQ_CONSTANT_SCALAR_INT_CLAUSE(Collapse, OMPC_collapse) 1575 CHECK_REQ_CONSTANT_SCALAR_INT_CLAUSE(Safelen, OMPC_safelen) 1576 CHECK_REQ_CONSTANT_SCALAR_INT_CLAUSE(Simdlen, OMPC_simdlen) 1577 1578 // Restrictions specific to each clause are implemented apart from the 1579 // generalized restrictions. 1580 void OmpStructureChecker::Enter(const parser::OmpClause::Reduction &x) { 1581 CheckAllowed(llvm::omp::Clause::OMPC_reduction); 1582 if (CheckReductionOperators(x)) { 1583 CheckReductionTypeList(x); 1584 } 1585 } 1586 bool OmpStructureChecker::CheckReductionOperators( 1587 const parser::OmpClause::Reduction &x) { 1588 1589 const auto &definedOp{std::get<0>(x.v.t)}; 1590 bool ok = false; 1591 std::visit( 1592 common::visitors{ 1593 [&](const parser::DefinedOperator &dOpr) { 1594 const auto &intrinsicOp{ 1595 std::get<parser::DefinedOperator::IntrinsicOperator>(dOpr.u)}; 1596 ok = CheckIntrinsicOperator(intrinsicOp); 1597 }, 1598 [&](const parser::ProcedureDesignator &procD) { 1599 const parser::Name *name{std::get_if<parser::Name>(&procD.u)}; 1600 if (name) { 1601 if (name->source == "max" || name->source == "min" || 1602 name->source == "iand" || name->source == "ior" || 1603 name->source == "ieor") { 1604 ok = true; 1605 } else { 1606 context_.Say(GetContext().clauseSource, 1607 "Invalid reduction identifier in REDUCTION clause."_err_en_US, 1608 ContextDirectiveAsFortran()); 1609 } 1610 } 1611 }, 1612 }, 1613 definedOp.u); 1614 1615 return ok; 1616 } 1617 bool OmpStructureChecker::CheckIntrinsicOperator( 1618 const parser::DefinedOperator::IntrinsicOperator &op) { 1619 1620 switch (op) { 1621 case parser::DefinedOperator::IntrinsicOperator::Add: 1622 case parser::DefinedOperator::IntrinsicOperator::Subtract: 1623 case parser::DefinedOperator::IntrinsicOperator::Multiply: 1624 case parser::DefinedOperator::IntrinsicOperator::AND: 1625 case parser::DefinedOperator::IntrinsicOperator::OR: 1626 case parser::DefinedOperator::IntrinsicOperator::EQV: 1627 case parser::DefinedOperator::IntrinsicOperator::NEQV: 1628 return true; 1629 default: 1630 context_.Say(GetContext().clauseSource, 1631 "Invalid reduction operator in REDUCTION clause."_err_en_US, 1632 ContextDirectiveAsFortran()); 1633 } 1634 return false; 1635 } 1636 1637 void OmpStructureChecker::CheckReductionTypeList( 1638 const parser::OmpClause::Reduction &x) { 1639 const auto &ompObjectList{std::get<parser::OmpObjectList>(x.v.t)}; 1640 CheckIntentInPointerAndDefinable( 1641 ompObjectList, llvm::omp::Clause::OMPC_reduction); 1642 CheckReductionArraySection(ompObjectList); 1643 CheckMultipleAppearanceAcrossContext(ompObjectList); 1644 } 1645 1646 void OmpStructureChecker::CheckIntentInPointerAndDefinable( 1647 const parser::OmpObjectList &objectList, const llvm::omp::Clause clause) { 1648 for (const auto &ompObject : objectList.v) { 1649 if (const auto *name{parser::Unwrap<parser::Name>(ompObject)}) { 1650 if (const auto *symbol{name->symbol}) { 1651 if (IsPointer(symbol->GetUltimate()) && 1652 IsIntentIn(symbol->GetUltimate())) { 1653 context_.Say(GetContext().clauseSource, 1654 "Pointer '%s' with the INTENT(IN) attribute may not appear " 1655 "in a %s clause"_err_en_US, 1656 symbol->name(), 1657 parser::ToUpperCaseLetters(getClauseName(clause).str())); 1658 } 1659 if (auto msg{ 1660 WhyNotModifiable(*symbol, context_.FindScope(name->source))}) { 1661 context_.Say(GetContext().clauseSource, 1662 "Variable '%s' on the %s clause is not definable"_err_en_US, 1663 symbol->name(), 1664 parser::ToUpperCaseLetters(getClauseName(clause).str())); 1665 } 1666 } 1667 } 1668 } 1669 } 1670 1671 void OmpStructureChecker::CheckReductionArraySection( 1672 const parser::OmpObjectList &ompObjectList) { 1673 for (const auto &ompObject : ompObjectList.v) { 1674 if (const auto *dataRef{parser::Unwrap<parser::DataRef>(ompObject)}) { 1675 if (const auto *arrayElement{ 1676 parser::Unwrap<parser::ArrayElement>(ompObject)}) { 1677 if (arrayElement) { 1678 CheckArraySection(*arrayElement, GetLastName(*dataRef), 1679 llvm::omp::Clause::OMPC_reduction); 1680 } 1681 } 1682 } 1683 } 1684 } 1685 1686 void OmpStructureChecker::CheckMultipleAppearanceAcrossContext( 1687 const parser::OmpObjectList &redObjectList) { 1688 // TODO: Verify the assumption here that the immediately enclosing region is 1689 // the parallel region to which the worksharing construct having reduction 1690 // binds to. 1691 if (auto *enclosingContext{GetEnclosingDirContext()}) { 1692 for (auto it : enclosingContext->clauseInfo) { 1693 llvmOmpClause type = it.first; 1694 const auto *clause = it.second; 1695 if (llvm::omp::privateReductionSet.test(type)) { 1696 if (const auto *objList{GetOmpObjectList(*clause)}) { 1697 for (const auto &ompObject : objList->v) { 1698 if (const auto *name{parser::Unwrap<parser::Name>(ompObject)}) { 1699 if (const auto *symbol{name->symbol}) { 1700 for (const auto &redOmpObject : redObjectList.v) { 1701 if (const auto *rname{ 1702 parser::Unwrap<parser::Name>(redOmpObject)}) { 1703 if (const auto *rsymbol{rname->symbol}) { 1704 if (rsymbol->name() == symbol->name()) { 1705 context_.Say(GetContext().clauseSource, 1706 "%s variable '%s' is %s in outer context must" 1707 " be shared in the parallel regions to which any" 1708 " of the worksharing regions arising from the " 1709 "worksharing" 1710 " construct bind."_err_en_US, 1711 parser::ToUpperCaseLetters( 1712 getClauseName(llvm::omp::Clause::OMPC_reduction) 1713 .str()), 1714 symbol->name(), 1715 parser::ToUpperCaseLetters( 1716 getClauseName(type).str())); 1717 } 1718 } 1719 } 1720 } 1721 } 1722 } 1723 } 1724 } 1725 } 1726 } 1727 } 1728 } 1729 1730 void OmpStructureChecker::Enter(const parser::OmpClause::Ordered &x) { 1731 CheckAllowed(llvm::omp::Clause::OMPC_ordered); 1732 // the parameter of ordered clause is optional 1733 if (const auto &expr{x.v}) { 1734 RequiresConstantPositiveParameter(llvm::omp::Clause::OMPC_ordered, *expr); 1735 // 2.8.3 Loop SIMD Construct Restriction 1736 if (llvm::omp::doSimdSet.test(GetContext().directive)) { 1737 context_.Say(GetContext().clauseSource, 1738 "No ORDERED clause with a parameter can be specified " 1739 "on the %s directive"_err_en_US, 1740 ContextDirectiveAsFortran()); 1741 } 1742 } 1743 } 1744 1745 void OmpStructureChecker::Enter(const parser::OmpClause::Shared &x) { 1746 CheckAllowed(llvm::omp::Clause::OMPC_shared); 1747 CheckIsVarPartOfAnotherVar(GetContext().clauseSource, x.v); 1748 } 1749 void OmpStructureChecker::Enter(const parser::OmpClause::Private &x) { 1750 CheckAllowed(llvm::omp::Clause::OMPC_private); 1751 CheckIsVarPartOfAnotherVar(GetContext().clauseSource, x.v); 1752 CheckIntentInPointer(x.v, llvm::omp::Clause::OMPC_private); 1753 } 1754 1755 bool OmpStructureChecker::IsDataRefTypeParamInquiry( 1756 const parser::DataRef *dataRef) { 1757 bool dataRefIsTypeParamInquiry{false}; 1758 if (const auto *structComp{ 1759 parser::Unwrap<parser::StructureComponent>(dataRef)}) { 1760 if (const auto *compSymbol{structComp->component.symbol}) { 1761 if (const auto *compSymbolMiscDetails{ 1762 std::get_if<MiscDetails>(&compSymbol->details())}) { 1763 const auto detailsKind = compSymbolMiscDetails->kind(); 1764 dataRefIsTypeParamInquiry = 1765 (detailsKind == MiscDetails::Kind::KindParamInquiry || 1766 detailsKind == MiscDetails::Kind::LenParamInquiry); 1767 } else if (compSymbol->has<TypeParamDetails>()) { 1768 dataRefIsTypeParamInquiry = true; 1769 } 1770 } 1771 } 1772 return dataRefIsTypeParamInquiry; 1773 } 1774 1775 void OmpStructureChecker::CheckIsVarPartOfAnotherVar( 1776 const parser::CharBlock &source, const parser::OmpObjectList &objList) { 1777 OmpDirectiveSet nonPartialVarSet{llvm::omp::Directive::OMPD_allocate, 1778 llvm::omp::Directive::OMPD_threadprivate, 1779 llvm::omp::Directive::OMPD_declare_target}; 1780 for (const auto &ompObject : objList.v) { 1781 std::visit( 1782 common::visitors{ 1783 [&](const parser::Designator &designator) { 1784 if (const auto *dataRef{ 1785 std::get_if<parser::DataRef>(&designator.u)}) { 1786 if (IsDataRefTypeParamInquiry(dataRef)) { 1787 context_.Say(source, 1788 "A type parameter inquiry cannot appear on the %s " 1789 "directive"_err_en_US, 1790 ContextDirectiveAsFortran()); 1791 } else if (parser::Unwrap<parser::StructureComponent>( 1792 ompObject) || 1793 parser::Unwrap<parser::ArrayElement>(ompObject)) { 1794 if (nonPartialVarSet.test(GetContext().directive)) { 1795 context_.Say(source, 1796 "A variable that is part of another variable (as an " 1797 "array or structure element) cannot appear on the %s " 1798 "directive"_err_en_US, 1799 ContextDirectiveAsFortran()); 1800 } else { 1801 context_.Say(source, 1802 "A variable that is part of another variable (as an " 1803 "array or structure element) cannot appear in a " 1804 "PRIVATE or SHARED clause"_err_en_US); 1805 } 1806 } 1807 } 1808 }, 1809 [&](const parser::Name &name) {}, 1810 }, 1811 ompObject.u); 1812 } 1813 } 1814 1815 void OmpStructureChecker::Enter(const parser::OmpClause::Firstprivate &x) { 1816 CheckAllowed(llvm::omp::Clause::OMPC_firstprivate); 1817 CheckIsLoopIvPartOfClause(llvmOmpClause::OMPC_firstprivate, x.v); 1818 1819 SymbolSourceMap currSymbols; 1820 GetSymbolsInObjectList(x.v, currSymbols); 1821 1822 DirectivesClauseTriple dirClauseTriple; 1823 // Check firstprivate variables in worksharing constructs 1824 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_do, 1825 std::make_pair( 1826 llvm::omp::Directive::OMPD_parallel, llvm::omp::privateReductionSet)); 1827 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_sections, 1828 std::make_pair( 1829 llvm::omp::Directive::OMPD_parallel, llvm::omp::privateReductionSet)); 1830 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_single, 1831 std::make_pair( 1832 llvm::omp::Directive::OMPD_parallel, llvm::omp::privateReductionSet)); 1833 // Check firstprivate variables in distribute construct 1834 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_distribute, 1835 std::make_pair( 1836 llvm::omp::Directive::OMPD_teams, llvm::omp::privateReductionSet)); 1837 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_distribute, 1838 std::make_pair(llvm::omp::Directive::OMPD_target_teams, 1839 llvm::omp::privateReductionSet)); 1840 // Check firstprivate variables in task and taskloop constructs 1841 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_task, 1842 std::make_pair(llvm::omp::Directive::OMPD_parallel, 1843 OmpClauseSet{llvm::omp::Clause::OMPC_reduction})); 1844 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_taskloop, 1845 std::make_pair(llvm::omp::Directive::OMPD_parallel, 1846 OmpClauseSet{llvm::omp::Clause::OMPC_reduction})); 1847 1848 CheckPrivateSymbolsInOuterCxt( 1849 currSymbols, dirClauseTriple, llvm::omp::Clause::OMPC_firstprivate); 1850 } 1851 1852 void OmpStructureChecker::CheckIsLoopIvPartOfClause( 1853 llvmOmpClause clause, const parser::OmpObjectList &ompObjectList) { 1854 for (const auto &ompObject : ompObjectList.v) { 1855 if (const parser::Name * name{parser::Unwrap<parser::Name>(ompObject)}) { 1856 if (name->symbol == GetContext().loopIV) { 1857 context_.Say(name->source, 1858 "DO iteration variable %s is not allowed in %s clause."_err_en_US, 1859 name->ToString(), 1860 parser::ToUpperCaseLetters(getClauseName(clause).str())); 1861 } 1862 } 1863 } 1864 } 1865 // Following clauses have a seperate node in parse-tree.h. 1866 // Atomic-clause 1867 CHECK_SIMPLE_PARSER_CLAUSE(OmpAtomicRead, OMPC_read) 1868 CHECK_SIMPLE_PARSER_CLAUSE(OmpAtomicWrite, OMPC_write) 1869 CHECK_SIMPLE_PARSER_CLAUSE(OmpAtomicUpdate, OMPC_update) 1870 CHECK_SIMPLE_PARSER_CLAUSE(OmpAtomicCapture, OMPC_capture) 1871 1872 void OmpStructureChecker::Leave(const parser::OmpAtomicRead &) { 1873 CheckNotAllowedIfClause(llvm::omp::Clause::OMPC_read, 1874 {llvm::omp::Clause::OMPC_release, llvm::omp::Clause::OMPC_acq_rel}); 1875 } 1876 void OmpStructureChecker::Leave(const parser::OmpAtomicWrite &) { 1877 CheckNotAllowedIfClause(llvm::omp::Clause::OMPC_write, 1878 {llvm::omp::Clause::OMPC_acquire, llvm::omp::Clause::OMPC_acq_rel}); 1879 } 1880 void OmpStructureChecker::Leave(const parser::OmpAtomicUpdate &) { 1881 CheckNotAllowedIfClause(llvm::omp::Clause::OMPC_update, 1882 {llvm::omp::Clause::OMPC_acquire, llvm::omp::Clause::OMPC_acq_rel}); 1883 } 1884 // OmpAtomic node represents atomic directive without atomic-clause. 1885 // atomic-clause - READ,WRITE,UPDATE,CAPTURE. 1886 void OmpStructureChecker::Leave(const parser::OmpAtomic &) { 1887 if (const auto *clause{FindClause(llvm::omp::Clause::OMPC_acquire)}) { 1888 context_.Say(clause->source, 1889 "Clause ACQUIRE is not allowed on the ATOMIC directive"_err_en_US); 1890 } 1891 if (const auto *clause{FindClause(llvm::omp::Clause::OMPC_acq_rel)}) { 1892 context_.Say(clause->source, 1893 "Clause ACQ_REL is not allowed on the ATOMIC directive"_err_en_US); 1894 } 1895 } 1896 // Restrictions specific to each clause are implemented apart from the 1897 // generalized restrictions. 1898 void OmpStructureChecker::Enter(const parser::OmpClause::Aligned &x) { 1899 CheckAllowed(llvm::omp::Clause::OMPC_aligned); 1900 1901 if (const auto &expr{ 1902 std::get<std::optional<parser::ScalarIntConstantExpr>>(x.v.t)}) { 1903 RequiresConstantPositiveParameter(llvm::omp::Clause::OMPC_aligned, *expr); 1904 } 1905 // 2.8.1 TODO: list-item attribute check 1906 } 1907 void OmpStructureChecker::Enter(const parser::OmpClause::Defaultmap &x) { 1908 CheckAllowed(llvm::omp::Clause::OMPC_defaultmap); 1909 using VariableCategory = parser::OmpDefaultmapClause::VariableCategory; 1910 if (!std::get<std::optional<VariableCategory>>(x.v.t)) { 1911 context_.Say(GetContext().clauseSource, 1912 "The argument TOFROM:SCALAR must be specified on the DEFAULTMAP " 1913 "clause"_err_en_US); 1914 } 1915 } 1916 void OmpStructureChecker::Enter(const parser::OmpClause::If &x) { 1917 CheckAllowed(llvm::omp::Clause::OMPC_if); 1918 using dirNameModifier = parser::OmpIfClause::DirectiveNameModifier; 1919 static std::unordered_map<dirNameModifier, OmpDirectiveSet> 1920 dirNameModifierMap{{dirNameModifier::Parallel, llvm::omp::parallelSet}, 1921 {dirNameModifier::Target, llvm::omp::targetSet}, 1922 {dirNameModifier::TargetEnterData, 1923 {llvm::omp::Directive::OMPD_target_enter_data}}, 1924 {dirNameModifier::TargetExitData, 1925 {llvm::omp::Directive::OMPD_target_exit_data}}, 1926 {dirNameModifier::TargetData, 1927 {llvm::omp::Directive::OMPD_target_data}}, 1928 {dirNameModifier::TargetUpdate, 1929 {llvm::omp::Directive::OMPD_target_update}}, 1930 {dirNameModifier::Task, {llvm::omp::Directive::OMPD_task}}, 1931 {dirNameModifier::Taskloop, llvm::omp::taskloopSet}}; 1932 if (const auto &directiveName{ 1933 std::get<std::optional<dirNameModifier>>(x.v.t)}) { 1934 auto search{dirNameModifierMap.find(*directiveName)}; 1935 if (search == dirNameModifierMap.end() || 1936 !search->second.test(GetContext().directive)) { 1937 context_ 1938 .Say(GetContext().clauseSource, 1939 "Unmatched directive name modifier %s on the IF clause"_err_en_US, 1940 parser::ToUpperCaseLetters( 1941 parser::OmpIfClause::EnumToString(*directiveName))) 1942 .Attach( 1943 GetContext().directiveSource, "Cannot apply to directive"_en_US); 1944 } 1945 } 1946 } 1947 1948 void OmpStructureChecker::Enter(const parser::OmpClause::Linear &x) { 1949 CheckAllowed(llvm::omp::Clause::OMPC_linear); 1950 1951 // 2.7 Loop Construct Restriction 1952 if ((llvm::omp::doSet | llvm::omp::simdSet).test(GetContext().directive)) { 1953 if (std::holds_alternative<parser::OmpLinearClause::WithModifier>(x.v.u)) { 1954 context_.Say(GetContext().clauseSource, 1955 "A modifier may not be specified in a LINEAR clause " 1956 "on the %s directive"_err_en_US, 1957 ContextDirectiveAsFortran()); 1958 } 1959 } 1960 } 1961 1962 void OmpStructureChecker::CheckAllowedMapTypes( 1963 const parser::OmpMapType::Type &type, 1964 const std::list<parser::OmpMapType::Type> &allowedMapTypeList) { 1965 const auto found{std::find( 1966 std::begin(allowedMapTypeList), std::end(allowedMapTypeList), type)}; 1967 if (found == std::end(allowedMapTypeList)) { 1968 std::string commaSeperatedMapTypes; 1969 llvm::interleave( 1970 allowedMapTypeList.begin(), allowedMapTypeList.end(), 1971 [&](const parser::OmpMapType::Type &mapType) { 1972 commaSeperatedMapTypes.append(parser::ToUpperCaseLetters( 1973 parser::OmpMapType::EnumToString(mapType))); 1974 }, 1975 [&] { commaSeperatedMapTypes.append(", "); }); 1976 context_.Say(GetContext().clauseSource, 1977 "Only the %s map types are permitted " 1978 "for MAP clauses on the %s directive"_err_en_US, 1979 commaSeperatedMapTypes, ContextDirectiveAsFortran()); 1980 } 1981 } 1982 1983 void OmpStructureChecker::Enter(const parser::OmpClause::Map &x) { 1984 CheckAllowed(llvm::omp::Clause::OMPC_map); 1985 1986 if (const auto &maptype{std::get<std::optional<parser::OmpMapType>>(x.v.t)}) { 1987 using Type = parser::OmpMapType::Type; 1988 const Type &type{std::get<Type>(maptype->t)}; 1989 switch (GetContext().directive) { 1990 case llvm::omp::Directive::OMPD_target: 1991 case llvm::omp::Directive::OMPD_target_teams: 1992 case llvm::omp::Directive::OMPD_target_teams_distribute: 1993 case llvm::omp::Directive::OMPD_target_teams_distribute_simd: 1994 case llvm::omp::Directive::OMPD_target_teams_distribute_parallel_do: 1995 case llvm::omp::Directive::OMPD_target_teams_distribute_parallel_do_simd: 1996 case llvm::omp::Directive::OMPD_target_data: 1997 CheckAllowedMapTypes( 1998 type, {Type::To, Type::From, Type::Tofrom, Type::Alloc}); 1999 break; 2000 case llvm::omp::Directive::OMPD_target_enter_data: 2001 CheckAllowedMapTypes(type, {Type::To, Type::Alloc}); 2002 break; 2003 case llvm::omp::Directive::OMPD_target_exit_data: 2004 CheckAllowedMapTypes(type, {Type::From, Type::Release, Type::Delete}); 2005 break; 2006 default: 2007 break; 2008 } 2009 } 2010 } 2011 2012 bool OmpStructureChecker::ScheduleModifierHasType( 2013 const parser::OmpScheduleClause &x, 2014 const parser::OmpScheduleModifierType::ModType &type) { 2015 const auto &modifier{ 2016 std::get<std::optional<parser::OmpScheduleModifier>>(x.t)}; 2017 if (modifier) { 2018 const auto &modType1{ 2019 std::get<parser::OmpScheduleModifier::Modifier1>(modifier->t)}; 2020 const auto &modType2{ 2021 std::get<std::optional<parser::OmpScheduleModifier::Modifier2>>( 2022 modifier->t)}; 2023 if (modType1.v.v == type || (modType2 && modType2->v.v == type)) { 2024 return true; 2025 } 2026 } 2027 return false; 2028 } 2029 void OmpStructureChecker::Enter(const parser::OmpClause::Schedule &x) { 2030 CheckAllowed(llvm::omp::Clause::OMPC_schedule); 2031 const parser::OmpScheduleClause &scheduleClause = x.v; 2032 2033 // 2.7 Loop Construct Restriction 2034 if (llvm::omp::doSet.test(GetContext().directive)) { 2035 const auto &kind{std::get<1>(scheduleClause.t)}; 2036 const auto &chunk{std::get<2>(scheduleClause.t)}; 2037 if (chunk) { 2038 if (kind == parser::OmpScheduleClause::ScheduleType::Runtime || 2039 kind == parser::OmpScheduleClause::ScheduleType::Auto) { 2040 context_.Say(GetContext().clauseSource, 2041 "When SCHEDULE clause has %s specified, " 2042 "it must not have chunk size specified"_err_en_US, 2043 parser::ToUpperCaseLetters( 2044 parser::OmpScheduleClause::EnumToString(kind))); 2045 } 2046 if (const auto &chunkExpr{std::get<std::optional<parser::ScalarIntExpr>>( 2047 scheduleClause.t)}) { 2048 RequiresPositiveParameter( 2049 llvm::omp::Clause::OMPC_schedule, *chunkExpr, "chunk size"); 2050 } 2051 } 2052 2053 if (ScheduleModifierHasType(scheduleClause, 2054 parser::OmpScheduleModifierType::ModType::Nonmonotonic)) { 2055 if (kind != parser::OmpScheduleClause::ScheduleType::Dynamic && 2056 kind != parser::OmpScheduleClause::ScheduleType::Guided) { 2057 context_.Say(GetContext().clauseSource, 2058 "The NONMONOTONIC modifier can only be specified with " 2059 "SCHEDULE(DYNAMIC) or SCHEDULE(GUIDED)"_err_en_US); 2060 } 2061 } 2062 } 2063 } 2064 2065 void OmpStructureChecker::Enter(const parser::OmpClause::Depend &x) { 2066 CheckAllowed(llvm::omp::Clause::OMPC_depend); 2067 if (const auto *inOut{std::get_if<parser::OmpDependClause::InOut>(&x.v.u)}) { 2068 const auto &designators{std::get<std::list<parser::Designator>>(inOut->t)}; 2069 for (const auto &ele : designators) { 2070 if (const auto *dataRef{std::get_if<parser::DataRef>(&ele.u)}) { 2071 CheckDependList(*dataRef); 2072 if (const auto *arr{ 2073 std::get_if<common::Indirection<parser::ArrayElement>>( 2074 &dataRef->u)}) { 2075 CheckArraySection(arr->value(), GetLastName(*dataRef), 2076 llvm::omp::Clause::OMPC_depend); 2077 } 2078 } 2079 } 2080 } 2081 } 2082 2083 void OmpStructureChecker::Enter(const parser::OmpClause::Copyprivate &x) { 2084 CheckAllowed(llvm::omp::Clause::OMPC_copyprivate); 2085 CheckIntentInPointer(x.v, llvm::omp::Clause::OMPC_copyprivate); 2086 } 2087 2088 void OmpStructureChecker::Enter(const parser::OmpClause::Lastprivate &x) { 2089 CheckAllowed(llvm::omp::Clause::OMPC_lastprivate); 2090 2091 DirectivesClauseTriple dirClauseTriple; 2092 SymbolSourceMap currSymbols; 2093 GetSymbolsInObjectList(x.v, currSymbols); 2094 CheckDefinableObjects(currSymbols, GetClauseKindForParserClass(x)); 2095 2096 // Check lastprivate variables in worksharing constructs 2097 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_do, 2098 std::make_pair( 2099 llvm::omp::Directive::OMPD_parallel, llvm::omp::privateReductionSet)); 2100 dirClauseTriple.emplace(llvm::omp::Directive::OMPD_sections, 2101 std::make_pair( 2102 llvm::omp::Directive::OMPD_parallel, llvm::omp::privateReductionSet)); 2103 2104 CheckPrivateSymbolsInOuterCxt( 2105 currSymbols, dirClauseTriple, GetClauseKindForParserClass(x)); 2106 } 2107 2108 llvm::StringRef OmpStructureChecker::getClauseName(llvm::omp::Clause clause) { 2109 return llvm::omp::getOpenMPClauseName(clause); 2110 } 2111 2112 llvm::StringRef OmpStructureChecker::getDirectiveName( 2113 llvm::omp::Directive directive) { 2114 return llvm::omp::getOpenMPDirectiveName(directive); 2115 } 2116 2117 void OmpStructureChecker::CheckDependList(const parser::DataRef &d) { 2118 std::visit( 2119 common::visitors{ 2120 [&](const common::Indirection<parser::ArrayElement> &elem) { 2121 // Check if the base element is valid on Depend Clause 2122 CheckDependList(elem.value().base); 2123 }, 2124 [&](const common::Indirection<parser::StructureComponent> &) { 2125 context_.Say(GetContext().clauseSource, 2126 "A variable that is part of another variable " 2127 "(such as an element of a structure) but is not an array " 2128 "element or an array section cannot appear in a DEPEND " 2129 "clause"_err_en_US); 2130 }, 2131 [&](const common::Indirection<parser::CoindexedNamedObject> &) { 2132 context_.Say(GetContext().clauseSource, 2133 "Coarrays are not supported in DEPEND clause"_err_en_US); 2134 }, 2135 [&](const parser::Name &) { return; }, 2136 }, 2137 d.u); 2138 } 2139 2140 // Called from both Reduction and Depend clause. 2141 void OmpStructureChecker::CheckArraySection( 2142 const parser::ArrayElement &arrayElement, const parser::Name &name, 2143 const llvm::omp::Clause clause) { 2144 if (!arrayElement.subscripts.empty()) { 2145 for (const auto &subscript : arrayElement.subscripts) { 2146 if (const auto *triplet{ 2147 std::get_if<parser::SubscriptTriplet>(&subscript.u)}) { 2148 if (std::get<0>(triplet->t) && std::get<1>(triplet->t)) { 2149 const auto &lower{std::get<0>(triplet->t)}; 2150 const auto &upper{std::get<1>(triplet->t)}; 2151 if (lower && upper) { 2152 const auto lval{GetIntValue(lower)}; 2153 const auto uval{GetIntValue(upper)}; 2154 if (lval && uval && *uval < *lval) { 2155 context_.Say(GetContext().clauseSource, 2156 "'%s' in %s clause" 2157 " is a zero size array section"_err_en_US, 2158 name.ToString(), 2159 parser::ToUpperCaseLetters(getClauseName(clause).str())); 2160 break; 2161 } else if (std::get<2>(triplet->t)) { 2162 const auto &strideExpr{std::get<2>(triplet->t)}; 2163 if (strideExpr) { 2164 if (clause == llvm::omp::Clause::OMPC_depend) { 2165 context_.Say(GetContext().clauseSource, 2166 "Stride should not be specified for array section in " 2167 "DEPEND " 2168 "clause"_err_en_US); 2169 } 2170 const auto stride{GetIntValue(strideExpr)}; 2171 if ((stride && stride != 1)) { 2172 context_.Say(GetContext().clauseSource, 2173 "A list item that appears in a REDUCTION clause" 2174 " should have a contiguous storage array section."_err_en_US, 2175 ContextDirectiveAsFortran()); 2176 break; 2177 } 2178 } 2179 } 2180 } 2181 } 2182 } 2183 } 2184 } 2185 } 2186 2187 void OmpStructureChecker::CheckIntentInPointer( 2188 const parser::OmpObjectList &objectList, const llvm::omp::Clause clause) { 2189 SymbolSourceMap symbols; 2190 GetSymbolsInObjectList(objectList, symbols); 2191 for (auto it{symbols.begin()}; it != symbols.end(); ++it) { 2192 const auto *symbol{it->first}; 2193 const auto source{it->second}; 2194 if (IsPointer(*symbol) && IsIntentIn(*symbol)) { 2195 context_.Say(source, 2196 "Pointer '%s' with the INTENT(IN) attribute may not appear " 2197 "in a %s clause"_err_en_US, 2198 symbol->name(), 2199 parser::ToUpperCaseLetters(getClauseName(clause).str())); 2200 } 2201 } 2202 } 2203 2204 void OmpStructureChecker::GetSymbolsInObjectList( 2205 const parser::OmpObjectList &objectList, SymbolSourceMap &symbols) { 2206 for (const auto &ompObject : objectList.v) { 2207 if (const auto *name{parser::Unwrap<parser::Name>(ompObject)}) { 2208 if (const auto *symbol{name->symbol}) { 2209 if (const auto *commonBlockDetails{ 2210 symbol->detailsIf<CommonBlockDetails>()}) { 2211 for (const auto &object : commonBlockDetails->objects()) { 2212 symbols.emplace(&object->GetUltimate(), name->source); 2213 } 2214 } else { 2215 symbols.emplace(&symbol->GetUltimate(), name->source); 2216 } 2217 } 2218 } 2219 } 2220 } 2221 2222 void OmpStructureChecker::CheckDefinableObjects( 2223 SymbolSourceMap &symbols, const llvm::omp::Clause clause) { 2224 for (auto it{symbols.begin()}; it != symbols.end(); ++it) { 2225 const auto *symbol{it->first}; 2226 const auto source{it->second}; 2227 if (auto msg{WhyNotModifiable(*symbol, context_.FindScope(source))}) { 2228 context_ 2229 .Say(source, 2230 "Variable '%s' on the %s clause is not definable"_err_en_US, 2231 symbol->name(), 2232 parser::ToUpperCaseLetters(getClauseName(clause).str())) 2233 .Attach(source, std::move(*msg), symbol->name()); 2234 } 2235 } 2236 } 2237 2238 void OmpStructureChecker::CheckPrivateSymbolsInOuterCxt( 2239 SymbolSourceMap &currSymbols, DirectivesClauseTriple &dirClauseTriple, 2240 const llvm::omp::Clause currClause) { 2241 SymbolSourceMap enclosingSymbols; 2242 auto range{dirClauseTriple.equal_range(GetContext().directive)}; 2243 for (auto dirIter{range.first}; dirIter != range.second; ++dirIter) { 2244 auto enclosingDir{dirIter->second.first}; 2245 auto enclosingClauseSet{dirIter->second.second}; 2246 if (auto *enclosingContext{GetEnclosingContextWithDir(enclosingDir)}) { 2247 for (auto it{enclosingContext->clauseInfo.begin()}; 2248 it != enclosingContext->clauseInfo.end(); ++it) { 2249 if (enclosingClauseSet.test(it->first)) { 2250 if (const auto *ompObjectList{GetOmpObjectList(*it->second)}) { 2251 GetSymbolsInObjectList(*ompObjectList, enclosingSymbols); 2252 } 2253 } 2254 } 2255 2256 // Check if the symbols in current context are private in outer context 2257 for (auto iter{currSymbols.begin()}; iter != currSymbols.end(); ++iter) { 2258 const auto *symbol{iter->first}; 2259 const auto source{iter->second}; 2260 if (enclosingSymbols.find(symbol) != enclosingSymbols.end()) { 2261 context_.Say(source, 2262 "%s variable '%s' is PRIVATE in outer context"_err_en_US, 2263 parser::ToUpperCaseLetters(getClauseName(currClause).str()), 2264 symbol->name()); 2265 } 2266 } 2267 } 2268 } 2269 } 2270 2271 bool OmpStructureChecker::CheckTargetBlockOnlyTeams( 2272 const parser::Block &block) { 2273 bool nestedTeams{false}; 2274 auto it{block.begin()}; 2275 2276 if (const auto *ompConstruct{parser::Unwrap<parser::OpenMPConstruct>(*it)}) { 2277 if (const auto *ompBlockConstruct{ 2278 std::get_if<parser::OpenMPBlockConstruct>(&ompConstruct->u)}) { 2279 const auto &beginBlockDir{ 2280 std::get<parser::OmpBeginBlockDirective>(ompBlockConstruct->t)}; 2281 const auto &beginDir{ 2282 std::get<parser::OmpBlockDirective>(beginBlockDir.t)}; 2283 if (beginDir.v == llvm::omp::Directive::OMPD_teams) { 2284 nestedTeams = true; 2285 } 2286 } 2287 } 2288 2289 if (nestedTeams && ++it == block.end()) { 2290 return true; 2291 } 2292 return false; 2293 } 2294 2295 void OmpStructureChecker::CheckWorkshareBlockStmts( 2296 const parser::Block &block, parser::CharBlock source) { 2297 OmpWorkshareBlockChecker ompWorkshareBlockChecker{context_, source}; 2298 2299 for (auto it{block.begin()}; it != block.end(); ++it) { 2300 if (parser::Unwrap<parser::AssignmentStmt>(*it) || 2301 parser::Unwrap<parser::ForallStmt>(*it) || 2302 parser::Unwrap<parser::ForallConstruct>(*it) || 2303 parser::Unwrap<parser::WhereStmt>(*it) || 2304 parser::Unwrap<parser::WhereConstruct>(*it)) { 2305 parser::Walk(*it, ompWorkshareBlockChecker); 2306 } else if (const auto *ompConstruct{ 2307 parser::Unwrap<parser::OpenMPConstruct>(*it)}) { 2308 if (const auto *ompAtomicConstruct{ 2309 std::get_if<parser::OpenMPAtomicConstruct>(&ompConstruct->u)}) { 2310 // Check if assignment statements in the enclosing OpenMP Atomic 2311 // construct are allowed in the Workshare construct 2312 parser::Walk(*ompAtomicConstruct, ompWorkshareBlockChecker); 2313 } else if (const auto *ompCriticalConstruct{ 2314 std::get_if<parser::OpenMPCriticalConstruct>( 2315 &ompConstruct->u)}) { 2316 // All the restrictions on the Workshare construct apply to the 2317 // statements in the enclosing critical constructs 2318 const auto &criticalBlock{ 2319 std::get<parser::Block>(ompCriticalConstruct->t)}; 2320 CheckWorkshareBlockStmts(criticalBlock, source); 2321 } else { 2322 // Check if OpenMP constructs enclosed in the Workshare construct are 2323 // 'Parallel' constructs 2324 auto currentDir{llvm::omp::Directive::OMPD_unknown}; 2325 const OmpDirectiveSet parallelDirSet{ 2326 llvm::omp::Directive::OMPD_parallel, 2327 llvm::omp::Directive::OMPD_parallel_do, 2328 llvm::omp::Directive::OMPD_parallel_sections, 2329 llvm::omp::Directive::OMPD_parallel_workshare, 2330 llvm::omp::Directive::OMPD_parallel_do_simd}; 2331 2332 if (const auto *ompBlockConstruct{ 2333 std::get_if<parser::OpenMPBlockConstruct>(&ompConstruct->u)}) { 2334 const auto &beginBlockDir{ 2335 std::get<parser::OmpBeginBlockDirective>(ompBlockConstruct->t)}; 2336 const auto &beginDir{ 2337 std::get<parser::OmpBlockDirective>(beginBlockDir.t)}; 2338 currentDir = beginDir.v; 2339 } else if (const auto *ompLoopConstruct{ 2340 std::get_if<parser::OpenMPLoopConstruct>( 2341 &ompConstruct->u)}) { 2342 const auto &beginLoopDir{ 2343 std::get<parser::OmpBeginLoopDirective>(ompLoopConstruct->t)}; 2344 const auto &beginDir{ 2345 std::get<parser::OmpLoopDirective>(beginLoopDir.t)}; 2346 currentDir = beginDir.v; 2347 } else if (const auto *ompSectionsConstruct{ 2348 std::get_if<parser::OpenMPSectionsConstruct>( 2349 &ompConstruct->u)}) { 2350 const auto &beginSectionsDir{ 2351 std::get<parser::OmpBeginSectionsDirective>( 2352 ompSectionsConstruct->t)}; 2353 const auto &beginDir{ 2354 std::get<parser::OmpSectionsDirective>(beginSectionsDir.t)}; 2355 currentDir = beginDir.v; 2356 } 2357 2358 if (!parallelDirSet.test(currentDir)) { 2359 context_.Say(source, 2360 "OpenMP constructs enclosed in WORKSHARE construct may consist " 2361 "of ATOMIC, CRITICAL or PARALLEL constructs only"_err_en_US); 2362 } 2363 } 2364 } else { 2365 context_.Say(source, 2366 "The structured block in a WORKSHARE construct may consist of only " 2367 "SCALAR or ARRAY assignments, FORALL or WHERE statements, " 2368 "FORALL, WHERE, ATOMIC, CRITICAL or PARALLEL constructs"_err_en_US); 2369 } 2370 } 2371 } 2372 2373 const parser::OmpObjectList *OmpStructureChecker::GetOmpObjectList( 2374 const parser::OmpClause &clause) { 2375 2376 // Clauses with OmpObjectList as its data member 2377 using MemberObjectListClauses = std::tuple<parser::OmpClause::Copyprivate, 2378 parser::OmpClause::Copyin, parser::OmpClause::Firstprivate, 2379 parser::OmpClause::From, parser::OmpClause::Lastprivate, 2380 parser::OmpClause::Link, parser::OmpClause::Private, 2381 parser::OmpClause::Shared, parser::OmpClause::To>; 2382 2383 // Clauses with OmpObjectList in the tuple 2384 using TupleObjectListClauses = std::tuple<parser::OmpClause::Allocate, 2385 parser::OmpClause::Map, parser::OmpClause::Reduction>; 2386 2387 // TODO:: Generate the tuples using TableGen. 2388 // Handle other constructs with OmpObjectList such as OpenMPThreadprivate. 2389 return std::visit( 2390 common::visitors{ 2391 [&](const auto &x) -> const parser::OmpObjectList * { 2392 using Ty = std::decay_t<decltype(x)>; 2393 if constexpr (common::HasMember<Ty, MemberObjectListClauses>) { 2394 return &x.v; 2395 } else if constexpr (common::HasMember<Ty, 2396 TupleObjectListClauses>) { 2397 return &(std::get<parser::OmpObjectList>(x.v.t)); 2398 } else { 2399 return nullptr; 2400 } 2401 }, 2402 }, 2403 clause.u); 2404 } 2405 2406 } // namespace Fortran::semantics 2407