CLAUDE.md

CLAUDE.md

本文件为 Claude Code (claude.ai/code) 在此仓库中工作时提供指导。

概述

这是《TCP/IP 网络编程》一书的学习笔记仓库，包含按章节组织的 Markdown 笔记和配套的 C 语言示例代码，演示套接字编程的核心概念。

开发环境：Ubuntu 18.04 LTS，gcc 7.3.0

仓库地址：https://github.com/riba2534/TCP-IP-NetworkNote

目录结构

ch01/    - 第 1 章：理解网络编程和套接字
ch02/    - 第 2 章：套接字类型与协议设置
ch03/    - 第 3 章：地址族与数据序列
ch04/    - 第 4 章：基于 TCP 的服务端/客户端（1）
ch05/    - 第 5 章：基于 TCP 的服务端/客户端（2）
ch06/    - 第 6 章：基于 UDP 的服务端/客户端
ch07/    - 第 7 章：优雅地断开套接字的连接
ch08/    - 第 8 章：域名及网络地址
ch09/    - 第 9 章：套接字的各种选项
ch10/    - 第 10 章：多进程服务器端
ch11/    - 第 11 章：进程间通信
ch12/    - 第 12 章：I/O 复用
ch13/    - 第 13 章：I/O 复用（2）
ch14/    - 第 14 章：多播与广播
ch15/    - 第 15 章：套接字和标准 I/O
ch16/    - 第 16 章：关于 I/O 流分离的其他内容
ch17/    - 第 17 章：优于 select 的 epoll
ch18/    - 第 18 章：多线程服务器端的实现
ch24/    - 第 24 章：制作 HTTP 服务器端

每个章节目录包含：

• README.md - 章节笔记（理论 + 习题）
• .c 文件 - 示例代码

项目根目录包含：

• images/ - 所有章节的图片资源（统一存放）

编译和运行

所有示例都是独立的 C 程序，使用 gcc 编译：

# 编译服务端示例
gcc hello_server.c -o hserver

# 编译客户端示例
gcc hello_client.c -o hclient

# 运行服务端（需要端口号参数）
./hserver 9190

# 运行客户端（需要 IP 地址和端口号）
./hclient 127.0.0.1 9190

多线程示例（第 18 章）需要链接 pthread 库：

gcc thread1.c -o tr1 -lpthread

内容规范

修改此仓库内容时需注意：

1. 专注于 Linux 平台：本仓库专门讲解 Linux 套接字编程。Windows 平台相关内容标记为"暂略"。

2. 保持中文术语一致性：

   • IPv4/IPv6（不要用 IPV4/IPV6）
   • "接收"（receive）不要写成"接受"
   • "连接"（connection）不要写成"链接"

3. 章节更新流程：根目录 README.md 包含所有 19 个章节的合并内容。更新内容时，先修改子目录中对应章节的 README.md，然后合并到根 README.md。

4. 代码引用格式：引用示例代码时使用相对路径，不加章节前缀（例如用 [hello_server.c](hello_server.c) 而不是 [hello_server.c](ch01/hello_server.c)）。

5. 图片引用格式：所有图片统一存放在根目录 images/ 下。在 README.md 中引用图片时使用统一路径 images/文件名.png（无论是根目录还是子目录的 README.md）。

涵盖的核心套接字编程概念

• TCP vs UDP：面向连接（SOCK_STREAM）vs 无连接（SOCK_DGRAM）
• 服务端生命周期：socket() → bind() → listen() → accept() → read/write → close()
• 客户端生命周期：socket() → connect() → read/write → close()
• I/O 模型：阻塞、非阻塞、I/O 复用（select、epoll）
• 并发方式：多进程（fork）、多线程（pthread）
• 高级主题：半关闭（shutdown）、套接字选项、多播/广播