Units
Translation components API.
See the Weblate's Web API documentation for detailed description of the API.
GET /api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/units/?format=api&page=4
{ "count": 210, "next": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/units/?format=api&page=5", "previous": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/units/?format=api&page=3", "results": [ { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "When running a development kernel (e.g., FreeBSD-CURRENT), such as a kernel under extreme conditions (e.g., very high load averages, tens of thousands of connections, exceedingly high number of concurrent users, hundreds of man:jail[8]s, etc.), or using a new feature or device driver on FreeBSD-STABLE (e.g., PAE), sometimes a kernel will panic. In the event that it does, this chapter will demonstrate how to extract useful information out of a crash." ], "previous_source": "", "target": [ "" ], "id_hash": 183548297155732807, "content_hash": 183548297155732807, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:60", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 5, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 70, "source_unit": "https://translate-dev.freebsd.org/api/units/1193328/?format=api", "priority": 100, "id": 1193445, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=828c18342b186547", "url": "https://translate-dev.freebsd.org/api/units/1193445/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:02.051090Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "A system reboot is inevitable once a kernel panics. Once a system is rebooted, the contents of a system's physical memory (RAM) is lost, as well as any bits that are on the swap device before the panic. To preserve the bits in physical memory, the kernel makes use of the swap device as a temporary place to store the bits that are in RAM across a reboot after a crash. In doing this, when FreeBSD boots after a crash, a kernel image can now be extracted and debugging can take place." ], "previous_source": "", "target": [ "بازراه‌‌اندازیِ سامانه در هنگام وقوع وحشت هسته اجتناب ناپذیر است. هنگامی‌که سامانه بازراه‌‌اندازی می‌شود، محتوای حافظهٔ فیزیکیِ سامانه (<acronym>RAM</acronym>) و همچنین هر بیتی که قبل از وقوع وحشت در دستگاهِ swap موجود بوده است از دست می‌رود. برای حفظ بیت‌ها در حافظهٔ فیزیکی، هسته دستگاهِ swap را به‌عنوان مکان موقتی برای حفظ بیت‌های موجود در RAM که در وسط بازراه‌‌اندازیِ پس از خرابی هستند به‌کار می‌برد. در این راه، هنگامی‌که FreeBSD پس از خرابی راه‌اندازی (بوت) می‌شود، حال تصویر هسته را می‌توان استخراج کرد و اشکال‌زدایی آغاز می‌شود." ], "id_hash": 4530368137806317934, "content_hash": 4530368137806317934, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:65", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 6, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 92, "source_unit": "https://translate-dev.freebsd.org/api/units/1193330/?format=api", "priority": 100, "id": 1193446, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=bedf19d183b1896e", "url": "https://translate-dev.freebsd.org/api/units/1193446/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:02.064193Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "A swap device that has been configured as a dump device still acts as a swap device. Dumps to non-swap devices (such as tapes or CDRWs, for example) are not supported at this time. A \"swap device\" is synonymous with a \"swap partition.\"" ], "previous_source": "", "target": [ "یک دستگاه swap که مانند یک دستگاه روگرفت پیکربندی شده است هنوز مانند دستگاه swap عمل می‌کند. روبرداری در دستگاه‌های غیر از swap (مانند نوارها یا CDRW ها) در این لحظه پشتیبانی نمی‌شود. یک <quote>دستگاه swap</quote> مترادف با یک <quote>محفظهٔ swap</quote> است." ], "id_hash": 1692044423396392310, "content_hash": 1692044423396392310, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:71", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 7, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 43, "source_unit": "https://translate-dev.freebsd.org/api/units/1193332/?format=api", "priority": 100, "id": 1193447, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=977b597030b8fd76", "url": "https://translate-dev.freebsd.org/api/units/1193447/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:02.149603Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Before the kernel will dump the contents of its physical memory to a dump device, a dump device must be configured. A dump device is specified by using the man:dumpon[8] command to tell the kernel where to save kernel crash dumps. The man:dumpon[8] program must be called after the swap partition has been configured with man:swapon[8]. This is normally handled by setting the `dumpdev` variable in man:rc.conf[5] to the path of the swap device (the recommended way to extract a kernel dump) or `AUTO` to use the first configured swap device. The default for `dumpdev` is `AUTO` in HEAD, and changed to `NO` on RELENG_* branches (except for RELENG_7, which was left set to `AUTO`). On FreeBSD 9.0-RELEASE and later versions, bsdinstall will ask whether crash dumps should be enabled on the target system during the install process." ], "previous_source": "", "target": [ "" ], "id_hash": 4832612037101154649, "content_hash": 4832612037101154649, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:95", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 17, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 138, "source_unit": "https://translate-dev.freebsd.org/api/units/1193334/?format=api", "priority": 100, "id": 1193448, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=c310e30b20b0f159", "url": "https://translate-dev.freebsd.org/api/units/1193448/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:02.647783Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Once a dump has been written to a dump device, the dump must be extracted before the swap device is mounted. To extract a dump from a dump device, use the man:savecore[8] program. If `dumpdev` has been set in man:rc.conf[5], man:savecore[8] will be called automatically on the first multi-user boot after the crash and before the swap device is mounted. The location of the extracted core is placed in the man:rc.conf[5] value `dumpdir`, by default [.filename]#/var/crash# and will be named [.filename]#vmcore.0#." ], "previous_source": "", "target": [ "" ], "id_hash": 9113773333921532071, "content_hash": 9113773333921532071, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:121", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 23, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 81, "source_unit": "https://translate-dev.freebsd.org/api/units/1193336/?format=api", "priority": 100, "id": 1193449, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=fe7aa08f73d208a7", "url": "https://translate-dev.freebsd.org/api/units/1193449/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:02.947836Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "In the event that there is already a file called [.filename]#vmcore.0# in [.filename]#/var/crash# (or whatever `dumpdir` is set to), the kernel will increment the trailing number for every crash to avoid overwriting an existing [.filename]#vmcore# (e.g., [.filename]#vmcore.1#). man:savecore[8] will always create a symbolic link to named [.filename]#vmcore.last# in [.filename]#/var/crash# after a dump is saved. This symbolic link can be used to locate the name of the most recent dump." ], "previous_source": "", "target": [ "" ], "id_hash": -6962789137321445162, "content_hash": -6962789137321445162, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:125", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 24, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 69, "source_unit": "https://translate-dev.freebsd.org/api/units/1193338/?format=api", "priority": 100, "id": 1193450, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=1f5f342b8801b8d6", "url": "https://translate-dev.freebsd.org/api/units/1193450/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:02.957870Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The man:crashinfo[8] utility generates a text file containing a summary of information from a full memory dump or minidump. If `dumpdev` has been set in man:rc.conf[5], man:crashinfo[8] will be invoked automatically after man:savecore[8]. The output is saved to a file in `dumpdir` named [.filename]#core.txt.N#." ], "previous_source": "", "target": [ "" ], "id_hash": 4535612230957445618, "content_hash": 4535612230957445618, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:129", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 25, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 44, "source_unit": "https://translate-dev.freebsd.org/api/units/1193340/?format=api", "priority": 100, "id": 1193451, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=bef1bb4b1922b1f2", "url": "https://translate-dev.freebsd.org/api/units/1193451/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:03.053711Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "This instructs man:savecore[8] to extract a kernel dump from [.filename]#/dev/ad0s1b# and place the contents in [.filename]#/var/crash#. Do not forget to make sure the destination directory [.filename]#/var/crash# has enough space for the dump. Also, do not forget to specify the correct path to your swap device as it is likely different than [.filename]#/dev/ad0s1b#!" ], "previous_source": "", "target": [ "" ], "id_hash": 5664515302543640828, "content_hash": 5664515302543640828, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:146", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 28, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 52, "source_unit": "https://translate-dev.freebsd.org/api/units/1193342/?format=api", "priority": 100, "id": 1193452, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=ce9c66a7e0e0c8fc", "url": "https://translate-dev.freebsd.org/api/units/1193452/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:03.349789Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The kernel includes a man:sysctl[8] node that requests a kernel panic. This can be used to verify that your system is properly configured to save kernel crash dumps. You may wish to remount existing file systems as read-only in single user mode before triggering the crash to avoid data loss." ], "previous_source": "", "target": [ "" ], "id_hash": -1762127257649069870, "content_hash": -1762127257649069870, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:153", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 30, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 50, "source_unit": "https://translate-dev.freebsd.org/api/units/1193344/?format=api", "priority": 100, "id": 1193453, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=678baa9866cb40d2", "url": "https://translate-dev.freebsd.org/api/units/1193453/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:03.463026Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "This section covers man:kgdb[1]. The latest version is included in the package:devel/gdb[]. An older version is also present in FreeBSD 11 and earlier." ], "previous_source": "", "target": [ "" ], "id_hash": 260326457937439999, "content_hash": 260326457937439999, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:175", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 34, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 23, "source_unit": "https://translate-dev.freebsd.org/api/units/1193346/?format=api", "priority": 100, "id": 1193454, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=839cdd88c2ff2cff", "url": "https://translate-dev.freebsd.org/api/units/1193454/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:03.664429Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Where _N_ is the suffix of the [.filename]#vmcore.N# to examine. To open the most recent dump use:" ], "previous_source": "", "target": [ "" ], "id_hash": -1572952131153828658, "content_hash": -1572952131153828658, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:186", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 37, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 17, "source_unit": "https://translate-dev.freebsd.org/api/units/1193348/?format=api", "priority": 100, "id": 1193455, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=6a2bc05edde1e4ce", "url": "https://translate-dev.freebsd.org/api/units/1193455/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:03.754118Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Normally, man:kgdb[1] should be able to locate the kernel running at the time the dump was generated. If it is not able to locate the correct kernel, pass the pathname of the kernel and dump as two arguments to kgdb:" ], "previous_source": "", "target": [ "" ], "id_hash": -3682811786776026112, "content_hash": -3682811786776026112, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:194", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 39, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 40, "source_unit": "https://translate-dev.freebsd.org/api/units/1193350/?format=api", "priority": 100, "id": 1193456, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=4ce406313a97e400", "url": "https://translate-dev.freebsd.org/api/units/1193456/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:03.856844Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "This dump is from a 5.2-BETA kernel and the crash comes from deep within the kernel. The output below has been modified to include line numbers on the left. This first trace inspects the instruction pointer and obtains a back trace. The address that is used on line 41 for the `list` command is the instruction pointer and can be found on line 17. Most developers will request having at least this information sent to them if you are unable to debug the problem yourself. If, however, you do solve the problem, make sure that your patch winds its way into the source tree via a problem report, mailing lists, or by being able to commit it!" ], "previous_source": "", "target": [ "این روگرفت از جانب یک هستهٔ 5.2-BETA است و خرابی از عمق خود هسته می‌آید. خروجیِ زیر تغییر داده شده است تا شامل شمارهٔ سطرها در سمت چپ باشد. اولین رد، اشاره‌گر دستور را بررسی می‌کند و یک عقب‌گرد (backtrace) بدست می‌آورد. نشانی‌ای که در سطر 41 برای دستور <command>list</command> به‌کار رفته است اشاره‌گر دستور است و در سطر 17 می‌توان آن را یافت. چنانچه خودتان توان اشکال‌زدایی مشکل را ندارید، بیشتر توسعه‌دهندگان حداقل خواهانِ ارسال این اطلاعات به آنها هستند. چنانچه، در هر صورت، خودتان مشکل را برطرف کردید، اطمینان پیدا کنید که اصلاح شما راه خود را از طریق گزارش مشکل به درخت منبع یا فهرست‌های پست‌سپاری پیدا کند، یا امکان ثبت (commit) آن وجود داشته باشد!" ], "id_hash": 3565530250294219485, "content_hash": 3565530250294219485, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:208", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 42, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 117, "source_unit": "https://translate-dev.freebsd.org/api/units/1193352/?format=api", "priority": 100, "id": 1193457, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=b17b4edf24b252dd", "url": "https://translate-dev.freebsd.org/api/units/1193457/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:03.957127Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "While `kgdb` as an off-line debugger provides a very high level of user interface, there are some things it cannot do. The most important ones being breakpointing and single-stepping kernel code." ], "previous_source": "", "target": [ "با اینکه <command>kgdb</command> به‌عنوان یک اشکال‌زدای برون‌خط سطح بسیار بالایی از رابط کاربری را ارائه می‌دهد، برخی کارها هستند که در انجام آنها ناتوان است. مهم‌ترین آنها شامل نقطهٔ توقف و تک مرحله‌ای کردن کد هسته است." ], "id_hash": 3531781630324494957, "content_hash": 3531781630324494957, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:314", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 46, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 31, "source_unit": "https://translate-dev.freebsd.org/api/units/1193354/?format=api", "priority": 100, "id": 1193458, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=b10368ae3bbdd26d", "url": "https://translate-dev.freebsd.org/api/units/1193458/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:04.253198Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "If you need to do low-level debugging on your kernel, there is an on-line debugger available called DDB. It allows setting of breakpoints, single-stepping kernel functions, examining and changing kernel variables, etc. However, it cannot access kernel source files, and only has access to the global and static symbols, not to the full debug information like `kgdb` does." ], "previous_source": "", "target": [ "چنانچه به اشکال‌زداییِ هسته در سطح پایین نیاز دارید، اشکال‌زدای برخطی به نام DDB وجود دارد که تنظیم کردن نقاط توقف، تک مرحله‌ای کردن توابع هسته، آزمایش و تغییر متغیرهای هسته، و ... را ممکن می‌سازد. هرچند، نمی‌تواند به پرونده‌های منبع هسته دسترسی پیدا کند، و تنها به نمادهای ثابت و جهانی دسترسی دارد، نه به اطلاعات کامل اشکال‌زدایی مانند <command>kgdb</command>." ], "id_hash": -5179702506712698916, "content_hash": -5179702506712698916, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:318", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 47, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 58, "source_unit": "https://translate-dev.freebsd.org/api/units/1193356/?format=api", "priority": 100, "id": 1193459, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=381e00036d306fdc", "url": "https://translate-dev.freebsd.org/api/units/1193459/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:04.350998Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Once your DDB kernel is running, there are several ways to enter DDB. The first, and earliest way is to use the boot flag `-d`. The kernel will start up in debug mode and enter DDB prior to any device probing. Hence you can even debug the device probe/attach functions. To use this, exit the loader's boot menu and enter `boot -d` at the loader prompt." ], "previous_source": "", "target": [ "هنگامی‌که هستهٔ DDB شما در حال اجرا است، روش‌های دیگری برای ورود به DDB است. اولین و ابتدایی‌ترین روش، استفاده از نشانِ boot، یعنی <option>-d</option> است. هسته در حالت اشکال‌زدایی آغاز می‌شود و پیش از هر کاوش‌کردنِ (probing) دستگاهی وارد DDB می‌شود. از این رو حتی می‌توانید توابعِ probe/attach در دستگاه را اشکال‌زدایی کنید. برای استفاده از آن، از صفحهٔ بوتِ بارکن (loader) خارج شوید و <command>boot -d</command> را در پیام‌وارهٔ بارکن بنویسید." ], "id_hash": 7343438116709310220, "content_hash": 7343438116709310220, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:338", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 52, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 66, "source_unit": "https://translate-dev.freebsd.org/api/units/1193360/?format=api", "priority": 100, "id": 1193461, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=e5e9220f58859f0c", "url": "https://translate-dev.freebsd.org/api/units/1193461/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:04.744879Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The second scenario is to drop to the debugger once the system has booted. There are two simple ways to accomplish this. If you would like to break to the debugger from the command prompt, simply type the command:" ], "previous_source": "", "target": [ "حالت دوم زمانی است که سامانه هنگام بالا آمدن وارد اشکال‌زدا شود. دو روش ساده برای رسیدن به این منظور وجود دارد. چنانچه تمایل به خروج از اشکال‌زدا از طریق خط فرمان را دارید، به‌سادگی این دستور را وارد کنید:" ], "id_hash": -4781552806672967290, "content_hash": -4781552806672967290, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:342", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 53, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 39, "source_unit": "https://translate-dev.freebsd.org/api/units/1193362/?format=api", "priority": 100, "id": 1193462, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=3da4830e5b7c5986", "url": "https://translate-dev.freebsd.org/api/units/1193462/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:04.753245Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Alternatively, if you are at the system console, you may use a hot-key on the keyboard. The default break-to-debugger sequence is kbd:[Ctrl+Alt+ESC]. For syscons, this sequence can be remapped and some of the distributed maps out there do this, so check to make sure you know the right sequence to use. There is an option available for serial consoles that allows the use of a serial line BREAK on the console line to enter DDB (`options BREAK_TO_DEBUGGER` in the kernel config file). It is not the default since there are a lot of serial adapters around that gratuitously generate a BREAK condition, for example when pulling the cable." ], "previous_source": "", "target": [ "" ], "id_hash": 8646608069526550702, "content_hash": 8646608069526550702, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:353", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 55, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 108, "source_unit": "https://translate-dev.freebsd.org/api/units/1193364/?format=api", "priority": 100, "id": 1193463, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=f7feec3a4027f8ae", "url": "https://translate-dev.freebsd.org/api/units/1193463/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:04.869389Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The third way is that any panic condition will branch to DDB if the kernel is configured to use it. For this reason, it is not wise to configure a kernel with DDB for a machine running unattended." ], "previous_source": "", "target": [ "روش سوم از این قرار است که چنانچه هسته بدین منظور پیکربندی شده باشد، هر کدام از شروط وحشت به DDB انشعاب کنند. به‌همین دلیل، پیکربندی هسته با DDB برای دستگاهی‌که در حالت اجرای بی‌متصدی است عاقلانه نیست." ], "id_hash": 2108543270829234930, "content_hash": 2108543270829234930, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:356", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 56, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 38, "source_unit": "https://translate-dev.freebsd.org/api/units/1193366/?format=api", "priority": 100, "id": 1193464, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=9d430ceeeb511af2", "url": "https://translate-dev.freebsd.org/api/units/1193464/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:04.953389Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The DDB commands roughly resemble some `gdb` commands. The first thing you probably need to do is to set a breakpoint:" ], "previous_source": "", "target": [ "دستورهای DDB تقریباً شبیه به برخی دستورهای <command>gdb</command> هستند. اولین کاری که احتمالاً لازم است انجام دهید ایجاد یک نقطهٔ توقف است:" ], "id_hash": -5649536988759846418, "content_hash": -5649536988759846418, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:368", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 60, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 21, "source_unit": "https://translate-dev.freebsd.org/api/units/1193368/?format=api", "priority": 100, "id": 1193465, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=3198d00a8f8a11ee", "url": "https://translate-dev.freebsd.org/api/units/1193465/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:05.057561Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Numbers are taken hexadecimal by default, but to make them distinct from symbol names; hexadecimal numbers starting with the letters `a-f` need to be preceded with `0x` (this is optional for other numbers). Simple expressions are allowed, for example: `function-name + 0x103`." ], "previous_source": "", "target": [ "اعداد به‌طور پیش‌فرض شانزده‌شانزدهی هستند، اما جهت متمایز کردن آنها از نام نمادها؛ اعداد شانزده‌شانزدهی‌ای که با حروف <literal>a-f</literal> آغاز می‌شوند باید قبل از <literal>0x</literal> بیایند (این امر برای سایر اعداد اختیاریست). گزاره‌های ساده مجاز هستند، برای مثال: <literal>function-name + 0x103</literal>." ], "id_hash": -1823676158053453826, "content_hash": -1823676158053453826, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:377", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 62, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 42, "source_unit": "https://translate-dev.freebsd.org/api/units/1193370/?format=api", "priority": 100, "id": 1193466, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=66b100324ddfeffe", "url": "https://translate-dev.freebsd.org/api/units/1193466/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:05.152430Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The first form will be accepted immediately after a breakpoint hit, and deletes the current breakpoint. The second form can remove any breakpoint, but you need to specify the exact address; this can be obtained from:" ], "previous_source": "", "target": [ "اولین قالب پس از اصابت نقطهٔ توقف به‌سرعت پذیرفته می‌شود، و نقطهٔ توقف جاری را حذف می‌کند. دومین قالب می‌تواند هر نقطهٔ توقفی را حذف کند، اما لازم است که نشانی دقیق را تعیین کنید؛ این امر را می‌توان بدین شکل بدست آورد:" ], "id_hash": -3905464847320818559, "content_hash": -3905464847320818559, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:404", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 70, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 36, "source_unit": "https://translate-dev.freebsd.org/api/units/1193372/?format=api", "priority": 100, "id": 1193467, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=49cd0069d4aadc81", "url": "https://translate-dev.freebsd.org/api/units/1193467/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:05.456007Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "This is different from ``gdb``'s `next` statement; it is like ``gdb``'s `finish`. Pressing kbd:[n] more than once will cause a continue." ], "previous_source": "", "target": [ "" ], "id_hash": 4093571411854776836, "content_hash": 4093571411854776836, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:435", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 78, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 21, "source_unit": "https://translate-dev.freebsd.org/api/units/1193374/?format=api", "priority": 100, "id": 1193468, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=b8cf4982aa4c5a04", "url": "https://translate-dev.freebsd.org/api/units/1193468/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:05.847215Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "for word/halfword/byte access, and hexadecimal/decimal/character/ string display. The number after the comma is the object count. To display the next 0x10 items, simply use:" ], "previous_source": "", "target": [ "" ], "id_hash": -7081872915626556590, "content_hash": -7081872915626556590, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:450", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 81, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 24, "source_unit": "https://translate-dev.freebsd.org/api/units/1193376/?format=api", "priority": 100, "id": 1193469, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=1db8221ac79e8352", "url": "https://translate-dev.freebsd.org/api/units/1193469/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:06.052918Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Now you have examined why your kernel failed, and you wish to reboot. Remember that, depending on the severity of previous malfunctioning, not all parts of the kernel might still be working as expected. Perform one of the following actions to shut down and reboot your system:" ], "previous_source": "", "target": [ "حال، دلیل خراب شدن هستهٔ خود را مورد بررسی قرار دادید و می‌توانید سامانه را مجدد راه‌اندازی کنید. به‌یاد داشته باشید که با توجه به شدت خرابی پیشین، ممکن است تمام بخش‌های هسته همانطور که انتظار می‌رود کار نکنند. یک کدام از اعمال پیش رو را انجام دهید تا سامانه را خاموش و مجدد راه‌اندازی کنید:" ], "id_hash": -5526929200531829718, "content_hash": -5526929200531829718, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:516", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 100, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 47, "source_unit": "https://translate-dev.freebsd.org/api/units/1193378/?format=api", "priority": 100, "id": 1193470, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=334c672ccf910c2a", "url": "https://translate-dev.freebsd.org/api/units/1193470/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:07.055898Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Might be a good way to cleanly shut down the running system, `sync()` all disks, and finally, in some cases, reboot. As long as the disk and filesystem interfaces of the kernel are not damaged, this could be a good way for an almost clean shutdown." ], "previous_source": "", "target": [ "ممکن است راه مناسبی برای تمیز خاموش کردن سامانهٔ در حال اجرا باشد، تمام دیسک‌ها را <function>sync()</function> کنید، در برخی موارد، مجدد راه اندازی کنید. تا آنجا که رابط‌های دیسک و سامانهٔ پروندهٔ هسته آسیب ندیده باشند، این روش می‌تواند راه مناسبی برای خاموش کردن تقریباً تمیز باشد." ], "id_hash": -5984816259470374258, "content_hash": -5984816259470374258, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:531", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 104, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 46, "source_unit": "https://translate-dev.freebsd.org/api/units/1193380/?format=api", "priority": 100, "id": 1193471, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=2cf1a95228494a8e", "url": "https://translate-dev.freebsd.org/api/units/1193471/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:07.359220Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "It is highly recommended to have a printed copy of the man:ddb[4] manual page ready for a debugging session. Remember that it is hard to read the on-line manual while single-stepping the kernel." ], "previous_source": "", "target": [ "" ], "id_hash": -233623505148067867, "content_hash": -233623505148067867, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:548", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 109, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 33, "source_unit": "https://translate-dev.freebsd.org/api/units/1193382/?format=api", "priority": 100, "id": 1193472, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=7cc200a8ec77bfe5", "url": "https://translate-dev.freebsd.org/api/units/1193472/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:07.651341Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Since you need a console driver to run DDB on, things are more complicated if the console driver itself is failing. You might remember the use of a serial console (either with modified boot blocks, or by specifying `-h` at the `Boot:` prompt), and hook up a standard terminal onto your first serial port. DDB works on any configured console driver, including a serial console." ], "previous_source": "", "target": [ "از آنجاکه شما به یک گردانندهٔ پیشانه نیاز دارید تا DDB را بر روی آن اجرا کنید، اگر گردانندهٔ پیشانه خراب شود مسائل پیچیده‌تر می‌شود. ممکن است استفاده از پیشانهٔ سریال (یا با قطعه‌های آغازِ تغییریافته، یا با مشخص کردنِ <option>-h</option> در پیام وارهٔ <prompt>Boot:</prompt>)، و متصل کردن یک پایانهٔ استاندارد به اولین درگاه سریال خود را به خاطر داشته باشید. DDB بر روی هر گردانندهٔ پیشانهٔ پیکر‌بندی‌شده کار می‌کند." ], "id_hash": 8627124673991061421, "content_hash": 8627124673991061421, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:647", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 131, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 65, "source_unit": "https://translate-dev.freebsd.org/api/units/1193390/?format=api", "priority": 100, "id": 1193476, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=f7b9b42eba3eafad", "url": "https://translate-dev.freebsd.org/api/units/1193476/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:08.450162Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "You may experience so called deadlocks, a situation where a system stops doing useful work. To provide a helpful bug report in this situation, use man:ddb[4] as described in the previous section. Include the output of `ps` and `trace` for suspected processes in the report." ], "previous_source": "", "target": [ "" ], "id_hash": 4635025437151360121, "content_hash": 4635025437151360121, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:654", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 133, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 45, "source_unit": "https://translate-dev.freebsd.org/api/units/1193392/?format=api", "priority": 100, "id": 1193477, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=c052eb13e24e7479", "url": "https://translate-dev.freebsd.org/api/units/1193477/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:08.546340Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "If possible, consider doing further investigation. The recipe below is especially useful if you suspect that a deadlock occurs in the VFS layer. Add these options to the kernel configuration file." ], "previous_source": "", "target": [ "اگر ممکن است، تحقیقات بیشتری را مد نظر قرار دهید. اگر مشکوک به رخ دادن بن‌بست در لایهٔ VFS هستید، رهنمود زیر به‌طور خاص مناسب است. این گزینه‌ها را به پروندهٔ پیکربندیِ هسته اضافه کنید." ], "id_hash": -2388268878746146349, "content_hash": -2388268878746146349, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:658", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 134, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 31, "source_unit": "https://translate-dev.freebsd.org/api/units/1193394/?format=api", "priority": 100, "id": 1193478, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=5edb2a1bbe3729d3", "url": "https://translate-dev.freebsd.org/api/units/1193478/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:08.554232Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "man:dcons[4] is a very simple console driver that is not directly connected with any physical devices. It just reads and writes characters from and to a buffer in a kernel or loader. Due to its simple nature, it is very useful for kernel debugging, especially with a FireWire(R) device. Currently, FreeBSD provides two ways to interact with the buffer from outside of the kernel using man:dconschat[8]." ], "previous_source": "", "target": [ "" ], "id_hash": -198851919097673976, "content_hash": -198851919097673976, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:682", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 139, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 66, "source_unit": "https://translate-dev.freebsd.org/api/units/1193396/?format=api", "priority": 100, "id": 1193479, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=7d3d893baf474708", "url": "https://translate-dev.freebsd.org/api/units/1193479/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:08.755090Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Most FireWire(R) (IEEE1394) host controllers are based on the OHCI specification that supports physical access to the host memory. This means that once the host controller is initialized, we can access the host memory without the help of software (kernel). We can exploit this facility for interaction with man:dcons[4]. man:dcons[4] provides similar functionality as a serial console. It emulates two serial ports, one for the console and DDB, the other for GDB. Since remote memory access is fully handled by the hardware, the man:dcons[4] buffer is accessible even when the system crashes." ], "previous_source": "", "target": [ "" ], "id_hash": 3809018050849014267, "content_hash": 3809018050849014267, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:691", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 141, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 92, "source_unit": "https://translate-dev.freebsd.org/api/units/1193398/?format=api", "priority": 100, "id": 1193480, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=b4dc59bc77e801fb", "url": "https://translate-dev.freebsd.org/api/units/1193480/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:08.851371Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "FireWire(R) devices are not limited to those integrated into motherboards. PCI cards exist for desktops, and a cardbus interface can be purchased for laptops." ], "previous_source": "", "target": [ "" ], "id_hash": 3650064407362868425, "content_hash": 3650064407362868425, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:694", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 142, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 24, "source_unit": "https://translate-dev.freebsd.org/api/units/1193400/?format=api", "priority": 100, "id": 1193481, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=b2a7a23d582914c9", "url": "https://translate-dev.freebsd.org/api/units/1193481/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:19.359768Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Here are a few configuration examples. A sample kernel configuration file would contain:" ], "previous_source": "", "target": [ "در اینجا چند نمونه پیکربندی آمده است. یک نمونه پروندهٔ پیکربندی هستهٔ ساده شامل:" ], "id_hash": 8925792965324875914, "content_hash": 8925792965324875914, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:719", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 155, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 13, "source_unit": "https://translate-dev.freebsd.org/api/units/1193402/?format=api", "priority": 100, "id": 1193482, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=fbdec9693cdea88a", "url": "https://translate-dev.freebsd.org/api/units/1193482/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:19.766828Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "We can directly read the man:dcons[4] buffer via [.filename]#/dev/mem# for live systems, and in the core dump for crashed systems. These give you similar output to `dmesg -a`, but the man:dcons[4] buffer includes more information." ], "previous_source": "", "target": [ "" ], "id_hash": -3856135866529900392, "content_hash": -3856135866529900392, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:821", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 183, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 35, "source_unit": "https://translate-dev.freebsd.org/api/units/1193404/?format=api", "priority": 100, "id": 1193483, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=4a7c40dc2dd79898", "url": "https://translate-dev.freebsd.org/api/units/1193483/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:32:20.361829Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "`options KASAN`: enable the Kernel Address Sanitizer. This enables compiler instrumentation which can be used to detect invalid memory accesses in the kernel, such as use-after-frees and buffer overflows. This largely supersedes `options DEBUG_MEMGUARD`. See man:kasan[9] for details, and for the currently supported platforms." ], "previous_source": "", "target": [ "" ], "id_hash": 4027697137128292809, "content_hash": 4027697137128292809, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:869", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 209, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 44, "source_unit": "https://translate-dev.freebsd.org/api/units/1251156/?format=api", "priority": 100, "id": 1251162, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=b7e54134e163c1c9", "url": "https://translate-dev.freebsd.org/api/units/1251162/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-09-18T19:15:15.793339Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "`options KMSAN`: enable the Kernel Memory Sanitizer. This enables compiler instrumentation which can be used to detect uses of uninitialized memory. See man:kmsan[9] for details, and for the currently supported platforms." ], "previous_source": "", "target": [ "" ], "id_hash": -2313635408378763329, "content_hash": -2313635408378763329, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:869", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 210, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 31, "source_unit": "https://translate-dev.freebsd.org/api/units/1251158/?format=api", "priority": 100, "id": 1251163, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=5fe450daafd167bf", "url": "https://translate-dev.freebsd.org/api/units/1251163/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-09-18T19:15:15.800745Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "to your config file, and rebuild. (See extref:{handbook}[The FreeBSD Handbook] for details on configuring the FreeBSD kernel)." ], "previous_source": "", "target": [ "" ], "id_hash": 8328712170473701927, "content_hash": 8328712170473701927, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:332", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 51, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 17, "source_unit": "https://translate-dev.freebsd.org/api/units/1253198/?format=api", "priority": 100, "id": 1253251, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=f3958797758ec227", "url": "https://translate-dev.freebsd.org/api/units/1253251/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:03.887177Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The FreeBSD kernel provides a second KDB backend for on-line debugging: man:gdb[4]. This feature has been supported since FreeBSD 2.2, and it is actually a very neat one." ], "previous_source": "This feature has been supported since FreeBSD 2.2, and it is actually a very neat one.", "target": [ "این امکان از زمان FreeBSD 2.2 پشتیبانی می‌شود، و در واقع یک امکان بسیار هوشمندانه است." ], "id_hash": -352032692029475477, "content_hash": -352032692029475477, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:554", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 111, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 28, "source_unit": "https://translate-dev.freebsd.org/api/units/1253200/?format=api", "priority": 100, "id": 1253252, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=7b1d5421ba42356b", "url": "https://translate-dev.freebsd.org/api/units/1253252/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.159314Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "GDB has supported _remote debugging_ for a long time. This is done using a very simple protocol along a serial line. Unlike the other debugging methods described above, you will need two machines for doing this. One is the host providing the debugging environment, including all the sources, and a copy of the kernel binary with all the symbols in it. The other is the target machine that runs a copy of the very same kernel (optionally stripped of the debugging information)." ], "previous_source": "", "target": [ "GDB مدت‌هاست که <emphasis>اشکال‌زدایی از راه دور</emphasis> را پشتیبانی می‌کند. این امر با استفاده از یک قرارداد بسیار ساده در کنار خط سریال صورت می‌گیرد. برخلاف سایر روش‌هایی که در بالا تشریح شده است، شما برای انجام آن نیاز به دو دستگاه دارید. یکی میزبانی است که محیط اشکال‌زدایی را فراهم می‌کند، شامل تمام منابع، و یک نسخه از دودوییِ هسته با تمام نمادها درونش می‌شود، و دیگری دستگاه هدفی است که یک نسخهٔ مشابه از همان هسته را اجرا می‌کند (اما فاقد اطلاعات اشکال‌زدایی)." ], "id_hash": 7533493010922904100, "content_hash": 7533493010922904100, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:560", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 10, "fuzzy": true, "translated": false, "approved": false, "position": 112, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 82, "source_unit": "https://translate-dev.freebsd.org/api/units/1253202/?format=api", "priority": 100, "id": 1253253, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=e88c57fab1f29a24", "url": "https://translate-dev.freebsd.org/api/units/1253253/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.165950Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "In order to use remote GDB, ensure that the following options are present in your kernel configuration:" ], "previous_source": "", "target": [ "" ], "id_hash": 5398313879314040155, "content_hash": 5398313879314040155, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:562", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 113, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 17, "source_unit": "https://translate-dev.freebsd.org/api/units/1253204/?format=api", "priority": 100, "id": 1253254, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=caeaa9df2a93055b", "url": "https://translate-dev.freebsd.org/api/units/1253254/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.171413Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "makeoptions DEBUG=-g\noptions KDB\noptions GDB\n" ], "previous_source": "", "target": [ "" ], "id_hash": 8322731124342098501, "content_hash": 8322731124342098501, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:567", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 114, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 6, "source_unit": "https://translate-dev.freebsd.org/api/units/1253206/?format=api", "priority": 100, "id": 1253255, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=f38047dca37f8a45", "url": "https://translate-dev.freebsd.org/api/units/1253255/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.174653Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Note that the `GDB` option is turned off by default in `GENERIC` kernels on -STABLE and -RELEASE branches, but enabled on -CURRENT." ], "previous_source": "", "target": [ "" ], "id_hash": -6930172421620075163, "content_hash": -6930172421620075163, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:570", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 115, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 22, "source_unit": "https://translate-dev.freebsd.org/api/units/1253208/?format=api", "priority": 100, "id": 1253256, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=1fd314e671207565", "url": "https://translate-dev.freebsd.org/api/units/1253256/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.177664Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Once built, copy the kernel to the target machine, and boot it. Connect the serial line of the target machine that has \"flags 080\" set on its uart device to any serial line of the debugging host. See man:uart[4] for information on how to set the flags on a uart device." ], "previous_source": "", "target": [ "" ], "id_hash": 1812070427944085181, "content_hash": 1812070427944085181, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:574", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 116, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 51, "source_unit": "https://translate-dev.freebsd.org/api/units/1253210/?format=api", "priority": 100, "id": 1253257, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=9925c4741598e6bd", "url": "https://translate-dev.freebsd.org/api/units/1253257/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.181377Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The target machine must be made to enter the GDB backend, either due to a panic or by taking a purposeful trap into the debugger. Before doing this, select the GDB debugger backend:" ], "previous_source": "", "target": [ "" ], "id_hash": -3467317070440185935, "content_hash": -3467317070440185935, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:577", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 117, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 33, "source_unit": "https://translate-dev.freebsd.org/api/units/1253212/?format=api", "priority": 100, "id": 1253258, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=4fe19d7ebcc3bfb1", "url": "https://translate-dev.freebsd.org/api/units/1253258/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.217834Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "# sysctl debug.kdb.current=gdb\ndebug.kdb.current: ddb -> gdb\n" ], "previous_source": "", "target": [ "" ], "id_hash": -696288623343671618, "content_hash": -696288623343671618, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:581", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 118, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 7, "source_unit": "https://translate-dev.freebsd.org/api/units/1253214/?format=api", "priority": 100, "id": 1253259, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=7656492fa87466be", "url": "https://translate-dev.freebsd.org/api/units/1253259/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.221802Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The supported backends can be listed by the `debug.kdb.available` sysctl. If the kernel configuration includes `options DDB`, then man:ddb[4] will be selected by default. If `gdb` does not appear in the list of available backends, then the debug serial port may not have been configured correctly." ], "previous_source": "", "target": [ "" ], "id_hash": -7218124733934394552, "content_hash": -7218124733934394552, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:588", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 119, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 46, "source_unit": "https://translate-dev.freebsd.org/api/units/1253216/?format=api", "priority": 100, "id": 1253260, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=1bd411cc39612348", "url": "https://translate-dev.freebsd.org/api/units/1253260/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.225081Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "Then, force entry to the debugger:" ], "previous_source": "", "target": [ "" ], "id_hash": -4409532443334674692, "content_hash": -4409532443334674692, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:591", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 120, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 6, "source_unit": "https://translate-dev.freebsd.org/api/units/1253218/?format=api", "priority": 100, "id": 1253261, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=42ce319b0179f6fc", "url": "https://translate-dev.freebsd.org/api/units/1253261/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.228483Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "# sysctl debug.kdb.enter=1\ndebug.kdb.enter: 0KDB: enter: sysctl debug.kdb.enter\n" ], "previous_source": "", "target": [ "" ], "id_hash": -1295558010695243948, "content_hash": -1295558010695243948, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:595", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 121, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 8, "source_unit": "https://translate-dev.freebsd.org/api/units/1253220/?format=api", "priority": 100, "id": 1253262, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=6e0540da7a992754", "url": "https://translate-dev.freebsd.org/api/units/1253262/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.231591Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbookkerneldebug_index/fa/?format=api", "source": [ "The target machine now awaits connection from a remote GDB client. On the debugging machine, go to the compile directory of the target kernel, and start `gdb`:" ], "previous_source": "", "target": [ "" ], "id_hash": -4820396904489052933, "content_hash": -4820396904489052933, "location": "documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:599", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 122, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 27, "source_unit": "https://translate-dev.freebsd.org/api/units/1253222/?format=api", "priority": 100, "id": 1253263, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbookkerneldebug_index/fa/?checksum=3d1a828e0f8994fb", "url": "https://translate-dev.freebsd.org/api/units/1253263/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-11-05T00:49:04.235130Z" } ] }