Упс как расшифровать. УПС и ИБП: особенности, принцип работы и виды источников бесперебойного питания

, также известное как «процентное кодирование», представляет собой механизм кодирования информации в унифицированном идентификаторе ресурса (URI). Хотя это называется кодированием URL-адресов, на самом деле оно используется более широко в основном наборе универсальных идентификаторов ресурсов (URI), который включает как универсальный указатель ресурсов (URL), так и универсальное имя ресурса (URN). Как таковой, он также используется при подготовке данных типа носителя «application / x-www-form-urlencoded», как это часто бывает при отправке данных HTML-формы в HTTP-запросах.

Дополнительные параметры

• Набор символов: В случае текстовых данных схема кодирования не содержит набор символов, поэтому вы должны указать, какой набор символов использовался в процессе кодирования. Обычно это UTF-8, но может быть и множество других; если вы не уверены, поиграйте с доступными опциями или попробуйте опцию автоопределения. Эта информация используется для преобразования декодированных данных в набор символов нашего веб-сайта, чтобы все буквы и символы могли отображаться правильно.Обратите внимание, что это не имеет отношения к файлам, поскольку к ним не нужно применять безопасные веб-преобразования.
• Декодировать каждую строку отдельно: Закодированные данные обычно состоят из непрерывного текста, поэтому даже символы новой строки преобразуются в их формы с процентной кодировкой. Перед декодированием все незакодированные пробелы удаляются из ввода для защиты целостности ввода. Эта опция полезна, если вы собираетесь декодировать несколько независимых записей данных, разделенных переносом строки.
• Живой режим: Когда вы включаете эту опцию, введенные данные немедленно декодируются с помощью встроенных функций JavaScript вашего браузера, без отправки какой-либо информации на наши серверы. В настоящее время этот режим поддерживает только набор символов UTF-8.

Все коммуникации с нашими серверами осуществляются через безопасные зашифрованные соединения SSL (https). Мы удаляем загруженные файлы с наших серверов сразу после обработки, а полученный загружаемый файл удаляется сразу после первой попытки загрузки или 15 минут бездействия (в зависимости от того, что короче).Мы никоим образом не храним и не проверяем содержимое отправленных данных или загруженных файлов. Ознакомьтесь с нашей политикой конфиденциальности ниже для получения более подробной информации.

Совершенно бесплатно

Наш инструмент можно использовать бесплатно. Отныне для таких простых задач не нужно скачивать никакого программного обеспечения.

Подробная информация о кодировке URL-адресов

Типы символов URI

Допустимые символы в URI либо зарезервированы, либо не зарезервированы (или символ процента как часть процентного кодирования).Зарезервированные символы — это символы, которые иногда имеют особое значение. Например, символы прямой косой черты используются для разделения разных частей URL-адреса (или, в более общем смысле, URI). Незарезервированные символы не имеют такого особого значения. При использовании процентного кодирования зарезервированные символы представляются с помощью специальных последовательностей символов. Наборы зарезервированных и незарезервированных символов, а также обстоятельства, при которых определенные зарезервированные символы имеют особое значение, немного меняются с каждой новой редакцией спецификаций, управляющих URI и схемами URI.

Зарезервированные символы с процентным кодированием

Когда символ из зарезервированного набора («зарезервированный символ») имеет особое значение («зарезервированное назначение») в конкретном контексте, а схема URI говорит, что необходимо использовать это символ для какой-либо другой цели, тогда этот символ должен быть закодирован в процентах. Процентное кодирование зарезервированного символа означает преобразование символа в соответствующее ему байтовое значение в ASCII и последующее представление этого значения в виде пары шестнадцатеричных цифр.Цифры, которым предшествует знак процента («%»), затем используются в URI вместо зарезервированного символа. (Для символа, отличного от ASCII, он обычно преобразуется в свою последовательность байтов в UTF-8, а затем каждое значение байта представляется, как указано выше.)

Зарезервированный символ «/», например, если он используется в пути « «компонент URI, имеет особое значение как разделитель между сегментами пути. Если в соответствии с заданной схемой URI «/» должен находиться в сегменте пути, тогда в этом сегменте должны использоваться три символа «% 2F» (или «% 2f») вместо «/».

В компоненте «запрос» URI (часть после символа «?»), Например, «/» по-прежнему считается зарезервированным символом, но обычно не имеет зарезервированного назначения (если в конкретной схеме URI не указано иное). Символ не нужно кодировать в процентах, если он не имеет зарезервированной цели.

URI, которые различаются только тем, является ли зарезервированный символ закодированным в процентах или нет, обычно считаются неэквивалентными (обозначающими один и тот же ресурс), кроме случаев, когда рассматриваемые зарезервированные символы не имеют зарезервированной цели.Это определение зависит от правил, установленных для зарезервированных символов отдельными схемами URI.

Процентное кодирование незарезервированных символов

Символы из незарезервированного набора никогда не нуждаются в процентном кодировании.

URI, которые различаются только тем, является ли незарезервированный символ закодированным в процентах или нет, эквивалентны по определению, но процессоры URI на практике не всегда могут обрабатывать их одинаково. Например, потребители URI не должны обрабатывать «% 41» иначе, чем «A» («% 41» — это процентное кодирование «A») или «% 7E» иначе, чем «~», но некоторые это делают.Поэтому для максимальной совместимости производителям URI не рекомендуется использовать процентное кодирование незарезервированных символов.

Процентное кодирование символа процента

Поскольку символ процента («%») служит индикатором для октетов, закодированных в процентах, он должен быть закодирован в процентах как «% 25», чтобы этот октет использовался в качестве данных в URI.

Процентное кодирование произвольных данных

Большинство схем URI включают представление произвольных данных, таких как IP-адрес или путь файловой системы, как компоненты URI.Спецификации схемы URI должны, но часто этого не делать, предоставлять явное сопоставление между символами URI и всеми возможными значениями данных, представленными этими символами.

Двоичные данные

С момента публикации RFC 1738 в 1994 году было указано, что схемы, которые обеспечивают представление двоичных данных в URI, должны разделять данные на 8-битные байты и кодировать каждый байт в процентах в таким же образом, как указано выше. Например, байтовое значение 0F (шестнадцатеричное) должно быть представлено как «% 0F», а байтовое значение 41 (шестнадцатеричное) может быть представлено как «A» или «% 41».Использование незакодированных символов для буквенно-цифровых и других незарезервированных символов обычно предпочтительнее, поскольку это приводит к более коротким URL-адресам.

Символьные данные

Процедура процентного кодирования двоичных данных часто экстраполировалась, иногда неправильно или не полностью, для применения к символьным данным. В годы становления Всемирной паутины при работе с символами данных в репертуаре ASCII и использовании соответствующих им байтов в ASCII в качестве основы для определения последовательностей, закодированных в процентах, эта практика была относительно безвредной; многие предполагали, что символы и байты взаимно однозначно сопоставлены и взаимозаменяемы.Однако потребность в представлении символов вне диапазона ASCII быстро росла, и схемы и протоколы URI часто не обеспечивали стандартных правил подготовки символьных данных для включения в URI. В результате веб-приложения начали использовать различные многобайтовые кодировки, кодировки с отслеживанием состояния и другие несовместимые с ASCII кодировки в качестве основы для процентного кодирования, что привело к двусмысленностям, а также затруднило надежную интерпретацию URI.

Например, многие схемы и протоколы URI, основанные на RFC 1738 и 2396, предполагают, что символы данных будут преобразованы в байты в соответствии с некоторой неопределенной кодировкой символов, прежде чем будут представлены в URI незарезервированными символами или байтами, закодированными в процентах.Если схема не позволяет URI предоставлять подсказку о том, какая кодировка использовалась, или если кодировка конфликтует с использованием ASCII для процентного кодирования зарезервированных и незарезервированных символов, то URI не может быть надежно интерпретирован. Некоторые схемы вообще не учитывают кодирование и вместо этого просто предлагают, чтобы символы данных отображались непосредственно на символы URI, что оставляет на усмотрение отдельных пользователей решать, следует ли и как процентно кодировать символы данных, которые не входят ни в зарезервированные, ни в незарезервированные наборы.

утилита для декодирования ядра Linux Упс ………

ksymoops — утилита для декодирования ядра Linux Oops

ОБЗОР

ksymoops
[ -v vmlinux ] [ —vmlinux = vmlinux ] [ -V ] [ —no-vmlinux ]
[ -k ksyms ] [ —ksyms = ksyms ] [ -K ] [ —no-ksyms ]
[ -l lsmod ] [ —lsmod = lsmod ] [ -L ] [ —no-lsmod ]
[ -o объект ] [ —object = object ] [ -O ] [ —объект ]
[ -м система.карта ] [ —system-map = system.map ] [ -M ] [ —no-system-map ]
[ -s save.map ] [ —save-map = save.map ]
[ -S ] [ —short-lines ]
[ -e ] [ —endian-swap ]
[ -x ] [ —hex ]
[-1 ] [ —однокадровый ]
[ -i ] [ —ignore-insmod-path ]
[ -I ] [ —ignore-insmod-all ]
[ -T truncate ] [ —truncate = усечь ]
[ -d ] [ —debug ]
[ -h ] [ —help ]
[ -t target ] [ —target = цель ]
[ -a архитектура ] [ —architecture = архитектура ]
[ -A «список адресов» ] [ —addresses = «адрес список «]
[ Ой.файл … ]

ОПИСАНИЕ

ksymoops извлекает отчеты ядра Oops из файла Oops и использует различные источники символьной информации для преобразования адреса и код в осмысленный текст. Сообщение о ядре Упс бессмысленно сам по себе, потому что другие люди не знаете, как выглядит ваше ядро, вам нужно кормить Oops текст через ksymoops, затем отправьте вывод ksymoops как часть вашего отчета об ошибке.

Ksymoops исполняемый файл предназначен для запуска всякий раз, когда у вас есть Oops to отчет.Исходный текст Oops может быть откуда угодно. Обычно он находится в файле, созданном вашим syslogd (8). Если syslogd недоступен, журнал может быть доступен через dmesg (8). Если вы используете последовательную консоль (см. linux / Documentation / serial-console.txt), вы можете записать текст «Ой» на другом компьютере. Если ничего не помогает, скопируйте Упс вручную с экрана перезагружаемся и вводим по рука.

ksymoops может быть запускается любым, у кого есть доступ для чтения к различным входам файлы. Его не нужно запускать с правами root.

ОПЦИИ

Некоторые из параметры имеют значения по умолчанию, которые задаются в Makefile. Текст ниже описывает стандартные значения по умолчанию, но ваш дистрибутив мог быть изменен для использования другого по умолчанию. В случае сомнений ksymoops -h перечислит текущие значения по умолчанию.

Первые 10 варианты ( -v , -V , -k , -K , -l , -L , -o , -O , -м , -M или соответствующие длинные формы) составляют 5 пар.В параметры нижнего регистра (вклом) принимают значение и включают параметр на, варианты верхнего регистра (ВКЛОМ) не имеют значения и включаются опция выключена. Если вы укажете и нижний, и верхний регистр версии одного и того же варианта, то используется последний, но вас предупреждают, что это может быть не то, что вы намеревались.

ksymoops будет бежать вполне счастливо, без вариантов. Однако есть риск что значения по умолчанию для источников символов не могут быть подходящее. Поэтому, если ни один из -v vmlinux , -V , -k ksyms , -K , -l lsmod , -L , -о объект , -O , -м система.указана карта или -М , ksymoops выводит предупреждающее сообщение.

Если любой из -v vmlinux , -k ksyms , -l lsmod , -o объект или -m system.map options содержат строку * r (* m, * n, * s), тогда строка заменяется во время выполнения на текущее значение ‘uname -r‘ (-m, -n, -s). Это в основном предназначено для того, чтобы ksymoops автоматически подбирать файлы, зависящие от версии, используя значение по умолчанию параметры, однако он может использоваться для сообщений об ошибках скрипты для автоматического выбора файлов, чьи имена или каталог зависит от текущего ядра.
-v vmlinux —vmlinux = vmlinux

Имя файла vmlinux, который соответствует отказавшему ядру. Примечание: Это файл vmlinux, а не zImage, bzImage, vmlinuz и т. д. Обычно это / usr / src / linux / vmlinux. если ты укажите -v , вы должны указать его только один раз.

-V —no-vmlinux

Не читать никакие vmlinux файл.

По умолчанию -В .
-k ksyms —ksyms = ksyms

Где найти список символы ядра на момент сбоя. К сожалению, список символов ядра в / proc / ksyms непостоянен, он обновляется по мере загрузки и удаления модулей. Попробуй скопировать / proc / ksyms в обычный файл как можно скорее после Oops и укажите ksymoops на этой копии, используя -k . Modutils имеет поддержка автоматического копирования данных ksyms и lsmod, см. insmod (8). Если вам пришлось перезагружаться после Oops, и вы делаете у вас нет копии / proc / ksyms на момент сообщения Упс, попробуйте чтобы перезагрузить те же модули в том же порядке перед запуском ksymoops.Если вы укажете -k , вы должны указать только это однажды.

-К —no-ksyms

Не читаю никакое ядро символы.

По умолчанию -к / proc / ksyms .
-l lsmod —lsmod = lsmod

Где найти список загруженные модули на момент выхода из строя. К сожалению, список в / proc / modules непостоянен, он обновляется как модули загружаются и удаляются. Попробуйте скопировать / proc / modules в нормальный файл как можно скорее после Oops и point ksymoops в этой копии, используя -l .Modutils имеет поддержку для автоматического копирования данных ksyms и lsmod см. insmod (8). Если вам пришлось перезагружаться после Oops, и вы делаете у вас нет копии / proc / modules на момент сообщения Oops, попробуйте перезагрузить те же модули в том же порядке перед работает ksymoops. Если вы укажете -l , вы должны только укажите это один раз.

-L —no-lsmod

Не читать список загруженных модули.

По умолчанию -l / proc / modules .
-o объект —object = объект

Где найти предметы для модули, используемые отказавшим ядром.Это может быть каталог имя или отдельный файл. Если это каталог, то ksymoops выполняет рекурсивный находит (1) в этом каталоге для всех файлы, соответствующие ’* .o’. -o можно указать более одного раза, список является накопительным и может содержать смесь каталогов и файлов.

Примечание: Когда вы указываете каталог, ksymoops использует только файлы, заканчиваться на ‘.o’. Любые модули с нестандартными названиями игнорируются, если вы не укажете эти файлы явно. Для Например, если модули vmnet и vmmon не заканчиваются на ‘.о, тебе нужно что-то вроде этого, чтобы забрать все нормальные модули плюс нестандартные имена.

-o / lib / modules / * r / \
-o / lib / modules / * r / misc / vmnet \
-o / lib / modules / * r / misc / vmmon

Если вы используя версию insmod (8), в которой хранится имя файла модуля в / proc / ksyms, ksymoops может перейти непосредственно к этому файлу, это не нужен -о . Опция -o используется только когда ksyms содержит хотя бы один модуль, имя файла которого не указаны явно в ksyms.

-O —объект

Не сканировать никакие объекты. Если Поставляется / proc / ksyms, а insmod добавил ksymoops символы помощи (начинающиеся с __insmod), затем те символы используются для доступа к объектам, без каталога сканирование выполняется, поэтому ни -o, ни -O не действуют. К полностью отключить использование объектов модуля при ksyms содержит символы __insmod, укажите -O и один из -i или -I.

По умолчанию -o / lib / modules / * r / .Например, если uname -r сообщает 2.2.7, ksymoops использует -o /lib/modules/2.2.7/ , но только если он еще не знает, где находятся объекты.
-m system.map —system-map = system.map

Где найти System.map соответствующий отказавшему ядру.

-M —no-system-map

Не читайте System.map.

По умолчанию -m / usr / src / linux / System.карта .
-s save.map —save-map = save.map

После того, как ksymoops прочитает все источники символов, он генерирует внутреннюю системную карту который содержит все из System.map плюс лучший попытаться извлечь все символы из всех загруженных модулей. Если вы хотите увидеть эту сводную карту, укажите -s save.map для записи сохранить.карта . Сохранять карту для нормальной работы не нужно. сообщение об ошибке.

По умолчанию нет сохраненная карта.
-S — короткие линии

Некоторые выходные данные ksymoops строки могут быть довольно длинными, особенно при дизассемблировании кода, но если у вас широкий экран, вывод ksymoops проще читать как длинные строки. Переключатель -S переключает между короткие и длинные строки. Обратите внимание, что строки, напечатанные ядром и извлеченные из файла Oops. не затрагиваются -S , текст проблемы печатается как есть.

По умолчанию короткие строки.
-e —endian-swap

ksymoops извлекает байты кода из отчетов и преобразует их в инструкции. Все ядра печатают байты кода в шестнадцатеричном формате, но, к сожалению, некоторые системы печатают несколько байтов, используя собственный компьютер порядок байтов. Это вызывает проблему только в том случае, если код напечатан. чем угодно, кроме 1 байтовых блоков. Например, i386 печатает по одному байту за раз, что переносимо на машине, альфа печатает 4 байта в нативном порядке байтов и отчет не переносная машина.

Если вы выполняет кросс-системную диагностику (скажем, для новой системы или встроенная версия Linux), затем неисправная система и система отчетов может иметь разный порядок байтов. На системы, которые одновременно поддерживают малый и большой порядок байтов время, ksymoops может быть скомпилирован с одним порядком байтов, но Дамп ядра мог использовать другой. Если ваш дизассемблер кода неверно, укажите -е . -e переключает между нативный и обратный порядок байтов при чтении байтов в каждом кусок кода.В этом контексте фрагмент кода равен 4 или 8. шестнадцатеричные цифры (2 или 4 байта кода), -e не действует в коде, который печатается как 2 шестнадцатеричные цифры (один байт в время).

Примечание: Более ранние версии ksymoops использовали -c code_bytes опция. Это сейчас устарело, используйте вместо него -e , но только если код разборка некорректна.

По умолчанию читать байты кода, используя порядок байтов, который был в ksymoops скомпилирован с помощью.
-x —hex

Обычно ksymoops печатает смещения и длины в шестнадцатеричном формате.Если вам нужны смещения и длины для печати в десятичном формате используйте переключатель -x .

По умолчанию шестнадцатеричный.
-1 — однократный

Обычно ksymoops читает его весь входной файл и извлекает все отчеты Oops. Если -1 переключатель установлен, он будет работать в режиме одного выстрела и выйдет после первый Ой. Это полезно для автоматической рассылки сообщает, как они происходят, например: —

#! / Bin / sh
# ksymoops1
в то время как (правда)
do

done

хвост -f / var / log / messages | ksymoops1

Перезапуск Команда tail после ротации бревен оставлена ​​в качестве упражнения для читатель.

Одним выстрелом в режиме, чтение различных источников символов откладывается до тех пор, пока ksymoops видит первый счетчик программы, трассировку вызовов или код линия. Это гарантирует, что текущая информация о модуле использовал. Обратной стороной является то, что никаких ошибок параметров не происходит. обнаружен до тех пор, пока не произойдет ошибка.

По умолчанию читать все из файла Oops.file, распаковывая и обрабатывает все, что найдет. Обратите внимание, что метод по умолчанию читает источники символов один раз и предполагает, что окружающая среда не меняется от одного упа к другому, не обязательно действителен, когда вы используете модули.
-i —ignore-insmod-path

Когда вы используете начальную ramdisk для модулей, путь к модулям обычно просто / lib. Этот путь записан в __insmod …_ символ O в ksyms, но ksymoops не может найти файлы в реальном / lib, поэтому он выдает предупреждающие сообщения. Если вы указываете -i, тогда ksymoops игнорирует имя пути в __insmod … O, вместо этого ищет пути -o (если любой) ищет объект с правильным базовым именем и отметка времени. -i рекомендуется при загрузке модулей из рамдиск.Это предполагает, что пути -o содержат модули используется для создания ramdisk с той же меткой времени.

По умолчанию используйте путь из символов __insmod … O.
-I —ignore-insmod-all

Используйте этот переключатель, если хотите полностью игнорировать всю вспомогательную информацию insmod (8) (символы, начинающиеся с __insmod в ksyms). Это включает в себя пути модулей, временные метки, начало и длина раздела и т. д. Затем ksymoops вернется к старому методу сопоставления символы для объектов модуля, используя пути -o (если есть).Это трудно придумать законную причину для использования -I, -i is лучше, если ваша единственная проблема — несоответствие имени пути.

По умолчанию используйте путь из __insmod … O символов и раздела информация из символов __insmod … S.
-T усечь —truncate = усечь

Если ваш binutils настроен для нескольких целей они, как правило, печатают адреса, используя размер адреса самой большой цели. Если другие входы в ksymoops имеют более короткие размеры символов, разные представления вызывают символы, которые должны иметь одинаковые адрес появится по разным адресам.Это конкретная проблема при сборке для смешанных 32 и 64 бит цели. Чтобы устранить двусмысленность, используйте —truncate = усечь . Значение 0 означает, что нет усечение, значение больше 8 * sizeof (беззнаковое длинное) равно бесшумно преобразован в 0.

По умолчанию —truncate = 0 , без усечения.
-d —debug

Каждое появление -d увеличивает уровень отладки ksymoops на единицу.

Уровень 1

Компиляция регулярного выражения резюме.До и после текста для расширения * [mns]. Обработка опций, но только для опций, появляющихся после -d . Вход в основные процедуры обработки. KSYMOOPS_ переменные среды. Объектные файлы, извлеченные непосредственно из ksyms. Информация о совпадениях загруженных модулей и объекты модуля. Имя файла отчета «К сожалению». Номер версии для упс. Сохранение объединенной карты системы.

Уровень 2

Сводная информация о символе размеры стола. Каждый номер версии, найденный в файле oops.Сравнение символьных карт. Добавление карт символов. Полный путь программы. Поданы внешние команды. Отчеты о проделанной работе для -о объект . Имена ’* .o’ файлы, найденные в каталоге -o . Корректировка смещения для разделы модуля. Каждая строка, выводимая при запуске objdump на байты кода.

Уровень 3

Каждая входная строка из Упс. Файл. Отсутствуют повторяющиеся символы и символы с низким адресом из объединенной карты системы. Отображение адресов на символы.

Уровень 4

Каждая входная строка из всех sources, это напечатает повторяющиеся строки.Код возврата из каждый вызов regexec. Неоднозначные совпадения, которые игнорируются. Каждый символ добавлен в каждую таблицу. Копирование таблиц символов. Увеличение размеров таблицы символов. Вход на какой-то более низкий уровень рутины. Все символы упали.

Уровень 5

Для сопоставления регулярных выражений, подробности на каждой подстроке.

По умолчанию нет отладка.
-h —help

Печатает текст справки и текущие значения по умолчанию.

-t цель —target = цель

Обычно вы делаете диагноз «Ой» используя то же оборудование, что и сам Oops.Но иногда вам нужно провести кросс-системную диагностику. от одного типа оборудования и обработки его на другом. Например, когда вы переходите на новую систему или сборка встроенного ядра. Сделать кросс-систему Ой обработки, вы должны сообщить ksymoops, какое целевое оборудование есть, используя -t цель , где цель — имя цели bfd. Вы можете узнать, на какие цели ваша машина поддерживает

ksymoops -t ’?’

По умолчанию та же цель, что и сам ksymoops, за одним исключением.На sparc64, ядро ​​использует elf64-sparc, но пользовательские программы elf32-sparc. Если -t цель не была указано, и ksymoops был скомпилирован для elf32-sparc и К сожалению, содержит строку TPC, затем ksymoops автоматически переключается на -t elf64-sparc.
-a архитектура —architecture = архитектура

Сделать кросс-систему Упс обработки, вы должны сообщить ksymoops, что цель архитектура есть, используя -a архитектура , где архитектура — имя архитектуры bfd.Ты можете узнать, какие архитектуры поддерживает ваша машина по

ksymoops -a ’?’

По умолчанию та же архитектура, что и сам ksymoops, за одним исключением. На sparc64, ядро ​​использует sparc: v9a, но пользовательские программы спарк. Если -a архитектура не была указано, и ksymoops был скомпилирован для sparc и Oops содержит строку TPC, тогда ksymoops автоматически переключается на -a sparcv: 9a.
-A «адрес list « —addresses = » адрес список « Если вы

есть несколько специальных адресов для преобразовать в символы, вы можете указать их явно, используя -A «список адресов» .Любые слова в список, который выглядит как адреса, преобразуются в символы. Знаки пунктуации и неадресные слова молча игнорируется, ведущие 0x в адресах также игнорируются, так что вы можете вставлять текст, включая слова и только адреса будет обработан.

Упс. Файл …

ksymoops принимает ноль или более входные файлы и читает их все. Если в командная строка и адреса не предоставляются через -A затем ksymoops читает со стандартного ввода.Вы даже можете ввести текст Oops прямо на терминале, хотя это не рекомендуемые.

ВХОД

ksymoops читает входной файл (ы), используя регулярные выражения для выбора строк которые подлежат распечатке и дальнейшему анализу. Вам не нужно для извлечения отчета об ошибке вручную.

Все вкладки преобразуется в пробелы, предполагая, что tabstop = 8. Где текст ниже написано «хотя бы один пробел», вкладки работают так же, как хорошо, но перед печатью они преобразуются в пробелы. Все нули и возврат каретки молча удаляется из строк ввода, оба вызывают проблемы при обработке и печати строк.

Входная линия может иметь префикс, который ksymoops будет печатать как часть линии, но игнорируйте во время анализа. Префикс может быть от syslogd (8) (состоит из даты, времени, имени хоста, ’Kernel:’), из syslog-ng (числа и три другие строки, разделенные ’|’), это может быть «начало строки» означает первый символ после пропуск всех префиксов, включая весь начальный пробел.

Каждое ядро команда архитектуры использует разные сообщения для ядра проблемы, см. Oops_read в oops.c для полного, кровавого списка.Если вы вводите сообщение Oops вручную, вам необходимо следовать как можно больше форматировать ядро, иначе ksymoops может не распознал ваш ввод. При вводе регистр не учитывается.

A в скобках адрес не обязателен ’[’, обязательно ’<’, Не менее 4 шестнадцатеричных цифр, обязательно ’>’, Необязательно ’]’, необязательно пробелы. Например, [<01234567>] или .

Без скобок адрес должен состоять не менее чем из 4 шестнадцатеричных цифр, за которыми следует необязательный пробелы. Например 01234567 или abCDeF.

Компьютер Sparc строка — ’PSR:’ в начале строки, пробел, шестнадцатеричный цифры, пробел, ´PC: ’, пробел, без квадратных скобок адрес.

TPC sparc64 строка: ’TSTATE:’ в начале строки, пробел, 16 шестнадцатеричные цифры, пробел ’TPC:’, пробел, без квадратных скобок адрес.

НПИ ppc строка имеет несколько форматов. ’Kernel pc’ ’Ловушка на ПК:’ ´bad area pc ’или’ NIP: ’. Любая из этих строк, за которой следует один пробел и адрес без скобок — это значение NIP.

ПК mips строка — ’epc’ в начале строки, необязательный пробел, один или несколько знаков «:», необязательный пробел, без квадратных скобок адрес.

Устройство ix86 EIP строка — ’EIP:’ в начале строки, по крайней мере, один пробел, любой текст, адрес в квадратных скобках.

EIP x86_64 строка — ’RIP:’ в начале строки, по крайней мере, один пробел, любой текст, адрес в квадратных скобках.

ПК m68k строка — ’PC’ в начале строки, необязательные пробелы, ’=’, Необязательные пробелы, адрес в квадратных скобках.

Линия arm PC это ’pc’ в начале строки, необязательные пробелы, ’:’, Необязательные пробелы, адрес в квадратных скобках.

IP-адрес IA64 строка — ’ip’, необязательный пробел ’:’, необязательный пробел, адрес в квадратных скобках.

Линия mips ra is ’ra’, необязательные пробелы, один или несколько ’=’, Необязательные пробелы, адрес без квадратных скобок.

Спарк строка дампа регистра (’i’, ’0’ или ’4’, ’:’, пробел) или (’Instruction DUMP:’, пробел) или (’Звонящий [’).

IA64 b0 строка ’b0’, необязательный пробел ’:’, необязательный пробел, адрес без квадратных скобок. Это можно повторить для других регистров b, например b6, b7.

Реестр дампов есть множество форматов. Большинство из них имеют форму ´name: value ’повторяется через строку, некоторые архитектуры используют ´ = ’вместо ´: ’. См. Текущий список распознанные имена регистров.Помимо списка Oops_regs, i370, mips, ppc и s390 имеют специальные форматы дампа регистров, обычно печатается одно имя регистра, за которым следует несколько значения. ksymoops извлекает все содержимое регистров, но только декодирует и печатает значения регистров, которые могут быть разрешены в символ ядра.

Набор звонков линии трассировки начинаются с ’Trace:’ или «Отслеживание звонков:» или ´Call Backtrace: ’(только ppc) или ’Функция введена в’ (только охрана) или ´Caller [’(только sparc64), за которым следует как минимум одно пространство.

Для ’Trace:’ и ’Call Trace:’, остальная часть строки — адреса в квадратных скобках, они могут быть продолжил на лишние строки.Адреса не могут быть разделены поперек линий.

Для ’Call Backtrace:’ (только ppc), остальная часть строка — адреса без квадратных скобок, их можно продолжить на дополнительные строки. Адреса не могут быть разделены линий.

Для ’Функция введена в’ (только рука), строка содержит ровно два адреса в квадратных скобках и не продолжение.

Для ’Caller [’ (только sparc64), строка содержит ровно один адрес без квадратных скобок и не продолжение.

Отжимная петля информация обозначается линией, начинающейся с ’Bh:’, за которым следуют строки, содержащие обратные скобки для обратных адресов.По какой-то причине эти адреса отличаются от всех остальных адресов и выгляди так ’<[Шестнадцатеричный]> <[шестнадцатеричный]>’ вместо нормальный ´ [] [] ’.

Кодовая строка обозначается ‘Instruction DUMP’ или (‘Код’ с дополнительными пробелами), ’:’, Один или несколько пробелов, за которыми следует как минимум одно шестнадцатеричное значение. Строка может содержать несколько шестнадцатеричных значений, каждый разделен хотя бы одним пробелом. Каждое шестнадцатеричное значение должно быть От 2 до 8 цифр и должно быть кратным 2 цифрам.

Любой код значения могут быть заключены в <..> или (..), последний такой Предполагается, что значение является ошибочной инструкцией. Если нет значения имеет <..> или (..), то предполагается, что первый байт невыполненная инструкция.

Особые случаи где Код: может сопровождаться текстом. Код: общий защита ’или’ Код: ’. Сбросьте data в любом случае код был недоступен.

Вы обнаруживаете небольшое замечание о несоответствии в вышеизложенном?

АДРЕС ДЛЯ ПРЕОБРАЗОВАНИЯ СИМВОЛА

Адреса преобразованы в символы на основе символов в vmlinux, / proc / ksyms, объектные файлы для модулей и System.карта, или как многие из этих источников как ksymoops было велено прочитать. ksymoops использует столько источников символов, сколько вы можете предоставить, пересекает ли проверки между различными источниками для выявления любых расхождений и строит объединенную карту, содержащую все символы, включая загруженные модули, где это возможно.

Символы, которые заканчиваются на _R_xxxxxxxx (8 шестнадцатеричных цифр) или _R_smp_xxxxxxxx версионный символ, см. genksyms (8). ksymoops убирает _R _… при построении внутренней карты системы.

Символы модуля не появляются ни в vmlinux, ни в System.карта и только экспортированный символы из модулей появляются в / proc / ksyms. Следовательно ksymoops пытается прочитать символы модуля из объектных файлов согласно -о . Без этих обозначений модулей диагностировать проблему в модуле практически невозможно.

Есть много проблемы с символами модулей, особенно с версиями insmod (8) до 2.1.121 включительно. Некоторые модули не экспортировать любые символов, их нет в / proc / ksyms, поэтому они фактически невидимы.Даже когда модуль экспортирует символы, обычно он экспортирует только один или два, не полный список, который действительно нужен для Упс диагноз. ksymoops может построить полную таблицу символов из объектный модуль, но он должен

Если модуль не экспортирует символы, тогда ksymoops не сможет получить любую информацию об этом модуле. lsmod говорит, что это загружен, но без символов, ksymoops не может найти соответствующий объектный файл и сопоставление смещений с адресами. Извините, но это так, если вы упс в модуле который не отображает символы в ksyms, забудьте об этом :(.

Когда модуль экспортирует символы, следующим шагом будет поиск объектного файла для этого модуля. В большинстве случаев загруженный модуль и объектный файл имеет такое же базовое имя, но это не гарантировано.Например,
insmod uart401 -o xyz
загрузит uart401.o из каталогов вашего модуля, но сохранит это как xyz. И ksyms, и lsmod говорят имя модуля ’Xyz’ без указания того, что оригинал объектный файл был uart401. Таким образом, ksymoops не может просто использовать имя модуля из ksyms или lsmod, он должен делать намного больше поработайте, чтобы найти правильный объект. Он делает это, ища уникальное совпадение экспортируемых символов и символов в объекты модуля.

Для каждого файла полученный из опций -o , ksymoops извлекает все символы (как статические, так и внешние) с использованием нм (1).Тогда это запускает символы экспортированного модуля в ksyms и для каждого символ экспортированного модуля, он выполняет строковое сравнение этого символ напротив каждого символа в каждом объекте. Когда ksymoops находит символ модуля, который экспортируется в ksyms и появляется ровно один раз среди всех -o объектов, тогда он должен предположить, что это тот объект, который использовался для загрузки модуль. Если ksymoops не может найти совпадений ни для одного экспортированного символ в модуле или находит более одного совпадения для каждого экспортированный символ в модуле, то он не может определить, какой объект действительно был загружен.

После ksymoops сопоставил загруженный модуль с объектом, используя уникальный символ, ему еще нужно вычислить адреса для символов от объекта. Для этого ksymoops сначала нужен запуск адрес текста, данных и разделов данных только для чтения в загруженный модуль. Учитывая начальный адрес раздела, ksymoops может вычислить адрес ядра каждого символа в этот раздел и добавьте символы на объединенную системную карту, сюда входят символы, которые не экспортируются. к несчастью начальный адрес раздела доступен, только если модуль экспортирует хотя бы один символ из этого раздела.Для Например, если модуль экспортирует только текстовые символы (большинство общий случай), то ksymoops может вычислить только начало текстовый раздел и должен отбросить символы из данных и читать только разделы данных для этого модуля, уменьшая информация, доступная для диагностики.

Когда несколько доступны источники символов, и эти источники символов содержат номер версии ядра, ksymoops сравнивает все номера версий. Он помечает предупреждение, если есть несоответствие. Одна из наиболее частых причин проблем — сила загрузка модуля из одного ядра в другое ядро.Даже если это было умышленно, его нужно выделить для диагноз.

Когда оба ksyms и lsmod доступны список модулей, извлеченных из ksyms сравнивается со списком модулей из lsmod. Любая разница отмечается как предупреждение, обычно указывает на невидимые модули. Однако это также может быть вызвано из-за несоответствия между ksyms и lsmod.

Когда несколько доступны источники символов, ksymoops выполняет перекрестную проверку между ними. Каждая проверка выполняется только в том случае, если оба символа источники присутствуют и не являются пустыми.Каждый символ в первом источник должен появиться во втором источнике и иметь тот же адрес. В случае каких-либо несоответствий одно из источники имеют приоритет, приоритет несколько произвольный. Некоторые неточности игнорируются, потому что это особые случаи, но подавляющее большинство символов ожидается совпадение.

После прочтения и перекрестная проверка всех источников символов, они объединяются в единую системную карту. Повторяющиеся символы, регистры (тип a) и статические символы ’gcc2_compiled.’ являются выпал с объединенной карты. Любые символы с адресом ниже 4096 отбрасываются, это такие символы, как Using_Versions с адресом 0.

Учитывая все выше обработки и дедукции, очевидно, что объединенная системная карта не может быть на 100% надежной, а это означает, что преобразование адресов в символы не может быть надежным. В адреса действительны, но преобразование символов только как хороши как источники символов, которые вы скачали в ksymoops.

/ proc / ksyms и / proc / lsmod изменчивы, поэтому, если ksymoops не получит текущий ksyms, вы всегда должны подвергать сомнению действительность информация о модуле. Единственный способ, который я знаю (почти) Гарантия действительного ksyms — использование ksymoops в однократном режиме (см. опцию -1 ).Затем ksymoops читает журнал и декодирует Oops в реальном времени.

ПОДДЕРЖКА KSYMOOPS В МОДУТИЛЯХ

Modutils 2.3.1 и далее имеет поддержку, чтобы упростить отладку, особенно для модулей. За подробностями обращайтесь к insmod (8). если ты хотите автоматические снимки данных ksyms и lsmod в виде модулей загружаются и выгружаются, создайте / var / log / ksymoops, он должен принадлежать root с режимом 644 или 600. Если не хотите автоматические снимки, не создавайте каталог. Скрипт (insmod_ksymoops_clean) предоставляется modutils для удаления старые версии, это должно запускаться cron один раз в день.

ВЫХОД

распечатки ksymoops все строки, содержащие текст, который может указывать на ядро проблема. Из-за полного отсутствия стандартов в ядре ошибка сообщения, я не могу гарантировать, что все проблемные строки напечатан. Если вы видите в своем журнале строку, в которой ksymoops должен извлечь, но не извлекает, обратитесь к сопровождающему.

Когда ksymoops видит строки EIP / PC / NIP / TPC, строки трассировки вызовов или строки кода, он распечатывает их и сохраняет для дальнейшей обработки. Когда строка кода обнаружена, ksymoops преобразует Адрес EIP / PC / NIP / TPC и адреса трассировки вызовов для символы.В этих строках есть ’;’ после заголовка. вместо ’:’, на всякий случай, если кто-нибудь захочет передать вывод ksymoops обратно в ksymoops, эти сгенерированные строки игнорируются.

Форматированные данные для программного счетчика, трассировка и код выводятся только тогда, когда Видна строка Код :. Если какие-либо данные были сохранены для позднее форматирование и более 5 строк, кроме текста Oops или конец файла, тогда ksymoops предполагает, что строка Code: отсутствует или искажена и выводит отформатированный данные в любом случае. Это должно быть отказоустойчивым, потому что строка Code: (или его эквивалент) сигнализирует об окончании отчета Oops.За исключением sparc64 на SMP, у которого есть дамп реестра после кода. ksymoops пытается удовлетворить это исключение. Вздох.

Адреса преобразованы в символы везде, где это возможно. Например

>> EIP; c0113f8c
Trace; c011d3f5
Трассировка; c011af5f
Trace; c011afe9
Trace; c011d2bc
Trace; c010e80f
Trace; c0107c39
Trace; c0107b30
Trace; 00001000 Перед первым символом

Каждый преобразован после адреса следует ближайший к нему символ адрес.За этим символом следует смещение адрес от символа. Значение после ’/’ равно «размер» символа, разница между символ и следующий известный символ. Итак,
>> EIP; c0113f8c означает что счетчик программы был c0113f8c. Предыдущий символ sys_init_module, адрес 0x49c байт от начало символа, sys_init_module имеет длину 0x4d0 байт. Если вы предпочитаете десятичные смещения и длины, см. опцию -x . Если символ поступает из модуля, ему предшествует префикс ’[ имя_модуля ]’, некоторые модули имеют те же имена процедур.

Использование «EIP» для счетчика программ выше предназначен для ix86. ksymoops пытается использовать правильную аббревиатуру программы счетчик (ПК, NIP, TPC и т. д.), но если он не распознает целевое оборудование, по умолчанию используется EIP.

Когда код: строка читается, ksymoops извлекает байты кода. Он использует строка счетчика программы вместе с байтами кода для сгенерировать небольшой объектный файл в целевой архитектуре. ksymoops затем вызывает objdump (1) для дизассемблирования этого объекта. файл.Инструкции, удобочитаемые человеком, извлекаются из вывод objdump и напечатанный с адресом к символу конверсия. Если дизассемблированный код не выглядит разумным, см. варианты -e , -a и -t .

ВЗЯТЬ СИМВОЛЫ, СМЕЩЕНИЯ И ДЛИНЫ С ЩЕТОЧКОЙ СОЛИ! адреса действительны, но преобразование символов только как хорошо, как ввод, который вы дали ksymoops. Смотрите все проблемы в «АДРЕС ДЛЯ ПРЕОБРАЗОВАНИЯ СИМВОЛА» выше. Так же трассировка стека потенциально неоднозначна.Ядро печатает любые адреса в стеке, которые могут быть допустимыми адресами . Ядро не может сказать, какие (если есть) из них адреса настоящие и которые просто лежат в стеке из предыдущих процедур. ksymoops просто декодирует то, что ядро печатает.

ПЕРЕМЕННЫЕ ОКРУЖАЮЩЕЙ СРЕДЫ

KSYMOOPS_NM

Путь для нм, по умолчанию $ {INSTALL_PREFIX} / bin / $ {CROSS} нм.

KSYMOOPS_FIND

Путь для поиска, по умолчанию / usr / bin / find.

KSYMOOPS_OBJDUMP

Путь для objdump, по умолчанию $ {INSTALL_PREFIX} / bin / $ {CROSS} objdump.

ДИАГНОСТИКА ПЕРЕКРЕСТНОЙ СИСТЕМЫ

Для обработки К сожалению, из одной системы в другую вам нужен доступ ко всем источники символов, включая модули, System.map, ksyms и т. д. две системы — разные аппаратные средства, вам также понадобится версии команд nm и objdump, которые выполняются на вашем система, но обрабатывает целевую систему. Также нужны версии libbfd, libopcodes и libiberty, которые обрабатывают цель система.За инструкциями обратитесь к документации по binutils. о том, как создавать кросс-системные версии этих коммунальные услуги.

Для отмены версии nm и find по умолчанию, используйте среду переменные выше. Чтобы использовать разные версии libbfd и libiberty используйте параметр —rpath при компоновке ksymoops или переменная среды LD_LIBRARY_PATH при запуске ksymoops. См. Информационные страницы для ld и / usr / doc / glibc * / FAQ. Вы также можете создать версию ksymoops, предназначенную для в среду кросс-компиляции с помощью BFD_PREFIX, Параметры DEF_TARGET, DEF_ARCH и CROSS во время сборки.Видеть УСТАНОВИТЕ в исходном пакете ksymoops для получения дополнительных сведений.

ДИАГНОСТИКА

ОШИБКИ

Из-за множество возможных ошибок ядра и информационных строк, При сопоставлении с образцом ksymoops иногда печатаются строки это вовсе не ошибки.Например, начало строки с 3c589 соответствует шаблону для линии трассировки вызова, оба начинаются как минимум с 4 шестнадцатеричных цифр. Люди умнее, чем программы игнорируют ложные строки.

АВТОРЫ

Кейт Оуэнс — сопровождающий.

патчей от Якуб Елинек , Ричард Хендерсон .

ИСТОРИЯ

Оригинал ksymoops.cc был написан Грегом МакГэри и обновлено Андреасом Шваб . Что версия требует C ++ и поддерживает только ix86 и m68k.

Чтобы получить эквивалент старого ksymoops.cc (без vmlinux, без модулей, без ksyms, без System.map) используйте ksymoops -VKLOM. Или чтобы просто прочтите System.map, ksymoops -VKLO -m mapfile.

СМОТРИ ТАКЖЕ

находка (1), insmod (8), нм (1), objdump (1), rmmod (8), dmesg (8), genksyms (8), syslogd (8). bfd файлы информации.

Linux Kernel Documentation :: oops-tracing.txt

На основе ядра версии 4.9. Страница создана 21 декабря 2016 в 14:36 ​​EST.

1 ПРИМЕЧАНИЕ: ksymoops бесполезен в версии 2.6. Пожалуйста, используйте Oops в исходном формате
2 (из dmesg и т. Д.). Игнорируйте любые ссылки в этом или других документах на "декодирование
3 Oops "или" прогоняя его через ksymoops ". Если вы опубликуете Oops из версии 2.6,
4 был запущен через ksymoops, люди просто скажут вам сделать репост.
5
6 Краткое резюме
7 -------------
8
9 Найдите сообщение "Упс" и отправьте его обслуживающему персоналу области ядра, которая, по всей видимости,
10 вовлечены в проблему.Не беспокойтесь слишком сильно о том, чтобы попасть не на того человека.
11 Если вы не уверены, отправьте его лицу, ответственному за код, относящийся к
12 что ты делал. Если это происходит неоднократно, попробуйте и опишите, как воссоздать
13 шт. Это стоит даже больше, чем упс.
14
15 Если вы не знаете, кому отправлять отчет, отправьте его
16 [email protected]. Спасибо за вашу помощь в создании Linux как
17 стабильных, насколько это возможно.
18
19 Где упс?
20 ----------------------
21 год
22 Обычно текст Oops считывается из буферов ядра с помощью klogd и
23 передается syslogd, который записывает его в файл syslog, обычно
24 / var / log / messages (зависит от / etc / syslog.conf). Иногда умирает klogd,
25 и в этом случае вы можете запустить dmesg> file для чтения данных из ядра.
26 буферов и сохраните его. Или вы можете cat / proc / kmsg> file, но вы
27 должны прерваться, чтобы остановить передачу, kmsg - это «нескончаемый файл».
28 Если машина разбилась настолько сильно, что вы не можете вводить команды или
29 диск недоступен, у вас есть три варианта: -
30
31 (1) От руки скопируйте текст с экрана и введите его после машины.
32 перезапустился. Беспорядочно, но это единственный вариант, если у вас его нет.
33 запланировано к катастрофе.Как вариант, вы можете сфотографировать
34 экран с цифровой камерой - не красиво, но лучше
35 ничего. Если сообщения прокручиваются в верхней части консоли, вы
36 может обнаружить, что загрузка с более высоким разрешением (например, vga = 791)
37 позволит вам прочитать больше текста. (Предостережение: для этого нужен vesafb,
38, так что не поможет при `` ранних '' оплакиваниях)
39
40 (2) Загрузитесь с последовательной консоли (см. Documentation / serial-console.txt),
41 запустить нуль-модем на вторую машину и записать там вывод
42 используя вашу любимую коммуникационную программу.Миником работает хорошо.
43 год
44 (3) Используйте Kdump (см. Documentation / kdump / kdump.txt),
45 извлеките кольцевой буфер ядра из старой памяти с помощью dmesg
46 gdbmacro в Documentation / kdump / gdbmacros.txt.
47
48
49 Полная информация
50 ----------------
51
52 ПРИМЕЧАНИЕ: сообщение Линуса ниже относится к ядру 2.4. Я сохранил это
53 по историческим причинам, а также потому, что часть информации в нем все еще
54 применяется. В особенности игнорируйте любые ссылки на ksymoops.
55
56 Источник: Линус Торвальдс 
57
58 Как отследить Упс ... [первоначально письмо linux-kernel]
59
60 Главный трюк - иметь 5-летний опыт работы с этими надоедливыми упсами.
61 сообщение ;-)
62
63 На самом деле, вы можете сделать это проще. у меня есть два
64 отдельных подхода:
65
66 ГБД / USR / SRC / Linux / VMlinux
67 gdb> дизассемблировать <преступная_функция>
68
69 Это простой способ найти проблему, по крайней мере, если отчет об ошибке
70 хорошо сделанных (как этот - пробегите через ksymoops, чтобы получить
71 информация о том, какая функция и смещение в функции, что она
72 произошло в).73
74 О, это помогает, если отчет происходит на ядре, которое скомпилировано с
75 тот же компилятор и похожие настройки.
76
77 Еще нужно разобрать часть отчета об ошибке «Код:»:
78 ksymoops сделает то же самое с правильными инструментами, но если у вас нет
79 инструментов, с помощью которых можно сделать глупую программу:
80
81 char str [] = "\ xXX \ xXX \ xXX ...";
82 main () {}
83
84 и скомпилируйте его с помощью gcc -g, а затем выполните "disassemble str" (где "XX"
85 значений - это значения, сообщенные Oops - вы можете просто вырезать и вставить
86 и заменяю пробелы на "\ x" - это то, что я делаю, так как мне лень
87, чтобы написать программу для автоматизации всего этого).88
89 В качестве альтернативы вы можете использовать сценарий оболочки в scripts / decodecode.
90 Его использование: decodecode  или (), как в «<86>» или «(f00d)». Эти
96 метки <> или () указывают на текущий указатель инструкции.Пример из
97 i386, разбитый на несколько строк для удобства чтения:
98
99 Код: f9 0f 8d f9 00 00 00 8d 42 0c e8 dd 26 11 c7 a1 60 ea 2b f9 8b 50 08 a1
100 64 ea 2b f9 8d 34 82 8b 1e 85 db 74 6d 8b 15 60 ea 2b f9 <8b> 43 04 39 42 54
101 7e 04 40 89 42 54 8b 43 04 3b 05 00 f6 52 c0
102
103 Наконец, если вы хотите увидеть, откуда берется код, вы можете сделать
104
105 кд / usr / src / linux
106 make fs / buffer.s # или любой другой файл, в котором произошла ошибка
107
108, и тогда вы получите лучшее представление о том, что происходит, чем с gdb
109 разборка.110
111 Теперь уловка состоит в том, чтобы объединить все данные, которые у вас есть: C
112 источников (и общие сведения о том, что _должен_ делать), сборка
113 листинг и дизассемблер кода (и дополнительно дамп реестра)
114 также можно получить из сообщения «ой» - это может быть полезно, чтобы увидеть _какой_
115 поврежденных указателей были, и когда у вас есть список ассемблера, вы можете
116 также сопоставляют другие регистры с любыми выражениями C, которые они использовали
117 для).
118
119 По сути, вы просто смотрите на то, что не совпадает (в данном случае это был
120 "Код" дизассемблера, который не соответствовал тому, что сгенерировал компилятор).121 Затем вам нужно выяснить, почему они не совпадают. Часто это просто - ты
122 видите, что в коде используется указатель NULL, а затем вы смотрите на код и
123 интересно, как туда попал NULL-указатель и правильно ли это делать?
124 вы просто проверите против него ..
125
126 Теперь, если кто-то поймет, что это отнимает много времени и требует
127 какая-то небольшая концентрация, вы правы. Вот почему я буду
128 в основном просто игнорируют любые отчеты о панике, в которых нет таблицы символов
129 информация и т. Д. Искали: просто становится слишком сложно ее найти (у меня есть
130 программ для поиска определенных шаблонов в сегменте кода ядра, и
131 иногда мне удавалось найти и подобные паники, но
132, что действительно требует хороших знаний ядра, чтобы иметь возможность
133, чтобы выбрать правильные последовательности и т. Д..)
134
135 _Иногда_ бывает, что я просто вижу дизассемблированную последовательность кода.
136 от паники, и я сразу знаю, откуда это. Вот когда
137 Меня беспокоит, что я слишком долго этим занимаюсь ;-)
138
139 Линус
140
141
142 ------------------------------------------------- --------------------------
143 Замечания по трассировке Oops с помощью klogd:
144
145 Чтобы помочь Линусу и другим разработчикам ядра,
146 существенная поддержка, встроенная в klogd для защиты обработки
147 неисправностей.Чтобы иметь полную поддержку разрешения адресов хотя бы
148 версии 1.3-pl3 пакета sysklogd следует использовать.
149
150 Когда происходит сбой защиты, демон klogd автоматически
151 переводит важные адреса в сообщениях журнала ядра в их
152 символических эквивалента. Это переведенное сообщение ядра затем
153 пересылается через любой механизм отчетов, который использует klogd. В
154 сообщение об ошибке защиты можно просто вырезать из файлов сообщений
155 и передан разработчикам ядра.156
157 klogd выполняет два типа разрешения адресов. Первый - это
158 статический перевод, а второй - динамический перевод. Статический
159 перевод использует файл System.map почти так же, как и
160 ksymoops делает. Для статического перевода демон klogd
161 должен быть в состоянии найти файл системной карты во время инициализации демона.
162 См. Справочную страницу klogd для получения информации о том, как klogd ищет карту.
163 файла.
164
165 Динамическая трансляция адресов важна при загрузке модулей ядра.
166 используются.Поскольку память для модулей ядра выделяется из
167 пулов динамической памяти ядра, для них нет фиксированных расположений.
168 начало модуля или для функций и символов в модуле.
169
170 Ядро поддерживает системные вызовы, которые позволяют программе определять
171, какие модули загружены и их расположение в памяти. Используя эти
172 системных вызовов, демон klogd создает таблицу символов, которую можно использовать
173 для отладки сбоя защиты, возникающего в загружаемом модуле ядра.
174
175 Как минимум, klogd предоставит имя модуля, который
176 сгенерировал ошибку защиты.Могут быть дополнительные символические
177 информация доступна, если разработчик загружаемого модуля решил
178 экспортировать символьную информацию из модуля.
179
180 Поскольку среда модуля ядра может быть динамической, должна быть
181 механизм уведомления демона klogd при изменении модуля
182 происходит окружающая среда. Доступны параметры командной строки, которые
183 разрешить klogd сигнализировать выполняющемуся в данный момент демону, что символ
184 информацию следует обновить. См. Дополнительную информацию на странице руководства klogd.
185 информация.186
187 В дистрибутив sysklogd включен патч, изменяющий
188 modules-2.0.0 пакет для автоматической сигнализации klogd всякий раз, когда модуль
189 загружается или разгружается. Применение этого патча существенно
190 бесшовная поддержка для устранения сбоев защиты, возникающих с
191 загружаемый модуль ядра.
192
193 Ниже приведен пример отказа защиты в загружаемом модуле.
194 обработано klogd:
195 ------------------------------------------------- --------------------------
196 29 августа, 09:51:01 Ядро blizard: не удалось обработать запрос ядра на подкачку по виртуальному адресу f15e97cc
197 29 августа, 09:51:01 ядро ​​blizard: current-> tss.cr3 = 0062d000,% cr3 = 0062d000
198 29 августа 09:51:01 ядро ​​blizard: * pde = 00000000
199 29 августа, 09:51:01 ядро ​​blizard: Ой: 0002
200 29 августа 09:51:01 ядро ​​blizard: CPU: 0
201 29 августа, 09:51:01 ядро ​​blizard: EIP: 0010: [ой: _oops + 16/3868]
202 29 августа 09:51:01 ядро ​​blizard: EFLAGS: 00010212
203 29 августа, 09:51:01 ядро ​​blizard: eax: 315e97cc ebx: 003a6f80 ecx: 001be77b edx: 00237c0c
204 29 августа, 09:51:01 ядро ​​blizard: esi: 00000000 edi: bffffdb3 ebp: 00589f90 esp: 00589f8c
205 29 августа 09:51:01 ядро ​​blizard: ds: 0018 es: 0018 fs: 002b gs: 002b ss: 0018
206 29 августа, 09:51:01 Ядро blizard: процесс oops_test (pid: 3374, номер процесса: 21, stackpage = 00589000)
207 29 августа 09:51:01 ядро ​​blizard: Стек: 315e97cc 00589f98 0100b0b4 bffffed4 0012e38e 00240c64 003a6f80 00000001
208 29 августа 09:51:01 ядро ​​blizard: 00000000 00237810 bfffff00 0010a7fa 00000003 00000001 00000000 bfffff00
209 29 августа 09:51:01 ядро ​​blizard: bffffdb3 bffffed4 ffffffda 0000002b 0007002b 0000002b 0000002b 00000036
210 29 августа, 09:51:01 Ядро blizard: Отслеживание вызовов: [oops: _oops_ioctl + 48/80] [_sys_ioctl + 254/272] [_system_call + 82/128]
211 29 августа 09:51:01 ядро ​​blizard: Код: c7 00 05 00 00 00 eb 08 90 90 90 90 90 90 90 90 89 ec 5d c3
212 ------------------------------------------------- --------------------------
213
214 ДокторG.W. Wettstein Oncology Research Div. Вычислительный центр
215 Онкологический центр Роджера Мариса ИНТЕРНЕТ: [email protected]
216 820 4-я улица N.
217 Fargo, ND 58122
218 Телефон: 701-234-7556
219
220
221 ------------------------------------------------- --------------------------
222 Испорченные ядра:
223
224 Некоторые отчеты oops содержат строку "Tainted:" после программы.
225 счетчик. Это указывает на то, что ядро ​​было испорчено некоторыми
226 механизм. За строкой следует ряд чувствительных к положению
227 символов, каждый из которых представляет определенное испорченное значение.228
229 1: 'G', если все загруженные модули имеют лицензию GPL или совместимую, 'P', если
230 загружен какой-либо фирменный модуль. Модули без
231 MODULE_LICENSE или с MODULE_LICENSE, который не распознается
232 insmod, как GPL-совместимый, считаются проприетарными.
233
234 2: 'F', если какой-либо модуль был принудительно загружен с помощью insmod -f, '' если все
235 модулей загрузились нормально.
236
237 3: 'S', если ошибка произошла на ядре SMP, работающем на оборудовании, которое
238 не был сертифицирован как безопасный для работы с несколькими процессорами.239 В настоящее время это происходит только на различных Атлонах, которые не
Возможность 240 SMP.
241
242 4: 'R', если модуль был принудительно выгружен командой "rmmod -f", '' если все
243 модуля выгружались нормально.
244
245 5: 'M', если какой-либо процессор сообщил об исключении проверки машины,
246 '', если не возникло никаких исключений проверки машины.
247
248 6: 'B', если функция выпуска страницы обнаружила неверную ссылку на страницу или
249 некоторые неожиданные флаги страницы.
250
251 7: 'U', если пользователь или пользовательское приложение специально запросили, чтобы
252 Флаг испорченного должен быть установлен, в противном случае.253
254 8: 'D', если ядро ​​недавно умерло, т.е. произошла ошибка OOPS или BUG.
255
256 9: 'A', если таблица ACPI была переопределена.
257
258 10: 'W', если ядро ​​ранее выдало предупреждение.
259 (Хотя некоторые предупреждения могут устанавливать более конкретные флаги заражения.)
260
261 11: 'C', если загружен промежуточный драйвер.
262
263 12: 'I', если ядро ​​работает с серьезной ошибкой в ​​платформе
264 (BIOS или аналогичная).
265
266 13: 'O', если был загружен созданный извне ("вне дерева") модуль.267
268 14: 'E', если неподписанный модуль был загружен в ядро, поддерживающее
269 ​​подпись модуля.
270
271 15: «L», если ранее в системе происходила мягкая блокировка.
272
273 16: 'K', если ядро ​​было исправлено в реальном времени.
274
275 Основная причина появления строки 'Tainted:' заключается в том, чтобы сообщить ядру
276 отладчиков, если это чистое ядро ​​или что-то необычное
277 произошло. Заражение необратимо: даже если вызывающий ошибку модуль
278 выгружено, испорченное значение остается, чтобы указать, что ядро ​​не
279 заслуживают доверия.

• Права на информацию принадлежат ее автору.
• Все материалы доступны из исходного кода ядра Linux, распространяемого по лицензии GPL.
• Размещено на mjmwired.net.

Взаимосвязи в OOPS… — Первое декодирование

ОТНОШЕНИЯ — это то, что класс или объект знает о другом классе или объекте.

 # с npm
npm install decode-json --save

# пряжей
пряжа установить decode-json 

 // со скайпаком
импортировать Decode, {Decoder} из https://cdn.skypack.dev/decode-json
import errorToHumanReadable from 'https: // cdn.skypack.dev/decode-json/error-to-human-readable '

// версия мини-поля
импортировать Decode, {Decoder} из https://cdn.skypack.dev/decode-json?min
import errorToHumanReadable from 'https://cdn.skypack.dev/decode-json/error-to-human-readable?min' 

 {
  "name": "Люк Скайуокер",
  "Birth_year": "19BBY",
  "рост": "172",
  "масса": "77"
} 

 import Decode, {Decoder} из decode-json

const parseFloatDecoder: Decoder  = Decode.один из([
  Decode.float, // если значение уже плавающее
  Decode.string.chain (str => {
    const num = Number (str || '_') // предотвращает Number ('') === 0

    if (isNaN (число)) {
      return Decode.fail (`Не удалось разобрать" $ {str} "как число с плавающей точкой`)
    }

    return Decode.succeed (число)
  })
])

const characterDecoder = Decode.shape ({
  имя: Decode.field ('имя'). строка,
  BirthYear: Decode.field ('Birth_year'). строка,
  высота: Decode.field ('высота'). of (parseFloatDecoder),
  масса: Decode.field ('масса').из (parseFloatDecoder)
})

const response = ожидание выборки ('https://swapi.dev/api/people/1')
const data = ожидание ответа.json ()
const characterResult = characterDecoder.decode (данные) 

 characterDecoder.decode (данные)
// == {
//   значение: {
// имя: 'Люк Скайуокер',
// год рождения: '19BBY',
// высота: 172,
// масса: 77
//}
//} 

 characterDecoder.декодировать (данные)
// == {
//   ошибка: {
// тип: 'IN_FIELD',
// поле: 'высота',
//     ошибка: {
// тип: 'FAILURE',
// сообщение: 'Не удалось разобрать «172 см» как число с плавающей запятой »,
// источник: '172 см'
//}
//}
//} 

 импорт Decode, {Decoder, DecodeResult, DecodeError} из decode-json

const ageDecoder: Decoder  = Decode.поле ('возраст'). int
const badResult = ageDecoder.decode ('ой')
// == {ошибка: {type: 'EXPECT_OBJECT', источник: 'oops'}}
const goodResult = ageDecoder.decode ({age: 27}) // == {значение: 27} 

 const {ошибка, значение} = ageDecoder.decode ({age: 27})

if (error) {
  showError (ошибка)
} еще {
  showAge (value) // TS жалуется: «Возможно, объект 'undefined'»
} 

 const ageResult = ageDecoder.декодировать ({age: 27})

if (ageResult.error) {
  showError (ageResult.error)
} еще {
  showAge (ageResult.value) // здесь жалоб нет
} 

 import Decode, {Decoder} из decode-json

interface User {
  id: строка
  ник: строка
  активный: логический
  возраст: число
}

const userDecoder: Decoder <Пользователь> = Decode.shape ({
  id: декодировать.поле ('uuid'). строка,
  ник: Decode.field ('имя пользователя'). строка,
  активный: Decode.field ('is_active'). boolean,
  возраст: Decode.field ('возраст'). int
}) 

 import Decode, {Decoder} из decode-json

const messageDecoder: Decoder  = Decode.string.map (message =>
  message.trim ()
)
const charCountDecoder: Decoder  = Decode.string.карта(
  сообщение => message.trim (). length
) 

 import Decode, {Decoder} из decode-json

const displayDateDecoder: Decoder  = Decode.field (
  'активный'
) .boolean.chain (active => {
  вернуться активным
    ? Decode.field ('last_activity'). Строка
    : Decode.field ('начальная_дата'). Строка
})

displayDateDecoder.decode ({
  активный: ложь,
  last_activity: '30 секунд назад',
  start_date: «1 сен 2020»
}).value // == '1 сен 2020'

displayDateDecoder.decode ({
  active: true,
  last_activity: '30 секунд назад',
  start_date: «1 сен 2020»
}). value // == '30 секунд назад '

 импорт декодирования из decode-json

Decode.boolean.decode ('Я неизвестен ввод'). Error
// == {type: 'EXPECT_BOOLEAN', source: 'I am unknown input'}

Decode.boolean.decode (false) .value // == false 

 импорт декодирования из decode-json

Decode.string.decodeJson ('Я просто строка'). Error
// == {
// тип: 'INVALID_JSON',
// ошибка: новый SyntaxError ('Неожиданный токен I в JSON в позиции 0'),
// источник: 'Я всего лишь строка'
//}

const goodJson = Decode.string.decodeJson ('"Я - строка JSON"'). value
// == 'Я строка JSON' 

 импорт декодирования из decode-json

Расшифровать.string.decode (null) .error // == {тип: 'EXPECT_STRING', источник: null}
Decode.string.decode (true) .error // == {тип: 'EXPECT_STRING', источник: true}
Decode.string.decode (1234) .error // == {тип: 'EXPECT_STRING', источник: 1234}
Decode.string.decode (12.3) .error // == {тип: 'EXPECT_STRING', источник: 12.3}
Decode.string.decode ('привет'). Значение // == 'привет' 

 импорт декодирования из decode-json

Decode.boolean.decode (ноль).ошибка // == {тип: 'EXPECT_BOOLEAN', источник: null}
Decode.boolean.decode (1234) .error // == {тип: 'EXPECT_BOOLEAN', источник: 1234}
Decode.boolean.decode (12.3) .error // == {тип: 'EXPECT_BOOLEAN', источник: 12.3}
Decode.boolean.decode ('hi'). Error // == {type: 'EXPECT_BOOLEAN', source: 'hi'}
Decode.boolean.decode (true) .value // true 

 импорт декодирования из decode-json

Decode.int.decode (null) .error // == {тип: 'EXPECT_INT', источник: null}
Расшифровать.int.decode (true) .error // == {тип: 'EXPECT_INT', источник: true}
Decode.int.decode ('привет'). Ошибка // == {тип: 'EXPECT_INT', источник: 'привет'}
Decode.int.decode (12.3) .error // == {тип: 'EXPECT_INT', источник: 12.3}
Decode.int.decode (1234) .value // 1234 

 импорт декодирования из decode-json

Decode.float.decode (null) .error // == {тип: 'EXPECT_FLOAT', источник: null}
Decode.float.decode (true) .error // == {type: 'EXPECT_FLOAT', source: true}
Расшифровать.float.decode ('привет'). ошибка // == {тип: 'EXPECT_FLOAT', источник: 'привет'}
Decode.float.decode (12.3) .value // 12.3
Decode.float.decode (1234) .value // 1234 

 импорт декодирования из decode-json

Decode.unknown.decode (window.location) .value // == window.location 

 импорт декодирования из decode-json

const pointDecoder = Decode.shape ({
  тип: Decode.field ('тип'). точный ('ТОЧКА'),
  x: Decode.field ('axis_x'). float,
  y: Decode.field ('axis_y'). float
})

pointDecoder.декодировать ({
  тип: 'ЛИНИЯ',
  х0: 1,2,
  y0: 3,4,
  х1: 5,6,
  x1: 7,8
}).ошибка
// == {
// тип: 'IN_FIELD',
// имя: 'тип',
//   ошибка: {
// тип: 'EXPECT_EXACT',
// значение: 'ТОЧКА',
// источник: 'СТРОКА'
//}
//} 

 import Decode, {Decoder} из decode-json

enum Role {
  Пользователь,
  Менеджер,
  Админ
}

const roleDecoder: Decoder  = Decode.oneOf ([
  Decode.exact ('ПОЛЬЗОВАТЕЛЬ', Роль.Пользователь),
  Расшифровать.точное ('МЕНЕДЖЕР', Роль.Менеджер),
  Decode.exact ('АДМИНИСТРАТОР', Role.Admin)
]) 

 import Decode, {Decoder} из decode-json

const activeUsers: Decoder > = Decode.record (
  Decode.boolean
)

activeUsers.decode ({
  Джон: ложь,
  Мартин: ложь,
  Скотт: правда
}). value // == {Джон: false, Мартин: false, Скотт: true}

activeUsers.decode ({
  Джон: ложь,
  Мартин: ложь,
  Скотт: да
}).ошибка
// == {
// тип: 'IN_FIELD',
// имя: 'Скотт',
//   ошибка: {
// тип: 'EXPECT_BOOLEAN',
// источник: 'да'
//}
//} 

 import Decode, {Decoder} из decode-json

interface User {
  идентификационный номер
  имя пользователя: строка
}

const userDecoder: Decoder <Пользователь> = Decode.shape ({
  id: Decode.field ('id'). int,
  имя пользователя: Decode.field ('имя_пользователя'). строка
})

Decode.list (userDecoder) .decode ([
  {
    id: 0,
    имя_пользователя: 'суперзвезда'
  },
  {
    id: 1,
    имя_пользователя: 'босс'
  }
]).значение // == [{id: 0, имя пользователя: 'superstar'}, {id: 1, имя пользователя: 'босс'}]

Decode.list (userDecoder) .decode ([
  {
    id: 0,
    имя_пользователя: 'lollypop'
  },
  {
    id: 1,
    имя: 'босс'
  }
]).ошибка
// == {
// тип: 'AT_INDEX',
// позиция: 1,
//   ошибка: {
// тип: 'REQUIRED_FIELD',
// имя: 'user_name',
//     источник: {
// id: 1,
// имя: 'босс'
//}
//}
//} 

 import Decode, {Decoder} из decode-json

const activeUsers: Decoder > = Декодировать.keyValue (
  Decode.boolean
)

activeUsers.decode ({
  Джон: ложь,
  Мартин: ложь,
  Скотт: правда
}). value // == [['John', false], ['Martin', false], ['Scott', true]]

activeUsers.decode ({
  Джон: ложь,
  Мартин: ложь,
  Скотт: да
}).ошибка
// == {
// тип: 'IN_FIELD',
// имя: 'Скотт',
//   ошибка: {
// тип: 'EXPECT_BOOLEAN',
// источник: 'да'
//}
//} 

 import Decode, {Decoder} из decode-json

enum Currency {
  Тереть,
  Евро,
  Доллар США
}

const currencyFromCode = (код: строка): Currency => {
  switch (code) {
    case 'rub':
      return {value: Currency.Тереть }
    case 'eur':
      return {value: Currency.Eur}
    case 'usd':
      return {значение: Currency.Usd}
    По умолчанию: {
      ошибка: `Неизвестный код валюты" $ {code} "`
    }
  }
}

const balance: Decoder > = Decode.keyValue (
  currencyFromCode,
  Decode.float
)

activeUsers.decode ({
  руб: 42000,1,
  eur: 2400,87,
  доллар США: 13000.51
}).значение
// == [
// [Currency.Rub ', 42000.1],
// [Currency.Eur, 2400,87],
// [Currency.Usd, 13000.51]
//]

activeUsers.декодировать ({
  руб: 42000,1,
  eur: 2400,87,
  доллар США: 13000,51,
  cny: 7912.08
}).ошибка
// == {
// тип: 'FAILURE',
// сообщение: 'Неизвестный код валюты "cny"'
// источник: 'cny'
//} 

 import Decode, {Decoder} из decode-json

interface User {
  id: строка
  ник: строка
  активный: логический
  возраст: число
}

const userDecoder: Decoder <Пользователь> = Decode.shape ({
  id: декодировать.поле ('uuid'). строка,
  ник: Decode.field ('имя пользователя'). строка,
  активный: Decode.field ('is_active'). boolean,
  возраст: Decode.field ('возраст'). int
})

userDecoder.decode ({
  uuid: 'user_12319238',
  имя пользователя: 'wolverine',
  is_active: ложь,
  возраст: 61
}).значение
// == {
// id: 'user_12319238',
// ник: 'wolverine',
// активно: ложь,
// возраст: 61
//}

userDecoder.decode ({
  uuid: 'user_12319238',
  имя пользователя: 'wolverine',
  is_active: 'да',
  возраст: 61
}).ошибка
// == {
// тип: 'IN_FIELD',
// поле: 'is_active',
//   ошибка: {
// тип: 'EXPECT_BOOLEAN',
// источник: 'да'
//}
//} 

 import Decode, {Decoder} из decode-json

const pointDecoder: Декодер <[число, число]> = Декодировать.кортеж (
  Decode.field ('x'). Float,
  Decode.field ('y'). Float
)

pointDecoder.decode ({
  х: 12,34,
  y: 56.78
}). значение // == [12.34, 56.78]

pointDecoder.decode ({
  х: 12,34,
  y: '56 .78 '
}).ошибка
// == {
// тип: 'IN_FIELD',
// поле: 'y',
//   ошибка: {
// тип: 'EXPECT_FLOAT',
// источник: '56 .78 '
//}
//} 

 import Decode, {Decoder} из decode-json

const dateDecoder: Decoder  = Decode.oneOf ([
  Decode.int.map (timestamp => новая дата (временная метка)),
  Decode.string.chain (datetime => {
    const date = новая дата (datetime)

    if (isNaN (date.getMilliseconds ())) {
      return Decode.fail (`Не удалось создать дату из" $ {datetime} "`)
    }

    вернуть Decode.успешно (дата)
  })
])

dateDecoder.decode (1609542413856) .value // == новая дата ('Пт, 01 января 2021 г., 23:06:53 GMT')
dateDecoder.decode ('Пт, 01 января 2021 г., 23:06:53 GMT'). value // == новая дата (1609542413856)
dateDecoder.decode ('01 | 01 | 2021 '). ошибка
// == {
// тип: 'ONE_OF',
// ошибки: [
// {
// тип: 'EXPECT_INT',
// источник: '01 | 01 | 2021 '
//},
// {
// тип: 'FAILURE',
// message: 'Не удалось создать дату с "01 | 01 | 2021"',
// источник: '01 | 01 | 2021 '
//}
//]
//} 

 import Decode, {Decoder} из decode-json

interface User {
  id: строка
  ник: строка
  активный: логический
  возраст: число
}

const userDecoder: Декодер <Пользователь> = Декодер.один из([
  // устаревшая версия
  Decode.shape ({
    id: Decode.field ('index'). int.map (String),
    псевдоним: Decode.field ('name'). string,
    активный: Decode.field ('is_active'). boolean,
    возраст: Decode.field ('years'). int
  }),

  // Последняя версия
  Decode.shape ({
    id: Decode.field ('uuid'). строка,
    ник: Decode.field ('имя пользователя'). строка,
    активный: Decode.field ('isActive'). логический,
    возраст: Decode.field ('возраст'). int
  })
])

userDecoder.decode ({
  индекс: 0,
  имя: 'Рэйчел',
  is_active: true,
  лет: 30
}).значение
// == {
// id: '0',
// ник: 'Рэйчел',
// active: true,
// возраст: 30
//}

userDecoder.decode ({
  uuid: 'uuid-id-is-здесь',
  имя пользователя: 'Росс',
  isActive: правда,
  возраст: 32
}).значение
// == {
// id: 'uuid-id-is-here',
// ник: 'Росс',
// active: true,
// возраст: 32 года
//} 

 импорт декодирования из decode-json

const configDecoder = Decode.oneOf ([
  Decode.shape ({
    hostUrl: декодировать.поле ('HOST_URL'). строка,
    apiVersion: Decode.field ('API_VERSION'). int
  }),

  Decode.succeed ({
    hostUrl: 'локальный: 8000',
    apiVersion: 1
  })
])

configDecoder.decode (нуль) .value
// == {
// hostUrl: 'localhost: 8000',
// apiVersion: 1
//} 

 import Decode, {Decoder} из decode-json

interface Comment {
  сообщение: строка
  ответы: Массив <Комментарий>
}

const commentDecoder: Decoder  = Decode.shape ({
  сообщение: Decode.field ('mes'). string,
  ответы: Decode.field ('res'). list (Decode.lazy (() => commentDecoder))
})

commentDecoder.decode ({
  mes: 'ой',
  res: [
    {
      mes: 'да',
      res: [
        {
          mes: 'вот и мы снова',
          res: []
        }
      ]
    },
    {
      mes: 'нет',
      res: [
        {
          mes: 'это правильно',
          res: [
            {
              mes: 'согласен',
              res: []
            }
          ]
        }
      ]
    }
  ]
}).значение
// == {
// сообщение: 'ой',
// ответы: [
// {
// сообщение: 'да',
// ответы: [
// {
// сообщение: 'вот и мы снова',
// ответы: []
//}
//]
//},
// {
// сообщение: 'нет',
// ответы: [
// {
// сообщение: 'это правильно',
// ответы: [
// {
// сообщение: 'согласен',
// ответы: []
//}
//]
//}
//]
//}
//]
//} 

 import Decode, {Decoder} из decode-json

const positiveIntDecoder: Decoder  = Decode.int.chain (int => {
  if (int> 0) {
    вернуть Decode.succeed (int)
  }

  return Decode.fail (`Ожидает положительное int, но вместо этого получает $ {int} ')
})

PositiveIntDecoder.decode (42) .value // == 42

PositiveIntDecoder.decode (-1) .error
// == {
// тип: 'FAILURE',
// message: 'Ожидает положительного int, но вместо этого получает -1',
// источник: -1
//} 

 import Decode, {Decoder} из decode-json

const messageDecoder: Декодер <строка> = Декодер.string.chain (message => {
  if (message.length> = 10) {
    return Decode.succeed (сообщение)
  }

  вернуть Decode.fail (
    `Входное сообщение состоит всего из $ {message.length} символов, но требуется как минимум 10`
  )
})

messageDecoder.decode ('Довольно длинное сообщение'). value // == 'Довольно длинное сообщение'
messageDecoder.decode ('Short'). error
// == Входное сообщение состоит всего из 5 символов, но требуется как минимум 10
messageDecoder.decode (123) .error // == {type: 'EXPECT_STRING', источник: 123} 

 import Decode, {Decoder} из decode-json

const pointDecoder = Decoder.shape ({
  x: Decode.index (0) .float,
  y: Decode.index (1) .float,
  z: Decode.succeed (0)
})

pointDecoder.decode ([0.31, 8.17]). value // == {x: 0.31, y: 8.17, z: 0} 

 import Decode, {RequiredDecodePath} из decode-json

const currentUserPath: RequiredDecodePath = Декодировать.поле ('current_user') 

 import Decode, {RequiredDecodePath} из decode-json

const secondPointPath: RequiredDecodePath = Decode.index (1) 

 импорт декодирования из decode-json

Расшифровать.optional.string.decode (1234) .error
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
// ошибка: {тип: 'EXPECT_STRING', источник: 1234}
//}
Decode.optional.string.decode (null) .value // == null
Decode.optional.string.decode (undefined) .value // == null
Decode.optional.string.decode ('привет'). Значение // == 'привет' 

 импорт декодирования из decode-json

Расшифровать.optional.boolean.decode (1234) .error
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
// ошибка: {тип: 'EXPECT_BOOLEAN', источник: 1234}
//}
Decode.optional.boolean.decode (null) .value // == null
Decode.optional.boolean.decode (undefined) .value // == null
Decode.optional.boolean.decode (true) .value // == true 

 импорт декодирования из decode-json

Расшифровать.optional.int.decode (12.3) .error
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
// ошибка: {тип: 'EXPECT_INT', источник: 12.3}
//}
Decode.optional.int.decode (null) .value // == null
Decode.optional.int.decode (undefined) .value // == null
Decode.optional.int.decode (1234) .value // == 1234 

 импорт декодирования из decode-json

Расшифровать.optional.float.decode (ложь) .error
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
// ошибка: {тип: 'EXPECT_FLOAT', источник: false}
//}
Decode.optional.float.decode (null) .value // == null
Decode.optional.float.decode (undefined) .value // == null
Decode.optional.float.decode (12.3) .value // == 12.3 

 import Decode, {Decoder} из decode-json

const idsDecoder: Decoder > = Декодировать.optional.list (
  Decode.int
)

idsDecoder.decode (null) .value // == null
idsDecoder.decode (undefined) .value // == null
idsDecoder.decode ([0, 2, 3]). значение // == [0, 2, 3] 

 idsDecoder.decode ([0, null, 2, 3]). Ошибка
{
  тип: 'ДОПОЛНИТЕЛЬНО',
  ошибка: {
    тип: 'AT_INDEX',
    позиция: 1,
    ошибка: {тип: 'EXPECT_INT', источник: null}
  }
} 

 import Decode, {Decoder} из decode-json

const idsDecoder: Decoder > = Декодировать.optional.list (
  Decode.optional.int
)

idsDecoder.decode (null) .value // === null
idsDecoder.decode ([0, null, 2, 3]). значение // === [0, null, 2, 3] 

 import Decode, {Decoder} из decode-json

const blackListDecoder: Decoder > = Декодировать. Необязательно.запись (Decode.boolean)

blackListDecoder.decode (null) .value // == null
blackListDecoder.decode (undefined) .value // == null
blackListDecoder.decode ({
  Джон: ложь,
  Эмма: правда,
  Том: правда
}).значение
// == {
// Джон: ложь,
// Эмма: правда,
// Том: правда
//} 

 blackListDecoder.decode ({
  Джон: ложь,
  Эмма: правда,
  Том: правда,
  Адам: ноль
}).ошибка
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
//   ошибка: {
// тип: 'IN_FIELD',
// имя: 'Адам',
// ошибка: {тип: 'EXPECT_BOOLEAN', источник: null}
//}
//} 

 import Decode, {Decoder} из decode-json

const blackListDecoder: Decoder > = Decode.optional.record (Decode.boolean)

blackListDecoder.decode (null) .value // === null
blackListDecoder.декодировать ({
  Джон: ложь,
  Эмма: правда,
  Том: правда,
  Адам: ноль
}).значение
// == {
// Джон: ложь,
// Эмма: правда,
// Том: правда,
// Адам: ноль
//} 

 import Decode, {Decoder} из decode-json

const blackListDecoder: Decoder > = Декодировать.optional.keyValue (Decode.boolean)

blackListDecoder.decode (null) .value // == null
blackListDecoder.decode (undefined) .value // == null
blackListDecoder.decode ({
  Джон: ложь,
  Эмма: правда,
  Том: правда
}).значение
// == [
// ['John', ложь],
// ['Эмма', правда],
// ['Том', правда]
//] 

 blackListDecoder.decode ({
  Джон: ложь,
  Эмма: правда,
  Том: правда,
  Адам: ноль
}).ошибка
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
//   ошибка: {
// тип: 'IN_FIELD',
// имя: 'Адам',
// ошибка: {тип: 'EXPECT_BOOLEAN', источник: null}
//}
//} 

 import Decode, {Decoder} из decode-json

const blackListDecoder: Decoder > = Decode.optional.keyValue (Decode.optional.boolean)

blackListDecoder.decode (null) .value // === null
blackListDecoder.декодировать ({
  Джон: ложь,
  Эмма: правда,
  Том: правда,
  Адам: ноль
}).значение
// == [
// ['John', ложь],
// ['Эмма', правда],
// ['Том', правда],
// ['Адам', ноль]
//] 

 импорт Decode, {OptionalDecodePath} из decode-json

const nameFieldDecoder: OptionalDecodePath = Decode.optional.field ('имя') 

 импорт Decode, {OptionalDecodePath} из decode-json

const headDecoder: OptionalDecodePath = Decode.optional.index (0) 

 импорт декодирования из decode-json

const pointDecoder = Decode.tuple (
  Decode.field ('x'). Float,
  Decode.field ('y'). Float
)

Decode.field ('центр'). Of (pointDecoder).декодировать ([1, 2, 3]). ошибка
// == {
// тип: 'EXPECT_OBJECT',
// источник: [1, 2, 3]
//}

Decode.field ('center'). Of (pointDecoder) .decode ({name: 'John'}). Error
// == {
// тип: 'REQUIRED_FIELD',
// имя: 'центр',
// источник: {имя: 'Джон'}
//}

Decode.field ('центр')
  .of (pointDecoder)
  .decode ({
    центр: {x: 1.2}
  }).ошибка
// == {
// тип: 'IN_FIELD',
// имя: 'центр',
//   ошибка: {
// тип: 'REQUIRED_FIELD',
// имя: 'y',
// источник: {x: 1.2}
//}
//}

Расшифровать.поле ('центр')
  .of (pointDecoder)
  .decode ({
    центр: {x: 1.2, y: 3.4}
  }). значение // == [1.2, 3.4] 

 импорт декодирования из decode-json

Decode.index (0) .int.decode ({}). Error
// == {
// тип: 'EXPECT_ARRAY',
//   источник: {}
//}

Decode.index (0) .int.decode ([]). Error
// == {
// тип: 'REQUIRED_INDEX',
// позиция: 0,
//   источник: []
//}

Decode.index (0) .int.decode ([null]). Ошибка
// == {
// тип: 'AT_INDEX',
// позиция: 0,
// ошибка: {тип: 'EXPECT_INT', источник: null}
//}

Расшифровать.index (0) .int.decode ([42]). value // == 42 

 импорт декодирования из decode-json

const pointDecoder = Decode.tuple (
  Decode.field ('x'). Float,
  Decode.field ('y'). Float
)

Decode.optional
  .field ('центр')
  .of (pointDecoder)
  .decode ({
    центр: {x: 1.2}
  }).ошибка
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
//   ошибка: {
// тип: 'IN_FIELD',
// имя: 'центр',
//     ошибка: {
// тип: 'REQUIRED_FIELD',
// имя: 'y',
// источник: {x: 1.2}
//}
//}
//}

Decode.optional
  .field ('центр')
  .of (pointDecoder)
  .decode ({
    центр: {x: 1.2, y: 3.4}
  }). значение // == [1.2, 3.4] 

 импорт декодирования из decode-json

Decode.optional.field ('name'). String.decode ({name: null}). Ошибка
{
  тип: 'ДОПОЛНИТЕЛЬНО',
  ошибка: {
    тип: 'IN_FIELD',
    name: 'имя',
    ошибка: {тип: 'EXPECT_STRING', источник: null}
  }
} 

 импорт декодирования из decode-json

Расшифровать.optional.field ('имя'). string.decode (null) .value // == null
Decode.optional.field ('name'). String.decode ({}). Value // == null
Decode.optional.field ('name'). String.decode ({name: 'Peter'}). Value // == 'Peter' 

 импорт декодирования из decode-json

Decode.optional.field ('имя'). Optional.string.decode ({name: null}).значение // == null 

 импорт декодирования из decode-json

Decode.optional.index (0) .int.decode (null) .value // == null
Decode.optional.index (0) .int.decode ([]). Value // == null
Decode.optional.index (0) .int.decode ([42]). Value // == 42
Decode.optional.index (0) .int.decode ([null]). Ошибка
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
//   ошибка: {
// тип: 'AT_INDEX',
// позиция: 0,
// ошибка: {тип: 'EXPECT_INT', источник: null}
//}
//}

Расшифровать.optional.index (0) .optional.int.decode ([null]). value // == null 

 // не экспортируется
type ExpectStringError = {
  тип: 'EXPECT_STRING'
  источник: неизвестно
} 

 импорт декодирования из decode-json

Decode.string.decode (123) .error
// == {
// тип: 'EXPECT_STRING',
// источник: 123
//} 

 // не экспортируется
type ExpectBooleanError = {
  тип: 'EXPECT_BOOLEAN'
  источник: неизвестно
} 

 импорт декодирования из decode-json

Расшифровать.string.decode ('Я строка'). error
// == {
// тип: 'EXPECT_BOOLEAN',
// источник: 'Я строка'
//} 

 // не экспортируется
type ExpectFloatError = {
  тип: 'EXPECT_FLOAT'
  источник: неизвестно
} 

 импорт декодирования из decode-json

Decode.int.decode (ложь) .error
// == {
// тип: 'EXPECT_FLOAT',
// источник: ложь
//} 

 // не экспортируется
type ExpectIntError = {
  тип: 'EXPECT_INT'
  источник: неизвестно
} 

 импорт декодирования из decode-json

Расшифровать.int.decode (12.3) .error
// == {
// тип: 'EXPECT_INT',
// источник: 12.3
//} 

 // не экспортируется
type ExpectExactError = {
  тип: 'EXPECT_EXACT'
  значение: строка | номер | логическое | ноль
  источник: неизвестно
} 

 импорт декодирования из decode-json

Decode.exact ('ADMIN'). Decode ('admin'). Error
// == {
// тип: 'EXPECT_EXACT',
// значение: 'ADMIN',
// источник: 'админ'
//}

const theWorstYear = новая дата (2020, 0, 1)

Расшифровать.точный (2020, худший год) .decode (2021) .error
// == {
// тип: 'EXPECT_EXACT',
// значение: 2020,
// источник: 2021 г.
//} 

 // не экспортируется
type ExpectArrayError = {
  тип: 'EXPECT_ARRAY'
  источник: неизвестно
} 

 импорт декодирования из decode-json

Decode.list (Decode.int) .decode ({title: 'NY Times'}). Ошибка
// == {
// тип: 'EXPECT_ARRAY',
// источник: {title: 'NY Times'}
//}

Расшифровать.index (2) .boolean.decode ({name: 'Boris'}). error
// == {
// тип: 'EXPECT_ARRAY',
// источник: {имя: 'Борис'}
//} 

 // не экспортируется
type ExpectObjectError = {
  тип: 'EXPECT_OBJECT'
  источник: неизвестно
} 

 импорт декодирования из decode-json

Decode.record (Decode.int) .decode ([1, 2, 3]). Ошибка
// == {
// тип: 'EXPECT_OBJECT',
// источник: [1, 2, 3]
//}

Расшифровать.keyValue (Decode.string) .decode (`Давайте рок!`) .error
// == {
// тип: 'EXPECT_OBJECT',
// источник: 'Давайте рок!'
//}

Decode.field ('length'). Boolean.decode ([true, false]). Ошибка
// == {
// тип: 'EXPECT_OBJECT',
// источник: [истина, ложь]
//} 

 // не экспортируется
type FailureError = {
  тип: 'ОТКАЗ'
  сообщение: строка
  источник: неизвестно
} 

 импорт декодирования из decode-json

Decode.int
  .chain (num => {
    if (num> 0) {
      return Decode.succeed (число)
    }

    return Decode.fail ('Ожидайте положительное целое число')
  })
  .decode (-1) .error
// == {
// тип: 'FAILURE',
// сообщение: 'Ожидайте положительное целое число',
// источник: -1
//}

Decode.keyValue (key => {
  константа число = parseInt (ключ, 10)

  if (! isNaN (число)) {
    return Decode.succeed (число)
  }

  вернуть Decode.fail ('Не удалось преобразовать строку в целое число')
}, Decode.string) .decode ({
  1: "первый",
  2: "второй",
  _3: 'третий'
})
// == {
// тип: 'FAILURE',
// сообщение: 'Не удалось преобразовать строку в целое число',
// источник: '_3'
//} 

 // не экспортируется
type RequiredIndexError = {
  тип: 'REQUIRED_INDEX'
  позиция: номер
  источник: Массив <неизвестно>
} 

 импорт декодирования из decode-json

Decode.index (2) .boolean.decode ([true, false]). Ошибка
// == {
// тип: 'REQUIRED_INDEX',
// позиция: 2,
// источник: [истина, ложь]
//} 

 // не экспортируется
type RequiredFieldError = {
  тип: 'REQUIRED_FIELD'
  имя: строка
  источник: Запись <строка, неизвестно>
} 

 импорт декодирования из decode-json

Decode.field ('возраст'). Int.decode ({
  id: 123,
  имя: 'Том'
}).ошибка
// == {
// тип: 'REQUIRED_FIELD',
//   Назовите возраст',
// источник: {id: 123, имя: 'Том'}
//} 

 // не экспортируется
type AtIndexError = {
  тип: 'AT_INDEX'
  позиция: номер
  ошибка: DecodeError
} 

 импорт декодирования из decode-json

Расшифровать.list (Decode.int) .decode ([1, 2, 2.5]). error
// == {
// тип: 'AT_INDEX',
// позиция: 2,
//   ошибка: {
// тип: 'EXPECT_INT',
// источник: 2.5
//}
//}

Decode.index (2) .boolean.decode ([false, true, 'ok']). Ошибка
// == {
// тип: 'AT_INDEX',
// позиция: 2,
//   ошибка: {
// тип: 'EXPECT_BOOLEAN',
// источник: 'ок'
//}
//} 

 // не экспортируется
type InFieldError = {
  тип: 'IN_FIELD'
  имя: строка
  ошибка: DecodeError
} 

 импорт декодирования из decode-json

Расшифровать.запись (Decode.int) .decode ({
  один: 1,
  два: 2,
  три: "3-й"
}).ошибка
// == {
// тип: 'IN_FIELD',
// имя: 'три',
//   ошибка: {
// тип: 'EXPECT_INT',
// источник: '3rd'
//}
//}

Decode.keyValue (Decode.string) .decode ({
  Россия: 'Москва',
  Нидерланды: 'Амстердам',
  США: ноль
}).ошибка
// == {
// тип: 'IN_FIELD',
// название: 'США',
//   ошибка: {
// тип: 'EXPECT_STRING',
// источник: null
//}
//}

Decode.field ('is_active'). Boolean.decode ({
  id: 123,
  имя: 'Карл',
  is_active: 'нет'
}).ошибка
// == {
// тип: 'IN_FIELD',
// имя: 'is_active',
//   ошибка: {
// тип: 'EXPECT_BOOLEAN',
// источник: 'нет'
//}
//} 

 // не экспортируется
type OptionalDecodeError = {
  тип: 'ДОПОЛНИТЕЛЬНО'
  ошибка: DecodeError
} 

 импорт декодирования из decode-json

Decode.optional.int.decode (1.23) .error
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
//   ошибка: {
// тип: 'EXPECT_INT',
// источник: 1.23
//}
//}

Decode.optional.field ('lat'). Float.decode ({
  lng: 123,45,
  lat: null
}).ошибка
// == {
// тип: 'ДОПОЛНИТЕЛЬНО',
//   ошибка: {
// тип: 'IN_FIELD',
// имя: 'широта',
//     ошибка: {
// тип: 'EXPECT_FLOAT',
// источник: null
//}
//}
//} 

 // не экспортируется
type OneOfError = {
  тип: 'ONE_OF'
  ошибки: Массив 
} 

 импорт декодирования из decode-json

Расшифровать.один из([
  Decode.tuple (
    // для координат как объекта
    Decode.field ('lat'). Float,
    Decode.field ('lng'). Float
  ),

  Decode.tuple (
    // для координат в виде массива
    Decode.index (0) .float,
    Decode.index (1) .float
  )
]). decode ({широта: 1.23, долгота: 4.56}). ошибка
// == {
// тип: 'ONE_OF',
// ошибки: [
// {
// тип: 'REQUIRED_FIELD',
// имя: 'lng',
// источник: {широта: 1.23, долгота: 4.56}
//},
// {
// тип: 'EXPECT_ARRAY',
// источник: {шир: 1.23, долг: 4.56}
//}
//]
//} 

 type RuntimeException = {
  тип: 'RUNTIME_EXCEPTION'
  error: Ошибка
} 

 type RuntimeException = {
  тип: 'INVALID_JSON'
  ошибка: SyntaxError
  источник: строка
} 

 импорт декодирования из decode-json

Decode.string.decodeJson ('Я просто строка'). Error
// == {
// тип: 'INVALID_JSON',
// ошибка: новый SyntaxError ('Неожиданный токен I в JSON в позиции 0'),
// источник: 'Я всего лишь строка'
//}