summaryrefslogtreecommitdiffstats
path: root/common/debug.c
diff options
context:
space:
mode:
Diffstat (limited to 'common/debug.c')
-rw-r--r--common/debug.c169
1 files changed, 169 insertions, 0 deletions
diff --git a/common/debug.c b/common/debug.c
new file mode 100644
index 0000000..0bb87a2
--- /dev/null
+++ b/common/debug.c
@@ -0,0 +1,169 @@
+/*
+ * debug.c
+ * contains utilitary functions for debugging
+ *
+ * Copyright (c) 2008 Jonathan Beck All Rights Reserved.
+ * Copyright (c) 2010 Martin S. 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 <config.h>
+#endif
+#include <stdarg.h>
+#define _GNU_SOURCE 1
+#define __USE_GNU 1
+#include <stdio.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include <time.h>
+
+#include "debug.h"
+#include "libimobiledevice/libimobiledevice.h"
+
+#ifndef STRIP_DEBUG_CODE
+#include "asprintf.h"
+#endif
+
+int debug_level = 0;
+
+/**
+ * Sets the level of debugging. Currently the only acceptable values are 0 and
+ * 1.
+ *
+ * @param level Set to 0 for no debugging or 1 for debugging.
+ */
+void idevice_set_debug_level(int level)
+{
+ debug_level = level;
+}
+
+#ifndef STRIP_DEBUG_CODE
+static void debug_print_line(const char *func, const char *file, int line, const char *buffer)
+{
+ char *str_time = NULL;
+ char *header = NULL;
+ time_t the_time;
+
+ time(&the_time);
+ str_time = (char*)malloc(255);
+ strftime(str_time, 254, "%H:%M:%S", localtime (&the_time));
+
+ /* generate header text */
+ (void)asprintf(&header, "%s %s:%d %s()", str_time, file, line, func);
+ free (str_time);
+
+ /* trim ending newlines */
+
+ /* print header */
+ printf ("%s: ", header);
+
+ /* print actual debug content */
+ printf ("%s\n", buffer);
+
+ /* flush this output, as we need to debug */
+ fflush (stdout);
+
+ free (header);
+}
+#endif
+
+inline void debug_info_real(const char *func, const char *file, int line, const char *format, ...)
+{
+#ifndef STRIP_DEBUG_CODE
+ va_list args;
+ char *buffer = NULL;
+
+ if (!debug_level)
+ return;
+
+ /* run the real fprintf */
+ va_start(args, format);
+ (void)vasprintf(&buffer, format, args);
+ va_end(args);
+
+ debug_print_line(func, file, line, buffer);
+
+ free(buffer);
+#endif
+}
+
+inline void debug_buffer(const char *data, const int length)
+{
+#ifndef STRIP_DEBUG_CODE
+ int i;
+ int j;
+ unsigned char c;
+
+ if (debug_level) {
+ for (i = 0; i < length; i += 16) {
+ fprintf(stderr, "%04x: ", i);
+ for (j = 0; j < 16; j++) {
+ if (i + j >= length) {
+ fprintf(stderr, " ");
+ continue;
+ }
+ fprintf(stderr, "%02hhx ", *(data + i + j));
+ }
+ fprintf(stderr, " | ");
+ for (j = 0; j < 16; j++) {
+ if (i + j >= length)
+ break;
+ c = *(data + i + j);
+ if ((c < 32) || (c > 127)) {
+ fprintf(stderr, ".");
+ continue;
+ }
+ fprintf(stderr, "%c", c);
+ }
+ fprintf(stderr, "\n");
+ }
+ fprintf(stderr, "\n");
+ }
+#endif
+}
+
+inline void debug_buffer_to_file(const char *file, const char *data, const int length)
+{
+#ifndef STRIP_DEBUG_CODE
+ if (debug_level) {
+ FILE *f = fopen(file, "wb");
+ fwrite(data, 1, length, f);
+ fflush(f);
+ fclose(f);
+ }
+#endif
+}
+
+inline void debug_plist_real(const char *func, const char *file, int line, plist_t plist)
+{
+#ifndef STRIP_DEBUG_CODE
+ if (!plist)
+ return;
+
+ char *buffer = NULL;
+ uint32_t length = 0;
+ plist_to_xml(plist, &buffer, &length);
+
+ /* get rid of ending newline as one is already added in the debug line */
+ if (buffer[length-1] == '\n')
+ buffer[length-1] = '\0';
+
+ debug_info_real(func, file, line, "printing %i bytes plist:\n%s", length, buffer);
+ free(buffer);
+#endif
+}
+