Android dumpsys介绍
一、需求[*]相识dumpsys原理，助于我们进一步相识Android体系的计划
[*]帮助我们分析标题，定位体系状态
[*]计划新功能的需要
二、环境
[*]版本：Android 12
[*]平台：SL8541E SPRD
三、相关概念
3.1 dumpsys
dumpsys 是一种在 Android 设备上运行的工具，可提供有关体系服务的信息。可以使用 Android 调试桥 (adb) 从命令行调用 dumpsys，获取在连接的设备上运行的所有体系服务的诊断输出。
3.2 Binder
Binder是Android提供的一套历程间相互通信框架。用来实现多历程间发送消息，同步和共享内存。
https://i-blog.csdnimg.cn/blog_migrate/294085f6f1542fa8652780b2274c17f6.png
3.3 管道
管道是一种IPC通信方式，分为有名管道和无名管道，无论是有名管道还是无名管道其原理都是在内核开发一块缓存空间，这段缓存空间的操纵是通过文件读写方式进行的。
有名管道与无名管道：
有名管道： 有名管道的通信可以通过管道名进行通信，历程间不需要有关系。
无名管道： 无名管道就是匿名管道，匿名管道通信的历程必须是父子历程。
管道为分半双工和全双工：
半双工： 半双工管道是单向通信，历程1只能向管道写数据，历程2只能从管道读取数据。只有一个代表读大概写的FD（文件描述符）。
全双工： 全双工管道是双向通信，有两个文件描述符，代表读和写。
https://i-blog.csdnimg.cn/blog_migrate/15230c5ea7d9143743132579adb35c63.png
四、dumpsys指令的使用
4.1 dumpsys使用
如下为实行"adb shell dumpsys"指令，控制台打印的内容，其使用如下：
dumpsys实行
4.2 dumpsys指令语法
（1）使用 dumpsys 的一般语法如下：
adb shell dumpsys [-t timeout] [--help | -l | --skip services | service | -c | -h]
（2）如需获取所连接设备的所有体系服务的诊断输出，请运行 adb shell dumpsys。不过，如许输出的信息比您通常想要的信息多得多。若要使输出更加可控，您可以通过在命令中添加相应服务来指定要检查的服务。例如，下面的命令会提供输入组件（如触摸屏或内置键盘）的体系数据：
adb shell dumpsys input
（3）如需检察可与 dumpsys 共同使用的体系服务的完备列表，请使用以下命令：
adb shell dumpsys -l
（4）命令行选项如下：
选项说明-t timeout指定超时期限（秒）。如果未指定，默认值为 10 秒。–help输出 dumpsys 工具的帮助文本。-l输出可与 dumpsys 共同使用的体系服务的完备列表。–skip services指定您不渴望包含在输出中的 services。service 指定您渴望输出的 service。某些服务可能允许您通报可选 arguments。如需相识这些可选参数，请将 -h 选项与服务一起通报：
adb shell dumpsys procstats -h-c指定某些服务时，附加此选项能以盘算机可读的格式输出数据。-h对于某些服务，附加此选项可检察该服务的帮助文本和其他选项。 五、详细计划
5.1 dumpsys流程图
https://i-blog.csdnimg.cn/blog_migrate/dae19dac239c89902528f65d1ac5dcc3.jpeg
5.2 dumpsys检察电池信息
5.2.1 dumpsys battery指令
https://i-blog.csdnimg.cn/blog_migrate/ea2ec242f3c25fa6c1d73c73f5b32021.png
5.2.2 service->dump打印函数
@frameworks\base\services\core\java\com\android\server\BatteryService.java
private final class BinderService extends Binder {
@Override protected void dump(FileDescriptor fd, PrintWriter pw, String[] args) {
if (!DumpUtils.checkDumpPermission(mContext, TAG, pw)) return;
if (args.length > 0 && "--proto".equals(args)) {
dumpProto(fd);
} else {
dumpInternal(fd, pw, args);
}
}
...
}
private void dumpInternal(FileDescriptor fd, PrintWriter pw, String[] args) {
synchronized (mLock) {
if (args == null || args.length == 0 || "-a".equals(args)) {
pw.println("Current Battery Service state:");
if (mUpdatesStopped) {
pw.println("(UPDATES STOPPED -- use 'reset' to restart)");
}
pw.println("AC powered: " + mHealthInfo.chargerAcOnline);
pw.println("USB powered: " + mHealthInfo.chargerUsbOnline);
pw.println("Wireless powered: " + mHealthInfo.chargerWirelessOnline);
pw.println("Max charging current: " + mHealthInfo.maxChargingCurrent);
pw.println("Max charging voltage: " + mHealthInfo.maxChargingVoltage);
pw.println("Charge counter: " + mHealthInfo.batteryChargeCounter);
pw.println("status: " + mHealthInfo.batteryStatus);
pw.println("health: " + mHealthInfo.batteryHealth);
pw.println("present: " + mHealthInfo.batteryPresent);
pw.println("level: " + mHealthInfo.batteryLevel);
pw.println("scale: " + BATTERY_SCALE);
pw.println("voltage: " + mHealthInfo.batteryVoltage);
pw.println("temperature: " + mHealthInfo.batteryTemperature);
pw.println("technology: " + mHealthInfo.batteryTechnology);
} else {
Shell shell = new Shell();
shell.exec(mBinderService, null, fd, null, args, null, new ResultReceiver(null));
}
}
}
5.3 dumpsys源码分析
5.3.1 dumpsys服务编译
dumpsys是个二进制可实行步伐，其通过bp进行编译，并最终打包到system分区（system/bin/dumpsys）。
@frameworks\native\cmds\dumpsys\android.bp
cc_binary {
name: "dumpsys",
defaults: ["dumpsys_defaults"],
srcs: [
"main.cpp",
],
}
5.3.2 dumpsys入口函数
我们通过实行adb指令 “adb shell dumpsys”，可以启动dumpsys服务，其对应的入口函数如下：
@frameworks\native\cmds\dumpsys\main.cpp
int main(int argc, char* const argv[]) {
signal(SIGPIPE, SIG_IGN);
sp<IServiceManager> sm = defaultServiceManager();//获取SM对象
fflush(stdout);
if (sm == nullptr) {
ALOGE("Unable to get default service manager!");
std::cerr << "dumpsys: Unable to get default service manager!" << std::endl;
return 20;
}
Dumpsys dumpsys(sm.get());
return dumpsys.main(argc, argv);//进入dumpsys服务
}
这边比较关键的点是获取ServiceManager对象。
大家通过打印可以发现，dumpsys指令打印的数据是java历程的dump函数，而dumpsys也是独立的一个历程，那么dumpsys历程又是怎么和多个java历程通信的呢？没错，就是通过ServiceManager对象。
那么，ServiceManager对象是什么呢？ServiceManager是Binder IPC通信的管家，自己也是一个Binder服务，他相称于 “DNS服务器”，内部存储了serviceName与其Binder Service的对应关系，管理Java层和native层的service，支持addService()、getService()、checkService、listServices()等功能。（Binder机制此处就不展开细说）
5.3.3 dumpsys服务打印
5.3.3.1 dumpsys解析参数
当我们使用dumpsys指令，打印的数据太过冗长，一般会共同相关参数进行使用，例如：“dumpsys -l”、“dumpsys -t 100 battery”、“dumpsys --help”，第一步我们会先解析目标参数。
@frameworks\native\cmds\dumpsys\dumpsys.cpp
int Dumpsys::main(int argc, char* const argv[]) {
...
while (1) {
...
c = getopt_long(argc, argv, "+t:T:l", longOptions, &optionIndex);//获取指令参数
...
switch (c) {
case 0://长参数
if (!strcmp(longOptions.name, "skip")) {//跳过某些服务打印
skipServices = true;
} else if (!strcmp(longOptions.name, "proto")) {
asProto = true;
} else if (!strcmp(longOptions.name, "help")) {//指令帮助
usage();
return 0;
} else if (!strcmp(longOptions.name, "priority")) {
...
} else if (!strcmp(longOptions.name, "pid")) {//只显示服务的pid
type = Type::PID;
} else if (!strcmp(longOptions.name, "thread")) {//仅显示进程使用情况
type = Type::THREAD;
}
break;
case 't'://超时时间设置，默认10秒
...
break;
case 'T'://超时时间设置，默认10秒
...
break;
case 'l'://显示支持的服务列表
showListOnly = true;
break;
default://其他参数
fprintf(stderr, "\n");
usage();
return -1;
}
}
...
}
5.3.3.2 skippedServices列表构造
dumpsys内部构造了skippedServices集合，用于记录需要忽略的服务。
@frameworks\native\cmds\dumpsys\dumpsys.cpp
int Dumpsys::main(int argc, char* const argv[]) {
...
for (int i = optind; i < argc; i++) {
if (skipServices) {
skippedServices.add(String16(argv));//配置待忽略的服务
} else {
...
}
...
}
5.3.3.3 获取支持服务列表
dumpsys通过ServiceManager获取支持的服务集合，并排序。
@frameworks\native\cmds\dumpsys\dumpsys.cpp
int Dumpsys::main(int argc, char* const argv[]) {
...
if (services.empty() || showListOnly) {
services = listServices(priorityFlags, asProto);
setServiceArgs(args, asProto, priorityFlags);
}
...
}
Vector<String16> Dumpsys::listServices(int priorityFilterFlags, bool filterByProto) const {
Vector<String16> services = sm_->listServices(priorityFilterFlags);//通过sm获取服务集合
services.sort(sort_func);//集合排序
...
return services;
}
5.3.3.4 打印支持服务列表
在获取了服务集合后，会先检查服务是否存在，接着打印服务的名称，且如果当前指令设置了"-l"参数，仅打印服务集合，即流程结束。
@frameworks\native\cmds\dumpsys\dumpsys.cpp
int Dumpsys::main(int argc, char* const argv[]) {
...
const size_t N = services.size();//获取支持的服务个数
if (N > 1 || showListOnly) {
// first print a list of the current services
std::cout << "Currently running services:" << std::endl;
for (size_t i=0; i<N; i++) {
sp<IBinder> service = sm_->checkService(services);//检查服务状态
if (service != nullptr) {
bool skipped = IsSkipped(skippedServices, services);
std::cout << "" << services << (skipped ? " (skipped)" : "") << std::endl;//打印服务名称
}
}
}
if (showListOnly) {//如果指令仅需要打印服务集合，则结束。
return 0;
}
...
}
5.3.3.5 打印目标服务
先遍历所有需要打印的服务，如果参数有指定服务名，即N为对应服务的数量，否则N为所有支持的服务数量。接着，开启线程，通过servicemanager调用远端的dump函数，利用管道和poll机制监听远端数据。末了如果超时大概dump结束，则关闭线程，开释相关资源。
@frameworks\native\cmds\dumpsys\dumpsys.cpp
int Dumpsys::main(int argc, char* const argv[]) {
...
for (size_t i = 0; i < N; i++) {
const String16& serviceName = services;
if (IsSkipped(skippedServices, serviceName)) continue;//跳过部分服务
if (startDumpThread(type, serviceName, args) == OK) {//step 1.创建dump打印的线程
...
std::chrono::duration<double> elapsedDuration;
size_t bytesWritten = 0;
status_t status =
writeDump(STDOUT_FILENO, serviceName, std::chrono::milliseconds(timeoutArgMs),
asProto, elapsedDuration, bytesWritten);//step 2.dump执行打印操作
if (status == TIMED_OUT) {//打印超时
std::cout << std::endl
<< "*** SERVICE '" << serviceName << "' DUMP TIMEOUT (" << timeoutArgMs
<< "ms) EXPIRED ***" << std::endl
<< std::endl;
}
...
bool dumpComplete = (status == OK);
stopDumpThread(dumpComplete);//step 3.结束dump打印线程
}
}
...
}
step 1. 创建dumpsys打印线程
创建了一条管道，接着开启了一个线程，通过ServiceManager对象读取目标服务的dump函数，即dump打印数据。
@frameworks\native\cmds\dumpsys\dumpsys.cpp
status_t Dumpsys::startDumpThread(Type type, const String16& serviceName,
const Vector<String16>& args) {
sp<IBinder> service = sm_->checkService(serviceName);//通过SM获取service对象
int sfd;
if (pipe(sfd) != 0) {//创建管道，用于读取service端数据
...
}
...
redirectFd_ = unique_fd(sfd);
unique_fd remote_end(sfd);
sfd = sfd = -1;
// dump blocks until completion, so spawn a thread..
activeThread_ = std::thread([=, remote_end{std::move(remote_end)}]() mutable {//创建线程
status_t err = 0;
switch (type) {
case Type::DUMP:
err = service->dump(remote_end.get(), args);//调用dump函数
break;
...
}
...
});
return OK;
}
step 2. dumpsys打印到终端
通过poll机制用来监听管道的数据，并将读取到的dump数据，打印至控制台。同时，通过盘算剩余的时间，来判断当前是否读取超时。
@frameworks\native\cmds\dumpsys\dumpsys.cpp
status_t Dumpsys::writeDump(int fd, const String16& serviceName, std::chrono::milliseconds timeout,
bool asProto, std::chrono::duration<double>& elapsedDuration,
size_t& bytesWritten) const {
...
int serviceDumpFd = redirectFd_.get();
struct pollfd pfd = {.fd = serviceDumpFd, .events = POLLIN};
while (true) {
...
int rc = TEMP_FAILURE_RETRY(poll(&pfd, 1, time_left_ms()));//poll机制检测管道数据
if (rc < 0) {
...
} else if (rc == 0 || time_left_ms() == 0) {
status = TIMED_OUT;//计算剩余时间，来决定是否超时
break;
}
char buf;
rc = TEMP_FAILURE_RETRY(read(redirectFd_.get(), buf, sizeof(buf)));//读取远端的数据
...
if (!WriteFully(fd, buf, rc)) {//打印至控制台
...
break;
}
totalBytes += rc;
}
...
return status;
}
step 3. 关闭dumpsys打印线程
将dumpsys打印的线程detach掉，相关的fd句柄reset掉，开释资源。
六、dumpsys的应用
如后续有什么应用dumpsys，大概有助于日常开发调试的场景，再增补，未完待续。
6.1 dumpsys常用指令
服务名类名指令功能activityActivityManagerService获取某个应用的Activity信息：
adb shell dumpsys activity a packagename
获取某个应用的Service信息：
adb shell dumpsys activity s packagename
获取某个应用的Broadcast信息：
adb shell dumpsys activity b packagename
获取某个应用的Provider信息：
adb shell dumpsys activity prov packagename
获取某个应用的历程状态：
adb shell dumpsys activity p packagename
获取当前界面的Activity信息：
adb shell dumpsys activity top | grep ACTIVITYAMS相关信息packagePackageManagerServiceadb shell dumpsys packagePMS相关信息windowWindowManagerServiceadb shell dumpsys windowWMS相关信息inputInputManagerServiceadb shell dumpsys input
IMS相关信息powerPowerManagerServiceadb shell dumpsys powerPMS相关信息batterystatsBatterystatsServiceadb shell dumpsys batterystats电池统计信息batteryBatteryServiceadb shell dumpsys battery电池信息alarmAlarmManagerServiceadb shell dumpsys alarm闹钟信息dropboxDropboxManagerServiceadb shell dumpsys dropbox调试相关procstatsProcessStatsServiceadb shell dumpsys procstats历程统计cpuinfoCpuBinderadb shell dumpsys cpuinfoCPUmeminfoMemBinderadb shell dumpsys meminfo内存gfxinfoGraphicsBinderadb shell dumpsys gfxinfo图像dbinfoDbBinderadb shell dumpsys dbinfo数据库 七、参考资料
dumpsys指令介绍：
https://developer.android.google.cn/studio/command-line/dumpsys?hl=zh-cn
管道：
https://www.cnblogs.com/naray/p/15365954.html
Binder：
https://blog.csdn.net/shenxiaolinil/article/details/128972302
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]