1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

// Copyright 2020 Contributors to the Parsec project.
// SPDX-License-Identifier: Apache-2.0

//! # PSA Cryptography API Wrapper
//!
//! This crate provides abstraction over an implementation of the PSA Cryptography API.
//! Please check the API
//! [here](https://developer.arm.com/architectures/security-architectures/platform-security-architecture/documentation)
//! for a more complete description of operations and types.
//! This abstraction is built on top of the `psa-crypto-sys` crate.

#![cfg_attr(feature = "no-std", no_std)]
#![deny(
    nonstandard_style,
    const_err,
    dead_code,
    improper_ctypes,
    non_shorthand_field_patterns,
    no_mangle_generic_items,
    overflowing_literals,
    path_statements,
    patterns_in_fns_without_body,
    private_in_public,
    unconditional_recursion,
    unused,
    unused_allocation,
    unused_comparisons,
    unused_parens,
    while_true,
    missing_debug_implementations,
    missing_docs,
    // The following ling is triggered when casting a reference to a raw pointer.
    //trivial_casts,
    trivial_numeric_casts,
    unused_extern_crates,
    unused_import_braces,
    unused_qualifications,
    unused_results,
    missing_copy_implementations
)]
// This one is hard to avoid.
#![allow(clippy::multiple_crate_versions)]

#[cfg(feature = "operations")]
pub mod operations;
pub mod types;

pub use psa_crypto_sys as ffi;

#[cfg(feature = "operations")]
use core::sync::atomic::{AtomicBool, Ordering};
#[cfg(feature = "operations")]
use types::status::{Error, Result, Status};

#[cfg(feature = "operations")]
static INITIALISED: AtomicBool = AtomicBool::new(false);

/// Initialize the PSA Crypto library
///
/// Applications must call this function before calling any other function in crate.
/// Applications are permitted to call this function more than once. Once a call succeeds,
/// subsequent calls are guaranteed to succeed.
///
///
/// # Example
///
/// ```rust
/// use psa_crypto::init;
/// init().unwrap();
/// // Can be called twice
/// init().unwrap();
/// ```
#[cfg(feature = "operations")]
pub fn init() -> Result<()> {
    // It is not a problem to call psa_crypto_init more than once.
    Status::from(unsafe { psa_crypto_sys::psa_crypto_init() }).to_result()?;
    let _ = INITIALISED.store(true, Ordering::Relaxed);

    Ok(())
}

/// Check if the PSA Crypto library has been initialized
///
/// Example
///
/// ```
/// use psa_crypto::{initialized, init};
/// init().unwrap();
/// initialized().unwrap();
/// ```
#[cfg(feature = "operations")]
pub fn initialized() -> Result<()> {
    if INITIALISED.load(Ordering::Relaxed) {
        Ok(())
    } else {
        Err(Error::BadState)
    }
}