Index (Linker and Libraries Guide)

Linker and Libraries Guide

Previous: Appendix D New Linker and Libraries Features and Updates


Numbers and Symbols

	32–bit/64–bit ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )
		introduction ( )

	`$ADDVERS`
		See versioning

	`$ISALIST`
		See search paths

	`$ORIGIN`
		See search paths

	`$OSNAME`
		See search paths

	`$OSREL`
		See search paths

	`$PLATFORM`
		See search paths


A

	ABI
		See Application Binary Interface

	Application Binary Interface ( ) ( ) ( )

	`ar(1)` ( )

	archives ( )
		inclusion of shared objects in ( )
		link-editor processing ( )
		multiple passes through ( )
		naming conventions ( )

	`as(1)` ( )

	`atexit(3C)` ( )

	auxiliary filters ( ) ( )


B

	base address ( ) ( )

	binding ( )
		dependency ordering ( )
		direct ( ) ( ) ( ) ( ) ( )
		lazy ( ) ( ) ( )
		to shared object dependencies ( ) ( )
		to version definitions ( )
		to weak version definitions ( )


C

	`CC(1)` ( )

	`cc(1)` ( ) ( ) ( )

	`COMDAT` ( ) ( )

	`COMMON` ( ) ( ) ( ) ( )

	compilation environment
		See also link-editing and link-editor

	compiler driver ( )

	compiler options
		`-K PIC` ( )
		`-K pic` ( ) ( )
		`-xF` ( ) ( ) ( )
		`-xpg` ( )
		`-xregs=no%appl` ( )

	`crle(1)` ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )

	`crle(1)` options
		`-E` ( )
		`-e` ( ) ( )
		`-l` ( )
		`-s` ( )
		`-u` ( )


D

	data representation ( )

	debugging aids
		link-editing ( )
		runtime linking ( )

	demonstrations
		`prefcnt` ( )
		`sotruss` ( )
		`symbindrep` ( )
		`whocalls` ( )

	dependency
		groups ( ) ( )

	dependency ordering ( )

	direct binding ( ) ( ) ( ) ( ) ( )

	`dladdr1(3DL)` ( )

	`dladdr(3DL)` ( )

	`dlclose(3DL)` ( ) ( )

	`dldump(3DL)` ( )

	`dlerror(3DL)` ( )

	`dlfcn.h` ( )

	`dlinfo(3DL)` ( ) ( )

	`dlmopen(3DL)`
		See also dlopen(3DL)

	`dlopen(3DL)` ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )
		effects of ordering ( )
		group ( )

	`dlopen(3DL)`
		group ( )

	`dlopen(3DL)`
		modes
			`RTLD_GLOBAL` ( ) ( )
			`RTLD_GROUP` ( )
			`RTLD_LAZY` ( )
			`RTLD_NOLOAD` ( )
			`RTLD_NOW` ( ) ( )
			`RTLD_PARENT` ( ) ( ) ( ) ( )
		of a dynamic executable ( )

	`dlopen(3DL)`
		of a dynamic executable ( )

	`dlopen(3DL)`
		shared object naming conventions ( )

	`dlsym(3DL)` ( ) ( ) ( ) ( ) ( ) ( )
		special handle
			`RTLD_DEFAULT` ( ) ( )
			`RTLD_NEXT` ( )
			`RTLD_SELF` ( )

	`dump(1)` ( ) ( ) ( ) ( ) ( )

	dynamic executables ( ) ( )

	dynamic information tags
		`NEEDED` ( ) ( )
		`RUNPATH` ( )
		`SONAME` ( )
		`SYMBOLIC` ( )
		`TEXTREL` ( )

	dynamic linking ( )
		implementation ( ) ( )


E

	ELF
		See also object files

	`elf(3E)` ( ) ( )

	environment variables ( )
		`LD_AUDIT` ( ) ( )
		`LD_BIND_NOT` ( )
		`LD_BIND_NOW` ( ) ( ) ( ) ( ) ( )
		`LD_BREADTH` ( )
		`LD_DEBUG` ( )
		`LD_DEBUG_OUTPUT` ( )
		`LD_LIBRARY_PATH` ( ) ( ) ( ) ( ) ( ) ( )
		`LD_LOADFLTR` ( )
		`LD_NOAUDIT` ( )
		`LD_NOAUXFLTR` ( )
		`LD_NODIRECT` ( )
		`LD_NOLAZYLOAD` ( )
		`LD_OPTIONS` ( ) ( )
		`LD_PRELOAD` ( ) ( ) ( )
		`LD_PROFILE` ( )
		`LD_PROFILE_OUTPUT` ( )
		`LD_RUN_PATH` ( )
		`LD_SIGNAL` ( )
		`SGS_SUPPORT` ( )

	error messages
		link-editor
			illegal argument to option ( )
			illegal option ( )
			incompatible options ( )
			multiple instances of an option ( )
			multiply-defined symbols ( )
			relocations against non-writable sections ( )
			shared object name conflicts ( )
			soname conflicts ( )
			symbol not assigned to version ( )
			symbol warnings ( ) ( )
			undefined symbols ( ) ( )
			undefined symbols from an implicit reference ( )
			version unavailable ( )
		runtime linker
			copy relocation size differences ( ) ( )
			relocation errors ( ) ( )
			unable to find shared object ( ) ( )
			unable to find version definition ( )
			unable to locate symbol ( )

	`exec(2)` ( ) ( ) ( )

	executable and linking format
		See ELF


F

	filters ( )
		auxiliary ( ) ( )
			platform specific ( )
			system specific ( )
		standard ( ) ( )


G

	generating a shared object ( )

	generating an executable ( )

	generating the output file image ( )

	global offset table ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )
		`IA` ( ) ( ) ( ) ( ) ( )
		`SPARC` ( ) ( ) ( ) ( )

	global symbols ( ) ( ) ( ) ( )

	`.got`
		See global offset table


I

	initialization and termination ( ) ( ) ( )

	input file processing ( )

	interface
		private ( )
		public ( ) ( )

	interposition ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )

	interpreter
		See runtime linker


L

	lazy binding ( ) ( ) ( ) ( )

	`ld(1)` ( )

	`LD_AUDIT` ( ) ( )

	`LD_BIND_NOT` ( )

	`LD_BIND_NOW` ( ) ( ) ( ) ( ) ( )

	`LD_BREADTH` ( )

	`LD_DEBUG` ( )

	`LD_DEBUG_OUTPUT` ( )

	`LD_LIBRARY_PATH` ( ) ( ) ( ) ( ) ( )

	`LD_LOADFLTR` ( )

	`LD_NOAUDIT` ( )

	`LD_NOAUXFLTR` ( )

	`LD_NODIRECT` ( )

	`LD_NOLAZYLOAD` ( )

	`LD_OPTIONS` ( ) ( )

	`LD_PRELOAD` ( ) ( ) ( )

	`LD_PROFILE` ( )

	`LD_PROFILE_OUTPUT` ( )

	`LD_RUN_PATH` ( )

	`LD_SIGNAL` ( )

	`ld.so.1(1)`
		See runtime linker

	`ldd(1)` ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )

	`ldd(1)` options
		`-d` ( ) ( ) ( )
		`-i` ( )
		`-r` ( ) ( ) ( )
		`-u` ( )
		`-v` ( )

	`libdl.so.1` ( )

	`libelf.so.1` ( ) ( )

	`libldstab.so.1` ( )

	libraries
		archives ( )
		naming conventions ( )
		shared ( ) ( )

	link-editing ( ) ( ) ( )
		adding additional libraries ( )
		archive processing ( )
		binding to a version definition ( ) ( )
		dynamic ( ) ( )
		input file processing ( )
		library input processing ( )
		library linking options ( )
		mixing shared objects and archives ( )
		position of files on command line ( )
		search paths ( ) ( )
		shared object processing ( )

	link-editor ( ) ( )
		debugging aids ( )
		direct binding ( )
		error messages
			See error messages
		invoking directly ( )
		invoking using compiler driver ( )
		overview ( )
		sections ( )
		segments ( )
		specifying options ( )

	link-editor options
		`-64` ( ) ( )
		`-a` ( )
		`-B direct` ( ) ( ) ( ) ( )
		`-B dynamic` ( )
		`-B eliminate` ( )
		`-B group` ( ) ( ) ( )
		`-B local` ( )
		`-B reduce` ( ) ( )
		`-B static` ( ) ( )
		`-D` ( )
		`-d n` ( ) ( )
		`-d y` ( )
		`-e` ( )
		`-F` ( )
		`-f` ( )
		`-G` ( ) ( ) ( )
		`-h` ( ) ( ) ( ) ( )
		`-i` ( )
		`-L` ( ) ( )
		`-l` ( ) ( ) ( ) ( ) ( )
		`-M` ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )
		`-m` ( ) ( )
		`-P` ( )
		`-p` ( )
		`-R` ( ) ( ) ( ) ( )
		`-r` ( ) ( )
		`-S` ( )
		`-s` ( ) ( )
		`-t` ( ) ( )
		`-u` ( ) ( )
		`-Y` ( )
		`-z allextract` ( )
		`-z combreloc` ( )
		`-z defaultextract` ( )
		`-z defs` ( ) ( ) ( ) ( )
		`-z endfiltee` ( )
		`-z finiarray` ( )
		`-z groupperm` ( )
		`-z ignore` ( ) ( ) ( ) ( )
		`-z initarray` ( )
		`-z initfirst` ( )
		`-z interpose` ( ) ( )
		`-z lazyload` ( ) ( ) ( ) ( )
		`-z ld32` ( )
		`-z ld64` ( )
		`-z loadfltr` ( ) ( )
		`-z muldefs` ( )
		`-z nocompstrtab` ( )
		`-z nodefaultlib` ( ) ( )
		`-z nodefs` ( ) ( )
		`-z nodelete` ( )
		`-z nodlopen` ( )
		`-z nodump` ( )
		`-z nolazyload` ( )
		`-z nopartial` ( )
		`-z noversion` ( ) ( ) ( )
		`-z now` ( ) ( )
		`-z rescan` ( )
		`-z text` ( ) ( )
		`-z verbose` ( )
		`-z weakextract` ( ) ( )

	link-editor output
		dynamic executables ( )
		relocatable objects ( )
		shared objects ( )
		static executables ( )

	link-editor support interface (ld-support) ( )
		`ld_atexit()` ( )
		`ld_atexit64()` ( )
		`ld_file()` ( )
		`ld_file64()` ( )
		`ld_input_done()` ( )
		`ld_input_section()` ( )
		`ld_input_section64()` ( )
		`ld_section()` ( )
		`ld_section64()` ( )
		`ld_start()` ( )
		`ld_start64()` ( )
		`ld_version()` ( )

	local symbols ( ) ( ) ( )

	`lorder(1)` ( ) ( )


M

	mapfiles ( )
		defaults ( )
		example ( )
		map structure ( )
		mapping directives ( )
		segment declarations ( )
		size-symbol declarations ( )
		structure ( )
		syntax ( )

	`mdb(1)` ( )

	`mmap(2)` ( ) ( ) ( ) ( )

	multiply-defined data ( ) ( )

	multiply-defined symbols ( ) ( ) ( )


N

	Namespace ( )

	naming conventions
		archives ( )
		libraries ( )
		shared objects ( ) ( )

	`NEEDED` ( ) ( )

	`nm(1)` ( ) ( )


O

	object files ( )
		base address ( ) ( )
		data representation ( )
		global offset table
			See global offset table
		note section ( ) ( )
		preloading at runtime ( )
		procedure linkage table
			See procedure linkage table
		program header ( ) ( ) ( )
		program interpretor ( )
		program loading ( )
		relocation ( ) ( )
		section alignment ( )
		section attributes ( ) ( )
		section group flags ( )
		section header ( ) ( )
		section names ( ) ( )
		section types ( ) ( )
		segment contents ( ) ( )
		segment permissions ( ) ( )
		segment types ( ) ( )
		string table ( ) ( )
		symbol table ( ) ( )


P

	packages
		`SUNWosdem` ( ) ( ) ( )
		`SUNWtool` ( )

	paging ( ) ( )

	performance
		allocating buffers dynamically ( )
		collapsing multiple definitions ( )
		improving locality of references ( ) ( )
		maximizing shareability ( )
		minimizing data segment ( )
		position-independent code
			See position-dependent code
		relocations ( ) ( )
		the underlying system ( )
		using automatic variables ( )

	PIC
		See position-independent code

	platform specific auxiliary filters ( )

	`.plt`
		See procedure linkage table

	position-independent code ( ) ( ) ( )

	preloading objects
		See `LD_PRELOAD`

	procedure linkage table ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( ) ( )
		64–bit `SPARC` ( )
		`IA` ( ) ( ) ( )
		`SPARC` ( ) ( ) ( ) ( )

	`profil(2)` ( )

	program interpreter
		See also runtime linker

	`pvs(1)` ( ) ( ) ( ) ( ) ( )


R

	relocatable objects ( )

	relocation ( ) ( ) ( ) ( )
		copy ( ) ( )
		displacement ( )
		immediate ( )
		lazy ( )
		non-symbolic ( ) ( )
		runtime linker
			symbol lookup ( ) ( ) ( ) ( )
		symbolic ( ) ( )

	`RTLD_DEFAULT`
		See also dependency ordering

	`RTLD_GLOBAL` ( ) ( )

	`RTLD_GROUP` ( )

	`RTLD_LAZY` ( )

	`RTLD_NEXT`
		See also dependency ordering

	`RTLD_NOLOAD` ( )

	`RTLD_NOW` ( ) ( )

	`RTLD_PARENT` ( ) ( ) ( ) ( )

	`RUNPATH`
		See runpath

	runpath ( ) ( ) ( ) ( ) ( ) ( )

	runtime environment ( ) ( ) ( )

	runtime linker ( ) ( ) ( )
		direct binding ( ) ( ) ( ) ( )
		initialization and termination routines ( )
		lazy binding ( ) ( ) ( )
		link-maps ( )
		loading additional objects ( )
		namespace ( )
		programming interface
			See also dlclose(3DL), dldump(3DL), dlerror(3DL), dlmopen(3DL), and dlopen(3DL)
		relocation processing ( )
		search paths ( ) ( )
		security ( )
		shared object processing ( )
		version definition verification ( )

	runtime linker support interfaces (rtld-audit) ( ) ( )
		`la_activity()` ( )
		`la_i86_pltenter()` ( )
		`la_objclose()` ( )
		`la_objopen()` ( )
		`la_objseach()` ( )
		`la_pltexit()` ( )
		`la_preinit()` ( )
		`la_sparcv8_pltenter()` ( )
		`la_sparcv9_pltenter()` ( )
		`la_symbind32()` ( )
		`la_symbind64()` ( )
		`la_version()` ( )

	runtime linker support interfaces (rtld-debugger) ( ) ( )
		`ps_global_sym()` ( )
		`ps_pglobal_sym()` ( ) ( )
		`ps_plog()` ( )
		`ps_pread()` ( )
		`ps_pwrite()` ( )
		`rd_delete()` ( )
		`rd_errstr()` ( )
		`rd_event_addr()` ( )
		`rd_event_enable()` ( )
		`rd_event_getmsg()` ( )
		`rd_init()` ( )
		`rd_loadobj_iter()` ( )
		`rd_log()` ( )
		`rd_new()` ( )
		`rd_objpad_enable()` ( )
		`rd_plt_resolution()` ( )
		`rd_reset()` ( )

	runtime linking ( )


S

	SCD
		See Application Binary Interface

	search paths
		link-editing ( )
		runtime linker ( ) ( )
			`$ISALIST` token ( )
			`$ORIGIN` token ( )
			`$OSNAME` token ( )
			`$OSREL` token ( )
			`$PLATFORM` token ( )

	section flags ( )
		`SHF_ALLOC` ( ) ( ) ( )
		`SHF_EXCLUDE` ( ) ( )
		`SHF_EXECINSTR` ( )
		`SHF_GROUP` ( ) ( )
		`SHF_INFO_LINK` ( )
		`SHF_LINK_ORDER` ( ) ( )
		`SHF_MASKOS` ( )
		`SHF_MASKPROC` ( )
		`SHF_MERGE` ( )
		`SHF_ORDERED` ( )
		`SHF_OS_NONCONFORMING` ( )
		`SHF_STRINGS` ( )
		`SHF_WRITE` ( )
		`SHT_TLS` ( )

	section names
		`.bss` ( ) ( )
		`.data` ( ) ( )
		`.dynamic` ( ) ( ) ( )
		`.dynstr` ( )
		`.dynsym` ( )
		`.fini` ( ) ( )
		`.fini_array` ( ) ( )
		`.got` ( ) ( )
		`.init` ( ) ( )
		`.init_array` ( ) ( )
		`.interp` ( )
		`.picdata` ( )
		`.plt` ( ) ( ) ( )
		`.preinit_array` ( ) ( )
		`.rela.text` ( )
		`.rodata` ( )
		`.strtab` ( ) ( )
		`.SUNW_reloc` ( ) ( )
		`.SUNW_version` ( )
		`.symtab` ( ) ( ) ( )
		`.text` ( )

	section numbers ( ) ( )
		`SHN_ABS` ( ) ( ) ( ) ( )
		`SHN_AFTER` ( ) ( ) ( )
		`SHN_BEFORE` ( ) ( ) ( )
		`SHN_COMMON` ( ) ( ) ( ) ( )
		`SHN_HIPROC` ( )
		`SHN_HIRESERVE` ( )
		`SHN_LOPROC` ( )
		`SHN_LORESERVE` ( )
		`SHN_UNDEF` ( ) ( ) ( ) ( ) ( )

	section types ( )
		`SHT_DYNAMIC` ( ) ( )
		`SHT_DYNSTR` ( )
		`SHT_DYNSYM` ( )
		`SHT_GROUP` ( ) ( ) ( )
		`SHT_HASH` ( ) ( )
		`SHT_HIPROC` ( )
		`SHT_HIUSER` ( ) ( )
		`SHT_LOPROC` ( )
		`SHT_LOUSER` ( ) ( )
		`SHT_NOBITS` ( ) ( ) ( ) ( ) ( ) ( ) ( )
		`SHT_NOTE` ( ) ( )
		`SHT_NULL` ( )
		`SHT_PROGBITS` ( ) ( )
		`SHT_REL` ( )
		`SHT_RELA` ( )
		`SHT_SHLIB` ( )
		`SHT_STRTAB` ( )
		`SHT_SUNW_COMDAT` ( ) ( )
		`SHT_SUNW_move` ( ) ( )
		`SHT_SUNW_syminfo` ( )
		`SHT_SUNW_verdef` ( ) ( ) ( )
		`SHT_SUNW_verneed` ( ) ( ) ( )
		`SHT_SUNW_versym` ( ) ( ) ( ) ( )
		`SHT_SYMTAB` ( ) ( )

	sections
		See also section flags, section names, section numbers and section types

	security ( )

	segments ( ) ( )
		data ( ) ( )
		text ( ) ( )

	`SGS_SUPPORT` ( )

	shared libraries
		See shared objects

	shared objects ( ) ( ) ( ) ( ) ( )
		as filters ( )
		dependency ordering ( )
		explicit definition ( )
		implementation ( ) ( )
		implicit definition ( )
		link-editor processing ( )
		naming conventions ( ) ( )
		recording a runtime name ( )
		with dependencies ( )

	`size(1)` ( )

	Solaris ABI
		See Application Binary Interface

	Solaris Application Binary Interface
		See Application Binary Interface

	`SONAME` ( )

	SPARC Compliance Definition
		See Application Binary Interface

	standard filters ( ) ( )

	static executables ( )

	`strings(1)` ( )

	`strip(1)` ( ) ( )

	`SUNWosdem` ( ) ( ) ( )

	`SUNWtoo` ( )

	support interfaces
		link-editor (ld-support) ( )
		runtime linker (rtld-audit) ( ) ( )
		runtime linker (rtld-debugger) ( ) ( )

	symbol reserved names ( )
		`_DYNAMIC` ( )
		`_edata` ( )
		`_end` ( )
		`_END_` ( )
		`_etext` ( )
		`_fini` ( )
		`_GLOBAL_OFFSET_TABLE_` ( ) ( ) ( )
		`_init` ( )
		`main` ( )
		`_PROCEDURE_LINKAGE_TABLE_` ( )
		`_start` ( )
		`_START_` ( )

	symbol resolution ( ) ( ) ( ) ( )
		complex ( )
		fatal ( )
		interposition ( )
		multiple definitions ( )
		search scope
			`group` ( )
		simple ( )
		symbol visibility ( ) ( )
			`global` ( )
			`local` ( )

	SYMBOLIC ( )

	symbols
		absolute ( ) ( )
		archive extraction ( )
		auto-elimination ( )
		auto-reduction ( ) ( ) ( )
		`COMMON` ( ) ( ) ( ) ( )
		defined ( )
		definition ( ) ( )
		elimination ( )
		existence test ( )
		global ( ) ( ) ( ) ( ) ( ) ( )
		local ( ) ( ) ( ) ( )
		multiply-defined ( ) ( ) ( )
		ordered ( )
		private interface ( )
		public interface ( )
		reference ( ) ( )
		registers ( )
		runtime lookup ( ) ( )
			deferred ( ) ( ) ( )
		scope ( ) ( )
		symbol visibility ( )
		tentative ( ) ( ) ( ) ( ) ( ) ( )
			ordering in the output file ( )
			realignment ( )
		type ( )
		undefined ( ) ( ) ( ) ( ) ( ) ( ) ( )
		visibility ( ) ( )
		weak ( ) ( ) ( ) ( ) ( ) ( ) ( )

	system specific auxiliary filters ( )

	System V Application Binary Interface
		See Application Binary Interface


T

	tentative symbols ( ) ( ) ( ) ( )

	`TEXTREL` ( )

	Thread Local Storage ( )

	`tsort(1)` ( ) ( )


U

	undefined symbols ( )

	`/usr/ccs/bin/ld`
		See link-editor

	`/usr/ccs/lib` ( )

	`/usr/lib` ( ) ( ) ( ) ( ) ( )

	`/usr/lib/64` ( ) ( ) ( ) ( ) ( )

	`/usr/lib/64/ld.so.1` ( ) ( )

	`/usr/lib/ld.so.1` ( ) ( )

	`/usr/lib/secure` ( ) ( )

	`/usr/lib/secure/64` ( ) ( )


V

	versioning ( )
		base version definition ( )
		binding to a definition ( ) ( )
			`$ADDVERS` ( )
		defining a public interface ( ) ( )
		definitions ( ) ( ) ( ) ( )
		file control directive ( )
		file name ( ) ( )
		generating definitions within an image ( ) ( ) ( )
		normalization ( )
		overview ( )
		runtime verification ( ) ( )

	virtual addressing ( )


W

	weak symbols ( ) ( ) ( ) ( )
		undefined ( ) ( )

Previous: Appendix D New Linker and Libraries Features and Updates