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}