//
|
// CryptoSwift
|
//
|
// Copyright (C) 2014-2022 Marcin Krzyżanowski <marcin@krzyzanowskim.com>
|
// This software is provided 'as-is', without any express or implied warranty.
|
//
|
// In no event will the authors be held liable for any damages arising from the use of this software.
|
//
|
// Permission is granted to anyone to use this software for any purpose,including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
|
//
|
// - The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation is required.
|
// - Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
|
// - This notice may not be removed or altered from any source or binary distribution.
|
//
|
|
#if canImport(Darwin)
|
import Darwin
|
#elseif canImport(Glibc)
|
import Glibc
|
#elseif canImport(WinSDK)
|
import WinSDK
|
#endif
|
|
typealias Key = SecureBytes
|
|
/// Keeps bytes in memory. Because this is class, bytes are not copied
|
/// and memory area is locked as long as referenced, then unlocked on deinit
|
final class SecureBytes {
|
private let bytes: Array<UInt8>
|
let count: Int
|
|
init(bytes: Array<UInt8>) {
|
self.bytes = bytes
|
self.count = bytes.count
|
self.bytes.withUnsafeBufferPointer { (pointer) -> Void in
|
#if os(Windows)
|
VirtualLock(UnsafeMutableRawPointer(mutating: pointer.baseAddress), SIZE_T(pointer.count))
|
#elseif os(WASI)
|
// not supported on WASI
|
#else
|
mlock(pointer.baseAddress, pointer.count)
|
#endif
|
}
|
}
|
|
deinit {
|
self.bytes.withUnsafeBufferPointer { (pointer) -> Void in
|
#if os(Windows)
|
VirtualUnlock(UnsafeMutableRawPointer(mutating: pointer.baseAddress), SIZE_T(pointer.count))
|
#elseif os(WASI)
|
// not supported on WASI
|
#else
|
munlock(pointer.baseAddress, pointer.count)
|
#endif
|
}
|
}
|
}
|
|
extension SecureBytes: Collection {
|
typealias Index = Int
|
|
var endIndex: Int {
|
self.bytes.endIndex
|
}
|
|
var startIndex: Int {
|
self.bytes.startIndex
|
}
|
|
subscript(position: Index) -> UInt8 {
|
self.bytes[position]
|
}
|
|
subscript(bounds: Range<Index>) -> ArraySlice<UInt8> {
|
self.bytes[bounds]
|
}
|
|
func formIndex(after i: inout Int) {
|
self.bytes.formIndex(after: &i)
|
}
|
|
func index(after i: Int) -> Int {
|
self.bytes.index(after: i)
|
}
|
}
|
|
extension SecureBytes: ExpressibleByArrayLiteral {
|
public convenience init(arrayLiteral elements: UInt8...) {
|
self.init(bytes: elements)
|
}
|
}
|