uboot/lib/trace.c
<<
>>
Prefs
   1/*
   2 * Copyright (c) 2012 The Chromium OS Authors.
   3 *
   4 * SPDX-License-Identifier:     GPL-2.0+
   5 */
   6
   7#include <common.h>
   8#include <mapmem.h>
   9#include <trace.h>
  10#include <asm/io.h>
  11#include <asm/sections.h>
  12
  13DECLARE_GLOBAL_DATA_PTR;
  14
  15static char trace_enabled __attribute__((section(".data")));
  16static char trace_inited __attribute__((section(".data")));
  17
  18/* The header block at the start of the trace memory area */
  19struct trace_hdr {
  20        int func_count;         /* Total number of function call sites */
  21        u64 call_count;         /* Total number of tracked function calls */
  22        u64 untracked_count;    /* Total number of untracked function calls */
  23        int funcs_used;         /* Total number of functions used */
  24
  25        /*
  26         * Call count for each function. This is indexed by the word offset
  27         * of the function from gd->relocaddr
  28         */
  29        uintptr_t *call_accum;
  30
  31        /* Function trace list */
  32        struct trace_call *ftrace;      /* The function call records */
  33        ulong ftrace_size;      /* Num. of ftrace records we have space for */
  34        ulong ftrace_count;     /* Num. of ftrace records written */
  35        ulong ftrace_too_deep_count;    /* Functions that were too deep */
  36
  37        int depth;
  38        int depth_limit;
  39        int max_depth;
  40};
  41
  42static struct trace_hdr *hdr;   /* Pointer to start of trace buffer */
  43
  44static inline uintptr_t __attribute__((no_instrument_function))
  45                func_ptr_to_num(void *func_ptr)
  46{
  47        uintptr_t offset = (uintptr_t)func_ptr;
  48
  49#ifdef CONFIG_SANDBOX
  50        offset -= (uintptr_t)&_init;
  51#else
  52        if (gd->flags & GD_FLG_RELOC)
  53                offset -= gd->relocaddr;
  54        else
  55                offset -= CONFIG_SYS_TEXT_BASE;
  56#endif
  57        return offset / FUNC_SITE_SIZE;
  58}
  59
  60static void __attribute__((no_instrument_function)) add_ftrace(void *func_ptr,
  61                                void *caller, ulong flags)
  62{
  63        if (hdr->depth > hdr->depth_limit) {
  64                hdr->ftrace_too_deep_count++;
  65                return;
  66        }
  67        if (hdr->ftrace_count < hdr->ftrace_size) {
  68                struct trace_call *rec = &hdr->ftrace[hdr->ftrace_count];
  69
  70                rec->func = func_ptr_to_num(func_ptr);
  71                rec->caller = func_ptr_to_num(caller);
  72                rec->flags = flags | (timer_get_us() & FUNCF_TIMESTAMP_MASK);
  73        }
  74        hdr->ftrace_count++;
  75}
  76
  77static void __attribute__((no_instrument_function)) add_textbase(void)
  78{
  79        if (hdr->ftrace_count < hdr->ftrace_size) {
  80                struct trace_call *rec = &hdr->ftrace[hdr->ftrace_count];
  81
  82                rec->func = CONFIG_SYS_TEXT_BASE;
  83                rec->caller = 0;
  84                rec->flags = FUNCF_TEXTBASE;
  85        }
  86        hdr->ftrace_count++;
  87}
  88
  89/**
  90 * This is called on every function entry
  91 *
  92 * We add to our tally for this function and add to the list of called
  93 * functions.
  94 *
  95 * @param func_ptr      Pointer to function being entered
  96 * @param caller        Pointer to function which called this function
  97 */
  98void __attribute__((no_instrument_function)) __cyg_profile_func_enter(
  99                void *func_ptr, void *caller)
 100{
 101        if (trace_enabled) {
 102                int func;
 103
 104                add_ftrace(func_ptr, caller, FUNCF_ENTRY);
 105                func = func_ptr_to_num(func_ptr);
 106                if (func < hdr->func_count) {
 107                        hdr->call_accum[func]++;
 108                        hdr->call_count++;
 109                } else {
 110                        hdr->untracked_count++;
 111                }
 112                hdr->depth++;
 113                if (hdr->depth > hdr->depth_limit)
 114                        hdr->max_depth = hdr->depth;
 115        }
 116}
 117
 118/**
 119 * This is called on every function exit
 120 *
 121 * We do nothing here.
 122 *
 123 * @param func_ptr      Pointer to function being entered
 124 * @param caller        Pointer to function which called this function
 125 */
 126void __attribute__((no_instrument_function)) __cyg_profile_func_exit(
 127                void *func_ptr, void *caller)
 128{
 129        if (trace_enabled) {
 130                add_ftrace(func_ptr, caller, FUNCF_EXIT);
 131                hdr->depth--;
 132        }
 133}
 134
 135/**
 136 * Produce a list of called functions
 137 *
 138 * The information is written into the supplied buffer - a header followed
 139 * by a list of function records.
 140 *
 141 * @param buff          Buffer to place list into
 142 * @param buff_size     Size of buffer
 143 * @param needed        Returns size of buffer needed, which may be
 144 *                      greater than buff_size if we ran out of space.
 145 * @return 0 if ok, -1 if space was exhausted
 146 */
 147int trace_list_functions(void *buff, int buff_size, unsigned int *needed)
 148{
 149        struct trace_output_hdr *output_hdr = NULL;
 150        void *end, *ptr = buff;
 151        int func;
 152        int upto;
 153
 154        end = buff ? buff + buff_size : NULL;
 155
 156        /* Place some header information */
 157        if (ptr + sizeof(struct trace_output_hdr) < end)
 158                output_hdr = ptr;
 159        ptr += sizeof(struct trace_output_hdr);
 160
 161        /* Add information about each function */
 162        for (func = upto = 0; func < hdr->func_count; func++) {
 163                int calls = hdr->call_accum[func];
 164
 165                if (!calls)
 166                        continue;
 167
 168                if (ptr + sizeof(struct trace_output_func) < end) {
 169                        struct trace_output_func *stats = ptr;
 170
 171                        stats->offset = func * FUNC_SITE_SIZE;
 172                        stats->call_count = calls;
 173                        upto++;
 174                }
 175                ptr += sizeof(struct trace_output_func);
 176        }
 177
 178        /* Update the header */
 179        if (output_hdr) {
 180                output_hdr->rec_count = upto;
 181                output_hdr->type = TRACE_CHUNK_FUNCS;
 182        }
 183
 184        /* Work out how must of the buffer we used */
 185        *needed = ptr - buff;
 186        if (ptr > end)
 187                return -1;
 188        return 0;
 189}
 190
 191int trace_list_calls(void *buff, int buff_size, unsigned *needed)
 192{
 193        struct trace_output_hdr *output_hdr = NULL;
 194        void *end, *ptr = buff;
 195        int rec, upto;
 196        int count;
 197
 198        end = buff ? buff + buff_size : NULL;
 199
 200        /* Place some header information */
 201        if (ptr + sizeof(struct trace_output_hdr) < end)
 202                output_hdr = ptr;
 203        ptr += sizeof(struct trace_output_hdr);
 204
 205        /* Add information about each call */
 206        count = hdr->ftrace_count;
 207        if (count > hdr->ftrace_size)
 208                count = hdr->ftrace_size;
 209        for (rec = upto = 0; rec < count; rec++) {
 210                if (ptr + sizeof(struct trace_call) < end) {
 211                        struct trace_call *call = &hdr->ftrace[rec];
 212                        struct trace_call *out = ptr;
 213
 214                        out->func = call->func * FUNC_SITE_SIZE;
 215                        out->caller = call->caller * FUNC_SITE_SIZE;
 216                        out->flags = call->flags;
 217                        upto++;
 218                }
 219                ptr += sizeof(struct trace_call);
 220        }
 221
 222        /* Update the header */
 223        if (output_hdr) {
 224                output_hdr->rec_count = upto;
 225                output_hdr->type = TRACE_CHUNK_CALLS;
 226        }
 227
 228        /* Work out how must of the buffer we used */
 229        *needed = ptr - buff;
 230        if (ptr > end)
 231                return -1;
 232        return 0;
 233}
 234
 235/* Print basic information about tracing */
 236void trace_print_stats(void)
 237{
 238        ulong count;
 239
 240#ifndef FTRACE
 241        puts("Warning: make U-Boot with FTRACE to enable function instrumenting.\n");
 242        puts("You will likely get zeroed data here\n");
 243#endif
 244        if (!trace_inited) {
 245                printf("Trace is disabled\n");
 246                return;
 247        }
 248        print_grouped_ull(hdr->func_count, 10);
 249        puts(" function sites\n");
 250        print_grouped_ull(hdr->call_count, 10);
 251        puts(" function calls\n");
 252        print_grouped_ull(hdr->untracked_count, 10);
 253        puts(" untracked function calls\n");
 254        count = min(hdr->ftrace_count, hdr->ftrace_size);
 255        print_grouped_ull(count, 10);
 256        puts(" traced function calls");
 257        if (hdr->ftrace_count > hdr->ftrace_size) {
 258                printf(" (%lu dropped due to overflow)",
 259                       hdr->ftrace_count - hdr->ftrace_size);
 260        }
 261        puts("\n");
 262        printf("%15d maximum observed call depth\n", hdr->max_depth);
 263        printf("%15d call depth limit\n", hdr->depth_limit);
 264        print_grouped_ull(hdr->ftrace_too_deep_count, 10);
 265        puts(" calls not traced due to depth\n");
 266}
 267
 268void __attribute__((no_instrument_function)) trace_set_enabled(int enabled)
 269{
 270        trace_enabled = enabled != 0;
 271}
 272
 273/**
 274 * Init the tracing system ready for used, and enable it
 275 *
 276 * @param buff          Pointer to trace buffer
 277 * @param buff_size     Size of trace buffer
 278 */
 279int __attribute__((no_instrument_function)) trace_init(void *buff,
 280                size_t buff_size)
 281{
 282        ulong func_count = gd->mon_len / FUNC_SITE_SIZE;
 283        size_t needed;
 284        int was_disabled = !trace_enabled;
 285
 286        if (!was_disabled) {
 287#ifdef CONFIG_TRACE_EARLY
 288                char *end;
 289                ulong used;
 290
 291                /*
 292                 * Copy over the early trace data if we have it. Disable
 293                 * tracing while we are doing this.
 294                 */
 295                trace_enabled = 0;
 296                hdr = map_sysmem(CONFIG_TRACE_EARLY_ADDR,
 297                                 CONFIG_TRACE_EARLY_SIZE);
 298                end = (char *)&hdr->ftrace[hdr->ftrace_count];
 299                used = end - (char *)hdr;
 300                printf("trace: copying %08lx bytes of early data from %x to %08lx\n",
 301                       used, CONFIG_TRACE_EARLY_ADDR,
 302                       (ulong)map_to_sysmem(buff));
 303                memcpy(buff, hdr, used);
 304#else
 305                puts("trace: already enabled\n");
 306                return -1;
 307#endif
 308        }
 309        hdr = (struct trace_hdr *)buff;
 310        needed = sizeof(*hdr) + func_count * sizeof(uintptr_t);
 311        if (needed > buff_size) {
 312                printf("trace: buffer size %zd bytes: at least %zd needed\n",
 313                       buff_size, needed);
 314                return -1;
 315        }
 316
 317        if (was_disabled)
 318                memset(hdr, '\0', needed);
 319        hdr->func_count = func_count;
 320        hdr->call_accum = (uintptr_t *)(hdr + 1);
 321
 322        /* Use any remaining space for the timed function trace */
 323        hdr->ftrace = (struct trace_call *)(buff + needed);
 324        hdr->ftrace_size = (buff_size - needed) / sizeof(*hdr->ftrace);
 325        add_textbase();
 326
 327        puts("trace: enabled\n");
 328        hdr->depth_limit = 15;
 329        trace_enabled = 1;
 330        trace_inited = 1;
 331        return 0;
 332}
 333
 334#ifdef CONFIG_TRACE_EARLY
 335int __attribute__((no_instrument_function)) trace_early_init(void)
 336{
 337        ulong func_count = gd->mon_len / FUNC_SITE_SIZE;
 338        size_t buff_size = CONFIG_TRACE_EARLY_SIZE;
 339        size_t needed;
 340
 341        /* We can ignore additional calls to this function */
 342        if (trace_enabled)
 343                return 0;
 344
 345        hdr = map_sysmem(CONFIG_TRACE_EARLY_ADDR, CONFIG_TRACE_EARLY_SIZE);
 346        needed = sizeof(*hdr) + func_count * sizeof(uintptr_t);
 347        if (needed > buff_size) {
 348                printf("trace: buffer size is %zd bytes, at least %zd needed\n",
 349                       buff_size, needed);
 350                return -1;
 351        }
 352
 353        memset(hdr, '\0', needed);
 354        hdr->call_accum = (uintptr_t *)(hdr + 1);
 355        hdr->func_count = func_count;
 356
 357        /* Use any remaining space for the timed function trace */
 358        hdr->ftrace = (struct trace_call *)((char *)hdr + needed);
 359        hdr->ftrace_size = (buff_size - needed) / sizeof(*hdr->ftrace);
 360        add_textbase();
 361        hdr->depth_limit = 200;
 362        printf("trace: early enable at %08x\n", CONFIG_TRACE_EARLY_ADDR);
 363
 364        trace_enabled = 1;
 365        return 0;
 366}
 367#endif
 368