Display the source code in dmd/backend/elfobj.d from which this page was generated on github.

If you spot a problem with this page, click here to create a Bugzilla issue.

Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Module `dmd.backend.elfobj`

Output to ELF object files

http

//www.sco.com/developers/gabi/2003-12-17/ch4.sheader.html

Compiler implementation of the D programming language.

Functions

Name	Description
`addSegmentToComdat(seg, comdatseg)`
`ELF_COMDAT()`	This should work on modern versions of GNU ld and all versions of LLVM lld. FreeBSD defaults to lld as of FreeBSD 13 (2021); OpenBSD as of 6.5 (2019).
`elf_dwarf_reftoident(seg, offset, s, val)`	Generate fixup specific to .eh_frame and .gcc_except_table sections.
`elf_renumbersyms()`	Renumber symbols so they are ordered as locals, weak and then global
`ElfObj_addstr(strtab, str)`	Output a string into a string table
`ElfObj_alias(n1, n2)`	Output an alias definition record.
`ElfObj_allowZeroSize()`	Do we allow zero sized objects?
`ElfObj_byte(seg, offset, byte_)`	Output byte to object file.
`ElfObj_bytes(seg, offset, nbytes, p)`	Output bytes to object file.
`ElfObj_codeseg(name, suffix)`	Define a new code segment.
`ElfObj_common_block(s, size, count)`	Output a common block definition.
`ElfObj_compiler(p)`	Embed compiler version in .obj file.
`ElfObj_data_readonly(p, len, pseg)`	Ouput read only data for data.
`ElfObj_data_start(sdata, datasize, seg)`	Update data information about symbol align for output and assign segment if not already specified.
`ElfObj_dehinfo(scc)`	Stuff pointer to DEH into its own section (deh).
`ElfObj_ehsections()`	Don't need to generate section brackets, use _start_SEC/_stop_SEC instead.
`ElfObj_ehtables(sfunc, size, ehsym)`	Stuff the following data in a separate segment: pointer to function pointer to ehsym length of function
`ElfObj_exestr(p)`	Embed string in executable.
`ElfObj_export_symbol(s, argsize)`	Export a function name.
`ElfObj_external(s)`	Output an external for existing symbol.
`ElfObj_external_def(name)`	Output an external symbol for name.
`ElfObj_far16thunk(s)`	Generate far16 thunk.
`ElfObj_filename(modname)`	Output file name record.
`ElfObj_fltused()`	Mark object file as using floating point.
`ElfObj_func_start(sfunc)`	Update function info before codgen
`ElfObj_func_term(sfunc)`	Update function info after codgen
`ElfObj_getsegment(name, suffix, type, flags, align_)`	Get corresponding seg_data entry for an existing or newly added section.
`ElfObj_gotref(s)`
`ElfObj_includelib(name)`	Output library name.
`ElfObj_init(objbuf, filename, csegname)`	Perform initialization that applies to all .o output files. Called before any other obj_xxx routines Called by Obj.initialize()
`ElfObj_initfile(filename, csegname, modname)`	Initialize the start of object output for this particular .o file. Called by Obj.initfile()
`ElfObj_lidata(seg, offset, count)`	Output an iterated data block of 0s.
`ElfObj_linkerdirective(name)`	Output linker directive.
`ElfObj_linnum(srcpos, seg, offset)`	Line number support.
`ElfObj_moduleinfo(scc)`	Stuff pointer to ModuleInfo into its own section (minfo).
`ElfObj_pubdef(seg, s, offset)`	Output a public definition.
`ElfObj_pubdefsize(seg, s, offset, symsize)`	Output a public definition.
`ElfObj_reftocodeseg(seg, offset, val)`	Refer to address that is in the code segment. Only offsets are output, regardless of the memory model. Used to put values in switch address tables.
`ElfObj_reftodatseg(seg, offset, val, targetdatum, flags)`	Refer to address that is in the data segment.
`ElfObj_reftoident(seg, offset, s, val, flags)`	Refer to an identifier.
`ElfObj_setcodeseg(seg)`	Reset code seg to existing seg. Used after a COMDAT for a function is done.
`ElfObj_setModuleCtorDtor(sfunc, isCtor)`	Stuff pointer to function in its own segment. Used for static ctor and dtor lists.
`ElfObj_startaddress(s)`	Set start address
`ElfObj_staticctor(s, __param_1, __param_2)`	Symbol is the function that calls the static constructors. Put a pointer to it into a special segment that the startup code looks at.
`ElfObj_staticdtor(s)`	Symbol is the function that calls the static destructors. Put a pointer to it into a special segment that the exit code looks at.
`ElfObj_string_literal_segment(sz)`	Get segment for readonly string literals. The linker will pool strings in this section.
`ElfObj_sym_cdata(ty, p, len)`	Ouput read only data and generate a symbol for it.
`ElfObj_term(objfilename)`	Finish up creating the object module and putting it in fobjbuf[]. Does not write the file. Pairs with ElfObj_init()
`ElfObj_termfile()`	Fixup and terminate object file. Pairs with ElfObj_initfile()
`ElfObj_tlsseg()`	Define segments for Thread Local Storage. Here's what the elf tls spec says: Field .tbss .tdata sh_name .tbss .tdata sh_type SHT_NOBITS SHT_PROGBITS sh_flags SHF_ALLOC\|SHF_WRITE\| SHF_ALLOC\|SHF_WRITE\| SHF_TLS SHF_TLS sh_addr virtual addr of section virtual addr of section sh_offset 0 file offset of initialization image sh_size size of section size of section sh_link SHN_UNDEF SHN_UNDEF sh_info 0 0 sh_addralign alignment of section alignment of section sh_entsize 0 0 We want tlsstart and tlsend to bracket all the D tls data. The default linker script (ld -verbose) says: .tdata : { (.tdata .tdata. .gnu.linkonce.td.) } .tbss : { (.tbss .tbss.* .gnu.linkonce.tb.) (.tcommon) } so if we assign names: tlsstart .tdata symbols .tdata. symbols .tbss tlsend .tbss. this should work. Don't care about sections emitted by other languages, as we presume they won't be storing D gc roots in their tls.
`ElfObj_tlsseg_bss()`	Define segments for Thread Local Storage.
`ElfObj_user(p)`	Embed string in obj.
`ElfObj_wkext(s1, s2)`	Output a weak extern record.
`ElfObj_write_byte(pseg, byte_)`	Append byte to segment.
`ElfObj_write_bytes(pseg, a)`	Append bytes to segment.
`ElfObj_write_zeros(pseg, count)`	Append an iterated data block of 0s. (uninitialized data only)
`ElfObj_writerel(targseg, offset, reltype, symidx, val)`	Write/Append a relocatable value to the given segment and offset.
`elfobjfile_delete()`	Close and delete .OBJ file.
`elfobjfile_term()`	Terminate.
`USE_INIT_ARRAY()`	All supported platforms have supported .init_array for years.

Manifest constants

Name	Type	Description
`DMDV2`		If set the compiler requires full druntime support of the new section registration.

Global variables

Name	Type	Description
`relcnt`	`int`	Output a relocation entry for a segment

Aliases

Name	Type	Description
`reltype_t`	`uint`	Correspondence of relocation types 386 32 bit in 64 64 in 64 R_386_32 R_X86_64_32 R_X86_64_64 R_386_GOTOFF R_X86_64_PC32 R_X86_64_ R_386_GOTPC R_X86_64_ R_X86_64_ R_386_GOT32 R_X86_64_ R_X86_64_ R_386_TLS_GD R_X86_64_TLSGD R_X86_64_ R_386_TLS_IE R_X86_64_GOTTPOFF R_X86_64_ R_386_TLS_LE R_X86_64_TPOFF32 R_X86_64_ R_386_PLT32 R_X86_64_PLT32 R_X86_64_ R_386_PC32 R_X86_64_PC32 R_X86_64_

Authors

Walter Bright

License

Boost License 1.0