2001-02-02 17:54:47 +00:00
|
|
|
.TH byte_equal 3
|
|
|
|
|
.SH NAME
|
|
|
|
|
byte_equal \- compare two strings
|
|
|
|
|
.SH SYNTAX
|
2017-05-13 22:51:26 +00:00
|
|
|
.B #include <libowfat/byte.h>
|
2001-02-02 17:54:47 +00:00
|
|
|
|
2006-11-07 17:56:05 +00:00
|
|
|
int \fBbyte_equal\fP(const char *\fIone\fR,size_t \fIlen\fR,const char *\fItwo\fR);
|
2001-02-02 17:54:47 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
\fIbyte_equal\fR returns 1 if the strings are equal, 0 otherwise.
|
|
|
|
|
|
|
|
|
|
When the strings are different, byte_equal does not read bytes past the
|
2020-10-22 20:43:13 +00:00
|
|
|
first difference. An attacker observing the execution timing can thus
|
|
|
|
|
learn where the first mismatch happened.
|
|
|
|
|
|
|
|
|
|
Use byte_equal_notimingattack to compare keys, passphrases, cookies or
|
|
|
|
|
hashes instead.
|
2001-02-02 17:54:47 +00:00
|
|
|
|
|
|
|
|
.SH "SEE ALSO"
|
2020-10-22 20:43:13 +00:00
|
|
|
byte_diff(3), byte_equal_notimingattack(3)
|
