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_give isl_ast_expr * 351 buildCondition(__isl_keep isl_ast_build *Build, const Scop::MinMaxAccessTy *It0, 352 const Scop::MinMaxAccessTy *It1) { 353 isl_ast_expr *NonAliasGroup, *MinExpr, *MaxExpr; 354 MinExpr = isl_ast_expr_address_of(isl_ast_build_access_from_pw_multi_aff( 355 Build, isl_pw_multi_aff_copy(It0->first))); 356 MaxExpr = isl_ast_expr_address_of(isl_ast_build_access_from_pw_multi_aff( 357 Build, isl_pw_multi_aff_copy(It1->second))); 358 NonAliasGroup = isl_ast_expr_le(MaxExpr, MinExpr); 359 MinExpr = isl_ast_expr_address_of(isl_ast_build_access_from_pw_multi_aff( 360 Build, isl_pw_multi_aff_copy(It1->first))); 361 MaxExpr = isl_ast_expr_address_of(isl_ast_build_access_from_pw_multi_aff( 362 Build, isl_pw_multi_aff_copy(It0->second))); 363 NonAliasGroup = 364 isl_ast_expr_or(NonAliasGroup, isl_ast_expr_le(MaxExpr, MinExpr)); 365 366 return NonAliasGroup; 367 } 368 369 __isl_give isl_ast_expr * 370 IslAst::buildRunCondition(Scop &S, __isl_keep isl_ast_build *Build) { 371 isl_ast_expr *RunCondition; 372 373 // The conditions that need to be checked at run-time for this scop are 374 // available as an isl_set in the runtime check context from which we can 375 // directly derive a run-time condition. 376 auto *PosCond = 377 isl_ast_build_expr_from_set(Build, S.getAssumedContext().release()); 378 if (S.hasTrivialInvalidContext()) { 379 RunCondition = PosCond; 380 } else { 381 auto *ZeroV = isl_val_zero(isl_ast_build_get_ctx(Build)); 382 auto *NegCond = 383 isl_ast_build_expr_from_set(Build, S.getInvalidContext().release()); 384 auto *NotNegCond = isl_ast_expr_eq(isl_ast_expr_from_val(ZeroV), NegCond); 385 RunCondition = isl_ast_expr_and(PosCond, NotNegCond); 386 } 387 388 // Create the alias checks from the minimal/maximal accesses in each alias 389 // group which consists of read only and non read only (read write) accesses. 390 // This operation is by construction quadratic in the read-write pointers and 391 // linear in the read only pointers in each alias group. 392 for (const Scop::MinMaxVectorPairTy &MinMaxAccessPair : S.getAliasGroups()) { 393 auto &MinMaxReadWrite = MinMaxAccessPair.first; 394 auto &MinMaxReadOnly = MinMaxAccessPair.second; 395 auto RWAccEnd = MinMaxReadWrite.end(); 396 397 for (auto RWAccIt0 = MinMaxReadWrite.begin(); RWAccIt0 != RWAccEnd; 398 ++RWAccIt0) { 399 for (auto RWAccIt1 = RWAccIt0 + 1; RWAccIt1 != RWAccEnd; ++RWAccIt1) 400 RunCondition = isl_ast_expr_and( 401 RunCondition, buildCondition(Build, RWAccIt0, RWAccIt1)); 402 for (const Scop::MinMaxAccessTy &ROAccIt : MinMaxReadOnly) 403 RunCondition = isl_ast_expr_and( 404 RunCondition, buildCondition(Build, RWAccIt0, &ROAccIt)); 405 } 406 } 407 408 return RunCondition; 409 } 410 411 /// Simple cost analysis for a given SCoP. 412 /// 413 /// TODO: Improve this analysis and extract it to make it usable in other 414 /// places too. 415 /// In order to improve the cost model we could either keep track of 416 /// performed optimizations (e.g., tiling) or compute properties on the 417 /// original as well as optimized SCoP (e.g., #stride-one-accesses). 418 static bool benefitsFromPolly(Scop &Scop, bool PerformParallelTest) { 419 if (PollyProcessUnprofitable) 420 return true; 421 422 // Check if nothing interesting happened. 423 if (!PerformParallelTest && !Scop.isOptimized() && 424 Scop.getAliasGroups().empty()) 425 return false; 426 427 // The default assumption is that Polly improves the code. 428 return true; 429 } 430 431 /// Collect statistics for the syntax tree rooted at @p Ast. 432 static void walkAstForStatistics(__isl_keep isl_ast_node *Ast) { 433 assert(Ast); 434 isl_ast_node_foreach_descendant_top_down( 435 Ast, 436 [](__isl_keep isl_ast_node *Node, void *User) -> isl_bool { 437 switch (isl_ast_node_get_type(Node)) { 438 case isl_ast_node_for: 439 NumForLoops++; 440 if (IslAstInfo::isParallel(Node)) 441 NumParallel++; 442 if (IslAstInfo::isInnermostParallel(Node)) 443 NumInnermostParallel++; 444 if (IslAstInfo::isOutermostParallel(Node)) 445 NumOutermostParallel++; 446 if (IslAstInfo::isReductionParallel(Node)) 447 NumReductionParallel++; 448 if (IslAstInfo::isExecutedInParallel(Node)) 449 NumExecutedInParallel++; 450 break; 451 452 case isl_ast_node_if: 453 NumIfConditions++; 454 break; 455 456 default: 457 break; 458 } 459 460 // Continue traversing subtrees. 461 return isl_bool_true; 462 }, 463 nullptr); 464 } 465 466 IslAst::IslAst(Scop &Scop) : S(Scop), Ctx(Scop.getSharedIslCtx()) {} 467 468 IslAst::IslAst(IslAst &&O) 469 : S(O.S), Root(O.Root), RunCondition(O.RunCondition), Ctx(O.Ctx) { 470 O.Root = nullptr; 471 O.RunCondition = nullptr; 472 } 473 474 IslAst::~IslAst() { 475 isl_ast_node_free(Root); 476 isl_ast_expr_free(RunCondition); 477 } 478 479 void IslAst::init(const Dependences &D) { 480 bool PerformParallelTest = PollyParallel || DetectParallel || 481 PollyVectorizerChoice != VECTORIZER_NONE; 482 483 // We can not perform the dependence analysis and, consequently, 484 // the parallel code generation in case the schedule tree contains 485 // extension nodes. 486 auto *ScheduleTree = S.getScheduleTree().release(); 487 PerformParallelTest = 488 PerformParallelTest && !S.containsExtensionNode(ScheduleTree); 489 isl_schedule_free(ScheduleTree); 490 491 // Skip AST and code generation if there was no benefit achieved. 492 if (!benefitsFromPolly(S, PerformParallelTest)) 493 return; 494 495 auto ScopStats = S.getStatistics(); 496 ScopsBeneficial++; 497 BeneficialAffineLoops += ScopStats.NumAffineLoops; 498 BeneficialBoxedLoops += ScopStats.NumBoxedLoops; 499 500 isl_ctx *Ctx = S.getIslCtx(); 501 isl_options_set_ast_build_atomic_upper_bound(Ctx, true); 502 isl_options_set_ast_build_detect_min_max(Ctx, true); 503 isl_ast_build *Build; 504 AstBuildUserInfo BuildInfo; 505 506 if (UseContext) 507 Build = isl_ast_build_from_context(S.getContext().release()); 508 else 509 Build = isl_ast_build_from_context( 510 isl_set_universe(S.getParamSpace().release())); 511 512 Build = isl_ast_build_set_at_each_domain(Build, AtEachDomain, nullptr); 513 514 if (PerformParallelTest) { 515 BuildInfo.Deps = &D; 516 BuildInfo.InParallelFor = false; 517 518 Build = isl_ast_build_set_before_each_for(Build, &astBuildBeforeFor, 519 &BuildInfo); 520 Build = 521 isl_ast_build_set_after_each_for(Build, &astBuildAfterFor, &BuildInfo); 522 523 Build = isl_ast_build_set_before_each_mark(Build, &astBuildBeforeMark, 524 &BuildInfo); 525 526 Build = isl_ast_build_set_after_each_mark(Build, &astBuildAfterMark, 527 &BuildInfo); 528 } 529 530 RunCondition = buildRunCondition(S, Build); 531 532 Root = isl_ast_build_node_from_schedule(Build, S.getScheduleTree().release()); 533 walkAstForStatistics(Root); 534 535 isl_ast_build_free(Build); 536 } 537 538 IslAst IslAst::create(Scop &Scop, const Dependences &D) { 539 IslAst Ast{Scop}; 540 Ast.init(D); 541 return Ast; 542 } 543 544 __isl_give isl_ast_node *IslAst::getAst() { return isl_ast_node_copy(Root); } 545 __isl_give isl_ast_expr *IslAst::getRunCondition() { 546 return isl_ast_expr_copy(RunCondition); 547 } 548 549 __isl_give isl_ast_node *IslAstInfo::getAst() { return Ast.getAst(); } 550 __isl_give isl_ast_expr *IslAstInfo::getRunCondition() { 551 return Ast.getRunCondition(); 552 } 553 554 IslAstUserPayload *IslAstInfo::getNodePayload(__isl_keep isl_ast_node *Node) { 555 isl_id *Id = isl_ast_node_get_annotation(Node); 556 if (!Id) 557 return nullptr; 558 IslAstUserPayload *Payload = (IslAstUserPayload *)isl_id_get_user(Id); 559 isl_id_free(Id); 560 return Payload; 561 } 562 563 bool IslAstInfo::isInnermost(__isl_keep isl_ast_node *Node) { 564 IslAstUserPayload *Payload = getNodePayload(Node); 565 return Payload && Payload->IsInnermost; 566 } 567 568 bool IslAstInfo::isParallel(__isl_keep isl_ast_node *Node) { 569 return IslAstInfo::isInnermostParallel(Node) || 570 IslAstInfo::isOutermostParallel(Node); 571 } 572 573 bool IslAstInfo::isInnermostParallel(__isl_keep isl_ast_node *Node) { 574 IslAstUserPayload *Payload = getNodePayload(Node); 575 return Payload && Payload->IsInnermostParallel; 576 } 577 578 bool IslAstInfo::isOutermostParallel(__isl_keep isl_ast_node *Node) { 579 IslAstUserPayload *Payload = getNodePayload(Node); 580 return Payload && Payload->IsOutermostParallel; 581 } 582 583 bool IslAstInfo::isReductionParallel(__isl_keep isl_ast_node *Node) { 584 IslAstUserPayload *Payload = getNodePayload(Node); 585 return Payload && Payload->IsReductionParallel; 586 } 587 588 bool IslAstInfo::isExecutedInParallel(__isl_keep isl_ast_node *Node) { 589 if (!PollyParallel) 590 return false; 591 592 // Do not parallelize innermost loops. 593 // 594 // Parallelizing innermost loops is often not profitable, especially if 595 // they have a low number of iterations. 596 // 597 // TODO: Decide this based on the number of loop iterations that will be 598 // executed. This can possibly require run-time checks, which again 599 // raises the question of both run-time check overhead and code size 600 // costs. 601 if (!PollyParallelForce && isInnermost(Node)) 602 return false; 603 604 return isOutermostParallel(Node) && !isReductionParallel(Node); 605 } 606 607 __isl_give isl_union_map * 608 IslAstInfo::getSchedule(__isl_keep isl_ast_node *Node) { 609 IslAstUserPayload *Payload = getNodePayload(Node); 610 return Payload ? isl_ast_build_get_schedule(Payload->Build) : nullptr; 611 } 612 613 __isl_give isl_pw_aff * 614 IslAstInfo::getMinimalDependenceDistance(__isl_keep isl_ast_node *Node) { 615 IslAstUserPayload *Payload = getNodePayload(Node); 616 return Payload ? isl_pw_aff_copy(Payload->MinimalDependenceDistance) 617 : nullptr; 618 } 619 620 IslAstInfo::MemoryAccessSet * 621 IslAstInfo::getBrokenReductions(__isl_keep isl_ast_node *Node) { 622 IslAstUserPayload *Payload = getNodePayload(Node); 623 return Payload ? &Payload->BrokenReductions : nullptr; 624 } 625 626 isl_ast_build *IslAstInfo::getBuild(__isl_keep isl_ast_node *Node) { 627 IslAstUserPayload *Payload = getNodePayload(Node); 628 return Payload ? Payload->Build : nullptr; 629 } 630 631 IslAstInfo IslAstAnalysis::run(Scop &S, ScopAnalysisManager &SAM, 632 ScopStandardAnalysisResults &SAR) { 633 return {S, SAM.getResult<DependenceAnalysis>(S, SAR).getDependences( 634 Dependences::AL_Statement)}; 635 } 636 637 static __isl_give isl_printer *cbPrintUser(__isl_take isl_printer *P, 638 __isl_take isl_ast_print_options *O, 639 __isl_keep isl_ast_node *Node, 640 void *User) { 641 isl::ast_node AstNode = isl::manage(isl_ast_node_copy(Node)); 642 isl::ast_expr NodeExpr = AstNode.user_get_expr(); 643 isl::ast_expr CallExpr = NodeExpr.get_op_arg(0); 644 isl::id CallExprId = CallExpr.get_id(); 645 ScopStmt *AccessStmt = (ScopStmt *)CallExprId.get_user(); 646 647 P = isl_printer_start_line(P); 648 P = isl_printer_print_str(P, AccessStmt->getBaseName()); 649 P = isl_printer_print_str(P, "("); 650 P = isl_printer_end_line(P); 651 P = isl_printer_indent(P, 2); 652 653 for (MemoryAccess *MemAcc : *AccessStmt) { 654 P = isl_printer_start_line(P); 655 656 if (MemAcc->isRead()) 657 P = isl_printer_print_str(P, "/* read */ &"); 658 else 659 P = isl_printer_print_str(P, "/* write */ "); 660 661 isl::ast_build Build = 662 isl::manage(isl_ast_build_copy(IslAstInfo::getBuild(Node))); 663 if (MemAcc->isAffine()) { 664 isl_pw_multi_aff *PwmaPtr = 665 MemAcc->applyScheduleToAccessRelation(Build.get_schedule()).release(); 666 isl::pw_multi_aff Pwma = isl::manage(PwmaPtr); 667 isl::ast_expr AccessExpr = Build.access_from(Pwma); 668 P = isl_printer_print_ast_expr(P, AccessExpr.get()); 669 } else { 670 P = isl_printer_print_str( 671 P, MemAcc->getLatestScopArrayInfo()->getName().c_str()); 672 P = isl_printer_print_str(P, "[*]"); 673 } 674 P = isl_printer_end_line(P); 675 } 676 677 P = isl_printer_indent(P, -2); 678 P = isl_printer_start_line(P); 679 P = isl_printer_print_str(P, ");"); 680 P = isl_printer_end_line(P); 681 682 isl_ast_print_options_free(O); 683 return P; 684 } 685 686 void IslAstInfo::print(raw_ostream &OS) { 687 isl_ast_print_options *Options; 688 isl_ast_node *RootNode = Ast.getAst(); 689 Function &F = S.getFunction(); 690 691 OS << ":: isl ast :: " << F.getName() << " :: " << S.getNameStr() << "\n"; 692 693 if (!RootNode) { 694 OS << ":: isl ast generation and code generation was skipped!\n\n"; 695 OS << ":: This is either because no useful optimizations could be applied " 696 "(use -polly-process-unprofitable to enforce code generation) or " 697 "because earlier passes such as dependence analysis timed out (use " 698 "-polly-dependences-computeout=0 to set dependence analysis timeout " 699 "to infinity)\n\n"; 700 return; 701 } 702 703 isl_ast_expr *RunCondition = Ast.getRunCondition(); 704 char *RtCStr, *AstStr; 705 706 Options = isl_ast_print_options_alloc(S.getIslCtx()); 707 708 if (PrintAccesses) 709 Options = 710 isl_ast_print_options_set_print_user(Options, cbPrintUser, nullptr); 711 Options = isl_ast_print_options_set_print_for(Options, cbPrintFor, nullptr); 712 713 isl_printer *P = isl_printer_to_str(S.getIslCtx()); 714 P = isl_printer_set_output_format(P, ISL_FORMAT_C); 715 P = isl_printer_print_ast_expr(P, RunCondition); 716 RtCStr = isl_printer_get_str(P); 717 P = isl_printer_flush(P); 718 P = isl_printer_indent(P, 4); 719 P = isl_ast_node_print(RootNode, P, Options); 720 AstStr = isl_printer_get_str(P); 721 722 auto *Schedule = S.getScheduleTree().release(); 723 724 DEBUG({ 725 dbgs() << S.getContextStr() << "\n"; 726 dbgs() << stringFromIslObj(Schedule); 727 }); 728 OS << "\nif (" << RtCStr << ")\n\n"; 729 OS << AstStr << "\n"; 730 OS << "else\n"; 731 OS << " { /* original code */ }\n\n"; 732 733 free(RtCStr); 734 free(AstStr); 735 736 isl_ast_expr_free(RunCondition); 737 isl_schedule_free(Schedule); 738 isl_ast_node_free(RootNode); 739 isl_printer_free(P); 740 } 741 742 AnalysisKey IslAstAnalysis::Key; 743 PreservedAnalyses IslAstPrinterPass::run(Scop &S, ScopAnalysisManager &SAM, 744 ScopStandardAnalysisResults &SAR, 745 SPMUpdater &U) { 746 auto &Ast = SAM.getResult<IslAstAnalysis>(S, SAR); 747 Ast.print(OS); 748 return PreservedAnalyses::all(); 749 } 750 751 void IslAstInfoWrapperPass::releaseMemory() { Ast.reset(); } 752 753 bool IslAstInfoWrapperPass::runOnScop(Scop &Scop) { 754 // Skip SCoPs in case they're already handled by PPCGCodeGeneration. 755 if (Scop.isToBeSkipped()) 756 return false; 757 758 ScopsProcessed++; 759 760 const Dependences &D = 761 getAnalysis<DependenceInfo>().getDependences(Dependences::AL_Statement); 762 763 Ast.reset(new IslAstInfo(Scop, D)); 764 765 DEBUG(printScop(dbgs(), Scop)); 766 return false; 767 } 768 769 void IslAstInfoWrapperPass::getAnalysisUsage(AnalysisUsage &AU) const { 770 // Get the Common analysis usage of ScopPasses. 771 ScopPass::getAnalysisUsage(AU); 772 AU.addRequired<ScopInfoRegionPass>(); 773 AU.addRequired<DependenceInfo>(); 774 } 775 776 void IslAstInfoWrapperPass::printScop(raw_ostream &OS, Scop &S) const { 777 if (Ast) 778 Ast->print(OS); 779 } 780 781 char IslAstInfoWrapperPass::ID = 0; 782 783 Pass *polly::createIslAstInfoWrapperPassPass() { 784 return new IslAstInfoWrapperPass(); 785 } 786 787 INITIALIZE_PASS_BEGIN(IslAstInfoWrapperPass, "polly-ast", 788 "Polly - Generate an AST of the SCoP (isl)", false, 789 false); 790 INITIALIZE_PASS_DEPENDENCY(ScopInfoRegionPass); 791 INITIALIZE_PASS_DEPENDENCY(DependenceInfo); 792 INITIALIZE_PASS_END(IslAstInfoWrapperPass, "polly-ast", 793 "Polly - Generate an AST from the SCoP (isl)", false, false) 794