/rust/registry/src/index.crates.io-1949cf8c6b5b557f/aws-lc-rs-1.16.2/src/ptr.rs

Source
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0 OR ISC

use crate::aws_lc::{
    BN_free, CMAC_CTX_free, ECDSA_SIG_free, EC_GROUP_free, EC_KEY_free, EC_POINT_free,
    EVP_AEAD_CTX_free, EVP_CIPHER_CTX_free, EVP_PKEY_CTX_free, EVP_PKEY_free, OPENSSL_free,
    RSA_free, BIGNUM, CMAC_CTX, ECDSA_SIG, EC_GROUP, EC_KEY, EC_POINT, EVP_AEAD_CTX,
    EVP_CIPHER_CTX, EVP_PKEY, EVP_PKEY_CTX, RSA,
};
use std::marker::PhantomData;

pub(crate) type LcPtr<T> = ManagedPointer<*mut T>;
pub(crate) type DetachableLcPtr<T> = DetachablePointer<*mut T>;

#[derive(Debug)]
pub(crate) struct ManagedPointer<P: Pointer> {
    pointer: P,
}

impl<P: Pointer> ManagedPointer<P> {
    #[inline]
    pub fn new<T: IntoPointer<P>>(value: T) -> Result<Self, ()> {
        if let Some(pointer) = value.into_pointer() {
            Ok(Self { pointer })
        } else {
            Err(())
        }
    }

    pub unsafe fn as_slice(&self, len: usize) -> &[P::T] {
        core::slice::from_raw_parts(self.pointer.as_const_ptr(), len)
    }
}

impl<P: Pointer> Drop for ManagedPointer<P> {
    #[inline]
    fn drop(&mut self) {
        self.pointer.free();
    }
}

impl<'a, P: Pointer> From<&'a ManagedPointer<P>> for ConstPointer<'a, P::T> {
    fn from(ptr: &'a ManagedPointer<P>) -> ConstPointer<'a, P::T> {
        ConstPointer {
            ptr: ptr.pointer.as_const_ptr(),
            _lifetime: PhantomData,
        }
    }
}

impl<P: Pointer> ManagedPointer<P> {
    #[inline]
    pub fn as_const(&self) -> ConstPointer<'_, P::T> {
        self.into()
    }

    #[inline]
    pub fn as_const_ptr(&self) -> *const P::T {
        self.pointer.as_const_ptr()
    }

    pub fn project_const_lifetime<'a, C>(
        &'a self,
        f: unsafe fn(&'a Self) -> *const C,
    ) -> Result<ConstPointer<'a, C>, ()> {
        let ptr = unsafe { f(self) };
        if ptr.is_null() {
            return Err(());
        }
        Ok(ConstPointer {
            ptr,
            _lifetime: PhantomData,
        })
    }

    #[inline]
    pub fn as_mut_ptr(&mut self) -> *mut P::T {
        self.pointer.as_mut_ptr()
    }
}

impl<P: Pointer> DetachablePointer<P> {
    #[inline]
    pub fn as_mut_ptr(&mut self) -> *mut P::T {
        self.pointer.as_mut().unwrap().as_mut_ptr()
    }
}

#[derive(Debug)]
#[allow(clippy::module_name_repetitions)]
pub(crate) struct DetachablePointer<P: Pointer> {
    pointer: Option<P>,
}

impl<P: Pointer> DetachablePointer<P> {
    #[inline]
    pub fn new<T: IntoPointer<P>>(value: T) -> Result<Self, ()> {
        if let Some(pointer) = value.into_pointer() {
            Ok(Self {
                pointer: Some(pointer),
            })
        } else {
            Err(())
        }
    }

    #[inline]
    pub fn detach(mut self) -> P {
        self.pointer.take().unwrap()
    }
}

impl<P: Pointer> From<DetachablePointer<P>> for ManagedPointer<P> {
    #[inline]
    fn from(mut dptr: DetachablePointer<P>) -> Self {
        match dptr.pointer.take() {
            Some(pointer) => ManagedPointer { pointer },
            None => {
                // Safety: pointer is only None when DetachableLcPtr is detached or dropped
                unreachable!()
            }
        }
    }
}

impl<P: Pointer> Drop for DetachablePointer<P> {
    #[inline]
    fn drop(&mut self) {
        if let Some(mut pointer) = self.pointer.take() {
            pointer.free();
        }
    }
}

#[derive(Debug)]
pub(crate) struct ConstPointer<'a, T> {
    ptr: *const T,
    _lifetime: PhantomData<&'a T>,
}

impl<T> ConstPointer<'static, T> {
    pub unsafe fn new_static(ptr: *const T) -> Result<Self, ()> {
        if ptr.is_null() {
            return Err(());
        }
        Ok(ConstPointer {
            ptr,
            _lifetime: PhantomData,
        })
    }
}

impl<T> ConstPointer<'_, T> {
    pub fn project_const_lifetime<'a, C>(
        &'a self,
        f: unsafe fn(&'a Self) -> *const C,
    ) -> Result<ConstPointer<'a, C>, ()> {
        let ptr = unsafe { f(self) };
        if ptr.is_null() {
            return Err(());
        }
        Ok(ConstPointer {
            ptr,
            _lifetime: PhantomData,
        })
    }

    pub fn as_const_ptr(&self) -> *const T {
        self.ptr
    }
}

pub(crate) trait Pointer {
    type T;

    fn free(&mut self);
    fn as_const_ptr(&self) -> *const Self::T;
    fn as_mut_ptr(&mut self) -> *mut Self::T;
}

pub(crate) trait IntoPointer<P> {
    fn into_pointer(self) -> Option<P>;
}

impl<T> IntoPointer<*mut T> for *mut T {
    #[inline]
    fn into_pointer(self) -> Option<*mut T> {
        if self.is_null() {
            None
        } else {
            Some(self)
        }
    }
}

macro_rules! create_pointer {
    ($ty:ty, $free:path) => {
        impl Pointer for *mut $ty {
            type T = $ty;

            #[inline]
            fn free(&mut self) {
                unsafe {
                    let ptr = *self;
                    $free(ptr.cast());
                }
            }

            #[inline]
            fn as_const_ptr(&self) -> *const Self::T {
                self.cast()
            }

            #[inline]
            fn as_mut_ptr(&mut self) -> *mut Self::T {
                *self
            }
        }
    };
}

// `OPENSSL_free` and the other `XXX_free` functions perform a zeroization of the memory when it's
// freed. This is different than functions of the same name in OpenSSL which generally do not zero
// memory.
create_pointer!(u8, OPENSSL_free);
create_pointer!(EC_GROUP, EC_GROUP_free);
create_pointer!(EC_POINT, EC_POINT_free);
create_pointer!(EC_KEY, EC_KEY_free);
create_pointer!(ECDSA_SIG, ECDSA_SIG_free);
create_pointer!(BIGNUM, BN_free);
create_pointer!(EVP_PKEY, EVP_PKEY_free);
create_pointer!(EVP_PKEY_CTX, EVP_PKEY_CTX_free);
create_pointer!(RSA, RSA_free);
create_pointer!(EVP_AEAD_CTX, EVP_AEAD_CTX_free);
create_pointer!(EVP_CIPHER_CTX, EVP_CIPHER_CTX_free);
create_pointer!(CMAC_CTX, CMAC_CTX_free);

#[cfg(test)]
mod tests {
    use crate::aws_lc::BIGNUM;
    use crate::ptr::{DetachablePointer, ManagedPointer};

    #[test]
    fn test_debug() {
        let num = 100u64;
        let detachable_ptr: DetachablePointer<*mut BIGNUM> =
            DetachablePointer::try_from(num).unwrap();
        let debug = format!("{detachable_ptr:?}");
        assert!(debug.contains("DetachablePointer { pointer: Some("));

        let lc_ptr = ManagedPointer::new(detachable_ptr.detach()).unwrap();
        let debug = format!("{lc_ptr:?}");
        assert!(debug.contains("ManagedPointer { pointer:"));
    }
}

Coverage Report

Created: 2026-05-16 07:02

Line	Count	Source
1		// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
2		// SPDX-License-Identifier: Apache-2.0 OR ISC
3
4		use crate::aws_lc::{
5		BN_free, CMAC_CTX_free, ECDSA_SIG_free, EC_GROUP_free, EC_KEY_free, EC_POINT_free,
6		EVP_AEAD_CTX_free, EVP_CIPHER_CTX_free, EVP_PKEY_CTX_free, EVP_PKEY_free, OPENSSL_free,
7		RSA_free, BIGNUM, CMAC_CTX, ECDSA_SIG, EC_GROUP, EC_KEY, EC_POINT, EVP_AEAD_CTX,
8		EVP_CIPHER_CTX, EVP_PKEY, EVP_PKEY_CTX, RSA,
9		};
10		use std::marker::PhantomData;
11
12		pub(crate) type LcPtr<T> = ManagedPointer<*mut T>;
13		pub(crate) type DetachableLcPtr<T> = DetachablePointer<*mut T>;
14
15		#[derive(Debug)]
16		pub(crate) struct ManagedPointer<P: Pointer> {
17		pointer: P,
18		}
19
20		impl<P: Pointer> ManagedPointer<P> {
21		#[inline]
22	0	pub fn new<T: IntoPointer<P>>(value: T) -> Result<Self, ()> {
23	0	if let Some(pointer) = value.into_pointer() {
24	0	Ok(Self { pointer })
25		} else {
26	0	Err(())
27		}
28	0	} Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::cmac_ctx_st>>::new::<mut aws_lc_sys::universal_crypto::cmac_ctx_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::ec_point_st>>::new::<mut aws_lc_sys::universal_crypto::ec_point_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::evp_pkey_st>>::new::<mut aws_lc_sys::universal_crypto::evp_pkey_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::ecdsa_sig_st>>::new::<mut aws_lc_sys::universal_crypto::ecdsa_sig_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::evp_aead_ctx_st>>::new::<mut aws_lc_sys::universal_crypto::evp_aead_ctx_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::evp_pkey_ctx_st>>::new::<mut aws_lc_sys::universal_crypto::evp_pkey_ctx_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::evp_cipher_ctx_st>>::new::<mut aws_lc_sys::universal_crypto::evp_cipher_ctx_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::bignum_st>>::new::<mut aws_lc_sys::universal_crypto::bignum_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::ec_key_st>>::new::<mut aws_lc_sys::universal_crypto::ec_key_st> Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut u8>>::new::<mut u8>
29
30	0	pub unsafe fn as_slice(&self, len: usize) -> &[P::T] {
31	0	core::slice::from_raw_parts(self.pointer.as_const_ptr(), len)
32	0	}
33		}
34
35		impl<P: Pointer> Drop for ManagedPointer<P> {
36		#[inline]
37	0	fn drop(&mut self) {
38	0	self.pointer.free();
39	0	} Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::cmac_ctx_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::ec_point_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::evp_pkey_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::ecdsa_sig_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::evp_aead_ctx_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::evp_pkey_ctx_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::evp_cipher_ctx_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::bignum_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut aws_lc_sys::universal_crypto::ec_key_st> as core::ops::drop::Drop>::drop Unexecuted instantiation: <aws_lc_rs::ptr::ManagedPointer<mut u8> as core::ops::drop::Drop>::drop