CTREE(1) UNIX Programmer's Manual CTREE(1) NAME ctree - print C function-call trees SYNOPSIS ctree [-nqFGMST] [-i indent] [-l level] [-c columns] [-t tagpath] [functions...] DESCRIPTION _C_t_r_e_e uses the _t_a_g_s file produced by _c_t_a_g_s(1) to print a display of the calling hierarchy in C programs. This can be used as a ``road map'' for browsing large or unfamiliar software systems. If no _f_u_n_c_t_i_o_n_s are given, all uncalled functions in the _t_a_g_s file (like _m_a_i_n) are used. Options provide control over formatting. Default output looks like this: Mptags(){ Case# Default# Error(){ Quiet Status } Int# Quiet^ Quote Status^ Verbose doTag(){ FindTag(){ Error^ SearchTagsFile(){ Error^ } null# tagpath } } ... } _M_p_t_a_g_s is the main function in a file called _p_t_a_g_s._c. Func- tions - _M_p_t_a_g_s, _E_r_r_o_r, _d_o_T_a_g, etc - are marked with parenthesis (). Macros - _C_a_s_e, _D_e_f_i_n_e, _I_n_t, etc - are marked with a pound sign #. A circumflex ^ means a symbol has appeared earlier in the listing (so functions are only enumerated once). Unmarked symbols - _Q_u_i_e_t, _S_t_a_t_u_s, etc - are global variables. Indentation and curly braces show the calling hierarchy; thus, _d_o_T_a_g calls _F_i_n_d_T_a_g, which calls _E_r_r_o_r, _S_e_a_r_c_h_T_a_g_s_F_i_l_e, _n_u_l_l, and _t_a_g_p_a_t_h. OPTIONS -n put each symbol on a new line, instead of the compact form above. -FGMST suppress printing of functions, globals, macros, structs, or typedefs, respectively. -q _q_u_i_e_t - don't print the type labels (#, ()). -c columns wrap lines greater than _c_o_l_u_m_n_s wide (default=80). -i indent Printed 9/11/87 May 30 1985 1 CTREE(1) UNIX Programmer's Manual CTREE(1) Use _i_n_d_e_n_t as the indentation string (three spaces is the default). -l level limit the depth of the tree to _l_e_v_e_l. -t tagpath set the path of tag files searched to _t_a_g_p_a_t_h (the default is $_T_A_G_S, or failing that, _t_a_g_s). DIAGNOSTICS Exits with status 1 if nothing was printed. FILES tags tags file used SEE ALSO ctags(1), ptags(1), cman(1) AUTHOR Michael Hawley Printed 9/11/87 May 30 1985 2