📘
Beej's Guide to Network Programming 正體中文版
  • 簡介
  • 原著資訊
  • 譯者誌謝
  • 進階資料
  • 簡體中文版
  • 中文授權
  • 聯絡譯者
  • 1. 導讀
    • 1.1. 本書的讀者
    • 1.2. 平台與編譯器
    • 1.3. 官方網頁與書本
    • 1.4. Solaris/SunOS 程式設計師該注意的事
    • 1.5. Windows 程式設計師該注意的事
    • 1.6. 來信原則
    • 1.7. 鏡射站台(Mirroring)
    • 1.8. 譯者該注意的
    • 1.9. 版權與散佈
  • 2. 何謂 Socket
    • 2.1 兩種 Internet Sockets
    • 2.2 底層漫談與網路理論
  • 3. IP address、結構與資料轉換
    • 3.1. IPv4 與 IPv6
      • 3.1.1. Sub network (子網段)
      • 3.1.2. Port Number(連接埠號碼)
    • 3.2. Byte Order(位元組順序)
    • 3.3. 資料結構
    • 3.4. IP 位址,續集
      • 3.4.1 Private Network
  • 4. 從 IPv4 移植為 IPv6
  • 5. System call 或 Bust
    • 5.1. getaddrinfo()-準備開始!
    • 5.2. socket()-取得 File Descriptor!
    • 5.3. bind()- 我在哪個 port?
    • 5.4. connect(),嘿!你好。
    • 5.5. listen()-有人會呼叫我嗎?
    • 5.6. accept()- 謝謝你 call 3490 port
    • 5.7. send() 與 recv()- 寶貝,我們來聊天!
    • 5.8. sendto() 與 recvfrom()- 來點 DGRAM
    • 5.9. close() 與 shutdown()- 你消失吧!
    • 5.10. getpeername()-你是誰?
    • 5.11. gethostname()-我是誰?
  • 6. Client-Server 基礎
    • 6.1. 簡單的 Stream Server
    • 6.2. 簡單的 Stream Client
    • 6.3. Datagram Sockets
  • 7. 進階技術
    • 7.1. Blocking(阻塞)
    • 7.2. select():同步 I/O 多工
    • 7.3. 不完整傳送的後續處理
    • 7.4. Serialization:如何封裝資料
    • 7.5. 資料封裝
    • 7.6. 廣播封包:Hello World!
  • 8. 常見的問題
  • 9. Man 使用手冊
    • 9.1. accept()
    • 9.2. bind()
    • 9.3. connect()
    • 9.4. close()
    • 9.5. getaddrinfo(), freeaddrinfo(), gai_strerror()
    • 9.6. gethostname()
    • 9.7. gethostbyname(), gethostbyaddr()
    • 9.8. getnameinfo()
    • 9.9. getpeername()
    • 9.10. errno
    • 9.11. fcntl()
    • 9.12. htons(), htonl(), ntohs(), ntohl()
    • 9.13. inet_ntoa(), inet_aton(), inet_addr
    • 9.14. inet_ntop(), inet_pton()
    • 9.15. listen()
    • 9.16. perror(), strerror()
    • 9.17. poll()
    • 9.18. recv(), recvfrom()
    • 9.19. select()
    • 9.20. setsockopt(), getsockopt()
    • 9.21. send(), sendto()
    • 9.22. shutdown()
    • 9.23. socket()
    • 9.24. struct sockaddr and pals
  • 10. 參考資料
    • 10.1. 書籍
    • 10.2. 網站參考資料
    • 10.3. RFC
  • 11. 原著誌謝
Powered by GitBook
On this page
  • 函式原型
  • 說明
  • 範例
  • 參考
Edit on GitHub
  1. 9. Man 使用手冊

9.24. struct sockaddr and pals

處理 internet addresses 的資料結構

函式原型

#include <netinet/in.h>

// 全部指向 socket address structures 的指標,通常會在各種函式或 system calls 使用以前,
// 轉型為對相對應型別的指標:

struct sockaddr {
    unsigned short    sa_family;    // address family, AF_xxx
    char              sa_data[14];  // 14 bytes 的 protocol address
};

// IPv4 AF_INET sockets:

struct sockaddr_in {
    short            sin_family;   // 例如:AF_INET, AF_INET6
    unsigned short   sin_port;     // 例如:htons(3490)
    struct in_addr   sin_addr;     // 參考下列的 struct in_addr
    char             sin_zero[8];  // 若你想要的話,將這個設定為零
};

struct in_addr {
    unsigned long s_addr;          // 用 inet_pton() 載入
};


// IPv6 AF_INET6 sockets:

struct sockaddr_in6 {
    u_int16_t       sin6_family;   // address family, AF_INET6
    u_int16_t       sin6_port;     // port number, Network Byte Order
    u_int32_t       sin6_flowinfo; // IPv6 flow 資訊
    struct in6_addr sin6_addr;     // IPv6 address
    u_int32_t       sin6_scope_id; // Scope ID
};

struct in6_addr {
    unsigned char   s6_addr[16];   // 用 inet_pton() 載入
};


// 承載 socket address 的 structure,要足以承載
// struct sockaddr_in 或 struct sockaddr_in6 data:

struct sockaddr_storage {
    sa_family_t  ss_family;     // address family

    // 這個全部都是填充的內容,依據實作而定,請忽略它:
    char      __ss_pad1[_SS_PAD1SIZE];
    int64_t   __ss_align;
    char      __ss_pad2[_SS_PAD2SIZE];
};

說明

對於 internet address 全部的 syscalls 及函式都有基本的資料結構,通常你會用 getaddinfo() 填好這些資料結構,然後當你需要時,就可以讀取它們。

印象中,struct sockaddr_in 與 struct sockaddr_in6 會共用相同的 struct sockaddr 起始資料結構,而你能自由地將一種型別轉型為另一種型別,除非你到了宇宙的盡頭,不然是不會有任何問題的。

宇宙的盡頭這件事只是開個玩笑 ... 若當你將 struct sockaddr_in 轉型為 struct sockaddr 時已經到了宇宙的盡頭,那我保證這必定純屬巧合,所以你根本不用擔心這件事啦。

恩,還要記得一點,如果一個函式允許你代入一個 struct sockaddr 參數時,你就可以放心地將你的 struct sockaddr_in、struct sockaddr_in6 或 struct sockadd_storage 轉型成這個型別。

struct sockaddr_in 是 IPv4 addresses(例如:"192.0.2.10")在用的資料結構,它承載了一個 address family (AF_INET):在 sin_port 有一個 port,而在 sin_addr 有一個 IPv4 address in sin_addr。

還有 struct sockadd_in 中的 sin_zero 欄位,有些人認為這個一定要設定成零,但有些人認為不用設定任何值(Linux 文件一點也沒有提過這件事),而且設定成零似乎沒有實際的用途。不過如果你喜歡,還是可以用 memset() 將它設定為零。

目前 struct in_addr 在不同的系統上是個怪東西,有時候它是瘋狂的大總匯(crazy union),有各種 #define 與一堆鬼東西。不過你該做的只是用這個 structure 的 s_addr 欄位,因為多數的系統只會實作這個欄位。

struct sockadd_in6 與 struct in6_addr 不僅都適用於 IPv6,而且都非常相似。

當你試著寫與 IP 版本無關的程式時,struct sockaddr_storage 是你可以傳遞給 accept() 或 recvfrom() 的資料結構,而且你不需知道新的 address 是走 IPv4 或 IPv6 協定。資料結構 struct sockaddr_storage 不像原本小小的 struct sockaddr,而是大到足以承載兩種型別。

範例

// IPv4:

struct sockaddr_in ip4addr;
int s;

ip4addr.sin_family = AF_INET;
ip4addr.sin_port = htons(3490);
inet_pton(AF_INET, "10.0.0.1", &ip4addr.sin_addr);

s = socket(PF_INET, SOCK_STREAM, 0);
bind(s, (struct sockaddr*)&ip4addr, sizeof ip4addr);
// IPv6:

struct sockaddr_in6 ip6addr;
int s;

ip6addr.sin6_family = AF_INET6;
ip6addr.sin6_port = htons(4950);
inet_pton(AF_INET6, "2001:db8:8714:3a90::12", &ip6addr.sin6_addr);

s = socket(PF_INET6, SOCK_STREAM, 0);
bind(s, (struct sockaddr*)&ip6addr, sizeof ip6addr);

參考

accept(), bind(), connect(), inet_aton(), inet_ntoa()

Previous9.23. socket()Next10. 參考資料

Last updated 2 years ago