Как правило, patch вызывается следующим образом:
patch <PATCHFILE
patch OPTIONS... [ORIGFILE [PATCHFILE]] [+ OPTIONS... [ORIGFILE]]...
Вы можете указать один или более исходных файлов как аргументы ORIG; каждый из них и опции, управляющие его обработкой, отделяются друг от друга символом '+'.
Если вы не указываете входной файл в командной строке, patch пытается пропустить вводный текст, который мог быть добавлен перед началом выдачи diff, и определить имя файла для редактирования. В заголовках контекстного или унифицированного формата diff, patch пытается найти строки, начинающиеся с '***', '---' или '+++', а среди них выбирает кратчайшее имя существующего файла. В случае неудачи, если есть строка "Index:" во вводном тексте, patch пытается использовать имя файла из этой строки. Если patch не может найти таким образом имя существующего файла из вводного текста, он запрашивает имя файла для модификации у пользователя.
Если входной файл не существует, или доступ к файлу разрешен только для чтения, и существуют соответствующие RCS- или SCCS- файлы, patch пытается извлечь файлы оттуда перед обработкой.
По умолчанию, patch заменяет содержимое исходного входного файла на исправленную версию, создав предварительно резервную копию исходного входного файла. Вы можете также явно указать, куда должен быть помещен выходной файл с помощью опций -o OUTPUT-FILE или --output=OUTPUT-FILE.
Опция patch '-d DIRECTORY' или '--directory=DIRECTORY', делает каталог DIRECTORY текущим каталогом для интерпретации имен файлов, встречающихся в файле изменений, и имен файлом, заданных как аргументы в других опциях (таких как '-B' и '-o'). Например, находясь в программе чтения новостей, Вы можете исправить файл в каталоге /usr/src/emacs, применив изменения, присланные в статье телеконференции, непосредственно следующим образом:
| patch -d /usr/src/emacs
patch ищет каждый файл (после всех обрезанных имен каталогов) от текущего каталога, или если Вы указали опцию '-d DIRECTORY', то от указанного в ней каталога.
Например, допустим в файле изменений указано имя файла '/gnu/src/emacs/etc/NEWS'. Если используется опция -p или -p0, то это имя файла остается неизмененным. -p1 приводит к рассмотрению имени 'gnu/src/emacs/etc/NEWS' (первый символ '/' удаляется). '-p4' приводит к имени 'etc/NEWS'. Если опция -p не указана вообще, то рассматривается файл с именем 'NEWS'.
По умолчанию, 'patch' делает резервную копию изменяемого файла, переименовывая исходный файл добавляя к его имени расширение '.orig', или '~' на системах, которые не поддерживают длинных имен файлов. Опции '-b BACKUP-SUFFIX' или '--suffix=BACKUP-SUFFIX' позволяют использовать BACKUP-SUFFIX как расширение для имени резервного файла.
Вы можете так же указать расширение для резервных файлов с помощью переменной окружения 'SIMPLE_BACKUP_SUFFIX', действие которой тоже перекрывается этими опциями.
'patch' может создавать пронумерованные резервные файлы таким же образом, как это делает GNU Emacs. В этом случае patch будет создавать новый резервный файл каждый раз, когда к исходному файлу применяется patch. Например, если исходный файл называется sink, то резервные копии этого файла будут названы последовательно sink.~1~, sink.~2~, sink.~3~, и т.д.
Аргумент опций '-V BACKUP-STYLE' или '--version-control=BACKUP-STYLE' определяет способ именования резервных копий. Вы можете так же управлять типом создаваемых резервных копий с помощью переменной окружения 'VERSION_CONTROL', действие которой может быть перекрыто при использовании опции '-V'. Значения переменной 'VERSION_CONTROL' и аргумента опции '-V' такие же, как и для переменной version-control в редакторе GNU Emacs. Кроме того, распознаются более понятные синонимы этих значений. Допустимые значения перечислены ниже; можно указывать однозначно определяемые сокращения.
Всегда делать пронумерованные резервные копии.
Делать нумерованные резервные копии для файлов, для котороых уже имеются резервные копии и простые копии для остальных. Это значение принимается по умолчанию.
Всегда делать простую резервную копию.
Если резервная копия уже существует, patch создает новую резервную копию, изменяя первую встретившуюся в имени маленькую букву на соответствующую большую букву. Если больших букв нет в имени, то удалятся первый символ из имени. Это повторяется до тех пор, пока не будет получено имя файла, которой еще не существует.
Если Вы указываете имя выходного файла с помощью опции '-o', то создается резервная копия файла, указанного как ее аргумент, а не входного файла.
Имена файлов отвергнутых изменений (файлы, содержащие те изменения, которые patch не смог применить, поскольку не нашел соответствующего места) по умолчанию строятся приписыванием суффикса '.rej' (или '#' - для систем, не поддерживающих длинные имена файлов).
Вы можете явно указать patch, что он должен помещать все отвергнутые изменения в один файл. Опция '-r REJECT-FILE' или '--reject-file=REJECT-FILE' позволяет использовать REJECT-FILE как имя для файла отвергнутых изменений.
В этом разделе приводится полный список опций, которые понимаются программой 'patch'. Старые версии 'patch' не воспринимают опции с длинными именами и опции '-t', '-E' и '-V'.
Несколько однобуквенных опций без аргументов могут быть объединены в один аргумент командной строки (записывается один символ '-', за которым следуют буквы, соответствующие этим опциям). Квадратные скобки ([ и ]) показывают что опция может иметь необязательный аргумент.
Использовать BACKUP-SUFFIX как расширение для имен файлов с резервными копиями вместо '.orig' или '~'
Использовать BACKUP-PREFIX как префикс для имени файла с резервной копией. Если эта опция указано, то опция '-b' игнорируется.
Не задавать никаких вопросов (пакетный режим работы).
Рассматривать файл изменений как выдачу diff в контекстном формате.
Каталог DIRECTORY рассматривается как текущий каталог для интерпретации имен файлов, заданных в пакетном файле и в качестве аргументов для других опций.
Выполняет слияние в формате if-then-else. NAME - имя переменной.
Установка внутренних отладочных флагов. Опция представляет интерес только для тех, кто сам патчит (модифицирует) patch.
Файл изменений интерпретируется как скрипт для ed.
Удалять выходные файлы, которые оказались пустыми в результате применения изменений.
Считать, что пользователь уверен в своих действиях, и не задавать никаких вопросов.
Установить значение показателя максимальной неточности в LINES.
Считать, что пользователь уверен в своих действиях, и не задавать никаких вопросов.
Игнорировать изменения, которые patch считает реверсивными или уже примененными. См. также '-R'
Установить значение показателя максимальной неточности в LINES.
Печать справочной информации об опциях, воспринимаемых программой patch.
Выполняет слияние в формате if-then-else. NAME - имя переменной.
Любая последовательность символов-разделителей в файле изменений считается совпадающей с любой последовательностью символов-разделителей во входном файле.
Файл изменений рассматривается как результат работы diff в нормальном формате.
Игнорировать изменения, которые patch считает реверсивными или уже примененными. См. также '-R'
OUTPUT-FILE используется как имя выходного файла.
Устанавливает количество отсекаемых имен каталогов в NUMBER.
Использовать BACKUP-PREFIX как префикс для имени файла с резервной копией. Если эта опция указано, то опция '-b' игнорируется.
Работать без выдачи любых сообщений до момента возникновения ошибки.
Использовать REJECT-FILE как имя файла отвергнутых изменений.
Считать, что при создании файла различий имена старого и нового файлов были указаны наоборот (реверсивное изменение).
Использовать REJECT-FILE как имя файла отвергнутых изменений.
Удалять выходные файлы, которые оказались пустыми в результате применения изменений.
Считать, что при создании файла различий имена старого и нового файлов были указаны наоборот (реверсивное изменение).
Работать без выдачи любых сообщений до момента возникновения ошибки.
Пропустить данное изменение из файла изменений, но продолжать обработку со следующего изменения в файле.
Работать без выдачи любых сообщений до момента возникновения ошибки.
Пропустить данное изменение из файла изменений, но продолжать обработку со следующего изменения в файле.
Устанавливает количество отсекаемых имен каталогов в NUMBER.
Использовать BACKUP-SUFFIX как расширение для имен файлов с резервными копиями вместо '.orig' или '~'
Не задавать никаких вопросов.
Рассматривать файл изменений как результат работы diff в унифицированном формате.
Вывести номер версии patch.
Выбрать способ создания резервных копий изменяемых файлов.
Вывести номер версии patch.
Выбрать способ создания резервных копий изменяемых файлов.
Установка внутренних отладочных флагов. Опция представляет интерес только для тех, кто сам патчит (модифицирует) patch.