libs/bssl/src/sha.rs

// Copyright 2023, The Android Open Source Project
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

//! Wrappers of the SHA functions in BoringSSL sha.h.

use crate::util::to_call_failed_error;
use bssl_avf_error::{ApiName, Result};
use bssl_ffi::SHA256;

/// The length of a SHA256 digest.
pub(crate) const SHA256_DIGEST_LENGTH: usize = bssl_ffi::SHA256_DIGEST_LENGTH as usize;

/// Computes the SHA256 digest of the provided `data``.
pub fn sha256(data: &[u8]) -> Result<[u8; SHA256_DIGEST_LENGTH]> {
    let mut out = [0u8; SHA256_DIGEST_LENGTH];
    // SAFETY: This function reads `data` and writes to `out` within its bounds.
    // `out` has `SHA256_DIGEST_LENGTH` bytes of space for write.
    let ret = unsafe { SHA256(data.as_ptr(), data.len(), out.as_mut_ptr()) };
    if ret.is_null() {
        Err(to_call_failed_error(ApiName::SHA256))
    } else {
        Ok(out)
    }
}