1 //===- IslAst.cpp - isl code generator interface --------------------------===// 2 // 3 // The LLVM Compiler Infrastructure 4 // 5 // This file is distributed under the University of Illinois Open Source 6 // License. See LICENSE.TXT for details. 7 // 8 //===----------------------------------------------------------------------===// 9 // 10 // The isl code generator interface takes a Scop and generates an isl_ast. This 11 // ist_ast can either be returned directly or it can be pretty printed to 12 // stdout. 13 // 14 // A typical isl_ast output looks like this: 15 // 16 // for (c2 = max(0, ceild(n + m, 2); c2 <= min(511, floord(5 * n, 3)); c2++) { 17 // bb2(c2); 18 // } 19 // 20 // An in-depth discussion of our AST generation approach can be found in: 21 // 22 // Polyhedral AST generation is more than scanning polyhedra 23 // Tobias Grosser, Sven Verdoolaege, Albert Cohen 24 // ACM Transactions on Programming Languages and Systems (TOPLAS), 25 // 37(4), July 2015 26 // http://www.grosser.es/#pub-polyhedral-AST-generation 27 // 28 //===----------------------------------------------------------------------===// 29 30 #include "polly/CodeGen/IslAst.h" 31 #include "polly/CodeGen/CodeGeneration.h" 32 #include "polly/DependenceInfo.h" 33 #include "polly/LinkAllPasses.h" 34 #include "polly/Options.h" 35 #include "polly/ScopDetection.h" 36 #include "polly/ScopInfo.h" 37 #include "polly/ScopPass.h" 38 #include "polly/Support/GICHelper.h" 39 #include "llvm/ADT/Statistic.h" 40 #include "llvm/IR/Function.h" 41 #include "llvm/Pass.h" 42 #include "llvm/Support/CommandLine.h" 43 #include "llvm/Support/Debug.h" 44 #include "llvm/Support/raw_ostream.h" 45 #include "isl/aff.h" 46 #include "isl/ast.h" 47 #include "isl/ast_build.h" 48 #include "isl/id.h" 49 #include "isl/isl-noexceptions.h" 50 #include "isl/map.h" 51 #include "isl/printer.h" 52 #include "isl/schedule.h" 53 #include "isl/set.h" 54 #include "isl/union_map.h" 55 #include "isl/val.h" 56 #include <cassert> 57 #include <cstdlib> 58 #include <cstring> 59 #include <map> 60 #include <string> 61 #include <utility> 62 63 #define DEBUG_TYPE "polly-ast" 64 65 using namespace llvm; 66 using namespace polly; 67 68 using IslAstUserPayload = IslAstInfo::IslAstUserPayload; 69 70 static cl::opt<bool> 71 PollyParallel("polly-parallel", 72 cl::desc("Generate thread parallel code (isl codegen only)"), 73 cl::init(false), cl::ZeroOrMore, cl::cat(PollyCategory)); 74 75 static cl::opt<bool> PrintAccesses("polly-ast-print-accesses", 76 cl::desc("Print memory access functions"), 77 cl::init(false), cl::ZeroOrMore, 78 cl::cat(PollyCategory)); 79 80 static cl::opt<bool> PollyParallelForce( 81 "polly-parallel-force", 82 cl::desc( 83 "Force generation of thread parallel code ignoring any cost model"), 84 cl::init(false), cl::ZeroOrMore, cl::cat(PollyCategory)); 85 86 static cl::opt<bool> UseContext("polly-ast-use-context", 87 cl::desc("Use context"), cl::Hidden, 88 cl::init(true), cl::ZeroOrMore, 89 cl::cat(PollyCategory)); 90 91 static cl::opt<bool> DetectParallel("polly-ast-detect-parallel", 92 cl::desc("Detect parallelism"), cl::Hidden, 93 cl::init(false), cl::ZeroOrMore, 94 cl::cat(PollyCategory)); 95 96 STATISTIC(ScopsProcessed, "Number of SCoPs processed"); 97 STATISTIC(ScopsBeneficial, "Number of beneficial SCoPs"); 98 STATISTIC(BeneficialAffineLoops, "Number of beneficial affine loops"); 99 STATISTIC(BeneficialBoxedLoops, "Number of beneficial boxed loops"); 100 101 STATISTIC(NumForLoops, "Number of for-loops"); 102 STATISTIC(NumParallel, "Number of parallel for-loops"); 103 STATISTIC(NumInnermostParallel, "Number of innermost parallel for-loops"); 104 STATISTIC(NumOutermostParallel, "Number of outermost parallel for-loops"); 105 STATISTIC(NumReductionParallel, "Number of reduction-parallel for-loops"); 106 STATISTIC(NumExecutedInParallel, "Number of for-loops executed in parallel"); 107 STATISTIC(NumIfConditions, "Number of if-conditions"); 108 109 namespace polly { 110 111 /// Temporary information used when building the ast. 112 struct AstBuildUserInfo { 113 /// Construct and initialize the helper struct for AST creation. 114 AstBuildUserInfo() = default; 115 116 /// The dependence information used for the parallelism check. 117 const Dependences *Deps = nullptr; 118 119 /// Flag to indicate that we are inside a parallel for node. 120 bool InParallelFor = false; 121 122 /// The last iterator id created for the current SCoP. 123 isl_id *LastForNodeId = nullptr; 124 }; 125 126 } // namespace polly 127 128 /// Free an IslAstUserPayload object pointed to by @p Ptr. 129 static void freeIslAstUserPayload(void *Ptr) { 130 delete ((IslAstInfo::IslAstUserPayload *)Ptr); 131 } 132 133 IslAstInfo::IslAstUserPayload::~IslAstUserPayload() { 134 isl_ast_build_free(Build); 135 isl_pw_aff_free(MinimalDependenceDistance); 136 } 137 138 /// Print a string @p str in a single line using @p Printer. 139 static isl_printer *printLine(__isl_take isl_printer *Printer, 140 const std::string &str, 141 __isl_keep isl_pw_aff *PWA = nullptr) { 142 Printer = isl_printer_start_line(Printer); 143 Printer = isl_printer_print_str(Printer, str.c_str()); 144 if (PWA) 145 Printer = isl_printer_print_pw_aff(Printer, PWA); 146 return isl_printer_end_line(Printer); 147 } 148 149 /// Return all broken reductions as a string of clauses (OpenMP style). 150 static const std::string getBrokenReductionsStr(__isl_keep isl_ast_node *Node) { 151 IslAstInfo::MemoryAccessSet *BrokenReductions; 152 std::string str; 153 154 BrokenReductions = IslAstInfo::getBrokenReductions(Node); 155 if (!BrokenReductions || BrokenReductions->empty()) 156 return ""; 157 158 // Map each type of reduction to a comma separated list of the base addresses. 159 std::map<MemoryAccess::ReductionType, std::string> Clauses; 160 for (MemoryAccess *MA : *BrokenReductions) 161 if (MA->isWrite()) 162 Clauses[MA->getReductionType()] += 163 ", " + MA->getScopArrayInfo()->getName(); 164 165 // Now print the reductions sorted by type. Each type will cause a clause 166 // like: reduction (+ : sum0, sum1, sum2) 167 for (const auto &ReductionClause : Clauses) { 168 str += " reduction ("; 169 str += MemoryAccess::getReductionOperatorStr(ReductionClause.first); 170 // Remove the first two symbols (", ") to make the output look pretty. 171 str += " : " + ReductionClause.second.substr(2) + ")"; 172 } 173 174 return str; 175 } 176 177 /// Callback executed for each for node in the ast in order to print it. 178 static isl_printer *cbPrintFor(__isl_take isl_printer *Printer, 179 __isl_take isl_ast_print_options *Options, 180 __isl_keep isl_ast_node *Node, void *) { 181 isl_pw_aff *DD = IslAstInfo::getMinimalDependenceDistance(Node); 182 const std::string BrokenReductionsStr = getBrokenReductionsStr(Node); 183 const std::string KnownParallelStr = "#pragma known-parallel"; 184 const std::string DepDisPragmaStr = "#pragma minimal dependence distance: "; 185 const std::string SimdPragmaStr = "#pragma simd"; 186 const std::string OmpPragmaStr = "#pragma omp parallel for"; 187 188 if (DD) 189 Printer = printLine(Printer, DepDisPragmaStr, DD); 190 191 if (IslAstInfo::isInnermostParallel(Node)) 192 Printer = printLine(Printer, SimdPragmaStr + BrokenReductionsStr); 193 194 if (IslAstInfo::isExecutedInParallel(Node)) 195 Printer = printLine(Printer, OmpPragmaStr); 196 else if (IslAstInfo::isOutermostParallel(Node)) 197 Printer = printLine(Printer, KnownParallelStr + BrokenReductionsStr); 198 199 isl_pw_aff_free(DD); 200 return isl_ast_node_for_print(Node, Printer, Options); 201 } 202 203 /// Check if the current scheduling dimension is parallel. 204 /// 205 /// In case the dimension is parallel we also check if any reduction 206 /// dependences is broken when we exploit this parallelism. If so, 207 /// @p IsReductionParallel will be set to true. The reduction dependences we use 208 /// to check are actually the union of the transitive closure of the initial 209 /// reduction dependences together with their reversal. Even though these 210 /// dependences connect all iterations with each other (thus they are cyclic) 211 /// we can perform the parallelism check as we are only interested in a zero 212 /// (or non-zero) dependence distance on the dimension in question. 213 static bool astScheduleDimIsParallel(__isl_keep isl_ast_build *Build, 214 const Dependences *D, 215 IslAstUserPayload *NodeInfo) { 216 if (!D->hasValidDependences()) 217 return false; 218 219 isl_union_map *Schedule = isl_ast_build_get_schedule(Build); 220 isl_union_map *Deps = D->getDependences( 221 Dependences::TYPE_RAW | Dependences::TYPE_WAW | Dependences::TYPE_WAR); 222 223 if (!D->isParallel(Schedule, Deps, &NodeInfo->MinimalDependenceDistance) && 224 !isl_union_map_free(Schedule)) 225 return false; 226 227 isl_union_map *RedDeps = D->getDependences(Dependences::TYPE_TC_RED); 228 if (!D->isParallel(Schedule, RedDeps)) 229 NodeInfo->IsReductionParallel = true; 230 231 if (!NodeInfo->IsReductionParallel && !isl_union_map_free(Schedule)) 232 return true; 233 234 // Annotate reduction parallel nodes with the memory accesses which caused the 235 // reduction dependences parallel execution of the node conflicts with. 236 for (const auto &MaRedPair : D->getReductionDependences()) { 237 if (!MaRedPair.second) 238 continue; 239 RedDeps = isl_union_map_from_map(isl_map_copy(MaRedPair.second)); 240 if (!D->isParallel(Schedule, RedDeps)) 241 NodeInfo->BrokenReductions.insert(MaRedPair.first); 242 } 243 244 isl_union_map_free(Schedule); 245 return true; 246 } 247 248 // This method is executed before the construction of a for node. It creates 249 // an isl_id that is used to annotate the subsequently generated ast for nodes. 250 // 251 // In this function we also run the following analyses: 252 // 253 // - Detection of openmp parallel loops 254 // 255 static __isl_give isl_id *astBuildBeforeFor(__isl_keep isl_ast_build *Build, 256 void *User) { 257 AstBuildUserInfo *BuildInfo = (AstBuildUserInfo *)User; 258 IslAstUserPayload *Payload = new IslAstUserPayload(); 259 isl_id *Id = isl_id_alloc(isl_ast_build_get_ctx(Build), "", Payload); 260 Id = isl_id_set_free_user(Id, freeIslAstUserPayload); 261 BuildInfo->LastForNodeId = Id; 262 263 // Test for parallelism only if we are not already inside a parallel loop 264 if (!BuildInfo->InParallelFor) 265 BuildInfo->InParallelFor = Payload->IsOutermostParallel = 266 astScheduleDimIsParallel(Build, BuildInfo->Deps, Payload); 267 268 return Id; 269 } 270 271 // This method is executed after the construction of a for node. 272 // 273 // It performs the following actions: 274 // 275 // - Reset the 'InParallelFor' flag, as soon as we leave a for node, 276 // that is marked as openmp parallel. 277 // 278 static __isl_give isl_ast_node * 279 astBuildAfterFor(__isl_take isl_ast_node *Node, __isl_keep isl_ast_build *Build, 280 void *User) { 281 isl_id *Id = isl_ast_node_get_annotation(Node); 282 assert(Id && "Post order visit assumes annotated for nodes"); 283 IslAstUserPayload *Payload = (IslAstUserPayload *)isl_id_get_user(Id); 284 assert(Payload && "Post order visit assumes annotated for nodes"); 285 286 AstBuildUserInfo *BuildInfo = (AstBuildUserInfo *)User; 287 assert(!Payload->Build && "Build environment already set"); 288 Payload->Build = isl_ast_build_copy(Build); 289 Payload->IsInnermost = (Id == BuildInfo->LastForNodeId); 290 291 // Innermost loops that are surrounded by parallel loops have not yet been 292 // tested for parallelism. Test them here to ensure we check all innermost 293 // loops for parallelism. 294 if (Payload->IsInnermost && BuildInfo->InParallelFor) { 295 if (Payload->IsOutermostParallel) { 296 Payload->IsInnermostParallel = true; 297 } else { 298 if (PollyVectorizerChoice == VECTORIZER_NONE) 299 Payload->IsInnermostParallel = 300 astScheduleDimIsParallel(Build, BuildInfo->Deps, Payload); 301 } 302 } 303 if (Payload->IsOutermostParallel) 304 BuildInfo->InParallelFor = false; 305 306 isl_id_free(Id); 307 return Node; 308 } 309 310 static isl_stat astBuildBeforeMark(__isl_keep isl_id *MarkId, 311 __isl_keep isl_ast_build *Build, 312 void *User) { 313 if (!MarkId) 314 return isl_stat_error; 315 316 AstBuildUserInfo *BuildInfo = (AstBuildUserInfo *)User; 317 if (strcmp(isl_id_get_name(MarkId), "SIMD") == 0) 318 BuildInfo->InParallelFor = true; 319 320 return isl_stat_ok; 321 } 322 323 static __isl_give isl_ast_node * 324 astBuildAfterMark(__isl_take isl_ast_node *Node, 325 __isl_keep isl_ast_build *Build, void *User) { 326 assert(isl_ast_node_get_type(Node) == isl_ast_node_mark); 327 AstBuildUserInfo *BuildInfo = (AstBuildUserInfo *)User; 328 auto *Id = isl_ast_node_mark_get_id(Node); 329 if (strcmp(isl_id_get_name(Id), "SIMD") == 0) 330 BuildInfo->InParallelFor = false; 331 isl_id_free(Id); 332 return Node; 333 } 334 335 static __isl_give isl_ast_node *AtEachDomain(__isl_take isl_ast_node *Node, 336 __isl_keep isl_ast_build *Build, 337 void *User) { 338 assert(!isl_ast_node_get_annotation(Node) && "Node already annotated"); 339 340 IslAstUserPayload *Payload = new IslAstUserPayload(); 341 isl_id *Id = isl_id_alloc(isl_ast_build_get_ctx(Build), "", Payload); 342 Id = isl_id_set_free_user(Id, freeIslAstUserPayload); 343 344 Payload->Build = isl_ast_build_copy(Build); 345 346 return isl_ast_node_set_annotation(Node, Id); 347 } 348 349 // Build alias check condition given a pair of minimal/maximal access. 350 static isl::ast_expr buildCondition(Scop &S, isl::ast_build Build, 351 const Scop::MinMaxAccessTy *It0, 352 const Scop::MinMaxAccessTy *It1) { 353 354 isl::pw_multi_aff AFirst = It0->first; 355 isl::pw_multi_aff ASecond = It0->second; 356 isl::pw_multi_aff BFirst = It1->first; 357 isl::pw_multi_aff BSecond = It1->second; 358 359 isl::id Left = AFirst.get_tuple_id(isl::dim::set); 360 isl::id Right = BFirst.get_tuple_id(isl::dim::set); 361 362 isl::ast_expr True = 363 isl::ast_expr::from_val(isl::val::int_from_ui(Build.get_ctx(), 1)); 364 isl::ast_expr False = 365 isl::ast_expr::from_val(isl::val::int_from_ui(Build.get_ctx(), 0)); 366 367 const ScopArrayInfo *BaseLeft = 368 ScopArrayInfo::getFromId(Left)->getBasePtrOriginSAI(); 369 const ScopArrayInfo *BaseRight = 370 ScopArrayInfo::getFromId(Right)->getBasePtrOriginSAI(); 371 if (BaseLeft && BaseLeft == BaseRight) 372 return True; 373 374 isl::set Params = S.getContext(); 375 376 isl::ast_expr NonAliasGroup, MinExpr, MaxExpr; 377 378 // In the following, we first check if any accesses will be empty under 379 // the execution context of the scop and do not code generate them if this 380 // is the case as isl will fail to derive valid AST expressions for such 381 // accesses. 382 383 if (!AFirst.intersect_params(Params).domain().is_empty() && 384 !BSecond.intersect_params(Params).domain().is_empty()) { 385 MinExpr = Build.access_from(AFirst).address_of(); 386 MaxExpr = Build.access_from(BSecond).address_of(); 387 NonAliasGroup = MaxExpr.le(MinExpr); 388 } 389 390 if (!BFirst.intersect_params(Params).domain().is_empty() && 391 !ASecond.intersect_params(Params).domain().is_empty()) { 392 MinExpr = Build.access_from(BFirst).address_of(); 393 MaxExpr = Build.access_from(ASecond).address_of(); 394 395 isl::ast_expr Result = MaxExpr.le(MinExpr); 396 if (!NonAliasGroup.is_null()) 397 NonAliasGroup = isl::manage( 398 isl_ast_expr_or(NonAliasGroup.release(), Result.release())); 399 else 400 NonAliasGroup = Result; 401 } 402 403 if (NonAliasGroup.is_null()) 404 NonAliasGroup = True; 405 406 return NonAliasGroup; 407 } 408 409 __isl_give isl_ast_expr * 410 IslAst::buildRunCondition(Scop &S, __isl_keep isl_ast_build *Build) { 411 isl_ast_expr *RunCondition; 412 413 // The conditions that need to be checked at run-time for this scop are 414 // available as an isl_set in the runtime check context from which we can 415 // directly derive a run-time condition. 416 auto *PosCond = 417 isl_ast_build_expr_from_set(Build, S.getAssumedContext().release()); 418 if (S.hasTrivialInvalidContext()) { 419 RunCondition = PosCond; 420 } else { 421 auto *ZeroV = isl_val_zero(isl_ast_build_get_ctx(Build)); 422 auto *NegCond = 423 isl_ast_build_expr_from_set(Build, S.getInvalidContext().release()); 424 auto *NotNegCond = isl_ast_expr_eq(isl_ast_expr_from_val(ZeroV), NegCond); 425 RunCondition = isl_ast_expr_and(PosCond, NotNegCond); 426 } 427 428 // Create the alias checks from the minimal/maximal accesses in each alias 429 // group which consists of read only and non read only (read write) accesses. 430 // This operation is by construction quadratic in the read-write pointers and 431 // linear in the read only pointers in each alias group. 432 for (const Scop::MinMaxVectorPairTy &MinMaxAccessPair : S.getAliasGroups()) { 433 auto &MinMaxReadWrite = MinMaxAccessPair.first; 434 auto &MinMaxReadOnly = MinMaxAccessPair.second; 435 auto RWAccEnd = MinMaxReadWrite.end(); 436 437 for (auto RWAccIt0 = MinMaxReadWrite.begin(); RWAccIt0 != RWAccEnd; 438 ++RWAccIt0) { 439 for (auto RWAccIt1 = RWAccIt0 + 1; RWAccIt1 != RWAccEnd; ++RWAccIt1) 440 RunCondition = isl_ast_expr_and( 441 RunCondition, 442 buildCondition(S, isl::manage_copy(Build), RWAccIt0, RWAccIt1) 443 .release()); 444 for (const Scop::MinMaxAccessTy &ROAccIt : MinMaxReadOnly) 445 RunCondition = isl_ast_expr_and( 446 RunCondition, 447 buildCondition(S, isl::manage_copy(Build), RWAccIt0, &ROAccIt) 448 .release()); 449 } 450 } 451 452 return RunCondition; 453 } 454 455 /// Simple cost analysis for a given SCoP. 456 /// 457 /// TODO: Improve this analysis and extract it to make it usable in other 458 /// places too. 459 /// In order to improve the cost model we could either keep track of 460 /// performed optimizations (e.g., tiling) or compute properties on the 461 /// original as well as optimized SCoP (e.g., #stride-one-accesses). 462 static bool benefitsFromPolly(Scop &Scop, bool PerformParallelTest) { 463 if (PollyProcessUnprofitable) 464 return true; 465 466 // Check if nothing interesting happened. 467 if (!PerformParallelTest && !Scop.isOptimized() && 468 Scop.getAliasGroups().empty()) 469 return false; 470 471 // The default assumption is that Polly improves the code. 472 return true; 473 } 474 475 /// Collect statistics for the syntax tree rooted at @p Ast. 476 static void walkAstForStatistics(__isl_keep isl_ast_node *Ast) { 477 assert(Ast); 478 isl_ast_node_foreach_descendant_top_down( 479 Ast, 480 [](__isl_keep isl_ast_node *Node, void *User) -> isl_bool { 481 switch (isl_ast_node_get_type(Node)) { 482 case isl_ast_node_for: 483 NumForLoops++; 484 if (IslAstInfo::isParallel(Node)) 485 NumParallel++; 486 if (IslAstInfo::isInnermostParallel(Node)) 487 NumInnermostParallel++; 488 if (IslAstInfo::isOutermostParallel(Node)) 489 NumOutermostParallel++; 490 if (IslAstInfo::isReductionParallel(Node)) 491 NumReductionParallel++; 492 if (IslAstInfo::isExecutedInParallel(Node)) 493 NumExecutedInParallel++; 494 break; 495 496 case isl_ast_node_if: 497 NumIfConditions++; 498 break; 499 500 default: 501 break; 502 } 503 504 // Continue traversing subtrees. 505 return isl_bool_true; 506 }, 507 nullptr); 508 } 509 510 IslAst::IslAst(Scop &Scop) : S(Scop), Ctx(Scop.getSharedIslCtx()) {} 511 512 IslAst::IslAst(IslAst &&O) 513 : S(O.S), Root(O.Root), RunCondition(O.RunCondition), Ctx(O.Ctx) { 514 O.Root = nullptr; 515 O.RunCondition = nullptr; 516 } 517 518 IslAst::~IslAst() { 519 isl_ast_node_free(Root); 520 isl_ast_expr_free(RunCondition); 521 } 522 523 void IslAst::init(const Dependences &D) { 524 bool PerformParallelTest = PollyParallel || DetectParallel || 525 PollyVectorizerChoice != VECTORIZER_NONE; 526 527 // We can not perform the dependence analysis and, consequently, 528 // the parallel code generation in case the schedule tree contains 529 // extension nodes. 530 auto ScheduleTree = S.getScheduleTree(); 531 PerformParallelTest = 532 PerformParallelTest && !S.containsExtensionNode(ScheduleTree); 533 534 // Skip AST and code generation if there was no benefit achieved. 535 if (!benefitsFromPolly(S, PerformParallelTest)) 536 return; 537 538 auto ScopStats = S.getStatistics(); 539 ScopsBeneficial++; 540 BeneficialAffineLoops += ScopStats.NumAffineLoops; 541 BeneficialBoxedLoops += ScopStats.NumBoxedLoops; 542 543 auto Ctx = S.getIslCtx(); 544 isl_options_set_ast_build_atomic_upper_bound(Ctx.get(), true); 545 isl_options_set_ast_build_detect_min_max(Ctx.get(), true); 546 isl_ast_build *Build; 547 AstBuildUserInfo BuildInfo; 548 549 if (UseContext) 550 Build = isl_ast_build_from_context(S.getContext().release()); 551 else 552 Build = isl_ast_build_from_context( 553 isl_set_universe(S.getParamSpace().release())); 554 555 Build = isl_ast_build_set_at_each_domain(Build, AtEachDomain, nullptr); 556 557 if (PerformParallelTest) { 558 BuildInfo.Deps = &D; 559 BuildInfo.InParallelFor = false; 560 561 Build = isl_ast_build_set_before_each_for(Build, &astBuildBeforeFor, 562 &BuildInfo); 563 Build = 564 isl_ast_build_set_after_each_for(Build, &astBuildAfterFor, &BuildInfo); 565 566 Build = isl_ast_build_set_before_each_mark(Build, &astBuildBeforeMark, 567 &BuildInfo); 568 569 Build = isl_ast_build_set_after_each_mark(Build, &astBuildAfterMark, 570 &BuildInfo); 571 } 572 573 RunCondition = buildRunCondition(S, Build); 574 575 Root = isl_ast_build_node_from_schedule(Build, S.getScheduleTree().release()); 576 walkAstForStatistics(Root); 577 578 isl_ast_build_free(Build); 579 } 580 581 IslAst IslAst::create(Scop &Scop, const Dependences &D) { 582 IslAst Ast{Scop}; 583 Ast.init(D); 584 return Ast; 585 } 586 587 __isl_give isl_ast_node *IslAst::getAst() { return isl_ast_node_copy(Root); } 588 __isl_give isl_ast_expr *IslAst::getRunCondition() { 589 return isl_ast_expr_copy(RunCondition); 590 } 591 592 __isl_give isl_ast_node *IslAstInfo::getAst() { return Ast.getAst(); } 593 __isl_give isl_ast_expr *IslAstInfo::getRunCondition() { 594 return Ast.getRunCondition(); 595 } 596 597 IslAstUserPayload *IslAstInfo::getNodePayload(__isl_keep isl_ast_node *Node) { 598 isl_id *Id = isl_ast_node_get_annotation(Node); 599 if (!Id) 600 return nullptr; 601 IslAstUserPayload *Payload = (IslAstUserPayload *)isl_id_get_user(Id); 602 isl_id_free(Id); 603 return Payload; 604 } 605 606 bool IslAstInfo::isInnermost(__isl_keep isl_ast_node *Node) { 607 IslAstUserPayload *Payload = getNodePayload(Node); 608 return Payload && Payload->IsInnermost; 609 } 610 611 bool IslAstInfo::isParallel(__isl_keep isl_ast_node *Node) { 612 return IslAstInfo::isInnermostParallel(Node) || 613 IslAstInfo::isOutermostParallel(Node); 614 } 615 616 bool IslAstInfo::isInnermostParallel(__isl_keep isl_ast_node *Node) { 617 IslAstUserPayload *Payload = getNodePayload(Node); 618 return Payload && Payload->IsInnermostParallel; 619 } 620 621 bool IslAstInfo::isOutermostParallel(__isl_keep isl_ast_node *Node) { 622 IslAstUserPayload *Payload = getNodePayload(Node); 623 return Payload && Payload->IsOutermostParallel; 624 } 625 626 bool IslAstInfo::isReductionParallel(__isl_keep isl_ast_node *Node) { 627 IslAstUserPayload *Payload = getNodePayload(Node); 628 return Payload && Payload->IsReductionParallel; 629 } 630 631 bool IslAstInfo::isExecutedInParallel(__isl_keep isl_ast_node *Node) { 632 if (!PollyParallel) 633 return false; 634 635 // Do not parallelize innermost loops. 636 // 637 // Parallelizing innermost loops is often not profitable, especially if 638 // they have a low number of iterations. 639 // 640 // TODO: Decide this based on the number of loop iterations that will be 641 // executed. This can possibly require run-time checks, which again 642 // raises the question of both run-time check overhead and code size 643 // costs. 644 if (!PollyParallelForce && isInnermost(Node)) 645 return false; 646 647 return isOutermostParallel(Node) && !isReductionParallel(Node); 648 } 649 650 __isl_give isl_union_map * 651 IslAstInfo::getSchedule(__isl_keep isl_ast_node *Node) { 652 IslAstUserPayload *Payload = getNodePayload(Node); 653 return Payload ? isl_ast_build_get_schedule(Payload->Build) : nullptr; 654 } 655 656 __isl_give isl_pw_aff * 657 IslAstInfo::getMinimalDependenceDistance(__isl_keep isl_ast_node *Node) { 658 IslAstUserPayload *Payload = getNodePayload(Node); 659 return Payload ? isl_pw_aff_copy(Payload->MinimalDependenceDistance) 660 : nullptr; 661 } 662 663 IslAstInfo::MemoryAccessSet * 664 IslAstInfo::getBrokenReductions(__isl_keep isl_ast_node *Node) { 665 IslAstUserPayload *Payload = getNodePayload(Node); 666 return Payload ? &Payload->BrokenReductions : nullptr; 667 } 668 669 isl_ast_build *IslAstInfo::getBuild(__isl_keep isl_ast_node *Node) { 670 IslAstUserPayload *Payload = getNodePayload(Node); 671 return Payload ? Payload->Build : nullptr; 672 } 673 674 IslAstInfo IslAstAnalysis::run(Scop &S, ScopAnalysisManager &SAM, 675 ScopStandardAnalysisResults &SAR) { 676 return {S, SAM.getResult<DependenceAnalysis>(S, SAR).getDependences( 677 Dependences::AL_Statement)}; 678 } 679 680 static __isl_give isl_printer *cbPrintUser(__isl_take isl_printer *P, 681 __isl_take isl_ast_print_options *O, 682 __isl_keep isl_ast_node *Node, 683 void *User) { 684 isl::ast_node AstNode = isl::manage_copy(Node); 685 isl::ast_expr NodeExpr = AstNode.user_get_expr(); 686 isl::ast_expr CallExpr = NodeExpr.get_op_arg(0); 687 isl::id CallExprId = CallExpr.get_id(); 688 ScopStmt *AccessStmt = (ScopStmt *)CallExprId.get_user(); 689 690 P = isl_printer_start_line(P); 691 P = isl_printer_print_str(P, AccessStmt->getBaseName()); 692 P = isl_printer_print_str(P, "("); 693 P = isl_printer_end_line(P); 694 P = isl_printer_indent(P, 2); 695 696 for (MemoryAccess *MemAcc : *AccessStmt) { 697 P = isl_printer_start_line(P); 698 699 if (MemAcc->isRead()) 700 P = isl_printer_print_str(P, "/* read */ &"); 701 else 702 P = isl_printer_print_str(P, "/* write */ "); 703 704 isl::ast_build Build = isl::manage_copy(IslAstInfo::getBuild(Node)); 705 if (MemAcc->isAffine()) { 706 isl_pw_multi_aff *PwmaPtr = 707 MemAcc->applyScheduleToAccessRelation(Build.get_schedule()).release(); 708 isl::pw_multi_aff Pwma = isl::manage(PwmaPtr); 709 isl::ast_expr AccessExpr = Build.access_from(Pwma); 710 P = isl_printer_print_ast_expr(P, AccessExpr.get()); 711 } else { 712 P = isl_printer_print_str( 713 P, MemAcc->getLatestScopArrayInfo()->getName().c_str()); 714 P = isl_printer_print_str(P, "[*]"); 715 } 716 P = isl_printer_end_line(P); 717 } 718 719 P = isl_printer_indent(P, -2); 720 P = isl_printer_start_line(P); 721 P = isl_printer_print_str(P, ");"); 722 P = isl_printer_end_line(P); 723 724 isl_ast_print_options_free(O); 725 return P; 726 } 727 728 void IslAstInfo::print(raw_ostream &OS) { 729 isl_ast_print_options *Options; 730 isl_ast_node *RootNode = Ast.getAst(); 731 Function &F = S.getFunction(); 732 733 OS << ":: isl ast :: " << F.getName() << " :: " << S.getNameStr() << "\n"; 734 735 if (!RootNode) { 736 OS << ":: isl ast generation and code generation was skipped!\n\n"; 737 OS << ":: This is either because no useful optimizations could be applied " 738 "(use -polly-process-unprofitable to enforce code generation) or " 739 "because earlier passes such as dependence analysis timed out (use " 740 "-polly-dependences-computeout=0 to set dependence analysis timeout " 741 "to infinity)\n\n"; 742 return; 743 } 744 745 isl_ast_expr *RunCondition = Ast.getRunCondition(); 746 char *RtCStr, *AstStr; 747 748 Options = isl_ast_print_options_alloc(S.getIslCtx().get()); 749 750 if (PrintAccesses) 751 Options = 752 isl_ast_print_options_set_print_user(Options, cbPrintUser, nullptr); 753 Options = isl_ast_print_options_set_print_for(Options, cbPrintFor, nullptr); 754 755 isl_printer *P = isl_printer_to_str(S.getIslCtx().get()); 756 P = isl_printer_set_output_format(P, ISL_FORMAT_C); 757 P = isl_printer_print_ast_expr(P, RunCondition); 758 RtCStr = isl_printer_get_str(P); 759 P = isl_printer_flush(P); 760 P = isl_printer_indent(P, 4); 761 P = isl_ast_node_print(RootNode, P, Options); 762 AstStr = isl_printer_get_str(P); 763 764 auto *Schedule = S.getScheduleTree().release(); 765 766 DEBUG({ 767 dbgs() << S.getContextStr() << "\n"; 768 dbgs() << stringFromIslObj(Schedule); 769 }); 770 OS << "\nif (" << RtCStr << ")\n\n"; 771 OS << AstStr << "\n"; 772 OS << "else\n"; 773 OS << " { /* original code */ }\n\n"; 774 775 free(RtCStr); 776 free(AstStr); 777 778 isl_ast_expr_free(RunCondition); 779 isl_schedule_free(Schedule); 780 isl_ast_node_free(RootNode); 781 isl_printer_free(P); 782 } 783 784 AnalysisKey IslAstAnalysis::Key; 785 PreservedAnalyses IslAstPrinterPass::run(Scop &S, ScopAnalysisManager &SAM, 786 ScopStandardAnalysisResults &SAR, 787 SPMUpdater &U) { 788 auto &Ast = SAM.getResult<IslAstAnalysis>(S, SAR); 789 Ast.print(OS); 790 return PreservedAnalyses::all(); 791 } 792 793 void IslAstInfoWrapperPass::releaseMemory() { Ast.reset(); } 794 795 bool IslAstInfoWrapperPass::runOnScop(Scop &Scop) { 796 // Skip SCoPs in case they're already handled by PPCGCodeGeneration. 797 if (Scop.isToBeSkipped()) 798 return false; 799 800 ScopsProcessed++; 801 802 const Dependences &D = 803 getAnalysis<DependenceInfo>().getDependences(Dependences::AL_Statement); 804 805 if (D.getSharedIslCtx() != Scop.getSharedIslCtx()) { 806 DEBUG(dbgs() << "Got dependence analysis for different SCoP/isl_ctx\n"); 807 Ast.reset(); 808 return false; 809 } 810 811 Ast.reset(new IslAstInfo(Scop, D)); 812 813 DEBUG(printScop(dbgs(), Scop)); 814 return false; 815 } 816 817 void IslAstInfoWrapperPass::getAnalysisUsage(AnalysisUsage &AU) const { 818 // Get the Common analysis usage of ScopPasses. 819 ScopPass::getAnalysisUsage(AU); 820 AU.addRequiredTransitive<ScopInfoRegionPass>(); 821 AU.addRequired<DependenceInfo>(); 822 823 AU.addPreserved<DependenceInfo>(); 824 } 825 826 void IslAstInfoWrapperPass::printScop(raw_ostream &OS, Scop &S) const { 827 if (Ast) 828 Ast->print(OS); 829 } 830 831 char IslAstInfoWrapperPass::ID = 0; 832 833 Pass *polly::createIslAstInfoWrapperPassPass() { 834 return new IslAstInfoWrapperPass(); 835 } 836 837 INITIALIZE_PASS_BEGIN(IslAstInfoWrapperPass, "polly-ast", 838 "Polly - Generate an AST of the SCoP (isl)", false, 839 false); 840 INITIALIZE_PASS_DEPENDENCY(ScopInfoRegionPass); 841 INITIALIZE_PASS_DEPENDENCY(DependenceInfo); 842 INITIALIZE_PASS_END(IslAstInfoWrapperPass, "polly-ast", 843 "Polly - Generate an AST from the SCoP (isl)", false, false) 844