'\" t
.\" Don't change the first line, it tells man that we need tbl.
.\" This man page is Copyright (C) 1999 Andi Kleen .
.\" and copyright (c) 1999 Matthew Wilcox. 
.\" Permission is granted to distribute possibly modified copies
.\" of this page provided the header is included verbatim,
.\" and in case of nontrivial modification author and date
.\" of the modification is added to the header.
.TH SOCKET  7 "7 May 1999" "Linux Man Page" "Linux Programmer's Manual" 
.SH NAME
socket \- Linux 套接字
.SH 總覽
.B #include  <sys/socket.h>
.br
.IB mysocket " = socket(int " socket_family ", int " socket_type ", int " protocol );

.SH 描述
本手冊頁介紹了 Linux 套接字的使用者介面. 這個 BSD 相容套接字是介於用
戶程序與核心網路協議棧之間的統一介面, 各協議模組屬於不同的
.I 協議族
,如
.BR PF_INET ", " PF_IPX ", " PF_PACKET
和
.I 套接字型別
,如
.B 位元組流（SOCK_STREAM）
或
.BR 資料報（SOCK_DGRAM）.
關於協議族和套接字型別請參考
.BR socket (2) "."

.SH 套接層函式
使用者透過這些套接字函式傳送和接收包, 以及其他套接字操作.
詳細說明參看他們各自的手冊頁.

.BR socket (2)
建立套接字，
.PP
.BR connect (2)
與遠端套接字地址建立連線
.PP
.BR bind (2)
把套接字和一個本地套接字地址繫結在一起（為套接字分配一個本地協議地址）
.PP
.BR listen (2)
通知套接字接受新的連線
.PP
.BR accept (2)
為新的已完成連接獲得新的描述字
.PP
.BR socketpair (2)
返回兩個連線的匿名套接字（僅在某些本地族中才有實現,如
.BR PF_UNIX "）"
.PP
.BR send (2),
.PP
.BR sendto (2),
和
.BR sendmsg (2)
透過套接字傳送資料，而
.BR recv (2),
.BR recvfrom (2),
.BR recvmsg (2)
從套接字接收資料.
.BR poll (2)
和
.PP
.BR select (2)
等待資料到來或準備好接收資料. 除此之外, 標準 I/O 操作如
.BR write (2),
.BR writev (2),
.BR sendfile (2),
.BR read (2),
和
.BR readv (2) 
也可用來讀入（接收）和寫出（傳送）資料.
.PP
.BR getsockname (2)
用於獲得本地套接字地址
.PP
.BR getpeername (2)
用於獲得遠端套接字地址.
.BR getsockopt (2)
和
.BR setsockopt (2)
用於設定或取得套接字或協議選項. 
.BR ioctl (2)
也可以用來設定或讀取一些其他選項.
.PP
.BR close (2)
關閉套接字.
.BR shutdown (2)
關閉全雙工套接字連線的一部分.
.PP
套接字不支援搜尋，也不支援呼叫
.BR pread (2) 
或
.BR pwrite (2)
進行非 0 位置的操作.
可以用
.BR fcntl (2).
設定
.B O_NONBLOCK
標誌來實現對套接字的非阻塞 I/O 操作
.B O_NONBLOCK
是從 accept 繼承來的，然後原來所有會阻塞的操作會返回
.BR EAGAIN .
.BR connect (2) 
在此情況下返回
.B EINPROGRESS
錯誤.
使用者可以透過
.BR poll (2)
或者
.BR select (2)
等待各種事件.

.PP
.TS
tab(:) allbox;
c s s
l l l.
I/O 事件
事件:輪詢標誌:發生事件
讀:POLLIN:T{
新資料到達.
T}
讀:POLLIN:T{
(對面向連線的套接字)建立連線成功
T}
讀:POLLHUP:T{
另一端套接字發出斷開連線請求.
T}
讀:POLLHUP:T{
(僅對面向連線協議)套接字寫的時候連線斷開. 同時傳送
.B SIGPIPE.
T}
寫:POLLOUT:T{
套接字有充足的傳送緩衝區用於寫入新資料.
T}
讀/寫:T{
POLLIN|
.br
POLLOUT
T}:T{
發出的
.BR connect (2)
結束.
T}
讀/寫:POLLERR:產生一個非同步錯誤.
讀/寫:POLLHUP:對方已經單向關閉連線.
例外:POLLPRI:T{
緊急資料到達.然後傳送
.B SIGURG.
T}
.\" XXX not true currently
.\" It is no I/O event when the connection
.\" is broken from the local end using 
.\" .BR shutdown (2)
.\" or 
.\" .BR close (2)
.\" .
.TE

.PP
另外一個的 poll/select 方法是讓核心用
.B SIGIO
訊號來通知應用程式. 要這麼用的話你必須用
.BR fcntl (2)
設定套接字檔案描述符的
.B FASYNC
標誌，並用
.BR sigaction (2).
給
.B SIGIO
訊號設定一個的有效訊號處理控制代碼.參看下面的
.I SIGNALS
的討論.
.SH 套接字選項
套接字選項可以用
.BR setsockopt (2)
來設定，用
.BR getsockopt (2)
讀取所有套接字級別設為
.B SOL_SOCKET 
的套接字的套接字選項:
.TP
.B SO_KEEPALIVE
允許在面向連線的套接字上傳送 keep\-alive 訊息的功能.是一個布林整數.
.TP
.B SO_OOBINLINE
如果開啟這個選項，帶外（Out\-of\-Band）資料可以直接放入接收資料流。
否則，只有接收時開啟
.B MSG_OOB 
標誌, 才接收帶外資料.
.\" don't document it because it can do too much harm.
.\".B SO_NO_CHECK
.TP
.BR SO_RCVLOWAT " 和 " SO_SNDLOWAT
宣告在開始向協議
.RB ( SO_SNDLOWAT ) 
或正在接收資料的使用者
.RB ( SO_RCVLOWAT ).
傳遞資料之前緩衝區內的最小位元組數. 在 Linux 中這兩個值是不可改變的,
固定為 1 位元組.
可以用
.B getsockopt 
用來讀取它們的值; 
.B setsockopt 
總是返回
.BR ENOPROTOOPT .  
.TP
.BR SO_RCVTIMEO " 和 " SO_SNDTIMEO
傳送和接收時的超時設定, 並在超時時報錯. 在 Linux 中由
協議指定, 不能被讀寫. 它們的功能可用
.BR alarm (2)
或者
.BR setitimer (2).
來模擬.
.TP
.B SO_BSDCOMPAT
允許 BSD 的 bug\-to\-bug 相容. 這一項只能在 UDP 協議模組中使用而
且今後將要取消. 如果允許的話, UDP 套接字接收到的 ICMP 錯誤將不
會被傳送至使用者程式. Linux 2.0 中對於原始套接字也允許 BSD 
bug\-to\-bug 相容（報頭隨機改變,省略廣播標識）,但在 Linux 2.2
中取消了這一項. 修改使用者程式的方式比較好.
.TP
.B SO_PASSCRED
允許或關閉
.B SCM_CREDENTIALS
控制訊息的接收.
更多資訊參見
.BR unix (7). 
.TP
.B SO_PEERCRED
返回連線至此套接字的外部程序的身份驗證. 只在 
.B PF_UNIX 
套接字中有用.參見 
.BR unix (7). 
引數為
.B ucred 
結構.只在
.BR getsockopt .
中有效.
.TP
.B SO_BINDTODEVICE
將此套接字繫結到一個特定的裝置上, 如\(lqeth0\(rq,
做為指定的介面名字傳遞. 如果名稱是空字串或此項長度為 0,
則套接字裝置繫結被取消. 過去的選項是一個變長的空零結尾的
介面名稱的字串, 其最大長度為
.BR IFNAMSIZ . 
如果一個套接字被繫結至一介面,
只有由這個特定介面接收的資訊包可以由此套接字處理.
.TP
.B SO_DEBUG 
允許套接字除錯.只對有
.B CAP_NET_ADMIN
功能或有效使用者標識為 0 的程序有效.
.TP
.B SO_REUSEADDR
表示在一個
.BR bind (2) 
呼叫中對提供給它的地址使用的確認規則應該允許重複使用本地地址. 對於
.B PF_INET
套接字, 這表示該套接字可以繫結, 除非已有一個活躍的偵聽套
介面繫結到此地址上. 如果這個偵聽套接字和一個指定埠繫結為
.B INADDR_ANY
時, 它就不能再繫結到任何本地地址的此埠.
.TP
.B SO_TYPE
按整數返回套接字型別（如
.BR SOCK_STREAM ） 
只能透過
.BR getsockopt
讀取. 
.TP
.B SO_DONTROUTE
不透過閘道器傳送, 只能傳送給直接連線的主機.可以透過在套接字的
.BR send (2)
操作上設定
.B MSG_DONTROUTE
標誌來實現相同的效果. 其值為布林型整數的標識.
.TP
.B SO_BROADCAST
設定或獲取廣播標識. 當選擇此選項時, 資料報套接字接收向
廣播地址傳送的資料包, 並且可以向廣播地址傳送資料包. 這一
選項對於面向流的套接字無效.
.TP
.B SO_SNDBUF 
設定或得到套接字傳送緩衝區的最大位元組數. 其預設值由 
.B wmem_default 
sysctl 設定,最大允許值由
.B wmem_max
sysctl 設定.
.TP
.B SO_RCVBUF
設定或得到套接字接收緩衝區的最大位元組數。其預設值由 
.B rmem_default 
sysctl設定,最大允許值由
.B rmem_max
sysctl 設定.
.TP
.B SO_LINGER
設定或獲取
.B SO_LINGER 
選項的值. 其引數為
.B linger 
結構.
.PP
.RS
.nf
.ta 4n 10n 22n
struct linger {
	int	l_onoff;	/* 延時狀態（開啟/關閉） */
	int	l_linger;	/* 延時多長時間 */
};
.ta
.fi
.RE
.IP
如果選擇此選項,
.BR close (2)
或
.BR shutdown (2)
將等到所有套接字裡排隊的訊息成功傳送或到達延遲時間後
才會返回. 否則, 呼叫將立即返回. 而 closing 操作將在後臺
進行. 如果套接字是
.BR exit (2),
的一部分關閉時, 它總是在後臺延遲進行的.
.TP
.B SO_PRIORITY
設定在此套接字傳送的所有包的協議定義優先權.
Linux 透過這一值來排列網路佇列: 根據所選裝置排隊規則, 
具有更高優先權的包可以先被處理.對於
.BR ip (7),
同時也設定了輸出包的 IP 服務型別（TOS）的域.
.TP
.B SO_ERROR
取得並清除未解決的套接字錯誤. 只有在
.BR getsockopt .
時有效. 是一個整數值.
.SH SIGNALS
當向一個已關閉（被本地或遠端終端）的面向聯接的套接字寫入時,
將向該寫入程序傳送
.B SIGPIPE
訊號，並返回
.B EPIPE
.
如果寫入命令聲明瞭
.B MSG_NOSIGNAL 
標識時, 不會發出此訊號.
.PP
如果與
.B FIOCSETOWN 
fcntl 或 
.B SIOCSPGRP 
ioctl 一起請求，那麼當發生 I/O 事件時發出
.B SIGIO
這樣我們就可以在訊號控制代碼裡使用
.BR poll (2)
或
.BR select (2)
找出發生事件的套接字.
另一種選擇（在 Linux 2.2 中）是用
.B F_SETSIG
fcntl 設定一個實時訊號:
實時訊號的處理程式被呼叫時還會收到它的
.IR siginfo_t 
的
.I si_fd 
區域中的檔案描述符.
更多資訊參見
.BR fcntl (2)
.PP
在某些環境中（例如:多個程序訪問單個套接字）,
引發
.B SIGIO
的東西在程序對訊號作出反應時可能已經消失了.
如果這樣的話, 程序應該再次等待, 因為 Linux 稍後會重發此訊號.
.\" .SH輔助訊息
.SH SYSCTLS 
可以透過目錄
.B /proc/sys/net/core/* 
下的檔案或者用
.BR sysctl (2) 
系統呼叫來訪問核心套接字的網路系統控制（sysctl）資訊.
.TP
.B rmem_default
指明套接字接收緩衝區的預設位元組數.
.TP
.B rmem_max
指明套接字接收緩衝區的最大位元組數, 使用者可以透過使用
.B SO_RCVBUF
套接字選項來設定此值.
.TP
.B wmem_default
指明套接字傳送緩衝區的預設位元組數.
.TP
.B wmem_max
指明發送緩衝區的最大位元組數，使用者可以透過使用套接字的
.B SO_SNDBUF
選項來設定它的值.
.TP
.BR message_cost " 和 " message_burst 
設定記號儲存桶過濾器, 在儲存桶中儲存一定數量的外部網路
事件導致的警告訊息.
.TP
.B netdev_max_backlog 
在全域性輸入佇列中包的最大數目.
.TP
.B optmem_max
每個套接字的象 iovecs 這樣的輔助資料和使用者控制資料的最大長度.
.\" netdev_fastroute 沒有介紹
.SH IOCTLS
以上的 IO 控制值可以透過
.BR ioctl (2)
來訪問:

.RS
.nf
.IB error " = ioctl(" ip_socket ", " ioctl_type ", " &value_result ");"
.fi
.RE

.TP
.B SIOCGSTAMP
返回
.B timeval 
型別的結構，其中包括有傳送給使用者的最後一個包接收時的時間戳。
被用來測量精確的 RTT （round trip time） 時間.
.BR "struct timeval" .
結構說明請參考
.BR setitimer (2) 
.\"
.TP
.BR SIOCSPGRP
在非同步 IO 操作結束或者接收到緊急資料時，用來設定程序或程序組，
向它（它們）傳送
.B SIGIO
或者
.B SIGURG
訊號, 引數為指向
.BR pid_t . 
型別的指標。如果引數為正，則傳送訊號到相應的程序。如果引數為
負，則傳送訊號到此引數絕對值 id 所屬的程序組的所有程序。
如果它沒有
.B CAP_KILL
功能或者它的有效 UID 不是 0, 程序只能選擇它自己或自己的程序組來
接收訊號.
.TP
.B FIOASYNC
改變
.B O_ASYNC
標誌來開啟或者關閉套接字的非同步 IO 模式。非同步IO模式指的是：當
新的 I/O 事件發生時，將發出
.B SIGIO 
訊號或者用
.B F_SETSIG
設定的訊號.
.IP
引數為整形布林量. 
.\"
.TP
.BR SIOCGPGRP
獲得當前接收
.B SIGIO 
或者
.B SIGURG
訊號的程序或者程序組, 
如果兩個訊號都沒有設定, 則為 0.
.PP
有效的 fcntl:
.TP
.BR FIOCGETOWN 
與 IO 控制中的 SIOCGPGRP 相同.
.TP
.BR FIOCSETOWN
與 IO 控制中的 SIOCSPGRP 相同.
.SH 注意
Linux 假設有一半的傳送/接收緩衝區是用來處理核心結構, 因此, 
系統控制的緩衝區是網路可訪問的緩衝區的兩倍.
.SH 缺陷
.B CONFIG_FILTER 
沒有介紹
.B SO_ATTACH_FILTER 
和
.B SO_DETACH_FILTER 
套接字選項. 在 libpcap 庫有此介面的說明
.SH VERSIONS 版本
.B SO_BINDTODEVICE 
在 Linux 2.0.30 中引入. 
.B SO_PASSCRED 
是在 Linux 2.2 中引入的新選項.
sysctl 是在 Linux 2.2. 中引入的新概念。 
.SH 作者
本手冊頁由 Andi Kleen 編寫.
.PP
.SH 又見
.BR socket (2),
.BR ip (7),
.BR setsockopt (2),
.BR getsockopt (2),
.BR packet (7),
.BR ddp (7) 

.SH "[中文版維護人]"
.B liguoping <liguoping_11@sina.com>
.SH "[中文版最新更新]"
.BR 2000/11/06
.SH "《中國linux論壇man手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR