ixgbe: add support for 82599 KR device 0x1517
[deliverable/linux.git] / net / ipv4 / inet_hashtables.c
CommitLineData
77d8bf9c
ACM
1/*
2 * INET An implementation of the TCP/IP protocol suite for the LINUX
3 * operating system. INET is implemented using the BSD Socket
4 * interface as the means of communication with the user level.
5 *
6 * Generic INET transport hashtables
7 *
8 * Authors: Lotsa people, from code originally in tcp
9 *
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License
12 * as published by the Free Software Foundation; either version
13 * 2 of the License, or (at your option) any later version.
14 */
15
2d8c4ce5 16#include <linux/module.h>
a7f5e7f1 17#include <linux/random.h>
f3f05f70 18#include <linux/sched.h>
77d8bf9c 19#include <linux/slab.h>
f3f05f70 20#include <linux/wait.h>
77d8bf9c 21
463c84b9 22#include <net/inet_connection_sock.h>
77d8bf9c 23#include <net/inet_hashtables.h>
a7f5e7f1 24#include <net/ip.h>
77d8bf9c
ACM
25
26/*
27 * Allocate and initialize a new local port bind bucket.
28 * The bindhash mutex for snum's hash chain must be held here.
29 */
e18b890b 30struct inet_bind_bucket *inet_bind_bucket_create(struct kmem_cache *cachep,
941b1d22 31 struct net *net,
77d8bf9c
ACM
32 struct inet_bind_hashbucket *head,
33 const unsigned short snum)
34{
54e6ecb2 35 struct inet_bind_bucket *tb = kmem_cache_alloc(cachep, GFP_ATOMIC);
77d8bf9c
ACM
36
37 if (tb != NULL) {
7a9546ee 38 write_pnet(&tb->ib_net, hold_net(net));
77d8bf9c
ACM
39 tb->port = snum;
40 tb->fastreuse = 0;
a9d8f911 41 tb->num_owners = 0;
77d8bf9c
ACM
42 INIT_HLIST_HEAD(&tb->owners);
43 hlist_add_head(&tb->node, &head->chain);
44 }
45 return tb;
46}
47
77d8bf9c
ACM
48/*
49 * Caller must hold hashbucket lock for this tb with local BH disabled
50 */
e18b890b 51void inet_bind_bucket_destroy(struct kmem_cache *cachep, struct inet_bind_bucket *tb)
77d8bf9c
ACM
52{
53 if (hlist_empty(&tb->owners)) {
54 __hlist_del(&tb->node);
7a9546ee 55 release_net(ib_net(tb));
77d8bf9c
ACM
56 kmem_cache_free(cachep, tb);
57 }
58}
2d8c4ce5
ACM
59
60void inet_bind_hash(struct sock *sk, struct inet_bind_bucket *tb,
61 const unsigned short snum)
62{
a9d8f911
EP
63 struct inet_hashinfo *hashinfo = sk->sk_prot->h.hashinfo;
64
24dd1fa1 65 atomic_inc(&hashinfo->bsockets);
a9d8f911 66
c720c7e8 67 inet_sk(sk)->inet_num = snum;
2d8c4ce5 68 sk_add_bind_node(sk, &tb->owners);
a9d8f911 69 tb->num_owners++;
463c84b9 70 inet_csk(sk)->icsk_bind_hash = tb;
2d8c4ce5
ACM
71}
72
2d8c4ce5
ACM
73/*
74 * Get rid of any references to a local port held by the given sock.
75 */
ab1e0a13 76static void __inet_put_port(struct sock *sk)
2d8c4ce5 77{
39d8cda7 78 struct inet_hashinfo *hashinfo = sk->sk_prot->h.hashinfo;
c720c7e8 79 const int bhash = inet_bhashfn(sock_net(sk), inet_sk(sk)->inet_num,
7f635ab7 80 hashinfo->bhash_size);
2d8c4ce5
ACM
81 struct inet_bind_hashbucket *head = &hashinfo->bhash[bhash];
82 struct inet_bind_bucket *tb;
83
24dd1fa1 84 atomic_dec(&hashinfo->bsockets);
a9d8f911 85
2d8c4ce5 86 spin_lock(&head->lock);
463c84b9 87 tb = inet_csk(sk)->icsk_bind_hash;
2d8c4ce5 88 __sk_del_bind_node(sk);
a9d8f911 89 tb->num_owners--;
463c84b9 90 inet_csk(sk)->icsk_bind_hash = NULL;
c720c7e8 91 inet_sk(sk)->inet_num = 0;
2d8c4ce5
ACM
92 inet_bind_bucket_destroy(hashinfo->bind_bucket_cachep, tb);
93 spin_unlock(&head->lock);
94}
95
ab1e0a13 96void inet_put_port(struct sock *sk)
2d8c4ce5
ACM
97{
98 local_bh_disable();
ab1e0a13 99 __inet_put_port(sk);
2d8c4ce5
ACM
100 local_bh_enable();
101}
102
103EXPORT_SYMBOL(inet_put_port);
f3f05f70 104
53083773
PE
105void __inet_inherit_port(struct sock *sk, struct sock *child)
106{
107 struct inet_hashinfo *table = sk->sk_prot->h.hashinfo;
c720c7e8 108 const int bhash = inet_bhashfn(sock_net(sk), inet_sk(child)->inet_num,
7f635ab7 109 table->bhash_size);
53083773
PE
110 struct inet_bind_hashbucket *head = &table->bhash[bhash];
111 struct inet_bind_bucket *tb;
112
113 spin_lock(&head->lock);
114 tb = inet_csk(sk)->icsk_bind_hash;
115 sk_add_bind_node(child, &tb->owners);
116 inet_csk(child)->icsk_bind_hash = tb;
117 spin_unlock(&head->lock);
118}
119
120EXPORT_SYMBOL_GPL(__inet_inherit_port);
121
c25eb3bf
ED
122static inline int compute_score(struct sock *sk, struct net *net,
123 const unsigned short hnum, const __be32 daddr,
124 const int dif)
125{
126 int score = -1;
127 struct inet_sock *inet = inet_sk(sk);
128
c720c7e8 129 if (net_eq(sock_net(sk), net) && inet->inet_num == hnum &&
c25eb3bf 130 !ipv6_only_sock(sk)) {
c720c7e8 131 __be32 rcv_saddr = inet->inet_rcv_saddr;
c25eb3bf
ED
132 score = sk->sk_family == PF_INET ? 1 : 0;
133 if (rcv_saddr) {
134 if (rcv_saddr != daddr)
135 return -1;
136 score += 2;
137 }
138 if (sk->sk_bound_dev_if) {
139 if (sk->sk_bound_dev_if != dif)
140 return -1;
141 score += 2;
142 }
143 }
144 return score;
145}
146
33b62231
ACM
147/*
148 * Don't inline this cruft. Here are some nice properties to exploit here. The
149 * BSD API does not allow a listening sock to specify the remote port nor the
150 * remote address for the connection. So always assume those are both
151 * wildcarded during the search since they can never be otherwise.
152 */
e48c414e 153
c25eb3bf 154
c67499c0
PE
155struct sock *__inet_lookup_listener(struct net *net,
156 struct inet_hashinfo *hashinfo,
fb99c848 157 const __be32 daddr, const unsigned short hnum,
8f491069 158 const int dif)
99a92ff5 159{
c25eb3bf
ED
160 struct sock *sk, *result;
161 struct hlist_nulls_node *node;
162 unsigned int hash = inet_lhashfn(net, hnum);
163 struct inet_listen_hashbucket *ilb = &hashinfo->listening_hash[hash];
164 int score, hiscore;
99a92ff5 165
c25eb3bf
ED
166 rcu_read_lock();
167begin:
168 result = NULL;
169 hiscore = -1;
170 sk_nulls_for_each_rcu(sk, node, &ilb->head) {
171 score = compute_score(sk, net, hnum, daddr, dif);
172 if (score > hiscore) {
173 result = sk;
174 hiscore = score;
175 }
99a92ff5 176 }
c25eb3bf
ED
177 /*
178 * if the nulls value we got at the end of this lookup is
179 * not the expected one, we must restart lookup.
180 * We probably met an item that was moved to another chain.
181 */
182 if (get_nulls_value(node) != hash + LISTENING_NULLS_BASE)
183 goto begin;
184 if (result) {
185 if (unlikely(!atomic_inc_not_zero(&result->sk_refcnt)))
186 result = NULL;
187 else if (unlikely(compute_score(result, net, hnum, daddr,
188 dif) < hiscore)) {
189 sock_put(result);
190 goto begin;
191 }
99a92ff5 192 }
c25eb3bf
ED
193 rcu_read_unlock();
194 return result;
99a92ff5 195}
8f491069 196EXPORT_SYMBOL_GPL(__inet_lookup_listener);
a7f5e7f1 197
c67499c0
PE
198struct sock * __inet_lookup_established(struct net *net,
199 struct inet_hashinfo *hashinfo,
77a5ba55
PE
200 const __be32 saddr, const __be16 sport,
201 const __be32 daddr, const u16 hnum,
202 const int dif)
203{
204 INET_ADDR_COOKIE(acookie, saddr, daddr)
205 const __portpair ports = INET_COMBINED_PORTS(sport, hnum);
206 struct sock *sk;
3ab5aee7 207 const struct hlist_nulls_node *node;
77a5ba55
PE
208 /* Optimize here for direct hit, only listening connections can
209 * have wildcards anyways.
210 */
9f26b3ad 211 unsigned int hash = inet_ehashfn(net, daddr, hnum, saddr, sport);
f373b53b 212 unsigned int slot = hash & hashinfo->ehash_mask;
3ab5aee7 213 struct inet_ehash_bucket *head = &hashinfo->ehash[slot];
77a5ba55 214
3ab5aee7
ED
215 rcu_read_lock();
216begin:
217 sk_nulls_for_each_rcu(sk, node, &head->chain) {
c67499c0 218 if (INET_MATCH(sk, net, hash, acookie,
3ab5aee7
ED
219 saddr, daddr, ports, dif)) {
220 if (unlikely(!atomic_inc_not_zero(&sk->sk_refcnt)))
221 goto begintw;
222 if (unlikely(!INET_MATCH(sk, net, hash, acookie,
223 saddr, daddr, ports, dif))) {
224 sock_put(sk);
225 goto begin;
226 }
227 goto out;
228 }
77a5ba55 229 }
3ab5aee7
ED
230 /*
231 * if the nulls value we got at the end of this lookup is
232 * not the expected one, we must restart lookup.
233 * We probably met an item that was moved to another chain.
234 */
235 if (get_nulls_value(node) != slot)
236 goto begin;
77a5ba55 237
3ab5aee7 238begintw:
77a5ba55 239 /* Must check for a TIME_WAIT'er before going to listener hash. */
3ab5aee7 240 sk_nulls_for_each_rcu(sk, node, &head->twchain) {
c67499c0 241 if (INET_TW_MATCH(sk, net, hash, acookie,
3ab5aee7
ED
242 saddr, daddr, ports, dif)) {
243 if (unlikely(!atomic_inc_not_zero(&sk->sk_refcnt))) {
244 sk = NULL;
245 goto out;
246 }
247 if (unlikely(!INET_TW_MATCH(sk, net, hash, acookie,
248 saddr, daddr, ports, dif))) {
249 sock_put(sk);
250 goto begintw;
251 }
252 goto out;
253 }
77a5ba55 254 }
3ab5aee7
ED
255 /*
256 * if the nulls value we got at the end of this lookup is
257 * not the expected one, we must restart lookup.
258 * We probably met an item that was moved to another chain.
259 */
260 if (get_nulls_value(node) != slot)
261 goto begintw;
77a5ba55
PE
262 sk = NULL;
263out:
3ab5aee7 264 rcu_read_unlock();
77a5ba55 265 return sk;
77a5ba55
PE
266}
267EXPORT_SYMBOL_GPL(__inet_lookup_established);
268
a7f5e7f1
ACM
269/* called with local bh disabled */
270static int __inet_check_established(struct inet_timewait_death_row *death_row,
271 struct sock *sk, __u16 lport,
272 struct inet_timewait_sock **twp)
273{
274 struct inet_hashinfo *hinfo = death_row->hashinfo;
275 struct inet_sock *inet = inet_sk(sk);
c720c7e8
ED
276 __be32 daddr = inet->inet_rcv_saddr;
277 __be32 saddr = inet->inet_daddr;
a7f5e7f1
ACM
278 int dif = sk->sk_bound_dev_if;
279 INET_ADDR_COOKIE(acookie, saddr, daddr)
c720c7e8 280 const __portpair ports = INET_COMBINED_PORTS(inet->inet_dport, lport);
9f26b3ad 281 struct net *net = sock_net(sk);
c720c7e8
ED
282 unsigned int hash = inet_ehashfn(net, daddr, lport,
283 saddr, inet->inet_dport);
a7f5e7f1 284 struct inet_ehash_bucket *head = inet_ehash_bucket(hinfo, hash);
9db66bdc 285 spinlock_t *lock = inet_ehash_lockp(hinfo, hash);
a7f5e7f1 286 struct sock *sk2;
3ab5aee7 287 const struct hlist_nulls_node *node;
a7f5e7f1 288 struct inet_timewait_sock *tw;
13475a30 289 int twrefcnt = 0;
a7f5e7f1 290
9db66bdc 291 spin_lock(lock);
a7f5e7f1
ACM
292
293 /* Check TIME-WAIT sockets first. */
3ab5aee7 294 sk_nulls_for_each(sk2, node, &head->twchain) {
a7f5e7f1
ACM
295 tw = inet_twsk(sk2);
296
c67499c0
PE
297 if (INET_TW_MATCH(sk2, net, hash, acookie,
298 saddr, daddr, ports, dif)) {
a7f5e7f1
ACM
299 if (twsk_unique(sk, sk2, twp))
300 goto unique;
301 else
302 goto not_unique;
303 }
304 }
305 tw = NULL;
306
307 /* And established part... */
3ab5aee7 308 sk_nulls_for_each(sk2, node, &head->chain) {
c67499c0
PE
309 if (INET_MATCH(sk2, net, hash, acookie,
310 saddr, daddr, ports, dif))
a7f5e7f1
ACM
311 goto not_unique;
312 }
313
314unique:
315 /* Must record num and sport now. Otherwise we will see
316 * in hash table socket with a funny identity. */
c720c7e8
ED
317 inet->inet_num = lport;
318 inet->inet_sport = htons(lport);
a7f5e7f1 319 sk->sk_hash = hash;
547b792c 320 WARN_ON(!sk_unhashed(sk));
3ab5aee7 321 __sk_nulls_add_node_rcu(sk, &head->chain);
13475a30
ED
322 if (tw) {
323 twrefcnt = inet_twsk_unhash(tw);
324 NET_INC_STATS_BH(net, LINUX_MIB_TIMEWAITRECYCLED);
325 }
9db66bdc 326 spin_unlock(lock);
13475a30
ED
327 if (twrefcnt)
328 inet_twsk_put(tw);
c29a0bc4 329 sock_prot_inuse_add(sock_net(sk), sk->sk_prot, 1);
a7f5e7f1
ACM
330
331 if (twp) {
332 *twp = tw;
a7f5e7f1
ACM
333 } else if (tw) {
334 /* Silly. Should hash-dance instead... */
335 inet_twsk_deschedule(tw, death_row);
a7f5e7f1
ACM
336
337 inet_twsk_put(tw);
338 }
a7f5e7f1
ACM
339 return 0;
340
341not_unique:
9db66bdc 342 spin_unlock(lock);
a7f5e7f1
ACM
343 return -EADDRNOTAVAIL;
344}
345
346static inline u32 inet_sk_port_offset(const struct sock *sk)
347{
348 const struct inet_sock *inet = inet_sk(sk);
c720c7e8
ED
349 return secure_ipv4_port_ephemeral(inet->inet_rcv_saddr,
350 inet->inet_daddr,
351 inet->inet_dport);
a7f5e7f1
ACM
352}
353
ab1e0a13 354void __inet_hash_nolisten(struct sock *sk)
152da81d 355{
39d8cda7 356 struct inet_hashinfo *hashinfo = sk->sk_prot->h.hashinfo;
3ab5aee7 357 struct hlist_nulls_head *list;
9db66bdc 358 spinlock_t *lock;
152da81d
PE
359 struct inet_ehash_bucket *head;
360
547b792c 361 WARN_ON(!sk_unhashed(sk));
152da81d
PE
362
363 sk->sk_hash = inet_sk_ehashfn(sk);
364 head = inet_ehash_bucket(hashinfo, sk->sk_hash);
365 list = &head->chain;
366 lock = inet_ehash_lockp(hashinfo, sk->sk_hash);
367
9db66bdc 368 spin_lock(lock);
3ab5aee7 369 __sk_nulls_add_node_rcu(sk, list);
9db66bdc 370 spin_unlock(lock);
c29a0bc4 371 sock_prot_inuse_add(sock_net(sk), sk->sk_prot, 1);
152da81d
PE
372}
373EXPORT_SYMBOL_GPL(__inet_hash_nolisten);
374
ab1e0a13 375static void __inet_hash(struct sock *sk)
152da81d 376{
39d8cda7 377 struct inet_hashinfo *hashinfo = sk->sk_prot->h.hashinfo;
5caea4ea 378 struct inet_listen_hashbucket *ilb;
152da81d
PE
379
380 if (sk->sk_state != TCP_LISTEN) {
ab1e0a13 381 __inet_hash_nolisten(sk);
152da81d
PE
382 return;
383 }
384
547b792c 385 WARN_ON(!sk_unhashed(sk));
5caea4ea 386 ilb = &hashinfo->listening_hash[inet_sk_listen_hashfn(sk)];
152da81d 387
5caea4ea 388 spin_lock(&ilb->lock);
c25eb3bf 389 __sk_nulls_add_node_rcu(sk, &ilb->head);
c29a0bc4 390 sock_prot_inuse_add(sock_net(sk), sk->sk_prot, 1);
5caea4ea 391 spin_unlock(&ilb->lock);
152da81d 392}
ab1e0a13
ACM
393
394void inet_hash(struct sock *sk)
395{
396 if (sk->sk_state != TCP_CLOSE) {
397 local_bh_disable();
398 __inet_hash(sk);
399 local_bh_enable();
400 }
401}
402EXPORT_SYMBOL_GPL(inet_hash);
403
404void inet_unhash(struct sock *sk)
405{
39d8cda7 406 struct inet_hashinfo *hashinfo = sk->sk_prot->h.hashinfo;
c25eb3bf
ED
407 spinlock_t *lock;
408 int done;
ab1e0a13
ACM
409
410 if (sk_unhashed(sk))
5caea4ea 411 return;
ab1e0a13 412
c25eb3bf
ED
413 if (sk->sk_state == TCP_LISTEN)
414 lock = &hashinfo->listening_hash[inet_sk_listen_hashfn(sk)].lock;
415 else
416 lock = inet_ehash_lockp(hashinfo, sk->sk_hash);
5caea4ea 417
c25eb3bf
ED
418 spin_lock_bh(lock);
419 done =__sk_nulls_del_node_init_rcu(sk);
c25eb3bf
ED
420 if (done)
421 sock_prot_inuse_add(sock_net(sk), sk->sk_prot, -1);
920de804 422 spin_unlock_bh(lock);
ab1e0a13
ACM
423}
424EXPORT_SYMBOL_GPL(inet_unhash);
152da81d 425
5ee31fc1 426int __inet_hash_connect(struct inet_timewait_death_row *death_row,
5d8c0aa9 427 struct sock *sk, u32 port_offset,
5ee31fc1
PE
428 int (*check_established)(struct inet_timewait_death_row *,
429 struct sock *, __u16, struct inet_timewait_sock **),
ab1e0a13 430 void (*hash)(struct sock *sk))
a7f5e7f1
ACM
431{
432 struct inet_hashinfo *hinfo = death_row->hashinfo;
c720c7e8 433 const unsigned short snum = inet_sk(sk)->inet_num;
e905a9ed
YH
434 struct inet_bind_hashbucket *head;
435 struct inet_bind_bucket *tb;
a7f5e7f1 436 int ret;
3b1e0a65 437 struct net *net = sock_net(sk);
a7f5e7f1 438
e905a9ed 439 if (!snum) {
227b60f5 440 int i, remaining, low, high, port;
a7f5e7f1 441 static u32 hint;
5d8c0aa9 442 u32 offset = hint + port_offset;
a7f5e7f1 443 struct hlist_node *node;
e905a9ed 444 struct inet_timewait_sock *tw = NULL;
a7f5e7f1 445
227b60f5 446 inet_get_local_port_range(&low, &high);
a25de534 447 remaining = (high - low) + 1;
227b60f5 448
e905a9ed 449 local_bh_disable();
227b60f5
SH
450 for (i = 1; i <= remaining; i++) {
451 port = low + (i + offset) % remaining;
7f635ab7
PE
452 head = &hinfo->bhash[inet_bhashfn(net, port,
453 hinfo->bhash_size)];
e905a9ed 454 spin_lock(&head->lock);
a7f5e7f1 455
e905a9ed
YH
456 /* Does not bother with rcv_saddr checks,
457 * because the established check is already
458 * unique enough.
459 */
a7f5e7f1 460 inet_bind_bucket_for_each(tb, node, &head->chain) {
09ad9bc7
OP
461 if (net_eq(ib_net(tb), net) &&
462 tb->port == port) {
e905a9ed
YH
463 if (tb->fastreuse >= 0)
464 goto next_port;
a9d8f911 465 WARN_ON(hlist_empty(&tb->owners));
5ee31fc1
PE
466 if (!check_established(death_row, sk,
467 port, &tw))
e905a9ed
YH
468 goto ok;
469 goto next_port;
470 }
471 }
472
941b1d22
PE
473 tb = inet_bind_bucket_create(hinfo->bind_bucket_cachep,
474 net, head, port);
e905a9ed
YH
475 if (!tb) {
476 spin_unlock(&head->lock);
477 break;
478 }
479 tb->fastreuse = -1;
480 goto ok;
481
482 next_port:
483 spin_unlock(&head->lock);
484 }
485 local_bh_enable();
486
487 return -EADDRNOTAVAIL;
a7f5e7f1
ACM
488
489ok:
490 hint += i;
491
e905a9ed
YH
492 /* Head lock still held and bh's disabled */
493 inet_bind_hash(sk, tb, port);
a7f5e7f1 494 if (sk_unhashed(sk)) {
c720c7e8 495 inet_sk(sk)->inet_sport = htons(port);
ab1e0a13 496 hash(sk);
e905a9ed
YH
497 }
498 spin_unlock(&head->lock);
a7f5e7f1 499
e905a9ed
YH
500 if (tw) {
501 inet_twsk_deschedule(tw, death_row);
502 inet_twsk_put(tw);
503 }
a7f5e7f1
ACM
504
505 ret = 0;
506 goto out;
e905a9ed 507 }
a7f5e7f1 508
7f635ab7 509 head = &hinfo->bhash[inet_bhashfn(net, snum, hinfo->bhash_size)];
e905a9ed 510 tb = inet_csk(sk)->icsk_bind_hash;
a7f5e7f1
ACM
511 spin_lock_bh(&head->lock);
512 if (sk_head(&tb->owners) == sk && !sk->sk_bind_node.next) {
ab1e0a13 513 hash(sk);
a7f5e7f1
ACM
514 spin_unlock_bh(&head->lock);
515 return 0;
516 } else {
517 spin_unlock(&head->lock);
518 /* No definite answer... Walk to established hash table */
5ee31fc1 519 ret = check_established(death_row, sk, snum, NULL);
a7f5e7f1
ACM
520out:
521 local_bh_enable();
522 return ret;
523 }
524}
5ee31fc1
PE
525
526/*
527 * Bind a port for a connect operation and hash it.
528 */
529int inet_hash_connect(struct inet_timewait_death_row *death_row,
530 struct sock *sk)
531{
5d8c0aa9 532 return __inet_hash_connect(death_row, sk, inet_sk_port_offset(sk),
5ee31fc1
PE
533 __inet_check_established, __inet_hash_nolisten);
534}
a7f5e7f1
ACM
535
536EXPORT_SYMBOL_GPL(inet_hash_connect);
5caea4ea
ED
537
538void inet_hashinfo_init(struct inet_hashinfo *h)
539{
540 int i;
541
24dd1fa1 542 atomic_set(&h->bsockets, 0);
c25eb3bf 543 for (i = 0; i < INET_LHTABLE_SIZE; i++) {
5caea4ea 544 spin_lock_init(&h->listening_hash[i].lock);
c25eb3bf
ED
545 INIT_HLIST_NULLS_HEAD(&h->listening_hash[i].head,
546 i + LISTENING_NULLS_BASE);
547 }
5caea4ea
ED
548}
549
550EXPORT_SYMBOL_GPL(inet_hashinfo_init);
This page took 0.545437 seconds and 5 git commands to generate.