On 17 August 2016 at 19:31, Clifford Wolf <
clif...@clifford.at> wrote:
> Hi,
>
> the RISC-V spec increasingly contains "auxiliary" information that is not
> directly relevant for building a hardware implementation, but is important
> for people who want to make software for RISC-V (and integrate those
> software components).
>
> I'm of course thinking of e.g. the chapter on the calling convention and
> the list of assembler pseudo-instructions.
>
> Are there any plans for also including information about the RISC-V ELF
> format in the spec, or is there already a separate document for this, like
> with the calling convention before the 2.1 ISA spec release?
>
> (I was wondering about the semantics of the different R_RISCV_PCREL_* ELF
> relocation types, but it wasn't so important to me that I would have been
> willing to dig into the binutils code and see what the linker does with
> those relocations. :)
A separate document for this doesn't exist for this currently, but
there's certainly demand for it. It's one of those things that just
needs contributions. Arun (CCed) has mentioned this need at least at
the last two RISC-V workshops. I haven't got round to the mnemonics
yet in my RISC-V LLVM work, but such a document would certainly be
helpful to me and to others who are reviewing patches. I hope I'll be
able to contribute to drafting such a document as a side effect of the
LLVM work, though a full assembly programmer's manual / psABI is a
project that's going to need a group of contributors.
If anyone has already started something towards this goal, please do share.
Best,
Alex