1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2#ifndef _UAPI__LINUX_IF_ADDR_H
3#define _UAPI__LINUX_IF_ADDR_H
4
5#include <linux/types.h>
6#include <linux/netlink.h>
7
8struct ifaddrmsg {
9 __u8 ifa_family;
10 __u8 ifa_prefixlen; /* The prefix length */
11 __u8 ifa_flags; /* Flags */
12 __u8 ifa_scope; /* Address scope */
13 __u32 ifa_index; /* Link index */
14};
15
16/*
17 * Important comment:
18 * IFA_ADDRESS is prefix address, rather than local interface address.
19 * It makes no difference for normally configured broadcast interfaces,
20 * but for point-to-point IFA_ADDRESS is DESTINATION address,
21 * local address is supplied in IFA_LOCAL attribute.
22 *
23 * IFA_FLAGS is a u32 attribute that extends the u8 field ifa_flags.
24 * If present, the value from struct ifaddrmsg will be ignored.
25 */
26enum {
27 IFA_UNSPEC,
28 IFA_ADDRESS,
29 IFA_LOCAL,
30 IFA_LABEL,
31 IFA_BROADCAST,
32 IFA_ANYCAST,
33 IFA_CACHEINFO,
34 IFA_MULTICAST,
35 IFA_FLAGS,
36 IFA_RT_PRIORITY, /* u32, priority/metric for prefix route */
37 IFA_TARGET_NETNSID,
38 IFA_PROTO, /* u8, address protocol */
39 __IFA_MAX,
40};
41
42#define IFA_MAX (__IFA_MAX - 1)
43
44/* ifa_flags */
45#define IFA_F_SECONDARY 0x01
46#define IFA_F_TEMPORARY IFA_F_SECONDARY
47
48#define IFA_F_NODAD 0x02
49#define IFA_F_OPTIMISTIC 0x04
50#define IFA_F_DADFAILED 0x08
51#define IFA_F_HOMEADDRESS 0x10
52#define IFA_F_DEPRECATED 0x20
53#define IFA_F_TENTATIVE 0x40
54#define IFA_F_PERMANENT 0x80
55#define IFA_F_MANAGETEMPADDR 0x100
56#define IFA_F_NOPREFIXROUTE 0x200
57#define IFA_F_MCAUTOJOIN 0x400
58#define IFA_F_STABLE_PRIVACY 0x800
59
60struct ifa_cacheinfo {
61 __u32 ifa_prefered;
62 __u32 ifa_valid;
63 __u32 cstamp; /* created timestamp, hundredths of seconds */
64 __u32 tstamp; /* updated timestamp, hundredths of seconds */
65};
66
67/* backwards compatibility for userspace */
68#ifndef __KERNEL__
69#define IFA_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct ifaddrmsg))))
70#define IFA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct ifaddrmsg))
71#endif
72
73/* ifa_proto */
74#define IFAPROT_UNSPEC 0
75#define IFAPROT_KERNEL_LO 1 /* loopback */
76#define IFAPROT_KERNEL_RA 2 /* set by kernel from router announcement */
77#define IFAPROT_KERNEL_LL 3 /* link-local set by kernel */
78
79#endif
80