# jesuserr/42cursus_ft_ping architecture

> Architecture diagram of the GitHub repository jesuserr/42cursus_ft_ping, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jesuserr/42cursus_ft_ping
- Repository: https://github.com/jesuserr/42cursus_ft_ping

## Overview

##### Project type and purpose
- This is a monolithic, system-level CLI application written in C. It recodes the Unix “ping” command by sending ICMP Echo requests and processing Echo replies over raw sockets.
- Key artifacts:
- srcs/ – all C source modules (main.c, ft_ping.c, parser.c, messages.c, signals.c)
- libft/ – a utility library (string helpers, I/O wrappers, etc.)
- subject/ – project specification PDF
- Makefile, .gitmodules – build and submodule configuration

##### File structure
- Top level:
- Makefile – orchestrates compile/link steps, pulls in libft
- .gitmodules – references the libft submodule
- srcs/:
- main.c      – entry point, high-level control loop
- parser.c    – parses command-line arguments into an options struct
- ft_ping.c   – core ping logic (initialization, send/receive loop)
- messages.c  – formatting output lines, error texts
- signals.c   – installs signal handlers (SIGINT, alarms)
- ft_ping.h   – shared definitions and structs
- libft/: reused general-purpose functions (memory, strings, I/O)

##### README for additional insights
- README states only the project summary (“recoding the ping command”), confirming the intended behavior matches POSIX ping.

##### Detail
- Timing interactions (alarms triggering every second)
- Clean-up logic on SIGINT (printing summary, closing socket)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Core Application Modules
    subgraph "Core Application Modules"
        subgraph "CLI / User Interface"
            Main["main.c"]:::core
            Parser["parser.c"]:::core
        end
        ControlLoop["Control Loop"]:::core
        subgraph "ICMP Engine"
            PacketBuilder["Packet Builder"]:::core
            PacketReader["Packet Reader"]:::core
        end
        SocketMgr["Socket Manager"]:::core
        SignalMgr["Signal Manager"]:::core
        Stats["Statistics & Output"]:::core
        Shared["Shared Definitions & Data Structures (ft_ping.h)"]:::core
    end

    %% Utilities & Third-Party
    subgraph "Utilities & Third-Party"
        Utils["Utilities Library (libft)"]:::util
    end

    %% Build & Config
    subgraph "Build & Configuration"
        Makefile["Makefile"]:::config
        Gitmodules[".gitmodules"]:::config
    end

    Spec["Project Specification (subject/en.subject.pdf)"]:::config

    %% External Systems
    subgraph "External Systems"
        OSStack["OS Network Stack"]:::external
        DNS["DNS Resolver"]:::external
    end

    %% Connections
    Main --> Parser
    Parser --> ControlLoop
    ControlLoop --> PacketBuilder
    ControlLoop --> PacketReader
    PacketBuilder --> SocketMgr
    PacketReader --> SocketMgr
    SocketMgr --> OSStack
    PacketBuilder --> DNS
    ControlLoop <-- SignalMgr
    ControlLoop --> Stats
    ControlLoop --> Shared

    Utils --> Main
    Utils --> Parser
    Utils --> PacketBuilder
    Utils --> PacketReader
    Utils --> SocketMgr
    Utils --> SignalMgr
    Utils --> Stats
    Utils --> Shared

    %% Click Events
    click Main "https://github.com/jesuserr/42cursus_ft_ping/blob/main/srcs/main.c"
    click Parser "https://github.com/jesuserr/42cursus_ft_ping/blob/main/srcs/parser.c"
    click PacketBuilder "https://github.com/jesuserr/42cursus_ft_ping/blob/main/srcs/ft_ping.c"
    click PacketReader "https://github.com/jesuserr/42cursus_ft_ping/blob/main/srcs/ft_ping.c"
    click SocketMgr "https://github.com/jesuserr/42cursus_ft_ping/blob/main/srcs/ft_ping.c"
    click SignalMgr "https://github.com/jesuserr/42cursus_ft_ping/blob/main/srcs/signals.c"
    click Stats "https://github.com/jesuserr/42cursus_ft_ping/blob/main/srcs/messages.c"
    click Shared "https://github.com/jesuserr/42cursus_ft_ping/blob/main/srcs/ft_ping.h"
    click Utils "https://github.com/jesuserr/42cursus_ft_ping/tree/main/libft/"
    click Makefile "https://github.com/jesuserr/42cursus_ft_ping/tree/main/Makefile"
    click Gitmodules "https://github.com/jesuserr/42cursus_ft_ping/blob/main/.gitmodules"
    click Spec "https://github.com/jesuserr/42cursus_ft_ping/blob/main/subject/en.subject.pdf"

    %% Styles
    classDef core fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef util fill:#90EE90,stroke:#000,stroke-width:1px
    classDef external fill:#FFA500,stroke:#000,stroke-width:1px
    classDef config fill:#D3D3D3,stroke:#000,stroke-width:1px
```
