File: pagemap.h

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (76 lines) | stat: -rw-r--r-- 2,548 bytes parent folder | download | duplicates (7)
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
66
67
68
69
70
71
72
73
74
75
76
// Copyright 2020 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROMEOS_ASH_COMPONENTS_MEMORY_PAGEMAP_H_
#define CHROMEOS_ASH_COMPONENTS_MEMORY_PAGEMAP_H_

#include <sys/types.h>
#include <unistd.h>
#include <vector>

#include "base/component_export.h"
#include "base/files/scoped_file.h"

namespace ash {
namespace memory {

// Pagemap fetches pagemap entries from procfs for a process.
class COMPONENT_EXPORT(ASH_MEMORY) Pagemap {
 public:
  // For more information on the Pagemap layout see the kernel documentation at
  // https://www.kernel.org/doc/Documentation/vm/pagemap.txt
  struct PagemapEntry {
    uint8_t swap_type : 5;
    uint64_t swap_offset : 50;
    bool pte_soft_dirty : 1;
    bool page_exclusively_mapped : 1;
    uint8_t : 4;  // these bits are unused
    bool page_file_or_shared_anon : 1;
    bool page_swapped : 1;
    bool page_present : 1;
  } __attribute__((packed));

  static_assert(sizeof(PagemapEntry) == sizeof(uint64_t),
                "PagemapEntry is expected to be 8 bytes");

  explicit Pagemap(pid_t pid);

  Pagemap(const Pagemap&) = delete;
  Pagemap& operator=(const Pagemap&) = delete;

  ~Pagemap();

  bool IsValid() const;

  // GetEntries will populate |entries| for the memory region specified.
  // It is required that |address| be page aligned and |length| must always be a
  // page length multiple. Additionally, |entries| is expected to be sized to
  // the number of pages in the range specified. If it's not properly sized it
  // will be resized to the appropriate length for the caller.
  bool GetEntries(uint64_t address,
                  uint64_t length,
                  std::vector<PagemapEntry>* entries) const;

  // GetNumberOfPagesPresent is a helper which makes it easy to quickly
  // determine the number of pages in core for the region specified by |address|
  // and |length|. On success the function will return true and pages_present
  // will be set accordingly.
  bool GetNumberOfPagesPresent(uint64_t address,
                               uint64_t length,
                               uint64_t* pages_present) const;

  // IsFullyPresent is a small helper around GetNumberOfPagesPresent which
  // returns true if every page in the range is presnt.
  bool IsFullyPresent(uint64_t address, uint64_t length) const;

 private:
  friend class PagemapTest;

  base::ScopedFD fd_;
};

}  // namespace memory
}  // namespace ash

#endif  // CHROMEOS_ASH_COMPONENTS_MEMORY_PAGEMAP_H_