ক্র্যাশ রিপোর্ট

যদি Mister Download Manager অপ্রত্যাশিতভাবে বন্ধ হয়ে যায় বা সাড়া দেওয়া বন্ধ করে দেয়, তাহলে একটি ক্র্যাশ রিপোর্ট উইন্ডো খোলে। এটি কী ঘটেছে তা দেখায়, আপনাকে পুরো রিপোর্টটি পড়তে দেয় এবং GitHub-এ ডেভেলপারদের কাছে পাঠাতে পারে। প্রতিটি রিপোর্ট সবার জন্য সমস্যা সমাধানে সহায়তা করে।

আপনি যা দেখেন

• Mister Download Manager অপ্রত্যাশিতভাবে বন্ধ হয়ে গেছে: MDM ক্র্যাশ করেছে, অথবা একটি অভ্যন্তরীণ ত্রুটির সম্মুখীন হয়ে বন্ধ হয়ে গেছে।
• Mister Download Manager সাড়া দেওয়া বন্ধ করে দিয়েছে: এর উইন্ডো 8 সেকেন্ড ধরে সাড়া দেয়নি। MDM এখনও চলছে, কিন্তু জমে আছে। MDM বন্ধ করুন এবং পুনরায় চালু করুন জমে থাকা কপিটি বন্ধ করে একটি নতুন কপি চালু করে। যদি MDM নিজে থেকে আবার সাড়া দেয়, তাহলে উইন্ডোটি তা জানায়।

উইন্ডোতে:

1. যখন এটি ঘটেছিল তখন আপনি কী করছিলেন? ঐচ্ছিক। কিছু শব্দ, যেমন "আমি URL যোগ করুন খুলেছিলাম", অনেক সাহায্য করে।
2. প্রতিবেদন যা কিছু পাঠানো হবে তা দেখায়। আপনি চাইলে প্রথমে এটি পড়ে নিতে পারেন।
3. GitHub-এ পাঠান আপনার ব্রাউজারে GitHub-এর ক্র্যাশ রিপোর্ট ফর্মটি খোলে, যা আগে থেকেই পূরণ করা থাকে, এবং রিপোর্টের ফাইলটি যে ফোল্ডারে আছে সেটিও খোলে। রিপোর্টের ফাইলটি ফর্মে টেনে আনুন, এটি পরীক্ষা করুন এবং জমা দিন। আপনার একটি GitHub অ্যাকাউন্ট থাকা প্রয়োজন। নিজেই কিছু পাঠানো হয় না।
4. যদি কেউ একই সমস্যা আগে থেকেই রিপোর্ট করে থাকে, তাহলে উইন্ডোটি তা জানায় (ইতিমধ্যে সমস্যা #… হিসাবে রিপোর্ট করা হয়েছে)। রিপোর্ট করা সমস্যাটি খুলুন এটি খোলে এবং আপনার রিপোর্টটি ক্লিপবোর্ডে রাখে, যাতে আপনি এটিকে একটি মন্তব্য হিসাবে যোগ করতে পারেন।

অন্যান্য বোতামগুলি রিপোর্ট কপি করে, এর ফোল্ডার খোলে, অথবা MDM আবার চালু করে।

একটি রিপোর্টে কী থাকে

• কী ঘটেছে: ত্রুটি এবং MDM-এর কোডের যে স্থানে এটি ঘটেছে।
• স্ট্যাক: MDM-এর কোডের যে স্থানে এটি ক্র্যাশ করেছে বা জমে গেছে, এবং এর অন্যান্য প্রতিটি অংশ কী করছিল।
• MDM-এর সাম্প্রতিক লগ: উদাহরণস্বরূপ "command AddUrl" অথবা "window opened: add-url"।
• সিস্টেম: MDM-এর সংস্করণ এবং আপনি এটি কীভাবে ইনস্টল করেছেন, আপনার অপারেটিং সিস্টেম এবং এর সংস্করণ, প্রসেসর, ভাষা এবং থিম, এবং আপনার কতগুলি ডাউনলোড ও কিউ আছে। এগুলি শুধুমাত্র সংখ্যা।

এতে থাকে না:

• আপনার ডাউনলোডের ঠিকানা বা ফাইলের নাম;
• আপনার ব্যবহারকারীর নাম, যা ফোল্ডার পাথে ~ হিসাবে দেখানো হয়।

যদি একটি ত্রুটি বার্তা আপনার টাইপ করা কিছু উদ্ধৃত করে, তাহলে সেই লেখাটি রিপোর্টে থাকে, তাই পাঠানোর আগে এটি পড়ুন।

ক্র্যাশ ডেটা ফাইল (.dmp) হল সেই মুহূর্তে MDM কী চালাচ্ছিল তার একটি স্ন্যাপশট। এটি ডেভেলপারদের সবচেয়ে বেশি সাহায্য করে, তবে এতে MDM-এর মেমরিতে থাকা কিছু অংশ থাকতে পারে, যেমন ডাউনলোডের ঠিকানা। এটি শুধুমাত্র তখনই সংযুক্ত করা হয় যখন আপনি ক্র্যাশ ডেটা সংযুক্ত করুন টিক দেন।

রিপোর্ট কোথায় রাখা হয়

MDM-এর ডেটা ফোল্ডারে:

• crashes\: প্রতিটি রিপোর্ট (.txt) এবং এর ক্র্যাশ ডেটা (.dmp);
• logs\: MDM-এর লগ (mdm.log, এবং পুরোনো গুলো mdm.1.log ইত্যাদি হিসাবে, প্রতিটি 2 MB)।

MDM-এর ডেটা ফোল্ডার Windows-এ %APPDATA%\misterdownloadmanager, macOS-এ ~/Library/Application Support/misterdownloadmanager, এবং Linux-এ ~/.local/share/misterdownloadmanager। পোর্টেবল মোডে এটি প্রোগ্রামের পাশে data ফোল্ডার।

লগ MDM কী করে তা রেকর্ড করে, তাই একটি রিপোর্ট সমস্যাটির কারণ কী তা দেখাতে পারে। আরও বিস্তারিত লগ করার জন্য, পরিবেশ ভেরিয়েবল MDM_LOG=debug দিয়ে MDM চালু করুন।

ডেভেলপারদের জন্য

এটি কীভাবে কাজ করে: MDM-এর একটি দ্বিতীয় কপি, মনিটর, --crash-monitor সহ এর পাশে চালু হয়। ক্র্যাশ কোড crates/crash এবং crates/app/src/crash.rs-এ থাকে।

• সমস্যা ধরা। যখন MDM ক্র্যাশ করে (একটি Windows ব্যতিক্রম, Linux-এ একটি সিগন্যাল, macOS-এ একটি Mach ব্যতিক্রম), প্যানিক করে, অথবা জমে যায়, তখন এটি মনিটরের কাছে একটি ডাম্প চায়। একটি ফ্রিজ হল উইন্ডোর একটি ফ্রেম যা 8 সেকেন্ডের বেশি চলে, যা একটি ওয়াচডগ থ্রেড দ্বারা দেখা হয় যা ঘুমানোর সময়কে উপেক্ষা করে। মনিটর তখন minidumper এবং crash-handler এর মাধ্যমে বাইরে থেকে প্রতিটি থ্রেডের একটি মিনিডাম্প লেখে। একটি ক্র্যাশ করা প্রক্রিয়া কখনোই নিজের ডাম্প লেখে না, যা Firefox, Crashpad এবং Sentry-ও করে।
• ডাম্প পড়া। মনিটর মোজিলার rust-minidump দিয়ে ডাম্প পড়ে। এটি রিলিজের ব্রেকপ্যাড সিম্বল ব্যবহার করে যখন সেগুলো পাওয়া যায়, অথবা সোর্স থেকে তৈরি বিল্ডের সাথে থাকা নেটিভ ডিবাগ তথ্য ব্যবহার করে। রিপোর্টের স্বাক্ষর (উদাহরণস্বরূপ freeze in misterdownloadmanager::winui::combo_edit) একটি সমস্যার বিভিন্ন রিপোর্টে একই থাকে, এবং উইন্ডোটি এর জন্য বিদ্যমান সমস্যাগুলো খুঁজে দেখে।
• সিম্বল। রিলিজ বিল্ডগুলো লাইন টেবিল (debug = "line-tables-only") রাখে, কিন্তু কোনো ডাউনলোডেই ডিবাগ তথ্য অন্তর্ভুক্ত থাকে না। CI এটিকে MisterDownloadManager-<version>-symbols-<platform>.zip (tools/installer/symbols.py, মোজিলার dump_syms ব্যবহার করে) তে রূপান্তরিত করে, যা রিলিজের অন্যান্য ফাইলের সাথে প্রকাশিত হয়। যখন একটি স্ট্যাক খালি ঠিকানা দেখায়, তখন রিপোর্ট উইন্ডোটি তার নিজস্ব সংস্করণের জন্য জিপ ফাইলটি নিয়ে আসে।
• একটি সমস্যা থেকে .dmp:

cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp MisterDownloadManager-<version>-symbols-windows-x64.zip

• এটি পরীক্ষা করা। cargo test -p mdm-crash একটি বাস্তব ফ্রিজ, প্যানিক এবং ক্র্যাশ (examples/crashy.rs) চালায় এবং প্রতিটি রিপোর্টের স্বাক্ষর পরীক্ষা করে। অ্যাপে এটি চেষ্টা করতে, MDM_CRASH_TEST=1 দিয়ে MDM শুরু করুন, তারপর misterdownloadmanager /show crash-test:freeze (অথবা panic, crash, abort) চালান।