glibc/manual
H.J. Lu 905947c304 tunables: Add IFUNC selection and cache sizes
The current IFUNC selection is based on microbenchmarks in glibc.  It
should give the best performance for most workloads.  But other choices
may have better performance for a particular workload or on the hardware
which wasn't available at the selection was made.  The environment
variable, GLIBC_TUNABLES=glibc.tune.ifunc=-xxx,yyy,-zzz...., can be used
to enable CPU/ARCH feature yyy, disable CPU/ARCH feature yyy and zzz,
where the feature name is case-sensitive and has to match the ones in
cpu-features.h.  It can be used by glibc developers to override the
IFUNC selection to tune for a new processor or improve performance for
a particular workload.  It isn't intended for normal end users.

NOTE: the IFUNC selection may change over time.  Please check all
multiarch implementations when experimenting.

Also, GLIBC_TUNABLES=glibc.tune.x86_non_temporal_threshold=NUMBER is
provided to set threshold to use non temporal store to NUMBER,
GLIBC_TUNABLES=glibc.tune.x86_data_cache_size=NUMBER to set data cache
size, GLIBC_TUNABLES=glibc.tune.x86_shared_cache_size=NUMBER to set
shared cache size.

	* elf/dl-tunables.list (tune): Add ifunc,
	x86_non_temporal_threshold,
	x86_data_cache_size and x86_shared_cache_size.
	* manual/tunables.texi: Document glibc.tune.ifunc,
	glibc.tune.x86_data_cache_size, glibc.tune.x86_shared_cache_size
	and glibc.tune.x86_non_temporal_threshold.
	* sysdeps/unix/sysv/linux/x86/dl-sysdep.c: New file.
	* sysdeps/x86/cpu-tunables.c: Likewise.
	* sysdeps/x86/cacheinfo.c
	(init_cacheinfo): Check and get data cache size, shared cache
	size and non temporal threshold from cpu_features.
	* sysdeps/x86/cpu-features.c [HAVE_TUNABLES] (TUNABLE_NAMESPACE):
	New.
	[HAVE_TUNABLES] Include <unistd.h>.
	[HAVE_TUNABLES] Include <elf/dl-tunables.h>.
	[HAVE_TUNABLES] (TUNABLE_CALLBACK (set_ifunc)): Likewise.
	[HAVE_TUNABLES] (init_cpu_features): Use TUNABLE_GET to set
	IFUNC selection, data cache size, shared cache size and non
	temporal threshold.
	* sysdeps/x86/cpu-features.h (cpu_features): Add data_cache_size,
	shared_cache_size and non_temporal_threshold.
2017-06-20 08:37:28 -07:00
..
examples Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
argp.texi manual: Complete @standards in argp.texi. 2017-06-16 01:19:30 -07:00
arith.texi manual: Complete @standards in arith.texi. 2017-06-16 01:20:50 -07:00
charset.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
check-safety.sh Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
conf.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
contrib.texi Fix a typo in the manual. 2017-02-08 01:34:12 -08:00
creature.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
crypt.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
ctype.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
debug.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
dir .. 2005-11-21 15:45:19 +00:00
errno.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
fdl-1.3.texi BZ#13738: Switch manual to FDL 1.3. 2012-02-24 12:58:10 -08:00
filesys.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
freemanuals.texi Update to canonical freemanuals.texi file. 2013-09-24 14:06:56 -07:00
getopt.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
header.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
install-plain.texi BZ #15941: Fix INSTALL file regeneration failure with makeinfo 5.x 2013-12-05 09:58:20 +05:30
install.texi Require GCC 4.9 or later for building glibc. 2017-06-19 16:34:05 +00:00
intro.texi manual: fix typo in the introduction 2016-05-19 23:22:59 -04:00
io.texi Clean up glibc manual references to "GNU system" (bug 6911). 2012-03-08 01:27:38 +00:00
ipc.texi manual/ipc.texi: Fix AC-safety notes. 2014-04-08 17:12:15 -04:00
job.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
lang.texi manual: Complete @standards in lang.texi. 2017-06-20 04:29:33 -07:00
lgpl-2.1.texi Use canonical FSF .texi files for LGPL and FDL texts. 2011-06-06 16:16:55 -07:00
libc-texinfo.sh Make shebang interpreter directives consistent 2016-01-07 04:03:21 -05:00
libc.texinfo Update copyright dates not handled by scripts/update-copyrights. 2017-01-01 00:26:24 +00:00
libcbook.texi initial import 1995-02-18 01:27:10 +00:00
libdl.texi * manual/libdl.texi: New. 2014-01-31 23:23:59 -02:00
libm-err-tab.pl Do not hardcode list of libm functions in libm-err-tab.pl. 2017-02-06 17:55:59 +00:00
llio.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
locale.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
macros.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
maint.texi Manual typos: Library Maintenance 2016-10-06 12:29:11 +05:30
Makefile manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
math.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
memory.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
message.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
nss.texi manual: Convert @tables of variables to @vtables. 2016-12-21 01:36:58 -08:00
nsswitch.texi update from main archive 960814 1996-08-15 01:23:29 +00:00
pattern.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
pipe.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
platform.texi PowerPC: Extend Program Priority Register support 2015-08-19 17:43:26 -03:00
probes.texi User manual documentation for tunables 2016-12-31 23:49:24 +05:30
process.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
resource.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
search.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
setjmp.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
signal.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
socket.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
startup.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
stdio-fp.c update from main archive 970225 1997-02-25 05:18:05 +00:00
stdio.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
string.texi manual: Complete @standards in string.texi. 2017-06-16 01:23:17 -07:00
summary.pl manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
sysinfo.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
syslog.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
terminal.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
texinfo.tex Update miscellaneous files from upstream sources. 2016-12-21 16:05:55 +00:00
texis.awk Correct close statement. 2001-05-18 13:01:32 +00:00
threads.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
time.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
tsort.awk Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
tunables.texi tunables: Add IFUNC selection and cache sizes 2017-06-20 08:37:28 -07:00
users.texi manual: Replace summary.awk with summary.pl. 2017-06-15 21:26:20 -07:00
xtract-typefun.awk Make shebang interpreter directives consistent 2016-01-07 04:03:21 -05:00