'\" t
.\" Don't change the first line, it tells man that tbl is needed.
.\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>.
.\" 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.
.\" $Id: netdevice.7,v 1.1.1.1 2000/12/27 12:24:43 BitBIRD Exp $
.TH NETDEVICE  7 "2 May 1999" "Linux Man Page" "Linux Programmer's Manual" 
.SH NAME
netdevice \- ײ Linux 豸.
.SH 
.B "#include <sys/ioctl.h>"
.B "#include <net/if.h>"

.SH 
ֲ豸׽ֽӿ.

Linux ֧һЩ豸ı׼ ioctl.
׽,˽ͻ.Ǵһ
.B ifreq 
ṹ:

.nf
.ta 4 20 42
struct ifreq
{
char    ifr_name[IFNAMSIZ];     /* ӿ */
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;            /* ߴ */
union {            
char *  ifc_buf; /* ַ */ 
struct ifreq *ifc_req; /* ṹ */
};  
};         
.ta
.fi

һ˵,ûҪѡ豸,ͨ
.B ifr_name
Ϊӿڵʵ. ṹԱԹڴ.

.SH IOCTLS
һ ioctl ΪҪȨ, ôʹҪЧûΪ0, ӵ
.B CAP_NET_ADMIN
. 

.B EPERM
.

.TP
.B SIOCGIFNAME

.BR ifr_ifindex,
򷵻ش
.BR ifr_name 
еĽӿ.Ψһܹش
.BR ifr_name 
ݵ ioctl.

.TP
.B SIOCGIFINDEX
ѽӿڵĽӿ
ŵ
.BR ifr_ifindex 
.

.TP
.BR SIOCGIFFLAGS ", " SIOCSIFFLAGS
ȡû豸Ļ־.
.B ifr_flags
ֵλ:

.TS
tab(:);
c s
l l.
豸־
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ѡ.
IFF_AUTOMEDIA: Զѡ.
IFF_DYNAMIC:T{
ӿڹرʱַ.
T}
.TE 

û־Ȩ, Ƕκν̿ɶ.

.TP
.BR SIOCGIFMETRIC ", " SIOCSIFMETRIC
ʹ
.BR ifr_metric 
ȡû豸 metric ֵ.Ŀǰûʵһ.ʹ
.B ifr_metric
 0, ᷵
.B EOPNOTSUPP.

.TP
.BR SIOCGIFMTU ", " SIOCSIFMTU
ʹ
.BR ifr_mtu 
ȡû豸 MTU (䵥Ԫ).
 MTU Ȩ. MTU ĹСܵں˱.

.TP
.BR SIOCGIFHWADDR ", " SIOCSIFHWADDR
ʹ
.BR ifr_hwaddr 
ȡû豸Ӳַ.ӲַȨ.

.TP
.B SIOCSIFHWBROADCAST
ʹ
.BR ifr_hwaddr 
ȡû豸Ӳ㲥ַ.ǸȨ.

.TP
.BR SIOCGIFMAP ", " SIOCSIFMAP
ʹ
.BR ifr_map 
ȡûýӿڵӲ.Ȩ.

.nf
.ta 4 20 42
struct ifmap 
{
unsigned long   mem_start;
unsigned long   mem_end;
unsigned short  base_addr; 
unsigned char   irq;    
unsigned char   dma; 
unsigned char   port; 
};
.ta
.fi

 ifmap ṹڹȡ豸ϵṹ.

.TP
.BR SIOCADDMULTI ", " SIOCDELMULTI
ʹ
.BR ifr_hwaddr 
豸·鲥 (multicase filter) ӻɾַ.
ЩȨ.ο
.BR packet (7)
滻Ʒ.

.TP
.BR SIOCGIFTXQLEN ", " SIOCSIFTXQLEN
ʹ
.BR ifr_qlen 
ȡû豸Ĵг.
ôгȨ.

.TP
.B SIOCSIFNAME

.BR ifr_ifindex
ڵƸij
.BR ifr_newname
ڵ. ǸȨ.

.TP
.B SIOCGIFCONF
һϵнӿڵַ(). ĿǰΪ˼, ָ AF_INET ַ.
ûһ
.B ifconf
ṹΪ ioctl IJ.
.B ifc_req
кһָ
.I ifreq
ṹָ,䳤ֽΪλ
.B ifc_len.
ںʹõĵַ ifreqs:
.I ifr_name 
װнӿڵ(eth0:1),
.I ifr_addr
ǵַ. ں
.I ifc_len
зʵʳ;
ڳʼ, ûΪ, ӦûһЩĻ.
ûдʱ ioctl  0, 򷵻 -1, .

\" XXX Slaving isn't supported in 2.2
.\" .TP
.\" .BR SIOCGIFSLAVE ", " SIOCSIFSLAVE
.\" Get or set the slave device using
.\" .BR ifr_slave .
.\" Setting the slave device is a privileged operation.

.PP

.\" XXX add amateur radio stuff.
.PP
Э֧Լ ioctl ЭضĽӿڲ.
οЩЭİֲ.Ҫ IP ַο
.BR ip (7).
.PP
һЩ豸֧ר ioctl, û.

.SH ע
.B SIOCGIFCONF 
ר IP , 
.BR ip (7).

.SH ע
еַû
.B IFF_RUNNING 
־ĽӿƿԾ
.I /proc/net/dev
.

.SH 
.BR ip "(7), " proc "(7)"

.SH "[İά]"
 E-mail: xuming@bigfoot.com
.SH "[ݸ]"
2000/10/15
.br
.B й Linux ̳ man ֲҳƻ: www.cmpp.net/