الابلاغ عن مشكلة كالي لينوكس

هذه المادة تشرح أفضل السبل لتقديم تقرير عن مشكل حتى يتم حله به في أسرع وقت. الهدف من التقرير هو تمكين فريق كالي من تكرار المشكلة لمعرفة سببها. اذا تم تكرارها بنجاح فسيعمل الفريق على جمع معلومات إضافية حتى يعرف السبب الجذري. إذا كان فريق كالي غير قادرا على إعادة إنتاج المشكل، فسيحتاج إلى معلومات إضافية الى حين الحصول على نفس نتائج المبلغ غن المشكل. يرجى تقديم التقارير باللغة الانجليزية لتكون قراءتها أفضل .

حبنا لمجتمع السيكيورتي دفعنا الى انشاء كالي وهو طريقتنا في المساهمة و نحن نسعى لنحافظ على هذا المشروع و تطويره. المطورون الذين يقدمون الدعم هم من المتطوعين للقيام بذلك من باب الشغف. يرجى أخذ ذلك بعين الاعتبار عند وضع التعاليق.

هذه بعض النقاط التي من شأنها أن تؤدي إلى النجاح في حل المشاكل:

• اذا كنت تريد الابلاغ غن مشكلة فلأنك تريد حلا لها، قم باعطاء كل المعلومات التي لديك.
• يرجى الوضوح في التقارير و الفصل بين الحقائق و الفرضيات.
• يرجى عمل التقارير بموضوعية، فقط الحقائق تساعد على البحث السليم .
• لا للاقتباس من يكيبيديا وغيرها من الموارد الغير الأساسية في التقارير.
• تقرير واحد لشخص واحد لمشكل واحد لنظام واحد.
• يرجى عدم وضع عدة مشاكل في تقرير واحد، يجب تقديم تقارير إضافية حسب الحاجة.
• لا للتعليقات الغير مفيدة مثل “أنا أيضا!” أو “+1″
• يرجى عدم التذمر من الوقت الذي قد يتم أخذه في حل المشكل.

كيفية الابلاغ عن مشكل

الbug tracker الخاص بلينكس كالي موجود على الرابط التالي http://bugs.kali.org. هذا المقال يشرح كيفية انشاء حساب و ملف تعريف كما يشرح كيفية تقديم تقرير مفصل.

إنشاء حساب كالي على Bug Tracker الخاص بكالي

إذا لم تقم بإنشاء حساب، ستحتاج الى إكمال هذا أولا. الحساب يسمح لك بتقديم التقارير والتعليق على التقارير الموجودة.

في موقع الbug tracker انقر على “اشترك الان لحساب جديد” (Signup for new account) لبدء العملية.

ستحتاج إلى ادخال اسم مستخدم وعنوان بريد إلكتروني و المعلومات CAPTCHA ثم انقر على signup .

اذا كان كل شيء على ما يرام سيقع اخبارك أن التسجيل قد تم لكن عليك الرد على رسالة التأكيد لتفعيل الحساب رسميا. أنقر على ‘Proceed’ للذهاب الى صفحة تسجيل الدخول.

إنشاء ملف تعريف في الBug Tracker الخاص بكالي

على الرغم من كونه ليس مطلوبا،الا أنه من المستحسن إنشاء ملف تعريف فريد كجزء من حساب bug tracker. يمكنك إنشاء ملف تعريف مخصص لكل نظام، أو الإختيار من المعلومات الافتراضية المقدمة. هذه المعلومات هي اختصارات لتعريف القيم الأساسية للنظام الخاص بك، نظام التشغيل ومعلومات الإصدار المقدمة كجزء من التقرير.

لإنشاء أو تحرير ملف تعريف مخصص، انقر على My Account في الصفحة الرئيسية ثم اختر “Profiles”. قم بإضافة المعلومات ووصف محدد للنظام الخاص بك وانقر فوق Add profile.

بعد اضافة البروفايل سوف يظهر في قائمة Select Profile عند إنشاء تقرير جديد. يمكنك إنشاء البروفيلات التي تحتاجها، فقط تأكد من اختيار البروفيل مناسب عند تقديم تقرير.

تأكد من عدم تكرار طلب سابق

قبل البدء في التقرير قم بالبحث عن الكلمات المفاتيح التي لها علاقة بمشكلتك في الموقع. إذا كان هناك نفس المشكل في القائمة يرجى عدم تكرار الطلب أو إضافة ملاحظات لا لزوم لها (أي “أنا أيضا” أو “+1″) لكن يمكنك عرض حالة هذه المشكلة بالضغط على الرابط ID.

إذا كنت تعتقد أن لها علاقة بالعتاد الخاص بك، يرجى تقديم تقرير جديد مع معلومات خاصة بك. هناك احتمال كبير أن يكون العتاد الخاص بك غير مطابق تماما لعتاد شخص قام بالابلاغ عن نفس المشكل، فلا تفترض أن مشكلتك ليست فريدة من نوعها بمجرد أن جهازك المحمول يعتبر من نفس الطراز.

إنشاء التقرير

لبدء التقرير الخاص بك، قم بتسجيل الدخول إلى حسابك وانقر على “Report Issue”. ستحتاج إلى الادلاء بالمعلومات بقدر الامكان.

الحقول التالية إلزامية في التقرير:

• الفئة (Category)
• الملخص (Summary)
• الوصف (Description)

على الرغم من أن الحقول الأخرى ليست إلزامية، يرجى الادلاء بأكثر ما يمكن من المعلومات داخل كل خيار مع إيلاء اهتمام الخاص بما يلي:

• استنساخ “Reproducibility”
• تحدد الملف “Select Profile”
• خطوات إعادة إنشاء “Steps to Reproduce”
• معلومات إضافية “Additional Information”
• تحميل الملف (سجلات الخطأ، الصورة) “Upload File”

تقرر الفئة المناسبة

حاليا هناك أربعة (4) فئات متوفرة في bug tracker كالي. قبل أن تبدأ طلبك تأكد من تضمينه بشكل صحيح لواحد مما يلي:

• مشكلة عامة (General Bug)
• مشكلة في حزمة كالي (Kali Package Bug)
• طلب أداة جديدة (New Tool Requests)
• أداة الترقية (Tool Upgrade)

لا تطلب الدعم في الbug tracker. كالي لينكس يوفر خيارات عديدة للحصول على الدعم بما في ذلكhttp://docs.kali.org , https://forums.kali.org وغرفة المحادثة kali-linux# على freenode

توفير موجز وصفي

الملخص هو أساسا اسم التقرير و هو أول شيء يراه مطورو كالي و غيرهم من الزوار. قم بتقديم نبذة قصيرة وموجزة يمكنها أن تصف المشكلة أو الطلب.

مثال جيد: Chromium Package installed from Repo will not run as root user

مثال غير جيد: Chromium doesn’t work

الموجز لا يجب أن يشمل كل شيء، ولكن يجب أن ينقل السبب الخاص بك لتقديم التقرير.

العثور على الحزمة و الإصدار للتقرير باستخدام 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…

تقديم وصف موجز

هذه هي فرصتك لتقديم وصف مدروس لما تريد الإبلاغ عنه. هذه هي فرصتك للتألق وتقديم الكثير من التفاصيل قدر الإمكان..

يرجى التأكد مما يلي عند الاقتضاء:

• النص الكامل و الدقيق لأي رسائل خطأ (صورة للشاشة أو ملفات log)
• ما كتبته بالضبط أو الفعل الذي قمت به لإنتاج هذه امشكلة
• الإصلاح المقترح، أو التصحيح إذا كنت قادرا على ذلك
• إصدار الحزمة وأي معلومات تتعلق بها
• إصدار النواة، shared C library، وأية تفاصيل أخرى تبدو مناسبة
• uname –a
• dpkg -s libc6 | grep ^Version
• نسخة البرنامج إن وجدت ( i.e. 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

أهمية إعادة إنتاج المشكل

الbug tracker الخاص بكالي يسمح لك بتقديم وتيرة المشكل. إذا كنت بصدد تقديم طلب للحصول على أداة جديدة أو ترقية لأداة موجودة، قم باختيار N/A من القائمة الخيارات. إذا كنت بصدد تقديم خلل، يرجى تقديم الرد المناسب.

بالرجوع الى المثال أعلاه، “Chromium” لا يمكن تشغيله باستخدام الجذر لذلك يمكن اختيار ‘always’ من القائمة.

من المهم للغاية توفير اجابة دقيقة لأن المطورين في حاجة الى معرفة التردد عند محاولة تكرار المشكل. إذا كانت المشكلة تحدث أحيانا ولكنك قمت باختيار ‘always’ قد يتم غلق المشكل بما أن المطور قد لا يواجه المشكل.

اختيار البروفايل المناسب

كما سبق ذكره فان استعمال ملف تعريف مخصص لكل مشكلة يعتبر الأفضل. ذا لم يتم إنشاء ملفات تعريف مخصصة يمكنك تحديد البروفايل من القائمة. الى حد زمن كتابة هذا المقال الخيارات المتوفرة هي كالآتي.

• armel Kali 1.0
• armhf Kali 1.0
• x64 Kali 1.0
• x86 Kali 1.0

تقديم المراحل لتكرار المشكل

قد يبدو هذا القسم زائدا عن الحاجة لكونه متشابها مع قسم description، وينبغي أن يشمل هذا القسم فقط الخطوات التي يجب اتخاذها لتكرار المشكل. قد تبدو بعض الخطوات سهلة، ولكن من المهم التأكد من ذكر كل المراحل. الخطوة المفقودة قد تكون هي اللازمة لإعادة إنشاء المشكل.

مثال:

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”. سيؤدي هذا إلى فتح مدير الملفات للنظام الخاص بك، ويسمح لك بتحديد الملف. وبمجرد الانتهاء من تحديد الملف انقر فوق الزر “Open” للعودة إلى التقرير وانقر على “Upload File”.

ارسال التقرير

هنا ستكون مستعدا لارسال التقرير. كل ما عليك القيام به هو النقر فوق “Submit Report” عندها سيتم ارسال تقريرك و اعطائه ID. سيظهر التقرير في صفحة “My View” تحت “Reported by Me.” و من هناك يمكنك تتبعه.

ملخص

الغرض من التبليغ عن المشاكل هو مساعدة المطورين لرؤيتها بأعينهم. لأنهم لا يمكنهم أن يكونو معك في حال حصول المشكلة يجب أن تقدم التعليمات المفصلة حتى يتمكنوا من تكرارها بأنفسهم.

يرجي وصف كل شيء بالتفصيل، مشيرا إلى أن الخطوات المتخذة، ما رأيت، ما فعلته وكذلك النتائج المتوقعة.

يرجى محاولة العثور على المشكلة أو الحل من خلال البحوث. إذا كنت قادرا على توفير حل لإصلاح المشكلة للنظام الخاص بك، يرجى توفير نفس المستوى من التفاصيل للمطورين. من المهم للمطورين أن يعرفو بالضبط ما فعلتم، حتى يتمكنوا من تكرار المشكلة بنجاح. هذا لا ينبغي أن يمنعك من تقديم شرح كامل للأعراض التي تسببت في السلوك الغير المتوقع.

يرجى الكتابة بدقة،الكتابة يجب أن تكون واضحة ودقيقة وموجزة لضمان عدم إساءة تفسير ما تحاول أن تنقله من قبل المطورين.

كن مستعدا لتقديم معلومات إضافية.

يرجى التحلي بالصبر، المطورون يريدون إصلاح المشكلة بالقدر الذي تريده. نحن نحب ما نقوم به ونحن فخورون بمواصلة تطوير كالي و جعله التوزيعة الأكثر تقدما في مجال اختبار الاختراق.