'\" t
.\" Don't change the first line, it tells man that tbl is needed.
.\" This man page copyright 1998 by Andi Kleen. Subject to the GPL.
.\" This manpage copyright 1998 by Andi Kleen. Subject to the GPL.
.\" Based on the original comments from Alexey Kuznetsov
.\" $Id: netlink.7,v 1.5 2001/04/04 08:02:37 ysato Exp $
.\"
.\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
.\" Translated Mon 6 Dec 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Wed Apr  4 16:21:55 JST 2001 by Yuichi SATO <ysato@h4.dion.ne.jp>
.\"
.\"WORD		payload		ڥ
.\"WORD		capability	
.\"
.TH NETLINK  7 "27 Apr 1999" "Linux Man Page" "Linux Programmer's Manual"
.SH ̾
netlink, PF_NETLINK \- ͥȥ桼֤̿
.SH 
.nf
.\" XXX
.B #include <asm/types.h>
.br
.B #include <sys/socket.h>
.br
.B #include <linux/netlink.h> 
.br
.PP
.BI "netlink_socket = socket(PF_NETLINK, " socket_type ", " netlink_family ); 
.SH 
netlink ϥͥ⥸塼ȥ桼֤Υץ֤
Ȥꤹ뤿Ѥ롣 netlink ϡ桼ץ
ФƤɸŪʥåȥ١Υ󥿡ե
ͥ⥸塼ˤϥͥ API 󶡤롣
ͥΥ󥿡եˤĤƤϤ man ڡǤ
Ҥʤޤ netlink 饯ǥХѤ
obsolete  netlink 󥿡ե⤢뤬
⤳ʸǤϲ⤷ʤñ˲ߴ
ѰդƤΤˤʤ

netlink ϥǡظΥӥǤ롣
.I socket_type
ˤ
.B SOCK_RAW

.B SOCK_DGRAM
ξȤǽǤ롣 netlink ץȥ
ǡ raw åȤζ̤򤷤ʤ

.I netlink_family
ϡ̿륫ͥ⥸塼 netlink 롼פѤ롣
߳ƤƤ netlink եߥ꡼ϰʲ̤ꡣ
.TP
.B NETLINK_ROUTE
롼ƥ󥰤ι롣 IPv4 롼ƥ󥰥ơ֥ν
Ѥ뤳ȤǤ
.RB ( rtnetlink (7)
򸫤)
.TP
.B NETLINK_FIREWALL 
IPv4 firewall ɤƤѥåȤ롣
.TP
.B NETLINK_ARPD
arp ơ֥桼֤Ǵ롣
.TP
.B NETLINK_ROUTE6
IPv6 Υ롼ƥ󥰥ơ֥빹롣
.TP
.B NETLINK_IP6_FW
IPv6 firewall Υå˼ԤѥåȤ
(ߤϤޤƤʤ)
.TP
.BR NETLINK_TAPBASE ... NETLINK_TAPBASE+15

.B ethertap
ǥХΥ󥹥󥹤Ǥ롣
ethertap ϵͥåȥȥͥǥХǡ
ˤäƥ桼֤饤ͥåȥɥ饤Ф
ߥ졼Ȥ뤳Ȥǽˤʤ롣
.TP
.B NETLINK_SKIP
ENskip Ѥͽ󤵤Ƥ롣
.TP
.B NETLINK_USERSOCK
Υ桼֤ΥץȥѤͽ󤵤Ƥ롣
.PP
netlink åϥХȥȥ꡼फʤꡢ
İʾ 
.B nlmsghdr
إåȡбڥ (payload) ޤޤ롣
ޥѡȥåˤƤϡƬΥإå³Υإåˤ
.B NLM_F_MULTI
ե饰åȤ롣ǸΥإå㳰ǡ
.B NLMSG_DONE
פȤʤ롣Хȥȥ꡼ˤϡɸ
.B NLMSG_*
ޥˤäƤΤߥ٤Ǥ롣
.BR netlink (3)
򸫤衣

netlink Ͽι⤤ץȥǤϤʤ netlink 
åԤϤ뤿˺Ԥ
꤬­ʤäꥨ顼äꤹ
åꤳܤȤ⤢롣ι⤤žԤȤϡ
ԤϼԤ˱׵᤹뤳ȤǤ롣ˤ
.B NLM_F_ACK
ե饰򥻥åȤ롣
.B NLMSG_ERROR
ѥåȤΥ顼եɤ 0 ˤΤˤʤ롣
ץꥱϼʬȤΥåȤˤϡ
ʤФʤʤͥϼԤѥåȤФơ
.B NLMSG_ERROR
åȤ롣桼ץϤδˤ
ɬפ롣

줾 netlink եߥ꡼ 32 Υޥ㥹ȥ롼פ
åȤġ
.BR bind (2)
åȤФƸƤФȡ
.B sockaddr_nl

.B nl_groups
եɤˤ listen 롼פΥӥåȥޥåȤ롣
ǥեȤͤ 0 ǡޥ㥹Ȥڼʤ
.BR sendmsg (2)

.BR connect (2)
ˤäơ륽åȤåޥ㥹ȤȤϡ
.B nl_groups
롼פΥӥåȥޥ򥻥åȤФ褤
¸桼 ID  0 
.B CAP_NET_ADMIN
¤ĥ桼Τߤ netlink ޥ㥹ȥ롼פ
ꡢ listen ꤹ뤳ȤǤ롣
ޥ㥹ȥ롼פؤΥåФϡ
åޥ㥹ȤȤϡ
.B nl_groups
롼פΥӥåȥޥ򥻥åȤФ褤
¸桼 ID  0 
.B CAP_NET_ADMIN
¤ĥ桼Τߤ netlink ޥ㥹ȥ롼פ
ꡢ listen ꤹ뤳ȤǤ롣
ޥ㥹ȥ롼׸å硢Ф
 pid ȥޥ㥹ȥ롼פȤ֤٤Ǥ롣

.RS
.nf
.ta 4 13 25
struct nlmsghdr
{
	__u32	nlmsg_len;	/* Length of message including header */
	__u16	nlmsg_type;	/* Message content */
	__u16	nlmsg_flags;	/* Additional flags */
	__u32	nlmsg_seq;	/* Sequence number */
	__u32	nlmsg_pid;	/* PID of the process that opened the socket */
};


struct nlmsgerr
{
	int	error;	/* negative errno or 0 for acks. */ 
	struct nlmsghdr msg;	/* message header that caused the error */ 
};
.ta
.fi
.RE

.\" 2.1.130 does not seem to use it.
.\" .B NLMSG_OVERRUN
.\" data was lost. 
줾
.B nlmsghdr
θˤϥڥ (payload) ³
.B nlmsg_type
ɸΥåפΤɤ줫ĤǤ:
.B NLMSG_NOOP
å̵뤵롣
.B NLMSG_ERROR
åϥ顼򼨤ڥɤˤ
.I nlmsgerr
¤Τ롣
.B NLMSG_DONE
åϥޥѡȥåνλ롣

 netlink եߥ꡼ǻǤåפϡ
̾ä¿˴ؤƤŬڤ man ڡ򸫤Ƥۤ
Ȥ
.I NETLINK_ROUTE
˴ؤƤ
.BR rtnetlink (7)
˽񤤤Ƥ롣

.TS 
tab(:); 
l s 
l l.
.\" XXX describe that
nlmsg_flags ɸե饰ӥå
NLM_F_REQUEST:׵åƤǥåȤ롣
NLM_F_MULTI:T{
ΥåϥޥѡȥåΰǤ롣
ޥѡȥå
.B NLMSG_DONE
ǽü롣
T}
NLM_F_ACK:ֿ롣
NLM_F_ECHO:׵򥨥롣
.TE

.TS
tab(:);
l s 
l l.
GET ׵ˤɲåե饰ӥå
NLM_F_ROOT:ñΥȥǤϤʤơ֥Τ֤
NLM_F_MATCH:ޤƤʤ
NLM_F_ATOMIC:ơ֥ΥȥߥåʥʥåץåȤ֤
NLM_F_DUMP:ޤҤƤʤ
.TE

.TS
tab(:);
l s
l l.
NEW ׵ˤɲåե饰ӥå
NLM_F_REPLACE:¸Υ֥Ȥ񤭤롣
NLM_F_EXCL:Ǥ˥֥Ȥäִʤ
NLM_F_CREATE:ޤ֥Ȥʤк롣
NLM_F_APPEND:֥ȥꥹȤκǸɲä롣
.TE

NLM_F_ATMIC ˤ
.B CAP_NET_ADMIN
¤ޤϥѡ桼¤ɬפǤ롣

.SH ɥ쥹Υեޥå
.B sockaddr_nl
¤Τϥ桼֤䥫֤ͥ netlink 饤Ȥ򵭽Ҥ롣
sockaddr_nl ϥ˥㥹 (ñ³ˤ) ˤǤ뤷
netlink 롼 (nl_groups  0 Ǥʤ) ˤ뤳ȤǤ롣

.RS
.nf
struct sockaddr_nl
{
    sa_family_t nl_family;    /* AF_NETLINK */
    unsigned short nl_pad;    /* zero */
    pid_t       nl_pid;       /* process pid */
    __u32       nl_groups;    /* multicast groups mask */
};
.fi
.RE

.B nl_pid
ŪΥåȤͭƤץ pid Ǥ롣
Ԥ褬ͥξ 0 ˤ롣
.B nl_groups
ϥӥåȥޥǡ٤ƤΥӥåȤ netlink 롼ֹɽ
.\" XXX describe what that is. 
.SH Х
 man ڡϴƤʤ
.SH 
٥Υͥ륤󥿡եꡢ
.B libnetlink
̤ netlink ѤۤɤȤ¿
.SH С
netlink ؤΥåȥ󥿡ե Linux 2.2 οǽǤ롣

Linux 2.0 ϡäȸŪʥǥХ١ netlink 󥿡ե
ݡȤƤ (ߴΤ˺ǤѤǤ)
Ť󥿡ե˴ؤƤϤǤϵҤʤ
.SH Ϣ
.BR cmsg (3),
.BR rtnetlink (7),
.BR netlink (3)
.PP
libnetlink ˴ؤ
ftp://ftp.inr.ac.ru/ip-routing/iproute2*