This file is indexed.

/usr/include/vowpalwabbit/memory.h is in libvw-dev 8.5.0.dfsg1-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
#pragma once
#include <stdlib.h>
#include <stdio.h>
#include <iostream>

template<class T>
T* calloc_or_throw(size_t nmemb)
{ if (nmemb == 0)
    return nullptr;

  void* data = calloc(nmemb, sizeof(T));
  if (data == nullptr)
  { const char* msg = "internal error: memory allocation failed!\n";
    // use low-level function since we're already out of memory.
    fputs(msg, stderr);
    THROW(msg);
  }
  return (T*)data;
}

template<class T> T& calloc_or_throw()
{ return *calloc_or_throw<T>(1); }

#ifdef MADV_MERGEABLE
template<class T>
T* calloc_mergable_or_throw(size_t nmemb)
{ if (nmemb == 0)
    return nullptr;
  size_t length = nmemb * sizeof(T);
  void* data;
  if (0 != posix_memalign(&data, sysconf(_SC_PAGE_SIZE), length))
  { const char* msg = "internal error: memory allocation failed!\n";
    fputs(msg, stderr);
    THROW(msg);
  }
  if (data == nullptr)
  { const char* msg = "internal error: memory allocation failed!\n";
    fputs(msg, stderr);
    THROW(msg);
  }
  memset(data, 0, length);
// mark weight vector as KSM sharable
// it allows to save memory if you run multiple instances of the same model
// see more https://www.kernel.org/doc/Documentation/vm/ksm.txt
// you need to have Linux kernel >= 2.6.32 and KSM enabled
// to check is KSM enabled run the command
// $ grep KSM /boot/config-`uname -r`
// if KSM is enabled you should see:
// >> CONFIG_KSM=y
// you can enable ksmd with sudo "echo 1 > /sys/kernel/mm/ksm/run"
// mark address space as a candidate for merging

  if (0 != madvise(data, length, MADV_MERGEABLE))
  { const char* msg = "internal warning: marking memory as ksm mergeable failed!\n";
    fputs(msg, stderr);
  }
  return (T*)data;
}
#else
#define calloc_mergable_or_throw calloc_or_throw
#endif



inline void free_it(void* ptr) { if (ptr != nullptr) free(ptr); ptr = nullptr; }