# kxtzownsu/libcros architecture

> Architecture diagram of the GitHub repository kxtzownsu/libcros, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kxtzownsu/libcros
- Repository: https://github.com/kxtzownsu/libcros

## Overview

libcros is a Rust library exposing high-level APIs for ChromeOS device and system operations. An application uses its public API for capabilities such as cryptography, argument parsing, UI rendering, disk and filesystem access, and device information; the optional TLCL API provides TPM operations. The graph includes the major runtime modules and their documented exports, plus the sampled TPM transport and sysinfo dependencies. Several modules are represented from the source index or README rather than inspected implementation, so their internal call relationships are omitted.

Main entry points: [`src/lib.rs`](https://github.com/kxtzownsu/libcros/blob/main/src/lib.rs) (libcros API), [`src/tlcl/mod.rs`](https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/mod.rs) (TLCL API), [`src/sysinfo/mod.rs`](https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/mod.rs) (Device Information), [`src/sysinfo/backend.rs`](https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/backend.rs) (Device Backend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public APIs"]
  node_library["libcros API<br/>[lib.rs]"]
  node_crypto["Cryptography<br/>[crypto.rs]"]
  node_commands["Command Execution<br/>[execute.rs]"]
  node_arguments["Argument Parsing<br/>[libargs.rs]"]
  node_logging["Logging<br/>[logging.rs]"]
  node_cmdline["Kernel Cmdline<br/>[cmdline.rs]"]
end

subgraph group_system["System and Storage"]
  node_gpt["GPT Disks<br/>[mod.rs]"]
  node_filesystem["Filesystem APIs<br/>[mod.rs]"]
  node_syscalls["Linux Syscalls<br/>[mount.rs]"]
  node_errno["Errno Handling<br/>[errno.rs]"]
  node_loopdev["Loop Devices<br/>[loopdev.rs]"]
  node_keyval[("Key-Value Store<br/>[mod.rs]")]
  node_deviceinfo["Device Information<br/>[mod.rs]"]
  node_sysinfo_backend["Device Backend<br/>[backend.rs]"]
  node_rollback["Rollback Queries<br/>[rollback.rs]"]
  node_gsc_info["GSC Information<br/>[gsc.rs]"]
  node_vpd["VPD Integration<br/>[mod.rs]"]
end

subgraph group_security["TPM and Security"]
  node_gsc["GSC Commands<br/>[mod.rs]"]
  node_tlcl["TLCL API<br/>[mod.rs]"]
  node_tpm_client["TPM Client<br/>[client.rs]"]
  node_tpm_backend["TPM Transport<br/>[backend.rs]"]
  node_tpm_permissions["TPM Permissions<br/>[permissions.rs]"]
end

subgraph group_presentation["User Interface"]
  node_ui["TUI Rendering<br/>[menu.rs]"]
end

node_application(("Application"))

node_application -->|"uses"| node_library
node_library -->|"exports"| node_crypto
node_library -->|"exports"| node_commands
node_library -->|"exports"| node_arguments
node_library -->|"exports"| node_logging
node_library -->|"exports"| node_cmdline
node_library -->|"exports"| node_gpt
node_library -->|"exports"| node_filesystem
node_library -->|"exports"| node_syscalls
node_library -->|"exports"| node_keyval
node_library -->|"exports"| node_deviceinfo
node_library -->|"exports"| node_gsc
node_library -->|"exports"| node_ui
node_library -->|"exports"| node_vpd
node_library -->|"feature-gates"| node_tlcl
node_filesystem -.-> node_syscalls
node_deviceinfo -->|"exposes"| node_sysinfo_backend
node_deviceinfo -->|"exposes"| node_rollback
node_deviceinfo -->|"exposes"| node_gsc_info
node_sysinfo_backend -->|"reads TPM"| node_tlcl
node_sysinfo_backend -->|"stores device handle"| node_keyval
node_rollback -->|"reads TPM data"| node_tlcl
node_tlcl -->|"reads TPM path"| node_keyval
node_tlcl -->|"uses client"| node_tpm_client
node_tlcl -->|"declares transport"| node_tpm_backend
node_tlcl -->|"exposes"| node_tpm_permissions
node_tpm_client -->|"dispatches commands"| node_tlcl

click node_library "https://github.com/kxtzownsu/libcros/blob/main/src/lib.rs"
click node_crypto "https://github.com/kxtzownsu/libcros/blob/main/src/crypto.rs"
click node_commands "https://github.com/kxtzownsu/libcros/blob/main/src/execute.rs"
click node_arguments "https://github.com/kxtzownsu/libcros/blob/main/src/libargs.rs"
click node_logging "https://github.com/kxtzownsu/libcros/blob/main/src/logging.rs"
click node_cmdline "https://github.com/kxtzownsu/libcros/blob/main/src/cmdline.rs"
click node_gpt "https://github.com/kxtzownsu/libcros/blob/main/src/diskutils/gpt/disk/mod.rs"
click node_filesystem "https://github.com/kxtzownsu/libcros/blob/main/src/fs/mod.rs"
click node_syscalls "https://github.com/kxtzownsu/libcros/blob/main/src/libc/mount.rs"
click node_errno "https://github.com/kxtzownsu/libcros/blob/main/src/libc/errno.rs"
click node_loopdev "https://github.com/kxtzownsu/libcros/blob/main/src/libc/loopdev.rs"
click node_keyval "https://github.com/kxtzownsu/libcros/blob/main/src/keyval/mod.rs"
click node_deviceinfo "https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/mod.rs"
click node_sysinfo_backend "https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/backend.rs"
click node_rollback "https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/rollback.rs"
click node_gsc_info "https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/gsc.rs"
click node_gsc "https://github.com/kxtzownsu/libcros/blob/main/src/gsc/mod.rs"
click node_tlcl "https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/mod.rs"
click node_tpm_client "https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/client.rs"
click node_tpm_backend "https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/backend.rs"
click node_tpm_permissions "https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/permissions.rs"
click node_ui "https://github.com/kxtzownsu/libcros/blob/main/src/ui/menu.rs"
click node_vpd "https://github.com/kxtzownsu/libcros/blob/main/src/vpd/mod.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_library,node_crypto,node_commands,node_arguments,node_logging,node_cmdline toneBlue
class node_gpt,node_filesystem,node_syscalls,node_errno,node_loopdev,node_keyval,node_deviceinfo,node_sysinfo_backend,node_rollback,node_gsc_info,node_vpd toneAmber
class node_gsc,node_tlcl,node_tpm_client,node_tpm_backend,node_tpm_permissions toneMint
class node_ui toneRose
class node_application toneIndigo
```

## Components

### Public APIs

- [libcros API](https://github.com/kxtzownsu/libcros/blob/main/src/lib.rs): `src/lib.rs`
- [Cryptography](https://github.com/kxtzownsu/libcros/blob/main/src/crypto.rs): `src/crypto.rs`
- [Command Execution](https://github.com/kxtzownsu/libcros/blob/main/src/execute.rs): `src/execute.rs`
- [Argument Parsing](https://github.com/kxtzownsu/libcros/blob/main/src/libargs.rs): `src/libargs.rs`
- [Logging](https://github.com/kxtzownsu/libcros/blob/main/src/logging.rs): `src/logging.rs`
- [Kernel Cmdline](https://github.com/kxtzownsu/libcros/blob/main/src/cmdline.rs): `src/cmdline.rs`

### System and Storage

- [GPT Disks](https://github.com/kxtzownsu/libcros/blob/main/src/diskutils/gpt/disk/mod.rs): `src/diskutils/gpt/disk/mod.rs`
- [Filesystem APIs](https://github.com/kxtzownsu/libcros/blob/main/src/fs/mod.rs): `src/fs/mod.rs`
- [Linux Syscalls](https://github.com/kxtzownsu/libcros/blob/main/src/libc/mount.rs): `src/libc/mount.rs`
- [Errno Handling](https://github.com/kxtzownsu/libcros/blob/main/src/libc/errno.rs): `src/libc/errno.rs`
- [Loop Devices](https://github.com/kxtzownsu/libcros/blob/main/src/libc/loopdev.rs): `src/libc/loopdev.rs`
- [Key-Value Store](https://github.com/kxtzownsu/libcros/blob/main/src/keyval/mod.rs): `src/keyval/mod.rs`
- [Device Information](https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/mod.rs): `src/sysinfo/mod.rs`
- [Device Backend](https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/backend.rs): `src/sysinfo/backend.rs`
- [Rollback Queries](https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/rollback.rs): `src/sysinfo/rollback.rs`
- [GSC Information](https://github.com/kxtzownsu/libcros/blob/main/src/sysinfo/gsc.rs): `src/sysinfo/gsc.rs`
- [VPD Integration](https://github.com/kxtzownsu/libcros/blob/main/src/vpd/mod.rs): `src/vpd/mod.rs`

### TPM and Security

- [GSC Commands](https://github.com/kxtzownsu/libcros/blob/main/src/gsc/mod.rs): `src/gsc/mod.rs`
- [TLCL API](https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/mod.rs): `src/tlcl/mod.rs`
- [TPM Client](https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/client.rs): `src/tlcl/client.rs`
- [TPM Transport](https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/backend.rs): `src/tlcl/backend.rs`
- [TPM Permissions](https://github.com/kxtzownsu/libcros/blob/main/src/tlcl/permissions.rs): `src/tlcl/permissions.rs`

### User Interface

- [TUI Rendering](https://github.com/kxtzownsu/libcros/blob/main/src/ui/menu.rs): `src/ui/menu.rs`

### Other components

- **Application**

## Connections

- Application → libcros API: uses (evidence: `README.md`)
- libcros API → Cryptography: exports (evidence: `src/lib.rs`)
- libcros API → Command Execution: exports (evidence: `src/lib.rs`)
- libcros API → Argument Parsing: exports (evidence: `src/lib.rs`)
- libcros API → Logging: exports (evidence: `src/lib.rs`)
- libcros API → Kernel Cmdline: exports (evidence: `src/lib.rs`)
- libcros API → GPT Disks: exports (evidence: `src/lib.rs`)
- libcros API → Filesystem APIs: exports (evidence: `src/lib.rs`)
- libcros API → Linux Syscalls: exports (evidence: `src/lib.rs`)
- libcros API → Key-Value Store: exports (evidence: `src/lib.rs`)
- libcros API → Device Information: exports (evidence: `src/lib.rs`)
- libcros API → GSC Commands: exports (evidence: `src/lib.rs`)
- libcros API → TUI Rendering: exports (evidence: `src/lib.rs`)
- libcros API → VPD Integration: exports (evidence: `src/lib.rs`)
- libcros API → TLCL API: feature-gates (evidence: `src/lib.rs`)
- Filesystem APIs → Linux Syscalls
- Device Information → Device Backend: exposes (evidence: `src/sysinfo/mod.rs`)
- Device Information → Rollback Queries: exposes (evidence: `src/sysinfo/mod.rs`)
- Device Information → GSC Information: exposes (evidence: `src/sysinfo/mod.rs`)
- Device Backend → TLCL API: reads TPM (evidence: `src/sysinfo/backend.rs`)
- Device Backend → Key-Value Store: stores device handle (evidence: `src/sysinfo/backend.rs`)
- Rollback Queries → TLCL API: reads TPM data (evidence: `src/sysinfo/rollback.rs`)
- TLCL API → Key-Value Store: reads TPM path (evidence: `src/tlcl/mod.rs`)
- TLCL API → TPM Client: uses client (evidence: `src/tlcl/mod.rs`)
- TLCL API → TPM Transport: declares transport (evidence: `src/tlcl/mod.rs`)
- TLCL API → TPM Permissions: exposes (evidence: `src/tlcl/mod.rs`)
- TPM Client → TLCL API: dispatches commands (evidence: `src/tlcl/client.rs`)
