diff mbox series

[v4] lib/string.c: implement a basic bcmp

Message ID 20190313211335.165605-1-ndesaulniers@google.com
State Accepted
Commit 5f074f3e192f10c9fade898b9b3b8812e3d83342
Headers show
Series [v4] lib/string.c: implement a basic bcmp | expand

Commit Message

Nick Desaulniers March 13, 2019, 9:13 p.m. UTC
A recent optimization in Clang (r355672) lowers comparisons of the
return value of memcmp against zero to comparisons of the return value
of bcmp against zero.  This helps some platforms that implement bcmp
more efficiently than memcmp. glibc simply aliases bcmp to memcmp, but
an optimized implementation is in the works.

This results in linkage failures for all targets with Clang due to the
undefined symbol.  For now, just implement bcmp as a tailcail to memcmp
to unbreak the build.  This routine can be further optimized in the
future.

Other ideas discussed:
* A weak alias was discussed, but breaks for architectures that define
their own implementations of memcmp since aliases to declarations are
not permitted (only definitions).  Arch-specific memcmp implementations
typically declare memcmp in C headers, but implement them in assembly.
* -ffreestanding also is used sporadically throughout the kernel.
* -fno-builtin-bcmp doesn't work when doing LTO.

Link: https://bugs.llvm.org/show_bug.cgi?id=41035
Link: https://code.woboq.org/userspace/glibc/string/memcmp.c.html#bcmp
Link: https://github.com/llvm/llvm-project/commit/8e16d73346f8091461319a7dfc4ddd18eedcff13
Link: https://github.com/ClangBuiltLinux/linux/issues/416
Cc: stable@vger.kernel.org
Reported-by: Nathan Chancellor <natechancellor@gmail.com>
Reported-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>
Suggested-by: Arnd Bergmann <arnd@arndb.de>
Suggested-by: James Y Knight <jyknight@google.com>
Suggested-by: Masahiro Yamada <yamada.masahiro@socionext.com>
Suggested-by: Nathan Chancellor <natechancellor@gmail.com>
Suggested-by: Rasmus Villemoes <linux@rasmusvillemoes.dk>
Signed-off-by: Nick Desaulniers <ndesaulniers@google.com>

Acked-by: Steven Rostedt (VMware) <rostedt@goodmis.org>

---
Changes V3 -> V4:
* Include the entirety of Rasmus' sugguestion, as per Steven.
* Change formal parameter identifiers to match the comment.
Changes V2 -> V3:
* Adjust comment as per Steven to Rasmus' sugguestion.
* Pick up Steven's Ack.
Changes V1 -> V2:
* Add declaration to include/linux/string.h.
* Reword comment above bcmp.

 include/linux/string.h |  3 +++
 lib/string.c           | 20 ++++++++++++++++++++
 2 files changed, 23 insertions(+)

-- 
2.21.0.360.g471c308f928-goog

Comments

Masahiro Yamada March 14, 2019, 5 a.m. UTC | #1
On Thu, Mar 14, 2019 at 6:13 AM Nick Desaulniers
<ndesaulniers@google.com> wrote:
>

> A recent optimization in Clang (r355672) lowers comparisons of the

> return value of memcmp against zero to comparisons of the return value

> of bcmp against zero.  This helps some platforms that implement bcmp

> more efficiently than memcmp. glibc simply aliases bcmp to memcmp, but

> an optimized implementation is in the works.

>

> This results in linkage failures for all targets with Clang due to the

> undefined symbol.  For now, just implement bcmp as a tailcail to memcmp

> to unbreak the build.  This routine can be further optimized in the

> future.

>

> Other ideas discussed:

> * A weak alias was discussed, but breaks for architectures that define

> their own implementations of memcmp since aliases to declarations are

> not permitted (only definitions).  Arch-specific memcmp implementations

> typically declare memcmp in C headers, but implement them in assembly.

> * -ffreestanding also is used sporadically throughout the kernel.

> * -fno-builtin-bcmp doesn't work when doing LTO.

>

> Link: https://bugs.llvm.org/show_bug.cgi?id=41035

> Link: https://code.woboq.org/userspace/glibc/string/memcmp.c.html#bcmp

> Link: https://github.com/llvm/llvm-project/commit/8e16d73346f8091461319a7dfc4ddd18eedcff13

> Link: https://github.com/ClangBuiltLinux/linux/issues/416

> Cc: stable@vger.kernel.org

> Reported-by: Nathan Chancellor <natechancellor@gmail.com>

> Reported-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>

> Suggested-by: Arnd Bergmann <arnd@arndb.de>

> Suggested-by: James Y Knight <jyknight@google.com>

> Suggested-by: Masahiro Yamada <yamada.masahiro@socionext.com>

> Suggested-by: Nathan Chancellor <natechancellor@gmail.com>

> Suggested-by: Rasmus Villemoes <linux@rasmusvillemoes.dk>

> Signed-off-by: Nick Desaulniers <ndesaulniers@google.com>

> Acked-by: Steven Rostedt (VMware) <rostedt@goodmis.org>



Reviewed-by: Masahiro Yamada <yamada.masahiro@socionext.com>





> ---

> Changes V3 -> V4:

> * Include the entirety of Rasmus' sugguestion, as per Steven.

> * Change formal parameter identifiers to match the comment.

> Changes V2 -> V3:

> * Adjust comment as per Steven to Rasmus' sugguestion.

> * Pick up Steven's Ack.

> Changes V1 -> V2:

> * Add declaration to include/linux/string.h.

> * Reword comment above bcmp.

>

>  include/linux/string.h |  3 +++

>  lib/string.c           | 20 ++++++++++++++++++++

>  2 files changed, 23 insertions(+)

>

> diff --git a/include/linux/string.h b/include/linux/string.h

> index 7927b875f80c..6ab0a6fa512e 100644

> --- a/include/linux/string.h

> +++ b/include/linux/string.h

> @@ -150,6 +150,9 @@ extern void * memscan(void *,int,__kernel_size_t);

>  #ifndef __HAVE_ARCH_MEMCMP

>  extern int memcmp(const void *,const void *,__kernel_size_t);

>  #endif

> +#ifndef __HAVE_ARCH_BCMP

> +extern int bcmp(const void *,const void *,__kernel_size_t);

> +#endif

>  #ifndef __HAVE_ARCH_MEMCHR

>  extern void * memchr(const void *,int,__kernel_size_t);

>  #endif

> diff --git a/lib/string.c b/lib/string.c

> index 38e4ca08e757..3ab861c1a857 100644

> --- a/lib/string.c

> +++ b/lib/string.c

> @@ -866,6 +866,26 @@ __visible int memcmp(const void *cs, const void *ct, size_t count)

>  EXPORT_SYMBOL(memcmp);

>  #endif

>

> +#ifndef __HAVE_ARCH_BCMP

> +/**

> + * bcmp - returns 0 if and only if the buffers have identical contents.

> + * @a: pointer to first buffer.

> + * @b: pointer to second buffer.

> + * @len: size of buffers.

> + *

> + * The sign or magnitude of a non-zero return value has no particular

> + * meaning, and architectures may implement their own more efficient bcmp(). So

> + * while this particular implementation is a simple (tail) call to memcmp, do

> + * not rely on anything but whether the return value is zero or non-zero.

> + */

> +#undef bcmp

> +int bcmp(const void *a, const void *b, size_t len)

> +{

> +       return memcmp(a, b, len);

> +}

> +EXPORT_SYMBOL(bcmp);

> +#endif

> +

>  #ifndef __HAVE_ARCH_MEMSCAN

>  /**

>   * memscan - Find a character in an area of memory.

> --

> 2.21.0.360.g471c308f928-goog

>



-- 
Best Regards
Masahiro Yamada
Andy Shevchenko March 14, 2019, 8:33 a.m. UTC | #2
On Wed, Mar 13, 2019 at 02:13:31PM -0700, Nick Desaulniers wrote:
> A recent optimization in Clang (r355672) lowers comparisons of the

> return value of memcmp against zero to comparisons of the return value

> of bcmp against zero.  This helps some platforms that implement bcmp

> more efficiently than memcmp. glibc simply aliases bcmp to memcmp, but

> an optimized implementation is in the works.

> 

> This results in linkage failures for all targets with Clang due to the

> undefined symbol.  For now, just implement bcmp as a tailcail to memcmp

> to unbreak the build.  This routine can be further optimized in the

> future.

> 

> Other ideas discussed:

> * A weak alias was discussed, but breaks for architectures that define

> their own implementations of memcmp since aliases to declarations are

> not permitted (only definitions).  Arch-specific memcmp implementations

> typically declare memcmp in C headers, but implement them in assembly.

> * -ffreestanding also is used sporadically throughout the kernel.

> * -fno-builtin-bcmp doesn't work when doing LTO.


Thanks!
Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>


> 

> Link: https://bugs.llvm.org/show_bug.cgi?id=41035

> Link: https://code.woboq.org/userspace/glibc/string/memcmp.c.html#bcmp

> Link: https://github.com/llvm/llvm-project/commit/8e16d73346f8091461319a7dfc4ddd18eedcff13

> Link: https://github.com/ClangBuiltLinux/linux/issues/416

> Cc: stable@vger.kernel.org

> Reported-by: Nathan Chancellor <natechancellor@gmail.com>

> Reported-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>

> Suggested-by: Arnd Bergmann <arnd@arndb.de>

> Suggested-by: James Y Knight <jyknight@google.com>

> Suggested-by: Masahiro Yamada <yamada.masahiro@socionext.com>

> Suggested-by: Nathan Chancellor <natechancellor@gmail.com>

> Suggested-by: Rasmus Villemoes <linux@rasmusvillemoes.dk>

> Signed-off-by: Nick Desaulniers <ndesaulniers@google.com>

> Acked-by: Steven Rostedt (VMware) <rostedt@goodmis.org>

> ---

> Changes V3 -> V4:

> * Include the entirety of Rasmus' sugguestion, as per Steven.

> * Change formal parameter identifiers to match the comment.

> Changes V2 -> V3:

> * Adjust comment as per Steven to Rasmus' sugguestion.

> * Pick up Steven's Ack.

> Changes V1 -> V2:

> * Add declaration to include/linux/string.h.

> * Reword comment above bcmp.

> 

>  include/linux/string.h |  3 +++

>  lib/string.c           | 20 ++++++++++++++++++++

>  2 files changed, 23 insertions(+)

> 

> diff --git a/include/linux/string.h b/include/linux/string.h

> index 7927b875f80c..6ab0a6fa512e 100644

> --- a/include/linux/string.h

> +++ b/include/linux/string.h

> @@ -150,6 +150,9 @@ extern void * memscan(void *,int,__kernel_size_t);

>  #ifndef __HAVE_ARCH_MEMCMP

>  extern int memcmp(const void *,const void *,__kernel_size_t);

>  #endif

> +#ifndef __HAVE_ARCH_BCMP

> +extern int bcmp(const void *,const void *,__kernel_size_t);

> +#endif

>  #ifndef __HAVE_ARCH_MEMCHR

>  extern void * memchr(const void *,int,__kernel_size_t);

>  #endif

> diff --git a/lib/string.c b/lib/string.c

> index 38e4ca08e757..3ab861c1a857 100644

> --- a/lib/string.c

> +++ b/lib/string.c

> @@ -866,6 +866,26 @@ __visible int memcmp(const void *cs, const void *ct, size_t count)

>  EXPORT_SYMBOL(memcmp);

>  #endif

>  

> +#ifndef __HAVE_ARCH_BCMP

> +/**

> + * bcmp - returns 0 if and only if the buffers have identical contents.

> + * @a: pointer to first buffer.

> + * @b: pointer to second buffer.

> + * @len: size of buffers.

> + *

> + * The sign or magnitude of a non-zero return value has no particular

> + * meaning, and architectures may implement their own more efficient bcmp(). So

> + * while this particular implementation is a simple (tail) call to memcmp, do

> + * not rely on anything but whether the return value is zero or non-zero.

> + */

> +#undef bcmp

> +int bcmp(const void *a, const void *b, size_t len)

> +{

> +	return memcmp(a, b, len);

> +}

> +EXPORT_SYMBOL(bcmp);

> +#endif

> +

>  #ifndef __HAVE_ARCH_MEMSCAN

>  /**

>   * memscan - Find a character in an area of memory.

> -- 

> 2.21.0.360.g471c308f928-goog

> 


-- 
With Best Regards,
Andy Shevchenko
David Laight March 14, 2019, 9:57 a.m. UTC | #3
From: Nick Desaulniers

> Sent: 13 March 2019 21:14

...
> diff --git a/include/linux/string.h b/include/linux/string.h

> index 7927b875f80c..6ab0a6fa512e 100644

> --- a/include/linux/string.h

> +++ b/include/linux/string.h

> @@ -150,6 +150,9 @@ extern void * memscan(void *,int,__kernel_size_t);

>  #ifndef __HAVE_ARCH_MEMCMP

>  extern int memcmp(const void *,const void *,__kernel_size_t);

>  #endif

> +#ifndef __HAVE_ARCH_BCMP

> +extern int bcmp(const void *,const void *,__kernel_size_t);

> +#endif


Shouldn't that prototype always be present?
Any architecture specific implementation better have the same definition.
This is particularly true here since the compiler is going to assume
the default calling convention.

The only time you wouldn't want it is when the architecture specific
implementation is inline asm.
If that were an option the default implementation would need to be
excluded using a different #define.

	David

-
Registered Address Lakeside, Bramley Road, Mount Farm, Milton Keynes, MK1 1PT, UK
Registration No: 1397386 (Wales)
Rasmus Villemoes March 14, 2019, 11:07 a.m. UTC | #4
On 14/03/2019 10.57, David Laight wrote:
> From: Nick Desaulniers

>> Sent: 13 March 2019 21:14

> ...

>> diff --git a/include/linux/string.h b/include/linux/string.h

>> index 7927b875f80c..6ab0a6fa512e 100644

>> --- a/include/linux/string.h

>> +++ b/include/linux/string.h

>> @@ -150,6 +150,9 @@ extern void * memscan(void *,int,__kernel_size_t);

>>  #ifndef __HAVE_ARCH_MEMCMP

>>  extern int memcmp(const void *,const void *,__kernel_size_t);

>>  #endif

>> +#ifndef __HAVE_ARCH_BCMP

>> +extern int bcmp(const void *,const void *,__kernel_size_t);

>> +#endif

> 

> Shouldn't that prototype always be present?


Yes and no. The problem is that asm/string.h may decide to implement
bcmp (or memcpy, memset, strcpy, ...) as a macro, which would break
rather badly when used to declare the function. And we can't undef the
macro temporarily. So I think the convention is that asm/string.h
provides the prototype before it #defines the macro, see e.g.
arch/x86/include/asm/string_32.h which has a #define of memcpy.

There is a fix for the "may be defined as a function-like macro", which is

extern int (bcmp)(const void *,const void *,__kernel_size_t);

I'd like to see that used rather than the ad hoc convention, but it is
of course somewhat unconventional C.

Rasmus
Andrew Morton March 21, 2019, 2:11 a.m. UTC | #5
On Wed, 13 Mar 2019 14:13:31 -0700 Nick Desaulniers <ndesaulniers@google.com> wrote:

> A recent optimization in Clang (r355672) lowers comparisons of the

> return value of memcmp against zero to comparisons of the return value

> of bcmp against zero.  This helps some platforms that implement bcmp

> more efficiently than memcmp. glibc simply aliases bcmp to memcmp, but

> an optimized implementation is in the works.

> 

> This results in linkage failures for all targets with Clang due to the

> undefined symbol.  For now, just implement bcmp as a tailcail to memcmp

> to unbreak the build.  This routine can be further optimized in the

> future.

> 

> Other ideas discussed:

> * A weak alias was discussed, but breaks for architectures that define

> their own implementations of memcmp since aliases to declarations are

> not permitted (only definitions).  Arch-specific memcmp implementations

> typically declare memcmp in C headers, but implement them in assembly.

> * -ffreestanding also is used sporadically throughout the kernel.

> * -fno-builtin-bcmp doesn't work when doing LTO.


I guess we should backport this into -stable so that older kernels can
be built with newer Clang.

> ...

>

> --- a/lib/string.c

> +++ b/lib/string.c

> @@ -866,6 +866,26 @@ __visible int memcmp(const void *cs, const void *ct, size_t count)

>  EXPORT_SYMBOL(memcmp);

>  #endif

>  

> +#ifndef __HAVE_ARCH_BCMP

> +/**

> + * bcmp - returns 0 if and only if the buffers have identical contents.

> + * @a: pointer to first buffer.

> + * @b: pointer to second buffer.

> + * @len: size of buffers.

> + *

> + * The sign or magnitude of a non-zero return value has no particular

> + * meaning, and architectures may implement their own more efficient bcmp(). So

> + * while this particular implementation is a simple (tail) call to memcmp, do

> + * not rely on anything but whether the return value is zero or non-zero.

> + */

> +#undef bcmp


What is the undef for?

> +int bcmp(const void *a, const void *b, size_t len)

> +{

> +	return memcmp(a, b, len);

> +}

> +EXPORT_SYMBOL(bcmp);

> +#endif

> +

>  #ifndef __HAVE_ARCH_MEMSCAN

>  /**

>   * memscan - Find a character in an area of memory.

> -- 

> 2.21.0.360.g471c308f928-goog
Nick Desaulniers March 21, 2019, 5:20 p.m. UTC | #6
On Thu, Mar 21, 2019 at 10:02 AM Nick Desaulniers
<ndesaulniers@google.com> wrote:
>

> On Wed, Mar 20, 2019 at 7:11 PM Andrew Morton <akpm@linux-foundation.org> wrote:

> > I guess we should backport this into -stable so that older kernels can

> > be built with newer Clang.

>

> Ah, you're right.  I always forget.  Is it too late to add

>

> Cc: stable@vger.kernel.org

>

> to the patch in your tree?


Just noticed now. Thank you for adding it!
-- 
Thanks,
~Nick Desaulniers
diff mbox series

Patch

diff --git a/include/linux/string.h b/include/linux/string.h
index 7927b875f80c..6ab0a6fa512e 100644
--- a/include/linux/string.h
+++ b/include/linux/string.h
@@ -150,6 +150,9 @@  extern void * memscan(void *,int,__kernel_size_t);
 #ifndef __HAVE_ARCH_MEMCMP
 extern int memcmp(const void *,const void *,__kernel_size_t);
 #endif
+#ifndef __HAVE_ARCH_BCMP
+extern int bcmp(const void *,const void *,__kernel_size_t);
+#endif
 #ifndef __HAVE_ARCH_MEMCHR
 extern void * memchr(const void *,int,__kernel_size_t);
 #endif
diff --git a/lib/string.c b/lib/string.c
index 38e4ca08e757..3ab861c1a857 100644
--- a/lib/string.c
+++ b/lib/string.c
@@ -866,6 +866,26 @@  __visible int memcmp(const void *cs, const void *ct, size_t count)
 EXPORT_SYMBOL(memcmp);
 #endif
 
+#ifndef __HAVE_ARCH_BCMP
+/**
+ * bcmp - returns 0 if and only if the buffers have identical contents.
+ * @a: pointer to first buffer.
+ * @b: pointer to second buffer.
+ * @len: size of buffers.
+ *
+ * The sign or magnitude of a non-zero return value has no particular
+ * meaning, and architectures may implement their own more efficient bcmp(). So
+ * while this particular implementation is a simple (tail) call to memcmp, do
+ * not rely on anything but whether the return value is zero or non-zero.
+ */
+#undef bcmp
+int bcmp(const void *a, const void *b, size_t len)
+{
+	return memcmp(a, b, len);
+}
+EXPORT_SYMBOL(bcmp);
+#endif
+
 #ifndef __HAVE_ARCH_MEMSCAN
 /**
  * memscan - Find a character in an area of memory.