Updated French translation
[binutils.git] / gprof / gprof.c
blob4a1fd50d01d620bf32410ce98478d62de81b85ee
1 /*
2 * Copyright (c) 1983, 1998, 2001 Regents of the University of California.
3 * All rights reserved.
5 * Redistribution and use in source and binary forms are permitted
6 * provided that: (1) source distributions retain this entire copyright
7 * notice and comment, and (2) distributions including binaries display
8 * the following acknowledgement: ``This product includes software
9 * developed by the University of California, Berkeley and its contributors''
10 * in the documentation or other materials provided with the distribution
11 * and in all advertising materials mentioning features or use of this
12 * software. Neither the name of the University nor the names of its
13 * contributors may be used to endorse or promote products derived
14 * from this software without specific prior written permission.
15 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
17 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
19 #include "getopt.h"
20 #include "libiberty.h"
21 #include "gprof.h"
22 #include "basic_blocks.h"
23 #include "call_graph.h"
24 #include "cg_arcs.h"
25 #include "cg_print.h"
26 #include "corefile.h"
27 #include "gmon_io.h"
28 #include "hertz.h"
29 #include "hist.h"
30 #include "source.h"
31 #include "sym_ids.h"
32 #include "demangle.h"
34 const char *whoami;
35 const char *function_mapping_file;
36 const char *a_out_name = A_OUTNAME;
37 long hz = HZ_WRONG;
40 * Default options values:
42 int debug_level = 0;
43 int output_style = 0;
44 int output_width = 80;
45 bool bsd_style_output = FALSE;
46 bool demangle = TRUE;
47 bool discard_underscores = TRUE;
48 bool ignore_direct_calls = FALSE;
49 bool ignore_static_funcs = FALSE;
50 bool ignore_zeros = TRUE;
51 bool line_granularity = FALSE;
52 bool print_descriptions = TRUE;
53 bool print_path = FALSE;
54 bool ignore_non_functions = FALSE;
55 File_Format file_format = FF_AUTO;
57 bool first_output = TRUE;
59 char copyright[] =
60 "@(#) Copyright (c) 1983 Regents of the University of California.\n\
61 All rights reserved.\n";
63 static char *gmon_name = GMONNAME; /* profile filename */
65 bfd *abfd;
68 * Functions that get excluded by default:
70 static char *default_excluded_list[] =
72 "_gprof_mcount", "mcount", "_mcount", "__mcount", "__mcount_internal",
73 "__mcleanup",
74 "<locore>", "<hicore>",
78 /* Codes used for the long options with no short synonyms. 150 isn't
79 special; it's just an arbitrary non-ASCII char value. */
81 #define OPTION_DEMANGLE (150)
82 #define OPTION_NO_DEMANGLE (OPTION_DEMANGLE + 1)
84 static struct option long_options[] =
86 {"line", no_argument, 0, 'l'},
87 {"no-static", no_argument, 0, 'a'},
88 {"ignore-non-functions", no_argument, 0, 'D'},
90 /* output styles: */
92 {"annotated-source", optional_argument, 0, 'A'},
93 {"no-annotated-source", optional_argument, 0, 'J'},
94 {"flat-profile", optional_argument, 0, 'p'},
95 {"no-flat-profile", optional_argument, 0, 'P'},
96 {"graph", optional_argument, 0, 'q'},
97 {"no-graph", optional_argument, 0, 'Q'},
98 {"exec-counts", optional_argument, 0, 'C'},
99 {"no-exec-counts", optional_argument, 0, 'Z'},
100 {"function-ordering", no_argument, 0, 'r'},
101 {"file-ordering", required_argument, 0, 'R'},
102 {"file-info", no_argument, 0, 'i'},
103 {"sum", no_argument, 0, 's'},
105 /* various options to affect output: */
107 {"all-lines", no_argument, 0, 'x'},
108 {"demangle", optional_argument, 0, OPTION_DEMANGLE},
109 {"no-demangle", no_argument, 0, OPTION_NO_DEMANGLE},
110 {"directory-path", required_argument, 0, 'I'},
111 {"display-unused-functions", no_argument, 0, 'z'},
112 {"min-count", required_argument, 0, 'm'},
113 {"print-path", no_argument, 0, 'L'},
114 {"separate-files", no_argument, 0, 'y'},
115 {"static-call-graph", no_argument, 0, 'c'},
116 {"table-length", required_argument, 0, 't'},
117 {"time", required_argument, 0, 'n'},
118 {"no-time", required_argument, 0, 'N'},
119 {"width", required_argument, 0, 'w'},
121 * These are for backwards-compatibility only. Their functionality
122 * is provided by the output style options already:
124 {"", required_argument, 0, 'e'},
125 {"", required_argument, 0, 'E'},
126 {"", required_argument, 0, 'f'},
127 {"", required_argument, 0, 'F'},
128 {"", required_argument, 0, 'k'},
130 /* miscellaneous: */
132 {"brief", no_argument, 0, 'b'},
133 {"debug", optional_argument, 0, 'd'},
134 {"help", no_argument, 0, 'h'},
135 {"file-format", required_argument, 0, 'O'},
136 {"traditional", no_argument, 0, 'T'},
137 {"version", no_argument, 0, 'v'},
138 {0, no_argument, 0, 0}
142 static void
143 DEFUN (usage, (stream, status), FILE * stream AND int status)
145 fprintf (stream, _("\
146 Usage: %s [-[abcDhilLsTvwxyz]] [-[ACeEfFJnNOpPqQZ][name]] [-I dirs]\n\
147 [-d[num]] [-k from/to] [-m min-count] [-t table-length]\n\
148 [--[no-]annotated-source[=name]] [--[no-]exec-counts[=name]]\n\
149 [--[no-]flat-profile[=name]] [--[no-]graph[=name]]\n\
150 [--[no-]time=name] [--all-lines] [--brief] [--debug[=level]]\n\
151 [--function-ordering] [--file-ordering]\n\
152 [--directory-path=dirs] [--display-unused-functions]\n\
153 [--file-format=name] [--file-info] [--help] [--line] [--min-count=n]\n\
154 [--no-static] [--print-path] [--separate-files]\n\
155 [--static-call-graph] [--sum] [--table-length=len] [--traditional]\n\
156 [--version] [--width=n] [--ignore-non-functions]\n\
157 [--demangle[=STYLE]] [--no-demangle]\n\
158 [image-file] [profile-file...]\n"),
159 whoami);
160 if (status == 0)
161 fprintf (stream, _("Report bugs to %s\n"), REPORT_BUGS_TO);
162 done (status);
167 DEFUN (main, (argc, argv), int argc AND char **argv)
169 char **sp, *str;
170 Sym **cg = 0;
171 int ch, user_specified = 0;
173 #if defined (HAVE_SETLOCALE) && defined (HAVE_LC_MESSAGES)
174 setlocale (LC_MESSAGES, "");
175 #endif
176 #if defined (HAVE_SETLOCALE)
177 setlocale (LC_CTYPE, "");
178 #endif
179 bindtextdomain (PACKAGE, LOCALEDIR);
180 textdomain (PACKAGE);
182 whoami = argv[0];
183 xmalloc_set_program_name (whoami);
185 while ((ch = getopt_long (argc, argv,
186 "aA::bBcCd::De:E:f:F:hiI:J::k:lLm:n::N::O:p::P::q::Q::st:Tvw:xyzZ::",
187 long_options, 0))
188 != EOF)
190 switch (ch)
192 case 'a':
193 ignore_static_funcs = TRUE;
194 break;
195 case 'A':
196 if (optarg)
198 sym_id_add (optarg, INCL_ANNO);
200 output_style |= STYLE_ANNOTATED_SOURCE;
201 user_specified |= STYLE_ANNOTATED_SOURCE;
202 break;
203 case 'b':
204 print_descriptions = FALSE;
205 break;
206 case 'B':
207 output_style |= STYLE_CALL_GRAPH;
208 user_specified |= STYLE_CALL_GRAPH;
209 break;
210 case 'c':
211 ignore_direct_calls = TRUE;
212 break;
213 case 'C':
214 if (optarg)
216 sym_id_add (optarg, INCL_EXEC);
218 output_style |= STYLE_EXEC_COUNTS;
219 user_specified |= STYLE_EXEC_COUNTS;
220 break;
221 case 'd':
222 if (optarg)
224 debug_level |= atoi (optarg);
225 debug_level |= ANYDEBUG;
227 else
229 debug_level = ~0;
231 DBG (ANYDEBUG, printf ("[main] debug-level=0x%x\n", debug_level));
232 #ifndef DEBUG
233 printf (_("%s: debugging not supported; -d ignored\n"), whoami);
234 #endif /* DEBUG */
235 break;
236 case 'D':
237 ignore_non_functions = TRUE;
238 break;
239 case 'E':
240 sym_id_add (optarg, EXCL_TIME);
241 case 'e':
242 sym_id_add (optarg, EXCL_GRAPH);
243 break;
244 case 'F':
245 sym_id_add (optarg, INCL_TIME);
246 case 'f':
247 sym_id_add (optarg, INCL_GRAPH);
248 break;
249 case 'g':
250 sym_id_add (optarg, EXCL_FLAT);
251 break;
252 case 'G':
253 sym_id_add (optarg, INCL_FLAT);
254 break;
255 case 'h':
256 usage (stdout, 0);
257 case 'i':
258 output_style |= STYLE_GMON_INFO;
259 user_specified |= STYLE_GMON_INFO;
260 break;
261 case 'I':
262 search_list_append (&src_search_list, optarg);
263 break;
264 case 'J':
265 if (optarg)
267 sym_id_add (optarg, EXCL_ANNO);
268 output_style |= STYLE_ANNOTATED_SOURCE;
270 else
272 output_style &= ~STYLE_ANNOTATED_SOURCE;
274 user_specified |= STYLE_ANNOTATED_SOURCE;
275 break;
276 case 'k':
277 sym_id_add (optarg, EXCL_ARCS);
278 break;
279 case 'l':
280 line_granularity = TRUE;
281 break;
282 case 'L':
283 print_path = TRUE;
284 break;
285 case 'm':
286 bb_min_calls = (unsigned long) strtoul (optarg, (char **) NULL, 10);
287 break;
288 case 'n':
289 sym_id_add (optarg, INCL_TIME);
290 break;
291 case 'N':
292 sym_id_add (optarg, EXCL_TIME);
293 break;
294 case 'O':
295 switch (optarg[0])
297 case 'a':
298 file_format = FF_AUTO;
299 break;
300 case 'm':
301 file_format = FF_MAGIC;
302 break;
303 case 'b':
304 file_format = FF_BSD;
305 break;
306 case '4':
307 file_format = FF_BSD44;
308 break;
309 case 'p':
310 file_format = FF_PROF;
311 break;
312 default:
313 fprintf (stderr, _("%s: unknown file format %s\n"),
314 optarg, whoami);
315 done (1);
317 break;
318 case 'p':
319 if (optarg)
321 sym_id_add (optarg, INCL_FLAT);
323 output_style |= STYLE_FLAT_PROFILE;
324 user_specified |= STYLE_FLAT_PROFILE;
325 break;
326 case 'P':
327 if (optarg)
329 sym_id_add (optarg, EXCL_FLAT);
330 output_style |= STYLE_FLAT_PROFILE;
332 else
334 output_style &= ~STYLE_FLAT_PROFILE;
336 user_specified |= STYLE_FLAT_PROFILE;
337 break;
338 case 'q':
339 if (optarg)
341 if (strchr (optarg, '/'))
343 sym_id_add (optarg, INCL_ARCS);
345 else
347 sym_id_add (optarg, INCL_GRAPH);
350 output_style |= STYLE_CALL_GRAPH;
351 user_specified |= STYLE_CALL_GRAPH;
352 break;
353 case 'r':
354 output_style |= STYLE_FUNCTION_ORDER;
355 user_specified |= STYLE_FUNCTION_ORDER;
356 break;
357 case 'R':
358 output_style |= STYLE_FILE_ORDER;
359 user_specified |= STYLE_FILE_ORDER;
360 function_mapping_file = optarg;
361 break;
362 case 'Q':
363 if (optarg)
365 if (strchr (optarg, '/'))
367 sym_id_add (optarg, EXCL_ARCS);
369 else
371 sym_id_add (optarg, EXCL_GRAPH);
373 output_style |= STYLE_CALL_GRAPH;
375 else
377 output_style &= ~STYLE_CALL_GRAPH;
379 user_specified |= STYLE_CALL_GRAPH;
380 break;
381 case 's':
382 output_style |= STYLE_SUMMARY_FILE;
383 user_specified |= STYLE_SUMMARY_FILE;
384 break;
385 case 't':
386 bb_table_length = atoi (optarg);
387 if (bb_table_length < 0)
389 bb_table_length = 0;
391 break;
392 case 'T':
393 bsd_style_output = TRUE;
394 break;
395 case 'v':
396 /* This output is intended to follow the GNU standards document. */
397 printf (_("GNU gprof %s\n"), VERSION);
398 printf (_("Based on BSD gprof, copyright 1983 Regents of the University of California.\n"));
399 printf (_("\
400 This program is free software. This program has absolutely no warranty.\n"));
401 done (0);
402 case 'w':
403 output_width = atoi (optarg);
404 if (output_width < 1)
406 output_width = 1;
408 break;
409 case 'x':
410 bb_annotate_all_lines = TRUE;
411 break;
412 case 'y':
413 create_annotation_files = TRUE;
414 break;
415 case 'z':
416 ignore_zeros = FALSE;
417 break;
418 case 'Z':
419 if (optarg)
421 sym_id_add (optarg, EXCL_EXEC);
422 output_style |= STYLE_EXEC_COUNTS;
424 else
426 output_style &= ~STYLE_EXEC_COUNTS;
428 user_specified |= STYLE_ANNOTATED_SOURCE;
429 break;
430 case OPTION_DEMANGLE:
431 demangle = TRUE;
432 if (optarg != NULL)
434 enum demangling_styles style;
436 style = cplus_demangle_name_to_style (optarg);
437 if (style == unknown_demangling)
439 fprintf (stderr,
440 _("%s: unknown demangling style `%s'\n"),
441 whoami, optarg);
442 xexit (1);
445 cplus_demangle_set_style (style);
447 break;
448 case OPTION_NO_DEMANGLE:
449 demangle = FALSE;
450 break;
451 default:
452 usage (stderr, 1);
456 /* Don't allow both ordering options, they modify the arc data in-place. */
457 if ((user_specified & STYLE_FUNCTION_ORDER)
458 && (user_specified & STYLE_FILE_ORDER))
460 fprintf (stderr,_("\
461 %s: Only one of --function-ordering and --file-ordering may be specified.\n"),
462 whoami);
463 done (1);
466 /* --sum implies --line, otherwise we'd lose b-b counts in gmon.sum */
467 if (output_style & STYLE_SUMMARY_FILE)
469 line_granularity = 1;
472 /* append value of GPROF_PATH to source search list if set: */
473 str = (char *) getenv ("GPROF_PATH");
474 if (str)
476 search_list_append (&src_search_list, str);
479 if (optind < argc)
481 a_out_name = argv[optind++];
483 if (optind < argc)
485 gmon_name = argv[optind++];
489 * Turn off default functions:
491 for (sp = &default_excluded_list[0]; *sp; sp++)
493 sym_id_add (*sp, EXCL_TIME);
494 sym_id_add (*sp, EXCL_GRAPH);
495 #ifdef __alpha__
496 sym_id_add (*sp, EXCL_FLAT);
497 #endif
501 * For line-by-line profiling, also want to keep those
502 * functions off the flat profile:
504 if (line_granularity)
506 for (sp = &default_excluded_list[0]; *sp; sp++)
508 sym_id_add (*sp, EXCL_FLAT);
513 * Read symbol table from core file:
515 core_init (a_out_name);
518 * If we should ignore direct function calls, we need to load
519 * to core's text-space:
521 if (ignore_direct_calls)
523 core_get_text_space (core_bfd);
527 * Create symbols from core image:
529 if (line_granularity)
531 core_create_line_syms (core_bfd);
533 else
535 core_create_function_syms (core_bfd);
539 * Translate sym specs into syms:
541 sym_id_parse ();
543 if (file_format == FF_PROF)
545 #ifdef PROF_SUPPORT_IMPLEMENTED
547 * Get information about mon.out file(s):
551 mon_out_read (gmon_name);
552 if (optind < argc)
554 gmon_name = argv[optind];
557 while (optind++ < argc);
558 #else
559 fprintf (stderr,
560 _("%s: sorry, file format `prof' is not yet supported\n"),
561 whoami);
562 done (1);
563 #endif
565 else
568 * Get information about gmon.out file(s):
572 gmon_out_read (gmon_name);
573 if (optind < argc)
575 gmon_name = argv[optind];
578 while (optind++ < argc);
582 * If user did not specify output style, try to guess something
583 * reasonable:
585 if (output_style == 0)
587 if (gmon_input & (INPUT_HISTOGRAM | INPUT_CALL_GRAPH))
589 output_style = STYLE_FLAT_PROFILE | STYLE_CALL_GRAPH;
591 else
593 output_style = STYLE_EXEC_COUNTS;
595 output_style &= ~user_specified;
599 * Dump a gmon.sum file if requested (before any other processing!):
601 if (output_style & STYLE_SUMMARY_FILE)
603 gmon_out_write (GMONSUM);
606 if (gmon_input & INPUT_HISTOGRAM)
608 hist_assign_samples ();
611 if (gmon_input & INPUT_CALL_GRAPH)
613 cg = cg_assemble ();
616 /* do some simple sanity checks: */
618 if ((output_style & STYLE_FLAT_PROFILE)
619 && !(gmon_input & INPUT_HISTOGRAM))
621 fprintf (stderr, _("%s: gmon.out file is missing histogram\n"), whoami);
622 done (1);
625 if ((output_style & STYLE_CALL_GRAPH) && !(gmon_input & INPUT_CALL_GRAPH))
627 fprintf (stderr,
628 _("%s: gmon.out file is missing call-graph data\n"), whoami);
629 done (1);
632 /* output whatever user whishes to see: */
634 if (cg && (output_style & STYLE_CALL_GRAPH) && bsd_style_output)
636 cg_print (cg); /* print the dynamic profile */
639 if (output_style & STYLE_FLAT_PROFILE)
641 hist_print (); /* print the flat profile */
644 if (cg && (output_style & STYLE_CALL_GRAPH))
646 if (!bsd_style_output)
648 cg_print (cg); /* print the dynamic profile */
650 cg_print_index ();
653 if (output_style & STYLE_EXEC_COUNTS)
655 print_exec_counts ();
658 if (output_style & STYLE_ANNOTATED_SOURCE)
660 print_annotated_source ();
662 if (output_style & STYLE_FUNCTION_ORDER)
664 cg_print_function_ordering ();
666 if (output_style & STYLE_FILE_ORDER)
668 cg_print_file_ordering ();
670 return 0;
673 void
674 done (status)
675 int status;
677 exit (status);