http://publib.boulder.ibm.com/infocenter/systems/index.jsp?topic=/com.ibm.aix.cmds/doc/aixcmds1/ar.htm
當我們的程序中有經常使用的模塊，而且這種模塊在其他程序中也會用到，這時按照軟件重用的思想，我們應該將它們生成庫，使得以后編程可以減少開發代碼量。這里介紹兩個命令ar和nm，用來對庫操作。
1.ar基本用法
2.nm基本用法命令
當我們的程序中有經常使用的模塊，而且這種模塊在其他程序中也會用到，這時按照軟件重用的思想，我們應該將它們生成庫，使得以后編程可以減少開發代碼量。這里介紹兩個命令ar和nm，用來對庫操作。
1.ar基本用法
ar命令可以用來創建、修改庫，也可以從庫中提出單個模塊。庫是一單獨的文件，里面包含了按照特定的結構組織起來的其它的一些文件（稱做此庫文件的member）。原始文件的內容、模式、時間戳、屬主、組等屬性都保留在庫文件中。
下面是ar命令的格式：
ar [-]{dmpqrtx}[abcfilNoPsSuvV] [membername] [count] archive files...
例如我們可以用ar rv libtest.a hello.o hello1.o來生成一個庫，庫名字是test，鏈接時可以用-ltest鏈接。該庫中存放了兩個模塊hello.o和hello1.o。選項前可以有‘-'字符，也可以沒有。下面我們來看看命令的操作選項和任選項。現在我們把{dmpqrtx}部分稱為操作選項，而[abcfilNoPsSuvV]部分稱為任選項。
{dmpqrtx}中的操作選項在命令中只能并且必須使用其中一個，它們的含義如下：
- d：從庫中刪除模塊。按模塊原來的文件名指定要刪除的模塊。如果使用了任選項v則列出被刪除的每個模塊。
- m：該操作是在一個庫中移動成員。當庫中如果有若干模塊有相同的符號定義(如函數定義)，則成員的位置順序很重要。如果沒有指定任選項，任何指定的成員將移到庫的最后。也可以使用'a'，'b'，或'I'任選項移動到指定的位置。
- p：顯示庫中指定的成員到標準輸出。如果指定任選項v，則在輸出成員的內容前，將顯示成員的名字。如果沒有指定成員的名字，所有庫中的文件將顯示出來。
- q：快速追加。增加新模塊到庫的結尾處。并不檢查是否需要替換。'a'，'b'，或'I'任選項對此操作沒有影響，模塊總是追加的庫的結尾處。如果使用了任選項v則列出每個模塊。 這時，庫的符號表沒有更新，可以用'ar s'或ranlib來更新庫的符號表索引。
- r：在庫中插入模塊(替換)。當插入的模塊名已經在庫中存在，則替換同名的模塊。如果若干模塊中有一個模塊在庫中不存在，ar顯示一個錯誤消息，并不替換其他同名模塊。默認的情況下，新的成員增加在庫的結尾處，可以使用其他任選項來改變增加的位置。
- t：顯示庫的模塊表清單。一般只顯示模塊名。
- x：從庫中提取一個成員。如果不指定要提取的模塊，則提取庫中所有的模塊。
下面在看看可與操作選項結合使用的任選項：
- a：在庫的一個已經存在的成員后面增加一個新的文件。如果使用任選項a，則應該為命令行中membername參數指定一個已經存在的成員名。
- b：在庫的一個已經存在的成員前面增加一個新的文件。如果使用任選項b，則應該為命令行中membername參數指定一個已經存在的成員名。
- c：創建一個庫。不管庫是否存在，都將創建。
- f：在庫中截短指定的名字。缺省情況下，文件名的長度是不受限制的，可以使用此參數將文件名截短，以保證與其它系統的兼容。
- i：在庫的一個已經存在的成員前面增加一個新的文件。如果使用任選項i，則應該為命令行中membername參數指定一個已經存在的成員名(類似任選項b)。
- l：暫未使用
- N：與count參數一起使用，在庫中有多個相同的文件名時指定提取或輸出的個數。
- o：當提取成員時，保留成員的原始數據。如果不指定該任選項，則提取出的模塊的時間將標為提取出的時間。
- P：進行文件名匹配時使用全路徑名。ar在創建庫時不能使用全路徑名（這樣的庫文件不符合POSIX標準），但是有些工具可以。
- s：寫入一個目標文件索引到庫中，或者更新一個存在的目標文件索引。甚至對于沒有任何變化的庫也作該動作。對一個庫做ar s等同于對該庫做ranlib。
- S：不創建目標文件索引，這在創建較大的庫時能加快時間。
- u：一般說來，命令ar r...插入所有列出的文件到庫中，如果你只想插入列出文件中那些比庫中同名文件新的文件，就可以使用該任選項。該任選項只用于r操作選項。
- v：該選項用來顯示執行操作選項的附加信息。
- V：顯示ar的版本。
2.nm基本用法命令
nm用來列出目標文件的符號清單。下面是nm命令的格式：
nm [-a|--debug-syms] [-g|--extern-only] [-B][-C|--demangle] [-D|--dynamic] [-s|--print-armap][-o|--print-file-name] [-n|--numeric-sort][-p|--no-sort] [-r|--reverse-sort] [--size-sort][-u|--undefined-only] [-l|--line-numbers] [--help][--version] [-t radix|--radix=radix][-P|--portability] [-f format|--format=format][--target=bfdname] [objfile...]
如果沒有為nm命令指出目標文件，則nm假定目標文件是a.out。下面列出該命令的任選項，大部分支持"-"開頭的短格式和"—"開頭的長格式。
- -A、-o或--print-file-name：在找到的各個符號的名字前加上文件名，而不是在此文件的所有符號前只出現文件名一次。
例如nm libtest.a的輸出如下：
CPThread.o:
00000068 T Main__8CPThreadPv
00000038 T Start__8CPThread
00000014 T _._8CPThread
00000000 T __8CPThread
00000000 ? __FRAME_BEGIN__
.......................................
則nm -A 的輸出如下：
libtest.a:CPThread.o:00000068 T Main__8CPThreadPv
libtest.a:CPThread.o:00000038 T Start__8CPThread
libtest.a:CPThread.o:00000014 T _._8CPThread
libtest.a:CPThread.o:00000000 T __8CPThread
libtest.a:CPThread.o:00000000 ? __FRAME_BEGIN__
..................................................................
- -a或--debug-syms：顯示調試符號。
- -B：等同于--format=bsd，用來兼容MIPS的nm。
- -C或--demangle：將低級符號名解碼(demangle)成用戶級名字。這樣可以使得C++函數名具有可讀性。
- -D或--dynamic：顯示動態符號。該任選項僅對于動態目標(例如特定類型的共享庫)有意義。
- -f format：使用format格式輸出。format可以選取bsd、sysv或posix，該選項在GNU的nm中有用。默認為bsd。
- -g或--extern-only：僅顯示外部符號。
- -n、-v或--numeric-sort：按符號對應地址的順序排序，而非按符號名的字符順序。
- -p或--no-sort：按目標文件中遇到的符號順序顯示，不排序。
- -P或--portability：使用POSIX.2標準輸出格式代替默認的輸出格式。等同于使用任選項-f posix。
- -s或--print-armap：當列出庫中成員的符號時，包含索引。索引的內容包含：哪些模塊包含哪些名字的映射。
- -r或--reverse-sort：反轉排序的順序(例如，升序變為降序)。
- --size-sort：按大小排列符號順序。該大小是按照一個符號的值與它下一個符號的值進行計算的。
- -t radix或--radix=radix：使用radix進制顯示符號值。radix只能為"d"表示十進制、"o"表示八進制或"x"表示十六進制。
- --target=bfdname：指定一個目標代碼的格式，而非使用系統的默認格式。
- -u或--undefined-only：僅顯示沒有定義的符號(那些外部符號)。
- -l或--line-numbers：對每個符號，使用調試信息來試圖找到文件名和行號。對于已定義的符號，查找符號地址的行號。對于未定義符號，查找指向符號重定位入口的行號。如果可以找到行號信息，顯示在符號信息之后。
- -V或--version：顯示nm的版本號。
- --help：顯示nm的任選項。
ar 命令
用途
維護鏈接編輯器使用的索引庫。
語法
ar [ -c ] [ -l ] [ -g | -o ] [ -s ] [ -v ] [ -C ] [ -T ] [ -z ] { -h | -p | -t | -x } [ -X {32|64|32_64|d64| any}] ArchiveFile [ File ... ]
ar [ -c ] [ -l ] [ -g | -o ] [ -s ] [ -v ] [ -C ] [ -T ] [ -z ] { -m | -r [ -u ] } [ { -a | -b | -i } PositionName ] [ -X {32|64|32_64|d64|any}] ArchiveFile File ...
ar [ -c ] [ -l ] [ -g | -o ] [ -s ] [ -v ] [ -C ] [ -T ] [ -z ] { -d | -q } [ -X {32|64|32_64|d64|any}] ArchiveFile File ...
ar [ -c ] [ -l ] [ -v ] [ -C ] [ -T ] [ -z ] { -g | -o | -s | -w } [ -X {32|64|32_64|d64|any}] ArchiveFile
描述
ar 命令維護鏈接編輯器使用的索引庫。ar 命令將一個或多個指定的文件并入單個寫成 ar 壓縮文檔格式的壓縮文檔文件。當 ar 命令創建庫時，它創建可傳輸格式的報頭；當它創建或更新庫時，它重建符號表。有關格式和索引壓縮文檔和符號表的結構的信息，請參閱 ar 文件格式條目。
ar 命令識別兩種文件格式。“大壓縮文檔格式”ar_big，是缺省文件格式并支持 32 位和 64 位目標文件。“小壓縮文檔格式”可用于創建在比 AIX 4.3 更老的版本上可識別的壓縮文檔，請參閱 -g 標志。如果將一個 64 位的對象添加到小格式壓縮文檔，除非指定了 -g，否則 ar 首先將它轉換為大格式。缺省情況下，ar 僅處理 32 位目標文件；壓縮文檔中任何 64 位目標文件在沒有提示的情況下被忽略。要更改此行為，請使用 -X 標志或設置 OBJECT_MODE 環境變量。
標志
在 ar 命令中，可以從集 cClosTv 中指定任何數量的可選標志。必須從標志集 dhmopqrstwx 中指定一個標志。如果選擇 -m 或 -r 標志，您可能還要指定一個位置標志（-a、-b 或 -i）；對于 -a、-b 或 -i 標志，您必須還指定在 ArchiveFile（PositionName）中一個文件的名稱，此名稱緊跟在標志列表后，并由空格隔開。
| -a PositionName |
在 PositionName 參數標識的現有文件后安置指定的文件。 |
| -b PositionName |
在 PositionName 參數標識的現有文件前安置指定的文件。 |
| -c |
禁止在創建庫時產生的正常消息。 |
| -C |
阻止解壓縮的文件替換文件系統中同名的文件。 |
| -d |
從庫中刪除指定的文件。 |
| -g |
對壓縮文檔成員進行排序以確保用最小數量的未用空間獲得最大的加載效率。在幾乎所有情況下，-g 標志以壓縮文檔成員的邏輯鏈接順序物理地安置它們。最終生成的壓縮文檔通常寫成小格式，這樣該標志可用來將大格式壓縮文檔轉換成小格式壓縮文檔。包含 64 位 XCOFF 對象的壓縮文檔不能創建成或轉換至小格式。 |
| -h |
將指定的文件的成員報頭中的修改時間設置為當前日期和時間。如果不指定任何文件名稱，那么 ar 命令設置所有成員報頭的時間戳記。此標志不能和 -z 標志一起使用。 |
| -i PositionName |
在 PositionName 參數標識的現有文件前安置指定的文件（和 -b 相同）。 |
| -l |
將臨時文件置于當前（本地）目錄中，而非 TMPDIR 目錄中（缺省為 /tmp）。 |
| -m |
將指定的文件移動到庫中的某個其他位置。缺省情況下，它將指定的文件移動到庫的末尾。使用位置標志（abi）來指定某個其他位置。 |
| -o |
對壓縮文檔成員進行排序以確保用最小數量的未用空間獲得最大的加載效率。在幾乎所有情況下，-o 標志以壓縮文檔成員的邏輯鏈接順序物理地安置它們。最終生成的壓縮文檔通常寫成大格式，這樣該標志可用來將小格式壓縮文檔轉換成大格式壓縮文檔。 |
| -p |
將 Files 參數中指定的文件的內容或在 ArchiveFile 參數中指定的所有文件（如果您不指定任何文件）都寫至標準輸出。 |
| -q |
將指定的文件添加到庫的末尾。另外，如果指定同一個文件兩次，它可能被放入庫中兩次。 |
| -r |
如果指定的文件已經存在于庫中，那么替換它。因為指定的文件在庫中占據它們替換的文件的同一個位置，位置標志沒有任何附加的影響。當和 -u 標志（更新）一起使用時，-r 標志僅替換自從最后一次添加到庫中以后修改的文件。
如果指定的文件不存在于庫中，那么 ar 命令添加它。在這種情況下，位置標志影響放置。如果不指定位置，那么將新文件置于庫的末尾。如果指定同一個文件兩次，它可能被放入庫中兩次。
|
| -s |
無論 ar 命令是否修改了庫內容都強制重新生成庫符號表。請在庫上使用 strip 命令之后，使用此標志來恢復庫符號表。 |
| -t |
將庫的目錄寫至標準輸出。如果指定文件名稱，那么僅顯示指定的那些文件。如果不指定任何文件，-t 標志列出庫中的所有文件。 |
| -T |
如果壓縮文檔成員名稱比文件系統支持的長，那么允許文件名稱截短。此選項無效，因為文件系統支持的名稱長度等于 255 個字符的最大壓縮文檔成員名稱。 |
| -u |
僅復制自它們最后一次復制起更改的文件（請參閱先前討論過的 -r 標志）。 |
| -v |
將建立新庫的詳細的逐個文件的描述寫至標準輸出。當和 -t 標志一起使用時，它給出類似于 ls -l 命令給出的長列表。當和 -x 標志一起使用時，它在每個文件前加一個名稱。當和 -h 標志一起使用，它列出成員名稱和更新的修改時間。 |
| -w |
顯示壓縮文檔符號表。每個符號和其中定義此符號的文件的名稱一起列出。 |
| -x |
通過將指定的文件復制到當前目錄來解壓縮它們。這些副本和原始文件（保留在庫中）具有相同的名稱。如果不指定任何文件，-x 標志復制庫中的所有文件。此過程不會更改庫。 |
| -X mode |
指定 ar 應檢查的目標文件的類型。mode 必須是下列其中一項：
- 32
- 僅處理 32 位目標文件
- 64
- 僅處理 64 位目標文件
- 32_64
- 處理 32 位 和 64 位目標文件
- d64
- 檢測已終止的 64 位 XCOFF 文件（幻數 == U803XTOCMAGIC）。
- any
- 處理所有受支持的對象文件。
缺省值是處理 32 位目標文件（忽略 64 位對象）。mode 還可以用 OBJECT_MODE 環境變量來設置。例如，OBJECT_MODE=64 使 ar 處理任何 64 位對象并忽略 32 位對象。-X 標志覆蓋 OBJECT_MODE 變量。 |
| -z |
創建壓縮文檔的臨時副本并對副本執行所有要求的修改。當所有操作成功完成時，壓縮文檔的工作副本覆蓋原始副本。此標志不能和 -h 標志一起使用。 |
| ArchiveFile |
指定壓縮文檔文件名稱；必需。 |
| MemberName ... |
各壓縮文檔成員的名稱。 |
退出狀態
該命令返回以下退出值：
示例
- 要創建一個庫，請輸入：
ar -v -q lib.a strlen.o strcpy.o
如果 lib.a 庫不存在，那么此命令創建它，并將文件 strlen.o 和 strcpy.o 的副本輸入其中。如果 lib.a 庫存在，那么此命令在不檢查相同成員的情況下，將新的成員添加到末尾。v 標志設置詳細方式，在此方式中 ar 命令在其進行時顯示進程報告。
- 要顯示庫的目錄，請輸入：
ar -v -t lib.a
此命令列出了 lib.a 庫的目錄，顯示類似于 ls -l 命令的輸出的長列表。要只列出成員文件名稱，那么省略 -v 標志。
- 要替換或添加新成員到庫中，請輸入：
ar -v -r lib.a strlen.o strcat.o
此命令替換成員 strlen.o 和 strcat.o。如果 lib.a 如示例 1 中顯示的那樣創建，那么替換 strlen.o 成員。因為不存在名為 strcat.o 的成員，所以它被添加到庫的末尾。
- 要指定在何處插入新成員，請輸入：
ar -v -r -b strlen.o lib.a strcmp.o
此命令添加 strcmp.o 文件，并將該新成員置于 strlen.o 成員之前。
- 要更新一個已經更改過的成員，請輸入：
ar -v -r -u lib.a strcpy.o
此命令替換現有 strcpy.o 成員，但僅當文件 strcpy.o 自從最后一次添加到庫后已經修改時才替換它。
- 要更改庫成員的順序，請輸入：
ar -v -m -a strcmp.o lib.a strcat.o strcpy.o
此命令將成員 strcat.o 和 strcpy.o 移動到緊跟在 strcmp.o 成員之后的位置。保留 strcat.o 和 strcpy.o 成員的相對順序。換句話說，如果在移動之前 strcpy.o 成員在 strcat.o 成員之前，那么（移動后）它依舊如此。
- 要解壓縮庫成員，請輸入：
ar -v -x lib.a strcat.o strcpy.o
此命令將成員 strcat.o 和 strcpy.o 分別復制到名為 strcat.o 和 strcpy.o 的文件。
- 要解壓縮并重命名一個成員，請輸入：
ar -p lib.a strcpy.o >stringcopy.o
此命令將成員 strcpy.o 復制到一個名為 stringcopy.o 的文件。
- 要刪除一個成員，請輸入：
ar -v -d lib.a strlen.o
此命令從 lib.a 庫中刪除成員 strlen.o。
- 要從多個用 ld 命令創建的共享模塊中創建一個壓縮文檔庫，請輸入：
ar -r -v libshr.a shrsub.o shrsub2.o shrsub3.o ...
此命令從名為 shrsub.o、shrsub2.o、shrsub3.o 等等的共享模塊中創建名為 libshr.a 的壓縮文檔庫。要編譯并鏈接使用 libshr.a 壓縮文檔庫的 main 程序，請使用以下命令：
cc -o main main.c -L/u/sharedlib -lshr
main 程序現在是可執行的。main 程序引用的任何符號（包含在libshr.a 壓縮文檔庫中）已經因延遲分辨率而作了標記。-l 標志指定應在 libshr.a 庫中搜索這些符號。
- 要列出 lib.a 的內容（忽略任何 32 位目標文件），請輸入：
ar -X64 -t -v lib.a
- 要從 lib.a 解壓縮所有 32 位的目標文件，請輸入：
ar -X32 -x lib.a
- 要列出 lib.a 中的所有文件，無論是 32 位、64 位或非對象，請輸入：
ar -X32_64 -t -v lib.a
文件