inputd is the normalized input routing service.
  • Rust 98.9%
  • Linker Script 1.1%
Find a file
Erik Inkinen c3ed0ef1e1
All checks were successful
CI / markdown (push) Successful in 4s
CI / test (push) Successful in 17s
Tighten CI markdown policy
2026-05-22 15:10:03 +03:00
.github Tighten CI markdown policy 2026-05-22 15:10:03 +03:00
src Test inputd deviced peer misroute rejection 2026-04-21 11:41:40 +03:00
.editorconfig Initial commit 2026-03-11 10:15:11 +01:00
.gitignore Ignore local .ci workspace 2026-04-15 21:52:42 +03:00
.markdownlint-cli2.yaml Tighten CI markdown policy 2026-05-22 15:10:03 +03:00
ARCHITECTURE.md Tighten CI markdown policy 2026-05-22 15:10:03 +03:00
Cargo.toml Point inputd git dependencies at main branch 2026-04-22 04:55:18 +03:00
CODE_OF_CONDUCT.md Tighten CI markdown policy 2026-05-22 15:10:03 +03:00
CONTRIBUTING.md Tighten CI markdown policy 2026-05-22 15:10:03 +03:00
LICENSE Initial commit 2026-03-11 10:15:11 +01:00
linker.ld Keep stack reserve pages in runtime images 2026-04-24 08:31:32 +03:00
README.md Tighten CI markdown policy 2026-05-22 15:10:03 +03:00
ROADMAP.md Tighten CI markdown policy 2026-05-22 15:10:03 +03:00
rustfmt.toml inputd: drop unstable rustfmt options for stable toolchains 2026-03-23 10:19:52 +02:00
SECURITY.md Tighten CI markdown policy 2026-05-22 15:10:03 +03:00

inputd

inputd is the normalized input routing service.

EriX is a clean-room, capability-based microkernel operating system written entirely in Rust.

Technical requirements are tracked in the EriX requirements, conventions, and project documentation.

See:

  • docs for design documents, specifications, and development plans.
  • Related architecture repositories for kernel, services, libraries, drivers, and integration tooling.

Purpose of This Repository

This repository implements the EriX input service daemon. Its purpose in EriX is to provide the input service role through explicit IPC and startup authority.

Functionally, it implements the daemon runtime, state model, IPC handling, and validation tests. The repository keeps the implementation, interface contracts, tests, and documentation for that behavior in one reviewable ownership boundary.

The maintained responsibilities are:

  • implement the input service runtime and state model
  • validate startup authority before accepting IPC requests
  • handle bounded service operations through the assigned endpoint set
  • keep service behavior, tests, and authority invariants documented

Clean-Room Policy

EriX follows a strict clean-room philosophy:

  • No external source code may be copied.
  • No external Rust crates are allowed.
  • No code generation tools that embed third-party code.
  • All code must be authored within the project.

Violations will result in rejection of the contribution.

License

All EriX repositories are licensed under the ISC License.

Development Model

EriX development is modular, deterministic, reproducible, authority-explicit, security-first, and self-hosting oriented.

This repository follows the project roadmap and the validation rules documented in its own roadmap.

Feature flags

  • inputd-runtime
  • inputd-runtime-phase3-input
  • compatibility aliases:
    • inputd-integration-smoke
    • inputd-integration-phase3-input
  • inputd-integration-force-fail

Build and test

cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-targets --all-features

Dependencies

  • lib-bootstrap
  • lib-capabi
  • lib-ipc
  • lib-service
  • ipc-syscall-x86_64

No third-party crates are used.

The startup contract logic now lives in src/startup.rs, keeping the main event-loop implementation in src/main.rs below 1 kLoC.

Governance Principles

inputd governance is scoped to input event aggregation and dispatch.

The scoped governance rules are:

  • It accepts input events only from authorized driver/provider endpoints.
  • It keeps event queues bounded and preserves ordering expected by consumers.
  • It separates input routing policy from device-specific driver behavior.
  • It does not manage driver processes or hardware ownership.

Authority Boundaries

  • inputd operates only through startup-assigned service capabilities.
  • New authority must be represented in bootstrap/capability validation and integration tests before use.

Contact

Development occurs in EriX organization and discussions happen in issues and design documents.

No decisions are considered valid without documented rationale.

Maintainers can be reached via email: admin@erikinkinen.fi.