# soyjun/ftp-implement-based-on-udp architecture

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

- Interactive diagram: https://gitdiagram.com/soyjun/ftp-implement-based-on-udp
- Repository: https://github.com/soyjun/ftp-implement-based-on-udp

## Overview

This is a UNIX Network Programming–based UDP file-transfer client/server, with interface discovery and reliable-datagram support. The main workflow is client initialization and host/network handshake, server port handoff, file request, then sequenced transfer and client-side receipt. Server excerpts show windowed sending, acknowledgements, timeout handling, and file reads; client excerpts show reconnect, file request, and packet receipt. Interface discovery and RTT estimation are distinct supporting layers. Some source is unsampled, so uncertain internal links are omitted.

Main entry points: [`client.c`](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/client.c) (Transfer client), [`server.c`](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/server.c) (Transfer server), [`rtt.c`](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/rtt.c) (RTT estimator), [`cli_recv.c`](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/cli_recv.c) (Client receive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_endpoints["Transfer endpoints"]
  node_client["Transfer client<br/>[client.c]"]
  node_server["Transfer server<br/>[server.c]"]
  node_client_config["Client settings<br/>[client.c]"]
  node_server_config["Server settings<br/>[server.c]"]
end

subgraph group_protocol["Transfer protocol"]
  node_client_receive["Client receive<br/>[cli_recv.c]"]
  node_client_send["Client send<br/>[cli_send.c]"]
  node_server_send["Server send<br/>[serv_send.c]"]
  node_server_receive["Server receive<br/>[serv_recv.c]"]
  node_send_receive["Reliable datagrams<br/>[send_recv.c]"]
end

subgraph group_network["Network support"]
  node_interfaces["Interface discovery"]
  node_interface_types["Interface data types<br/>[unpifiplus.h]"]
  node_interface_printer["Interface printer<br/>[prifinfo_plus.c]"]
end

subgraph group_timing["Reliability timing"]
  node_rtt["RTT estimator<br/>[rtt.c]"]
  node_rtt_types["RTT data types<br/>[unprtt.h]"]
end

node_user(("Operator"))
node_requested_file["Requested file"]
node_output_file["Received file"]

node_user -->|"starts"| node_client
node_client -->|"reads settings"| node_client_config
node_server -->|"reads settings"| node_server_config
node_client -->|"handshakes"| node_server
node_client -->|"requests file"| node_server
node_server -->|"reads"| node_requested_file
node_server -->|"sends datagrams"| node_client
node_server -->|"sends packets"| node_server_send
node_server -->|"receives acknowledgements"| node_server_receive
node_client -->|"receives packets"| node_client_receive
node_client -->|"writes result"| node_output_file
node_client -.->|"sends packets"| node_client_send
node_send_receive -->|"updates timing"| node_rtt
node_client_receive -->|"uses timeout"| node_rtt
node_server -->|"uses timeout"| node_rtt
node_interfaces -->|"builds records"| node_interface_types
node_interface_printer -->|"prints results"| node_interfaces
node_rtt -->|"implements API"| node_rtt_types

click node_client "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/client.c"
click node_server "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/server.c"
click node_client_receive "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/cli_recv.c"
click node_client_send "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/cli_send.c"
click node_server_send "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/serv_send.c"
click node_server_receive "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/serv_recv.c"
click node_send_receive "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/send_recv.c"
click node_client_config "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/client.c"
click node_server_config "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/server.c"
click node_interfaces "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/get_ifi_info_plus.c"
click node_interface_types "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/unpifiplus.h"
click node_interface_printer "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/prifinfo_plus.c"
click node_rtt "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/rtt.c"
click node_rtt_types "https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/unprtt.h"

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_client,node_server,node_client_config,node_server_config toneBlue
class node_client_receive,node_client_send,node_server_send,node_server_receive,node_send_receive toneAmber
class node_interfaces,node_interface_types,node_interface_printer,node_requested_file toneMint
class node_rtt,node_rtt_types toneRose
class node_user,node_output_file toneIndigo
```

## Components

### Transfer endpoints

- [Transfer client](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/client.c): `client.c`
- [Transfer server](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/server.c): `server.c`
- [Client settings](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/client.c): `client.c`
- [Server settings](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/server.c): `server.c`

### Transfer protocol

- [Client receive](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/cli_recv.c): `cli_recv.c`
- [Client send](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/cli_send.c): `cli_send.c`
- [Server send](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/serv_send.c): `serv_send.c`
- [Server receive](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/serv_recv.c): `serv_recv.c`
- [Reliable datagrams](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/send_recv.c): `send_recv.c`

### Network support

- [Interface discovery](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/get_ifi_info_plus.c): `get_ifi_info_plus.c`
- [Interface data types](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/unpifiplus.h): `unpifiplus.h`
- [Interface printer](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/prifinfo_plus.c): `prifinfo_plus.c`

### Reliability timing

- [RTT estimator](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/rtt.c): `rtt.c`
- [RTT data types](https://github.com/soyjun/ftp-implement-based-on-udp/blob/master/unprtt.h): `unprtt.h`

### Other components

- **Operator**
- **Requested file**
- **Received file**

## Connections

- Operator → Transfer client: starts
- Transfer client → Client settings: reads settings (evidence: `client.c`)
- Transfer server → Server settings: reads settings (evidence: `server.c`)
- Transfer client → Transfer server: handshakes (evidence: `client.c`)
- Transfer client → Transfer server: requests file (evidence: `client.c`)
- Transfer server → Requested file: reads (evidence: `server.c`)
- Transfer server → Transfer client: sends datagrams (evidence: `server.c`)
- Transfer server → Server send: sends packets (evidence: `server.c`)
- Transfer server → Server receive: receives acknowledgements (evidence: `server.c`)
- Transfer client → Client receive: receives packets (evidence: `client.c`)
- Transfer client → Received file: writes result (evidence: `client.c`)
- Transfer client → Client send: sends packets
- Reliable datagrams → RTT estimator: updates timing (evidence: `send_recv.c`)
- Client receive → RTT estimator: uses timeout (evidence: `cli_recv.c`)
- Transfer server → RTT estimator: uses timeout (evidence: `server.c`)
- Interface discovery → Interface data types: builds records (evidence: `get_ifi_info_plus.c`)
- Interface printer → Interface discovery: prints results (evidence: `prifinfo_plus.c`)
- RTT estimator → RTT data types: implements API (evidence: `rtt.c`)
