To debug a program with MULTI or a debugger from another vendor, the compiler or assembler must generate information indicating source line numbers and variable data types. The options -g or -G can be passed to the compiler to generate this debug information. These options are also available in the MULTI Builder's File Options window, labeled Debug Level. The selection Plain corresponds to -g, and the selection MULTI corresponds to -G.
Before a program can be debugged with MULTI, the mtrans utility program collects the information in the .dbg files into a .sym file. The Builder or Driver usually invokes mtrans just after the program is linked. However, if MULTI is debugging a program prog, MULTI looks for prog.sym in the same directory. If MULTI doesn't find prog.sym, it invokes mtrans to create the file.
mtrans uses the symbol table information in the executable program to find all of the .dbg files. If the .dbg files have been moved, mtrans might not be able to locate them. In this case, the option may be passed to mtrans to indicate additional directories where the .dbg files may be found:
-dbgpath=dir[:dir][:dir][...]
This option is rarely needed and should only be used if mtrans indicates that .dbg files are not found.