NAME

netdevice - 底層訪問 Linux 網路裝置.

總覽 (SYNOPSIS)

#include <sys/ioctl.h>
#include <net/if.h>

描述 (DESCRIPTION)

本手冊描述用於配置網路裝置的套接字(socket) 介面.

Linux 支援一些配置網路裝置的標準 ioctl. 他們用於任意的套接字描述符, 而無須瞭解其型別或系列. 他們傳遞一個 ifreq 結構:

struct ifreq
{
	char	ifr_name[IFNAMSIZ];	/* Interface name */
	union {
		struct sockaddr	ifr_addr;
		struct sockaddr	ifr_dstaddr;
		struct sockaddr	ifr_broadaddr;
		struct sockaddr	ifr_netmask;
		struct sockaddr	ifr_hwaddr;
		short	ifr_flags;
		int	ifr_ifindex;
		int	ifr_metric;
		int	ifr_mtu;
		struct ifmap	ifr_map;
		char	ifr_slave[IFNAMSIZ];
		char	ifr_newname[IFNAMSIZ];
		char *	ifr_data;
	};
}
struct ifconf 
{ 
  	int ifc_len;		/* size of buffer */
	union {            
		char *	ifc_buf; /* buffer address */ 
		struct ifreq *ifc_req; /* array of structures */
	};  
};

一般說來, ioctl 透過把 ifr_name 設定為介面的名字來指定將要操作的裝置. 結構的其他成員可以分享記憶體.

IOCTLS

如果某個 ioctl 標記為特權操作, 那麼操作時需要有效uid 為 0, 或者擁有 CAP_NET_ADMIN 能力. 否則將返回 EPERM .

SIOCGIFNAME

給定 ifr_ifindex, 返回 ifr_name 中的介面名字. 這是唯一返回 ifr_name 內容的 ioctl.

SIOCGIFINDEX

把介面的索引存入 ifr_ifindex.

SIOCGIFFLAGS, SIOCSIFFLAGS

讀取或設定裝置的活動標誌字. ifr_flags 包含下列值的遮蔽位:

裝置標誌
IFF_UP	介面正在執行.
IFF_BROADCAST	有效的廣播地址集.
IFF_DEBUG	內部除錯標誌.
IFF_LOOPBACK	這是自環介面.
IFF_POINTOPOINT	這是點到點的鏈路介面.
IFF_RUNNING	資源已分配.
IFF_NOARP	無arp協議, 沒有設定第二層目的地址.
IFF_PROMISC	介面為雜湊(promiscuous)模式.
IFF_NOTRAILERS	避免使用trailer .
IFF_ALLMULTI	接收所有組播(multicast)報文.
IFF_MASTER	主負載平衡群(bundle).
IFF_SLAVE	從負載平衡群(bundle).
IFF_MULTICAST	支援組播(multicast).
IFF_PORTSEL	可以透過ifmap選擇介質(media)型別.
IFF_AUTOMEDIA	自動選擇介質.
IFF_DYNAMIC	介面關閉時丟棄地址.

設定活動標誌字是特權操作, 但是任何程序都可以讀取標誌字.

SIOCGIFMETRIC, SIOCSIFMETRIC

使用 ifr_metric 讀取或設定裝置的 metric 值. 該功能目前還沒有實現. 讀取操作使 ifr_metric 置 0, 而設定操作則返回 EOPNOTSUPP.

SIOCGIFMTU, SIOCSIFMTU

使用 ifr_mtu 讀取或設定裝置的 MTU(最大傳輸單元). 設定 MTU 是特權操作. 過小的 MTU 可能導致核心崩潰.

SIOCGIFHWADDR, SIOCSIFHWADDR

使用 ifr_hwaddr 讀取或設定裝置的硬體地址. 設定硬體地址是特權操作.

SIOCSIFHWBROADCAST

使用 ifr_hwaddr 讀取或設定裝置的硬體廣播地址. 這是個特權操作.

SIOCGIFMAP, SIOCSIFMAP

使用 ifr_map 讀取或設定介面的硬體引數. 設定這個引數是特權操作.

struct ifmap 
{
	unsigned long	mem_start;
	unsigned long	mem_end;
	unsigned short	base_addr; 
	unsigned char	irq;	
	unsigned char	dma; 
	unsigned char	port; 
};

對 ifmap 結構的解釋取決於裝置驅動程式和體系結構.

SIOCADDMULTI, SIOCDELMULTI

使用 ifr_hwaddr 在裝置的鏈路層組播過濾器 (multicase filter) 中新增或刪除地址. 這些是特權操作. 參看 packet(7).

SIOCGIFTXQLEN, SIOCSIFTXQLEN

使用 ifr_qlen 讀取或設定裝置的傳輸佇列長度. 設定傳輸佇列長度是特權操作.

SIOCSIFNAME

把 ifr_ifindex 中指定的介面名字改成 ifr_newname. 這是個特權操作.

SIOCGIFCONF

返回介面地址(傳輸層) 列表. 出於相容性, 目前只代表 AF_INET 地址. 使用者傳送一個 ifconf 結構作為 ioctl 的引數. 其中 ifc_req 包含一個指標指向 ifreq 結構陣列, 他的長度以位元組為單位存放在 ifc_len 中. 核心用所有當前的 L3(第三層?) 介面地址填充 ifreqs, 這些介面正在執行: ifr_name 存放介面名字 (eth0:1等), ifr_addr 存放地址. 核心在 ifc_len 中返回實際長度; 如果他等於初始長度, 表示溢位了, 使用者應該換一個大些的緩衝區重試一下. 沒有發生錯誤時 ioctl 返回 0, 否則返回 -1, 溢位不算錯誤.

大多數協議使用自己的 ioctl 配置協議特定的介面操作. 具體情況參看協議的幫助手冊. 要配置 IP 地址可以參看 ip(7).

另外, 某些裝置有專用的 ioctl, 這裡不做敘述.