/* * idevicediagnostics.c * Retrieves diagnostics information from device * * Copyright (c) 2012 Martin Szulecki All Rights Reserved. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #ifdef HAVE_CONFIG_H #include #endif #define TOOL_NAME "idevicediagnostics" #include #include #include #include #include #include #ifndef WIN32 #include #endif #include #include #include enum cmd_mode { CMD_NONE = 0, CMD_SLEEP, CMD_RESTART, CMD_SHUTDOWN, CMD_DIAGNOSTICS, CMD_MOBILEGESTALT, CMD_IOREGISTRY, CMD_IOREGISTRY_ENTRY }; static void print_xml(plist_t node) { char *xml = NULL; uint32_t len = 0; plist_to_xml(node, &xml, &len); if (xml) { puts(xml); } } static void print_usage(int argc, char **argv, int is_error) { char *name = strrchr(argv[0], '/'); fprintf(is_error ? stderr : stdout, "Usage: %s [OPTIONS] COMMAND\n", (name ? name + 1: argv[0])); fprintf(is_error ? stderr : stdout, "\n" "Use diagnostics interface of a device running iOS 4 or later.\n" "\n" "Where COMMAND is one of:\n" " diagnostics [TYPE] print diagnostics information from device by TYPE (All, WiFi, GasGauge, NAND)\n" " mobilegestalt KEY [...] print mobilegestalt keys passed as arguments separated by a space.\n" " ioreg [PLANE] print IORegistry of device, optionally by PLANE (IODeviceTree, IOPower, IOService) (iOS 5+ only)\n" " ioregentry [KEY] print IORegistry entry of device (AppleARMPMUCharger, ASPStorage, ...) (iOS 5+ only)\n" " shutdown shutdown device\n" " restart restart device\n" " sleep put device into sleep mode (disconnects from host)\n" "\n" "The following OPTIONS are accepted:\n" " -u, --udid UDID target specific device by UDID\n" " -n, --network connect to network device\n" " -d, --debug enable communication debugging\n" " -h, --help prints usage information\n" " -v, --version prints version information\n" "\n" "Homepage: <" PACKAGE_URL ">\n" "Bug Reports: <" PACKAGE_BUGREPORT ">\n" ); } int main(int argc, char **argv) { idevice_t device = NULL; lockdownd_client_t lockdown_client = NULL; diagnostics_relay_client_t diagnostics_client = NULL; lockdownd_error_t ret = LOCKDOWN_E_UNKNOWN_ERROR; lockdownd_service_descriptor_t service = NULL; int result = EXIT_FAILURE; const char *udid = NULL; int use_network = 0; int cmd = CMD_NONE; char* cmd_arg = NULL; plist_t node = NULL; plist_t keys = NULL; int c = 0; const struct option longopts[] = { { "debug", no_argument, NULL, 'd' }, { "help", no_argument, NULL, 'h' }, { "udid", required_argument, NULL, 'u' }, { "network", no_argument, NULL, 'n' }, { "version", no_argument, NULL, 'v' }, { NULL, 0, NULL, 0} }; #ifndef WIN32 signal(SIGPIPE, SIG_IGN); #endif /* parse cmdline args */ while ((c = getopt_long(argc, argv, "dhu:nv", longopts, NULL)) != -1) { switch (c) { case 'd': idevice_set_debug_level(1); break; case 'u': if (!*optarg) { fprintf(stderr, "ERROR: UDID argument must not be empty!\n"); print_usage(argc, argv, 1); return 2; } udid = optarg; break; case 'n': use_network = 1; break; case 'h': print_usage(argc, argv, 0); return 0; case 'v': printf("%s %s\n", TOOL_NAME, PACKAGE_VERSION); return 0; default: print_usage(argc, argv, 1); return 2; } } argc -= optind; argv += optind; if (!argv[0]) { fprintf(stderr, "ERROR: No command specified\n"); print_usage(argc+optind, argv-optind, 1); return 2; } if (!strcmp(argv[0], "sleep")) { cmd = CMD_SLEEP; } else if (!strcmp(argv[0], "restart")) { cmd = CMD_RESTART; } else if (!strcmp(argv[0], "shutdown")) { cmd = CMD_SHUTDOWN; } else if (!strcmp(argv[0], "diagnostics")) { cmd = CMD_DIAGNOSTICS; /* read type */ if (!argv[1] || ((strcmp(argv[1], "All") != 0) && (strcmp(argv[1], "WiFi") != 0) && (strcmp(argv[1], "GasGauge") != 0) && (strcmp(argv[1], "NAND") != 0) && (strcmp(argv[1], "HDMI") != 0))) { if (argv[1] == NULL) { cmd_arg = strdup("All"); } else { fprintf(stderr, "ERROR: Unknown TYPE %s\n", argv[1]); print_usage(argc+optind, argv-optind, 1); goto cleanup; } } cmd_arg = strdup(argv[1]); } else if (!strcmp(argv[0], "mobilegestalt")) { cmd = CMD_MOBILEGESTALT; /* read keys */ if (!argv[1] || !*argv[1]) { fprintf(stderr, "ERROR: Please supply the key to query.\n"); print_usage(argc, argv, 1); goto cleanup; } int i = 1; keys = plist_new_array(); while (argv[i] && *argv[i]) { plist_array_append_item(keys, plist_new_string(argv[i])); i++; } } else if (!strcmp(argv[0], "ioreg")) { cmd = CMD_IOREGISTRY; /* read plane */ if (argv[1]) { cmd_arg = strdup(argv[1]); } } else if (!strcmp(argv[0], "ioregentry")) { cmd = CMD_IOREGISTRY_ENTRY; /* read key */ if (argv[1]) { cmd_arg = strdup(argv[1]); } } /* verify options */ if (cmd == CMD_NONE) { fprintf(stderr, "ERROR: Unsupported command '%s'\n", argv[0]); print_usage(argc+optind, argv-optind, 1); goto cleanup; } if (IDEVICE_E_SUCCESS != idevice_new_with_options(&device, udid, (use_network) ? IDEVICE_LOOKUP_NETWORK : IDEVICE_LOOKUP_USBMUX)) { if (udid) { printf("No device found with udid %s.\n", udid); } else { printf("No device found.\n"); } goto cleanup; } if (LOCKDOWN_E_SUCCESS != (ret = lockdownd_client_new_with_handshake(device, &lockdown_client, TOOL_NAME))) { idevice_free(device); printf("ERROR: Could not connect to lockdownd, error code %d\n", ret); goto cleanup; } /* attempt to use newer diagnostics service available on iOS 5 and later */ ret = lockdownd_start_service(lockdown_client, "com.apple.mobile.diagnostics_relay", &service); if (ret == LOCKDOWN_E_INVALID_SERVICE) { /* attempt to use older diagnostics service */ ret = lockdownd_start_service(lockdown_client, "com.apple.iosdiagnostics.relay", &service); } lockdownd_client_free(lockdown_client); if (ret != LOCKDOWN_E_SUCCESS) { idevice_free(device); printf("ERROR: Could not start diagnostics relay service: %s\n", lockdownd_strerror(ret)); goto cleanup; } result = EXIT_FAILURE; if ((ret == LOCKDOWN_E_SUCCESS) && service && (service->port > 0)) { if (diagnostics_relay_client_new(device, service, &diagnostics_client) != DIAGNOSTICS_RELAY_E_SUCCESS) { printf("ERROR: Could not connect to diagnostics_relay!\n"); } else { switch (cmd) { case CMD_SLEEP: if (diagnostics_relay_sleep(diagnostics_client) == DIAGNOSTICS_RELAY_E_SUCCESS) { printf("Putting device into deep sleep mode.\n"); result = EXIT_SUCCESS; } else { printf("ERROR: Failed to put device into deep sleep mode.\n"); } break; case CMD_RESTART: if (diagnostics_relay_restart(diagnostics_client, DIAGNOSTICS_RELAY_ACTION_FLAG_WAIT_FOR_DISCONNECT) == DIAGNOSTICS_RELAY_E_SUCCESS) { printf("Restarting device.\n"); result = EXIT_SUCCESS; } else { printf("ERROR: Failed to restart device.\n"); } break; case CMD_SHUTDOWN: if (diagnostics_relay_shutdown(diagnostics_client, DIAGNOSTICS_RELAY_ACTION_FLAG_WAIT_FOR_DISCONNECT) == DIAGNOSTICS_RELAY_E_SUCCESS) { printf("Shutting down device.\n"); result = EXIT_SUCCESS; } else { printf("ERROR: Failed to shutdown device.\n"); } break; case CMD_MOBILEGESTALT: if (diagnostics_relay_query_mobilegestalt(diagnostics_client, keys, &node) == DIAGNOSTICS_RELAY_E_SUCCESS) { if (node) { print_xml(node); result = EXIT_SUCCESS; } } else { printf("ERROR: Unable to query mobilegestalt keys.\n"); } break; case CMD_IOREGISTRY_ENTRY: if (diagnostics_relay_query_ioregistry_entry(diagnostics_client, cmd_arg == NULL ? "": cmd_arg, "", &node) == DIAGNOSTICS_RELAY_E_SUCCESS) { if (node) { print_xml(node); result = EXIT_SUCCESS; } } else { printf("ERROR: Unable to retrieve IORegistry from device.\n"); } break; case CMD_IOREGISTRY: if (diagnostics_relay_query_ioregistry_plane(diagnostics_client, cmd_arg == NULL ? "": cmd_arg, &node) == DIAGNOSTICS_RELAY_E_SUCCESS) { if (node) { print_xml(node); result = EXIT_SUCCESS; } } else { printf("ERROR: Unable to retrieve IORegistry from device.\n"); } break; case CMD_DIAGNOSTICS: default: if (diagnostics_relay_request_diagnostics(diagnostics_client, cmd_arg, &node) == DIAGNOSTICS_RELAY_E_SUCCESS) { if (node) { print_xml(node); result = EXIT_SUCCESS; } } else { printf("ERROR: Unable to retrieve diagnostics from device.\n"); } break; } diagnostics_relay_goodbye(diagnostics_client); diagnostics_relay_client_free(diagnostics_client); } } else { printf("ERROR: Could not start diagnostics service!\n"); } if (service) { lockdownd_service_descriptor_free(service); service = NULL; } idevice_free(device); cleanup: if (node) { plist_free(node); } if (keys) { plist_free(keys); } if (cmd_arg) { free(cmd_arg); } return result; }