lib/xxhash: make xxh{32,64}_update() return void
Subsystems (2)
PATCH 1/1 lib/xxhash: make xxh{32,64}_update() return void
From: Eric Biggers <[email protected]>
The return value of xxh64_update() is pointless and confusing, since an error is only returned for input==NULL. But the callers must ignore this error because they might pass input=NULL, length=0.
Likewise for xxh32_update().
Just make these functions return void.
---
lib/xxhash.c doesn't actually have a maintainer, but probably it makes sense to take this through the crypto tree, alongside the other patch I sent to return void in lib/crypto/sha256.c.
include/linux/xxhash.h | 8 ++------ lib/xxhash.c | 20 ++++++-------------- 2 files changed, 8 insertions(+), 20 deletions(-)
include/linux/xxhash.h +2 -6
@@ -185,10 +185,8 @@ void xxh32_reset(struct xxh32_state *state, uint32_t seed);* @length: The length of the data to hash. * * After calling xxh32_reset() call xxh32_update() as many times as necessary. -* -* Return: Zero on success, otherwise an error code. */ -int xxh32_update (struct xxh32_state *state,const void *input,size_t length); +void xxh32_update (struct xxh32_state *state,const void *input,size_t length);/** * xxh32_digest() - produce the current xxh32 hash
@@ -218,10 +216,8 @@ void xxh64_reset(struct xxh64_state *state, uint64_t seed);* @length: The length of the data to hash. * * After calling xxh64_reset() call xxh64_update() as many times as necessary. -* -* Return: Zero on success, otherwise an error code. */ -int xxh64_update (struct xxh64_state *state,const void *input,size_t length); +void xxh64_update (struct xxh64_state *state,const void *input,size_t length);/** * xxh64_digest() - produce the current xxh64 hash
lib/xxhash.c +6 -14
@@ -267,21 +267,19 @@ void xxh64_reset(struct xxh64_state *statePtr, const uint64_t seed) }EXPORT_SYMBOL (xxh64_reset); -int xxh32_update (struct xxh32_state *state,const void *input,const size_t len) +void xxh32_update (struct xxh32_state *state,const void *input, +const size_t len) {const uint8_t *p = (const uint8_t *)input;const uint8_t *const b_end = p + len; -if (input ==NULL ) -return -EINVAL ; - state->total_len_32 += (uint32_t )len; state->large_len |= (len >=16 ) | (state->total_len_32 >=16 );if (state->memsize + len <16 ) {/* fill in tmp buffer */ memcpy ((uint8_t *)(state->mem32) + state->memsize, input, len); state->memsize += (uint32_t )len; -return 0 ; +return ; }if (state->memsize) {/* some data left from previous update */
@@ -331,8 +329,6 @@ int xxh32_update(struct xxh32_state *state, const void *input, const size_t len)memcpy (state->mem32, p, (size_t )(b_end-p)); state->memsize = (uint32_t )(b_end-p); } - -return 0 ; }EXPORT_SYMBOL (xxh32_update);
@@ -374,20 +370,18 @@ uint32_t xxh32_digest(const struct xxh32_state *state) }EXPORT_SYMBOL (xxh32_digest); -int xxh64_update (struct xxh64_state *state,const void *input,const size_t len) +void xxh64_update (struct xxh64_state *state,const void *input, +const size_t len) {const uint8_t *p = (const uint8_t *)input;const uint8_t *const b_end = p + len; -if (input ==NULL ) -return -EINVAL ; - state->total_len += len;if (state->memsize + len <32 ) {/* fill in tmp buffer */ memcpy (((uint8_t *)state->mem64) + state->memsize, input, len); state->memsize += (uint32_t )len; -return 0 ; +return ; }if (state->memsize) {/* tmp buffer is full */
@@ -436,8 +430,6 @@ int xxh64_update(struct xxh64_state *state, const void *input, const size_t len)memcpy (state->mem64, p, (size_t )(b_end-p)); state->memsize = (uint32_t )(b_end - p); } - -return 0 ; }EXPORT_SYMBOL (xxh64_update);
Signature · 1 line
2.26.2
Quoted 58 lines · Eric Biggers
From: Eric Biggers <[email protected]>
The return value of
xxh64_update()is pointless and confusing, since an error is only returned for input==NULL. But the callers must ignore this error because they might pass input=NULL, length=0.Likewise for
xxh32_update().Just make these functions return void.
Cc Nikolay Borisov <[email protected]>Signed-off-by Eric Biggers <[email protected]>---
lib/xxhash.cdoesn't actually have a maintainer, but probably it makes sense to take this through the crypto tree, alongside the other patch I sent to return void inlib/crypto/sha256.c.include/linux/xxhash.h | 8 ++------ lib/xxhash.c | 20 ++++++-------------- 2 files changed, 8 insertions(+), 20 deletions(-)include/linux/xxhash.h +2
-6@@ -185,10 +185,8 @@ void xxh32_reset(struct xxh32_state *state, uint32_t seed);* @length: The length of the data to hash. * * After calling xxh32_reset() call xxh32_update() as many times as necessary. -* -* Return: Zero on success, otherwise an error code. */ -int xxh32_update (struct xxh32_state *state,const void *input,size_t length); +void xxh32_update (struct xxh32_state *state,const void *input,size_t length);/** * xxh32_digest() - produce the current xxh32 hash @@ -218,10 +216,8 @@ void xxh64_reset(struct xxh64_state *state, uint64_t seed);* @length: The length of the data to hash. * * After calling xxh64_reset() call xxh64_update() as many times as necessary. -* -* Return: Zero on success, otherwise an error code. */ -int xxh64_update (struct xxh64_state *state,const void *input,size_t length); +void xxh64_update (struct xxh64_state *state,const void *input,size_t length);/** * xxh64_digest() - produce the current xxh64 hash lib/xxhash.c +0
-0@@ -267,21 +267,19 @@ void xxh64_reset(struct xxh64_state *statePtr, const uint64_t seed) }EXPORT_SYMBOL (xxh64_reset);
lib/xxhash.c void xxh64_reset(struct xxh64_state *statePtr, const uint64_t seed) · line 277
Quoted 10 lines
lib/xxhash.c +2
-4-int xxh32_update (struct xxh32_state *state,const void *input,const size_t len) +void xxh32_update (struct xxh32_state *state,const void *input, +const size_t len) {const uint8_t *p = (const uint8_t *)input;const uint8_t *const b_end = p + len; -if (input ==NULL ) -return -EINVAL ; -
Values calculated based on input are dereferenced further down, wouldn't that cause crashes in case input is null ?
Quoted 54 lines
lib/xxhash.c +4
-10state->total_len_32 += (uint32_t )len; state->large_len |= (len >=16 ) | (state->total_len_32 >=16 );if (state->memsize + len <16 ) {/* fill in tmp buffer */ memcpy ((uint8_t *)(state->mem32) + state->memsize, input, len); state->memsize += (uint32_t )len; -return 0 ; +return ; }if (state->memsize) {/* some data left from previous update */ @@ -331,8 +329,6 @@ int xxh32_update(struct xxh32_state *state, const void *input, const size_t len)memcpy (state->mem32, p, (size_t )(b_end-p)); state->memsize = (uint32_t )(b_end-p); } - -return 0 ; }EXPORT_SYMBOL (xxh32_update);@@ -374,20 +370,18 @@ uint32_t xxh32_digest(const struct xxh32_state *state) }EXPORT_SYMBOL (xxh32_digest); -int xxh64_update (struct xxh64_state *state,const void *input,const size_t len) +void xxh64_update (struct xxh64_state *state,const void *input, +const size_t len) {const uint8_t *p = (const uint8_t *)input;const uint8_t *const b_end = p + len; -if (input ==NULL ) -return -EINVAL ; - state->total_len += len;if (state->memsize + len <32 ) {/* fill in tmp buffer */ memcpy (((uint8_t *)state->mem64) + state->memsize, input, len); state->memsize += (uint32_t )len; -return 0 ; +return ; }if (state->memsize) {/* tmp buffer is full */ @@ -436,8 +430,6 @@ int xxh64_update(struct xxh64_state *state, const void *input, const size_t len)memcpy (state->mem64, p, (size_t )(b_end-p)); state->memsize = (uint32_t )(b_end - p); } - -return 0 ; }EXPORT_SYMBOL (xxh64_update);
Quoted 6 lines · Nikolay Borisov
Quoted 6 lines
lib/xxhash.c +2
-0+void xxh32_update (struct xxh32_state *state,const void *input, +const size_t len) {const uint8_t *p = (const uint8_t *)input;const uint8_t *const b_end = p + len;
Quoted 7 lines
lib/xxhash.c void xxh64_reset(struct xxh64_state *statePtr, const uint64_t seed) · line 277
Quoted 3 lines
lib/xxhash.c +0
-3-if (input ==NULL ) -return -EINVAL ; -Values calculated based on input are dereferenced further down, wouldn't that cause crashes in case input is null ?
Only if len > 0, which would mean the caller provided an invalid buffer.
- Eric
Quoted 10 lines · Eric Biggers
From: Eric Biggers <[email protected]>
The return value of
xxh64_update()is pointless and confusing, since an error is only returned for input==NULL. But the callers must ignore this error because they might pass input=NULL, length=0.Likewise for
xxh32_update().Just make these functions return void.
Quoted 7 lines
Cc Nikolay Borisov <[email protected]>Signed-off-by Eric Biggers <[email protected]>---
lib/xxhash.cdoesn't actually have a maintainer, but probably it makes sense to take this through the crypto tree, alongside the other patch I sent to return void inlib/crypto/sha256.c.
Herbert, are you planning to apply this patch?
- Eric
Herbert Xu
maintainerQuoted 15 lines · Eric Biggers
Quoted 14 lines · Eric Biggers
From: Eric Biggers <[email protected]>
The return value of
xxh64_update()is pointless and confusing, since an error is only returned for input==NULL. But the callers must ignore this error because they might pass input=NULL, length=0.Likewise for
xxh32_update().Just make these functions return void.
Cc Nikolay Borisov <[email protected]>Signed-off-by Eric Biggers <[email protected]>---
Quoted 5 lines
Quoted 3 lines
lib/xxhash.cdoesn't actually have a maintainer, but probably it makes sense to take this through the crypto tree, alongside the other patch I sent to return void inlib/crypto/sha256.c.Herbert, are you planning to apply this patch?
It looks like Chris Mason added this originally. Chris, are you OK with this patch and if so do you want to take it or shall I push it through the crypto tree?
Thanks,
Signature · 3 lines
Email: Herbert Xu <[email protected]> Home Page: http://gondor.apana.org.au/~herbert/ PGP Key: http://gondor.apana.org.au/~herbert/pubkey.txt