From 3c94dc45dfb15483d76c47a128ec352cc0b655ac Mon Sep 17 00:00:00 2001 From: cvs2svn Date: Wed, 4 May 2022 18:02:08 +0000 Subject: This commit was manufactured by cvs2git to create tag 'tb_20220504'. --- src/lib/libc/string/timingsafe_bcmp.3 | 87 ----------------------------------- 1 file changed, 87 deletions(-) delete mode 100644 src/lib/libc/string/timingsafe_bcmp.3 (limited to 'src/lib/libc/string/timingsafe_bcmp.3') diff --git a/src/lib/libc/string/timingsafe_bcmp.3 b/src/lib/libc/string/timingsafe_bcmp.3 deleted file mode 100644 index 00da769157..0000000000 --- a/src/lib/libc/string/timingsafe_bcmp.3 +++ /dev/null @@ -1,87 +0,0 @@ -.\" $OpenBSD: timingsafe_bcmp.3,v 1.2 2014/06/21 20:22:15 tedu Exp $ -.\" -.\" Copyright (c) 2014 Google Inc. -.\" -.\" Permission to use, copy, modify, and distribute this software for any -.\" purpose with or without fee is hereby granted, provided that the above -.\" copyright notice and this permission notice appear in all copies. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES -.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF -.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR -.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES -.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN -.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF -.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -.Dd $Mdocdate: June 21 2014 $ -.Dt TIMINGSAFE_BCMP 3 -.Os -.Sh NAME -.Nm timingsafe_bcmp , -.Nm timingsafe_memcmp -.Nd timing-safe byte sequence comparisons -.Sh SYNOPSIS -.In string.h -.Ft int -.Fn timingsafe_bcmp "const void *b1" "const void *b2" "size_t len" -.Ft int -.Fn timingsafe_memcmp "const void *b1" "const void *b2" "size_t len" -.Sh DESCRIPTION -The -.Fn timingsafe_bcmp -and -.Fn timingsafe_memcmp -functions lexicographically compare the first -.Fa len -bytes (each interpreted as an -.Vt unsigned char ) -pointed to by -.Fa b1 -and -.Fa b2 . -.Pp -Additionally, their running times are independent of the byte sequences compared, -making them safe to use for comparing secret values such as cryptographic MACs. -In contrast, -.Xr bcmp 3 -and -.Xr memcmp 3 -may short-circuit after finding the first differing byte. -.Sh RETURN VALUES -The -.Fn timingsafe_bcmp -function returns 0 or not zero if the byte sequence pointed to by -.Fa b1 -compares equal to or not equal to (respectively) -the byte sequence pointed to by -.Fa b2 . -.Pp -The -.Fn timingsafe_memcmp -function returns a negative value, 0, or positive value if the byte sequence -pointed to by -.Fa b1 -compares less than, equal to, or greater than (respectively) -the byte sequence pointed to by -.Fa b2 . -.Sh SEE ALSO -.Xr bcmp 3 , -.Xr memcmp 3 -.Sh STANDARDS -The -.Fn timingsafe_bcmp -and -.Fn timingsafe_memcmp -functions are -.Ox -extensions. -.Sh HISTORY -The -.Fn timingsafe_bcmp -function first appeared in -.Ox 4.9 . -.Pp -The -.Fn timingsafe_memcmp -function first appeared in -.Ox 5.6 . -- cgit v1.2.3-55-g6feb