How hassaanmasood-051/server-client-project works
This repository implements a time-travel debugger: a user starts a debugging session for source code, the client uploads it through a load balancer, and a server produces a trace file that the client reads locally for stepping and inspection. The server includes source resolution, binary conversion, execution, snapshot/timeline handling, and trace serialization; the load balancer queues and relays requests and can wake the server. The README is empty, and some server orchestration is outside the excerpts, so those links are marked unverified rather than asserted.
Main entry points: client.cpp Trace request and download · load_balancer.cpp Stream relay · server.cpp Request handling · helper.h Checksum and trailer
Components 20
Debugger client
- Command interface
client.cpp - Session and navigation
client.cpp - Trace request and download
client.cpp - Trace file reader
client.cpp - Snapshot display
client.cpp
Request routing
- Connection acceptor
load_balancer.cpp - Pending client queue
load_balancer.cpp - Request dispatcher
load_balancer.cpp - Server wakeup
load_balancer.cpp - Stream relay
load_balancer.cpp
Trace server
- Request handling
server.cpp - Source resolver
server.cpp - Binary converter
server.cpp - Program executor
server.cpp - Snapshot timeline
server.cpp - Trace serializer
server.cpp
Shared protocol
- Checksum and trailer
helper.h
Other components
- Debugger user
- Source program
- Downloaded trace
Connections 26
- Debugger user → Command interface: enters commands
client.cpp - Command interface → Session and navigation: dispatches commands
client.cpp - Session and navigation → Trace request and download: starts trace request
client.cpp - Trace request and download → Connection acceptor: uploads source
client.cpp - Source program → Trace request and download: provides source
client.cpp - Connection acceptor → Pending client queue: enqueues clients
load_balancer.cpp - Request dispatcher → Pending client queue: dequeues clients
load_balancer.cpp - Request dispatcher → Server wakeup: ensures server
load_balancer.cpp - Request dispatcher → Stream relay: serves client
load_balancer.cpp - Server wakeup → Request handling: connects or starts
load_balancer.cpp - Stream relay → Request handling: forwards request
load_balancer.cpp - Request handling → Source resolver: processes source
server.cpp - Source resolver → Binary converter: prepares resolved code
server.cpp - Binary converter → Program executor: provides executable code
server.cpp - Program executor → Snapshot timeline: records snapshots
server.cpp - Snapshot timeline → Trace serializer: supplies snapshots
server.cpp - Trace serializer → Stream relay: returns trace
- Stream relay → Trace request and download: relays response
load_balancer.cpp - Trace request and download → Downloaded trace: saves download
client.cpp - Session and navigation → Trace file reader: opens trace
client.cpp - Session and navigation → Trace file reader: reads selected step
client.cpp - Trace file reader → Snapshot display: returns snapshot
client.cpp - Snapshot display → Debugger user: shows program state
- Trace request and download → Checksum and trailer: checks transfer
client.cpp - Stream relay → Checksum and trailer: checks forwarded stream
load_balancer.cpp - Request handling → Checksum and trailer: validates received data
server.cpp