編譯mapfile作用

㈠ c++程序編譯後自動生成的文件有什麼用，分別解釋下

1， PCH文件

預編譯頭文件(一般擴展名為.PCH),是把一個工程中較穩定的代碼預先編譯好放在一個文件(.PCH)里.這些預先編譯好的代碼可以是任何的C/C++代碼--甚至可以是inline函數,只它們在整個工程中是較為穩定的,即在工程開發過程中不會經常被修改的代碼.

為什麼需要預編譯頭文件?一言以蔽之:提高編譯速度.一般地,編譯器以文件為單位編譯,如果修改了一工程中的一個文件則所有文件都要重新編譯,包括頭文件里的所有東西(eg.Macro宏,Preprocessor預處理),而VC程序中,這些頭文件中所包括的東西往往是非常大的,編譯之將占很長的時間.但它們又不常被修改,是較穩定的,為單獨的一個小文件而重新編譯整個工程的所有文件導致編譯效率下降,因此引入了.PCH文件.

如何使用預編譯頭文件以提高編譯速度?要使用預編譯頭文件,必須指定一個頭文件(.H),它包含我們不會經常修改的代碼和其他的頭文件,然後用這個頭文件(.H)來生成一個預編譯頭文件(.PCH)VC默認的頭文件就是StdAfx.h,因為頭文件是不能編譯的,所以我們還需要一個.CPP文件來作橋梁,VC默認的文件為StdAfx.cpp,這個文件里只有一句代碼就是:＃include "StdAfx.h".接下來要用它生成.PCH文件,涉及到幾個重要的預編譯指令:/Yu,/Yc,/Yx,/Fp.簡單地說,/Yc是用來生成.PCH文件的編譯開關.在Project->setting->C/C++的Category里的Precompiled Header,然後在左邊的樹形視圖中選擇用來編譯生成.PCH文件的.CPP文件(默認即StdAfx.cpp)你就可以看到/Yc這個開關,它表示這個文件編譯了以後是否生成.PCH文件(可能/Yc的c表示create)./Fp指令指定生成的.PCH文件的名字及路徑(可能/Fp的p代表path)./Yu的u即use使用,工程中只要包括了.H文件的文件都會有這個/Yu指令.如果選擇自動Automatic...的話則原來為/Yc的地方就換成了/Yx指令.如果選擇自動,則每次編譯時編譯器會看以前有沒有生成過.PCH文件,有則不現生成否則就再次編譯產生.PCH文件.

注意:

A,實際上,由Appzard項目向導生成的默認的頭文件及CPP文件StdAfx.h和StdAfx.cpp可以是任何名字的.原因很簡單.但如果你要這樣做就要記得修改相應的Project->setting...下的幾個預編譯指令(/Yc,/Yu,/Yx,/Fp)的參數.

B.在任何一個包括了將要預編譯的頭文件而使用了.PCH文件的工程文件的開頭,一定必須要是在最開頭,你要包含那個指定生成.PCH文件的.H文件(通過.CPP文件包括,默認為StdAfx.cpp),如果沒包括將產生我最開頭產生的錯誤.如果不是在最開頭包括將產生讓你意想不到的莫名其妙錯誤,如若不信,盍為試之?

C.預編譯文件.PCH生成之很耗時間,而且生成之後它也很占磁碟空間,常在5-6M,注意項目完成之後及時清理無用的.PCH文件以節約磁碟空間.

D.如果丟了或刪了.PCH文件而以後要再修改工程文件時,可將指定的/Yc的.CPP文件(默認為StdAfx.cpp)重新編譯一次即可再次生成.PCH文件,不用傻傻的按F7或Rebuild All

2， NCB文件

.ncb 無編譯瀏覽文件(no compile browser)。當自動完成功能出問題時可以刪除此文件。build後會自動生成

3， OBJ文件

目標文件，一般是程序編譯後的二進制文件，再通過鏈接器和資源文件鏈接就成exe文件了。

OBJ只給出了程序的相對地址，而EXE是絕對地址。

4， PDB文件

程序資料庫 (PDB) 文件保存著調試和項目狀態信息，使用這些信息可以對程序的調試配置進行增量鏈接。當以 /ZI 或 /Zi（用於 C/C++）生成時，將創建一個 PDB 文件。

在 Visual C++ 中，/Fd 選項用於命名由編譯器創建的PDB 文件。當使用向導在Visual Studio 中創建項目時，/Fd 選項被設置為創建一個名為 project.PDB 的 PDB。

如果使用生成文件創建 C/C++ 應用程序，並指定 /ZI 或 /Zi 而不指定 /Fd 時，則最終將生成兩個 PDB 文件：

*VC80.PDB （更籠統地說就是 VCx0.PDB，其中 x 表示 Visual C++ 的版本。）該文件存儲各個 OBJ 文件的所有調試信息並與項目生成文件駐留在同一個目錄中。

*project.PDB 該文件存儲 .exe 文件的所有調試信息。對於C/C++，它駐留在 \debug 子目錄中。

每當創建 OBJ 文件時，C/C++ 編譯器都將調試信息合並到 VCx0.PDB 中。插入的信息包括類型信息，但不包括函數定義等符號信息。因此，即使每個源文件都包含公共頭文件（如 <windows.h>），這些頭文件中的 typedef 也只存儲一次，而不是在每個 OBJ 文件中都存在。

鏈接器將創建 project.PDB，它包含項目的 EXE 文件的調試信息。project.PDB文件包含完整的調試信息（包括函數原型），而不僅僅是在 VCx0.PDB 中找到的類型信息。這兩個 PDB 文件都允許增量更新。鏈接器還在其創建的 .exe 或 .dll 文件中嵌入 .pdb 文件的路徑。

Visual Studio 調試器使用 EXE 或 DLL 文件中的PDB 路徑查找 project.PDB 文件。如果調試器在該位置無法找到 PDB 文件或者如果路徑無效（例如，如果項目被移動到了另一台計算機上），調試器將搜索包含 EXE 的路徑，即在「選項」對話框（「調試」文件夾，「符號」節點）中指定的符號路徑。調試器不會載入與所調試的二進制不匹配的 PDB。

5， ILK文件

在增量鏈接時，LINK 更新在第一次增量鏈接期間創建的 .ilk 狀態文件。該文件和 .exe文件或 .dll 文件具有相同的基名稱，並具有擴展名 .ilk。在後面的增量鏈接期間，LINK 更新 .ilk 文件。如果缺少 .ilk 文件，則 LINK 執行完全鏈接並創建新的 .ilk 文件。如果 .ilk 文件無法使用，則 LINK 執行非增量鏈接。有關增量鏈接的詳細信息，請參見漸進式鏈接(/INCREMENTAL) 選項。

6， MAP文件

Windows和linux系統下都有map文件，map文件一般是用來保存符號的地址信息。這里的符號一般是指函數名及變數（局部、全局）。根據這個地址信息，便可以把地址翻譯成相應的符號，很多系統工具、debug方法都要用到這種信息。

（一）一個程序編譯完以後內容會分成兩大類保存，一類是code，一類是data：

（1）code指程序代碼，常存在.text section

（2）data指存程序中聲明的變數，常存在.data section，未初始化的變數會被存在.bss section。

（二）Windows

（1）單個模塊的map文件

在Windows下每一個模塊（dll/exe）對應一個map文件，只需編譯時打開相應的選項即可。

visual studio中方法：右擊工程，選擇Properties，然後選擇 Configuration Properties -Linker - Debugging，將Generate Map File項改成Yes。

編譯後在debug/release目錄里便可以找到與應用程序同名的map文件。

如下為map文件內容：

Timestamp is4b9603e2 (Tue Mar 09 16:16:34 2010) //這個是時間戳，每次編譯都不同，後面符號對應的地址一般也不同。

Preferred loadaddress is 00010000 //這是編譯時的預裝載地址，實際上模塊被載入的地址可能跟這個不同，所以來確定某個地址對應哪個符號信息的時候，還需要知道該模塊載入在內存的真正起始地址，然後根據偏移量來確定。

Start Length Name Class

0001:00000000 001c3950H .text CODE ==》存放程序代碼

0003:000008b8000af67cH .data DATA ==》初始化的變數

0003:000aff40003930b1H .bss DATA ==》未初始化的變數

（2）操作系統總的map文件：不知道有沒有。

（3）mpbin

mpbin是一個反匯編工具，可以輸出exe/dll文件的許多信息。

mpbin /allyourmolename > a.txt 可以把所有的信息保存在一個a.txt中，裡面可以找到時間戳、原debug路徑信息及函數列表等。

如下：

FILE HEADERVALUES

1C2 machine (Thumb)

6 number of sections

49EC0BAE time date stamp Mon Apr 2013:44:14 2009 //時間戳

0 file pointer to symbol table

0 number of symbols

E0 size of optional header

2102 characteristics

Executable

32 bit word machine

DLL

OPTIONAL HEADERVALUES

10B magic # (PE32)

9.00 linker version

53E00 size of code

76A00size of initialized data

0 size of uninitialized data

502ACentry point (100502AC)

1000 base of code

55000 base of data

10000000 image base (10000000 to100CDFFF)

1000 section alignment

200 file alignment

5.01 operating system version

0.00 image version

5.01 subsystem version

0 Win32 version

CE000 size of image

400 size of headers

其中 10000000 image base (10000000 to 100CDFFF)是重要的信息，與map file中的 Preferred load address is10000000 意義相同。

DebugDirectories

Time Type Size RVA Pointer

-------- ------ -------- -------- --------

49EC0BAE cv 81 000020FC CFC Format: RSDS, {A5C699F0-C26D-427E-BC54-3504731BA9B8}, 1,d:\Projects\Final\MyUsbToPc_CPL\MyUsbToPc\Windows Mobile 6 Professional SDK(ARMV4I)\Debug\MyUsbToPc.pdb //原編譯路徑

Begin End Prolog Excpt 32bit Fixup 【Function Name】

0000000010001000 10001040 10001010 N Y Y DllMain

0000000810001040 10001064 10001050 N Y Y ?InitApplet@@YAHPAUHWND__@@@Z (int __cdecl InitApplet(struct HWND__*))

0000001010001064 10001068 10001064 N Y Y ?TermApplet@@YAXXZ (void __cdecl TermApplet(void))

0000001810001068 100013DC 10001078 N Y Y CPlApplet

00000020 1000141C 100014B4 10001420 N Y Y _DllMainCRTStartup

00000028100014B4 100014BC 100014B4 N Y Y GetCurrentProcess

00000030100014BC 100014F0 100014C0 N Y Y

00000038 100014F0 1000155C 100014F4 N Y Y _cinit

00000040 1000155C 10001660 10001560 N Y Y

0000004810001660 10001678 10001664 N Y Y exit

0000005010001678 10001690 1000167C N Y Y _exit

0000005810001690 100016AC10001694 N Y Y _cexit

00000060 100016AC 100016F8 100016B0 N Y Y _c_exit

begin欄對應的地址與map里的地址是一致的，非常類似於map文件。

【注意：很多exe或dll在編譯時時將此信息隱藏的，Function Name會變成空的】

（三）Linux

（1）單個模塊的map文件

暫還不清楚，大家知道的請告知。

（2）操作系統總的map文件

linux系統編譯Image後會生成一個system.map，裡面存了被編譯進內核的符號信息，不同次的編譯生成的system.map會有差異。

因為是操作系統的符號信息，裝載的地址都是固定的，所以不像windows單個模塊那樣靠偏移量定位，直接通過地址就可以直接找到對應的符號。

其內容的重要的幾個符號如下：

_stext//代碼段開始

_etext//代碼段結束

__data_start//初始化的數據開始

_edata//初始化的數據結束

__bss_start//未初始化數據開始

_end//全部結束

Linux相對windows有個很重要的不同是，linux啟動後在proc\kallsyms里也有一份類似Map文件的信息，cat命令可看到其內容，有了這個就可以得到任何一個內核的符號（變數及函數名）的地址信息，而不需要在編譯完內核後特意保存map文件，這真是一個巨大的寶藏。

而且，proc\kallsym的信息比system.map多，在最後會有mole部分的符號信息，這些信息會隨著系統的變化而變化。

（3）nm命令

nm命令用來顯示某個可執行文件的符號信息。符號信息中會包含全局變數（比如下面的xyz）和函數名（比如下面的main），還有一些編譯器插入的符號（比如下面的__data_start,__bss_start）

第二列表示符號的屬性，其中大寫代表global，小寫代表local

Usage: nm[option(s)] [file(s)]

List symbols in[file(s)] (a.out by default).

示例：

nm helo

08049f20 d_DYNAMIC

08049ff4 d_GLOBAL_OFFSET_TABLE_

080484ec R_IO_stdin_used

w _Jv_RegisterClasses

08049f10 d__CTOR_END__

08049f0c d__CTOR_LIST__

08049f18 D__DTOR_END__

08049f14 d__DTOR_LIST__

08048500 r__FRAME_END__

08049f1c d__JCR_END__

08049f1c d__JCR_LIST__

0804a020 A__bss_start

0804a00c D__data_start

080484a0 t __do_global_ctors_aux

08048340 t__do_global_dtors_aux

0804a010 D__dso_handle

w __gmon_start__

0804849a T __i686.get_pc_thunk.bx

08049f0c d__init_array_end

08049f0c d__init_array_start

08048430 T__libc_csu_fini

08048440 T__libc_csu_init

U __libc_start_main@@GLIBC_2.0

0804a020 A _edata

0804a028 A _end

080484cc T _fini

080484e8 R_fp_hw

08048298 T _init

08048310 T_start

0804a020 bcompleted.6635

0804a00c Wdata_start

0804a024 bdtor_idx.6637

080483a0 t frame_mmy

080483c4 T main

U printf@@GLIBC_2.0

0804a014 D x

0804a018 D y

0804a01c D z

helo.c如下：

#include<stdio.h>

int x = 10;

int y = 20;

int z = 30;

extern int__data_start;//這里引用了編譯器插入的符號

int main(void)

{

int *ds = &__data_start;

printf("%p\n", ds);

printf("now x = %d\n", x);

ds+=3;

*ds = 100;

printf("now x = %d\n", x);

}

7， IDB文件

The compiler savesstate information from the first compile in the project』s .IDB file (the default name is project.IDB or VC60.IDBfor files compiled without a project).

The compiler usesthis state information to speed subsequent compiles.

8， SLN文件

Visual Studio.Solution 通過為環境提供對項目、項目項和解決方案項在磁碟上位置的引用，可將它們組織到解決方案中。

㈡ Delphi的命令行編譯命令

Borland出品的Delphi，有著閃電般的編譯速度，但是在界面控制項使用較多、工程項目較大的時候，編譯一個工程仍需要一段時間，打開龐大的Delphi IDE，也需要時間。其實，在一個工程開發結束，調試完成之後的Release編譯，完全可以用命令行來執行，因為Delphi的編譯器參數不像C++編譯器那樣復雜。

筆者把Delphi聯機手冊中關於命令行編譯(command-line compiler)的幾篇主題作了翻譯，希望對Delphi開發人員有幫助。

目錄
1. Command-line compiler
命令行編譯器
2. Command-line compiler options
命令行編譯器選項
3. Compiler directive options
編譯器指令選項
4. Compiler mode options
編譯模式選項
5. DCC32.CFG file
編譯器配置文件DCC32.CFG
6. Debug options
調試選項
7. Directory options
目錄選項
8. IDE command-line options
IDE命令行選項
9. Generated files
幾個IDE自動生成的文件介紹

Command-line compiler
命令行編譯器
Delphi's command-line compiler (dcc32.EXE) lets you invoke all the functions of the IDE compiler (DELPHI32.EXE) from the DOS command line (see IDE command-line options. Run the command-line compiler from the DOS prompt using the syntax:
Delphi』s命令行編譯器(dcc32.exe)允許你從DOS命令行方式(參照：IDE命令行選項)實現IDE編譯器(delphi32.exe)的所有功能。用DOS命令運行命令行編譯器語法如下：
dcc32 [options] filename [options]
dcc32 [選項] [文件名] [選項]
where options are zero or more parameters that provide information to the compiler and filename is the name of the source file to compile. If you type dcc32 alone, it displays a help screen of command-line options and syntax.
零或多個參數給編譯器提供信息，文件名指定需要編譯的源文件名。如果你單獨輸入dcc32，它會顯示一個關於命令行編譯的選項和語法的屏幕。
If filename does not have an extension, the command-line compiler assumes .dpr, then .pas, if no .dpr is found. If the file you're compiling to doesn't have an extension, you must append a period (.) to the end of the filename.
如果文件名沒有擴展名，命令行編譯器會查找擴展名為.dpr的同名文件，如果找不到，則查找擴展名為.pas的同名文件。如果你的源文件確實沒有擴展名，你需要在文件名的末尾添加(.)。
If the source text contained in filename is a program, the compiler creates an executable file named filename.EXE. If filename contains a library, the compiler creates a file named filename.DLL. If filename contains a package, the compiler creates a file named filename.BPL. If filename contains a unit, the compiler creates a unit file named filename.dcu.
如果指定的源文件是一個工程文件，編譯器會創建一個擴展名為.EXE的同名可執行文件。如果指定的源文件是一個庫文件，編譯器創建一個擴展名為.DLL的同名動態鏈接庫文件。如果指定的源文件是一個包文件，編譯器會創建一個擴展名為.BPL的同名包。如果指定的源文件是一個單元文件，編譯器會創建一個擴展名為.dcu的目標代碼文件。
You can specify a number of options for the command-line compiler. An option consists of a slash (/) or immediately followed by an option letter. In some cases, the option letter is followed by additional information, such as a number, a symbol, or a directory name. Options can be given in any order and can come before or after the file name.
你可以為命令行編譯器指定多個參數。一個參數包含一個破折號「-」(或「/」)和緊跟著的一個選項字元構成。通常情況下，選項字元後面會跟一些附加的信息，如一個數字、一個符號、一個目錄等。選項可以是任意順序並且可以在源文件名前面或後面。

Command-line compiler options
命令行編譯選項
The IDE lets you set various options through the menus; the command-line compiler gives you access to these options using the slash (/) delimiter. You can also precede options with a hyphen (-) instead of a slash (/), but those options that start with a hyphen must be separated by blanks. For example, the following two command lines are equivalent and legal:
IDE允許你使用菜單來設置各種編譯選項，而命令行編譯器允許你使用字元「/」作為分隔符來設定這些編譯選項。你也可以使用連字元「-」來代替「/」，但是用「-」引出的參數之間必須用空格隔開。例如，下面兩個命令都是等同的也是合法的：
DCC -IC:\DELPHI -DDEBUG SORTNAME -$R- -$U+
DCC /IC:\DELPHI/DDEBUG SORTNAME /$R-/$U+
The first command line uses hyphens with at least one blank separating options. The second uses slashes and no separation is needed.
第一個編譯命令用「-」引出參數，且參數之間有多個空格分隔。第二個編譯命令用「/」引出參數，參數之間不必要分隔。
The following table lists the command-line options. In addition to the listed options, all single-letter compiler directives can be specified on the command line, as described in Compiler directive options.
下列表中列出所有的命令行參數。在附加的選項列表中，所有的單字元編譯器指令都可以在命令行編譯中使用，詳情請參照：編譯器指令。
Option Description
選項 描述
Aunit=alias 設置單元別名
B 編譯所有單元
CC 編譯控制台程序
CG 編譯圖形界面程序
Ddefines 編譯條件符號定義
Epath 可執行文件輸出路徑
Foffset 查找運行期間錯誤
GD 生成完整.Map文件
GP 生成.Map文件Public段
GS 生成.Map文件Segment段
H 輸出提示信息
Ipaths 文件包含路徑
J 生成.Obj目標文件
JP 生成C++類型.Obj目標文件
Kaddress Set image base address
LEpath 包.BPL文件輸出路徑
LNpath .dcp文件輸出路徑
LUpackage 使用運行期間包列表
M 編譯有改動的源文件
Npath dcu/dpu文件輸出目錄
Opaths .Obj文件(匯編目標代碼文件)路徑
P 按8.3格式文件名查找
Q 安靜模式
Rpaths 資源文件(.RES)路徑
TXext 目標文件擴展名
Upaths 單元文件路徑
V 為Turbo Debugger生成調試信息文件
VN 以.Giant格式生成包含命名空間的調試信息文件(將用於C++Builder)
VR 生成調試信息文件.rsm
W 輸出警告信息
Z Disable implicit compilation
$directive Compiler directives
--Help 顯示編譯選項的幫助。同樣的，如果你在命令行單獨輸入dcc32，也會顯示編譯選項的幫助。
--version 顯示產品名稱和版本

Compiler directive options
編譯器指令選項
Delphi supports the compiler directives described in Compiler directives. The $ and D command-line options allow you to change the default states of most compiler directives. Using $ and D on the command line is equivalent to inserting the corresponding compiler directive at the beginning of each source file compiled.
Delphi支持用編譯器指令關鍵字描述的編譯器指令。使用「$」和「D」命令行選項可以改變所有的默認編譯器狀態。用「$」和「D」命令行選項等同於在源文件的前面添加編譯器指令。
Switch directive option
編譯器指令選項開關
The $ option lets you change the default state of all of the switch directives. The syntax of a switch directive option is $ followed by the directive letter, followed by a plus (+) or a minus (-). For example:
「$」允許你改變每一種編譯器指令默認狀態。編譯器指令的語法是「$」後緊跟一個指令字元，再跟一個「-」或「+」。例如：
dcc32 MYSTUFF -$R-
compiles MYSTUFF.pas with range-checking turned off, while:
不使用邊界檢查編譯MYSTUFF.pas單元：
dcc32 MYSTUFF -$R+
compiles it with range checking turned on. Note that if a {$R+} or {$R-} compiler directive appears in the source text, it overrides the -$R command-line option.
使用界面檢查編譯MYSTUFF.pas單元。如果將編譯器指令{$R+}或{$R-}添加到源文件的開始，它將覆蓋從命令行傳入的參數。
You can repeat the -$ option in order to specify multiple compiler directives:
你可以用多個「$」來指定多個編譯器指令，如：
dcc32 MYSTUFF -$R--$I--$V--$U+
Alternately, the command-line compiler lets you write a list of directives (except for $M), separated by commas:
命令行編譯器允許作用逗號分隔的編譯器指定列表，如：
dcc32 MYSTUFF -$R-,I-,V-,U+
只需要用一個「$」符號。
Only one dollar sign ($) is needed.
注意，因為$M的格式不一樣，你不能在逗號分隔的指令列表中使用$M
Note that, because of its format, you cannot use the $M directive in a list of directives separated by commas.
Conditional defines option
條件編譯選項
The -D option lets you define conditional symbols, corresponding to the {$DEFINE symbol} compiler directive. The -D option must be followed by one or more conditional symbols separated by semicolons (;). For example, the following command line:
「-D」選項允許你定義一個編譯條件，符合你用{$DEFINE symbol}定義的編譯器指令。「-D」選項後必須跟隨一或多個用分號分隔的編譯條件符號，如下命令：
dcc32 MYSTUFF -DIOCHECK;DEBUG;LIST
defines three conditional symbols, iocheck, debug, and list, for the compilation of MYSTUFF.pas. This is equivalent to inserting:
定義了三個編譯條件符號：IOCHECK,DEBUG,LIST,用於MYSTUFF.pas單元中。這等同於在源文件中插入以下語句：
{$DEFINE IOCHECK}
{$DEFINE DEBUG}
{$DEFINE LIST}
at the beginning of MYSTUFF.pas. If you specify multiple -D directives, you can concatenate the symbol lists. Therefore:
如果你指定了多個「-D」選項，你可以聯接它們，如下：
dcc32 MYSTUFF -DIOCHECK-DDEBUG-DLIST

is equivalent to the first example.
等同於第一個例子。

Compiler mode options
編譯模式選項
A few options affect how the compiler itself functions. As with the other options, you can use these with either the hyphen or the slash format. Remember to separate the options with at least one blank.
有幾個選項能影響編譯器自身的功能。像其它選項一個，你可以使用「/」或「-」的格式。別忘了用至少一個空格分隔這些選項。
Make (-M) option
選項(-M)
The command-line compiler has built-in MAKE logic to aid in project maintenance. The -M option instructs command-line compiler to check all units upon which the file being compiled depends. Using this option results in a much quicker compile time.
命令行編譯器使用構造邏輯的方式來維護工程。「-M」選項指示編譯器檢查所有與編譯文件相關聯的文件。用這個參數會導致編譯時間增大。
A unit is recompiled under the following conditions:
一個源文件在下列情況下會重新編譯：
The source file for that unit has been modified since the unit file was created.
源文件被創建以來被修改過；
用「$I」指令包含的任何文件，用「$L」包含的任何.Obj文件，或用「$R」關聯的任何資源文件.Res,比源文件中的要新；
Any file included with the $I directive, any .OBJ file linked in by the $L directive, or any .res file referenced by the $R directive, is newer than the unit file.
The interface section of a unit referenced in a uses statement has changed.
單元介面部分interface的uses段有改動。
Units compiled with the -Z option are excluded from the make logic.
在單元編譯時指令「-Z」在構造邏輯期不被接受。
If you were applying this option to the previous example, the command would be:
如果你在上一個例子中使用這個指令，編譯命令就應該是：
dcc32 MYSTUFF -M
Build all (-B) option
編譯所有 選項(-B)
Instead of relying on the -M option to determine what needs to be updated, you can tell command-line compiler to update all units upon which your program depends using the -B option. You can't use -M and -B at the same time. The -B option is slower than the -M option and is usually unnecessary.
用於取代要知道哪些單元需要更新-M的選項，你可以使用-B選項來更新所有你的程序中關聯的單元。你不能在程序中同時使用-M和-B。選項-B比-M速度更慢，而且它並不是必需的。
If you were using this option in the previous example, the command would be
如果你在前一個例子中使用這個參數，編譯命令就應該是：
dcc32 MYSTUFF -B
Find error (-F) option
查找錯誤 選項(-F)
When a program terminates e to a runtime error, it displays an error code and the address at which the error occurred. By specifying that address in a -Faddress option, you can locate the statement in the source text that caused the error, provided your program and units were compiled with debug information enabled (via the $D compiler directive).
當一個程序由於運行期間錯誤而終止時，它會顯示一個錯誤號和錯誤地址在錯誤發生時。用-Faddress選項來指定錯誤地址，你在源文件中能找到引發錯誤的位置，如果你的程序和單元編譯時附加了調試信息(使用$D編譯器指令)。
In order for the command-line compiler to find the runtime error with -F, you must compile the program with all the same command-line parameters you used the first time you compiled it.
為了命令行編譯器能用-F選項查找運行期間錯誤，你必須傳遞與第一次編譯時相同的指令列表。
As mentioned previously, you must compile your program and units with debug information enabled for the command-line compiler to be able to find runtime errors. By default, all programs and units are compiled with debug information enabled, but if you turn it off, using a {$D-} compiler directive or a -$D- option, the command-line compiler will not be able to locate runtime errors.
先前提到過，你的程序和單元必須啟用調試信息，命令行編譯器才能查找運行期間錯誤。默認情況下，所有的程序和單都是啟用調試信息的，除非你用{-D}或-$D-指令關閉它，這樣，命令行編譯器就不能查找運行期間錯誤了。
Use packages (-LU) option
使用包(-LU)選項
Use the -LU option to list additional runtime packages that you want to use in the application being compiled. Runtime packages already listed in the Project Options dialog box need not be repeated on the command line.
使用-LU選項來在編譯時添加你應用程序中要用到的運行期間包。運行期間包已經在「工程選項」對話框中列舉的，不必再在命令行中添加。
Disable implicit compilation (-Z) option
(此選項在delphi6.0/7.0中有不同描述，在此不作翻譯)
The -Z option prevents packages and units from being implicitly recompiled later. With packages, it is equivalent to placing {$ IMPLICITBUILD OFF} in the .dpk file. Use -Z when compiling packages that provide low-level functionality, that change infrequently between builds, or whose source code will not be distributed.
Target file extension (-TX) option
目標文件擴展名(-TX)選項
The -TX option lets you override the default extension for the output file. For example,
選項-TX允許你改寫默認的輸出文件擴展名。例如：
dcc32 MYSTUFF -TXSYS
generates compiled output in a file called MYSTUFF.SYS.
生成的將是一個叫做MYSTUFF.SYS的文件。
Quiet (-Q) option
安靜模式(-Q)選項
The quiet mode option suppresses the printing of file names and line numbers ring compilation. When the command-line compiler is invoked with the quiet mode option
安靜模式選項禁止在編譯時顯示文件名及代碼行數，如果命令行編譯器調用這個選項的話。
dcc32 MYSTUFF -Q its output is limited to the startup right message and the usual statistics at the end of compilation. If any errors occur, they will be reported.

它的輸出僅限於起始時行版權信息以及結尾的統計信息。當然，如果發生錯誤，它也會輸出。

DCC32.CFG file
DCC32.CFG配置文件
You can set up a list of options in a configuration file called DCC32.CFG, which will then be used in addition to the options entered on the command line. Each line in configuration file corresponds to an extra command-line argument inserted before the actual command-line arguments. Thus, by creating a configuration file, you can change the default setting of any command-line option.
你可以設置一個編譯選項列表到一個叫做DCC32.CFG的配置文件中，它將用於編譯時附加到命令行參數後。配置文件的每一行都相當於一個額外的命令行參數插入到實際的命令行參數前(注意，是實際參數前)。因而，你可以使用這個配置文件改變一些命令行參數的默認設置。
The command-line compiler lets you enter the same command-line option several times, ignoring all but the last occurrence. This way, even though you've changed some settings with a configuration file, you can still override them on the command line.
命令行編譯器允許你輸入相同的命令行參數，它將忽略所有除最後一個之外。這個的話，盡管通過配置文件你可以改變一些設置，你仍然可以覆蓋它使用命令行參數。
When dcc32 starts, it looks for DCC32.CFG in the current directory. If the file isn't found there, dcc32 looks in the directory where DCC32.EXE resides.
當dcc32啟動時，它查找DCC32.CFG文件在當前目錄。如果文件沒有找到，dcc32會查找它所在的目錄。
Here's an example DCC32.CFG file, defining some default directories for include, object, and unit files, and changing the default states of the $O and $R compiler directives:
以下是一個DCC32.CFG配置文件的例子，定義了關於文件包含、OBJ文件包含、單元文件搜索路徑信息，並改變了編譯器指令$O和$R的默認值。
-IC:\DELPHI\INC;C:\DELPHI\SRC
-OC:\DELPHI\ASM
-UC:\DELPHI\UNITS
-$R+
-$O-
Now, if you type:
現在，如果你輸入：
dcc32 MYSTUFF
the compiler performs as if you had typed the following:
編譯器把它當作你輸入如下命令：
dcc32 -IC:\DELPHI\INC;C:\DELPHI\SRC -OC:\DELPHI\ASM -UC:\DELPHI\UNITS -$R+ -$O- MYSTUFF

Debug options
調試選項
The compiler has two sets of command-line options that enable you to generate external debugging information: the map file options and the debug info options.
編譯器有兩個命令行參數可以生成外部調試信息:MAP文件選項和調試信息選項。
Map file (-G) options
Map文件(-G)選項
The -G option instructs the command-line compiler to generate a .map file that shows the layout of the executable file. Unlike the binary format of executable and .dcu files, a .map file is a legible text file that can be output on a printer or loaded into the editor. The -G option must be followed by the letter S, P, or D to indicate the desired level of information in the .map file. A .MAP file is divided into three sections:
選項-G指示命令行編譯器生成一個.map文件來查看一個可執行文件的布局。不同於可二進制的可執行文件和.dcu文件，.map文件是一個可讀的文本文件，可以被列印或是其它文本編輯器編輯。選項-G後必須跟字元S、P或D，去決定你想要在.map文件列出的信息。一個.MAP文件被分成三個節：
Segment
Publics
Line Numbers
-GS outputs only the Segment section, -GP outputs the Segment and Publics section, and -GD outputs all three sections. -GD also generates a .DRC file that contains tables of all string constants declared using the resourcestring keyword.
-GS選項只輸出Segment Section,-GS選項輸出Segment和Publics,-GD輸出所有的三個Sections.-GD選項也生成一個擴展名為.DRC的文件包含所有的用resourcestring關鍵字聲明的字元串常量。
For moles (program and units) compiled in the {$D+,L+} state (the default), the Publics section shows all global variables, proceres, and functions, and the Line Numbers section shows line numbers for all proceres and functions in the mole. In the {$D+,L-} state, only symbols defined in a unit's interface part are listed in the Publics section. For moles compiled in the {$D-} state, there are no entries in the Line Numbers section.
用默認的編譯選項{$D+,L+}編譯模塊(程序或單元)，Publics Section列舉所有的全局變數、過程和函數，Line Numbers Section列舉模塊中所有的過程和函數的行號。如果用{$D+,L-}編譯選項編譯模塊，Publics Section中僅列舉在單元的interface部分定義的符號。如果用{$D-}選項編譯模塊，在Line Numbers Section沒有任何入口。
Debug info (-V) options
調度選項(-V)
The -V options (-V, -VN. and -VR), which cause the compiler to generate debug information, can be combined on the command line.
選項-V、-VN、-VR會指示編譯器生成調試信息，它們能在命令行中組合使用。
Generate Turbo Debugger debug info (-V) option
生成Turbo Debugger使用的調試信息的選項(-V)
When you specify the -V option on the command line, the compiler appends Turbo Debugger 5.0-compatible external debug information at the end of the executable file. Turbo Debugger includes both source- and machine-level debugging and powerful breakpoints.
當你在命令行中使用-V選項時，編譯器會在可執行文件的末尾附加與Turbo Debugger5.0一致的外部調試信息。Turbo Debugger包含代碼和硬體級別的強大的斷點。
Even though the debug information generated by -V makes the resulting executable file larger, it does not affect the actual code in the executable, and does not require additional memory to run the program.
雖然附加調試信息到查執行文件中會使可執行文件增大，但是它並不影響實際可執行文件中的可執行代碼，也不需要額外的內存來啟動程序。
The extent of debug information appended to the executable file depends on the setting of the $D and $L compiler directives in each of the moles (program and units) that make up the application. For moles compiled in the {$D+,L+} state, which is the default, all constant, variable, type, procere, and function symbols are known to the debugger. In the {$D+,L-} state, only symbols defined in a unit's interface section are known to the debugger. In the {$D-} state, no line-number records are generated, so the debugger cannot display source lines whe