# 給Kali提交問題 ## 簡介 這篇文檔指導一個報告者如何提交一份最好的問題報告,以便問題能盡快的被修復.問題報告者的目的是讓Kali Linux的開發者問題重現然后發現問題.如果Kali開發者發現了問題,他們會收集更多的信息直到找到問題的根本.否則,他們會要求提供更多的信息直到他們出現提交者遇到的問題.請記住,我們的開發團隊使用英文,所以最好用**英文**提交. Kali Linux誕生于對社區的回報.社區促使我們的項目得以更好的保持持續發展.在你寫評論時請記住,為你提供支持的開發者都是無私奉獻的志愿者. 想要解決問題,請明確以下的要點: * 你是因為想要解決問題才提交的問題,所以請提供全面的信息. * 弄清楚你提交的是事實還是假設. * 保持問題報告的客觀性,只陳述經過適當研究后的事實. * 不要引用Wikipeida和其它非主要資源的結果作為報告. * 一個BUG,不要以不同的報告,不同的人,不同的硬件多次提交. * 不要把多個問題堆在一起報告,如果可以請分別提交. * 不要發類似“Me too!” 或 “+1″這樣的評論. * 不要抱怨修復一個漏洞為何那么久. ## 如何報告問題 Kali Linux問題追蹤系統在[http://bugs.kali.org](http://bugs.kali.org).這篇文檔指導你如何創建帳號,如何創建系統資料,和如何提交一份詳細的報告. #### 創建Kali Linux問題追蹤系統帳戶 如果你還沒有創建帳戶,應該先完成這一步.創建用戶后你才可以提交問題報告或對已存在的問題進行評論. 在問題追蹤系統頁面,點擊‘Signup for new account’開始創建. [](img/kali-bugtacker-signup-1.png) 輸入用戶名和email,然后輸入驗證碼.點擊signup按鈕. [](img/kali-bugtacker-signup-2.png) 如果成功了,下一步會提示你帳戶已經注冊好.要激活帳戶請回復官方的email確認郵件.點擊”Proceed”繼續到漏洞追蹤系統登錄頁面. [](img/kali-bugtacker-signup-3.png) #### 在Kali Linux問題追蹤系統創建一份資料 不是必須的,但是作為你的帳戶的一部分,建議創建一份獨特的資料.你可以為每個系統創建自定義的資料,或者從默認資料里選擇.這些資料用于報告時定義你的平臺,操作系統和版本信息. 創建或編輯自定義資料,從主頁選擇My Account然后選擇Profiles.為你的系統添加具體的信息和描述,完成時點擊”Add Profile”按鈕. [](img/kali-bugtracker-profile-1.png) 資料添加好后,在你創建一個新的問題報告時會出現”Select Profile”下拉菜單.可以根據你的需要創建不同的配置文件,只要你在提交問題報告時選擇正確的配置文件. ## 務必不要報告提交過的問題 在開始報告之前,在網站搜索和你的問題相關的關鍵字.如果存在已經被報告的問題(與硬件無關),請不要重復提交或者添加沒有必要的注釋,例如”Me too!”或者”+1″.你可以點擊ID鏈接來查看問題的狀態. 如果你認為問題和硬件有關,即使類似的硬件也報告過,也請以你的具信息提交一份新的報告.你的硬件與別硬件不一定完全相同.不要以為同樣的桌面或者筆記本型號就不可能遇到不一樣的問題. #### 創建報告 開始你的報告,登入你的帳戶然后點擊登錄頁面上的”Report Issue”.你需要填盡可能多的信息.必要時請查看本文前面提出的那幾點要求. 報告中必須包含以下字段: * Category(分類) * Summary(摘要) * Description(描述) 其它字段不是必須的,但我們請特別多注意下面每個選項: * Reproducibility(重現性) * Select Profile(選擇資料) * Steps to Reproduce(重現步驟) * Additional Information(附加信息) * Upload File (error logs, screenshot)-上傳文件(錯誤日志,屏幕截圖) #### 選擇適當的分類 目前Kali的問題被分為4類.報告問題之前請先確定它的類別: * General Bug(一般問題) * Kali Package Bug(Kali軟件包問題) * New Tool Requests(請求添加新工具) * Tool Upgrade(工具升級) 不要提出問題追蹤系統不支持的請求.Kali Linux提供許多可選的支持,包括[http://docs.kali.org](http://docs.kali.org) , [https://forums.kali.org](https://forums.kali.org)和freenode上的IRC聊天室(#kali-linux). #### 提供一個描述性的摘要 摘要字段本質上是一個問題報告的”名字”,Kali開發者和其它訪問者會第一個看它.提供一個簡短但具描述性的摘要可以描述問題或者明確要求. Good: Chromium Package installed from Repo will not run as root user(優:從源安裝的Chromium軟件包不能用root運行) Bad: Chromium doesn’t work(劣:chromium不能運行) 摘要不應該包括所有東西,除非必須要包含它才能傳達你提交報告的原因. #### 使用dpkg為問題報告找到軟件包和軟件版本 你可以用dpkg參數組合找到安裝過哪個軟件包.在你的報告中列入這些命令的輸出結果很重要.輸出結果也可以以文本文件格式上傳.(在本文后面討論). * search * list * status 例子的輸出: ``` root@kali:~# which chromium /usr/bin/chromium root@kali:~# type chromium chromium is /usr/bin/chromium root@kali:~# dpkg --search /usr/bin/chromium chromium: /usr/bin/chromium root@kali:~# dpkg --list chromium Desired=Unknown/Install/Remove/Purge/Hold | Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend |/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad) ||/ Name Version Architecture Description +++-==============-============-============-================================= ii chromium 24.0.1312.68 amd64 Google open source chromium web root@kali:~# dpkg --status chromium Package: chromium Status: install ok installed Priority: optional Section: web Installed-Size: 98439 Maintainer: Debian Chromium Maintainers <pkg-chromium-maint@lists.alioth.debian.org> Architecture: amd64 Source: chromium-browser Version: 24.0.1312.68-1 …Output Truncated… ``` #### 建立描述方案 現在是提交經過你深思熟慮的報告的時候了.盡可能多的提供細節和結果. 請務必在適當的地方包含如下內容: * 任何錯誤信息的準確并完整的文本(屏幕截圖或日志文件) * 你具體輸入了什么或者做過什么產生的問題 * 如果可以,提供一個修復建議或者補丁 * 軟件包的版本和與依賴包有關系的任何信息 * 內核版本,C共享庫,或者別看起來合適的資料 * uname –a * dpkg -s libc6 | grep ^Version * 適當的時候,軟件版本(例如 python -V) * 你的硬件信息 * 如果你要報告硬件驅動問題,請列出你所有的硬件信息 * 在你系統上安裝源里的lshw報告完整的硬件信息 * 添加其它相關的資料 * 別為報告”太長”而擔心,只要是相關信息,有比沒有更好. ##### 例子 Package: Chromium Architecture: amd64 Maintainer: Debian Chromium Maintainers Source: chromium-browser Version: 24.0.1312.68-1 I installed the chromium web browser from the Kali Linux repos, using the command ‘apt-get install chromium’. I launched the program from the Kali menu by selecting Applications/Internet/Chromium Web Browser. Chromium did not launch as expected, instead it provided an error pop-up window. The error message stated, “Chromium cannot be run as root. Please start Chromium as a normal user. To run as root, you must specify an alternate –user-data-dir for storage of profile information”. I clicked the Close button to close the pop up window. uname –a output: Linux kali 3.7-trunk-amd64 #1 SMP Debian 3.7.2+kali6 x86_64 GNU/Linux C Library Version: 2.13-38 #### 再現性的重要 Kali Linux問題追蹤系統允許你提交被報告的問題出現頻率.如果你提交一個要求添加新工具或工具更新的請求,簡單的在下拉菜單選擇N/A.如果提交問題,請提供相應的回答. 繼續回到上面的例子,Chromium設計成無法用root啟動，你可以從下拉菜單選擇“總是”. 你提供了一個準確的反饋,這很重要,如果Kali開發者試圖重現該問題,他們需要知道該問題的發生的頻率.如果出問題的頻率是偶爾,但你卻標著總是,開發者可能會因為測試時沒遇到問題而草率地關閉這個報告. #### 選擇適當的資料 如上所述,為每一個報告的問題使用一個自定義的資料是最好的.如果沒有創建自定義資料,從下拉菜單中選擇相應的資料.在本指南發布時,下列選項是可用的. * armel Kali 1.0 * armhf Kali 1.0 * x64 Kali 1.0 * x86 Kali 1.0 #### 提供重現該問題的步驟 與描述部分相比這部分雖然看起來可能是多余的,但這部分只包含重現該問題采取的步驟.一些步驟可能只起輔助作用,但它們很重要務必盡力寫.可能缺少的就是那個重現問題必需的步驟. ##### 例子: 1. Opened a terminal window by selecting Applications/Accessories/Terminal 2. Typed ‘apt-get install chromium’ in the terminal and hit enter to run the command 3. Attempted to run Chromium web browser by selecting Applications/Internet/Chromium Web Browser #### 提供更多信息 在這部分你可以提供與問題相關的更多的信息.如果你有修復問題的方法,請在這部分提供它.同樣的,堅持事實和正確的寫步驟很重要,以便開發者能重現. ##### 例子: There is a simple fix that is well documented on several forums. I tried it and it fixed the issue for me. * Using a text editor open /etc/chromium/default * Add –user-data-dir flag * i.e. CHROMIUM_FLAGS=”–user-data-dir” Can this be patched within the repo version of Chromium so adding this flag is not required for future releases? #### 上傳相關文件 有時提供不是很容易提供的信息給開發組很重要.報告的這部分允許你添加屏幕截圖或者日志文件.注意文件的大小限制. 你可以點擊”Choose FIle”按鈕來添加一個文件.它會打開系統的文件管理器然后上傳你選擇的文件.選好文件之后點擊”打開”按鈕返回你的報告,然后點擊”Upload File”按鈕. #### 提交報告 至此,你已經準備好提交報告了.剩下的就是點擊”Submit Report”按鈕.你的報告會被提交然后分配到一個tracking ID(追蹤ID).報告會在你的”My View”頁面下的”Reported by Me”看見.你可以跟蹤問題的解決. #### 摘要 問題報告的目的是幫助開發者用他們的雙眼看到錯誤.你可以通過提供詳細的說明讓他們和你一起親自看到錯誤. 詳細描述一切,陳述采取了什么步驟,看到了什么,除了你期盼的結果外你做了什么. 嘗試通過研究找到問題或解決辦法.如果你可以為你的系統提供一個解決問題的方案,就可以給開發者提供同等級的問題報告.讓開發者知道你到底做過什么很重要,以便讓他們成功地重復過程.這不該成為你解決異常問題的絆腳石. 準確,清晰,簡明扼要地寫報告,以確保開發者不會誤解你的意思. 開發者不會忽悠你,準備好額外的信息以便他們問起. 請對你的請求有耐心,開發者像你一樣也想修復問題.我們熱愛我們的工作并以繼續讓Kali成為有史以來最尖端的滲透測試發行版為驕傲. 這篇文章由如下的資源按需修改而成: [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html](http://www.chiark.greenend.org.uk/~sgtatham/bugs.html "How to Report Bugs Effectively") – Fetched March 20,2013 [https://help.ubuntu.com/community/ReportingBugs](https://help.ubuntu.com/community/ReportingBugs "ReportingBugs") – Fetched March 20,2013 [http://www.debian.org/Bugs/Reporting](http://www.debian.org/Bugs/Reporting "How to report a bug in Debian using reportbug") – Fetched March 20,2013