Skip to main content

nautilus_plugin/
host.rs

1// -------------------------------------------------------------------------------------------------
2//  Copyright (C) 2015-2026 Nautech Systems Pty Ltd. All rights reserved.
3//  https://nautechsystems.io
4//
5//  Licensed under the GNU Lesser General Public License Version 3.0 (the "License");
6//  You may not use this file except in compliance with the License.
7//  You may obtain a copy of the License at https://www.gnu.org/licenses/lgpl-3.0.en.html
8//
9//  Unless required by applicable law or agreed to in writing, software
10//  distributed under the License is distributed on an "AS IS" BASIS,
11//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12//  See the License for the specific language governing permissions and
13//  limitations under the License.
14// -------------------------------------------------------------------------------------------------
15
16//! Opaque host-side ABI tokens.
17//!
18//! The public `nautilus-plugin` crate supplies the token types used to declare
19//! the plug-in init symbol while the host implementation remains an internal
20//! Nautilus deployment detail.
21
22/// Opaque host service table supplied by the host implementation.
23#[repr(C)]
24#[derive(Debug)]
25pub struct HostVTable {
26    _opaque: [u8; 0],
27}
28
29/// Opaque per-instance host context supplied by the host implementation.
30#[repr(C)]
31#[derive(Debug)]
32pub struct HostContext {
33    _opaque: [u8; 0],
34}
35
36#[cfg(test)]
37mod tests {
38    use core::mem::{align_of, size_of};
39
40    use rstest::rstest;
41
42    use super::*;
43
44    #[rstest]
45    fn host_vtable_is_opaque_zero_sized_token() {
46        assert_eq!(size_of::<HostVTable>(), 0);
47        assert_eq!(align_of::<HostVTable>(), 1);
48    }
49
50    #[rstest]
51    fn host_context_is_opaque_zero_sized_token() {
52        assert_eq!(size_of::<HostContext>(), 0);
53        assert_eq!(align_of::<HostContext>(), 1);
54    }
55}