blob: 389444e9cd3a720713994186b5d1b06f50f24057 [file] [log] [blame]
Colin Crossf45fa6b2012-03-26 12:38:26 -07001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
Felipe Leme8268ed22016-08-02 18:18:25 -070017#ifndef FRAMEWORK_NATIVE_CMD_DUMPSTATE_H_
18#define FRAMEWORK_NATIVE_CMD_DUMPSTATE_H_
Colin Crossf45fa6b2012-03-26 12:38:26 -070019
Felipe Leme8268ed22016-08-02 18:18:25 -070020#ifndef ON_DRY_RUN_RETURN
21#define ON_DRY_RUN_RETURN(X) if (is_dry_run()) return X
22#endif
Felipe Leme93d705b2015-11-10 20:10:25 -080023
Felipe Leme8268ed22016-08-02 18:18:25 -070024#ifndef ON_DRY_RUN
25#define ON_DRY_RUN(code) if (is_dry_run()) code
Felipe Leme93d705b2015-11-10 20:10:25 -080026#endif
27
Felipe Lemecbce55d2016-02-08 09:53:18 -080028#ifndef MYLOGD
Felipe Leme60869c92016-02-09 16:07:20 -080029#define MYLOGD(...) fprintf(stderr, __VA_ARGS__); ALOGD(__VA_ARGS__);
Felipe Lemecbce55d2016-02-08 09:53:18 -080030#endif
31
32#ifndef MYLOGI
Felipe Leme60869c92016-02-09 16:07:20 -080033#define MYLOGI(...) fprintf(stderr, __VA_ARGS__); ALOGI(__VA_ARGS__);
Felipe Lemecbce55d2016-02-08 09:53:18 -080034#endif
35
36#ifndef MYLOGE
Felipe Leme60869c92016-02-09 16:07:20 -080037#define MYLOGE(...) fprintf(stderr, __VA_ARGS__); ALOGE(__VA_ARGS__);
Felipe Lemecbce55d2016-02-08 09:53:18 -080038#endif
Felipe Leme93d705b2015-11-10 20:10:25 -080039
Colin Crossf45fa6b2012-03-26 12:38:26 -070040#include <time.h>
41#include <unistd.h>
Colin Cross0c22e8b2012-11-02 15:46:56 -070042#include <stdbool.h>
Colin Crossf45fa6b2012-03-26 12:38:26 -070043#include <stdio.h>
Felipe Leme36b3f6f2015-11-19 15:41:04 -080044#include <vector>
Colin Crossf45fa6b2012-03-26 12:38:26 -070045
46#define SU_PATH "/system/xbin/su"
47
Felipe Leme8620bb42015-11-10 11:04:45 -080048#ifdef __cplusplus
49extern "C" {
50#endif
51
Colin Cross0c22e8b2012-11-02 15:46:56 -070052typedef void (for_each_pid_func)(int, const char *);
53typedef void (for_each_tid_func)(int, int, const char *);
54
Felipe Leme71bbfc52015-11-23 14:14:51 -080055/* Estimated total weight of bugreport generation.
56 *
57 * Each section contributes to the total weight by an individual weight, so the overall progress
58 * can be calculated by dividing the all completed weight by the total weight.
59 *
60 * This value is defined empirically and it need to be adjusted as more sections are added.
Felipe Lemead5f6c42015-11-30 14:26:46 -080061 *
62 * It does not need to match the exact sum of all sections, but ideally it should to be slight more
63 * than such sum: a value too high will cause the bugreport to finish before the user expected (for
Felipe Lemefaf67e32016-03-28 11:15:22 -070064 * example, jumping from 70% to 100%), while a value too low will cause the progress to get stuck
65 * at an almost-finished value (like 99%) for a while.
Felipe Leme71bbfc52015-11-23 14:14:51 -080066 */
Felipe Lemefaf67e32016-03-28 11:15:22 -070067static const int WEIGHT_TOTAL = 6500;
Felipe Leme71bbfc52015-11-23 14:14:51 -080068
69/* Most simple commands have 10 as timeout, so 5 is a good estimate */
70static const int WEIGHT_FILE = 5;
71
72/*
Felipe Leme0c80cf02016-01-05 13:25:34 -080073 * TODO: the dumpstate internal state is getting fragile; for example, this variable is defined
Felipe Leme71bbfc52015-11-23 14:14:51 -080074 * here, declared at utils.cpp, and used on utils.cpp and dumpstate.cpp.
75 * It would be better to take advantage of the C++ migration and encapsulate the state in an object,
76 * but that will be better handled in a major C++ refactoring, which would also get rid of other C
77 * idioms (like using std::string instead of char*, removing varargs, etc...) */
Felipe Leme02b7e002016-07-22 12:03:20 -070078extern int do_update_progress, progress, weight_total, control_socket_fd;
Felipe Leme71bbfc52015-11-23 14:14:51 -080079
Felipe Leme71ca15e2016-05-19 16:18:17 -070080/* full path of the directory where the bugreport files will be written */
81extern std::string bugreport_dir;
82
83/* root dir for all files copied as-is into the bugreport. */
84extern const std::string ZIP_ROOT_DIR;
85
86/* adds a new entry to the existing zip file. */
87bool add_zip_entry(const std::string& entry_name, const std::string& entry_path);
88
89/* adds a new entry to the existing zip file. */
90bool add_zip_entry_from_fd(const std::string& entry_name, int fd);
91
Calvin On249beee2016-06-03 15:17:07 -070092/* adds all files from a directory to the zipped bugreport file */
93void add_dir(const char *dir, bool recursive);
94
Colin Crossf45fa6b2012-03-26 12:38:26 -070095/* prints the contents of a file */
Christopher Ferris1fe61072014-07-22 16:08:19 -070096int dump_file(const char *title, const char *path);
97
Felipe Leme71a74ac2016-03-17 15:43:25 -070098/* saves the the contents of a file as a long */
99int read_file_as_long(const char *path, long int *output);
100
Christopher Ferris54bcc5f2015-02-10 12:15:01 -0800101/* prints the contents of the fd
102 * fd must have been opened with the flag O_NONBLOCK.
103 */
Christopher Ferris1fe61072014-07-22 16:08:19 -0700104int dump_file_from_fd(const char *title, const char *path, int fd);
Colin Crossf45fa6b2012-03-26 12:38:26 -0700105
Mark Salyzyn326842f2015-04-30 09:49:41 -0700106/* calls skip to gate calling dump_from_fd recursively
107 * in the specified directory. dump_from_fd defaults to
108 * dump_file_from_fd above when set to NULL. skip defaults
109 * to false when set to NULL. dump_from_fd will always be
110 * called with title NULL.
111 */
112int dump_files(const char *title, const char *dir,
113 bool (*skip)(const char *path),
114 int (*dump_from_fd)(const char *title, const char *path, int fd));
115
Felipe Lemecf6a8b42016-03-11 10:38:19 -0800116// TODO: need to refactor all those run_command variations; there shold be just one, receiving an
117// optional CommandOptions objects with values such as run_always, drop_root, etc...
118
Colin Crossf45fa6b2012-03-26 12:38:26 -0700119/* forks a command and waits for it to finish -- terminate args with NULL */
Felipe Lemecf6a8b42016-03-11 10:38:19 -0800120int run_command_as_shell(const char *title, int timeout_seconds, const char *command, ...);
Colin Crossf45fa6b2012-03-26 12:38:26 -0700121int run_command(const char *title, int timeout_seconds, const char *command, ...);
122
Felipe Leme29c39712016-04-01 10:02:00 -0700123enum RootMode { DROP_ROOT, DONT_DROP_ROOT };
124enum StdoutMode { NORMAL_STDOUT, REDIRECT_TO_STDERR };
125
Felipe Leme93d705b2015-11-10 20:10:25 -0800126/* forks a command and waits for it to finish
127 first element of args is the command, and last must be NULL.
128 command is always ran, even when _DUMPSTATE_DRY_RUN_ is defined. */
Felipe Leme29c39712016-04-01 10:02:00 -0700129int run_command_always(const char *title, RootMode root_mode, StdoutMode stdout_mode,
130 int timeout_seconds, const char *args[]);
Felipe Lemecf6a8b42016-03-11 10:38:19 -0800131
132/* switch to non-root user and group */
133bool drop_root_user();
Felipe Leme93d705b2015-11-10 20:10:25 -0800134
Felipe Leme36b3f6f2015-11-19 15:41:04 -0800135/* sends a broadcast using Activity Manager */
136void send_broadcast(const std::string& action, const std::vector<std::string>& args);
137
Felipe Leme71bbfc52015-11-23 14:14:51 -0800138/* updates the overall progress of dumpstate by the given weight increment */
139void update_progress(int weight);
140
Colin Crossf45fa6b2012-03-26 12:38:26 -0700141/* prints all the system properties */
142void print_properties();
143
Felipe Leme2628e9e2016-04-12 16:36:51 -0700144/** opens a socket and returns its file descriptor */
145int open_socket(const char *service);
146
Colin Crossf45fa6b2012-03-26 12:38:26 -0700147/* redirect output to a service control socket */
148void redirect_to_socket(FILE *redirect, const char *service);
149
Felipe Leme0f3fb202016-06-10 17:10:53 -0700150/* redirect output to a new file */
Christopher Ferrisff4a4dc2015-02-09 16:24:47 -0800151void redirect_to_file(FILE *redirect, char *path);
Colin Crossf45fa6b2012-03-26 12:38:26 -0700152
Felipe Leme0f3fb202016-06-10 17:10:53 -0700153/* redirect output to an existing file */
154void redirect_to_existing_file(FILE *redirect, char *path);
155
Felipe Leme111b9d02016-02-03 09:28:24 -0800156/* create leading directories, if necessary */
157void create_parent_dirs(const char *path);
158
Jeff Brownbf7f4922012-06-07 16:40:01 -0700159/* dump Dalvik and native stack traces, return the trace file location (NULL if none) */
160const char *dump_traces();
Colin Crossf45fa6b2012-03-26 12:38:26 -0700161
162/* for each process in the system, run the specified function */
Colin Cross0c22e8b2012-11-02 15:46:56 -0700163void for_each_pid(for_each_pid_func func, const char *header);
164
165/* for each thread in the system, run the specified function */
166void for_each_tid(for_each_tid_func func, const char *header);
Colin Crossf45fa6b2012-03-26 12:38:26 -0700167
168/* Displays a blocked processes in-kernel wait channel */
Colin Cross0c22e8b2012-11-02 15:46:56 -0700169void show_wchan(int pid, int tid, const char *name);
Colin Crossf45fa6b2012-03-26 12:38:26 -0700170
Mark Salyzyna297c322016-02-05 15:33:17 -0800171/* Displays a processes times */
172void show_showtime(int pid, const char *name);
173
Colin Crossf45fa6b2012-03-26 12:38:26 -0700174/* Runs "showmap" for a process */
175void do_showmap(int pid, const char *name);
176
177/* Gets the dmesg output for the kernel */
178void do_dmesg();
179
Sreeram Ramachandran2b3bba32014-07-08 15:40:55 -0700180/* Prints the contents of all the routing tables, both IPv4 and IPv6. */
181void dump_route_tables();
182
Colin Crossf45fa6b2012-03-26 12:38:26 -0700183/* Play a sound via Stagefright */
Christopher Ferris1fe61072014-07-22 16:08:19 -0700184void play_sound(const char *path);
Colin Crossf45fa6b2012-03-26 12:38:26 -0700185
186/* Implemented by libdumpstate_board to dump board-specific info */
187void dumpstate_board();
188
Felipe Lemee338bf62015-12-07 14:03:50 -0800189/* Takes a screenshot and save it to the given file */
Felipe Leme3634a1e2015-12-09 10:11:47 -0800190void take_screenshot(const std::string& path);
Felipe Lemee338bf62015-12-07 14:03:50 -0800191
Felipe Leme0c80cf02016-01-05 13:25:34 -0800192/* Vibrates for a given durating (in milliseconds). */
193void vibrate(FILE* vibrator, int ms);
194
195/* Checks if a given path is a directory. */
196bool is_dir(const char* pathname);
197
198/** Gets the last modification time of a file, or default time if file is not found. */
199time_t get_mtime(int fd, time_t default_mtime);
200
Calvin On249beee2016-06-03 15:17:07 -0700201/* Dumps eMMC Extended CSD data. */
Felipe Leme78f2c862015-12-21 09:55:22 -0800202void dump_emmc_ecsd(const char *ext_csd_path);
203
Calvin On249beee2016-06-03 15:17:07 -0700204/** Gets command-line arguments. */
Felipe Lemea34efb72016-03-11 09:33:32 -0800205void format_args(int argc, const char *argv[], std::string *args);
Felipe Leme88c79332016-02-22 11:06:49 -0800206
Calvin On249beee2016-06-03 15:17:07 -0700207/** Tells if the device is running a user build. */
208bool is_user_build();
209
Felipe Leme78f2c862015-12-21 09:55:22 -0800210/*
Felipe Leme8268ed22016-08-02 18:18:25 -0700211 * When running in dry-run mode, skips the real dumps and just print the section headers.
212 *
213 * Useful when debugging dumpstate or other bugreport-related activities.
214 *
215 * Dry-run mode is enabled by setting the system property dumpstate.dry_run to true.
216 */
217bool is_dry_run();
218
219/*
Felipe Leme78f2c862015-12-21 09:55:22 -0800220 * Helper class used to report how long it takes for a section to finish.
221 *
222 * Typical usage:
223 *
224 * DurationReporter duration_reporter(title);
225 *
226 */
227class DurationReporter {
228public:
229 DurationReporter(const char *title);
Felipe Leme608385d2016-02-01 10:35:38 -0800230 DurationReporter(const char *title, FILE* out);
Felipe Leme78f2c862015-12-21 09:55:22 -0800231
232 ~DurationReporter();
233
234 static uint64_t nanotime();
235
236private:
237 const char* title_;
Felipe Leme608385d2016-02-01 10:35:38 -0800238 FILE* out_;
Felipe Leme78f2c862015-12-21 09:55:22 -0800239 uint64_t started_;
240};
241
Felipe Leme8620bb42015-11-10 11:04:45 -0800242#ifdef __cplusplus
243}
244#endif
245
Felipe Leme8268ed22016-08-02 18:18:25 -0700246#endif /* FRAMEWORK_NATIVE_CMD_DUMPSTATE_H_ */