Quelle  lib.rs

/*
 * Copyright (C) 2025 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.
 */

//! trusty_peer_id bindings
//!
//! Allows Rust to interact with trusty_peer_id and any ID types it might contain (like uuid).

#![no_std]

mod peer_id_impl;
mod uuid_impl;

#[cfg(feature = "userspace")]
mod userspace;

#[allow(non_camel_case_types)]
#[allow(non_upper_case_globals)]
mod sys {
    include!(env!("BINDGEN_INC_FILE"));
}

pub use sys::{
    trusty_peer_id, trusty_peer_id_kind_t, trusty_peer_id_sized, trusty_peer_id_storage,
    trusty_peer_id_uuid, trusty_peer_id_uuid_sized, trusty_peer_id_vmid_ffa,
    trusty_peer_id_vmid_ffa_sized, uuid, uuid_t, TRUSTY_PEER_ID_KIND_FIRST_USERSPACE_AVAILABLE,
    TRUSTY_PEER_ID_KIND_INVALID, TRUSTY_PEER_ID_KIND_UUID, TRUSTY_PEER_ID_KIND_VMID_FFA,
    UUID_STR_SIZE,
};

pub use peer_id_impl::{
    AsConcreteError, TrustyPeerId, TrustyPeerIdExt, TrustyPeerIdRef, TrustyPeerIdStorageSized,
};

pub use uuid_impl::{Uuid, UuidFromBytesError, UuidFromStrError};

#[cfg(feature = "userspace")]
pub use userspace::PeerIdIterator;

// Safety:
//   * Prefix - Guaranteed by C implementation/bindgen.
//   * No Padding - Guaranteed by C implementation.
//   * len Impl - Self has statically know size.
//   * Distinct KIND - Guaranteed by C implementation.
//   * KIND Range - Guaranteed by C implementation.
unsafe impl crate::TrustyPeerId for trusty_peer_id_uuid {
    const KIND: trusty_peer_id_kind_t = TRUSTY_PEER_ID_KIND_UUID;

    // # Safety
    //   Always safe.
    unsafe fn len(_data: *const u8) -> usize {
        core::mem::size_of::<Self>()
    }
}

// Safety:
//   * Prefix - Guaranteed by C implementation/bindgen.
//   * No Padding - Guaranteed by C implementation.
//   * len Impl - Self has statically know size.
//   * Distinct KIND - Guaranteed by C implementation.
//   * KIND Range - Guaranteed by C implementation.
unsafe impl crate::TrustyPeerId for trusty_peer_id_vmid_ffa {
    const KIND: trusty_peer_id_kind_t = TRUSTY_PEER_ID_KIND_VMID_FFA;

    // # Safety
    //   Always safe.
    unsafe fn len(_data: *const u8) -> usize {
        core::mem::size_of::<Self>()
    }
}