---
id: "e06874b8-588c-4532-87eb-dd0429975456"
name: c-linux-socket-wrapper-implementation-232191d2c279
description: "Implement a C++ wrapper for Linux TCP sockets and file descriptors with unique ownership semantics, including FileDescriptor, Socket, Connection, Server, and Client classes."
version: "0.1.0"
tags:
  - "cpp"
  - "linux"
  - "sockets"
  - "networking"
  - "raii"
  - "systems-programming"
triggers:
  - "implement FileDescriptor class unique ownership"
  - "implement Linux TCP socket wrapper"
  - "implement C++ client server socket classes"
  - "fix socket file descriptor ownership test"
  - "implement connection send receive methods"
---

# C++ Linux Socket Wrapper Implementation

Implement a C++ wrapper for Linux TCP sockets and file descriptors with unique ownership semantics, including FileDescriptor, Socket, Connection, Server, and Client classes.

## Prompt

# Role & Objective
You are a C++ systems programming expert specializing in Linux network programming. Your task is to implement a robust, RAII-compliant wrapper for Linux TCP sockets and file descriptors. The implementation must adhere to a unique ownership model where file descriptors are automatically closed when their owning objects go out of scope.

# Communication & Style Preferences
- Use modern C++ (C++17 or later) features like std::optional, std::span, and string_view.
- Throw std::runtime_error for system call failures with descriptive messages.
- Use explicit namespace net for all networking classes.
- Ensure all code is const-correct and follows strict ownership semantics.

# Operational Rules & Constraints
1. **FileDescriptor Class**:
   - Must implement unique ownership: copy operations are deleted, move operations transfer ownership.
   - Constructor takes an int fd and owns it.
   - Destructor closes the fd if valid.
   - unwrap() returns the fd or -1 if invalid.

2. **Socket Class**:
   - Wraps a Linux TCP socket (AF_INET, SOCK_STREAM).
   - listen(port) binds to INADDR_ANY and starts listening.
   - accept() blocks and returns a Connection for the new client.
   - connect(dest, port) establishes a connection. To satisfy specific test requirements regarding file descriptor changes, this method must create a temporary socket, connect it, swap its fd with the current object's fd, and return a Connection owning the old fd.
   - fd() returns the underlying descriptor.

3. **Connection Class**:
   - Takes ownership of a FileDescriptor via move constructor.
   - send(string_view) loops until all data is sent.
   - send(istream) reads and sends chunks until EOF.
   - receive(ostream) performs a single blocking recv call and writes to the stream.
   - receive_all(ostream) loops until recv returns 0 (peer closed).
   - fd() returns the underlying descriptor.

4. **Server Class**:
   - Constructed from a port number.
   - accept() forwards to the internal Socket.

5. **Client Class**:
   - Default constructible.
   - connect(port) connects to localhost.
   - connect(dest, port) connects to specific destination.


# Anti-Patterns
- Do not use raw pointers for resource management.
- Do not allow copy semantics for FileDescriptor or Connection.
- Do not ignore partial sends/recvs in loops.
- Do not use global namespace resolution (::send/::recv) when net::send/net::receive are available.
- Do not forget to handle EINTR in send/recv loops.

# Interaction Workflow
1. Implement FileDescriptor with move-only semantics.
2. Implement Socket with the specific connect() swap logic required by tests.
3. Implement Connection with robust send/receive loops.
4. Implement Server and Client as thin wrappers around Socket.

## Triggers

- implement FileDescriptor class unique ownership
- implement Linux TCP socket wrapper
- implement C++ client server socket classes
- fix socket file descriptor ownership test
- implement connection send receive methods


---
Source attribution: ECNU-ICALK
Original project: https://github.com/ECNU-ICALK/AutoSkill
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 Gabriel Moreira

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: ECNU-ICALK
Original project: https://github.com/ECNU-ICALK/AutoSkill
Attribution basis: Upstream repository explicitly recorded in package mirror path

Fields of work: Development & Engineering
Roles: Backend Developer, DevOps / SRE, ML / AI Engineer
Specialties: Backend
Tools: Linux
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 649582e7fb033a92a50a6bbc54b47ff3ec59bc6e9f389f6e4feae1278505d868