libnl 3.5.0

rtnl.c
1 /* SPDX-License-Identifier: LGPL-2.1-only */
2 /*
3 * lib/route/rtnl.c Routing Netlink
4 *
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation version 2.1
8 * of the License.
9 *
10 * Copyright (c) 2003-2012 Thomas Graf <tgraf@suug.ch>
11 */
12
13 /**
14 * @defgroup rtnl Routing Library (libnl-route)
15 * @{
16 */
17
18 #include <netlink-private/netlink.h>
19 #include <netlink/netlink.h>
20 #include <netlink/utils.h>
21 #include <netlink/route/rtnl.h>
22
23 /**
24 * @name Sending
25 * @{
26 */
27
28 /**
29 * Send routing netlink request message
30 * @arg sk Netlink socket.
31 * @arg type Netlink message type.
32 * @arg family Address family.
33 * @arg flags Additional netlink message flags.
34 *
35 * Fills out a routing netlink request message and sends it out
36 * using nl_send_simple().
37 *
38 * @return 0 on success or a negative error code. Due to a bug in older
39 * version of the library, this function returned the number of bytes sent.
40 * Treat any non-negative number as success.
41 */
42 int nl_rtgen_request(struct nl_sock *sk, int type, int family, int flags)
43 {
44 int err;
45 struct rtgenmsg gmsg = {
46 .rtgen_family = family,
47 };
48
49 err = nl_send_simple(sk, type, flags, &gmsg, sizeof(gmsg));
50
51 return err >= 0 ? 0 : err;
52 }
53
54 /** @} */
55
56 /**
57 * @name Routing Type Translations
58 * @{
59 */
60
61 static const struct trans_tbl rtntypes[] = {
62 __ADD(RTN_UNSPEC,unspec),
63 __ADD(RTN_UNICAST,unicast),
64 __ADD(RTN_LOCAL,local),
65 __ADD(RTN_BROADCAST,broadcast),
66 __ADD(RTN_ANYCAST,anycast),
67 __ADD(RTN_MULTICAST,multicast),
68 __ADD(RTN_BLACKHOLE,blackhole),
69 __ADD(RTN_UNREACHABLE,unreachable),
70 __ADD(RTN_PROHIBIT,prohibit),
71 __ADD(RTN_THROW,throw),
72 __ADD(RTN_NAT,nat),
73 __ADD(RTN_XRESOLVE,xresolve),
74 };
75
76 char *nl_rtntype2str(int type, char *buf, size_t size)
77 {
78 return __type2str(type, buf, size, rtntypes, ARRAY_SIZE(rtntypes));
79 }
80
81 int nl_str2rtntype(const char *name)
82 {
83 return __str2type(name, rtntypes, ARRAY_SIZE(rtntypes));
84 }
85
86 /** @} */
87
88 /**
89 * @name Scope Translations
90 * @{
91 */
92
93 static const struct trans_tbl scopes[] = {
94 __ADD(255,nowhere),
95 __ADD(254,host),
96 __ADD(253,link),
97 __ADD(200,site),
98 __ADD(0,global),
99 };
100
101 char *rtnl_scope2str(int scope, char *buf, size_t size)
102 {
103 return __type2str(scope, buf, size, scopes, ARRAY_SIZE(scopes));
104 }
105
106 int rtnl_str2scope(const char *name)
107 {
108 return __str2type(name, scopes, ARRAY_SIZE(scopes));
109 }
110
111 /** @} */
112
113 /**
114 * @name Realms Translations
115 * @{
116 */
117
118 char * rtnl_realms2str(uint32_t realms, char *buf, size_t len)
119 {
120 int from = RTNL_REALM_FROM(realms);
121 int to = RTNL_REALM_TO(realms);
122
123 snprintf(buf, len, "%d/%d", from, to);
124
125 return buf;
126 }
127
128 /** @} */
129
130 /** @} */
RTNL_REALM_TO
#define RTNL_REALM_TO(realm)
Extract TO realm from a realms field.
Definition: rtnl.h:40
RTNL_REALM_FROM
#define RTNL_REALM_FROM(realm)
Extract FROM realm from a realms field.
Definition: rtnl.h:35
nl_rtgen_request
int nl_rtgen_request(struct nl_sock *sk, int type, int family, int flags)
Send routing netlink request message.
Definition: rtnl.c:42
nl_send_simple
int nl_send_simple(struct nl_sock *sk, int type, int flags, void *buf, size_t size)
Construct and transmit a Netlink message.
Definition: nl.c:581