Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 1 | //===-- LLVMTargetMachine.cpp - Implement the LLVMTargetMachine class -----===// |
| 2 | // |
| 3 | // The LLVM Compiler Infrastructure |
| 4 | // |
Chris Lattner | 081ce94 | 2007-12-29 20:36:04 +0000 | [diff] [blame] | 5 | // This file is distributed under the University of Illinois Open Source |
| 6 | // License. See LICENSE.TXT for details. |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 7 | // |
| 8 | //===----------------------------------------------------------------------===// |
| 9 | // |
| 10 | // This file implements the LLVMTargetMachine class. |
| 11 | // |
| 12 | //===----------------------------------------------------------------------===// |
| 13 | |
| 14 | #include "llvm/Target/TargetMachine.h" |
| 15 | #include "llvm/PassManager.h" |
| 16 | #include "llvm/Pass.h" |
| 17 | #include "llvm/Assembly/PrintModulePass.h" |
| 18 | #include "llvm/Analysis/LoopPass.h" |
| 19 | #include "llvm/CodeGen/Passes.h" |
Gordon Henriksen | f194af2 | 2008-08-17 12:56:54 +0000 | [diff] [blame] | 20 | #include "llvm/CodeGen/GCStrategy.h" |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 21 | #include "llvm/Target/TargetOptions.h" |
Dale Johannesen | 8553576 | 2008-04-02 00:25:04 +0000 | [diff] [blame] | 22 | #include "llvm/Target/TargetAsmInfo.h" |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 23 | #include "llvm/Transforms/Scalar.h" |
| 24 | #include "llvm/Support/CommandLine.h" |
Owen Anderson | 847b99b | 2008-08-21 00:14:44 +0000 | [diff] [blame] | 25 | #include "llvm/Support/raw_ostream.h" |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 26 | using namespace llvm; |
| 27 | |
| 28 | static cl::opt<bool> PrintLSR("print-lsr-output", cl::Hidden, |
| 29 | cl::desc("Print LLVM IR produced by the loop-reduce pass")); |
| 30 | static cl::opt<bool> PrintISelInput("print-isel-input", cl::Hidden, |
| 31 | cl::desc("Print LLVM IR input to isel pass")); |
Evan Cheng | 7754721 | 2007-07-20 21:56:13 +0000 | [diff] [blame] | 32 | static cl::opt<bool> PrintEmittedAsm("print-emitted-asm", cl::Hidden, |
| 33 | cl::desc("Dump emitter generated instructions as assembly")); |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 34 | static cl::opt<bool> PrintGCInfo("print-gc", cl::Hidden, |
| 35 | cl::desc("Dump garbage collector data")); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 36 | |
Chris Lattner | 3988226 | 2008-01-04 07:36:53 +0000 | [diff] [blame] | 37 | // Hidden options to help debugging |
| 38 | static cl::opt<bool> |
| 39 | EnableSinking("enable-sinking", cl::init(false), cl::Hidden, |
| 40 | cl::desc("Perform sinking on machine code")); |
Bill Wendling | 4aab7ae | 2008-01-04 08:11:03 +0000 | [diff] [blame] | 41 | static cl::opt<bool> |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 42 | EnableLICM("machine-licm", |
| 43 | cl::init(false), cl::Hidden, |
| 44 | cl::desc("Perform loop-invariant code motion on machine code")); |
Chris Lattner | 3988226 | 2008-01-04 07:36:53 +0000 | [diff] [blame] | 45 | |
Chris Lattner | e06d8eb | 2008-01-14 19:00:06 +0000 | [diff] [blame] | 46 | // When this works it will be on by default. |
| 47 | static cl::opt<bool> |
| 48 | DisablePostRAScheduler("disable-post-RA-scheduler", |
| 49 | cl::desc("Disable scheduling after register allocation"), |
| 50 | cl::init(true)); |
| 51 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 52 | FileModel::Model |
Dan Gohman | e34aa77 | 2008-03-11 22:29:46 +0000 | [diff] [blame] | 53 | LLVMTargetMachine::addPassesToEmitFile(PassManagerBase &PM, |
Owen Anderson | 847b99b | 2008-08-21 00:14:44 +0000 | [diff] [blame] | 54 | raw_ostream &Out, |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 55 | CodeGenFileType FileType, |
| 56 | bool Fast) { |
| 57 | // Standard LLVM-Level Passes. |
| 58 | |
| 59 | // Run loop strength reduction before anything else. |
| 60 | if (!Fast) { |
| 61 | PM.add(createLoopStrengthReducePass(getTargetLowering())); |
| 62 | if (PrintLSR) |
Dan Gohman | 35a5415 | 2008-03-25 21:38:12 +0000 | [diff] [blame] | 63 | PM.add(new PrintFunctionPass("\n\n*** Code after LSR ***\n", &cerr)); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 64 | } |
| 65 | |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 66 | PM.add(createGCLoweringPass()); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 67 | |
Dale Johannesen | 8553576 | 2008-04-02 00:25:04 +0000 | [diff] [blame] | 68 | if (!getTargetAsmInfo()->doesSupportExceptionHandling()) |
Dale Johannesen | 748a85c | 2008-04-01 20:00:57 +0000 | [diff] [blame] | 69 | PM.add(createLowerInvokePass(getTargetLowering())); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 70 | |
| 71 | // Make sure that no unreachable blocks are instruction selected. |
| 72 | PM.add(createUnreachableBlockEliminationPass()); |
| 73 | |
| 74 | if (!Fast) |
| 75 | PM.add(createCodeGenPreparePass(getTargetLowering())); |
| 76 | |
| 77 | if (PrintISelInput) |
Dan Gohman | 35a5415 | 2008-03-25 21:38:12 +0000 | [diff] [blame] | 78 | PM.add(new PrintFunctionPass("\n\n*** Final LLVM Code input to ISel ***\n", |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 79 | &cerr)); |
| 80 | |
| 81 | // Ask the target for an isel. |
| 82 | if (addInstSelector(PM, Fast)) |
| 83 | return FileModel::Error; |
| 84 | |
| 85 | // Print the instruction selected machine code... |
| 86 | if (PrintMachineCode) |
| 87 | PM.add(createMachineFunctionPrinterPass(cerr)); |
Bill Wendling | b958b0d | 2007-12-07 21:42:31 +0000 | [diff] [blame] | 88 | |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 89 | if (EnableLICM) |
Bill Wendling | 4aab7ae | 2008-01-04 08:11:03 +0000 | [diff] [blame] | 90 | PM.add(createMachineLICMPass()); |
Chris Lattner | 3988226 | 2008-01-04 07:36:53 +0000 | [diff] [blame] | 91 | |
| 92 | if (EnableSinking) |
| 93 | PM.add(createMachineSinkingPass()); |
Bill Wendling | b958b0d | 2007-12-07 21:42:31 +0000 | [diff] [blame] | 94 | |
Anton Korobeynikov | 339d245 | 2008-04-23 18:22:28 +0000 | [diff] [blame] | 95 | // Run pre-ra passes. |
| 96 | if (addPreRegAlloc(PM, Fast) && PrintMachineCode) |
| 97 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 98 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 99 | // Perform register allocation to convert to a concrete x86 representation |
| 100 | PM.add(createRegisterAllocator()); |
| 101 | |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 102 | // Perform stack slot coloring. |
Evan Cheng | 2ea5550 | 2008-06-30 22:33:16 +0000 | [diff] [blame] | 103 | if (!Fast) |
| 104 | PM.add(createStackSlotColoringPass()); |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 105 | |
| 106 | if (PrintMachineCode) // Print the register-allocated code |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 107 | PM.add(createMachineFunctionPrinterPass(cerr)); |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 108 | |
| 109 | // Run post-ra passes. |
| 110 | if (addPostRegAlloc(PM, Fast) && PrintMachineCode) |
| 111 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 112 | |
Christopher Lamb | ed37973 | 2007-07-27 07:36:14 +0000 | [diff] [blame] | 113 | PM.add(createLowerSubregsPass()); |
| 114 | |
| 115 | if (PrintMachineCode) // Print the subreg lowered code |
| 116 | PM.add(createMachineFunctionPrinterPass(cerr)); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 117 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 118 | // Insert prolog/epilog code. Eliminate abstract frame index references... |
| 119 | PM.add(createPrologEpilogCodeInserter()); |
| 120 | |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 121 | if (PrintMachineCode) |
| 122 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 123 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 124 | // Second pass scheduler. |
Chris Lattner | e06d8eb | 2008-01-14 19:00:06 +0000 | [diff] [blame] | 125 | if (!Fast && !DisablePostRAScheduler) |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 126 | PM.add(createPostRAScheduler()); |
| 127 | |
| 128 | // Branch folding must be run after regalloc and prolog/epilog insertion. |
| 129 | if (!Fast) |
| 130 | PM.add(createBranchFoldingPass(getEnableTailMergeDefault())); |
Bill Wendling | b958b0d | 2007-12-07 21:42:31 +0000 | [diff] [blame] | 131 | |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 132 | PM.add(createGCMachineCodeAnalysisPass()); |
| 133 | if (PrintMachineCode) |
| 134 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 135 | |
| 136 | if (PrintGCInfo) |
Gordon Henriksen | 1aed599 | 2008-08-17 18:44:35 +0000 | [diff] [blame] | 137 | PM.add(createGCInfoPrinter(*cerr)); |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 138 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 139 | // Fold redundant debug labels. |
| 140 | PM.add(createDebugLabelFoldingPass()); |
| 141 | |
| 142 | if (PrintMachineCode) // Print the register-allocated code |
| 143 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 144 | |
| 145 | if (addPreEmitPass(PM, Fast) && PrintMachineCode) |
| 146 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 147 | |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 148 | if (!Fast && !OptimizeForSize) |
Evan Cheng | 7e29ba0 | 2008-02-28 23:29:57 +0000 | [diff] [blame] | 149 | PM.add(createLoopAlignerPass()); |
| 150 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 151 | switch (FileType) { |
| 152 | default: |
| 153 | break; |
| 154 | case TargetMachine::AssemblyFile: |
| 155 | if (addAssemblyEmitter(PM, Fast, Out)) |
| 156 | return FileModel::Error; |
| 157 | return FileModel::AsmFile; |
| 158 | case TargetMachine::ObjectFile: |
| 159 | if (getMachOWriterInfo()) |
| 160 | return FileModel::MachOFile; |
| 161 | else if (getELFWriterInfo()) |
| 162 | return FileModel::ElfFile; |
| 163 | } |
| 164 | |
| 165 | return FileModel::Error; |
| 166 | } |
| 167 | |
| 168 | /// addPassesToEmitFileFinish - If the passes to emit the specified file had to |
| 169 | /// be split up (e.g., to add an object writer pass), this method can be used to |
| 170 | /// finish up adding passes to emit the file, if necessary. |
Dan Gohman | e34aa77 | 2008-03-11 22:29:46 +0000 | [diff] [blame] | 171 | bool LLVMTargetMachine::addPassesToEmitFileFinish(PassManagerBase &PM, |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 172 | MachineCodeEmitter *MCE, |
| 173 | bool Fast) { |
| 174 | if (MCE) |
Evan Cheng | 7754721 | 2007-07-20 21:56:13 +0000 | [diff] [blame] | 175 | addSimpleCodeEmitter(PM, Fast, PrintEmittedAsm, *MCE); |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 176 | |
Gordon Henriksen | 1aed599 | 2008-08-17 18:44:35 +0000 | [diff] [blame] | 177 | PM.add(createGCInfoDeleter()); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 178 | |
| 179 | // Delete machine code for this function |
| 180 | PM.add(createMachineCodeDeleter()); |
| 181 | |
| 182 | return false; // success! |
| 183 | } |
| 184 | |
| 185 | /// addPassesToEmitMachineCode - Add passes to the specified pass manager to |
| 186 | /// get machine code emitted. This uses a MachineCodeEmitter object to handle |
| 187 | /// actually outputting the machine code and resolving things like the address |
| 188 | /// of functions. This method should returns true if machine code emission is |
| 189 | /// not supported. |
| 190 | /// |
Dan Gohman | e34aa77 | 2008-03-11 22:29:46 +0000 | [diff] [blame] | 191 | bool LLVMTargetMachine::addPassesToEmitMachineCode(PassManagerBase &PM, |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 192 | MachineCodeEmitter &MCE, |
| 193 | bool Fast) { |
| 194 | // Standard LLVM-Level Passes. |
| 195 | |
| 196 | // Run loop strength reduction before anything else. |
| 197 | if (!Fast) { |
| 198 | PM.add(createLoopStrengthReducePass(getTargetLowering())); |
| 199 | if (PrintLSR) |
Dan Gohman | 35a5415 | 2008-03-25 21:38:12 +0000 | [diff] [blame] | 200 | PM.add(new PrintFunctionPass("\n\n*** Code after LSR ***\n", &cerr)); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 201 | } |
| 202 | |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 203 | PM.add(createGCLoweringPass()); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 204 | |
Dale Johannesen | 8553576 | 2008-04-02 00:25:04 +0000 | [diff] [blame] | 205 | if (!getTargetAsmInfo()->doesSupportExceptionHandling()) |
Dale Johannesen | 748a85c | 2008-04-01 20:00:57 +0000 | [diff] [blame] | 206 | PM.add(createLowerInvokePass(getTargetLowering())); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 207 | |
| 208 | // Make sure that no unreachable blocks are instruction selected. |
| 209 | PM.add(createUnreachableBlockEliminationPass()); |
| 210 | |
| 211 | if (!Fast) |
| 212 | PM.add(createCodeGenPreparePass(getTargetLowering())); |
| 213 | |
| 214 | if (PrintISelInput) |
Dan Gohman | 35a5415 | 2008-03-25 21:38:12 +0000 | [diff] [blame] | 215 | PM.add(new PrintFunctionPass("\n\n*** Final LLVM Code input to ISel ***\n", |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 216 | &cerr)); |
| 217 | |
| 218 | // Ask the target for an isel. |
| 219 | if (addInstSelector(PM, Fast)) |
| 220 | return true; |
| 221 | |
| 222 | // Print the instruction selected machine code... |
| 223 | if (PrintMachineCode) |
| 224 | PM.add(createMachineFunctionPrinterPass(cerr)); |
Bill Wendling | b958b0d | 2007-12-07 21:42:31 +0000 | [diff] [blame] | 225 | |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 226 | if (EnableLICM) |
Bill Wendling | 4aab7ae | 2008-01-04 08:11:03 +0000 | [diff] [blame] | 227 | PM.add(createMachineLICMPass()); |
Chris Lattner | a132dd4 | 2008-01-05 06:14:16 +0000 | [diff] [blame] | 228 | |
| 229 | if (EnableSinking) |
| 230 | PM.add(createMachineSinkingPass()); |
Bill Wendling | b958b0d | 2007-12-07 21:42:31 +0000 | [diff] [blame] | 231 | |
Anton Korobeynikov | 9cba34c | 2008-04-23 18:26:03 +0000 | [diff] [blame] | 232 | // Run pre-ra passes. |
| 233 | if (addPreRegAlloc(PM, Fast) && PrintMachineCode) |
| 234 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 235 | |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 236 | // Perform register allocation. |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 237 | PM.add(createRegisterAllocator()); |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 238 | |
| 239 | // Perform stack slot coloring. |
Evan Cheng | 2ea5550 | 2008-06-30 22:33:16 +0000 | [diff] [blame] | 240 | if (!Fast) |
| 241 | PM.add(createStackSlotColoringPass()); |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 242 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 243 | if (PrintMachineCode) |
| 244 | PM.add(createMachineFunctionPrinterPass(cerr)); |
Christopher Lamb | ed37973 | 2007-07-27 07:36:14 +0000 | [diff] [blame] | 245 | |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 246 | // Run post-ra passes. |
| 247 | if (addPostRegAlloc(PM, Fast) && PrintMachineCode) |
| 248 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 249 | |
| 250 | if (PrintMachineCode) // Print the register-allocated code |
| 251 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 252 | |
Christopher Lamb | ed37973 | 2007-07-27 07:36:14 +0000 | [diff] [blame] | 253 | PM.add(createLowerSubregsPass()); |
| 254 | |
| 255 | if (PrintMachineCode) // Print the subreg lowered code |
| 256 | PM.add(createMachineFunctionPrinterPass(cerr)); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 257 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 258 | // Insert prolog/epilog code. Eliminate abstract frame index references... |
| 259 | PM.add(createPrologEpilogCodeInserter()); |
| 260 | |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 261 | if (PrintMachineCode) |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 262 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 263 | |
| 264 | // Second pass scheduler. |
| 265 | if (!Fast) |
| 266 | PM.add(createPostRAScheduler()); |
| 267 | |
| 268 | // Branch folding must be run after regalloc and prolog/epilog insertion. |
| 269 | if (!Fast) |
| 270 | PM.add(createBranchFoldingPass(getEnableTailMergeDefault())); |
Bill Wendling | b958b0d | 2007-12-07 21:42:31 +0000 | [diff] [blame] | 271 | |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 272 | PM.add(createGCMachineCodeAnalysisPass()); |
Evan Cheng | 14f8a50 | 2008-06-04 09:18:41 +0000 | [diff] [blame] | 273 | |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 274 | if (PrintMachineCode) |
| 275 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 276 | |
| 277 | if (PrintGCInfo) |
Gordon Henriksen | 1aed599 | 2008-08-17 18:44:35 +0000 | [diff] [blame] | 278 | PM.add(createGCInfoPrinter(*cerr)); |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 279 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 280 | if (addPreEmitPass(PM, Fast) && PrintMachineCode) |
| 281 | PM.add(createMachineFunctionPrinterPass(cerr)); |
| 282 | |
Evan Cheng | 7754721 | 2007-07-20 21:56:13 +0000 | [diff] [blame] | 283 | addCodeEmitter(PM, Fast, PrintEmittedAsm, MCE); |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 284 | |
Gordon Henriksen | 1aed599 | 2008-08-17 18:44:35 +0000 | [diff] [blame] | 285 | PM.add(createGCInfoDeleter()); |
Gordon Henriksen | 3646477 | 2008-01-07 01:33:09 +0000 | [diff] [blame] | 286 | |
Dan Gohman | f17a25c | 2007-07-18 16:29:46 +0000 | [diff] [blame] | 287 | // Delete machine code for this function |
| 288 | PM.add(createMachineCodeDeleter()); |
| 289 | |
| 290 | return false; // success! |
| 291 | } |