This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH] Rename the glibc.tune namespace to glibc.cpu
- From: Tulio Magno Quites Machado Filho <tuliom at ascii dot art dot br>
- To: Siddhesh Poyarekar <siddhesh at sourceware dot org>, libc-alpha at sourceware dot org
- Cc:
- Date: Mon, 16 Jul 2018 17:16:04 -0300
- Subject: Re: [PATCH] Rename the glibc.tune namespace to glibc.cpu
- References: <20180716141633.6948-1-siddhesh@sourceware.org>
Siddhesh Poyarekar <siddhesh@sourceware.org> writes:
> diff --git a/manual/tunables.texi b/manual/tunables.texi
> index be33c9fc79..9b8f9e4610 100644
> --- a/manual/tunables.texi
> +++ b/manual/tunables.texi
> @@ -295,23 +295,23 @@ The default value of this tunable is @samp{3}.
> @cindex non_temporal_threshold tunables
> @cindex tunables, non_temporal_threshold
>
> -@deftp {Tunable namespace} glibc.tune
> +@deftp {Tunable namespace} glibc.cpu
> Behavior of @theglibc{} can be tuned to assume specific hardware capabilities
> by setting the following tunables in the @code{tune} namespace:
> @end deftp
>
> -@deftp Tunable glibc.tune.hwcap_mask
> +@deftp Tunable glibc.cpu.hwcap_mask
> This tunable supersedes the @env{LD_HWCAP_MASK} environment variable and is
> identical in features.
>
> The @code{AT_HWCAP} key in the Auxiliary Vector specifies instruction set
> extensions available in the processor at runtime for some architectures. The
> -@code{glibc.tune.hwcap_mask} tunable allows the user to mask out those
> +@code{glibc.cpu.hwcap_mask} tunable allows the user to mask out those
> capabilities at runtime, thus disabling use of those extensions.
> @end deftp
>
> -@deftp Tunable glibc.tune.hwcaps
> -The @code{glibc.tune.hwcaps=-xxx,yyy,-zzz...} tunable allows the user to
> +@deftp Tunable glibc.cpu.hwcaps
> +The @code{glibc.cpu.hwcaps=-xxx,yyy,-zzz...} tunable allows the user to
> enable CPU/ARCH feature @code{yyy}, disable CPU/ARCH feature @code{xxx}
> and @code{zzz} where the feature name is case-sensitive and has to match
> the ones in @code{sysdeps/x86/cpu-features.h}.
> @@ -319,8 +319,8 @@ the ones in @code{sysdeps/x86/cpu-features.h}.
> This tunable is specific to i386 and x86-64.
> @end deftp
>
> -@deftp Tunable glibc.tune.cached_memopt
> -The @code{glibc.tune.cached_memopt=[0|1]} tunable allows the user to
> +@deftp Tunable glibc.cpu.cached_memopt
> +The @code{glibc.cpu.cached_memopt=[0|1]} tunable allows the user to
> enable optimizations recommended for cacheable memory. If set to
> @code{1}, @theglibc{} assumes that the process memory image consists
> of cacheable (non-device) memory only. The default, @code{0},
> @@ -329,8 +329,8 @@ indicates that the process may use device memory.
> This tunable is specific to powerpc, powerpc64 and powerpc64le.
> @end deftp
>
> -@deftp Tunable glibc.tune.cpu
> -The @code{glibc.tune.cpu=xxx} tunable allows the user to tell @theglibc{} to
> +@deftp Tunable glibc.cpu.cpu
> +The @code{glibc.cpu.cpu=xxx} tunable allows the user to tell @theglibc{} to
s/cpu.cpu/cpu.name/ in both lines.
Otherwise, looks good to me.
--
Tulio Magno