IBM AIX errpt 指令－雨果

用途

產生已記載錯誤的報告。

語法

從錯誤日誌處理報告

Errpt [ -@ wpar_name ] [ -a ] [ -是 ] [ -c ] [ -d ErrorClass清單 ] [ -D ] [ -e EndDate ] [ -g ] [ -i 檔案 ] [ -我檔案 ] [ -j ErrorID [ ,ErrorID ] ] | [ -k ErrorID [ ,ErrorID ] ] [ -J ErrorLabel [ ,ErrorLabel ] ] | [ -K ErrorLabel [ ,ErrorLabel ] ] [ -l SequenceNumber ] [ -m 機器 ] [ -n 節點 ] [ -s StartDate ] [ -F FlagList ] [ -N ResourceName清單 ] [ -P ] [ -R ResourceType清單 ] [ -S ResourceClass清單 ] [ -T ErrorType清單 ] [ -是檔案 ] [ -z 檔案 ]

從錯誤記錄範本儲存庫處理報告

errpt [ -a ] [ -A ] [ -I File ] [ -t ] [ -d ErrorClassList ] [ -j ErrorID [ ，ErrorID ]] | [ -k ErrorID [ ，ErrorID ]] [ -J ErrorLabel [ ，ErrorLabel ]] | [ -K ErrorLabel [ ，ErrorLabel ]] [ -F FlagList ] [ -P ] [ -T ErrorTypeList ] [ -y File ] [ -z File ]

說明

Errpt 指令會從錯誤日誌中的項目產生錯誤報告。它包括旗標，用於選取符合特定準則的錯誤。透過使用預設條件，您可以依照錯誤日誌項目發生及記錄的相反順序來顯示錯誤日誌項目。透過使用 -c (並行) 旗標，您可以在發生錯誤時顯示錯誤。如果 -i 旗標未與 Errpt 指令一起使用，則 Errpt 處理的錯誤日誌檔是錯誤日誌配置資料庫中指定的錯誤日誌檔。 (若要檢視錯誤日誌配置資料庫中的資訊，請使用 errdemon 指令。)

預設摘要報告包含每一個錯誤的一行資料。您可以使用旗標來產生具有不同格式的報告。

“附註: Errpt 指令不會執行錯誤日誌分析; 若要進行分析，請使用 diag 指令。不過，當執行錯誤日誌分析時，診斷程式可能會將診斷資訊新增回錯誤日誌。這類資訊會顯示在對應錯誤日誌項目的詳細資料之後。”

您可以使用「系統管理介面工具 (SMIT)」 smit errpt 捷徑來執行此指令。

旗標

-@wpar_name

選取所指定 WPAR 名稱的錯誤項目。

-a

以詳細格式顯示錯誤日誌檔中錯誤的相關資訊。如果與 -t 旗標一起使用，則會顯示範本檔中的所有資訊。

-A

顯示 -a 旗標所產生詳細報告的縮短版本。 -是旗標與 -a、 -g或 -t 旗標一起無效。所報告的項目是標籤、日期和時間、類型、資源名稱、說明及明細資料。此旗標的範例輸出格式如下:

	LABEL:           STOK_RCVRY_EXIT
Date/Time:       Tue Dec 14 15:25:33 
Type:            TEMP
Resource Name:   tok0
Description
PROBLEM RESOLVED
Detail Data
FILE NAME
line: 273 file: stok_wdt.c
SENSE DATA
0000 0000 0000 0000 0000 0000 
DEVICE ADDRESS
0004 AC62 25F1 
	

-c

同時格式化並顯示每一個錯誤項目，亦即在記載時。日誌檔中的現有項目會依其記載順序顯示。

-d ErrorClass清單

將錯誤報告限制為有效 ErrorClass清單 變數所指定的特定類型錯誤記錄: H (硬體)、 S (軟體)、 0 (errlogger 指令訊息) 及 U (未定)。 ErrorClass清單 變數中的錯誤記錄可以用、 (逗點) 區隔或以 "" 括住 (雙引號) 並以、 (逗點) 或空格字元區隔。

-D

合併重複的錯誤。使用 -a 旗標取得的詳細錯誤報告，會報告重複的次數以及第一次和最後一次。請參閱 一般程式設計概念: 撰寫及除錯程式中的錯誤記載概觀。

附註: -D 旗標與 -c、 -g、 -l、 -t及 -P 旗標一起無效。

-e EndDate

指定在 EndDate 變數之前 (含) 公佈的所有記錄，其中 EndDate 變數的格式為 mmddhhmmyy (月、日、小時、分鐘和年)。

-g

顯示未格式化錯誤日誌項目的 ASCII 表示法。此旗標的輸出格式如下:

el_sequence: 錯誤-日誌戳記號碼
el_label: 錯誤標籤
el_timestamp: 錯誤-日誌項目時間戳記
el_crcid: 唯一循環冗餘檢查 (CRC) 錯誤 ID
el_machineid: 機器 ID 變數
el_nodeid: 節點 ID 變數
el_class: 錯誤類別
el_type: 錯誤類型
el_resource: 資源名稱
el_rclass: 資源類別
el_rtype: 資源類型
el_vpd_ibm: IBM® 重要產品資料 (VPD)
el_vpd_user: 使用者 VPD
el_in: 裝置的位置碼
el_connwhere: 硬體連線 ID (特定裝置上的位置，例如插槽號碼)
et_label: 錯誤標籤
et_class: 錯誤類別
et_type: 錯誤類型
et_desc: 錯誤說明
et_probcaes: 可能原因
et_usercauses: 使用者原因
et_useraction: 使用者動作

et_instca導致: 安裝原因
et_instaction: 安裝動作
et_failcaes: 失敗原因
et_failaction: 失敗動作
et_detail_length: 明細-資料欄位長度
et_detail_descid: 明細-資料 ID
et_detail_encode: detail-data 輸入格式的說明
et_logflg: 日誌旗標
et_alertflg: 可警示錯誤旗標
et_reportflg: 錯誤報告旗標
el_detail_length: 明細-資料輸入長度
el_detail_data: 明細-資料輸入

-F FlagList

根據的值選取錯誤記錄範本Alert,Log，或Report範本的欄位。 FlagList 變數可以用、 (逗點) 區隔，或以 "" 括住 (雙引號) 並以、 (逗點) 或空格字元區隔。 -F 旗標僅與 -t 旗標一起使用。

FlagList 變數的有效值包括:

alert=0: 選取具有下列項目的錯誤記錄範本:Alert欄位設為 False。
alert=1: 選取具有下列項目的錯誤記錄範本:Alert欄位設為 True。
log=0: 選取具有下列項目的錯誤記錄範本:Log欄位設為 False。
log=1: 選取具有下列項目的錯誤記錄範本:Log欄位設為 True。
report=0: 選取具有下列項目的錯誤記錄範本:Report欄位設為 False。
report=1: 選取具有下列項目的錯誤記錄範本:Report欄位設為 True。

-i 檔案

使用檔案變數指定的錯誤日誌檔。如果未指定此旗標，則會使用錯誤日誌配置資料庫中的值。

-I 檔案

使用檔案指定的診斷日誌檔。如果未指定此旗標，則會使用預設路徑名稱 /var/adm/ras/diag_log。

-j ErrorID[，ErrorID]

僅包括 ErrorID (錯誤 ID) 變數指定的錯誤日誌項目。 ErrorID 變數可以用、 (逗點) 區隔或以 "" 括住 (雙引號) 並以、 (逗點) 或空格字元區隔。與 -t 旗標結合時，會從錯誤範本儲存庫處理項目。 (否則會從錯誤日誌儲存庫處理項目。)

-J ErrorLabel

包括 ErrorLabel 變數指定的錯誤日誌項目。 ErrorLabel 變數值可以用逗點區隔，也可以用雙引號括住，並以逗點或空白區隔。與 -t 旗標結合時，會從錯誤範本儲存庫處理項目。 (否則，會從錯誤日誌儲存庫處理項目。)

-k ErrorID[，ErrorID]

排除 ErrorID 變數指定的錯誤日誌項目。 ErrorID 變數可以用、 (逗點) 區隔或以 "" 括住 (雙引號) 並以、 (逗點) 或空格字元區隔。與 -t 旗標結合時，會從錯誤範本儲存庫處理項目。 (否則會從錯誤日誌儲存庫處理項目。)

-K ErrorLabel

排除 ErrorLabel 變數指定的錯誤日誌項目。 ErrorLabel 變數值可以用逗點區隔，也可以用雙引號括住，並以逗點或空白區隔。與 -t 旗標結合時，會從錯誤範本儲存庫處理項目。 (否則，會從錯誤日誌儲存庫處理項目)。

-l SequenceNumber

選取由 SequenceNumber 變數指定的唯一錯誤日誌項目。此旗標由 error-notification 物件類別中的方法使用。 SequenceNumber 變數可以用、 (逗點) 區隔，或以 "" 括住 (雙引號) 並以、 (逗點) 或空格字元區隔。

-m 機器

包括指定機器變數的錯誤日誌項目。 uname -m 指令會傳回機器變數值。

-n 節點

包括指定節點變數. 的錯誤日誌項目 uname -n 指令會傳回節點變數值。

-N ResourceName清單

產生由 ResourceNameList 變數指定之資源名稱的報告。 ResourceNameList 變數是已偵測到錯誤的資源名稱清單。若為軟體錯誤， ResourceNameList 變數會列出偵測到錯誤的資源名稱。若為硬體錯誤，它會列出裝置或系統元件的名稱。它不會指出元件故障或需要更換。相反地，它是用來判斷要用來分析錯誤的適當診斷模組。

ResourceNameList 變數的名稱可以用、 (逗點) 區隔，也可以用 "" 括住 (雙引號) 並以、 (逗點) 或空格字元區隔。

-P

僅顯示與前一個錯誤重複的錯誤。 -P 旗標僅適用於錯誤日誌裝置驅動程式產生的重複錯誤。這些錯誤是在 errdemon daemon -t 旗標所控制的 errlg_duptime 錯誤記載屬性所指定的大約時間間隔內發生的重複錯誤。 -P 旗標與 -D 旗標一起無效。

-R ResourceTypeList

產生 ResourceTypeList 變數所指定資源類型的報告。對於硬體錯誤， ResourceTypeList 變數是裝置類型。對於軟體錯誤，它是 LPP 值。 ResourceTypeList 變數中的項目可以用、 (逗點) 區隔，也可以用 "" 括住 (雙引號) 並以、 (逗點) 或空格字元區隔。

-s StartDate

指定在 StartDate 變數上及之後公佈的所有記錄，其中 StartDate 變數格式為 mmddhhmmyy (月、日、小時、分鐘和年)。

-S ResourceClass清單

產生 ResourceClassList 變數所指定資源類別的報告。對於硬體錯誤， ResourceClassList 變數是裝置類別。資源類別必須以 , (逗點) 區隔，或以 "" 括住 (雙引號) 並以 , (逗點) 或空格字元區隔。

-t

處理錯誤記錄範本儲存庫，而不是錯誤日誌。 -t 旗標可用來檢視報告表單中的錯誤記錄範本。

-T ErrorType清單

將錯誤報告限制為有效 ErrorType清單 變數所指定的錯誤類型: INFO、 PEND、 PERF、 PERM、 TEMP及 UNKN。錯誤類型可以以 , (逗點) 區隔，或以 "" 括住 (雙引號) 並以 , 或空格字元區隔。

-y 檔案

使用檔案變數指定的錯誤記錄範本檔案。與 -t 旗標結合時，會從指定的錯誤範本儲存庫處理項目。 (否則，會使用指定的錯誤範本儲存庫，從錯誤日誌儲存庫處理項目。)

-z 檔案

使用檔案變數指定的錯誤記載訊息型錄。與 -t 旗標結合時，會從錯誤範本儲存庫處理項目。 (否則，會從錯誤日誌儲存庫處理項目。)

安全

RBAC 使用者注意: 這個指令可以執行特許作業。只有專用使用者可以執行專用作業。如需授權及專用權的相關資訊，請參閱安全中的「特許指令資料庫」。如需與這個指令相關聯之專用權及授權的清單，請參閱 lssecattr 指令或 getcmdattr 次指令。

若要執行 errpt 指令，如果在 errdemon 指令中啟用 errpt 限制，則您必須具有下列其他授權:

aix.ras.error.errpt: 執行 errpt 指令時需要。

附註: 依預設， root 及系統群組使用者是特許使用者。

範例

若要顯示完整摘要報告，請輸入:
```
errpt
```
若要顯示完整的詳細報告，請輸入:
errpt -a
顯示針對錯誤 ID 所記載的所有錯誤的詳細報告E19E094F，輸入:
errpt -a -j E19E094F
若要顯示過去 24 小時所記載所有錯誤的詳細報告，請輸入:
errpt -a -s mmddhhmmyy
其中mmddhhmmyystring 等於現行月、日、小時、分鐘及年，減去 24 小時。
若要列出已針對任何錯誤日誌項目關閉記載的錯誤記錄範本，請輸入:
errpt -t -F log=0
檢視替代錯誤日誌檔中的所有項目/var/adm/ras/errlog.alternate，輸入:
errpt -i /var/adm/ras/errlog.alternate
檢視替代錯誤日誌檔中的所有硬體項目/var/adm/ras/errlog.alternate，輸入:
errpt -i /var/adm/ras/errlog.alternate -d H
顯示針對錯誤標籤所記載的所有錯誤的詳細報告ERRLOG_ON，輸入:
errpt -a -J ERRLOG_ON
若要顯示所有錯誤及群組重複錯誤的詳細報告，請輸入:
```
errpt -aD
```
若要顯示八月期間針對錯誤標籤 DISK_ERR1 及 DISK_ERR2 所記載的所有錯誤的詳細報告，請輸入:
```
errpt -a -J DISK_ERR1,DISK_ERR2 -s 0801000004 -e 0831235904"
```