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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
// Copyright (c) 2009 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_PROCESS_INFO_SNAPSHOT_H_
#define CHROME_BROWSER_PROCESS_INFO_SNAPSHOT_H_
#include <sys/types.h>
#include <map>
#include <string>
#include <vector>
#include "base/process_util.h"
// A class which captures process information at a given point in time when its
// |Sample()| method is called. This information can then be probed by PID.
// |Sample()| may take a while to complete, so if calling from the browser
// process, only do so from the file thread. The current implementation, only on
// Mac, pulls information from /bin/ps. /usr/bin/top provides much more
// information about memory, but it has changed greatly from Mac OS 10.5.x to
// 10.6.x, thereby raising future compatibility concerns. Moreover, the 10.6.x
// version is less capable in terms of configuring output and its output is
// harder to parse.
// TODO(viettrungluu): This is currently only implemented and used on Mac, so
// things are very Mac-specific. If this is ever implemented for other
// platforms, we should subclass and add opaqueness (probably |ProcInfoEntry|
// should be considered opaque).
class ProcessInfoSnapshot {
public:
ProcessInfoSnapshot();
~ProcessInfoSnapshot();
// Capture a snapshot of process memory information (by running ps) for the
// given list of PIDs. Call only from the file thread.
// |pid_list| - list of |ProcessId|s on which to capture information.
// returns - |true| if okay, |false| on error.
bool Sample(std::vector<base::ProcessId> pid_list);
// Reset all statistics (deallocating any memory allocated).
void Reset();
// Our basic structure for storing information about a process (the names are
// mostly self-explanatory). Note that |command| may not actually reflect the
// actual executable name; never trust it absolutely, and only take it
// half-seriously when it begins with '/'.
struct ProcInfoEntry {
base::ProcessId pid;
base::ProcessId ppid;
uid_t uid;
uid_t euid;
size_t rss;
size_t vsize;
std::string command;
};
// Get process information for a given PID.
// |pid| - self-explanatory.
// |proc_info| - place to put the process information.
// returns - |true| if okay, |false| on error (including PID not found).
bool GetProcInfo(int pid,
ProcInfoEntry* proc_info) const;
// Fills a |CommittedKBytes| with both resident and paged memory usage, as per
// its definition (or as close as we can manage). In the current (Mac)
// implementation, we map:
// vsize --> comm_priv,
// 0 --> comm_mapped,
// 0 --> comm_image;
// in about:memory: virtual:private = comm_priv,
// virtual:mapped = comm_mapped.
// TODO(viettrungluu): Doing such a mapping is kind of ugly.
// |pid| - self-explanatory.
// |usage| - pointer to |CommittedBytes| to fill; zero-ed on error.
// returns - |true| on success, |false| on error (including PID not found).
bool GetCommittedKBytesOfPID(int pid,
base::CommittedKBytes* usage) const;
// Fills a |WorkingSetKBytes| containing resident private and shared memory,
// as per its definition (or as close as we can manage). In the current (Mac)
// implementation, we map:
// 0 --> ws_priv,
// rss --> ws_shareable,
// 0 --> ws_shared;
// in about:memory: res:private = ws_priv + ws_shareable - ws_shared,
// res:shared = ws_shared / num_procs,
// res:total = res:private + res:shared.
// TODO(viettrungluu): Doing such a mapping is kind of ugly.
// |pid| - self-explanatory.
// |ws_usage| - pointer to |WorkingSetKBytes| to fill; zero-ed on error.
// returns - |true| on success, |false| on error (including PID not found).
bool GetWorkingSetKBytesOfPID(int pid,
base::WorkingSetKBytes* ws_usage) const;
// TODO(viettrungluu): Maybe we should also have the following (again, for
// "compatibility"):
// size_t GetWorkingSetSizeOfPID(int pid) const;
// size_t GetPeakWorkingSetSizeOfPID(int pid) const;
// size_t GetPrivateBytesOfPID(int pid) const;
private:
// map from |int| (PID) to |ProcInfoEntry|
std::map<int,ProcInfoEntry> proc_info_entries_;
};
#endif // CHROME_BROWSER_PROCESS_INFO_SNAPSHOT_H_
|
