aboutsummaryrefslogtreecommitdiff
path: root/rust/minijail-sys/lib.rs
diff options
context:
space:
mode:
Diffstat (limited to 'rust/minijail-sys/lib.rs')
-rw-r--r--rust/minijail-sys/lib.rs42
1 files changed, 42 insertions, 0 deletions
diff --git a/rust/minijail-sys/lib.rs b/rust/minijail-sys/lib.rs
new file mode 100644
index 0000000..59db51e
--- /dev/null
+++ b/rust/minijail-sys/lib.rs
@@ -0,0 +1,42 @@
+// Copyright 2019 The Chromium OS Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+/// libminijail bindings for Rust.
+
+// TODO(crbug.com/1032672): Generate bindings at build time.
+//
+// Bindgen will invoke the C preprocessor to process headers, which means that the bindings
+// generated can depend on the architecture that actually ran bindgen. In particular, for
+// portability across compilers glibc defines types like __u8 and __rlim64_t in terms of C types
+// like unsigned char and unsigned long. This is problematic for __rlim64_t since that resolves to
+// unsigned long int on amd64, which will end up being 32-bit on 32-bit platforms.
+//
+// As a workaround to let us commit these bindings and still use them on 32-bit platforms, the
+// bindgen invocation blocklists some of the generated fixed-width types and redefines them
+// manually as Rust fixed-width types.
+//
+// Generated in CrOS SDK chroot with:
+// bindgen --default-enum-style rust \
+// --blacklist-type '__rlim64_t' \
+// --raw-line 'pub type __rlim64_t = u64;' \
+// --blacklist-type '__u\d{1,2}' \
+// --raw-line 'pub type __u8 = u8;' \
+// --raw-line 'pub type __u16 = u16;' \
+// --raw-line 'pub type __u32 = u32;' \
+// --blacklist-type '__uint64_t' \
+// --whitelist-function '^minijail_.*' \
+// --whitelist-var '^MINIJAIL_.*' \
+// --no-layout-tests \
+// --output libminijail.rs \
+// libminijail.h -- \
+// -DUSE_BINDGEN \
+// -D_FILE_OFFSET_BITS=64 \
+// -D_LARGEFILE_SOURCE \
+// -D_LARGEFILE64_SOURCE
+//
+// Enum variants in rust are customarily camel case, but bindgen will leave the original names
+// intact.
+#[allow(non_camel_case_types)]
+mod libminijail;
+pub use crate::libminijail::*;