2012-03-27 23:13:14 +00:00
|
|
|
// Copyright 2009 The Go Authors. All rights reserved.
|
|
|
|
// Use of this source code is governed by a BSD-style
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
|
|
|
// Package subtle implements functions that are often useful in cryptographic
|
|
|
|
// code but require careful thought to use correctly.
|
|
|
|
package subtle
|
|
|
|
|
2017-10-07 00:16:47 +00:00
|
|
|
// ConstantTimeCompare returns 1 if and only if the two slices, x
|
2012-03-27 23:13:14 +00:00
|
|
|
// and y, have equal contents. The time taken is a function of the length of
|
|
|
|
// the slices and is independent of the contents.
|
|
|
|
func ConstantTimeCompare(x, y []byte) int {
|
2015-08-28 15:33:40 +00:00
|
|
|
if len(x) != len(y) {
|
|
|
|
return 0
|
|
|
|
}
|
|
|
|
|
2012-03-27 23:13:14 +00:00
|
|
|
var v byte
|
|
|
|
|
|
|
|
for i := 0; i < len(x); i++ {
|
|
|
|
v |= x[i] ^ y[i]
|
|
|
|
}
|
|
|
|
|
|
|
|
return ConstantTimeByteEq(v, 0)
|
|
|
|
}
|
|
|
|
|
|
|
|
// ConstantTimeSelect returns x if v is 1 and y if v is 0.
|
|
|
|
// Its behavior is undefined if v takes any other value.
|
|
|
|
func ConstantTimeSelect(v, x, y int) int { return ^(v-1)&x | (v-1)&y }
|
|
|
|
|
|
|
|
// ConstantTimeByteEq returns 1 if x == y and 0 otherwise.
|
|
|
|
func ConstantTimeByteEq(x, y uint8) int {
|
|
|
|
z := ^(x ^ y)
|
|
|
|
z &= z >> 4
|
|
|
|
z &= z >> 2
|
|
|
|
z &= z >> 1
|
|
|
|
|
|
|
|
return int(z)
|
|
|
|
}
|
|
|
|
|
|
|
|
// ConstantTimeEq returns 1 if x == y and 0 otherwise.
|
|
|
|
func ConstantTimeEq(x, y int32) int {
|
|
|
|
z := ^(x ^ y)
|
|
|
|
z &= z >> 16
|
|
|
|
z &= z >> 8
|
|
|
|
z &= z >> 4
|
|
|
|
z &= z >> 2
|
|
|
|
z &= z >> 1
|
|
|
|
|
|
|
|
return int(z & 1)
|
|
|
|
}
|
|
|
|
|
2015-08-28 15:33:40 +00:00
|
|
|
// ConstantTimeCopy copies the contents of y into x (a slice of equal length)
|
|
|
|
// if v == 1. If v == 0, x is left unchanged. Its behavior is undefined if v
|
|
|
|
// takes any other value.
|
2012-03-27 23:13:14 +00:00
|
|
|
func ConstantTimeCopy(v int, x, y []byte) {
|
2015-08-28 15:33:40 +00:00
|
|
|
if len(x) != len(y) {
|
|
|
|
panic("subtle: slices have different lengths")
|
|
|
|
}
|
|
|
|
|
2012-03-27 23:13:14 +00:00
|
|
|
xmask := byte(v - 1)
|
|
|
|
ymask := byte(^(v - 1))
|
|
|
|
for i := 0; i < len(x); i++ {
|
|
|
|
x[i] = x[i]&xmask | y[i]&ymask
|
|
|
|
}
|
|
|
|
}
|
2014-09-21 17:33:12 +00:00
|
|
|
|
|
|
|
// ConstantTimeLessOrEq returns 1 if x <= y and 0 otherwise.
|
|
|
|
// Its behavior is undefined if x or y are negative or > 2**31 - 1.
|
|
|
|
func ConstantTimeLessOrEq(x, y int) int {
|
|
|
|
x32 := int32(x)
|
|
|
|
y32 := int32(y)
|
|
|
|
return int(((x32 - y32 - 1) >> 31) & 1)
|
|
|
|
}
|