Man page - netdevice(7)

Packages contains this manual

Available languages:

en fr es ja zh_TW zh_CN

Manual

NETDEVICE

NAME
總 覽 (SYNOPSIS)
描 述 (DESCRIPTION)
IOCTLS
注 意 (NOTE)
注 意 (NOTE)
另 見 (SEE ALSO)
[中 文 版 維 護 人 ]
[中 文 版 最 新 更 新 ]
《 中 國 linux論 壇 man手 冊 頁 翻 譯 計 劃 》 :
跋

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 包 含 下 列 值 的 遮 蔽 位 :

Image grohtml-687347-1.png

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

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, 這 裡 不 做 敘 述 .

注 意 (NOTE)

嚴 格 說 來 SIOCGIFCONF 是 專 門 針 對 IP 的 , 它 屬 於 ip (7).

注 意 (NOTE)

可 以 透 過 /proc/net/dev 看 到 沒 有 地 址 或 沒 有 IFF_RUNNING 標 誌 的 介 面 名 字 .

另 見 (SEE ALSO)

ip (7), proc (7)

[中 文 版 維 護 人 ]

徐 明 <xuming@iname.com>

[中 文 版 最 新 更 新 ]

2000/10/15 第 一 版
2001/11/24 第 一 次 修 訂

《 中 國 linux論 壇 man手 冊 頁 翻 譯 計 劃 》 :

http://cmpp.linuxforum.net

跋

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。
中 文 man 手 冊 頁 計 劃 ： https://github.com/man-pages-zh/manpages-zh