blob: 4811ec65bc434d012c76bf0e55fb1ec2fec574a1 [file] [log] [blame]
Sven Eckelmann7db7d9f2017-11-19 15:05:11 +01001// SPDX-License-Identifier: GPL-2.0
Sven Eckelmann7a79d712018-12-31 23:59:59 +01002/* Copyright (C) 2007-2019 B.A.T.M.A.N. contributors:
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +00003 *
4 * Marek Lindner, Simon Wunderlich
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +00005 */
6
7#include "main.h"
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +02008
9#include <linux/atomic.h>
Sven Eckelmannecc36f52017-11-19 17:12:03 +010010#include <linux/build_bug.h>
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020011#include <linux/byteorder/generic.h>
12#include <linux/crc32c.h>
Sven Eckelmann0fa4c302019-03-03 18:02:57 +010013#include <linux/device.h>
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020014#include <linux/errno.h>
Sven Eckelmann2c0c06f2016-10-29 13:56:23 +020015#include <linux/genetlink.h>
Sven Eckelmannb92b94a2017-11-19 17:12:02 +010016#include <linux/gfp.h>
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020017#include <linux/if_ether.h>
18#include <linux/if_vlan.h>
19#include <linux/init.h>
20#include <linux/ip.h>
21#include <linux/ipv6.h>
22#include <linux/kernel.h>
Sven Eckelmann0fa4c302019-03-03 18:02:57 +010023#include <linux/kobject.h>
Sven Eckelmannf7157dd2016-01-16 10:29:48 +010024#include <linux/kref.h>
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020025#include <linux/list.h>
26#include <linux/module.h>
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020027#include <linux/netdevice.h>
Sven Eckelmannba412082016-05-15 23:48:31 +020028#include <linux/printk.h>
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020029#include <linux/rculist.h>
30#include <linux/rcupdate.h>
31#include <linux/seq_file.h>
32#include <linux/skbuff.h>
Sven Eckelmann0fa4c302019-03-03 18:02:57 +010033#include <linux/slab.h>
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020034#include <linux/spinlock.h>
35#include <linux/stddef.h>
36#include <linux/string.h>
37#include <linux/workqueue.h>
38#include <net/dsfield.h>
39#include <net/rtnetlink.h>
Sven Eckelmannfec149f2017-12-21 10:17:41 +010040#include <uapi/linux/batadv_packet.h>
Sven Eckelmann2c0c06f2016-10-29 13:56:23 +020041#include <uapi/linux/batman_adv.h>
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020042
43#include "bat_algo.h"
Sven Eckelmanna2d08162016-05-15 11:07:46 +020044#include "bat_iv_ogm.h"
45#include "bat_v.h"
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020046#include "bridge_loop_avoidance.h"
Sven Eckelmannb706b132012-06-10 23:58:51 +020047#include "debugfs.h"
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020048#include "distributed-arp-table.h"
49#include "gateway_client.h"
50#include "gateway_common.h"
51#include "hard-interface.h"
52#include "icmp_socket.h"
Sven Eckelmannba412082016-05-15 23:48:31 +020053#include "log.h"
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020054#include "multicast.h"
Matthias Schiffer09748a22016-05-09 18:41:08 +020055#include "netlink.h"
Sven Eckelmann1e2c2a42015-04-17 19:40:28 +020056#include "network-coding.h"
57#include "originator.h"
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +000058#include "routing.h"
59#include "send.h"
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +000060#include "soft-interface.h"
Antonio Quartulli33a3bb42016-05-05 13:09:43 +020061#include "tp_meter.h"
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +000062#include "translation-table.h"
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +000063
Sven Eckelmannc3caf512011-05-03 11:51:38 +020064/* List manipulations on hardif_list have to be rtnl_lock()'ed,
Sven Eckelmann9cfc7bd2012-05-12 02:09:43 +020065 * list traversals just rcu-locked
66 */
Sven Eckelmann3193e8f2012-05-12 02:09:42 +020067struct list_head batadv_hardif_list;
Sven Eckelmannfb69be62018-10-30 22:01:24 +010068unsigned int batadv_hardif_generation;
Sven Eckelmann706cc9f2017-09-30 09:24:28 +020069static int (*batadv_rx_handler[256])(struct sk_buff *skb,
70 struct batadv_hard_iface *recv_if);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +000071
Sven Eckelmann3193e8f2012-05-12 02:09:42 +020072unsigned char batadv_broadcast_addr[] = {0xff, 0xff, 0xff, 0xff, 0xff, 0xff};
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +000073
Sven Eckelmann3193e8f2012-05-12 02:09:42 +020074struct workqueue_struct *batadv_event_workqueue;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +000075
Sven Eckelmannee11ad62012-05-16 20:23:19 +020076static void batadv_recv_handler_init(void);
Marek Lindnerffa995e2012-03-01 15:35:17 +080077
Sven Eckelmann0fa4c302019-03-03 18:02:57 +010078#define BATADV_UEV_TYPE_VAR "BATTYPE="
79#define BATADV_UEV_ACTION_VAR "BATACTION="
80#define BATADV_UEV_DATA_VAR "BATDATA="
81
82static char *batadv_uev_action_str[] = {
83 "add",
84 "del",
85 "change",
86 "loopdetect",
87};
88
89static char *batadv_uev_type_str[] = {
90 "gw",
91 "bla",
92};
93
Sven Eckelmannee11ad62012-05-16 20:23:19 +020094static int __init batadv_init(void)
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +000095{
Sven Eckelmann86452f82016-06-25 16:44:06 +020096 int ret;
97
98 ret = batadv_tt_cache_init();
99 if (ret < 0)
100 return ret;
101
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200102 INIT_LIST_HEAD(&batadv_hardif_list);
Sven Eckelmann01d350d2016-05-15 11:07:44 +0200103 batadv_algo_init();
Marek Lindner1c280472011-11-28 17:40:17 +0800104
Sven Eckelmannee11ad62012-05-16 20:23:19 +0200105 batadv_recv_handler_init();
Marek Lindnerffa995e2012-03-01 15:35:17 +0800106
Linus Luessingd6f94d92016-01-16 16:40:09 +0800107 batadv_v_init();
Sven Eckelmann81c524f2012-05-12 02:09:22 +0200108 batadv_iv_init();
Matthias Schiffer6c519ba2013-09-27 18:03:39 +0200109 batadv_nc_init();
Antonio Quartulli33a3bb42016-05-05 13:09:43 +0200110 batadv_tp_meter_init();
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000111
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200112 batadv_event_workqueue = create_singlethread_workqueue("bat_events");
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200113 if (!batadv_event_workqueue)
Sven Eckelmann86452f82016-06-25 16:44:06 +0200114 goto err_create_wq;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000115
Sven Eckelmann9039dc72012-05-12 02:09:33 +0200116 batadv_socket_init();
Sven Eckelmann40a072d2012-05-12 02:09:23 +0200117 batadv_debugfs_init();
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000118
Sven Eckelmann95638772012-05-12 02:09:31 +0200119 register_netdevice_notifier(&batadv_hard_if_notifier);
Sven Eckelmanna4ac28c2013-02-11 17:10:26 +0800120 rtnl_link_register(&batadv_link_ops);
Matthias Schiffer09748a22016-05-09 18:41:08 +0200121 batadv_netlink_register();
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000122
Sven Eckelmann86ceb362012-03-07 09:07:45 +0100123 pr_info("B.A.T.M.A.N. advanced %s (compatibility version %i) loaded\n",
Sven Eckelmann42d0b042012-06-03 22:19:17 +0200124 BATADV_SOURCE_VERSION, BATADV_COMPAT_VERSION);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000125
126 return 0;
Sven Eckelmann86452f82016-06-25 16:44:06 +0200127
128err_create_wq:
129 batadv_tt_cache_destroy();
130
131 return -ENOMEM;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000132}
133
Sven Eckelmannee11ad62012-05-16 20:23:19 +0200134static void __exit batadv_exit(void)
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000135{
Sven Eckelmann40a072d2012-05-12 02:09:23 +0200136 batadv_debugfs_destroy();
Matthias Schiffer09748a22016-05-09 18:41:08 +0200137 batadv_netlink_unregister();
Sven Eckelmanna4ac28c2013-02-11 17:10:26 +0800138 rtnl_link_unregister(&batadv_link_ops);
Sven Eckelmann95638772012-05-12 02:09:31 +0200139 unregister_netdevice_notifier(&batadv_hard_if_notifier);
140 batadv_hardif_remove_interfaces();
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000141
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200142 flush_workqueue(batadv_event_workqueue);
143 destroy_workqueue(batadv_event_workqueue);
144 batadv_event_workqueue = NULL;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000145
146 rcu_barrier();
Sven Eckelmann86452f82016-06-25 16:44:06 +0200147
148 batadv_tt_cache_destroy();
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000149}
150
Sven Eckelmannff15c272017-12-02 19:51:53 +0100151/**
152 * batadv_mesh_init() - Initialize soft interface
153 * @soft_iface: netdev struct of the soft interface
154 *
155 * Return: 0 on success or negative error number in case of failure
156 */
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200157int batadv_mesh_init(struct net_device *soft_iface)
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000158{
Sven Eckelmann56303d32012-06-05 22:31:31 +0200159 struct batadv_priv *bat_priv = netdev_priv(soft_iface);
Sven Eckelmann5346c352012-05-05 13:27:28 +0200160 int ret;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000161
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000162 spin_lock_init(&bat_priv->forw_bat_list_lock);
163 spin_lock_init(&bat_priv->forw_bcast_list_lock);
Sven Eckelmann807736f2012-07-15 22:26:51 +0200164 spin_lock_init(&bat_priv->tt.changes_list_lock);
165 spin_lock_init(&bat_priv->tt.req_list_lock);
166 spin_lock_init(&bat_priv->tt.roam_list_lock);
167 spin_lock_init(&bat_priv->tt.last_changeset_lock);
Antonio Quartullia70a9aa2013-07-30 22:16:24 +0200168 spin_lock_init(&bat_priv->tt.commit_lock);
Sven Eckelmann807736f2012-07-15 22:26:51 +0200169 spin_lock_init(&bat_priv->gw.list_lock);
Linus Lüssingab498862014-02-15 17:47:53 +0100170#ifdef CONFIG_BATMAN_ADV_MCAST
Linus Lüssinga3c7cd02019-04-24 03:19:14 +0200171 spin_lock_init(&bat_priv->mcast.mla_lock);
Linus Lüssingab498862014-02-15 17:47:53 +0100172 spin_lock_init(&bat_priv->mcast.want_lists_lock);
173#endif
Marek Lindneref261572013-04-23 21:39:57 +0800174 spin_lock_init(&bat_priv->tvlv.container_list_lock);
175 spin_lock_init(&bat_priv->tvlv.handler_list_lock);
Antonio Quartulli5d2c05b2013-07-02 11:04:34 +0200176 spin_lock_init(&bat_priv->softif_vlan_list_lock);
Antonio Quartulli33a3bb42016-05-05 13:09:43 +0200177 spin_lock_init(&bat_priv->tp_list_lock);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000178
179 INIT_HLIST_HEAD(&bat_priv->forw_bat_list);
180 INIT_HLIST_HEAD(&bat_priv->forw_bcast_list);
Sven Eckelmann70ea5ce2016-07-27 12:31:08 +0200181 INIT_HLIST_HEAD(&bat_priv->gw.gateway_list);
Linus Lüssingab498862014-02-15 17:47:53 +0100182#ifdef CONFIG_BATMAN_ADV_MCAST
183 INIT_HLIST_HEAD(&bat_priv->mcast.want_all_unsnoopables_list);
Linus Lüssing4c8755d2014-02-15 17:47:54 +0100184 INIT_HLIST_HEAD(&bat_priv->mcast.want_all_ipv4_list);
185 INIT_HLIST_HEAD(&bat_priv->mcast.want_all_ipv6_list);
Linus Lüssingab498862014-02-15 17:47:53 +0100186#endif
Sven Eckelmann807736f2012-07-15 22:26:51 +0200187 INIT_LIST_HEAD(&bat_priv->tt.changes_list);
Marek Lindner7c26a532015-06-28 22:16:06 +0800188 INIT_HLIST_HEAD(&bat_priv->tt.req_list);
Sven Eckelmann807736f2012-07-15 22:26:51 +0200189 INIT_LIST_HEAD(&bat_priv->tt.roam_list);
Linus Lüssingc5caf4e2014-02-15 17:47:49 +0100190#ifdef CONFIG_BATMAN_ADV_MCAST
191 INIT_HLIST_HEAD(&bat_priv->mcast.mla_list);
192#endif
Marek Lindneref261572013-04-23 21:39:57 +0800193 INIT_HLIST_HEAD(&bat_priv->tvlv.container_list);
194 INIT_HLIST_HEAD(&bat_priv->tvlv.handler_list);
Antonio Quartulli5d2c05b2013-07-02 11:04:34 +0200195 INIT_HLIST_HEAD(&bat_priv->softif_vlan_list);
Antonio Quartulli33a3bb42016-05-05 13:09:43 +0200196 INIT_HLIST_HEAD(&bat_priv->tp_list);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000197
Sven Eckelmann9264c852018-10-30 22:01:23 +0100198 bat_priv->gw.generation = 0;
199
Antonio Quartulli0da00352016-01-16 16:40:12 +0800200 ret = batadv_v_mesh_init(bat_priv);
201 if (ret < 0)
202 goto err;
203
Sven Eckelmann7d211ef2012-05-12 02:09:34 +0200204 ret = batadv_originator_init(bat_priv);
Sven Eckelmann5346c352012-05-05 13:27:28 +0200205 if (ret < 0)
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000206 goto err;
207
Sven Eckelmann08c36d32012-05-12 02:09:39 +0200208 ret = batadv_tt_init(bat_priv);
Sven Eckelmann5346c352012-05-05 13:27:28 +0200209 if (ret < 0)
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000210 goto err;
211
Sven Eckelmann08adf152012-05-12 13:38:47 +0200212 ret = batadv_bla_init(bat_priv);
Sven Eckelmann5346c352012-05-05 13:27:28 +0200213 if (ret < 0)
Simon Wunderlich23721382012-01-22 20:00:19 +0100214 goto err;
215
Antonio Quartulli2f1dfbe2012-06-30 20:01:19 +0200216 ret = batadv_dat_init(bat_priv);
217 if (ret < 0)
218 goto err;
219
Matthias Schiffer6c519ba2013-09-27 18:03:39 +0200220 ret = batadv_nc_mesh_init(bat_priv);
Martin Hundebølld353d8d2013-01-25 11:12:38 +0100221 if (ret < 0)
222 goto err;
223
Marek Lindner414254e2013-04-23 21:39:58 +0800224 batadv_gw_init(bat_priv);
Linus Lüssing60432d72014-02-15 17:47:51 +0100225 batadv_mcast_init(bat_priv);
Marek Lindner414254e2013-04-23 21:39:58 +0800226
Sven Eckelmann807736f2012-07-15 22:26:51 +0200227 atomic_set(&bat_priv->gw.reselect, 0);
Sven Eckelmann39c75a52012-06-03 22:19:22 +0200228 atomic_set(&bat_priv->mesh_state, BATADV_MESH_ACTIVE);
Sven Eckelmann5346c352012-05-05 13:27:28 +0200229
230 return 0;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000231
232err:
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200233 batadv_mesh_free(soft_iface);
Sven Eckelmann5346c352012-05-05 13:27:28 +0200234 return ret;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000235}
236
Sven Eckelmannff15c272017-12-02 19:51:53 +0100237/**
238 * batadv_mesh_free() - Deinitialize soft interface
239 * @soft_iface: netdev struct of the soft interface
240 */
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200241void batadv_mesh_free(struct net_device *soft_iface)
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000242{
Sven Eckelmann56303d32012-06-05 22:31:31 +0200243 struct batadv_priv *bat_priv = netdev_priv(soft_iface);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000244
Sven Eckelmann39c75a52012-06-03 22:19:22 +0200245 atomic_set(&bat_priv->mesh_state, BATADV_MESH_DEACTIVATING);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000246
Sven Eckelmann9455e342012-05-12 02:09:37 +0200247 batadv_purge_outstanding_packets(bat_priv, NULL);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000248
Simon Wunderlichbd3524c2015-08-03 19:13:58 +0200249 batadv_gw_node_free(bat_priv);
Antonio Quartulli0da00352016-01-16 16:40:12 +0800250
251 batadv_v_mesh_free(bat_priv);
Matthias Schiffer6c519ba2013-09-27 18:03:39 +0200252 batadv_nc_mesh_free(bat_priv);
Antonio Quartullia4361862013-05-07 01:06:18 +0200253 batadv_dat_free(bat_priv);
Sven Eckelmann08adf152012-05-12 13:38:47 +0200254 batadv_bla_free(bat_priv);
Simon Wunderlich23721382012-01-22 20:00:19 +0100255
Linus Lüssingc5caf4e2014-02-15 17:47:49 +0100256 batadv_mcast_free(bat_priv);
257
Antonio Quartullia4361862013-05-07 01:06:18 +0200258 /* Free the TT and the originator tables only after having terminated
259 * all the other depending components which may use these structures for
260 * their purposes.
261 */
262 batadv_tt_free(bat_priv);
263
264 /* Since the originator table clean up routine is accessing the TT
265 * tables as well, it has to be invoked after the TT tables have been
266 * freed and marked as empty. This ensures that no cleanup RCU callbacks
267 * accessing the TT data are scheduled for later execution.
268 */
269 batadv_originator_free(bat_priv);
Antonio Quartulli2f1dfbe2012-06-30 20:01:19 +0200270
Marek Lindner414254e2013-04-23 21:39:58 +0800271 batadv_gw_free(bat_priv);
272
Martin Hundebøllf8214862012-04-20 17:02:45 +0200273 free_percpu(bat_priv->bat_counters);
Martin Hundebøllf69ae772013-04-17 21:13:16 +0200274 bat_priv->bat_counters = NULL;
Martin Hundebøllf8214862012-04-20 17:02:45 +0200275
Sven Eckelmann39c75a52012-06-03 22:19:22 +0200276 atomic_set(&bat_priv->mesh_state, BATADV_MESH_INACTIVE);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000277}
278
David S. Miller6e0895c2013-04-22 20:32:51 -0400279/**
Sven Eckelmann7e9a8c22017-12-02 19:51:47 +0100280 * batadv_is_my_mac() - check if the given mac address belongs to any of the
281 * real interfaces in the current mesh
David S. Miller6e0895c2013-04-22 20:32:51 -0400282 * @bat_priv: the bat priv with all the soft interface information
283 * @addr: the address to check
Markus Pargmanne8ad3b12014-12-26 12:41:38 +0100284 *
Sven Eckelmann62fe7102015-09-15 19:00:48 +0200285 * Return: 'true' if the mac address was found, false otherwise.
David S. Miller6e0895c2013-04-22 20:32:51 -0400286 */
Sven Eckelmann6b5e9712015-05-26 18:34:26 +0200287bool batadv_is_my_mac(struct batadv_priv *bat_priv, const u8 *addr)
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000288{
Sven Eckelmann56303d32012-06-05 22:31:31 +0200289 const struct batadv_hard_iface *hard_iface;
Markus Pargmanne8ad3b12014-12-26 12:41:38 +0100290 bool is_my_mac = false;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000291
292 rcu_read_lock();
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200293 list_for_each_entry_rcu(hard_iface, &batadv_hardif_list, list) {
Sven Eckelmanne9a4f292012-06-03 22:19:19 +0200294 if (hard_iface->if_status != BATADV_IF_ACTIVE)
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000295 continue;
296
Antonio Quartullife8a93b2013-04-03 19:10:26 +0200297 if (hard_iface->soft_iface != bat_priv->soft_iface)
298 continue;
299
Sven Eckelmann1eda58b2012-05-12 13:48:58 +0200300 if (batadv_compare_eth(hard_iface->net_dev->dev_addr, addr)) {
Markus Pargmanne8ad3b12014-12-26 12:41:38 +0100301 is_my_mac = true;
302 break;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000303 }
304 }
305 rcu_read_unlock();
Markus Pargmanne8ad3b12014-12-26 12:41:38 +0100306 return is_my_mac;
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000307}
308
Sven Eckelmanndc1cbd12016-07-16 09:31:20 +0200309#ifdef CONFIG_BATMAN_ADV_DEBUGFS
Marek Lindner30da63a2012-08-03 17:15:46 +0200310/**
Sven Eckelmann7e9a8c22017-12-02 19:51:47 +0100311 * batadv_seq_print_text_primary_if_get() - called from debugfs table printing
Marek Lindner30da63a2012-08-03 17:15:46 +0200312 * function that requires the primary interface
313 * @seq: debugfs table seq_file struct
314 *
Sven Eckelmann62fe7102015-09-15 19:00:48 +0200315 * Return: primary interface if found or NULL otherwise.
Marek Lindner30da63a2012-08-03 17:15:46 +0200316 */
317struct batadv_hard_iface *
318batadv_seq_print_text_primary_if_get(struct seq_file *seq)
319{
320 struct net_device *net_dev = (struct net_device *)seq->private;
321 struct batadv_priv *bat_priv = netdev_priv(net_dev);
322 struct batadv_hard_iface *primary_if;
323
324 primary_if = batadv_primary_if_get_selected(bat_priv);
325
326 if (!primary_if) {
327 seq_printf(seq,
328 "BATMAN mesh %s disabled - please specify interfaces to enable it\n",
329 net_dev->name);
330 goto out;
331 }
332
333 if (primary_if->if_status == BATADV_IF_ACTIVE)
334 goto out;
335
336 seq_printf(seq,
337 "BATMAN mesh %s disabled - primary interface not active\n",
338 net_dev->name);
Sven Eckelmann82047ad2016-01-17 11:01:10 +0100339 batadv_hardif_put(primary_if);
Marek Lindner30da63a2012-08-03 17:15:46 +0200340 primary_if = NULL;
341
342out:
343 return primary_if;
344}
Sven Eckelmanndc1cbd12016-07-16 09:31:20 +0200345#endif
Marek Lindner30da63a2012-08-03 17:15:46 +0200346
Simon Wunderlichc54f38c2013-07-29 17:56:44 +0200347/**
Sven Eckelmann7e9a8c22017-12-02 19:51:47 +0100348 * batadv_max_header_len() - calculate maximum encapsulation overhead for a
Marek Lindner411d6ed2013-05-08 13:31:59 +0800349 * payload packet
350 *
Sven Eckelmann62fe7102015-09-15 19:00:48 +0200351 * Return: the maximum encapsulation overhead in bytes.
Marek Lindner411d6ed2013-05-08 13:31:59 +0800352 */
353int batadv_max_header_len(void)
354{
355 int header_len = 0;
356
357 header_len = max_t(int, header_len,
358 sizeof(struct batadv_unicast_packet));
359 header_len = max_t(int, header_len,
360 sizeof(struct batadv_unicast_4addr_packet));
361 header_len = max_t(int, header_len,
362 sizeof(struct batadv_bcast_packet));
363
364#ifdef CONFIG_BATMAN_ADV_NC
365 header_len = max_t(int, header_len,
366 sizeof(struct batadv_coded_packet));
367#endif
368
Marek Lindner1df0cbd2014-01-15 20:31:18 +0800369 return header_len + ETH_HLEN;
Marek Lindner411d6ed2013-05-08 13:31:59 +0800370}
371
372/**
Sven Eckelmann7e9a8c22017-12-02 19:51:47 +0100373 * batadv_skb_set_priority() - sets skb priority according to packet content
Simon Wunderlichc54f38c2013-07-29 17:56:44 +0200374 * @skb: the packet to be sent
375 * @offset: offset to the packet content
376 *
377 * This function sets a value between 256 and 263 (802.1d priority), which
378 * can be interpreted by the cfg80211 or other drivers.
379 */
380void batadv_skb_set_priority(struct sk_buff *skb, int offset)
381{
382 struct iphdr ip_hdr_tmp, *ip_hdr;
383 struct ipv6hdr ip6_hdr_tmp, *ip6_hdr;
384 struct ethhdr ethhdr_tmp, *ethhdr;
385 struct vlan_ethhdr *vhdr, vhdr_tmp;
386 u32 prio;
387
388 /* already set, do nothing */
389 if (skb->priority >= 256 && skb->priority <= 263)
390 return;
391
392 ethhdr = skb_header_pointer(skb, offset, sizeof(*ethhdr), &ethhdr_tmp);
393 if (!ethhdr)
394 return;
395
396 switch (ethhdr->h_proto) {
397 case htons(ETH_P_8021Q):
398 vhdr = skb_header_pointer(skb, offset + sizeof(*vhdr),
399 sizeof(*vhdr), &vhdr_tmp);
400 if (!vhdr)
401 return;
402 prio = ntohs(vhdr->h_vlan_TCI) & VLAN_PRIO_MASK;
403 prio = prio >> VLAN_PRIO_SHIFT;
404 break;
405 case htons(ETH_P_IP):
406 ip_hdr = skb_header_pointer(skb, offset + sizeof(*ethhdr),
407 sizeof(*ip_hdr), &ip_hdr_tmp);
408 if (!ip_hdr)
409 return;
410 prio = (ipv4_get_dsfield(ip_hdr) & 0xfc) >> 5;
411 break;
412 case htons(ETH_P_IPV6):
413 ip6_hdr = skb_header_pointer(skb, offset + sizeof(*ethhdr),
414 sizeof(*ip6_hdr), &ip6_hdr_tmp);
415 if (!ip6_hdr)
416 return;
417 prio = (ipv6_get_dsfield(ip6_hdr) & 0xfc) >> 5;
418 break;
419 default:
420 return;
421 }
422
423 skb->priority = prio + 256;
424}
425
Sven Eckelmannee11ad62012-05-16 20:23:19 +0200426static int batadv_recv_unhandled_packet(struct sk_buff *skb,
Sven Eckelmann56303d32012-06-05 22:31:31 +0200427 struct batadv_hard_iface *recv_if)
Marek Lindnerffa995e2012-03-01 15:35:17 +0800428{
Sven Eckelmannb91a2542016-07-17 21:04:04 +0200429 kfree_skb(skb);
430
Marek Lindnerffa995e2012-03-01 15:35:17 +0800431 return NET_RX_DROP;
432}
433
434/* incoming packets with the batman ethertype received on any active hard
435 * interface
436 */
Sven Eckelmannff15c272017-12-02 19:51:53 +0100437
438/**
439 * batadv_batman_skb_recv() - Handle incoming message from an hard interface
440 * @skb: the received packet
441 * @dev: the net device that the packet was received on
442 * @ptype: packet type of incoming packet (ETH_P_BATMAN)
443 * @orig_dev: the original receive net device (e.g. bonded device)
444 *
445 * Return: NET_RX_SUCCESS on success or NET_RX_DROP in case of failure
446 */
Sven Eckelmann3193e8f2012-05-12 02:09:42 +0200447int batadv_batman_skb_recv(struct sk_buff *skb, struct net_device *dev,
448 struct packet_type *ptype,
449 struct net_device *orig_dev)
Marek Lindnerffa995e2012-03-01 15:35:17 +0800450{
Sven Eckelmann56303d32012-06-05 22:31:31 +0200451 struct batadv_priv *bat_priv;
Sven Eckelmann96412692012-06-05 22:31:30 +0200452 struct batadv_ogm_packet *batadv_ogm_packet;
Sven Eckelmann56303d32012-06-05 22:31:31 +0200453 struct batadv_hard_iface *hard_iface;
Sven Eckelmann6b5e9712015-05-26 18:34:26 +0200454 u8 idx;
Marek Lindnerffa995e2012-03-01 15:35:17 +0800455
Sven Eckelmann56303d32012-06-05 22:31:31 +0200456 hard_iface = container_of(ptype, struct batadv_hard_iface,
457 batman_adv_ptype);
Sven Eckelmann4fe56e62016-03-05 16:09:17 +0100458
459 /* Prevent processing a packet received on an interface which is getting
460 * shut down otherwise the packet may trigger de-reference errors
461 * further down in the receive path.
462 */
463 if (!kref_get_unless_zero(&hard_iface->refcount))
464 goto err_out;
465
Marek Lindnerffa995e2012-03-01 15:35:17 +0800466 skb = skb_share_check(skb, GFP_ATOMIC);
467
468 /* skb was released by skb_share_check() */
469 if (!skb)
Sven Eckelmann4fe56e62016-03-05 16:09:17 +0100470 goto err_put;
Marek Lindnerffa995e2012-03-01 15:35:17 +0800471
472 /* packet should hold at least type and version */
473 if (unlikely(!pskb_may_pull(skb, 2)))
474 goto err_free;
475
476 /* expect a valid ethernet header here. */
477 if (unlikely(skb->mac_len != ETH_HLEN || !skb_mac_header(skb)))
478 goto err_free;
479
480 if (!hard_iface->soft_iface)
481 goto err_free;
482
483 bat_priv = netdev_priv(hard_iface->soft_iface);
484
Sven Eckelmann39c75a52012-06-03 22:19:22 +0200485 if (atomic_read(&bat_priv->mesh_state) != BATADV_MESH_ACTIVE)
Marek Lindnerffa995e2012-03-01 15:35:17 +0800486 goto err_free;
487
488 /* discard frames on not active interfaces */
Sven Eckelmanne9a4f292012-06-03 22:19:19 +0200489 if (hard_iface->if_status != BATADV_IF_ACTIVE)
Marek Lindnerffa995e2012-03-01 15:35:17 +0800490 goto err_free;
491
Sven Eckelmann96412692012-06-05 22:31:30 +0200492 batadv_ogm_packet = (struct batadv_ogm_packet *)skb->data;
Marek Lindnerffa995e2012-03-01 15:35:17 +0800493
Simon Wunderlicha40d9b02013-12-02 20:38:31 +0100494 if (batadv_ogm_packet->version != BATADV_COMPAT_VERSION) {
Sven Eckelmann39c75a52012-06-03 22:19:22 +0200495 batadv_dbg(BATADV_DBG_BATMAN, bat_priv,
Sven Eckelmann1eda58b2012-05-12 13:48:58 +0200496 "Drop packet: incompatible batman version (%i)\n",
Simon Wunderlicha40d9b02013-12-02 20:38:31 +0100497 batadv_ogm_packet->version);
Marek Lindnerffa995e2012-03-01 15:35:17 +0800498 goto err_free;
499 }
500
Martin Hundebølle0d96772014-09-17 08:56:19 +0200501 /* reset control block to avoid left overs from previous users */
502 memset(skb->cb, 0, sizeof(struct batadv_skb_cb));
503
Simon Wunderlicha40d9b02013-12-02 20:38:31 +0100504 idx = batadv_ogm_packet->packet_type;
Sven Eckelmannb91a2542016-07-17 21:04:04 +0200505 (*batadv_rx_handler[idx])(skb, hard_iface);
Marek Lindnerffa995e2012-03-01 15:35:17 +0800506
Sven Eckelmann4fe56e62016-03-05 16:09:17 +0100507 batadv_hardif_put(hard_iface);
508
Marek Lindnerffa995e2012-03-01 15:35:17 +0800509 /* return NET_RX_SUCCESS in any case as we
510 * most probably dropped the packet for
511 * routing-logical reasons.
512 */
513 return NET_RX_SUCCESS;
514
515err_free:
516 kfree_skb(skb);
Sven Eckelmann4fe56e62016-03-05 16:09:17 +0100517err_put:
518 batadv_hardif_put(hard_iface);
Marek Lindnerffa995e2012-03-01 15:35:17 +0800519err_out:
520 return NET_RX_DROP;
521}
522
Sven Eckelmannee11ad62012-05-16 20:23:19 +0200523static void batadv_recv_handler_init(void)
Marek Lindnerffa995e2012-03-01 15:35:17 +0800524{
525 int i;
526
Sven Eckelmannee11ad62012-05-16 20:23:19 +0200527 for (i = 0; i < ARRAY_SIZE(batadv_rx_handler); i++)
528 batadv_rx_handler[i] = batadv_recv_unhandled_packet;
Marek Lindnerffa995e2012-03-01 15:35:17 +0800529
Simon Wunderlicha1f1ac52013-04-25 10:37:23 +0200530 for (i = BATADV_UNICAST_MIN; i <= BATADV_UNICAST_MAX; i++)
531 batadv_rx_handler[i] = batadv_recv_unhandled_unicast_packet;
532
Simon Wunderlich031ace82013-12-17 19:12:12 +0100533 /* compile time checks for sizes */
534 BUILD_BUG_ON(sizeof(struct batadv_bla_claim_dst) != 6);
535 BUILD_BUG_ON(sizeof(struct batadv_ogm_packet) != 24);
536 BUILD_BUG_ON(sizeof(struct batadv_icmp_header) != 20);
537 BUILD_BUG_ON(sizeof(struct batadv_icmp_packet) != 20);
538 BUILD_BUG_ON(sizeof(struct batadv_icmp_packet_rr) != 116);
539 BUILD_BUG_ON(sizeof(struct batadv_unicast_packet) != 10);
540 BUILD_BUG_ON(sizeof(struct batadv_unicast_4addr_packet) != 18);
541 BUILD_BUG_ON(sizeof(struct batadv_frag_packet) != 20);
542 BUILD_BUG_ON(sizeof(struct batadv_bcast_packet) != 14);
543 BUILD_BUG_ON(sizeof(struct batadv_coded_packet) != 46);
544 BUILD_BUG_ON(sizeof(struct batadv_unicast_tvlv_packet) != 20);
545 BUILD_BUG_ON(sizeof(struct batadv_tvlv_hdr) != 4);
546 BUILD_BUG_ON(sizeof(struct batadv_tvlv_gateway_data) != 8);
547 BUILD_BUG_ON(sizeof(struct batadv_tvlv_tt_vlan_data) != 8);
548 BUILD_BUG_ON(sizeof(struct batadv_tvlv_tt_change) != 12);
549 BUILD_BUG_ON(sizeof(struct batadv_tvlv_roam_adv) != 8);
Simon Wunderlich80067c82013-04-25 10:37:22 +0200550
Pankaj Bharadiyac5936422019-12-09 10:31:43 -0800551 i = sizeof_field(struct sk_buff, cb);
Linus Lüssinge2d9ba42017-02-17 11:17:07 +0100552 BUILD_BUG_ON(sizeof(struct batadv_skb_cb) > i);
553
Simon Wunderlicha1f1ac52013-04-25 10:37:23 +0200554 /* broadcast packet */
555 batadv_rx_handler[BATADV_BCAST] = batadv_recv_bcast_packet;
556
557 /* unicast packets ... */
Antonio Quartulli7cdcf6d2012-10-01 09:57:35 +0200558 /* unicast with 4 addresses packet */
559 batadv_rx_handler[BATADV_UNICAST_4ADDR] = batadv_recv_unicast_packet;
Marek Lindnerffa995e2012-03-01 15:35:17 +0800560 /* unicast packet */
Sven Eckelmannacd34af2012-06-03 22:19:21 +0200561 batadv_rx_handler[BATADV_UNICAST] = batadv_recv_unicast_packet;
Marek Lindneref261572013-04-23 21:39:57 +0800562 /* unicast tvlv packet */
563 batadv_rx_handler[BATADV_UNICAST_TVLV] = batadv_recv_unicast_tvlv;
Simon Wunderlicha1f1ac52013-04-25 10:37:23 +0200564 /* batman icmp packet */
565 batadv_rx_handler[BATADV_ICMP] = batadv_recv_icmp_packet;
Martin Hundebøll610bfc6bc2013-05-23 16:53:02 +0200566 /* Fragmented packets */
567 batadv_rx_handler[BATADV_UNICAST_FRAG] = batadv_recv_frag_packet;
Marek Lindnerffa995e2012-03-01 15:35:17 +0800568}
569
Sven Eckelmannff15c272017-12-02 19:51:53 +0100570/**
571 * batadv_recv_handler_register() - Register handler for batman-adv packet type
572 * @packet_type: batadv_packettype which should be handled
573 * @recv_handler: receive handler for the packet type
574 *
575 * Return: 0 on success or negative error number in case of failure
576 */
Sven Eckelmann56303d32012-06-05 22:31:31 +0200577int
Sven Eckelmann6b5e9712015-05-26 18:34:26 +0200578batadv_recv_handler_register(u8 packet_type,
Sven Eckelmann56303d32012-06-05 22:31:31 +0200579 int (*recv_handler)(struct sk_buff *,
580 struct batadv_hard_iface *))
Marek Lindnerffa995e2012-03-01 15:35:17 +0800581{
Sven Eckelmann706cc9f2017-09-30 09:24:28 +0200582 int (*curr)(struct sk_buff *skb,
583 struct batadv_hard_iface *recv_if);
Simon Wunderlicha1f1ac52013-04-25 10:37:23 +0200584 curr = batadv_rx_handler[packet_type];
585
Sven Eckelmann825ffe12017-08-23 21:52:13 +0200586 if (curr != batadv_recv_unhandled_packet &&
587 curr != batadv_recv_unhandled_unicast_packet)
Marek Lindnerffa995e2012-03-01 15:35:17 +0800588 return -EBUSY;
589
Sven Eckelmannee11ad62012-05-16 20:23:19 +0200590 batadv_rx_handler[packet_type] = recv_handler;
Marek Lindnerffa995e2012-03-01 15:35:17 +0800591 return 0;
592}
593
Sven Eckelmannff15c272017-12-02 19:51:53 +0100594/**
595 * batadv_recv_handler_unregister() - Unregister handler for packet type
596 * @packet_type: batadv_packettype which should no longer be handled
597 */
Sven Eckelmann6b5e9712015-05-26 18:34:26 +0200598void batadv_recv_handler_unregister(u8 packet_type)
Marek Lindnerffa995e2012-03-01 15:35:17 +0800599{
Sven Eckelmannee11ad62012-05-16 20:23:19 +0200600 batadv_rx_handler[packet_type] = batadv_recv_unhandled_packet;
Marek Lindnerffa995e2012-03-01 15:35:17 +0800601}
602
Sven Eckelmann95a066d2012-10-17 21:10:39 +0200603/**
Sven Eckelmann7e9a8c22017-12-02 19:51:47 +0100604 * batadv_skb_crc32() - calculate CRC32 of the whole packet and skip bytes in
Sven Eckelmann95a066d2012-10-17 21:10:39 +0200605 * the header
606 * @skb: skb pointing to fragmented socket buffers
607 * @payload_ptr: Pointer to position inside the head buffer of the skb
608 * marking the start of the data to be CRC'ed
609 *
610 * payload_ptr must always point to an address in the skb head buffer and not to
611 * a fragment.
Sven Eckelmann7afcbbe2015-10-31 12:29:29 +0100612 *
613 * Return: big endian crc32c of the checksummed data
Sven Eckelmann95a066d2012-10-17 21:10:39 +0200614 */
615__be32 batadv_skb_crc32(struct sk_buff *skb, u8 *payload_ptr)
616{
617 u32 crc = 0;
618 unsigned int from;
619 unsigned int to = skb->len;
620 struct skb_seq_state st;
621 const u8 *data;
622 unsigned int len;
623 unsigned int consumed = 0;
624
625 from = (unsigned int)(payload_ptr - skb->data);
626
627 skb_prepare_seq_read(skb, from, to, &st);
628 while ((len = skb_seq_read(consumed, &data, &st)) != 0) {
629 crc = crc32c(crc, data, len);
630 consumed += len;
631 }
Sven Eckelmann95a066d2012-10-17 21:10:39 +0200632
633 return htonl(crc);
634}
635
Marek Lindneref261572013-04-23 21:39:57 +0800636/**
Sven Eckelmann7e9a8c22017-12-02 19:51:47 +0100637 * batadv_get_vid() - extract the VLAN identifier from skb if any
Antonio Quartullic018ad32013-06-04 12:11:39 +0200638 * @skb: the buffer containing the packet
639 * @header_len: length of the batman header preceding the ethernet header
640 *
Sven Eckelmann62fe7102015-09-15 19:00:48 +0200641 * Return: VID with the BATADV_VLAN_HAS_TAG flag when the packet embedded in the
642 * skb is vlan tagged. Otherwise BATADV_NO_FLAGS.
Antonio Quartullic018ad32013-06-04 12:11:39 +0200643 */
644unsigned short batadv_get_vid(struct sk_buff *skb, size_t header_len)
645{
646 struct ethhdr *ethhdr = (struct ethhdr *)(skb->data + header_len);
647 struct vlan_ethhdr *vhdr;
648 unsigned short vid;
649
650 if (ethhdr->h_proto != htons(ETH_P_8021Q))
651 return BATADV_NO_FLAGS;
652
653 if (!pskb_may_pull(skb, header_len + VLAN_ETH_HLEN))
654 return BATADV_NO_FLAGS;
655
656 vhdr = (struct vlan_ethhdr *)(skb->data + header_len);
657 vid = ntohs(vhdr->h_vlan_TCI) & VLAN_VID_MASK;
658 vid |= BATADV_VLAN_HAS_TAG;
659
660 return vid;
661}
662
Antonio Quartullieceb22a2013-11-16 12:03:51 +0100663/**
Sven Eckelmann7e9a8c22017-12-02 19:51:47 +0100664 * batadv_vlan_ap_isola_get() - return AP isolation status for the given vlan
Antonio Quartullieceb22a2013-11-16 12:03:51 +0100665 * @bat_priv: the bat priv with all the soft interface information
666 * @vid: the VLAN identifier for which the AP isolation attributed as to be
667 * looked up
668 *
Sven Eckelmann62fe7102015-09-15 19:00:48 +0200669 * Return: true if AP isolation is on for the VLAN idenfied by vid, false
Antonio Quartullieceb22a2013-11-16 12:03:51 +0100670 * otherwise
671 */
672bool batadv_vlan_ap_isola_get(struct batadv_priv *bat_priv, unsigned short vid)
673{
674 bool ap_isolation_enabled = false;
675 struct batadv_softif_vlan *vlan;
676
677 /* if the AP isolation is requested on a VLAN, then check for its
678 * setting in the proper VLAN private data structure
679 */
680 vlan = batadv_softif_vlan_get(bat_priv, vid);
681 if (vlan) {
682 ap_isolation_enabled = atomic_read(&vlan->ap_isolation);
Sven Eckelmann9c3bf082016-01-17 11:01:21 +0100683 batadv_softif_vlan_put(vlan);
Antonio Quartullieceb22a2013-11-16 12:03:51 +0100684 }
685
686 return ap_isolation_enabled;
687}
688
Sven Eckelmann0fa4c302019-03-03 18:02:57 +0100689/**
690 * batadv_throw_uevent() - Send an uevent with batman-adv specific env data
691 * @bat_priv: the bat priv with all the soft interface information
692 * @type: subsystem type of event. Stored in uevent's BATTYPE
693 * @action: action type of event. Stored in uevent's BATACTION
694 * @data: string with additional information to the event (ignored for
695 * BATADV_UEV_DEL). Stored in uevent's BATDATA
696 *
697 * Return: 0 on success or negative error number in case of failure
698 */
699int batadv_throw_uevent(struct batadv_priv *bat_priv, enum batadv_uev_type type,
700 enum batadv_uev_action action, const char *data)
701{
702 int ret = -ENOMEM;
703 struct kobject *bat_kobj;
704 char *uevent_env[4] = { NULL, NULL, NULL, NULL };
705
706 bat_kobj = &bat_priv->soft_iface->dev.kobj;
707
708 uevent_env[0] = kasprintf(GFP_ATOMIC,
709 "%s%s", BATADV_UEV_TYPE_VAR,
710 batadv_uev_type_str[type]);
711 if (!uevent_env[0])
712 goto out;
713
714 uevent_env[1] = kasprintf(GFP_ATOMIC,
715 "%s%s", BATADV_UEV_ACTION_VAR,
716 batadv_uev_action_str[action]);
717 if (!uevent_env[1])
718 goto out;
719
720 /* If the event is DEL, ignore the data field */
721 if (action != BATADV_UEV_DEL) {
722 uevent_env[2] = kasprintf(GFP_ATOMIC,
723 "%s%s", BATADV_UEV_DATA_VAR, data);
724 if (!uevent_env[2])
725 goto out;
726 }
727
728 ret = kobject_uevent_env(bat_kobj, KOBJ_CHANGE, uevent_env);
729out:
730 kfree(uevent_env[0]);
731 kfree(uevent_env[1]);
732 kfree(uevent_env[2]);
733
734 if (ret)
735 batadv_dbg(BATADV_DBG_BATMAN, bat_priv,
736 "Impossible to send uevent for (%s,%s,%s) event (err: %d)\n",
737 batadv_uev_type_str[type],
738 batadv_uev_action_str[action],
739 (action == BATADV_UEV_DEL ? "NULL" : data), ret);
740 return ret;
741}
742
Sven Eckelmannee11ad62012-05-16 20:23:19 +0200743module_init(batadv_init);
744module_exit(batadv_exit);
Sven Eckelmannc6c8fea2010-12-13 11:19:28 +0000745
746MODULE_LICENSE("GPL");
747
Sven Eckelmann42d0b042012-06-03 22:19:17 +0200748MODULE_AUTHOR(BATADV_DRIVER_AUTHOR);
749MODULE_DESCRIPTION(BATADV_DRIVER_DESC);
750MODULE_SUPPORTED_DEVICE(BATADV_DRIVER_DEVICE);
751MODULE_VERSION(BATADV_SOURCE_VERSION);
Sven Eckelmann9791860c2016-06-10 23:00:55 +0200752MODULE_ALIAS_RTNL_LINK("batadv");
Sven Eckelmann2c0c06f2016-10-29 13:56:23 +0200753MODULE_ALIAS_GENL_FAMILY(BATADV_NL_NAME);