mem: add API to lock/unlock memory hotplug
[dpdk.git] / lib / librte_eal / common / malloc_heap.c
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2010-2014 Intel Corporation
3  */
4 #include <stdint.h>
5 #include <stddef.h>
6 #include <stdlib.h>
7 #include <stdio.h>
8 #include <stdarg.h>
9 #include <errno.h>
10 #include <sys/queue.h>
11
12 #include <rte_memory.h>
13 #include <rte_errno.h>
14 #include <rte_eal.h>
15 #include <rte_eal_memconfig.h>
16 #include <rte_launch.h>
17 #include <rte_per_lcore.h>
18 #include <rte_lcore.h>
19 #include <rte_common.h>
20 #include <rte_string_fns.h>
21 #include <rte_spinlock.h>
22 #include <rte_memcpy.h>
23 #include <rte_atomic.h>
24 #include <rte_fbarray.h>
25
26 #include "eal_internal_cfg.h"
27 #include "eal_memalloc.h"
28 #include "malloc_elem.h"
29 #include "malloc_heap.h"
30 #include "malloc_mp.h"
31
32 /* start external socket ID's at a very high number */
33 #define CONST_MAX(a, b) (a > b ? a : b) /* RTE_MAX is not a constant */
34 #define EXTERNAL_HEAP_MIN_SOCKET_ID (CONST_MAX((1 << 8), RTE_MAX_NUMA_NODES))
35
36 static unsigned
37 check_hugepage_sz(unsigned flags, uint64_t hugepage_sz)
38 {
39         unsigned check_flag = 0;
40
41         if (!(flags & ~RTE_MEMZONE_SIZE_HINT_ONLY))
42                 return 1;
43
44         switch (hugepage_sz) {
45         case RTE_PGSIZE_256K:
46                 check_flag = RTE_MEMZONE_256KB;
47                 break;
48         case RTE_PGSIZE_2M:
49                 check_flag = RTE_MEMZONE_2MB;
50                 break;
51         case RTE_PGSIZE_16M:
52                 check_flag = RTE_MEMZONE_16MB;
53                 break;
54         case RTE_PGSIZE_256M:
55                 check_flag = RTE_MEMZONE_256MB;
56                 break;
57         case RTE_PGSIZE_512M:
58                 check_flag = RTE_MEMZONE_512MB;
59                 break;
60         case RTE_PGSIZE_1G:
61                 check_flag = RTE_MEMZONE_1GB;
62                 break;
63         case RTE_PGSIZE_4G:
64                 check_flag = RTE_MEMZONE_4GB;
65                 break;
66         case RTE_PGSIZE_16G:
67                 check_flag = RTE_MEMZONE_16GB;
68         }
69
70         return check_flag & flags;
71 }
72
73 int
74 malloc_socket_to_heap_id(unsigned int socket_id)
75 {
76         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
77         int i;
78
79         for (i = 0; i < RTE_MAX_HEAPS; i++) {
80                 struct malloc_heap *heap = &mcfg->malloc_heaps[i];
81
82                 if (heap->socket_id == socket_id)
83                         return i;
84         }
85         return -1;
86 }
87
88 /*
89  * Expand the heap with a memory area.
90  */
91 static struct malloc_elem *
92 malloc_heap_add_memory(struct malloc_heap *heap, struct rte_memseg_list *msl,
93                 void *start, size_t len)
94 {
95         struct malloc_elem *elem = start;
96
97         malloc_elem_init(elem, heap, msl, len, elem, len);
98
99         malloc_elem_insert(elem);
100
101         elem = malloc_elem_join_adjacent_free(elem);
102
103         malloc_elem_free_list_insert(elem);
104
105         return elem;
106 }
107
108 static int
109 malloc_add_seg(const struct rte_memseg_list *msl,
110                 const struct rte_memseg *ms, size_t len, void *arg __rte_unused)
111 {
112         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
113         struct rte_memseg_list *found_msl;
114         struct malloc_heap *heap;
115         int msl_idx, heap_idx;
116
117         if (msl->external)
118                 return 0;
119
120         heap_idx = malloc_socket_to_heap_id(msl->socket_id);
121         if (heap_idx < 0) {
122                 RTE_LOG(ERR, EAL, "Memseg list has invalid socket id\n");
123                 return -1;
124         }
125         heap = &mcfg->malloc_heaps[heap_idx];
126
127         /* msl is const, so find it */
128         msl_idx = msl - mcfg->memsegs;
129
130         if (msl_idx < 0 || msl_idx >= RTE_MAX_MEMSEG_LISTS)
131                 return -1;
132
133         found_msl = &mcfg->memsegs[msl_idx];
134
135         malloc_heap_add_memory(heap, found_msl, ms->addr, len);
136
137         heap->total_size += len;
138
139         RTE_LOG(DEBUG, EAL, "Added %zuM to heap on socket %i\n", len >> 20,
140                         msl->socket_id);
141         return 0;
142 }
143
144 /*
145  * Iterates through the freelist for a heap to find a free element
146  * which can store data of the required size and with the requested alignment.
147  * If size is 0, find the biggest available elem.
148  * Returns null on failure, or pointer to element on success.
149  */
150 static struct malloc_elem *
151 find_suitable_element(struct malloc_heap *heap, size_t size,
152                 unsigned int flags, size_t align, size_t bound, bool contig)
153 {
154         size_t idx;
155         struct malloc_elem *elem, *alt_elem = NULL;
156
157         for (idx = malloc_elem_free_list_index(size);
158                         idx < RTE_HEAP_NUM_FREELISTS; idx++) {
159                 for (elem = LIST_FIRST(&heap->free_head[idx]);
160                                 !!elem; elem = LIST_NEXT(elem, free_list)) {
161                         if (malloc_elem_can_hold(elem, size, align, bound,
162                                         contig)) {
163                                 if (check_hugepage_sz(flags,
164                                                 elem->msl->page_sz))
165                                         return elem;
166                                 if (alt_elem == NULL)
167                                         alt_elem = elem;
168                         }
169                 }
170         }
171
172         if ((alt_elem != NULL) && (flags & RTE_MEMZONE_SIZE_HINT_ONLY))
173                 return alt_elem;
174
175         return NULL;
176 }
177
178 /*
179  * Iterates through the freelist for a heap to find a free element with the
180  * biggest size and requested alignment. Will also set size to whatever element
181  * size that was found.
182  * Returns null on failure, or pointer to element on success.
183  */
184 static struct malloc_elem *
185 find_biggest_element(struct malloc_heap *heap, size_t *size,
186                 unsigned int flags, size_t align, bool contig)
187 {
188         struct malloc_elem *elem, *max_elem = NULL;
189         size_t idx, max_size = 0;
190
191         for (idx = 0; idx < RTE_HEAP_NUM_FREELISTS; idx++) {
192                 for (elem = LIST_FIRST(&heap->free_head[idx]);
193                                 !!elem; elem = LIST_NEXT(elem, free_list)) {
194                         size_t cur_size;
195                         if ((flags & RTE_MEMZONE_SIZE_HINT_ONLY) == 0 &&
196                                         !check_hugepage_sz(flags,
197                                                 elem->msl->page_sz))
198                                 continue;
199                         if (contig) {
200                                 cur_size =
201                                         malloc_elem_find_max_iova_contig(elem,
202                                                         align);
203                         } else {
204                                 void *data_start = RTE_PTR_ADD(elem,
205                                                 MALLOC_ELEM_HEADER_LEN);
206                                 void *data_end = RTE_PTR_ADD(elem, elem->size -
207                                                 MALLOC_ELEM_TRAILER_LEN);
208                                 void *aligned = RTE_PTR_ALIGN_CEIL(data_start,
209                                                 align);
210                                 /* check if aligned data start is beyond end */
211                                 if (aligned >= data_end)
212                                         continue;
213                                 cur_size = RTE_PTR_DIFF(data_end, aligned);
214                         }
215                         if (cur_size > max_size) {
216                                 max_size = cur_size;
217                                 max_elem = elem;
218                         }
219                 }
220         }
221
222         *size = max_size;
223         return max_elem;
224 }
225
226 /*
227  * Main function to allocate a block of memory from the heap.
228  * It locks the free list, scans it, and adds a new memseg if the
229  * scan fails. Once the new memseg is added, it re-scans and should return
230  * the new element after releasing the lock.
231  */
232 static void *
233 heap_alloc(struct malloc_heap *heap, const char *type __rte_unused, size_t size,
234                 unsigned int flags, size_t align, size_t bound, bool contig)
235 {
236         struct malloc_elem *elem;
237
238         size = RTE_CACHE_LINE_ROUNDUP(size);
239         align = RTE_CACHE_LINE_ROUNDUP(align);
240
241         elem = find_suitable_element(heap, size, flags, align, bound, contig);
242         if (elem != NULL) {
243                 elem = malloc_elem_alloc(elem, size, align, bound, contig);
244
245                 /* increase heap's count of allocated elements */
246                 heap->alloc_count++;
247         }
248
249         return elem == NULL ? NULL : (void *)(&elem[1]);
250 }
251
252 static void *
253 heap_alloc_biggest(struct malloc_heap *heap, const char *type __rte_unused,
254                 unsigned int flags, size_t align, bool contig)
255 {
256         struct malloc_elem *elem;
257         size_t size;
258
259         align = RTE_CACHE_LINE_ROUNDUP(align);
260
261         elem = find_biggest_element(heap, &size, flags, align, contig);
262         if (elem != NULL) {
263                 elem = malloc_elem_alloc(elem, size, align, 0, contig);
264
265                 /* increase heap's count of allocated elements */
266                 heap->alloc_count++;
267         }
268
269         return elem == NULL ? NULL : (void *)(&elem[1]);
270 }
271
272 /* this function is exposed in malloc_mp.h */
273 void
274 rollback_expand_heap(struct rte_memseg **ms, int n_segs,
275                 struct malloc_elem *elem, void *map_addr, size_t map_len)
276 {
277         if (elem != NULL) {
278                 malloc_elem_free_list_remove(elem);
279                 malloc_elem_hide_region(elem, map_addr, map_len);
280         }
281
282         eal_memalloc_free_seg_bulk(ms, n_segs);
283 }
284
285 /* this function is exposed in malloc_mp.h */
286 struct malloc_elem *
287 alloc_pages_on_heap(struct malloc_heap *heap, uint64_t pg_sz, size_t elt_size,
288                 int socket, unsigned int flags, size_t align, size_t bound,
289                 bool contig, struct rte_memseg **ms, int n_segs)
290 {
291         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
292         struct rte_memseg_list *msl;
293         struct malloc_elem *elem = NULL;
294         size_t alloc_sz;
295         int allocd_pages;
296         void *ret, *map_addr;
297
298         alloc_sz = (size_t)pg_sz * n_segs;
299
300         /* first, check if we're allowed to allocate this memory */
301         if (eal_memalloc_mem_alloc_validate(socket,
302                         heap->total_size + alloc_sz) < 0) {
303                 RTE_LOG(DEBUG, EAL, "User has disallowed allocation\n");
304                 return NULL;
305         }
306
307         allocd_pages = eal_memalloc_alloc_seg_bulk(ms, n_segs, pg_sz,
308                         socket, true);
309
310         /* make sure we've allocated our pages... */
311         if (allocd_pages < 0)
312                 return NULL;
313
314         map_addr = ms[0]->addr;
315         msl = rte_mem_virt2memseg_list(map_addr);
316
317         /* check if we wanted contiguous memory but didn't get it */
318         if (contig && !eal_memalloc_is_contig(msl, map_addr, alloc_sz)) {
319                 RTE_LOG(DEBUG, EAL, "%s(): couldn't allocate physically contiguous space\n",
320                                 __func__);
321                 goto fail;
322         }
323
324         /*
325          * Once we have all the memseg lists configured, if there is a dma mask
326          * set, check iova addresses are not out of range. Otherwise the device
327          * setting the dma mask could have problems with the mapped memory.
328          *
329          * There are two situations when this can happen:
330          *      1) memory initialization
331          *      2) dynamic memory allocation
332          *
333          * For 1), an error when checking dma mask implies app can not be
334          * executed. For 2) implies the new memory can not be added.
335          */
336         if (mcfg->dma_maskbits &&
337             rte_mem_check_dma_mask_thread_unsafe(mcfg->dma_maskbits)) {
338                 /*
339                  * Currently this can only happen if IOMMU is enabled
340                  * and the address width supported by the IOMMU hw is
341                  * not enough for using the memory mapped IOVAs.
342                  *
343                  * If IOVA is VA, advice to try with '--iova-mode pa'
344                  * which could solve some situations when IOVA VA is not
345                  * really needed.
346                  */
347                 RTE_LOG(ERR, EAL,
348                         "%s(): couldn't allocate memory due to IOVA exceeding limits of current DMA mask\n",
349                         __func__);
350
351                 /*
352                  * If IOVA is VA and it is possible to run with IOVA PA,
353                  * because user is root, give and advice for solving the
354                  * problem.
355                  */
356                 if ((rte_eal_iova_mode() == RTE_IOVA_VA) &&
357                      rte_eal_using_phys_addrs())
358                         RTE_LOG(ERR, EAL,
359                                 "%s(): Please try initializing EAL with --iova-mode=pa parameter\n",
360                                 __func__);
361                 goto fail;
362         }
363
364         /* add newly minted memsegs to malloc heap */
365         elem = malloc_heap_add_memory(heap, msl, map_addr, alloc_sz);
366
367         /* try once more, as now we have allocated new memory */
368         ret = find_suitable_element(heap, elt_size, flags, align, bound,
369                         contig);
370
371         if (ret == NULL)
372                 goto fail;
373
374         return elem;
375
376 fail:
377         rollback_expand_heap(ms, n_segs, elem, map_addr, alloc_sz);
378         return NULL;
379 }
380
381 static int
382 try_expand_heap_primary(struct malloc_heap *heap, uint64_t pg_sz,
383                 size_t elt_size, int socket, unsigned int flags, size_t align,
384                 size_t bound, bool contig)
385 {
386         struct malloc_elem *elem;
387         struct rte_memseg **ms;
388         void *map_addr;
389         size_t alloc_sz;
390         int n_segs;
391         bool callback_triggered = false;
392
393         alloc_sz = RTE_ALIGN_CEIL(align + elt_size +
394                         MALLOC_ELEM_TRAILER_LEN, pg_sz);
395         n_segs = alloc_sz / pg_sz;
396
397         /* we can't know in advance how many pages we'll need, so we malloc */
398         ms = malloc(sizeof(*ms) * n_segs);
399         if (ms == NULL)
400                 return -1;
401         memset(ms, 0, sizeof(*ms) * n_segs);
402
403         elem = alloc_pages_on_heap(heap, pg_sz, elt_size, socket, flags, align,
404                         bound, contig, ms, n_segs);
405
406         if (elem == NULL)
407                 goto free_ms;
408
409         map_addr = ms[0]->addr;
410
411         /* notify user about changes in memory map */
412         eal_memalloc_mem_event_notify(RTE_MEM_EVENT_ALLOC, map_addr, alloc_sz);
413
414         /* notify other processes that this has happened */
415         if (request_sync()) {
416                 /* we couldn't ensure all processes have mapped memory,
417                  * so free it back and notify everyone that it's been
418                  * freed back.
419                  *
420                  * technically, we could've avoided adding memory addresses to
421                  * the map, but that would've led to inconsistent behavior
422                  * between primary and secondary processes, as those get
423                  * callbacks during sync. therefore, force primary process to
424                  * do alloc-and-rollback syncs as well.
425                  */
426                 callback_triggered = true;
427                 goto free_elem;
428         }
429         heap->total_size += alloc_sz;
430
431         RTE_LOG(DEBUG, EAL, "Heap on socket %d was expanded by %zdMB\n",
432                 socket, alloc_sz >> 20ULL);
433
434         free(ms);
435
436         return 0;
437
438 free_elem:
439         if (callback_triggered)
440                 eal_memalloc_mem_event_notify(RTE_MEM_EVENT_FREE,
441                                 map_addr, alloc_sz);
442
443         rollback_expand_heap(ms, n_segs, elem, map_addr, alloc_sz);
444
445         request_sync();
446 free_ms:
447         free(ms);
448
449         return -1;
450 }
451
452 static int
453 try_expand_heap_secondary(struct malloc_heap *heap, uint64_t pg_sz,
454                 size_t elt_size, int socket, unsigned int flags, size_t align,
455                 size_t bound, bool contig)
456 {
457         struct malloc_mp_req req;
458         int req_result;
459
460         memset(&req, 0, sizeof(req));
461
462         req.t = REQ_TYPE_ALLOC;
463         req.alloc_req.align = align;
464         req.alloc_req.bound = bound;
465         req.alloc_req.contig = contig;
466         req.alloc_req.flags = flags;
467         req.alloc_req.elt_size = elt_size;
468         req.alloc_req.page_sz = pg_sz;
469         req.alloc_req.socket = socket;
470         req.alloc_req.heap = heap; /* it's in shared memory */
471
472         req_result = request_to_primary(&req);
473
474         if (req_result != 0)
475                 return -1;
476
477         if (req.result != REQ_RESULT_SUCCESS)
478                 return -1;
479
480         return 0;
481 }
482
483 static int
484 try_expand_heap(struct malloc_heap *heap, uint64_t pg_sz, size_t elt_size,
485                 int socket, unsigned int flags, size_t align, size_t bound,
486                 bool contig)
487 {
488         int ret;
489
490         rte_mcfg_mem_write_lock();
491
492         if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
493                 ret = try_expand_heap_primary(heap, pg_sz, elt_size, socket,
494                                 flags, align, bound, contig);
495         } else {
496                 ret = try_expand_heap_secondary(heap, pg_sz, elt_size, socket,
497                                 flags, align, bound, contig);
498         }
499
500         rte_mcfg_mem_write_unlock();
501         return ret;
502 }
503
504 static int
505 compare_pagesz(const void *a, const void *b)
506 {
507         const struct rte_memseg_list * const*mpa = a;
508         const struct rte_memseg_list * const*mpb = b;
509         const struct rte_memseg_list *msla = *mpa;
510         const struct rte_memseg_list *mslb = *mpb;
511         uint64_t pg_sz_a = msla->page_sz;
512         uint64_t pg_sz_b = mslb->page_sz;
513
514         if (pg_sz_a < pg_sz_b)
515                 return -1;
516         if (pg_sz_a > pg_sz_b)
517                 return 1;
518         return 0;
519 }
520
521 static int
522 alloc_more_mem_on_socket(struct malloc_heap *heap, size_t size, int socket,
523                 unsigned int flags, size_t align, size_t bound, bool contig)
524 {
525         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
526         struct rte_memseg_list *requested_msls[RTE_MAX_MEMSEG_LISTS];
527         struct rte_memseg_list *other_msls[RTE_MAX_MEMSEG_LISTS];
528         uint64_t requested_pg_sz[RTE_MAX_MEMSEG_LISTS];
529         uint64_t other_pg_sz[RTE_MAX_MEMSEG_LISTS];
530         uint64_t prev_pg_sz;
531         int i, n_other_msls, n_other_pg_sz, n_requested_msls, n_requested_pg_sz;
532         bool size_hint = (flags & RTE_MEMZONE_SIZE_HINT_ONLY) > 0;
533         unsigned int size_flags = flags & ~RTE_MEMZONE_SIZE_HINT_ONLY;
534         void *ret;
535
536         memset(requested_msls, 0, sizeof(requested_msls));
537         memset(other_msls, 0, sizeof(other_msls));
538         memset(requested_pg_sz, 0, sizeof(requested_pg_sz));
539         memset(other_pg_sz, 0, sizeof(other_pg_sz));
540
541         /*
542          * go through memseg list and take note of all the page sizes available,
543          * and if any of them were specifically requested by the user.
544          */
545         n_requested_msls = 0;
546         n_other_msls = 0;
547         for (i = 0; i < RTE_MAX_MEMSEG_LISTS; i++) {
548                 struct rte_memseg_list *msl = &mcfg->memsegs[i];
549
550                 if (msl->socket_id != socket)
551                         continue;
552
553                 if (msl->base_va == NULL)
554                         continue;
555
556                 /* if pages of specific size were requested */
557                 if (size_flags != 0 && check_hugepage_sz(size_flags,
558                                 msl->page_sz))
559                         requested_msls[n_requested_msls++] = msl;
560                 else if (size_flags == 0 || size_hint)
561                         other_msls[n_other_msls++] = msl;
562         }
563
564         /* sort the lists, smallest first */
565         qsort(requested_msls, n_requested_msls, sizeof(requested_msls[0]),
566                         compare_pagesz);
567         qsort(other_msls, n_other_msls, sizeof(other_msls[0]),
568                         compare_pagesz);
569
570         /* now, extract page sizes we are supposed to try */
571         prev_pg_sz = 0;
572         n_requested_pg_sz = 0;
573         for (i = 0; i < n_requested_msls; i++) {
574                 uint64_t pg_sz = requested_msls[i]->page_sz;
575
576                 if (prev_pg_sz != pg_sz) {
577                         requested_pg_sz[n_requested_pg_sz++] = pg_sz;
578                         prev_pg_sz = pg_sz;
579                 }
580         }
581         prev_pg_sz = 0;
582         n_other_pg_sz = 0;
583         for (i = 0; i < n_other_msls; i++) {
584                 uint64_t pg_sz = other_msls[i]->page_sz;
585
586                 if (prev_pg_sz != pg_sz) {
587                         other_pg_sz[n_other_pg_sz++] = pg_sz;
588                         prev_pg_sz = pg_sz;
589                 }
590         }
591
592         /* finally, try allocating memory of specified page sizes, starting from
593          * the smallest sizes
594          */
595         for (i = 0; i < n_requested_pg_sz; i++) {
596                 uint64_t pg_sz = requested_pg_sz[i];
597
598                 /*
599                  * do not pass the size hint here, as user expects other page
600                  * sizes first, before resorting to best effort allocation.
601                  */
602                 if (!try_expand_heap(heap, pg_sz, size, socket, size_flags,
603                                 align, bound, contig))
604                         return 0;
605         }
606         if (n_other_pg_sz == 0)
607                 return -1;
608
609         /* now, check if we can reserve anything with size hint */
610         ret = find_suitable_element(heap, size, flags, align, bound, contig);
611         if (ret != NULL)
612                 return 0;
613
614         /*
615          * we still couldn't reserve memory, so try expanding heap with other
616          * page sizes, if there are any
617          */
618         for (i = 0; i < n_other_pg_sz; i++) {
619                 uint64_t pg_sz = other_pg_sz[i];
620
621                 if (!try_expand_heap(heap, pg_sz, size, socket, flags,
622                                 align, bound, contig))
623                         return 0;
624         }
625         return -1;
626 }
627
628 /* this will try lower page sizes first */
629 static void *
630 malloc_heap_alloc_on_heap_id(const char *type, size_t size,
631                 unsigned int heap_id, unsigned int flags, size_t align,
632                 size_t bound, bool contig)
633 {
634         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
635         struct malloc_heap *heap = &mcfg->malloc_heaps[heap_id];
636         unsigned int size_flags = flags & ~RTE_MEMZONE_SIZE_HINT_ONLY;
637         int socket_id;
638         void *ret;
639
640         rte_spinlock_lock(&(heap->lock));
641
642         align = align == 0 ? 1 : align;
643
644         /* for legacy mode, try once and with all flags */
645         if (internal_config.legacy_mem) {
646                 ret = heap_alloc(heap, type, size, flags, align, bound, contig);
647                 goto alloc_unlock;
648         }
649
650         /*
651          * we do not pass the size hint here, because even if allocation fails,
652          * we may still be able to allocate memory from appropriate page sizes,
653          * we just need to request more memory first.
654          */
655
656         socket_id = rte_socket_id_by_idx(heap_id);
657         /*
658          * if socket ID is negative, we cannot find a socket ID for this heap -
659          * which means it's an external heap. those can have unexpected page
660          * sizes, so if the user asked to allocate from there - assume user
661          * knows what they're doing, and allow allocating from there with any
662          * page size flags.
663          */
664         if (socket_id < 0)
665                 size_flags |= RTE_MEMZONE_SIZE_HINT_ONLY;
666
667         ret = heap_alloc(heap, type, size, size_flags, align, bound, contig);
668         if (ret != NULL)
669                 goto alloc_unlock;
670
671         /* if socket ID is invalid, this is an external heap */
672         if (socket_id < 0)
673                 goto alloc_unlock;
674
675         if (!alloc_more_mem_on_socket(heap, size, socket_id, flags, align,
676                         bound, contig)) {
677                 ret = heap_alloc(heap, type, size, flags, align, bound, contig);
678
679                 /* this should have succeeded */
680                 if (ret == NULL)
681                         RTE_LOG(ERR, EAL, "Error allocating from heap\n");
682         }
683 alloc_unlock:
684         rte_spinlock_unlock(&(heap->lock));
685         return ret;
686 }
687
688 void *
689 malloc_heap_alloc(const char *type, size_t size, int socket_arg,
690                 unsigned int flags, size_t align, size_t bound, bool contig)
691 {
692         int socket, heap_id, i;
693         void *ret;
694
695         /* return NULL if size is 0 or alignment is not power-of-2 */
696         if (size == 0 || (align && !rte_is_power_of_2(align)))
697                 return NULL;
698
699         if (!rte_eal_has_hugepages() && socket_arg < RTE_MAX_NUMA_NODES)
700                 socket_arg = SOCKET_ID_ANY;
701
702         if (socket_arg == SOCKET_ID_ANY)
703                 socket = malloc_get_numa_socket();
704         else
705                 socket = socket_arg;
706
707         /* turn socket ID into heap ID */
708         heap_id = malloc_socket_to_heap_id(socket);
709         /* if heap id is negative, socket ID was invalid */
710         if (heap_id < 0)
711                 return NULL;
712
713         ret = malloc_heap_alloc_on_heap_id(type, size, heap_id, flags, align,
714                         bound, contig);
715         if (ret != NULL || socket_arg != SOCKET_ID_ANY)
716                 return ret;
717
718         /* try other heaps. we are only iterating through native DPDK sockets,
719          * so external heaps won't be included.
720          */
721         for (i = 0; i < (int) rte_socket_count(); i++) {
722                 if (i == heap_id)
723                         continue;
724                 ret = malloc_heap_alloc_on_heap_id(type, size, i, flags, align,
725                                 bound, contig);
726                 if (ret != NULL)
727                         return ret;
728         }
729         return NULL;
730 }
731
732 static void *
733 heap_alloc_biggest_on_heap_id(const char *type, unsigned int heap_id,
734                 unsigned int flags, size_t align, bool contig)
735 {
736         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
737         struct malloc_heap *heap = &mcfg->malloc_heaps[heap_id];
738         void *ret;
739
740         rte_spinlock_lock(&(heap->lock));
741
742         align = align == 0 ? 1 : align;
743
744         ret = heap_alloc_biggest(heap, type, flags, align, contig);
745
746         rte_spinlock_unlock(&(heap->lock));
747
748         return ret;
749 }
750
751 void *
752 malloc_heap_alloc_biggest(const char *type, int socket_arg, unsigned int flags,
753                 size_t align, bool contig)
754 {
755         int socket, i, cur_socket, heap_id;
756         void *ret;
757
758         /* return NULL if align is not power-of-2 */
759         if ((align && !rte_is_power_of_2(align)))
760                 return NULL;
761
762         if (!rte_eal_has_hugepages())
763                 socket_arg = SOCKET_ID_ANY;
764
765         if (socket_arg == SOCKET_ID_ANY)
766                 socket = malloc_get_numa_socket();
767         else
768                 socket = socket_arg;
769
770         /* turn socket ID into heap ID */
771         heap_id = malloc_socket_to_heap_id(socket);
772         /* if heap id is negative, socket ID was invalid */
773         if (heap_id < 0)
774                 return NULL;
775
776         ret = heap_alloc_biggest_on_heap_id(type, heap_id, flags, align,
777                         contig);
778         if (ret != NULL || socket_arg != SOCKET_ID_ANY)
779                 return ret;
780
781         /* try other heaps */
782         for (i = 0; i < (int) rte_socket_count(); i++) {
783                 cur_socket = rte_socket_id_by_idx(i);
784                 if (cur_socket == socket)
785                         continue;
786                 ret = heap_alloc_biggest_on_heap_id(type, i, flags, align,
787                                 contig);
788                 if (ret != NULL)
789                         return ret;
790         }
791         return NULL;
792 }
793
794 /* this function is exposed in malloc_mp.h */
795 int
796 malloc_heap_free_pages(void *aligned_start, size_t aligned_len)
797 {
798         int n_segs, seg_idx, max_seg_idx;
799         struct rte_memseg_list *msl;
800         size_t page_sz;
801
802         msl = rte_mem_virt2memseg_list(aligned_start);
803         if (msl == NULL)
804                 return -1;
805
806         page_sz = (size_t)msl->page_sz;
807         n_segs = aligned_len / page_sz;
808         seg_idx = RTE_PTR_DIFF(aligned_start, msl->base_va) / page_sz;
809         max_seg_idx = seg_idx + n_segs;
810
811         for (; seg_idx < max_seg_idx; seg_idx++) {
812                 struct rte_memseg *ms;
813
814                 ms = rte_fbarray_get(&msl->memseg_arr, seg_idx);
815                 eal_memalloc_free_seg(ms);
816         }
817         return 0;
818 }
819
820 int
821 malloc_heap_free(struct malloc_elem *elem)
822 {
823         struct malloc_heap *heap;
824         void *start, *aligned_start, *end, *aligned_end;
825         size_t len, aligned_len, page_sz;
826         struct rte_memseg_list *msl;
827         unsigned int i, n_segs, before_space, after_space;
828         int ret;
829
830         if (!malloc_elem_cookies_ok(elem) || elem->state != ELEM_BUSY)
831                 return -1;
832
833         /* elem may be merged with previous element, so keep heap address */
834         heap = elem->heap;
835         msl = elem->msl;
836         page_sz = (size_t)msl->page_sz;
837
838         rte_spinlock_lock(&(heap->lock));
839
840         /* mark element as free */
841         elem->state = ELEM_FREE;
842
843         elem = malloc_elem_free(elem);
844
845         /* anything after this is a bonus */
846         ret = 0;
847
848         /* ...of which we can't avail if we are in legacy mode, or if this is an
849          * externally allocated segment.
850          */
851         if (internal_config.legacy_mem || (msl->external > 0))
852                 goto free_unlock;
853
854         /* check if we can free any memory back to the system */
855         if (elem->size < page_sz)
856                 goto free_unlock;
857
858         /* if user requested to match allocations, the sizes must match - if not,
859          * we will defer freeing these hugepages until the entire original allocation
860          * can be freed
861          */
862         if (internal_config.match_allocations && elem->size != elem->orig_size)
863                 goto free_unlock;
864
865         /* probably, but let's make sure, as we may not be using up full page */
866         start = elem;
867         len = elem->size;
868         aligned_start = RTE_PTR_ALIGN_CEIL(start, page_sz);
869         end = RTE_PTR_ADD(elem, len);
870         aligned_end = RTE_PTR_ALIGN_FLOOR(end, page_sz);
871
872         aligned_len = RTE_PTR_DIFF(aligned_end, aligned_start);
873
874         /* can't free anything */
875         if (aligned_len < page_sz)
876                 goto free_unlock;
877
878         /* we can free something. however, some of these pages may be marked as
879          * unfreeable, so also check that as well
880          */
881         n_segs = aligned_len / page_sz;
882         for (i = 0; i < n_segs; i++) {
883                 const struct rte_memseg *tmp =
884                                 rte_mem_virt2memseg(aligned_start, msl);
885
886                 if (tmp->flags & RTE_MEMSEG_FLAG_DO_NOT_FREE) {
887                         /* this is an unfreeable segment, so move start */
888                         aligned_start = RTE_PTR_ADD(tmp->addr, tmp->len);
889                 }
890         }
891
892         /* recalculate length and number of segments */
893         aligned_len = RTE_PTR_DIFF(aligned_end, aligned_start);
894         n_segs = aligned_len / page_sz;
895
896         /* check if we can still free some pages */
897         if (n_segs == 0)
898                 goto free_unlock;
899
900         /* We're not done yet. We also have to check if by freeing space we will
901          * be leaving free elements that are too small to store new elements.
902          * Check if we have enough space in the beginning and at the end, or if
903          * start/end are exactly page aligned.
904          */
905         before_space = RTE_PTR_DIFF(aligned_start, elem);
906         after_space = RTE_PTR_DIFF(end, aligned_end);
907         if (before_space != 0 &&
908                         before_space < MALLOC_ELEM_OVERHEAD + MIN_DATA_SIZE) {
909                 /* There is not enough space before start, but we may be able to
910                  * move the start forward by one page.
911                  */
912                 if (n_segs == 1)
913                         goto free_unlock;
914
915                 /* move start */
916                 aligned_start = RTE_PTR_ADD(aligned_start, page_sz);
917                 aligned_len -= page_sz;
918                 n_segs--;
919         }
920         if (after_space != 0 && after_space <
921                         MALLOC_ELEM_OVERHEAD + MIN_DATA_SIZE) {
922                 /* There is not enough space after end, but we may be able to
923                  * move the end backwards by one page.
924                  */
925                 if (n_segs == 1)
926                         goto free_unlock;
927
928                 /* move end */
929                 aligned_end = RTE_PTR_SUB(aligned_end, page_sz);
930                 aligned_len -= page_sz;
931                 n_segs--;
932         }
933
934         /* now we can finally free us some pages */
935
936         rte_mcfg_mem_write_lock();
937
938         /*
939          * we allow secondary processes to clear the heap of this allocated
940          * memory because it is safe to do so, as even if notifications about
941          * unmapped pages don't make it to other processes, heap is shared
942          * across all processes, and will become empty of this memory anyway,
943          * and nothing can allocate it back unless primary process will be able
944          * to deliver allocation message to every single running process.
945          */
946
947         malloc_elem_free_list_remove(elem);
948
949         malloc_elem_hide_region(elem, (void *) aligned_start, aligned_len);
950
951         heap->total_size -= aligned_len;
952
953         if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
954                 /* notify user about changes in memory map */
955                 eal_memalloc_mem_event_notify(RTE_MEM_EVENT_FREE,
956                                 aligned_start, aligned_len);
957
958                 /* don't care if any of this fails */
959                 malloc_heap_free_pages(aligned_start, aligned_len);
960
961                 request_sync();
962         } else {
963                 struct malloc_mp_req req;
964
965                 memset(&req, 0, sizeof(req));
966
967                 req.t = REQ_TYPE_FREE;
968                 req.free_req.addr = aligned_start;
969                 req.free_req.len = aligned_len;
970
971                 /*
972                  * we request primary to deallocate pages, but we don't do it
973                  * in this thread. instead, we notify primary that we would like
974                  * to deallocate pages, and this process will receive another
975                  * request (in parallel) that will do it for us on another
976                  * thread.
977                  *
978                  * we also don't really care if this succeeds - the data is
979                  * already removed from the heap, so it is, for all intents and
980                  * purposes, hidden from the rest of DPDK even if some other
981                  * process (including this one) may have these pages mapped.
982                  *
983                  * notifications about deallocated memory happen during sync.
984                  */
985                 request_to_primary(&req);
986         }
987
988         RTE_LOG(DEBUG, EAL, "Heap on socket %d was shrunk by %zdMB\n",
989                 msl->socket_id, aligned_len >> 20ULL);
990
991         rte_mcfg_mem_write_unlock();
992 free_unlock:
993         rte_spinlock_unlock(&(heap->lock));
994         return ret;
995 }
996
997 int
998 malloc_heap_resize(struct malloc_elem *elem, size_t size)
999 {
1000         int ret;
1001
1002         if (!malloc_elem_cookies_ok(elem) || elem->state != ELEM_BUSY)
1003                 return -1;
1004
1005         rte_spinlock_lock(&(elem->heap->lock));
1006
1007         ret = malloc_elem_resize(elem, size);
1008
1009         rte_spinlock_unlock(&(elem->heap->lock));
1010
1011         return ret;
1012 }
1013
1014 /*
1015  * Function to retrieve data for a given heap
1016  */
1017 int
1018 malloc_heap_get_stats(struct malloc_heap *heap,
1019                 struct rte_malloc_socket_stats *socket_stats)
1020 {
1021         size_t idx;
1022         struct malloc_elem *elem;
1023
1024         rte_spinlock_lock(&heap->lock);
1025
1026         /* Initialise variables for heap */
1027         socket_stats->free_count = 0;
1028         socket_stats->heap_freesz_bytes = 0;
1029         socket_stats->greatest_free_size = 0;
1030
1031         /* Iterate through free list */
1032         for (idx = 0; idx < RTE_HEAP_NUM_FREELISTS; idx++) {
1033                 for (elem = LIST_FIRST(&heap->free_head[idx]);
1034                         !!elem; elem = LIST_NEXT(elem, free_list))
1035                 {
1036                         socket_stats->free_count++;
1037                         socket_stats->heap_freesz_bytes += elem->size;
1038                         if (elem->size > socket_stats->greatest_free_size)
1039                                 socket_stats->greatest_free_size = elem->size;
1040                 }
1041         }
1042         /* Get stats on overall heap and allocated memory on this heap */
1043         socket_stats->heap_totalsz_bytes = heap->total_size;
1044         socket_stats->heap_allocsz_bytes = (socket_stats->heap_totalsz_bytes -
1045                         socket_stats->heap_freesz_bytes);
1046         socket_stats->alloc_count = heap->alloc_count;
1047
1048         rte_spinlock_unlock(&heap->lock);
1049         return 0;
1050 }
1051
1052 /*
1053  * Function to retrieve data for a given heap
1054  */
1055 void
1056 malloc_heap_dump(struct malloc_heap *heap, FILE *f)
1057 {
1058         struct malloc_elem *elem;
1059
1060         rte_spinlock_lock(&heap->lock);
1061
1062         fprintf(f, "Heap size: 0x%zx\n", heap->total_size);
1063         fprintf(f, "Heap alloc count: %u\n", heap->alloc_count);
1064
1065         elem = heap->first;
1066         while (elem) {
1067                 malloc_elem_dump(elem, f);
1068                 elem = elem->next;
1069         }
1070
1071         rte_spinlock_unlock(&heap->lock);
1072 }
1073
1074 static int
1075 destroy_elem(struct malloc_elem *elem, size_t len)
1076 {
1077         struct malloc_heap *heap = elem->heap;
1078
1079         /* notify all subscribers that a memory area is going to be removed */
1080         eal_memalloc_mem_event_notify(RTE_MEM_EVENT_FREE, elem, len);
1081
1082         /* this element can be removed */
1083         malloc_elem_free_list_remove(elem);
1084         malloc_elem_hide_region(elem, elem, len);
1085
1086         heap->total_size -= len;
1087
1088         memset(elem, 0, sizeof(*elem));
1089
1090         return 0;
1091 }
1092
1093 struct rte_memseg_list *
1094 malloc_heap_create_external_seg(void *va_addr, rte_iova_t iova_addrs[],
1095                 unsigned int n_pages, size_t page_sz, const char *seg_name,
1096                 unsigned int socket_id)
1097 {
1098         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
1099         char fbarray_name[RTE_FBARRAY_NAME_LEN];
1100         struct rte_memseg_list *msl = NULL;
1101         struct rte_fbarray *arr;
1102         size_t seg_len = n_pages * page_sz;
1103         unsigned int i;
1104
1105         /* first, find a free memseg list */
1106         for (i = 0; i < RTE_MAX_MEMSEG_LISTS; i++) {
1107                 struct rte_memseg_list *tmp = &mcfg->memsegs[i];
1108                 if (tmp->base_va == NULL) {
1109                         msl = tmp;
1110                         break;
1111                 }
1112         }
1113         if (msl == NULL) {
1114                 RTE_LOG(ERR, EAL, "Couldn't find empty memseg list\n");
1115                 rte_errno = ENOSPC;
1116                 return NULL;
1117         }
1118
1119         snprintf(fbarray_name, sizeof(fbarray_name), "%s_%p",
1120                         seg_name, va_addr);
1121
1122         /* create the backing fbarray */
1123         if (rte_fbarray_init(&msl->memseg_arr, fbarray_name, n_pages,
1124                         sizeof(struct rte_memseg)) < 0) {
1125                 RTE_LOG(ERR, EAL, "Couldn't create fbarray backing the memseg list\n");
1126                 return NULL;
1127         }
1128         arr = &msl->memseg_arr;
1129
1130         /* fbarray created, fill it up */
1131         for (i = 0; i < n_pages; i++) {
1132                 struct rte_memseg *ms;
1133
1134                 rte_fbarray_set_used(arr, i);
1135                 ms = rte_fbarray_get(arr, i);
1136                 ms->addr = RTE_PTR_ADD(va_addr, i * page_sz);
1137                 ms->iova = iova_addrs == NULL ? RTE_BAD_IOVA : iova_addrs[i];
1138                 ms->hugepage_sz = page_sz;
1139                 ms->len = page_sz;
1140                 ms->nchannel = rte_memory_get_nchannel();
1141                 ms->nrank = rte_memory_get_nrank();
1142                 ms->socket_id = socket_id;
1143         }
1144
1145         /* set up the memseg list */
1146         msl->base_va = va_addr;
1147         msl->page_sz = page_sz;
1148         msl->socket_id = socket_id;
1149         msl->len = seg_len;
1150         msl->version = 0;
1151         msl->external = 1;
1152
1153         return msl;
1154 }
1155
1156 struct extseg_walk_arg {
1157         void *va_addr;
1158         size_t len;
1159         struct rte_memseg_list *msl;
1160 };
1161
1162 static int
1163 extseg_walk(const struct rte_memseg_list *msl, void *arg)
1164 {
1165         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
1166         struct extseg_walk_arg *wa = arg;
1167
1168         if (msl->base_va == wa->va_addr && msl->len == wa->len) {
1169                 unsigned int found_idx;
1170
1171                 /* msl is const */
1172                 found_idx = msl - mcfg->memsegs;
1173                 wa->msl = &mcfg->memsegs[found_idx];
1174                 return 1;
1175         }
1176         return 0;
1177 }
1178
1179 struct rte_memseg_list *
1180 malloc_heap_find_external_seg(void *va_addr, size_t len)
1181 {
1182         struct extseg_walk_arg wa;
1183         int res;
1184
1185         wa.va_addr = va_addr;
1186         wa.len = len;
1187
1188         res = rte_memseg_list_walk_thread_unsafe(extseg_walk, &wa);
1189
1190         if (res != 1) {
1191                 /* 0 means nothing was found, -1 shouldn't happen */
1192                 if (res == 0)
1193                         rte_errno = ENOENT;
1194                 return NULL;
1195         }
1196         return wa.msl;
1197 }
1198
1199 int
1200 malloc_heap_destroy_external_seg(struct rte_memseg_list *msl)
1201 {
1202         /* destroy the fbarray backing this memory */
1203         if (rte_fbarray_destroy(&msl->memseg_arr) < 0)
1204                 return -1;
1205
1206         /* reset the memseg list */
1207         memset(msl, 0, sizeof(*msl));
1208
1209         return 0;
1210 }
1211
1212 int
1213 malloc_heap_add_external_memory(struct malloc_heap *heap,
1214                 struct rte_memseg_list *msl)
1215 {
1216         /* erase contents of new memory */
1217         memset(msl->base_va, 0, msl->len);
1218
1219         /* now, add newly minted memory to the malloc heap */
1220         malloc_heap_add_memory(heap, msl, msl->base_va, msl->len);
1221
1222         heap->total_size += msl->len;
1223
1224         /* all done! */
1225         RTE_LOG(DEBUG, EAL, "Added segment for heap %s starting at %p\n",
1226                         heap->name, msl->base_va);
1227
1228         /* notify all subscribers that a new memory area has been added */
1229         eal_memalloc_mem_event_notify(RTE_MEM_EVENT_ALLOC,
1230                         msl->base_va, msl->len);
1231
1232         return 0;
1233 }
1234
1235 int
1236 malloc_heap_remove_external_memory(struct malloc_heap *heap, void *va_addr,
1237                 size_t len)
1238 {
1239         struct malloc_elem *elem = heap->first;
1240
1241         /* find element with specified va address */
1242         while (elem != NULL && elem != va_addr) {
1243                 elem = elem->next;
1244                 /* stop if we've blown past our VA */
1245                 if (elem > (struct malloc_elem *)va_addr) {
1246                         rte_errno = ENOENT;
1247                         return -1;
1248                 }
1249         }
1250         /* check if element was found */
1251         if (elem == NULL || elem->msl->len != len) {
1252                 rte_errno = ENOENT;
1253                 return -1;
1254         }
1255         /* if element's size is not equal to segment len, segment is busy */
1256         if (elem->state == ELEM_BUSY || elem->size != len) {
1257                 rte_errno = EBUSY;
1258                 return -1;
1259         }
1260         return destroy_elem(elem, len);
1261 }
1262
1263 int
1264 malloc_heap_create(struct malloc_heap *heap, const char *heap_name)
1265 {
1266         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
1267         uint32_t next_socket_id = mcfg->next_socket_id;
1268
1269         /* prevent overflow. did you really create 2 billion heaps??? */
1270         if (next_socket_id > INT32_MAX) {
1271                 RTE_LOG(ERR, EAL, "Cannot assign new socket ID's\n");
1272                 rte_errno = ENOSPC;
1273                 return -1;
1274         }
1275
1276         /* initialize empty heap */
1277         heap->alloc_count = 0;
1278         heap->first = NULL;
1279         heap->last = NULL;
1280         LIST_INIT(heap->free_head);
1281         rte_spinlock_init(&heap->lock);
1282         heap->total_size = 0;
1283         heap->socket_id = next_socket_id;
1284
1285         /* we hold a global mem hotplug writelock, so it's safe to increment */
1286         mcfg->next_socket_id++;
1287
1288         /* set up name */
1289         strlcpy(heap->name, heap_name, RTE_HEAP_NAME_MAX_LEN);
1290         return 0;
1291 }
1292
1293 int
1294 malloc_heap_destroy(struct malloc_heap *heap)
1295 {
1296         if (heap->alloc_count != 0) {
1297                 RTE_LOG(ERR, EAL, "Heap is still in use\n");
1298                 rte_errno = EBUSY;
1299                 return -1;
1300         }
1301         if (heap->first != NULL || heap->last != NULL) {
1302                 RTE_LOG(ERR, EAL, "Heap still contains memory segments\n");
1303                 rte_errno = EBUSY;
1304                 return -1;
1305         }
1306         if (heap->total_size != 0)
1307                 RTE_LOG(ERR, EAL, "Total size not zero, heap is likely corrupt\n");
1308
1309         /* after this, the lock will be dropped */
1310         memset(heap, 0, sizeof(*heap));
1311
1312         return 0;
1313 }
1314
1315 int
1316 rte_eal_malloc_heap_init(void)
1317 {
1318         struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
1319         unsigned int i;
1320
1321         if (internal_config.match_allocations) {
1322                 RTE_LOG(DEBUG, EAL, "Hugepages will be freed exactly as allocated.\n");
1323         }
1324
1325         if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
1326                 /* assign min socket ID to external heaps */
1327                 mcfg->next_socket_id = EXTERNAL_HEAP_MIN_SOCKET_ID;
1328
1329                 /* assign names to default DPDK heaps */
1330                 for (i = 0; i < rte_socket_count(); i++) {
1331                         struct malloc_heap *heap = &mcfg->malloc_heaps[i];
1332                         char heap_name[RTE_HEAP_NAME_MAX_LEN];
1333                         int socket_id = rte_socket_id_by_idx(i);
1334
1335                         snprintf(heap_name, sizeof(heap_name),
1336                                         "socket_%i", socket_id);
1337                         strlcpy(heap->name, heap_name, RTE_HEAP_NAME_MAX_LEN);
1338                         heap->socket_id = socket_id;
1339                 }
1340         }
1341
1342
1343         if (register_mp_requests()) {
1344                 RTE_LOG(ERR, EAL, "Couldn't register malloc multiprocess actions\n");
1345                 rte_mcfg_mem_read_unlock();
1346                 return -1;
1347         }
1348
1349         /* unlock mem hotplug here. it's safe for primary as no requests can
1350          * even come before primary itself is fully initialized, and secondaries
1351          * do not need to initialize the heap.
1352          */
1353         rte_mcfg_mem_read_unlock();
1354
1355         /* secondary process does not need to initialize anything */
1356         if (rte_eal_process_type() != RTE_PROC_PRIMARY)
1357                 return 0;
1358
1359         /* add all IOVA-contiguous areas to the heap */
1360         return rte_memseg_contig_walk(malloc_add_seg, NULL);
1361 }