This chapter details environment variables which are used by the MIPSpro compiling environment. The following sections are included in this chapter:
Section 4.1, describes the variables used with OpenMP directives.
Section 4.2, describes variables recognized on Origin 2000 and Origin 200 systems.
Section 4.3, describes the multiprocessing environment variables that allow you to set up your multiprocessing environment.
Section 4.4, describes variables used by the I/O libraries.
Section 4.5, describes other environment variables directly used by the compiler.
Section 4.6, describes environment variables used by SpeedShop.
The following environment variables are recognized on Origin 2000 and Origin 200 systems.
The multiprocessing environment variables allow you to set up your multiprocessing environment. Some of the settings that these environment variables control can also be set through library routines. For more information on the multiprocessing library routines, see MP(3f).
![]() | Note: Many of the environment variables in the following list are outmoded. The descriptions for each one indicate the preferred alternative, if one exists. |
The following environment variables are used by the I/O libraries.
FF_IO_AIO_LOCKS, FF_IO_AIO_NUMUSERS, FF_IO_AIO_THREADS | |
Specifies aspects of the aioinit structure. This structure contains the following fields: aio_locks, aio_numusers, and aio_threads. These environment variables alter the values used for these fields. For more information on using these environment variables, see AIO_SGI_INIT(3) man page. | |
FF_IO_LOGFILE | |
Names a file to which statistics are written by the event FFIO layer. | |
FILENV | |
Specifies the location of the assign environment information. Use FILENV to assign a file name to store the assign information or to specify that it be stored in the process environment. |
The following miscellaneous environment variables also affect compiling.
COMPILER_DEFAULTS_PATH | |
Specifies the a path or a colon-separated list of paths designating where the compiler is to look for the compiler.defaults file. | |
F2CFLAGS | |
Controls the Fortran-to-C interface. As a value for this environment variable, specify options to the mkf2c(1) command. | |
FORMAT_TYPE_CHECKING | |
F90_BOUNDS_CHECK_ABORT | |
Controls whether the compiler aborts execution if a bounds check fails. The f90 -C option performs array bounds checking. By default, execution continues even if the bounds check fails. To cause the compiler to abort on a failed bounds check, set the F90_BOUNDS_CHECK_ABORT environment variable to YES. | |
LD_LIBRARY_PATH, LD_LIBRARY64_PATH, and LD_LIBRARYN32_PATH | |
Specifies the default library search path. This differs depending on the ABI being used. For more information on these environment variables, see rld(5). | |
LISTIO_PRECISION | |
Controls the number of digits of precision printed by list-directed output. | |
NLSPATH | |
Affects interactions with the message system. For more information, see catopen(3c). | |
SGI_ABI | |
Specifies the Application Binary Interface (ABI) used during compilation. This environment variable can be used to change the default ABI. Specify -o32, -n32, or -64 as values. | |
SGI_CC | |
Specifies the default C compile mode. This environment variable can be set to any one of ansi, cckr (cc only), or xansi, and is interpreted as an option before any other options specified on the command line. | |
TMPDIR | |
Specifies a path for temporary files. When set, the value used is the directory in which the system places temporary files, rather than the default, /tmp. | |
TRAP_FPE | |
Controls the handling and classifying of floating-point exceptions and substitutes new values. It also provides a mechanism to count, trace, exit, or abort on enabled exceptions. The -TENV:check_div option on the command line inserts checks for divide by zero and for overflow. See FSIGFPE(3f) for information on HANDLE_FSIGFPES, which performs a function similar to that of this environment variable. | |
_XPG | |
Specifies that compilation should proceed according to X/Open XPG4 specifications. If set, cc or f77 (c89 or fort77, as they are known under XPG4, respectively) operates in conformance with the X/Open XPG4 specifications. The options and the command line behavior may differ in accordance to the XPG4 standards. | |
ZERO_WIDTH_PRECISION | |
Sets the default size of the fractional field using real formating specifications. |
You can also set an environment variable to specify the compilation mode:
setenv SGI_ABI -n32 | |
Sets the environment for new 32-bit compilation. | |
setenv SGI_ABI -64 | |
Sets the environment for 64-bit compilation. | |
setenv SGI_ABI -o32 | |
Sets the environment for old 32-bit compilation. |
SpeedShop is a tool used to help you analyze compiler performance on IRIX systems.
_SPEEDSHOP_VERBOSE | |
Causes a log of each program's operation to be written to stderr. If this variable is set to an empty string, only major events are logged; if it is set to a non-empty string, more detailed events are logged. | |
_SPEEDSHOP_SILENT | |
Suppresses all SpeedShop output other than fatal error messages. If both _SPEEDSHOP_VERBOSE and _SPEEDSHOP_SILENT are set, _SPEEDSHOP_VERBOSE is ignored. | |
_SPEEDSHOP_CALIPER_POINT_SIG sig_num | |
Causes the specified signal number to be used for recording a caliper point in the experiment. | |
_SPEEDSHOP_REUSE_FILE_DESCRIPTOR | |
Opens and closes the file descriptors for the output files every time performance data is to be written | |
_SPEEDSHOP_HWC_COUNTER_NUMBER | |
Specifies the counter to be used for prof_hwc experiments. Counters are numbered between 0 and 31, Counter 0 counters are numbered 0-15, and counter 1 counters are numbered 16-31. | |
_SPEEDSHOP_HWC_COUNTER_OVERFLOW | |
Specifies the overflow value for the counter to be used in prof_hwc experiments. The value chosen can be any number greater than 0. Some choices may produce data that is not statistically random but reflects a correlation between the overflow interval and a cyclic behavior in the application. Users may want to do two or more runs with different overflow values. | |
_SPEEDSHOP_OUTPUT_NOCOMPRESS | |
_SPEEDSHOP_OUTPUT_DIRECTORY | |
Causes the output data files to be placed in the specified directory rather than the current working directory | |
_SPEEDSHOP_OUTPUT_FILENAME | |
Causes the output file to be saved under the specified name. If set to myfile, the experiment file is named myfile.suffix (for example, myfile.m12345). If _SPEEDSHOP_OUTPUT_DIRECTORY is also specified, the directory is prepended to the file name you specify. |
_SPEEDSHOP_TRACE_FORK | |
If True, specifies that processes spawned by calls to fork() will be monitored if they do not call exec(). If they do call exec() and _SPEEDSHOP_TRACE_FORK_TO_EXEC is not set to True, the data covering the time between the fork() and exec() will be discarded. Default: true. | |
_SPEEDSHOP_TRACE_FORK_TO_EXEC | |
If True, specifies that a process spawned by calls to fork() will be monitored, even if they also call exec(). Default: false. | |
_SPEEDSHOP_TRACE_EXE | |
If True, specifies that a process spawned by calls to any of the various flavors of exec() will be monitored. Default: true. | |
_SPEEDSHOP_TRACE_SPROC | |
If True, specifies that a process spawned by calls to sproc() will be monitored. Default: true. | |
_SPEEDSHOP_TRACE_SYSTEM | |
If True, specifies that system() calls will be monitored. Default: true. |
A number of variables may be used for debugging and finer control of the operation of SpeedShop:
_SPEEDSHOP_SAMPLING_MODE | |
Used for PC sampling and hardware counter profiling. If set to 1, generates data for the base executable only. If not set or set to a value other than 1, data is generated for the executable and all the DSOs it uses. | |
_SPEEDSHOP_INIT_DEFERRED_SIG | |
If specified, initialization of the experiment is not performed when the target process starts. Initialization is delayed until the specified signal is sent to the process. A handler for the given signal is installed when the process starts. It is the user's responsibility to ensure that it is not overridden by the target code. | |
_SPEEDSHOP_SHUTDOWN_SIG | |
If specified, termination of the experiment is not performed when the target process exits. Termination happens when the specified signal is sent to the process. A handler for the given signal is installed when the process starts, and it is the user's responsibility to ensure that it is not overridden by the target code. | |
_SPEEDSHOP_EXPERIMENT_TYPE | |
Passes the name of the experiment to the run-time DSO. It is normally set by ssrun but can be overwritten. | |
_SPEEDSHOP_MARCHING_ORDERS | |
Passes the marching orders of the experiment to the run-time DSO. The marching orders are usually set by ssrun from the experiment type, but they can be overwritten. | |
_SPEEDSHOP_SBRK_BUFFER_LENGTH | |
Defines the maximum size of the internal malloc (memory allocation) area used. This area is completely separate from the user's area and has a default size of 0x100000. | |
_SPEEDSHOP_FILE_BUFFER_LENGTH | |
Defines the size of the buffer used for writing the experiment files. The default length is 8 KB. The buffer is used only for writing small records to the file; large records are written directly to avoid the buffering overhead. | |
_SPEEDSHOP_DEBUG_NO_SIG_TRAPS | |
Disables the normal setting of signal handlers for all fatal and exit signals. | |
_SPEEDSHOP_DEBUG_NO_STACK_UNWIND | |
Suppresses the stack unwind, as in usertime experiments and at caliper samples, for all experiments. The option is used as a workaround for various unwind bugs in libexc. |