

            brefs (5) --- print caller-callee pairs in an object file  01/03/83


            _U_s_a_g_e

                 brefs { <object file> | -n }


            _D_e_s_c_r_i_p_t_i_o_n

                 'Brefs'  prints  the  precedence  relationships  between the
                 entry points that are defined and/or referenced  within  the
                 named  object  files.   Each  output line contains two entry
                 point names; the first is the name of  the  calling  routine
                 ($MAIN   for  Fortran  main  programs  or  unnamed  assembly
                 language routines), and the second is the name of an  exter-
                 nal  object  referenced  by  that  routine.  The output from
                 'brefs' is suitable for piping into 'tsort' to determine the
                 proper ordering for routines in a library.

                 If the "-n" argument appears in the place of an object  file
                 name,  'brefs'  will  obtain  names of object files from its
                 standard input.  For more information on  this  syntax,  see
                 the entry for 'cat' (1).


            _E_x_a_m_p_l_e_s

                 brefs ave.b ave_lib.b
                 brefs lib.b | tsort | bmerge lib.b >lib


            _M_e_s_s_a_g_e_s

                 "<object  file>:   can't open" if a non-existent or inacces-
                      sible file is specified.
                 "<object file>:  bad object file" if something other than an
                      object file is specified.
                 "block size exceeds buffer space"  if  the  object  file  is
                      badly formatted.


            _B_u_g_s

                 If  a  module has multiple entry points, only the last entry
                 point is recognized.


            _S_e_e _A_l_s_o

                 bmerge (5), bnames (5), ld (1), lorder (1), tsort (1)










            brefs (5)                     - 1 -                     brefs (5)


