parche: en línea en la nube

PROGRAMA:

NOMBRE

parche: aplica un archivo diff a un original

SINOPSIS

parche [opciones] [archivo original [archivo de parche]]

pero generalmente solo

parche -pnúmero <archivo de parche

DESCRIPCIÓN

parche toma un archivo de parche archivo de parche que contiene una lista de diferencias producida por el diff
programa y aplica esas diferencias a uno o más archivos originales, produciendo parcheado
versiones. Normalmente, las versiones parcheadas se colocan en lugar de las originales. Las copias de seguridad pueden
hacerse; ver el -b or --respaldo opción. Los nombres de los archivos que se van a parchear suelen ser
tomado del archivo de parche, pero si solo hay un archivo para parchear, se puede especificar
en la línea de comando como archivo original.

Al iniciarse, el parche intenta determinar el tipo de listado de diferencias, a menos que se anule
por una -c (--contexto), -e (--ed), -n (--normal), o -u (--unificado) opción. Diferencias de contexto
(estilo antiguo, estilo nuevo y unificado) y las diferencias normales son aplicadas por el parche programa
en sí mismo, mientras ed diffs simplemente se alimentan al ed(1) editor a través de una tubería.

parche intenta omitir cualquier basura inicial, aplicar la diferencia y luego omitir cualquier final
basura. Por lo tanto, puede enviar un artículo o mensaje que contenga una lista de diferencias para parche,
y debería funcionar. Si toda la diferencia tiene una sangría constante, si las líneas terminan
en CRLF, o si una diferencia se encapsula una o más veces anteponiendo "- "a líneas
empezando con "-"según lo especificado por Internet RFC 934, esto se tiene en cuenta. Después
eliminar sangría o encapsulación, las líneas que comienzan con # son ignorados, ya que son
considerados comentarios.

Con diferencias de contexto, y en menor medida con diferencias normales, parche puede detectar cuando el
Los números de línea mencionados en el parche son incorrectos e intentan encontrar el lugar correcto.
para aplicar cada trozo del parche. Como primera suposición, toma el número de línea mencionado para
el trozo, más o menos cualquier compensación utilizada al aplicar el trozo anterior. Si ese no es el
lugar correcto, parche escanea tanto hacia adelante como hacia atrás en busca de un conjunto de líneas que coincidan con el
contexto dado en el trozo. Primero parche busca un lugar donde todas las líneas del contexto
fósforo. Si no se encuentra tal lugar, y es una diferencia de contexto, y el factor de fuzz máximo es
establecido en 1 o más, luego se realiza otro escaneo ignorando la primera y la última línea de
contexto. Si eso falla, y el factor de fuzz máximo se establece en 2 o más, los dos primeros
y se ignoran las dos últimas líneas de contexto y se realiza otro escaneo. (El máximo predeterminado
factor de fuzz es 2.)

Los hunks con menos contexto de prefijo que contexto de sufijo (después de aplicar fuzz) deben aplicarse en el
inicio del archivo si su número de primera línea es 1. Hunks con más contexto de prefijo que
El contexto del sufijo (después de aplicar fuzz) debe aplicarse al final del archivo.

If parche no puede encontrar un lugar para instalar ese trozo del parche, pone el trozo a un
rechazar archivo, que normalmente es el nombre del archivo de salida más un .rej sufijo, o # if
.rej generaría un nombre de archivo que es demasiado largo (incluso si se agrega el carácter único #
hace que el nombre del archivo sea demasiado largo, entonces # reemplaza el último carácter del nombre del archivo).

El trozo rechazado sale en formato unificado o de diferencia de contexto. Si la entrada fuera normal
diff, muchos de los contextos son simplemente nulos. Los números de línea de los trozos en el rechazo
El archivo puede ser diferente al del archivo de parche: reflejan la ubicación aproximada del parche
cree que los macizos fallidos pertenecen al nuevo archivo en lugar del anterior.

A medida que se completa cada trozo, se le indica si el trozo falló y, de ser así, qué línea (en el
archivo nuevo) parche Pensé que el galán debería continuar. Si el trozo está instalado en un lugar diferente
línea desde el número de línea especificado en la diferencia, se le indica el desplazamiento. Un solo grande
compensar pueden indican que un trozo se instaló en el lugar equivocado. También se le informa si un
se usó el factor de fuzz para hacer la coincidencia, en cuyo caso también debe ser ligeramente
suspicaz. Si el --verboso se le da la opción, también se le informa acerca de los macizos que coinciden
exactamente.

Si no hay archivo original archivo original se especifica en la línea de comando, parche trata de averiguar
de la basura principal cuál es el nombre del archivo a editar, usando las siguientes reglas.

en primer lugar, parche toma una lista ordenada de nombres de archivos candidatos de la siguiente manera:

· Si el encabezado es el de una diferencia de contexto, parche toma los nombres de archivo antiguo y nuevo en el
encabezamiento. Un nombre se ignora si no tiene suficientes barras para satisfacer la -pnúmero or
--strip =número opción. El nombre / dev / null también se ignora.

· Si hay una Índice: línea en la basura principal y si el nombre antiguo y el nuevo
ambos están ausentes o si parche cumple con POSIX, parche toma el nombre en el Índice:
la línea.

· A los efectos de las siguientes reglas, los nombres de los archivos candidatos se consideran
en el orden (antiguo, nuevo, índice), independientemente del orden en que aparecen en el encabezado.

Entonces parche selecciona un nombre de archivo de la lista de candidatos de la siguiente manera:

· Si existen algunos de los archivos nombrados, parche selecciona el nombre si se ajusta a POSIX,
y el mejor nombre de lo contrario.

· If parche no ignora RCS, ClearCase, Perforce y SCCS (consulte la -g número or
--get =número opción), y no existen archivos con nombre, excepto RCS, ClearCase, Perforce o SCCS
se encuentra el maestro, parche selecciona el primer archivo nombrado con un RCS, ClearCase, Perforce,
o maestro SCCS.

· Si no existen archivos con nombre, no se encontró ningún maestro RCS, ClearCase, Perforce o SCCS, algunos
se dan nombres, parche no se ajusta a POSIX, y el parche parece crear un
archivo, parche selecciona el mejor nombre que requiere la creación de la menor cantidad de directorios.

· Si no se obtiene un nombre de archivo de la heurística anterior, se le pedirá el nombre del
archivo para parchear, y parche selecciona ese nombre.

Para determinar el el mejor de una lista no vacía de nombres de archivos, parche primero toma todos los nombres
con la menor cantidad de componentes de nombre de ruta; de ellos, luego toma todos los nombres con la
nombre de base más corto; de esos, luego toma todos los nombres más cortos; finalmente, se necesita el
primer nombre restante.

Además, si la basura principal contiene un Prerrequisito: línea, parche toma la primera palabra
de la línea de requisitos previos (normalmente un número de versión) y comprueba el archivo original para
mira si esa palabra se puede encontrar. Que no, parche solicita confirmación antes de continuar.

El resultado de todo esto es que debería poder decir, en una interfaz de noticias,
algo como lo siguiente:

| parche -d / usr / src / local / blurfl

y parchear un archivo en el difuminar directorio directamente desde el artículo que contiene el parche.

Si el archivo de parche contiene más de un parche, parche intenta aplicar cada uno de ellos como si
procedían de archivos de parche separados. Esto significa, entre otras cosas, que se asume
que el nombre del archivo a parchear debe determinarse para cada lista de diferencias, y que el
basura antes de cada lista de diferencias contiene cosas interesantes como nombres de archivos y
nivel de revisión, como se mencionó anteriormente.

OPCIONES

-b or --respaldo
Crea archivos de respaldo. Es decir, al parchear un archivo, cambie el nombre o copie el original.
de quitarlo. Ver el -V or --control de versiones opción para obtener detalles sobre cómo la copia de seguridad
se determinan los nombres de los archivos.

- copia de seguridad-si-no coincide
Realice una copia de seguridad de un archivo si el parche no coincide exactamente con el archivo y si las copias de seguridad no
de lo contrario solicitado. Este es el valor predeterminado a menos que parche cumple con POSIX.

--no-respaldo-si-no coincide
No realice una copia de seguridad de un archivo si el parche no coincide exactamente con el archivo y si las copias de seguridad están
no solicitado de otra manera. Este es el valor predeterminado si parche cumple con POSIX.

-B preferencia or --prefix =preferencia
Ingrese al simples método para determinar los nombres de los archivos de respaldo (consulte el -V Método or
--control de versiones Método opción) y anexar preferencia a un nombre de archivo al generar su
nombre del archivo de copia de seguridad. Por ejemplo, con -B /basura/ el nombre de archivo de copia de seguridad simple para
src / parche / util.c is /junk/src/parche/util.c.

--binario
Escriba todos los archivos en modo binario, excepto la salida estándar y / dev / tty. Al leer,
deshabilite la heurística para transformar las terminaciones de línea CRLF en terminaciones de línea LF. Esta
La opción es necesaria en sistemas POSIX cuando se aplican parches generados en sistemas que no son POSIX.
a archivos que no son POSIX. (En los sistemas POSIX, las lecturas y escrituras de archivos nunca transforman la línea
finales. En Windows, las lecturas y escrituras transforman los finales de línea de forma predeterminada, y los parches
debe ser generado por diff --binario cuando los finales de línea son significativos).

-c or --contexto
Interprete el archivo de parche como una diferencia de contexto ordinaria.

-d dir or --directory =dir
Cambiar al directorio dir inmediatamente, antes de hacer cualquier otra cosa.

-D definir or --ifdef =definir
Ingrese al #ifdef ... #terminara si construir para marcar cambios, con definir como el diferenciador
símbolo.

- corrida en seco
Imprima los resultados de la aplicación de los parches sin cambiar ningún archivo.

-e or --ed
Interprete el archivo de parche como un ed guión.

-E or - eliminar-archivos-vacíos
Elimine los archivos de salida que estén vacíos después de que se hayan aplicado los parches. Normalmente esto
La opción es innecesaria, ya que parche puede examinar las marcas de tiempo en el encabezado para
determinar si un archivo debe existir después de la revisión. Sin embargo, si la entrada no es
diferencia de contexto o si parche cumple con POSIX, parche no quita parche vacío
archivos a menos que se dé esta opción. Cuando parche elimina un archivo, también intenta
elimine los directorios de antepasados ​​vacíos.

-f or --fuerza
Suponga que el usuario sabe exactamente lo que está haciendo y no pregunte
preguntas. Omitir parches cuyos encabezados no indiquen qué archivo se va a parchear; parche
archivos a pesar de que tienen la versión incorrecta para el Prerrequisito: línea en el parche; y
suponga que los parches no se invierten incluso si se ven así. Esta opción hace
no suprimir comentarios; usar -s para eso.

-F número or --fuzz =número
Establezca el factor de fuzz máximo. Esta opción solo se aplica a diferencias que tienen contexto y
causas parche ignorar tantas líneas de contexto al buscar lugares para
instalar un trozo. Tenga en cuenta que un factor de fuzz más grande aumenta las probabilidades de un parche defectuoso.
El factor de fuzz predeterminado es 2. Un factor de fuzz mayor o igual al número de
líneas de contexto en el contexto diff, normalmente 3, ignora todo el contexto.

-g número or --get =número
Esta opción controla parcheacciones cuando un archivo está bajo control RCS o SCCS, y no
no existe o es de solo lectura y coincide con la versión predeterminada, o cuando un archivo está bajo
Control ClearCase o Perforce y no existe. Si número es positivo, parche obtiene (o
extrae) el archivo del sistema de control de revisiones; si es cero, parche ignora RCS,
ClearCase, Perforce y SCCS y no obtiene el archivo; y si es negativo, parche pregunta
el usuario si desea obtener el archivo. El valor predeterminado de esta opción viene dado por el
valor de la PATCH_GET variable de entorno si está configurada; si no, el valor predeterminado es
cero.

--ayuda
Imprima un resumen de opciones y salga.

-i archivo de parche or --input =archivo de parche
Leer el parche de archivo de parche. Si archivo de parche is -, leer de la entrada estándar, el
predeterminada.

-l or --ignore-espacios en blanco
Haga coincidir los patrones de forma holgada, en caso de que se hayan marcado pestañas o espacios en sus archivos. Alguna
secuencia de uno o más espacios en blanco en el archivo de parche coincide con cualquier secuencia en el original
archivo, y las secuencias de espacios en blanco al final de las líneas se ignoran. Los personajes normales deben
todavía coinciden exactamente. Cada línea del contexto debe coincidir con una línea en el original
archivo.

--unir or --merge = fusionar or --merge = diff3
Fusionar un archivo de parche en los archivos originales similar a diferencia3(1) o unir(1). Si un
se encuentra el conflicto, parche emite una advertencia y pone entre paréntesis el conflicto con <<<<<< y
>>>>>>> líneas. Un conflicto típico se verá así:

<<<<<<
líneas Desde los mas originales presentar
|||||||
mas originales líneas Desde los parche
=======
new líneas Desde los parche
>>>>>>>

El argumento opcional de --unir determina el formato de salida para los conflictos: el diff3
formato muestra el ||||||| sección con las líneas originales del parche; en la fusión
formato, falta esta sección. El formato de combinación es el predeterminado.

Esta opción implica --hacia adelante y no toma el --pelusa=número opción en cuenta.

-n or --normal
Interprete el archivo de parche como una diferencia normal.

-N or --hacia adelante
Cuando un parche no se aplica, el parche generalmente verifica si el parche parece que ha sido
invertido. los --hacia adelante La opción evita eso. Ver también -R.

-o archivar or --salida =archivar
Enviar salida a archivar en lugar de parchear los archivos en su lugar. No use esta opción si
archivar es uno de los archivos que se van a parchear. Cuando archivar is -, enviar salida a estándar
salida, y enviar cualquier mensaje que normalmente iría a salida estándar a estándar
error.

-pnúmero or --strip =número
Quite el prefijo más pequeño que contenga número barras inclinadas de cada nombre de archivo que se encuentra en
el archivo de parche. Una secuencia de una o más barras adyacentes se cuenta como una sola
barra oblicua. Esto controla cómo se tratan los nombres de archivo que se encuentran en el archivo de parche, en caso de que
mantenga sus archivos en un directorio diferente al de la persona que envió el parche. Para
ejemplo, suponiendo que el nombre del archivo en el archivo de parche fuera

/u/howard/src/blurfl/blurfl.c

pólipo -p0 da el nombre de archivo completo sin modificar, -p1 da

u / howard / src / blurfl / blurfl.c

sin la barra inicial, -p4 da

blurfl / blurfl.c

y no especificando -p nada solo te da Blurfl.c. Lo que sea que termines se ve
ya sea en el directorio actual, o en el directorio especificado por el -d .

--posix
Cumplir más estrictamente con el estándar POSIX, de la siguiente manera.

· Tome el primer archivo existente de la lista (antiguo, nuevo, índice) al intuir el archivo
nombres de los encabezados diff.

· No elimine archivos que estén vacíos después de la revisión.

· No pregunte si desea obtener archivos de RCS, ClearCase, Perforce o SCCS.

· Requiere que todas las opciones precedan a los archivos en la línea de comando.

· No haga copias de seguridad de los archivos cuando no coincidan.

--quoting-style =palabra clave
Usa estilo palabra clave para citar nombres de salida. los palabra clave debe ser uno de los siguientes:

literal
Nombres de salida tal cual.

shell Citar nombres para el shell si contienen metacaracteres del shell o causarían
salida ambigua.

shell-siempre
Cite los nombres del shell, incluso si normalmente no requieren citar.

c Cite los nombres como para una cadena de lenguaje C.

escapar Citar como con c excepto que omita los caracteres de comillas dobles circundantes.

Puede especificar el valor predeterminado de la - estilo de comillas opción con el medio ambiente
variable ESTILO_COTIZACIÓN. Si esa variable de entorno no está configurada, el valor predeterminado es
shell.

-r rechazar archivo or --reject-file =rechazar archivo
Pon los rechazos en rechazar archivo en lugar del predeterminado .rej expediente. Cuando rechazar archivo is -,
descartar los rechazos.

-R or --contrarrestar
Suponga que este parche se creó con los archivos nuevos y antiguos intercambiados. (Sí, yo soy
temo que eso suceda ocasionalmente, siendo la naturaleza humana lo que es). parche Los intentos
para intercambiar cada trozo antes de aplicarlo. Los rechazos salen en formato intercambiado.
La -R la opción no funciona con ed diff porque hay muy poco
información para reconstruir la operación inversa.

Si falla el primer trozo de un parche, parche invierte el trozo para ver si se puede aplicar
de esa manera. Si puede, se le preguntará si desea tener el -R conjunto de opciones. Si se
no puede, el parche se sigue aplicando normalmente. (Nota: este método no puede detectar
parche invertido si es una diferencia normal y si el primer comando es un anexo (es decir,
debería haber sido una eliminación) ya que los anexos siempre tienen éxito, debido al hecho de que un nulo
el contexto coincide en cualquier lugar. Afortunadamente, la mayoría de los parches agregan o cambian líneas en lugar de eliminar
ellos, por lo que la mayoría de las diferencias normales invertidas comienzan con una eliminación, que falla, lo que activa la
heurístico.)

--read-only =comportamiento
Comportarse según lo solicitado al intentar modificar un archivo de solo lectura: pasar por alto el potencial
problema, advertir sobre esto (el predeterminado), o fallar.

--reject-format =formato
Producir archivos de rechazo en el formato (ya sea contexto or unificado). Sin esto
opción, los trozos rechazados aparecen en formato de diferencia unificado si el parche de entrada era de ese
formato, de lo contrario en formato de diferencia de contexto ordinario.

-s or --silencio or --tranquilo
Trabaje en silencio, a menos que ocurra un error.

--seguir-enlaces simbólicos
Cuando busque archivos de entrada, siga los enlaces simbólicos. Reemplaza los enlaces simbólicos,
en lugar de modificar los archivos a los que apuntan los enlaces simbólicos. Parches de estilo Git para
Ya no se aplicarán los enlaces simbólicos. Esta opción existe para compatibilidad con versiones anteriores.
con versiones anteriores del parche; se desaconseja su uso.

-t or --lote
Suprime preguntas como -f, pero haga algunas suposiciones diferentes: omita los parches cuyo
los encabezados no contienen nombres de archivo (lo mismo que -f); omitir parches para los que el archivo tiene
la versión incorrecta para el Prerrequisito: línea en el parche; y asumir que los parches son
invertidos si se ven como lo son.

-T or --fijar tiempo
Establezca los tiempos de modificación y acceso de los archivos parcheados a partir de las marcas de tiempo dadas en
encabezados de diferencias de contexto. A menos que se especifique en las marcas de tiempo, suponga que el contexto
Los encabezados diff usan la hora local.

No se recomienda el uso de esta opción con marcas de tiempo que no incluyen zonas horarias,
debido a que los parches que utilizan la hora local no pueden ser utilizados fácilmente por personas en otras zonas horarias,
y porque las marcas de tiempo locales son ambiguas cuando los relojes locales se mueven hacia atrás durante
ajustes de horario de verano. Asegúrese de que las marcas de tiempo incluyan zonas horarias o
generar parches con UTC y usar el -Z or --set-utc opción en lugar.

-u or --unificado
Interprete el archivo de parche como una diferencia de contexto unificada.

-v or --versión
Imprimir parcheencabezado de revisión y nivel de parche, y salida.

-V Método or --version-control =Método
Use Método para determinar los nombres de los archivos de respaldo. El método también puede ser dado por el
PATCH_VERSION_CONTROL (o, si no está configurado, el CONTROL DE VERSIONES) medio ambiente
variable, que está anulada por esta opción. El método no afecta si
se hacen los archivos de respaldo; solo afecta a los nombres de los archivos de respaldo que se crean.

El valor de Método es como la variable GNU Emacs 'version-control'; parche tambien
reconoce sinónimos que son más descriptivos. Los valores válidos para Método son únicos
se aceptan abreviaturas):

existente or cero
Realice copias de seguridad numeradas de los archivos que ya las tengan, de lo contrario, copias de seguridad simples.
Este es el predeterminado.

numerado or t
Realice copias de seguridad numeradas. El nombre del archivo de respaldo numerado para F is F.~N~ donde N son los
número de versión.

simples or nunca
Realice copias de seguridad sencillas. los -B or --prefijo, -Y or --basename-prefijo y -z or
--sufijo Las opciones especifican el nombre del archivo de copia de seguridad simple. Si ninguna de estas opciones es
dado, se utiliza un sufijo de copia de seguridad simple; es el valor de la
SIMPLE_BACKUP_SUFIJO variable de entorno si se establece, y es .orig de otra manera.

Con copias de seguridad numeradas o simples, si el nombre del archivo de copia de seguridad es demasiado largo, el sufijo de la copia de seguridad
~ se usa en su lugar; si incluso agregando ~ haría el nombre demasiado largo, entonces ~ reemplaza
el último carácter del nombre del archivo.

--verboso
Genere información adicional sobre el trabajo que se está realizando.

-x número or --debug =número
Establezca indicadores de depuración internos de interés solo para parche parcheadores.

-Y preferencia or --basename-prefix =preferencia
Ingrese al simples método para determinar los nombres de los archivos de respaldo (consulte el -V Método or
--control de versiones Método opción) y prefijo preferencia al nombre base de un nombre de archivo cuando
generando su nombre de archivo de respaldo. Por ejemplo, con -Y .del / el archivo de respaldo simple
nombre para src / parche / util.c is src / parche / .del / util.c.

-z sufijo or --sufijo =sufijo
Ingrese al simples método para determinar los nombres de los archivos de respaldo (consulte el -V Método or
--control de versiones Método opción), y use sufijo como sufijo. Por ejemplo, con -z -
el nombre del archivo de respaldo para src / parche / util.c is src / patch / util.c-.

-Z or --set-utc
Establezca los tiempos de modificación y acceso de los archivos parcheados a partir de las marcas de tiempo dadas en
encabezados de diferencias de contexto. A menos que se especifique en las marcas de tiempo, suponga que el contexto difiere
los encabezados utilizan la hora universal coordinada (UTC, a menudo conocida como GMT). También vea el -T or
--fijar tiempo .

La -Z or --set-utc y -T or --fijar tiempo opciones normalmente se abstienen de configurar un archivo
time si la hora original del archivo no coincide con la hora indicada en el encabezado del parche, o
si su contenido no coincide exactamente con el parche. Sin embargo, si el -f or --fuerza opción
se da, el tiempo de archivo se establece independientemente.

Debido a las limitaciones de diff formato de salida, estas opciones no pueden actualizar los tiempos de
archivos cuyo contenido no ha cambiado. Además, si usa estas opciones, debe
eliminar (por ejemplo, con “piensen de nuevo sobre los incrementos de precio” limpia) todos los archivos que dependen de los archivos parcheados, para que luego
invocaciones de “piensen de nuevo sobre los incrementos de precio” no se confunda con los tiempos de los archivos parcheados.

MEDIO AMBIENTE

PATCH_GET
Esto especifica si parche obtiene archivos faltantes o de solo lectura de RCS, ClearCase,
Perforce o SCCS por defecto; ver el -g or --obtener .

POSIXLY_CORRECT
Si está configurado, parche se ajusta más estrictamente al estándar POSIX por defecto: consulte el --posix
.

ESTILO_COTIZACIÓN
Valor predeterminado del - estilo de comillas .

SIMPLE_BACKUP_SUFIJO
Extensión para usar para nombres de archivos de respaldo simples en lugar de .orig.

TMPDIR, TMP, TEMP
Directorio para colocar archivos temporales; parche usa la primera variable de entorno en este
lista que se establece. Si no se establece ninguno, el valor predeterminado depende del sistema; es normalmente
/ Tmp en hosts Unix.

CONTROL DE VERSIONES or PATCH_VERSION_CONTROL
Selecciona el estilo de control de versiones; ver el -v or --control de versiones .

Use el parche en línea usando los servicios de onworks.net