rucc_session/
runtime.rs

1//! The headers the compiler ships, and the directory they appear to live in.
2//!
3//! Design: `spec/04-driver-and-cli.md` section 4.4.
4//!
5//! A hosted C implementation is two halves. The library ships `<stdio.h>` and everything that
6//! declares a function you link against. The compiler ships the handful of headers whose
7//! contents are not the library's to know: `<stdarg.h>` is the target's calling convention,
8//! `<limits.h>` and `<float.h>` are the target's types, and `<stddef.h>` is the ABI. No
9//! library can write those, which is why every compiler carries its own copies and why a
10//! compiler that carries none cannot preprocess a program as ordinary as SQLite.
11//!
12//! They are in the binary rather than on disk. A compiler that has to find its own
13//! installation directory before it can preprocess a file is a compiler that stops working
14//! when it is copied somewhere else, and a single static binary that works from anywhere is
15//! worth more here than the ability to edit a header without rebuilding.
16//!
17//! Since they are not on disk they need a name, because the search path is a list of
18//! directories and a diagnostic has to be able to say where a header came from. That name is
19//! [`DIR`], and the angle brackets are the point: no directory a user can create is spelled
20//! that way, so nothing on the real file system can shadow these or be shadowed by them.
21
22use std::path::Path;
23
24use rucc_diag::SourceBytes;
25
26/// The directory the shipped headers appear to be in.
27///
28/// Not a path. It is a name that cannot be one, so that `#include <stdarg.h>` resolving to
29/// `<builtin>/stdarg.h` reads as what it is, and so that a real directory can never collide
30/// with it.
31pub const DIR: &str = "<builtin>";
32
33/// Every shipped header, in the order they are listed here, which is sorted by name.
34///
35/// The text is in the binary. `include_str!` rather than a build script because the set is
36/// small and fixed, and because a build script would put the headers behind a step that has
37/// to run before anything can be read.
38const HEADERS: &[(&str, &str)] = &[
39    ("arm_neon.h", include_str!("../runtime/include/arm_neon.h")),
40    ("avx512bwintrin.h", include_str!("../runtime/include/avx512bwintrin.h")),
41    ("avx512fintrin.h", include_str!("../runtime/include/avx512fintrin.h")),
42    ("avx512vlintrin.h", include_str!("../runtime/include/avx512vlintrin.h")),
43    ("avx512vpopcntdqintrin.h", include_str!("../runtime/include/avx512vpopcntdqintrin.h")),
44    ("cpuid.h", include_str!("../runtime/include/cpuid.h")),
45    ("emmintrin.h", include_str!("../runtime/include/emmintrin.h")),
46    ("float.h", include_str!("../runtime/include/float.h")),
47    ("immintrin.h", include_str!("../runtime/include/immintrin.h")),
48    ("iso646.h", include_str!("../runtime/include/iso646.h")),
49    ("limits.h", include_str!("../runtime/include/limits.h")),
50    ("mm_malloc.h", include_str!("../runtime/include/mm_malloc.h")),
51    ("mmintrin.h", include_str!("../runtime/include/mmintrin.h")),
52    ("nmmintrin.h", include_str!("../runtime/include/nmmintrin.h")),
53    ("pmmintrin.h", include_str!("../runtime/include/pmmintrin.h")),
54    ("popcntintrin.h", include_str!("../runtime/include/popcntintrin.h")),
55    ("smmintrin.h", include_str!("../runtime/include/smmintrin.h")),
56    ("stdalign.h", include_str!("../runtime/include/stdalign.h")),
57    ("stdarg.h", include_str!("../runtime/include/stdarg.h")),
58    ("stdatomic.h", include_str!("../runtime/include/stdatomic.h")),
59    ("stdbool.h", include_str!("../runtime/include/stdbool.h")),
60    ("stddef.h", include_str!("../runtime/include/stddef.h")),
61    ("stdint.h", include_str!("../runtime/include/stdint.h")),
62    ("stdnoreturn.h", include_str!("../runtime/include/stdnoreturn.h")),
63    ("tmmintrin.h", include_str!("../runtime/include/tmmintrin.h")),
64    ("vpclmulqdqintrin.h", include_str!("../runtime/include/vpclmulqdqintrin.h")),
65    ("x86intrin.h", include_str!("../runtime/include/x86intrin.h")),
66    ("xmmintrin.h", include_str!("../runtime/include/xmmintrin.h")),
67    ("xsaveintrin.h", include_str!("../runtime/include/xsaveintrin.h")),
68];
69
70/// The names of the shipped headers, sorted.
71#[must_use]
72pub fn names() -> Vec<&'static str> {
73    HEADERS.iter().map(|&(name, _)| name).collect()
74}
75
76/// The text of one shipped header, by its name alone.
77#[must_use]
78pub fn header(name: &str) -> Option<&'static str> {
79    HEADERS.iter().find(|&&(have, _)| have == name).map(|&(_, text)| text)
80}
81
82/// Reads a path that an include search produced, when it names a shipped header.
83///
84/// The path is [`DIR`] joined with the header's name, which on Windows means a backslash
85/// between them, so the two halves are compared rather than the string.
86#[must_use]
87pub fn read(path: &Path) -> Option<SourceBytes> {
88    if path.parent() != Some(Path::new(DIR)) {
89        return None;
90    }
91    let name = path.file_name()?.to_str()?;
92    header(name).map(SourceBytes::new)
93}
94
95#[cfg(test)]
96mod tests {
97    use std::path::PathBuf;
98
99    use super::*;
100
101    #[test]
102    fn the_shipped_headers_are_read_by_the_name_the_search_path_builds() {
103        let path = PathBuf::from(DIR).join("stdarg.h");
104        let bytes = read(&path).expect("stdarg.h is shipped");
105        let text = String::from_utf8(bytes.as_ref().to_vec()).expect("utf-8");
106        assert!(text.contains("__builtin_va_list"));
107    }
108
109    #[test]
110    fn nothing_outside_the_builtin_directory_is_answered() {
111        assert!(read(Path::new("/usr/include/stdarg.h")).is_none());
112        assert!(read(Path::new("stdarg.h")).is_none());
113        assert!(read(&PathBuf::from(DIR).join("stdio.h")).is_none());
114        assert!(read(&PathBuf::from(DIR).join("sys").join("stdarg.h")).is_none());
115    }
116
117    #[test]
118    fn the_list_is_sorted_so_that_a_new_header_has_one_place_to_go() {
119        let mut sorted = names();
120        sorted.sort_unstable();
121        assert_eq!(names(), sorted);
122    }
123
124    /// Every header has to be idempotent and has to name itself in its own guard, because a
125    /// program includes `<stddef.h>` forty times and a guard copied from a neighbour is the
126    /// way one of them silently stops working.
127    #[test]
128    fn every_header_guards_itself_under_its_own_name() {
129        for &(name, text) in HEADERS {
130            let guard = format!("__RUCC_{}", name.trim_end_matches(".h").to_uppercase());
131            assert!(text.contains(&guard), "{name} does not mention {guard}");
132        }
133    }
134}
rucc_session/runtime.rs

rucc_session/
runtime.rs
