home *** CD-ROM | disk | FTP | other *** search
/ IRIS Development Option 6.2 / IRIS_Development_Option_6.2_814-0478-001.iso / relnotes / c_dev / ch2.z / ch2
Text File  |  1996-03-14  |  11KB  |  330 lines
  1.  
  2.  
  3.  
  4.                                                - 1 -
  5.  
  6.  
  7.  
  8.                     6.2 ANSI C Release Notes
  9.  
  10.  
  11.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                - 2 -
  70.  
  71.  
  72.  
  73.                     DDDDooooccccuuuummmmeeeennnntttt NNNNuuuummmmbbbbeeeerrrr 000000007777----1111666655559999----000011110000
  74.  
  75.  
  76.                     2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  77.  
  78.                     This chapter lists supplemental information to
  79.                     the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The
  80.                     information listed here is product-specific; use
  81.                     it with the installation guide to install this
  82.                     product.
  83.  
  84.                     2.1  _A_N_S_I__C__S_u_b_s_y_s_t_e_m_s
  85.  
  86.                     This section lists the subsystems of the ANSI C
  87.                     option.
  88.  
  89.                     If you are installing this option for the first
  90.                     time, the subsystems marked ``default'' are
  91.                     those that are installed if you use the ``go''
  92.                     menu item.  To install a different set of
  93.                     subsystems, use the ``install,'' ``remove,''
  94.                     ``keep,'' and ``step'' commands in _i_n_s_t to
  95.                     customize the list of subsystems to be
  96.                     installed, then select the ``go'' menu item.
  97.  
  98.                     _c__d_e_v._b_o_o_k_s._C_L_a_n_g_u_a_g_e_R_e_f Insight-readable
  99.                                         version of the compiler and
  100.                                         C programmer's reference
  101.                                         guide (default)
  102.  
  103.                     _c__d_e_v._m_a_n._c         Manual page for the _c_c
  104.                                         driver (default)
  105.  
  106.                     _c__d_e_v._m_a_n._u_t_i_l      Manual pages for C source
  107.                                         utilities - _c_f_l_o_w, _c_b, etc.
  108.                                         (default)
  109.  
  110.                     _c__d_e_v._m_a_n._r_e_l_n_o_t_e_s  Online version of these
  111.                                         release notes (default)
  112.  
  113.                     _c__d_e_v._s_w._c          The C front ends and
  114.                                         preprocessors (default)
  115.  
  116.                     _c__d_e_v._s_w._c_o_p_t       The C scalar optimizer
  117.                                         (default)
  118.  
  119.                     _c__d_e_v._h_d_r._l_i_b       _c_o_p_t-specific header files -
  120.                                         _k_a_p_i_o._i_n_t_e_r_n_a_l._h,
  121.                                         _k_a_p_i_o._s_g_i._h (default)
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                                - 3 -
  136.  
  137.  
  138.  
  139.                     _c__d_e_v._s_w._l_i_b        _c_o_p_t-specific I/O archive
  140.                                         for shared compiles -
  141.                                         _l_i_b_k_a_p_i_o._a (default)
  142.  
  143.                     _c__d_e_v._s_w._s_p_e_c_l_i_b    _c_o_p_t-specific I/O archive
  144.                                         for non-shared compiles -
  145.                                         _l_i_b_k_a_p_i_o._a
  146.  
  147.                     _c__d_e_v._s_w_3_2._l_i_b      _c_o_p_t-specific I/O archive
  148.                                         (N32 ABI) for shared
  149.                                         compiles - _l_i_b_k_a_p_i_o._a
  150.                                         (default on R8000 and R10000
  151.                                         systems only)
  152.  
  153.                     _c__d_e_v._s_w_3_2._s_p_e_c_l_i_b  _c_o_p_t-specific I/O archive
  154.                                         (N32 ABI) for non-shared
  155.                                         compiles - _l_i_b_k_a_p_i_o._a
  156.  
  157.                     _c__d_e_v._s_w_6_4._l_i_b      _c_o_p_t-specific I/O archive
  158.                                         (64-bit ABI) for shared
  159.                                         compiles - _l_i_b_k_a_p_i_o._a
  160.                                         (default on R8000 and R10000
  161.                                         systems only)
  162.  
  163.                     _c__d_e_v._s_w_6_4._s_p_e_c_l_i_b  _c_o_p_t-specific I/O archive
  164.                                         (64-bit ABI) for non-shared
  165.                                         compiles - _l_i_b_k_a_p_i_o._a
  166.  
  167.                     _c__d_e_v._s_w._u_t_i_l       The C source utilities -
  168.                                         _c_f_l_o_w, _c_b, etc.  (default)
  169.  
  170.                     _c__d_e_v._m_a_n._c_o_p_t      The C scalar optimizer
  171.                                         manual pages (default)
  172.  
  173.                     _c__d_e_v._s_r_c._c_u_s_t_o_m_a_l_l_o_c The C source code for
  174.                                         _c_u_s_t_o_m_a_l_l_o_c memory
  175.                                         allocator.
  176.  
  177.                     _c__d_e_v._s_r_c._a_c_p_p      The C source code for the
  178.                                         ANSI preprocessor _a_c_p_p
  179.  
  180.  
  181.                     2.2  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  182.  
  183.                     All of the subsystems for ANSI C can be
  184.                     installed using IRIX.  You do not need to use
  185.                     the miniroot. Refer to the _I_R_I_S _S_o_f_t_w_a_r_e
  186.                     _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  187.                     instructions.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                                - 4 -
  202.  
  203.  
  204.  
  205.                     2.3  _P_r_e_r_e_q_u_i_s_i_t_e_s
  206.  
  207.                     ANSI C 6.2 requires the installation of the IRIS
  208.                     Development Option (compilers portion) release
  209.                     6.2.  For the compiler subsystems, refer to the
  210.                     _6._2 _B_a_s_e _C_o_m_p_i_l_e_r _R_e_l_e_a_s_e _N_o_t_e_s.
  211.  
  212.  
  213.                     2.4  _C_o_m_p_a_t_i_b_i_l_i_t_y
  214.  
  215.                     ANSI C release 6.2 is a compiler aimed at
  216.                     software development for a MIPS3 or MIPS4
  217.                     instruction set architecture (ISA) in 64-bit (-
  218.                     _6_4) or n32 (-_n_3_2) mode, but with options to
  219.                     compile for a MIPS2 or MIPS1 ISA in 32-bit mode
  220.                     (-_3_2).  Refer to the _c_c(1) man pages, the
  221.                     _M_I_P_S_p_r_o _C_o_m_p_i_l_i_n_g, _D_e_b_u_g_g_i_n_g _a_n_d _P_e_r_f_o_r_m_a_n_c_e
  222.                     _T_u_n_i_n_g _G_u_i_d_e, the _M_I_P_S_p_r_o _6_4-_B_i_t _P_o_r_t_i_n_g _a_n_d
  223.                     _T_r_a_n_s_i_t_i_o_n _G_u_i_d_e, and the _C _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e
  224.                     _M_a_n_u_a_l for a full description of the differences
  225.                     between 32-bit and 64-bit compilation modes.
  226.                     For a description of the high performance 32-bit
  227.                     (n32) mode, please refer to the _M_I_P_S_p_r_o _N_3_2 _A_B_I
  228.                     _H_a_n_d_b_o_o_k.
  229.  
  230.                     In 32-bit mode, the 6.2 release of the ANSI C
  231.                     compiler is fully compatible with the earlier
  232.                     releases of the compiler with two exceptions:
  233.  
  234.                        +o MIPS2 is the default ISA
  235.  
  236.                        +o COFF is no longer supported
  237.  
  238.                     In 64-bit mode, the 6.2 release of the ANSI C
  239.                     compiler follows a new Applications Binary
  240.                     Interface (ABI).  Objects compiled in 64-bit
  241.                     mode cannot be linked together with objects
  242.                     compiled in 32-bit mode, and 64-bit objects will
  243.                     only run in an Irix 6.2 operating system
  244.                     environment.
  245.  
  246.                     In n32 mode, the 6.2 release of the ANSI C
  247.                     compiler follows a new Applications Binary
  248.                     Interface (ABI).  Objects compiled in n32 mode
  249.                     cannot be linked together with objects compiled
  250.                     in 32-bit mode or with objects compiled in 64-
  251.                     bit mode.  N32 objects will only run in an Irix
  252.                     6.2 operating system environment.
  253.  
  254.                     The 6.2 release of the ANSI C compiler is
  255.                     incompatible with 6.1 release in the way small
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                                - 5 -
  268.  
  269.  
  270.  
  271.                     (4 bytes or less) C structures and unions are
  272.                     passed as parameters when compiled -64 or -n32.
  273.                     As a result, both the caller and the callee
  274.                     functions must be compiled with the same version
  275.                     of the compiler, if they use small structures or
  276.                     unions as parameters.  Under our 64-bit and n32
  277.                     calling conventions, small structures or unions
  278.                     are left justified when passed as parameters.
  279.                     Earlier versions of the compiler implemented the
  280.                     convention incorrectly in code of both the
  281.                     callee and caller functions, but in a consistent
  282.                     way (Code passing small structs still "worked").
  283.                     This bug has been fixed, but results in the
  284.                     incompatibility described above.
  285.  
  286.                     The _COMPILER_VERSION predefined variable can be
  287.                     used to identify compiler versions that have
  288.                     this implementation.  You can check the value of
  289.                     this predefine by adding -show to your
  290.                     compilation command line. The 6.2 compiler sets
  291.                     this variable to 621.
  292.  
  293.                     For 64-bit and N32 compilation, the default
  294.                     level of enabled exceptions for speculative code
  295.                     motion (-TENV:X=n) has been changed to X=1 at
  296.                     all optimization levels. This change was made to
  297.                     provide the most uniform behavior across all SGI
  298.                     platforms. For the 6.1 release, this level was
  299.                     documented to be X=1, but implemented as X=3. As
  300.                     a result, some applications running on R8000
  301.                     systems may experience performance degradation
  302.                     if they are recompiled with the default flags.
  303.                     If this performance degradation is significant,
  304.                     you should recompile with -TENV:X=3 explicitly
  305.                     set in your compilation command line.  For more
  306.                     information about this flag, please check the
  307.                     _c_c(1) man pages.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.