Cstack_info               package:base               R Documentation

_R_e_p_o_r_t _I_n_f_o_r_m_a_t_i_o_n _o_n _C _S_t_a_c_k _S_i_z_e _a_n_d _U_s_a_g_e

_D_e_s_c_r_i_p_t_i_o_n:

     Report information on the C stack size and usage (if available).

_U_s_a_g_e:

     Cstack_info()

_D_e_t_a_i_l_s:

     On most platforms, C stack information is recorded when R is
     initialized and used for stack-checking.  If this information is
     unavailable, the 'size' will be returned as 'NA', and
     stack-checking is not performed.

     The information on the stack base address is thought to be
     accurate on Windows, Linux and FreeBSD (including Mac OS X), but a
     heuristic is used on other platforms.  Because this might be
     slightly inaccurate, the current usage could be estimated as
     negative.  (The heuristic is not used on embedded uses of R on
     platforms where the stack base is not thought to be accurate.)

_V_a_l_u_e:

     An integer vector.  This has named elements 

    size: The size of the stack (in bytes), or 'NA' if unknown.

 current: The estimated current usage (in bytes), possibly 'NA'.

direction: '1' (stack grows down, the usual case) or '-1' (stack grows
          up).

eval_depth: The current evaluation depth (including two calls for the
          call to 'Cstack_info').

_E_x_a_m_p_l_e_s:

     Cstack_info()

