2 * Copyright (c) 2015 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 * buffer.c: allocate/free network buffers.
18 * Copyright (c) 2008 Eliot Dresselhaus
20 * Permission is hereby granted, free of charge, to any person obtaining
21 * a copy of this software and associated documentation files (the
22 * "Software"), to deal in the Software without restriction, including
23 * without limitation the rights to use, copy, modify, merge, publish,
24 * distribute, sublicense, and/or sell copies of the Software, and to
25 * permit persons to whom the Software is furnished to do so, subject to
26 * the following conditions:
28 * The above copyright notice and this permission notice shall be
29 * included in all copies or substantial portions of the Software.
31 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
32 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
33 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
34 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
35 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
36 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
37 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
43 * Allocate/free network buffers.
46 #include <vppinfra/linux/sysfs.h>
47 #include <vppinfra/bitmap.h>
48 #include <vppinfra/unix.h>
49 #include <vlib/vlib.h>
50 #include <vlib/unix/unix.h>
51 #include <vlib/stats/stats.h>
53 #define VLIB_BUFFER_DEFAULT_BUFFERS_PER_NUMA 16384
54 #define VLIB_BUFFER_DEFAULT_BUFFERS_PER_NUMA_UNPRIV 8192
56 #ifdef CLIB_HAVE_VEC128
57 /* Assumptions by vlib_buffer_free_inline: */
58 STATIC_ASSERT_FITS_IN (vlib_buffer_t, flags, 16);
59 STATIC_ASSERT_FITS_IN (vlib_buffer_t, ref_count, 16);
60 STATIC_ASSERT_FITS_IN (vlib_buffer_t, buffer_pool_index, 16);
63 u16 __vlib_buffer_external_hdr_size = 0;
66 vlib_buffer_length_in_chain_slow_path (vlib_main_t * vm,
67 vlib_buffer_t * b_first)
69 vlib_buffer_t *b = b_first;
70 uword l_first = b_first->current_length;
72 while (b->flags & VLIB_BUFFER_NEXT_PRESENT)
74 b = vlib_get_buffer (vm, b->next_buffer);
75 l += b->current_length;
77 b_first->total_length_not_including_first_buffer = l;
78 b_first->flags |= VLIB_BUFFER_TOTAL_LENGTH_VALID;
83 format_vlib_buffer_no_chain (u8 * s, va_list * args)
85 vlib_buffer_t *b = va_arg (*args, vlib_buffer_t *);
86 u32 indent = format_get_indent (s);
89 #define _(bit, name, v) \
90 if (v && (b->flags & VLIB_BUFFER_##name)) \
91 a = format (a, "%s ", v);
92 foreach_vlib_buffer_flag
94 s = format (s, "current data %d, length %d, buffer-pool %d, "
95 "ref-count %u", b->current_data, b->current_length,
96 b->buffer_pool_index, b->ref_count);
98 if (b->flags & VLIB_BUFFER_NEXT_PRESENT)
99 s = format (s, ", totlen-nifb %d",
100 b->total_length_not_including_first_buffer);
102 if (b->flags & VLIB_BUFFER_IS_TRACED)
103 s = format (s, ", trace handle 0x%x", b->trace_handle);
106 s = format (s, "\n%U%v", format_white_space, indent, a);
113 format_vlib_buffer (u8 * s, va_list * args)
115 vlib_main_t *vm = vlib_get_main ();
116 vlib_buffer_t *b = va_arg (*args, vlib_buffer_t *);
117 u32 indent = format_get_indent (s);
119 s = format (s, "%U", format_vlib_buffer_no_chain, b);
121 while (b->flags & VLIB_BUFFER_NEXT_PRESENT)
123 u32 next_buffer = b->next_buffer;
124 b = vlib_get_buffer (vm, next_buffer);
127 format (s, "\n%Unext-buffer 0x%x, segment length %d, ref-count %u",
128 format_white_space, indent, next_buffer, b->current_length,
136 format_vlib_buffer_and_data (u8 * s, va_list * args)
138 vlib_buffer_t *b = va_arg (*args, vlib_buffer_t *);
140 s = format (s, "%U, %U",
141 format_vlib_buffer, b,
142 format_hex_bytes, vlib_buffer_get_current (b), 64);
148 format_vlib_buffer_known_state (u8 * s, va_list * args)
150 vlib_buffer_known_state_t state = va_arg (*args, vlib_buffer_known_state_t);
155 case VLIB_BUFFER_UNKNOWN:
159 case VLIB_BUFFER_KNOWN_ALLOCATED:
160 t = "known-allocated";
163 case VLIB_BUFFER_KNOWN_FREE:
172 return format (s, "%s", t);
176 format_vlib_buffer_contents (u8 * s, va_list * va)
178 vlib_main_t *vm = va_arg (*va, vlib_main_t *);
179 vlib_buffer_t *b = va_arg (*va, vlib_buffer_t *);
183 vec_add (s, vlib_buffer_get_current (b), b->current_length);
184 if (!(b->flags & VLIB_BUFFER_NEXT_PRESENT))
186 b = vlib_get_buffer (vm, b->next_buffer);
193 vlib_validate_buffer_helper (vlib_main_t * vm,
195 uword follow_buffer_next, uword ** unique_hash)
197 vlib_buffer_main_t *bm = vm->buffer_main;
198 vlib_buffer_t *b = vlib_get_buffer (vm, bi);
200 if (vec_len (bm->buffer_pools) <= b->buffer_pool_index)
201 return format (0, "unknown buffer pool 0x%x", b->buffer_pool_index);
203 if ((signed) b->current_data < (signed) -VLIB_BUFFER_PRE_DATA_SIZE)
204 return format (0, "current data %d before pre-data", b->current_data);
206 if (b->current_data + b->current_length >
207 vlib_buffer_get_default_data_size (vm))
208 return format (0, "%d-%d beyond end of buffer %d", b->current_data,
209 b->current_length, vlib_buffer_get_default_data_size (vm));
211 if (follow_buffer_next && (b->flags & VLIB_BUFFER_NEXT_PRESENT))
213 vlib_buffer_known_state_t k;
216 k = vlib_buffer_is_known (vm, b->next_buffer);
217 if (k != VLIB_BUFFER_KNOWN_ALLOCATED)
218 return format (0, "next 0x%x: %U",
219 b->next_buffer, format_vlib_buffer_known_state, k);
223 if (hash_get (*unique_hash, b->next_buffer))
224 return format (0, "duplicate buffer 0x%x", b->next_buffer);
226 hash_set1 (*unique_hash, b->next_buffer);
229 msg = vlib_validate_buffer (vm, b->next_buffer, follow_buffer_next);
232 result = format (0, "next 0x%x: %v", b->next_buffer, msg);
242 vlib_validate_buffer (vlib_main_t * vm, u32 bi, uword follow_buffer_next)
244 return vlib_validate_buffer_helper (vm, bi, follow_buffer_next,
245 /* unique_hash */ 0);
249 vlib_validate_buffers (vlib_main_t * vm,
251 uword next_buffer_stride,
253 vlib_buffer_known_state_t known_state,
254 uword follow_buffer_next)
257 u32 bi, *b = buffers;
258 vlib_buffer_known_state_t k;
259 u8 *msg = 0, *result = 0;
261 hash = hash_create (0, 0);
262 for (i = 0; i < n_buffers; i++)
265 b += next_buffer_stride;
267 /* Buffer is not unique. */
268 if (hash_get (hash, bi))
270 msg = format (0, "not unique");
274 k = vlib_buffer_is_known (vm, bi);
275 if (k != known_state)
277 msg = format (0, "is %U; expected %U",
278 format_vlib_buffer_known_state, k,
279 format_vlib_buffer_known_state, known_state);
283 msg = vlib_validate_buffer_helper (vm, bi, follow_buffer_next, &hash);
287 hash_set1 (hash, bi);
293 result = format (0, "0x%x: %v", bi, msg);
300 /* When debugging validate that given buffers are either known allocated
303 vlib_buffer_validate_alloc_free (vlib_main_t * vm,
306 vlib_buffer_known_state_t expected_state)
308 vlib_buffer_main_t *bm = vm->buffer_main;
310 uword i, bi, is_free;
315 is_free = expected_state == VLIB_BUFFER_KNOWN_ALLOCATED;
317 for (i = 0; i < n_buffers; i++)
319 vlib_buffer_known_state_t known;
323 known = vlib_buffer_is_known (vm, bi);
325 if (known == VLIB_BUFFER_UNKNOWN &&
326 expected_state == VLIB_BUFFER_KNOWN_FREE)
327 known = VLIB_BUFFER_KNOWN_FREE;
329 if (known != expected_state)
331 clib_panic ("%s %U buffer 0x%x", is_free ? "freeing" : "allocating",
332 format_vlib_buffer_known_state, known, bi);
335 clib_spinlock_lock (&bm->buffer_known_hash_lockp);
336 hash_set (bm->buffer_known_hash, bi, is_free ? VLIB_BUFFER_KNOWN_FREE :
337 VLIB_BUFFER_KNOWN_ALLOCATED);
338 clib_spinlock_unlock (&bm->buffer_known_hash_lockp);
343 vlib_packet_template_init (vlib_main_t * vm,
344 vlib_packet_template_t * t,
346 uword n_packet_data_bytes,
347 uword min_n_buffers_each_alloc, char *fmt, ...)
352 t->name = va_format (0, fmt, &va);
355 vlib_worker_thread_barrier_sync (vm);
357 clib_memset (t, 0, sizeof (t[0]));
359 vec_add (t->packet_data, packet_data, n_packet_data_bytes);
360 t->min_n_buffers_each_alloc = min_n_buffers_each_alloc;
361 vlib_worker_thread_barrier_release (vm);
365 vlib_packet_template_get_packet (vlib_main_t * vm,
366 vlib_packet_template_t * t, u32 * bi_result)
371 if (vlib_buffer_alloc (vm, &bi, 1) != 1)
376 b = vlib_get_buffer (vm, bi);
377 clib_memcpy_fast (vlib_buffer_get_current (b),
378 t->packet_data, vec_len (t->packet_data));
379 b->current_length = vec_len (t->packet_data);
384 /* Append given data to end of buffer, possibly allocating new buffers. */
386 vlib_buffer_add_data (vlib_main_t * vm, u32 * buffer_index, void *data,
389 u32 n_buffer_bytes, n_left, n_left_this_buffer, bi;
394 if (bi == ~0 && 1 != vlib_buffer_alloc (vm, &bi, 1))
398 n_left = n_data_bytes;
399 n_buffer_bytes = vlib_buffer_get_default_data_size (vm);
401 b = vlib_get_buffer (vm, bi);
402 b->flags &= ~VLIB_BUFFER_TOTAL_LENGTH_VALID;
404 /* Get to the end of the chain before we try to append data... */
405 while (b->flags & VLIB_BUFFER_NEXT_PRESENT)
406 b = vlib_get_buffer (vm, b->next_buffer);
412 ASSERT (n_buffer_bytes >= b->current_length);
414 n_buffer_bytes - (b->current_data + b->current_length);
415 n = clib_min (n_left_this_buffer, n_left);
416 clib_memcpy_fast (vlib_buffer_get_current (b) + b->current_length, d,
418 b->current_length += n;
424 if (1 != vlib_buffer_alloc (vm, &b->next_buffer, 1))
427 b->flags |= VLIB_BUFFER_NEXT_PRESENT;
429 b = vlib_get_buffer (vm, b->next_buffer);
436 clib_warning ("out of buffers");
441 vlib_buffer_chain_append_data_with_alloc (vlib_main_t * vm,
442 vlib_buffer_t * first,
443 vlib_buffer_t ** last, void *data,
446 vlib_buffer_t *l = *last;
447 u32 n_buffer_bytes = vlib_buffer_get_default_data_size (vm);
449 ASSERT (n_buffer_bytes >= l->current_length + l->current_data);
452 u16 max = n_buffer_bytes - l->current_length - l->current_data;
455 if (1 != vlib_buffer_alloc_from_pool (vm, &l->next_buffer, 1,
456 first->buffer_pool_index))
458 *last = l = vlib_buffer_chain_buffer (vm, l, l->next_buffer);
459 max = n_buffer_bytes - l->current_length - l->current_data;
462 u16 len = (data_len > max) ? max : data_len;
463 clib_memcpy_fast (vlib_buffer_get_current (l) + l->current_length,
465 vlib_buffer_chain_increase_length (first, l, len);
473 vlib_buffer_alloc_size (uword ext_hdr_size, uword data_size)
475 uword alloc_size = ext_hdr_size + sizeof (vlib_buffer_t) + data_size;
476 alloc_size = round_pow2 (alloc_size, VLIB_BUFFER_ALIGN);
478 /* in case when we have even number of 'cachelines', we add one more for
479 * better cache occupancy */
480 alloc_size |= VLIB_BUFFER_ALIGN;
486 vlib_buffer_pool_create (vlib_main_t *vm, u32 data_size, u32 physmem_map_index,
489 vlib_buffer_main_t *bm = vm->buffer_main;
490 vlib_buffer_pool_t *bp;
491 vlib_physmem_map_t *m = vlib_physmem_get_map (vm, physmem_map_index);
492 uword start = pointer_to_uword (m->base);
493 uword size = (uword) m->n_pages << m->log2_page_size;
494 uword page_mask = ~pow2_mask (m->log2_page_size);
499 if (vec_len (bm->buffer_pools) >= 255)
502 vec_add2_aligned (bm->buffer_pools, bp, 1, CLIB_CACHE_LINE_BYTES);
504 if (bm->buffer_mem_size == 0)
506 bm->buffer_mem_start = start;
507 bm->buffer_mem_size = size;
509 else if (start < bm->buffer_mem_start)
511 bm->buffer_mem_size += bm->buffer_mem_start - start;
512 bm->buffer_mem_start = start;
513 if (size > bm->buffer_mem_size)
514 bm->buffer_mem_size = size;
516 else if (start > bm->buffer_mem_start)
518 uword new_size = start - bm->buffer_mem_start + size;
519 if (new_size > bm->buffer_mem_size)
520 bm->buffer_mem_size = new_size;
523 if ((u64) bm->buffer_mem_size >
524 ((u64) 1 << (32 + CLIB_LOG2_CACHE_LINE_BYTES)))
526 clib_panic ("buffer memory size out of range!");
531 bp->index = bp - bm->buffer_pools;
532 bp->buffer_template.buffer_pool_index = bp->index;
533 bp->buffer_template.ref_count = 1;
534 bp->physmem_map_index = physmem_map_index;
535 bp->data_size = data_size;
536 bp->numa_node = m->numa_node;
537 bp->log2_page_size = m->log2_page_size;
540 bp->name = va_format (0, fmt, &va);
543 vec_validate_aligned (bp->threads, vlib_get_n_threads () - 1,
544 CLIB_CACHE_LINE_BYTES);
546 alloc_size = vlib_buffer_alloc_size (bm->ext_hdr_size, data_size);
547 bp->alloc_size = alloc_size;
549 /* preallocate buffer indices memory */
550 bp->buffers = clib_mem_alloc_aligned (
551 round_pow2 ((size / alloc_size) * sizeof (u32), CLIB_CACHE_LINE_BYTES),
552 CLIB_CACHE_LINE_BYTES);
554 clib_spinlock_init (&bp->lock);
558 /* start with naturally aligned address */
559 p += alloc_size - (uword) p % alloc_size;
562 * Waste 1 buffer (maximum) so that 0 is never a valid buffer index.
563 * Allows various places to ASSERT (bi != 0). Much easier
564 * than debugging downstream crashes in successor nodes.
569 for (; p < (u8 *) m->base + size - alloc_size; p += alloc_size)
574 /* skip if buffer spans across page boundary */
575 if (((uword) p & page_mask) != ((uword) (p + alloc_size) & page_mask))
578 b = (vlib_buffer_t *) (p + bm->ext_hdr_size);
579 b->template = bp->buffer_template;
580 bi = vlib_get_buffer_index (vm, b);
581 bp->buffers[bp->n_avail++] = bi;
582 vlib_get_buffer (vm, bi);
585 bp->n_buffers = bp->n_avail;
591 format_vlib_buffer_pool (u8 * s, va_list * va)
593 vlib_main_t *vm = va_arg (*va, vlib_main_t *);
594 vlib_buffer_pool_t *bp = va_arg (*va, vlib_buffer_pool_t *);
595 vlib_buffer_pool_thread_t *bpt;
599 return format (s, "%-20s%=6s%=6s%=6s%=11s%=6s%=8s%=8s%=8s",
600 "Pool Name", "Index", "NUMA", "Size", "Data Size",
601 "Total", "Avail", "Cached", "Used");
603 vec_foreach (bpt, bp->threads)
604 cached += bpt->n_cached;
606 s = format (s, "%-20v%=6d%=6d%=6u%=11u%=6u%=8u%=8u%=8u", bp->name, bp->index,
608 bp->data_size + sizeof (vlib_buffer_t) +
609 vm->buffer_main->ext_hdr_size,
610 bp->data_size, bp->n_buffers, bp->n_avail, cached,
611 bp->n_buffers - bp->n_avail - cached);
617 format_vlib_buffer_pool_all (u8 *s, va_list *va)
619 vlib_main_t *vm = va_arg (*va, vlib_main_t *);
620 vlib_buffer_main_t *bm = vm->buffer_main;
621 vlib_buffer_pool_t *bp;
623 s = format (s, "%U", format_vlib_buffer_pool, vm, 0);
625 vec_foreach (bp, bm->buffer_pools)
626 s = format (s, "\n%U", format_vlib_buffer_pool, vm, bp);
631 static clib_error_t *
632 show_buffers (vlib_main_t *vm, unformat_input_t *input,
633 vlib_cli_command_t *cmd)
635 vlib_cli_output (vm, "%U", format_vlib_buffer_pool_all, vm);
639 VLIB_CLI_COMMAND (show_buffers_command, static) = {
640 .path = "show buffers",
641 .short_help = "Show packet buffer allocation",
642 .function = show_buffers,
646 vlib_buffer_num_workers_change (vlib_main_t *vm)
648 vlib_buffer_main_t *bm = vm->buffer_main;
649 vlib_buffer_pool_t *bp;
651 vec_foreach (bp, bm->buffer_pools)
652 vec_validate_aligned (bp->threads, vlib_get_n_threads () - 1,
653 CLIB_CACHE_LINE_BYTES);
658 VLIB_NUM_WORKERS_CHANGE_FN (vlib_buffer_num_workers_change);
660 static clib_error_t *
661 vlib_buffer_main_init_numa_alloc (struct vlib_main_t *vm, u32 numa_node,
662 u32 * physmem_map_index,
663 clib_mem_page_sz_t log2_page_size,
666 vlib_buffer_main_t *bm = vm->buffer_main;
667 u32 buffers_per_numa = bm->buffers_per_numa;
670 uword n_pages, pagesize;
673 ASSERT (log2_page_size != CLIB_MEM_PAGE_SZ_UNKNOWN);
675 pagesize = clib_mem_page_bytes (log2_page_size);
676 buffer_size = vlib_buffer_alloc_size (bm->ext_hdr_size,
677 vlib_buffer_get_default_data_size
679 if (buffer_size > pagesize)
680 return clib_error_return (0, "buffer size (%llu) is greater than page "
681 "size (%llu)", buffer_size, pagesize);
683 if (buffers_per_numa == 0)
684 buffers_per_numa = unpriv ? VLIB_BUFFER_DEFAULT_BUFFERS_PER_NUMA_UNPRIV :
685 VLIB_BUFFER_DEFAULT_BUFFERS_PER_NUMA;
687 name = format (0, "buffers-numa-%d%c", numa_node, 0);
688 n_pages = (buffers_per_numa - 1) / (pagesize / buffer_size) + 1;
689 error = vlib_physmem_shared_map_create (vm, (char *) name,
691 min_log2 (pagesize), numa_node,
697 static clib_error_t *
698 vlib_buffer_main_init_numa_node (struct vlib_main_t *vm, u32 numa_node,
701 vlib_buffer_main_t *bm = vm->buffer_main;
702 u32 physmem_map_index;
705 if (bm->log2_page_size == CLIB_MEM_PAGE_SZ_UNKNOWN)
707 error = vlib_buffer_main_init_numa_alloc (vm, numa_node,
709 CLIB_MEM_PAGE_SZ_DEFAULT_HUGE,
712 goto buffer_pool_create;
714 /* If alloc failed, retry without hugepages */
715 vlib_log_warn (bm->log_default,
716 "numa[%u] falling back to non-hugepage backed "
717 "buffer pool (%U)", numa_node, format_clib_error, error);
718 clib_error_free (error);
720 error = vlib_buffer_main_init_numa_alloc (vm, numa_node,
722 CLIB_MEM_PAGE_SZ_DEFAULT,
726 error = vlib_buffer_main_init_numa_alloc (vm, numa_node,
735 vlib_buffer_pool_create (vm, vlib_buffer_get_default_data_size (vm),
736 physmem_map_index, "default-numa-%d", numa_node);
738 if (*index == (u8) ~ 0)
739 error = clib_error_return (0, "maximum number of buffer pools reached");
746 vlib_buffer_main_alloc (vlib_main_t * vm)
748 vlib_buffer_main_t *bm;
753 vm->buffer_main = bm = clib_mem_alloc (sizeof (bm[0]));
754 clib_memset (vm->buffer_main, 0, sizeof (bm[0]));
755 bm->default_data_size = VLIB_BUFFER_DEFAULT_DATA_SIZE;
759 buffer_get_cached (vlib_buffer_pool_t * bp)
762 vlib_buffer_pool_thread_t *bpt;
764 clib_spinlock_lock (&bp->lock);
766 vec_foreach (bpt, bp->threads)
767 cached += bpt->n_cached;
769 clib_spinlock_unlock (&bp->lock);
774 static vlib_buffer_pool_t *
775 buffer_get_by_index (vlib_buffer_main_t * bm, u32 index)
777 vlib_buffer_pool_t *bp;
778 if (!bm->buffer_pools || vec_len (bm->buffer_pools) < index)
780 bp = vec_elt_at_index (bm->buffer_pools, index);
786 buffer_gauges_collect_used_fn (vlib_stats_collector_data_t *d)
788 vlib_main_t *vm = vlib_get_main ();
789 vlib_buffer_pool_t *bp =
790 buffer_get_by_index (vm->buffer_main, d->private_data);
794 d->entry->value = bp->n_buffers - bp->n_avail - buffer_get_cached (bp);
798 buffer_gauges_collect_available_fn (vlib_stats_collector_data_t *d)
800 vlib_main_t *vm = vlib_get_main ();
801 vlib_buffer_pool_t *bp =
802 buffer_get_by_index (vm->buffer_main, d->private_data);
806 d->entry->value = bp->n_avail;
810 buffer_gauges_collect_cached_fn (vlib_stats_collector_data_t *d)
812 vlib_main_t *vm = vlib_get_main ();
813 vlib_buffer_pool_t *bp =
814 buffer_get_by_index (vm->buffer_main, d->private_data);
818 d->entry->value = buffer_get_cached (bp);
822 vlib_buffer_main_init (struct vlib_main_t * vm)
824 vlib_buffer_main_t *bm;
826 clib_bitmap_t *bmp = 0, *bmp_has_memory = 0;
828 vlib_buffer_pool_t *bp;
829 u8 *name = 0, first_valid_buffer_pool_index = ~0;
831 vlib_buffer_main_alloc (vm);
833 bm = vm->buffer_main;
834 bm->log_default = vlib_log_register_class ("buffer", 0);
835 bm->ext_hdr_size = __vlib_buffer_external_hdr_size;
837 clib_spinlock_init (&bm->buffer_known_hash_lockp);
839 bmp = os_get_online_cpu_node_bitmap ();
841 if ((err = clib_sysfs_read ("/sys/devices/system/node/has_memory", "%U",
842 unformat_bitmap_list, &bmp_has_memory)))
843 clib_error_free (err);
845 if (bmp && bmp_has_memory)
846 bmp = clib_bitmap_and (bmp, bmp_has_memory);
848 /* no info from sysfs, assuming that only numa 0 exists */
850 bmp = clib_bitmap_set (bmp, 0, 1);
852 if (clib_bitmap_last_set (bmp) >= VLIB_BUFFER_MAX_NUMA_NODES)
853 clib_panic ("system have more than %u NUMA nodes",
854 VLIB_BUFFER_MAX_NUMA_NODES);
856 clib_bitmap_foreach (numa_node, bmp)
858 u8 *index = bm->default_buffer_pool_index_for_numa + numa_node;
860 if ((err = vlib_buffer_main_init_numa_node (vm, numa_node, index)))
862 clib_error_report (err);
863 clib_error_free (err);
867 if (first_valid_buffer_pool_index == 0xff)
868 first_valid_buffer_pool_index = index[0];
871 if (first_valid_buffer_pool_index == (u8) ~ 0)
873 err = clib_error_return (0, "failed to allocate buffer pool(s)");
877 clib_bitmap_foreach (numa_node, bmp)
879 if (bm->default_buffer_pool_index_for_numa[numa_node] == (u8) ~0)
880 bm->default_buffer_pool_index_for_numa[numa_node] =
881 first_valid_buffer_pool_index;
884 vec_foreach (bp, bm->buffer_pools)
886 vlib_stats_collector_reg_t reg = { .private_data = bp - bm->buffer_pools };
887 if (bp->n_buffers == 0)
891 vlib_stats_add_gauge ("/buffer-pools/%v/cached", bp->name);
892 reg.collect_fn = buffer_gauges_collect_cached_fn;
893 vlib_stats_register_collector_fn (®);
895 reg.entry_index = vlib_stats_add_gauge ("/buffer-pools/%v/used", bp->name);
896 reg.collect_fn = buffer_gauges_collect_used_fn;
897 vlib_stats_register_collector_fn (®);
900 vlib_stats_add_gauge ("/buffer-pools/%v/available", bp->name);
901 reg.collect_fn = buffer_gauges_collect_available_fn;
902 vlib_stats_register_collector_fn (®);
907 vec_free (bmp_has_memory);
912 static clib_error_t *
913 vlib_buffers_configure (vlib_main_t * vm, unformat_input_t * input)
915 vlib_buffer_main_t *bm;
917 vlib_buffer_main_alloc (vm);
919 bm = vm->buffer_main;
920 bm->log2_page_size = CLIB_MEM_PAGE_SZ_UNKNOWN;
922 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
924 if (unformat (input, "buffers-per-numa %u", &bm->buffers_per_numa))
926 else if (unformat (input, "page-size %U", unformat_log2_page_size,
927 &bm->log2_page_size))
929 else if (unformat (input, "default data-size %u",
930 &bm->default_data_size))
933 return unformat_parse_error (input);
936 unformat_free (input);
940 VLIB_EARLY_CONFIG_FUNCTION (vlib_buffers_configure, "buffers");
942 #if VLIB_BUFFER_ALLOC_FAULT_INJECTOR > 0
944 vlib_buffer_alloc_may_fail (vlib_main_t * vm, u32 n_buffers)
948 r = random_f64 (&vm->buffer_alloc_success_seed);
950 /* Fail this request? */
951 if (r > vm->buffer_alloc_success_rate)
953 /* 5% chance of returning nothing at all */
954 if (r > vm->buffer_alloc_success_rate && r > 0.95)
962 vlib_buffer_set_alloc_free_callback (
963 vlib_main_t *vm, vlib_buffer_alloc_free_callback_t *alloc_callback_fn,
964 vlib_buffer_alloc_free_callback_t *free_callback_fn)
966 vlib_buffer_main_t *bm = vm->buffer_main;
967 if ((alloc_callback_fn && bm->alloc_callback_fn) ||
968 (free_callback_fn && bm->free_callback_fn))
970 bm->alloc_callback_fn = alloc_callback_fn;
971 bm->free_callback_fn = free_callback_fn;
977 * fd.io coding-style-patch-verification: ON
980 * eval: (c-set-style "gnu")