CITKIT.ru - свободные мысли о свободном софте
Деловая газета CitCity.ru Библиотека CITForum.ru Форумы Курилка
Каталог софта Движение Open Source Дискуссионный клуб Дистрибутивы Окружение Приложения Заметки Разное
23.08.2017

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

ОСТОРОЖНО: ВИНДОФИЛИЯ! (2250)
24 December, 22:53
Kubuntu Feisty (15)
24 December, 18:42
Один на один с Windows XP (3758)
24 December, 11:46

Каталог софта

Статьи

Дискуссионный клуб
Linux в школе
Open Source и деньги
Open Source и жизнь
Windows vs Linux
Копирайт
Кто такие анонимусы
Лицензии
Нетбуки
Нужен ли русский Linux?
Пользователи
Дистрибутивы
Идеология
Выбор дистрибутива
Archlinux & CRUX
Debian
Fedora
Gentoo
LFS
LiveCD
Mandriva
OpenSolaris
Slackware
Zenwalk
Другие линуксы
BSD
MINIX
Движение Open Source
История
Классика жанра
Окружение
shell
Библиотеки UI
Графические среды
Шрифты
Приложения
Безопасность
Управление пакетами
Разное
Linuxformat. Колонки Алексея Федорчука
Заметки
Блогометки
Файловые системы
Заметки о ядре

Заметки :: Блогометки :: Системы

Заметки :: Заметки о ядре

Применение патчей к ядру Linux

http://sites.google.com/site/gikneto/home

Оригинал: Applying Patches To The Linux Kernel

Часто задаваемый вопрос в списке рассылки ядра линукс — это как применить патч к ядру, или, точнее, какой патч для какой версии ядра подходит. В данном документе это объясняется.

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

Что такое патч (patch)?

Патч, или заплатка — это небольшой текстовый документ, содержащий суть изменений между двумя разными версиями исходных текстов. Патчи создаются с помощью программы 'diff'. Для правильного применения патча вам нужно знать, на основе чего он был создан, и в какую новую версию патч превратит исходные тексты ядра. И то и другое может быть представлено в метаданных файла патча и, возможно, в его названии.

Как применить или отменить патч?

Патч применяется с помощью программы 'patch'. Эта программа читает файл различий (или патч) и делает изменения в нужных местах исходных текстов.

Патчи для ядра Linux генерируются относительно родительского каталога, содержащего исходные тексты ядра.

Это означает, что пути к файлам внутри файла патча содержат имя директории исходных текстов ядра, относительно которой этот патч генерировался (или имена некоторых других директорий подобно «a/» или «b/»).

Поскольку это имя вряд ли будет совпадать с именем директории исходных текстов ядра на вашей машине (хотя часто оно помогает увидеть, для какой версии ядра был создан данный патч), вам следует перейти в свою директорию, содержащую исходные тексты ядра и затем отбросить первый элемент в путевых именах файлов в файле патча до того, как его применить (для этого служит ключ -p1 в программе 'patch').

Чтобы отменить примененный патч, используйте ключ -R. Например, если вы применили патч следующим образом:

patch -p1 < ../patch-x.y.z

то отменить его можно так:

patch -R -p1 < ../patch-x.y.z

Как передавать файл заплатки/патча программе 'patch'?

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

patch -p1 < path/to/patch-x.y.z

Если для вас этого достаточно, можете дальше не читать этот раздел.

Программе 'patch' можно передать имя файла, используя ключ -i, как в следующем примере:

patch -p1 -i путь/к/патчу-x.y.z

Если файл патча содержится в архиве gzip или bzip, и вы не хотите распаковывать его заранее, можно вызвать 'patch' так:

zcat path/to/patch-x.y.z.gz | patch -p1
bzcat path/to/patch-x.y.z.bz2 | patch -p1

Если файл патча содержится в архиве, и вы хотите разархивировать его вручную до применения, (в примерах ниже это предполагается), это можно сделать так:

gunzip patch-x.y.z.gz
bunzip2 patch-x.y.z.bz2

Это даст вам обычный текстовый файл, который можно передавать программе 'patch' через стандартный ввод или через ключ -i, как вам захочется.

К числу других интересные ключей программы 'patch' относятся -s, вынуждающий программу не выводить никаких сообщений, кроме сообщений об ошибках, что позволяет лучше их заметить, и ключ --dry-run который заставляет программу просто выдать листинг того, что будет происходить, а в реальности ничего не менять. Наконец, ключ --verbose указывает программе 'patch' о потребности вывода максимума информации о происходящем.

Основные ошибки

Когда программа 'patch' применяет патч, она пытается проверить файл разными способами. В частности, проверяется, что файл является допустимым патч-файлом и что код, окружающий биты, которые должны быть изменены, соответствует контексту патча.

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

Один из примеров ситуации «что-то не так», которую программа пытается исправить, — это когда контекст изменений присутствует, нужные строки находятся, но у них другие номера. Так может случиться, к примеру, если программа 'patch' делает изменения в середине файла, но по каким-то причинам несколько строк в начале файла были добавлены или удалены. Если все остальное в порядке, программа обычно подгоняет номера строк и применяет патч.

Всякий раз, когда программа 'patch' применяет патч с его предварительной модификацией, она сообщает вам, что патч применен с 'подгонкой' ('fuzz').

Вы должны быть осторожны с подобными изменениям, поскольку даже если все выглядит верно, это не всегда так, и что-либо может быть неправильно.

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

Если вы не применяете к исходным текстам своего ядра неофициальные патчи, а используете только патчи с ресурса kernel.org, применяя их в правильном порядке, и не делаете самостоятельных изменений в исходных текстах ядра, то вы никогда не увидите сообщений 'fuzz' или 'reject' от программы 'patch'. Если они будут выдаваться, это свидетельствует об порче ваших локальных исходных текстов или скаченного патча. Вам стоит попробовать снова закачать патч, а если и это не устранит проблемы, то следует скачать полные исходные тексты ядра с kernel.org.

Давайте посмотрим на другие сообщения, которые может генерировать программа 'patch'.

Если программа останавливается и выводит сообщение "File to patch:", значит она не смогла найти файл патча. Обычно это означает, что вы забыли указать ключ -p1 или находитесь не в нужной директории. Но иногда так случается, когда вы применяете патч, для которого нужен ключ -p0, а не -p1 (исследуйте файл патча на предмет этого, и если это так, то это ошибка человека, создавшего патч, и она поправима ).

Если вы получили сообщение "Hunk #2 succeeded at 1887 with fuzz 2 (offset 7 lines)." или подобное, это означает, что программа 'patch' регулировала применяемые изменения (в данном случае пришлось передвинуться на 7 строк от того места, где они должны были применяться, чтобы их стало можно применить). Результирующий файл может получиться правильным или неправильным в зависимости от причин, по которым исходный файл был не таким, как ожидалось. Так часто случается, когда вы пытаетесь применить патч не к той версии ядра.

Если вы получили сообщение "Hunk #3 FAILED at 2387.", это означает что программа не смогла применить патч даже с подгонкой. В этом случае генерируется файл .rej с информацией о неудавшемся изменении, а также файл с расширением .orig, содержащий оригинальный текст, который не удалось заменить.

Сообщение "Reversed (or previously applied) patch detected! Assume -R? [n]" означает, что программа обнаружила, что патч уже применен.

Если вы действительно применяли этот патч и вторичное применение — это ошибка, нажмите [n] и завершите выполнение программы. Если вы применяли его, а теперь хотели отменить, просто забыв ключ указать -R, нажмите [y]. Такое также случается, когда человек, создававший патч, поменял местами исходный и целевой каталоги, и в этом случае применение патча и заключается в отмене изменений.

Сообщение "patch: **** unexpected end of file in patch" или "patch unexpectedly ends in middle of line" означает, что программа не может обнаружить в файле патча нужное содержание. Это значит, что либо вы некорректно загрузили патч, либо пытаетесь применить патч не в разархивированном виде, либо применяете патч, переданный через почтовый клиент или что-то и подобное, разбивающее длинные строки на две. Зачастую такие предупреждения могут легко быть устранены путем объединения (конкатенации) таких двойных строк.

Как ранее указывалось, эти ошибки не могут проявиться, когда вы применяете официальные патчи с ресурса kernel.org в правильном порядке и к не измененным исходным текстам ядра. Таким образом, если это случается с патчами с kernel.org, это обозначает искажение патча при загрузке или исходных текстов на вашей машине, и вам стоит полностью заново перекачать исходные тексты ядра или патч, который вы намерены применить.

Есть ли альтернативы программе 'patch'?

Они есть.

Можно использовать программу 'interdiff' (http://cyberelk.net/tim/patchutils/) для создания патча, представляющего разницу между двумя патчами, и дальнейшего его применения.

Она позволит вам перейти, например, от 2.6.12.2 к 2.6.12.3 за один шаг. Флаг -z программы interdiff позволяет работать с патчами в архивах gzip и bzip2, не извлекая их заранее вручную и без использования zcat и bzcat.

Вот пример:

interdiff -z ../patch-2.6.12.2.bz2
../patch-2.6.12.3.gz | patch -p1

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

Другой альтернативой является сценарий 'ketchup', написанный на языке python, который автоматически скачивает и применяет патчи (http://www.selenic.com/ketchup/).

Другими интересными инструментами являются diffstat, который показывает сводку изменений, сделанных программой patch; lsdiff, который выводит краткий перечень файлов, затрагиваемых заданным патч-файлом, вместе с номерами изменяемых строк; и grepdiff, показывающий список файлов, модифицируемых патчем, для которых элементы патча содержат заданное регулярное выражение.

Где я могу скачать патчи?

Патчи доступны на http://kernel.org/ Наиболее свежие патчи доступны с главной страницы, но для них имеются и отдельные страницы.

Патчи 2.6.x.y (-stable) и 2.6.x содержатся на ftp://ftp.kernel.org/pub/linux/kernel/v2.6/

Патчи -rc содержатся на ftp://ftp.kernel.org/pub/linux/kernel/v2.6/testing/

Патчи -git содержатся на ftp://ftp.kernel.org/pub/linux/kernel/v2.6/snapshots/

Патчи -mm содержатся на ftp://ftp.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/

Взамен ftp.kernel.org вы можете использовать ftp.cc.kernel.org, где cc — код страны. Использование для закачки зеркало из наиболее ближней к вам страны позволяет ускорить загрузку, сократить глобальный трафик и уменьшить нагрузку на сервер kernel.org. Поэтому при наличии возможности используйте зеркала.

Ядра 2.6.x

Имеются основные стабильные релизы, выпускаемые Линусом Торвальдсом. Чем больше номер, тем свежее релиз.

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

Чтобы применить патч от 2.6.11 к 2.6.12, нужно сделать следующее (учитывайте что такие патчи не применимы к ядрам версий 2.6.x.y, их можно применять только к базовым версиям 2.6.x ядро — если необходимо перейти от 2.6.x.y к 2.6.x+1, то нужно сперва применить патч, отменяющий 2.6.x.y, т.е. вернуться к 2.6.x).

Вот несколько примеров:

# от версии 2.6.11 к версии 2.6.12

$ cd ~/linux-2.6.11 # войти в директорию текстов ядра

$ patch -p1 < ../patch-2.6.12 # применить патч 2.6.12

$ cd .. $ mv linux-2.6.11 linux-2.6.12 # переименование

# от версии 2.6.11.1 к версии 2.6.12 $ cd ~/linux-2.6.11.1 # войти в директорию текстов ядра

$ patch -p1 -R < ../patch-2.6.11.1 # отменить патч 2.6.11.1 # версия ядра теперь 2.6.11

$ patch -p1 < ../patch-2.6.12 # применить патч 2.6.12

$ cd .. $ mv linux-2.6.11.1 linux-2.6.12 # переименование

Ядра 2.6.x.y

Ядра с четырехцифренными номерами версий называются -stable. Они содержат минимальные критические исправления, касающиеся проблем безопасности или существенных регрессий, обнаруженных в данном ядре 2.6.х.

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

Если нет доступного ядра 2.6.x.y, то текущей стабильной версией является ядро с самым большим номером 2.6.x.

Замечание: команда разработчиков -stable обычно делает доступными не только патчи для последнего основного выпуска, но и инкрементальные патчи. Однако ниже я говорю только про не инкрементальные патчи. Инкрементальные же патчи доступны на ftp://ftp.kernel.org/pub/linux/kernel/v2.6/incr/

Не инкрементальность патча означает, например, что патч 2.6.12.3 подходит для обновления основной версии 2.6.12, но не промежуточной версии 2.6.12.2. Для применения патча 2.6.12.3 к существующему ядру 2.6.12.2 вы должны сперва отменить патч 2.6.12.2 (перейти назад к версии 2.6.12), а затем применить патч 2.6.12.3.

Вот небольшой пример:

$ cd ~/linux-2.6.12.2
# переход в директорию текстов ядра

$ patch -p1 -R < ../patch-2.6.12.2 # отмена 2.6.12.2 патча

$ patch -p1 < ../patch-2.6.12.3 # применение нового 2.6.12.3 патча

$ cd .. $ mv linux-2.6.12.2 linux-2.6.12.3 # переименование

Ядра -rc: релиз-кандидатные ядра

Это опытные ядра, выпускаемые Линусом, когда он сочтет, что текущее дерево git (приложение управления исходными текстами ядра) находится в состоянии, достаточно пригодном для тестирования.

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

Это хороший выбор для тех, кто хочет тестировать новые ядра, но, на самом деле, не хочет экспериментировать. (Таким людям следует прочитать ниже разделы -git и -mm ниже).

Патчи -rc — не инкрементальные, они применяются к базовому ядру 2.6.x , подобно патчам 2.6.x.y, отмеченным выше. Часть номера версии ядра до суффикса -rcN указывает номер версии ядра, в которую, в конечном счете, все должно превратиться.

Таким образом, 2.6.13-rc5 означает, что это пятый кандидат-релиз для ядра 2.6.13, и патч должен применяться к версии 2.6.12.

Вот три примера наложения этого патча:

# первый пример, делающий из 2.6.12 версию 2.6.13-rc3

$ cd ~/linux-2.6.12 # переход в директорию текстов ядра

$ patch -p1 < ../patch-2.6.13-rc3 # применение патча

$ cd .. $ mv linux-2.6.12 linux-2.6.13-rc3 # переименование

# переход из 2.6.13-rc3 в 2.6.13-rc5 $ cd ~/linux-2.6.13-rc3 # переход в директорию текстов ядра

$ patch -p1 -R < ../patch-2.6.13-rc3 # отмена патча 2.6.13-rc3

$ patch -p1 < ../patch-2.6.13-rc5 # применение нового 2.6.13-rc5 патча

$ cd .. $ mv linux-2.6.13-rc3 linux-2.6.13-rc5 # переименование

# наконец попытка перехода от 2.6.12.3 к 2.6.13-rc5

$ cd ~/linux-2.6.12.3 # переход в директорию

$ patch -p1 -R < ../patch-2.6.12.3 # отмена 2.6.12.3 патча

$ patch -p1 < ../patch-2.6.13-rc5 # применение 2.6.13-rc5 патча

$ cd .. $ mv linux-2.6.12.3 linux-2.6.13-rc5 # переименование

Ядра -git

Эти ежедневные снимки дерева ядра Линуса (сделанные в репозитарии git, поэтому такое название).

Эти патчи обычно ежедневные и представляют текущее состояние версии Линуса. Они более экспериментальные, чем -rc ядра, поскольку генерируются автоматически даже без беглого взгляда на их работоспособность.

Патчи -git — не инкрементальные и применяются к базовому ядру 2.6.х или базовому ядру 2.6.x.rc, что видно из их имен. Патч с именем 2.6.12-git1 применяется к ядру 2.6.12, а патч с именем 2.6.13-rc3-git2 — к 2.6.13-rc3.

Вот несколько примеров применения патчей:

# из 2.6.12 к 2.6.12-git1

$ cd ~/linux-2.6.12 # переход в нужный каталог

$ patch -p1 < ../patch-2.6.12-git1 # применение патча 2.6.12-git1

$ cd .. $ mv linux-2.6.12 linux-2.6.12-git1 # переименование

# от 2.6.12-git1 к 2.6.13-rc2-git3

$ cd ~/linux-2.6.12-git1 # переход в нужную директорию

$ patch -p1 -R < ../patch-2.6.12-git1 # отмена патча 2.6.12-git1 # теперь вы имеете ядро 2.6.12

$ patch -p1 < ../patch-2.6.13-rc2 # применение патча 2.6.13-rc2 # ядро теперь 2.6.13-rc2

$ patch -p1 < ../patch-2.6.13-rc2-git3 # применение патча 2.6.13-rc2-git3 # ядро теперь 2.6.13-rc2-git3

$ cd .. $ mv linux-2.6.12-git1 linux-2.6.13-rc2-git3 # переименование

Ядра -mm

Это экспериментальные ядра, выпускаемые Андрю Мортоном (Andrew Morton).

Ветка -mm является неким видом полигона для образования патчей с новыми возможностями и другими экспериментальными особенностями.

После того, как некоторый патч доказывает свою ценность в ветке -mm в течении какого-то времени, Андрю предлагает его Линусу для включения в основную ветку.

Хотя по установленным правилам эти патчи передаются Линусу через ветку -mm, эти правила не всегда соблюдаются. Мейнтейнеры подсистем (или просто разработчики) иногда пересылают свои патчи напрямую Линусу, даже если они были объединены и протестированы в -mm (а иногда даже без предварительного тестирования в -mm).

Для обеспечения максимального тестирования в большинстве случаев следует стремиться получать патчи через -mm.

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

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

Для этих ядер, в дополнение ко всем другим экспериментальным патчам, как правило, поддерживаются различные изменения к основным ядрам ветки -git ядер к моменту выпуска.

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

Версии ядер -mm не выпускаются по какому-либо установленному плану, но обычно в промежутке между выпусками ядер -rc выходит несколько версий ядра -mm (обычно от одной до трех). Патчи ветки -mm применяются к базовому ядру 2.6.x (до выхода -rc версии) или к ветке -rc Линуса.

Вот несколько примеров того, как их применять:

# переход от  2.6.12 к 2.6.12-mm1
$ cd ~/linux-2.6.12
# переход в директорию 2.6.12

$ patch -p1 < ../2.6.12-mm1 # применение патча 2.6.12-mm1

$ cd .. $ mv linux-2.6.12 linux-2.6.12-mm1 # переименование

# переход от 2.6.12-mm1 к 2.6.13-rc3-mm3 $ cd ~/linux-2.6.12-mm1 $ patch -p1 -R < ../2.6.12-mm1 # отмена патча 2.6.12-mm1 # теперь вы имеете ядро 2.6.12

$ patch -p1 < ../patch-2.6.13-rc3 # применение патча 2.6.13-rc3 # теперь вы имеете ядро 2.6.13-rc3

$ patch -p1 < ../2.6.13-rc3-mm3 # применение патча 2.6.13-rc3-mm3

$ cd .. $ mv linux-2.6.12-mm1 linux-2.6.13-rc3-mm3 # переименование

На этом список разъяснений по различным ядра деревьев можно закончить.

Я надеюсь, что вам теперь ясно, как применять различные патчи и помочь в тестировании ядер.

Особая благодарность Рэнди Данлэп (Randy Dunlap), Ролфу Айке Беру (Rolf Eike Beer), Линусу Торвальсу (Linus Torvalds), Бого Эггерту (Bodo Eggert), Йоханнесу Стезенбаху (Johannes Stezenbach), Гранту Коди (Grant Coady), Павлу Мачеку (Pavel Machek) и другим, которых я забыл указать, за помощь в создании данного документа.




Комментарии

аноним, Mon Aug 3 12:21:10 2009:
что комментировать? Спасибо большое за перевод. Будем применять и знать.

Комментарии заморожены.

Новости:

Все новости на CitCity.ru

Компании месяца

 
Последние комментарии
Почему школам следует использовать только свободные программы (101)
20 Декабрь, 14:51
ОСТОРОЖНО: ВИНДОФИЛИЯ! (2250)

24 Декабрь, 22:53
Linux в школе: мифы про школу и информатику (334)
24 Декабрь, 22:43
Kubuntu Feisty (15)
24 Декабрь, 18:42
Software is like sex: it's better when it's free.
©Linus Torvalds