llvm-project/llvm/lib/Target/SystemZ
Adrian Prantl 5f8f34e459 Remove \brief commands from doxygen comments.
We've been running doxygen with the autobrief option for a couple of
years now. This makes the \brief markers into our comments
redundant. Since they are a visual distraction and we don't want to
encourage more \brief markers in new code either, this patch removes
them all.

Patch produced by

  for i in $(git grep -l '\\brief'); do perl -pi -e 's/\\brief //g' $i & done

Differential Revision: https://reviews.llvm.org/D46290

llvm-svn: 331272
2018-05-01 15:54:18 +00:00
..
AsmParser [AsmParser][TableGen] Add VariantID argument to the generated mnemonic spell check function so it can use the correct table based on variant. 2017-10-26 06:46:41 +00:00
Disassembler [SystemZ] Add all remaining instructions 2017-06-30 20:43:40 +00:00
InstPrinter
MCTargetDesc Thread MCSubtargetInfo through Target::createMCAsmBackend 2018-01-03 08:53:05 +00:00
TargetInfo Add backend name to Target to enable runtime info to be fed back into TableGen 2017-11-15 23:55:44 +00:00
CMakeLists.txt Consistently sort add_subdirectory calls in lib/Target/*/CMakeLists.txt 2018-04-23 12:49:34 +00:00
LLVMBuild.txt SystemZCodeGen: Update libdeps. r308024 introduced LoopDataPrefetchPass. 2017-07-15 06:32:12 +00:00
README.txt
SystemZ.h [SystemZ] Handle SADDO et.al. and ADD/SUBCARRY 2018-04-30 17:54:28 +00:00
SystemZ.td [MachineOperand][Target] MachineOperand::isRenamable semantics changes 2018-02-23 18:25:08 +00:00
SystemZAsmPrinter.cpp [SystemZ] Support stackmaps and patchpoints 2018-03-02 20:39:30 +00:00
SystemZAsmPrinter.h [SystemZ] Support stackmaps and patchpoints 2018-03-02 20:39:30 +00:00
SystemZCallingConv.cpp
SystemZCallingConv.h
SystemZCallingConv.td [SystemZ] Add support for anyregcc calling convention 2018-03-02 20:40:11 +00:00
SystemZConstantPoolValue.cpp
SystemZConstantPoolValue.h
SystemZElimCompare.cpp [SystemZ] Check for legality before doing LOAD AND TEST transformations. 2018-01-15 15:41:26 +00:00
SystemZExpandPseudo.cpp Remove \brief commands from doxygen comments. 2018-05-01 15:54:18 +00:00
SystemZFeatures.td [SystemZ] Improve handling of Select pseudo-instructions 2018-04-30 15:49:27 +00:00
SystemZFrameLowering.cpp [SystemZ] Add support for anyregcc calling convention 2018-03-02 20:40:11 +00:00
SystemZFrameLowering.h [SystemZ] Fix common-code users of stack size 2018-03-02 20:38:41 +00:00
SystemZHazardRecognizer.cpp [SystemZ] NFC refactoring in SystemZHazardRecognizer. 2018-03-07 08:57:09 +00:00
SystemZHazardRecognizer.h [SystemZ] Improve getCurrCycleIdx() in SystemZHazardRecognizer. 2018-03-07 08:54:32 +00:00
SystemZISelDAGToDAG.cpp [SystemZ] Handle SADDO et.al. and ADD/SUBCARRY 2018-04-30 17:54:28 +00:00
SystemZISelLowering.cpp [SystemZ] Handle SADDO et.al. and ADD/SUBCARRY 2018-04-30 17:54:28 +00:00
SystemZISelLowering.h [SystemZ] Handle SADDO et.al. and ADD/SUBCARRY 2018-04-30 17:54:28 +00:00
SystemZInstrBuilder.h
SystemZInstrDFP.td
SystemZInstrFP.td [SystemZ] Improve handling of Select pseudo-instructions 2018-04-30 15:49:27 +00:00
SystemZInstrFormats.td [SystemZ] Do not use glue to represent condition code dependencies 2018-04-30 17:52:32 +00:00
SystemZInstrHFP.td
SystemZInstrInfo.cpp [SystemZ] Handle SADDO et.al. and ADD/SUBCARRY 2018-04-30 17:54:28 +00:00
SystemZInstrInfo.h Target/TargetInstrInfo.h -> CodeGen/TargetInstrInfo.h to match layering 2017-11-08 01:01:31 +00:00
SystemZInstrInfo.td [SystemZ] Handle SADDO et.al. and ADD/SUBCARRY 2018-04-30 17:54:28 +00:00
SystemZInstrSystem.td [SystemZ] set 'guessInstructionProperties = 0' and set flags as needed. 2017-12-05 11:24:39 +00:00
SystemZInstrVector.td [SystemZ] set 'guessInstructionProperties = 0' and set flags as needed. 2017-12-05 11:24:39 +00:00
SystemZLDCleanup.cpp MachineFunction: Return reference from getFunction(); NFC 2017-12-15 22:22:58 +00:00
SystemZLongBranch.cpp [SystemZ] Handle BRCTH branches correctly in SystemZLongBranch.cpp. 2018-01-17 17:16:07 +00:00
SystemZMCInstLower.cpp
SystemZMCInstLower.h
SystemZMachineFunctionInfo.cpp
SystemZMachineFunctionInfo.h
SystemZMachineScheduler.cpp [TargetSchedule] shrink interface for init(); NFCI 2018-04-08 19:56:04 +00:00
SystemZMachineScheduler.h [SystemZ] Improved debug dumping during post-RA scheduling. 2018-03-07 08:39:00 +00:00
SystemZOperands.td [SystemZ] Handle SADDO et.al. and ADD/SUBCARRY 2018-04-30 17:54:28 +00:00
SystemZOperators.td [SystemZ] Handle SADDO et.al. and ADD/SUBCARRY 2018-04-30 17:54:28 +00:00
SystemZPatterns.td [SystemZ] Add support for IBM z14 processor (1/3) 2017-07-17 17:41:11 +00:00
SystemZProcessors.td [SystemZ] Add support for IBM z14 processor (1/3) 2017-07-17 17:41:11 +00:00
SystemZRegisterInfo.cpp [SystemZ] Do not use glue to represent condition code dependencies 2018-04-30 17:52:32 +00:00
SystemZRegisterInfo.h Remove \brief commands from doxygen comments. 2018-05-01 15:54:18 +00:00
SystemZRegisterInfo.td [SystemZ] Do not use glue to represent condition code dependencies 2018-04-30 17:52:32 +00:00
SystemZSchedule.td [SystemZ] Add support for IBM z14 processor (1/3) 2017-07-17 17:41:11 +00:00
SystemZScheduleZ13.td [SystemZ] Remove scheduling info from some Pseudo instructions (NFC). 2018-04-27 14:09:03 +00:00
SystemZScheduleZ14.td [SystemZ] Remove scheduling info from some Pseudo instructions (NFC). 2018-04-27 14:09:03 +00:00
SystemZScheduleZ196.td [SystemZ] Remove scheduling info from some Pseudo instructions (NFC). 2018-04-27 14:09:03 +00:00
SystemZScheduleZEC12.td [SystemZ] Remove scheduling info from some Pseudo instructions (NFC). 2018-04-27 14:09:03 +00:00
SystemZSelectionDAGInfo.cpp [SystemZ] Do not use glue to represent condition code dependencies 2018-04-30 17:52:32 +00:00
SystemZSelectionDAGInfo.h
SystemZShortenInst.cpp MachineFunction: Return reference from getFunction(); NFC 2017-12-15 22:22:58 +00:00
SystemZSubtarget.cpp [SystemZ] Add support for IBM z14 processor (1/3) 2017-07-17 17:41:11 +00:00
SystemZSubtarget.h Fix a bunch more layering of CodeGen headers that are in Target 2017-11-17 01:07:10 +00:00
SystemZTDC.cpp
SystemZTargetMachine.cpp Move TargetLoweringObjectFile from CodeGen to Target to fix layering 2018-03-23 23:58:19 +00:00
SystemZTargetMachine.h (Re-landing) Expose a TargetMachine::getTargetTransformInfo function 2017-12-22 18:21:59 +00:00
SystemZTargetTransformInfo.cpp Fix a bunch more layering of CodeGen headers that are in Target 2017-11-17 01:07:10 +00:00
SystemZTargetTransformInfo.h [SystemZ] implement hasDivRemOp() 2017-11-06 13:10:31 +00:00

README.txt

//===---------------------------------------------------------------------===//
// Random notes about and ideas for the SystemZ backend.
//===---------------------------------------------------------------------===//

The initial backend is deliberately restricted to z10.  We should add support
for later architectures at some point.

--

If an inline asm ties an i32 "r" result to an i64 input, the input
will be treated as an i32, leaving the upper bits uninitialised.
For example:

define void @f4(i32 *%dst) {
  %val = call i32 asm "blah $0", "=r,0" (i64 103)
  store i32 %val, i32 *%dst
  ret void
}

from CodeGen/SystemZ/asm-09.ll will use LHI rather than LGHI.
to load 103.  This seems to be a general target-independent problem.

--

The tuning of the choice between LOAD ADDRESS (LA) and addition in
SystemZISelDAGToDAG.cpp is suspect.  It should be tweaked based on
performance measurements.

--

There is no scheduling support.

--

We don't use the BRANCH ON INDEX instructions.

--

We only use MVC, XC and CLC for constant-length block operations.
We could extend them to variable-length operations too,
using EXECUTE RELATIVE LONG.

MVCIN, MVCLE and CLCLE may be worthwhile too.

--

We don't use CUSE or the TRANSLATE family of instructions for string
operations.  The TRANSLATE ones are probably more difficult to exploit.

--

We don't take full advantage of builtins like fabsl because the calling
conventions require f128s to be returned by invisible reference.

--

ADD LOGICAL WITH SIGNED IMMEDIATE could be useful when we need to
produce a carry.  SUBTRACT LOGICAL IMMEDIATE could be useful when we
need to produce a borrow.  (Note that there are no memory forms of
ADD LOGICAL WITH CARRY and SUBTRACT LOGICAL WITH BORROW, so the high
part of 128-bit memory operations would probably need to be done
via a register.)

--

We don't use ICM, STCM, or CLM.

--

We don't use ADD (LOGICAL) HIGH, SUBTRACT (LOGICAL) HIGH,
or COMPARE (LOGICAL) HIGH yet.

--

DAGCombiner doesn't yet fold truncations of extended loads.  Functions like:

    unsigned long f (unsigned long x, unsigned short *y)
    {
      return (x << 32) | *y;
    }

therefore end up as:

        sllg    %r2, %r2, 32
        llgh    %r0, 0(%r3)
        lr      %r2, %r0
        br      %r14

but truncating the load would give:

        sllg    %r2, %r2, 32
        lh      %r2, 0(%r3)
        br      %r14

--

Functions like:

define i64 @f1(i64 %a) {
  %and = and i64 %a, 1
  ret i64 %and
}

ought to be implemented as:

        lhi     %r0, 1
        ngr     %r2, %r0
        br      %r14

but two-address optimizations reverse the order of the AND and force:

        lhi     %r0, 1
        ngr     %r0, %r2
        lgr     %r2, %r0
        br      %r14

CodeGen/SystemZ/and-04.ll has several examples of this.

--

Out-of-range displacements are usually handled by loading the full
address into a register.  In many cases it would be better to create
an anchor point instead.  E.g. for:

define void @f4a(i128 *%aptr, i64 %base) {
  %addr = add i64 %base, 524288
  %bptr = inttoptr i64 %addr to i128 *
  %a = load volatile i128 *%aptr
  %b = load i128 *%bptr
  %add = add i128 %a, %b
  store i128 %add, i128 *%aptr
  ret void
}

(from CodeGen/SystemZ/int-add-08.ll) we load %base+524288 and %base+524296
into separate registers, rather than using %base+524288 as a base for both.

--

Dynamic stack allocations round the size to 8 bytes and then allocate
that rounded amount.  It would be simpler to subtract the unrounded
size from the copy of the stack pointer and then align the result.
See CodeGen/SystemZ/alloca-01.ll for an example.

--

If needed, we can support 16-byte atomics using LPQ, STPQ and CSDG.

--

We might want to model all access registers and use them to spill
32-bit values.

--

We might want to use the 'overflow' condition of eg. AR to support
llvm.sadd.with.overflow.i32 and related instructions - the generated code
for signed overflow check is currently quite bad.  This would improve
the results of using -ftrapv.