# captain-coding74/linux-audit architecture

> Architecture diagram of the GitHub repository captain-coding74/linux-audit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/captain-coding74/linux-audit
- Repository: https://github.com/captain-coding74/linux-audit

## Overview

linux-audit is a small Bash system-auditing tool. The documented workflow is a user invoking `audit.sh` with optional paths and baseline files; the tool performs checks for writable files, cron persistence, UID 0 accounts, SUID files, capabilities, sudo access, and processes executing from writable directories. The README documents these checks and their inputs, but no source excerpt was provided, so relationships below reflect documentation rather than inspected implementation.

Main entry points: [`audit.sh`](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh) (Audit tool), [`suid-baseline.txt`](https://github.com/captain-coding74/linux-audit/blob/main/suid-baseline.txt) (SUID baseline), [`capabilities_baseline.txt`](https://github.com/captain-coding74/linux-audit/blob/main/capabilities_baseline.txt) (Capability baseline)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("Administrator"))
node_audit["Audit tool<br/>[audit.sh]"]
node_writable["Writable files<br/>[audit.sh]"]
node_cron["Cron persistence<br/>[audit.sh]"]
node_uid["UID 0 accounts<br/>[audit.sh]"]
node_suid["Extra SUID<br/>[audit.sh]"]
node_capabilities["Extra capabilities<br/>[audit.sh]"]
node_sudo["Sudo access<br/>[audit.sh]"]
node_processes["Writable-path processes<br/>[audit.sh]"]
node_target["Target files"]
node_cronpaths["Cron paths"]
node_passwd["Passwd file"]
node_suidpaths["SUID paths"]
node_suidbaseline["SUID baseline<br/>[suid-baseline.txt]"]
node_cappaths["Capability paths"]
node_capbaseline["Capability baseline"]
node_groupfile["Group file"]
node_sudoers["Sudoers paths"]
node_proc["Process metadata"]

node_user -->|"invokes"| node_audit
node_audit -->|"checks"| node_writable
node_audit -->|"checks"| node_cron
node_audit -->|"checks"| node_uid
node_audit -->|"checks"| node_suid
node_audit -->|"checks"| node_capabilities
node_audit -->|"checks"| node_sudo
node_audit -->|"checks"| node_processes
node_writable -->|"scans"| node_target
node_cron -->|"searches"| node_cronpaths
node_uid -->|"reads"| node_passwd
node_suid -->|"scans"| node_suidpaths
node_suid -->|"compares"| node_suidbaseline
node_capabilities -->|"scans"| node_cappaths
node_capabilities -->|"compares"| node_capbaseline
node_sudo -->|"reads"| node_groupfile
node_sudo -->|"searches"| node_sudoers
node_processes -->|"reads"| node_proc

click node_audit "https://github.com/captain-coding74/linux-audit/blob/main/audit.sh"
click node_writable "https://github.com/captain-coding74/linux-audit/blob/main/audit.sh"
click node_cron "https://github.com/captain-coding74/linux-audit/blob/main/audit.sh"
click node_uid "https://github.com/captain-coding74/linux-audit/blob/main/audit.sh"
click node_suid "https://github.com/captain-coding74/linux-audit/blob/main/audit.sh"
click node_capabilities "https://github.com/captain-coding74/linux-audit/blob/main/audit.sh"
click node_sudo "https://github.com/captain-coding74/linux-audit/blob/main/audit.sh"
click node_processes "https://github.com/captain-coding74/linux-audit/blob/main/audit.sh"
click node_suidbaseline "https://github.com/captain-coding74/linux-audit/blob/main/suid-baseline.txt"
click node_capbaseline "https://github.com/captain-coding74/linux-audit/blob/main/capabilities_baseline.txt"

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_user,node_target,node_cronpaths,node_passwd,node_suidpaths,node_cappaths,node_groupfile,node_sudoers,node_proc toneIndigo
class node_audit,node_writable,node_cron,node_uid,node_suid,node_capabilities,node_sudo,node_processes,node_suidbaseline,node_capbaseline toneTeal
```

## Components

### Other components

- **Administrator**
- [Audit tool](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh): `audit.sh`
- [Writable files](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh): `audit.sh`
- [Cron persistence](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh): `audit.sh`
- [UID 0 accounts](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh): `audit.sh`
- [Extra SUID](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh): `audit.sh`
- [Extra capabilities](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh): `audit.sh`
- [Sudo access](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh): `audit.sh`
- [Writable-path processes](https://github.com/captain-coding74/linux-audit/blob/main/audit.sh): `audit.sh`
- **Target files**
- **Cron paths**
- **Passwd file**
- **SUID paths**
- [SUID baseline](https://github.com/captain-coding74/linux-audit/blob/main/suid-baseline.txt): `suid-baseline.txt`
- **Capability paths**
- [Capability baseline](https://github.com/captain-coding74/linux-audit/blob/main/capabilities_baseline.txt): `capabilities_baseline.txt`
- **Group file**
- **Sudoers paths**
- **Process metadata**

## Connections

- Administrator → Audit tool: invokes (evidence: `README.md`)
- Audit tool → Writable files: checks (evidence: `README.md`)
- Audit tool → Cron persistence: checks (evidence: `README.md`)
- Audit tool → UID 0 accounts: checks (evidence: `README.md`)
- Audit tool → Extra SUID: checks (evidence: `README.md`)
- Audit tool → Extra capabilities: checks (evidence: `README.md`)
- Audit tool → Sudo access: checks (evidence: `README.md`)
- Audit tool → Writable-path processes: checks (evidence: `README.md`)
- Writable files → Target files: scans (evidence: `README.md`)
- Cron persistence → Cron paths: searches (evidence: `README.md`)
- UID 0 accounts → Passwd file: reads (evidence: `README.md`)
- Extra SUID → SUID paths: scans (evidence: `README.md`)
- Extra SUID → SUID baseline: compares (evidence: `README.md`)
- Extra capabilities → Capability paths: scans (evidence: `README.md`)
- Extra capabilities → Capability baseline: compares (evidence: `README.md`)
- Sudo access → Group file: reads (evidence: `README.md`)
- Sudo access → Sudoers paths: searches (evidence: `README.md`)
- Writable-path processes → Process metadata: reads (evidence: `README.md`)
