1  /* hist.h
       2  
       3     Copyright (C) 2000-2023 Free Software Foundation, Inc.
       4  
       5     This file is part of GNU Binutils.
       6  
       7     This program is free software; you can redistribute it and/or modify
       8     it under the terms of the GNU General Public License as published by
       9     the Free Software Foundation; either version 3 of the License, or
      10     (at your option) any later version.
      11  
      12     This program is distributed in the hope that it will be useful,
      13     but WITHOUT ANY WARRANTY; without even the implied warranty of
      14     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      15     GNU General Public License for more details.
      16  
      17     You should have received a copy of the GNU General Public License
      18     along with this program; if not, write to the Free Software
      19     Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
      20     MA 02110-1301, USA.  */
      21  
      22  #ifndef hist_h
      23  #define hist_h
      24  
      25  typedef struct histogram
      26  {
      27    bfd_vma lowpc;
      28    bfd_vma highpc;
      29    unsigned int num_bins;
      30    int *sample;           /* Histogram samples (shorts in the file!).  */
      31  } histogram;
      32  
      33  extern histogram * histograms;
      34  extern unsigned    num_histograms;
      35  
      36  /* Scale factor converting samples to pc values:
      37     each sample covers HIST_SCALE bytes.  */
      38  extern double hist_scale;
      39  
      40  extern void hist_read_rec        (FILE *, const char *);
      41  extern void hist_write_hist      (FILE *, const char *);
      42  extern void hist_assign_samples  (void);
      43  extern void hist_print           (void);
      44  
      45  /* Checks if ADDRESS is within the range of addresses for which
      46     we have histogram data.  Returns 1 if so and 0 otherwise.  */
      47  extern int hist_check_address (unsigned address);
      48  
      49  /* Given a range of addresses for a symbol, find a histogram record
      50     that intersects with this range, and clips the range to that
      51     histogram record, modifying *P_LOWPC and *P_HIGHPC.
      52  
      53     If no intersection is found, *P_LOWPC and *P_HIGHPC will be set to
      54     one unspecified value.  If more that one intersection is found,
      55     an error is emitted.  */
      56  extern void hist_clip_symbol_address (bfd_vma *p_lowpc, bfd_vma *p_highpc);
      57  
      58  #endif /* hist_h */