Return to iscope.3 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / icon / man / cat3

Annotation of 43BSD/contrib/icon/man/cat3/iscope.3, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: 
                      4: ISCOPE(3.icon)        Icon Program Library         ISCOPE(3.icon)
                      5: 
                      6: 
                      7: 
                      8: NNNNAAAAMMMMEEEE
                      9:      Descr, Indir, Word1, Word2, Symbol, Efp, Gfp, Pfp - examine
                     10:      Icon internals
                     11: 
                     12: DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
                     13:      These functions deal with Icon internals, producing values
                     14:      that exist in memory and registers as Icon is executing.
                     15:      Internal values are represented as Icon integers. A
                     16:      knowledge of the implementation of Icon is needed to use
                     17:      these functions properly.
                     18: 
                     19: SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
                     20:      DDDDeeeessssccccrrrr((((iiii,,,,jjjj))))
                     21:                compose a descriptor whose first word is iiii and
                     22:                whose second word is jjjj.
                     23: 
                     24:      IIIInnnnddddiiiirrrr((((iiii))))  return an integer corresponding to the value where
                     25:                the descriptor at iiii points.
                     26: 
                     27:      WWWWoooorrrrdddd1111((((xxxx,,,,iiii))))
                     28:                return Icon integer whose value is the first word
                     29:                of the descriptor xxxx. If iiii is zero, xxxx is derefer-
                     30:                enced; otherwise it is not. An omitted value of iiii
                     31:                defaults to 0.
                     32: 
                     33:      WWWWoooorrrrdddd2222((((xxxx,,,,iiii))))
                     34:                like WWWWoooorrrrdddd1111, except that the value is for the
                     35:                second word of the descriptor xxxx.
                     36: 
                     37:      SSSSyyyymmmmbbbboooollll((((ssss)))) returns the address of the symbol ssss. The allowable
                     38:                values of ssss are:
                     39: 
                     40:                     globals   address of the global vector
                     41:                     eeeegggglllloooobbbbaaaallllssss  address of the end of the global vector
                     42:                     ggggnnnnaaaammmmeeeessss    address of the global name vector
                     43:                     ssssttttrrrriiiinnnnggggssss   beginning of the string region
                     44:                     ssssffffrrrreeeeeeee     string region free pointer
                     45:                     hhhhppppbbbbaaaasssseeee    beginning of the heap region
                     46:                     hhhhppppffffrrrreeeeeeee    heap region free pointer
                     47:                     ssssttttaaaacccckkkkssss    beginning of the co-expression stack region
                     48:                     eeeessssffffrrrreeeeeeee    co-expression stack region free pointer
                     49: 
                     50:                SSSSyyyymmmmbbbboooollll((((ssss)))) fails if ssss is not one of these strings.
                     51: 
                     52:      EEEEffffpppp(((())))     return the address of the expression frame pointer
                     53: 
                     54:      GGGGffffpppp(((())))     return the address of the generator frame pointer
                     55: 
                     56:      PPPPffffpppp(((())))     return the address of the frame pointer
                     57: 
                     58: CCCCAAAAVVVVEEEEAAAATTTTSSSS
                     59:      _I_s_c_o_p_e is inherently dangerous. For example, the composition
                     60: 
                     61: 
                     62: 
                     63: Version 5.9    The University of Arizona - 8/17/84              1
                     64: 
                     65: 
                     66: 
                     67: 
                     68: 
                     69: 
                     70: ISCOPE(3.icon)        Icon Program Library         ISCOPE(3.icon)
                     71: 
                     72: 
                     73: 
                     74:      of an arbitrary descriptor using DDDDeeeessssccccrrrr may cause the Icon
                     75:      system to malfunction in mysterious ways.
                     76: 
                     77:      Addresses that are represented by integers are not relocated
                     78:      during garbage collection; such addresses generally are
                     79:      invalidated by a garbage collection.
                     80: 
                     81: RRRREEEEQQQQUUUUIIIIRRRREEEEMMMMEEEENNNNTTTTSSSS
                     82:      _I_s_c_o_p_e only works for the VAX-11 implementation of Icon.
                     83: 
                     84: SSSSEEEEEEEE AAAALLLLSSSSOOOO
                     85:      Griswold, Ralph E., Robert K. McConeghy, and William H.
                     86:      Mitchell.  _A _T_o_u_r _T_h_r_o_u_g_h _t_h_e _C _I_m_p_l_e_m_e_n_t_a_t_i_o_n _o_f _I_c_o_n; _V_e_r_-
                     87:      _s_i_o_n _5._9, Department of Computer Science, The University of
                     88:      Arizona. 1984.
                     89: 
                     90:      Griswold, Ralph E. ``A Portable Diagnostic Facility for SNO-
                     91:      BOL4'', _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e _a_n_d _E_x_p_e_r_i_e_n_c_e, Vol. 5 (1975),
                     92:      pp. 93-105.
                     93: 
                     94:      Griswold, Ralph E. ``Linguistic Extension of Abstract
                     95:      Machine Modelling to Aid Software Development'', _S_o_f_t_w_a_r_e--
                     96:      _P_r_a_c_t_i_c_e _a_n_d _E_x_p_e_r_i_e_n_c_e, Vol. 10 (1980), pp. 1-9.
                     97: 
                     98: AAAAUUUUTTTTHHHHOOOORRRRSSSS
                     99:      Ralph E. Griswold and William H. Mitchell
                    100: 
                    101: 
                    102: 
                    103: 
                    104: 
                    105: 
                    106: 
                    107: 
                    108: 
                    109: 
                    110: 
                    111: 
                    112: 
                    113: 
                    114: 
                    115: 
                    116: 
                    117: 
                    118: 
                    119: 
                    120: 
                    121: 
                    122: 
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: Version 5.9    The University of Arizona - 8/17/84              2
                    130: 
                    131: 
                    132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.