git-send-email: en línea en la nube

PROGRAMA:

NOMBRE

git-send-email: envíe una colección de parches como correos electrónicos

SINOPSIS

git enviar correo electrónico [opciones] ...
git enviar correo electrónico --dump-alias

DESCRIPCIÓN

Toma los parches proporcionados en la línea de comando y los envía por correo electrónico. Se pueden especificar parches
como archivos, directorios (que enviarán todos los archivos en el directorio), o directamente como un
lista de revisión. En este último caso, cualquier formato aceptado por parche de formato git(1) se puede pasar
para git send-email.

El encabezado del correo electrónico se puede configurar a través de las opciones de la línea de comandos. Si no se especifica en el
línea de comandos, se le pedirá al usuario una interfaz habilitada para ReadLine para proporcionar la
Información necesaria.

Hay dos formatos aceptados para archivos de parche:

1. archivos en formato mbox

Esto es lo que parche de formato git(1) genera. La mayoría de los encabezados y el formato MIME son
ignorado

2. El formato original utilizado por Greg Kroah-Hartman enviar_lotes_de_correo electrónico.pl guión

Este formato espera que la primera línea del archivo contenga el valor "Cc:" y el
"Asunto:" del mensaje como segunda línea.

CAMPUS

Composición
--anotar
Revise y edite cada parche que está a punto de enviar. Por defecto es el valor de
enviarcorreo.anotar. Consulte la sección CONFIGURACIÓN para enviaremail.multiEditar.

--bcc = ...
Especifique un valor "Cco:" para cada correo electrónico. Por defecto es el valor de enviarcorreo.bcc.

Esta opción se puede especificar varias veces.

--cc = ...
Especifique un valor "Cc:" inicial para cada correo electrónico. Por defecto es el valor de enviaremail.cc.

Esta opción se puede especificar varias veces.

--componer
Invocar un editor de texto (ver GIT_EDITOR en git-var(1)) para editar un mensaje introductorio
para la serie de parches.

Cuándo --componer se usa, git send-email usará De, Asunto e In-Reply-To
encabezados especificados en el mensaje. Si el cuerpo del mensaje (lo que escribe después del
encabezados y una línea en blanco) solo contiene líneas en blanco (o Git: prefijo), el resumen
no se enviarán, pero se usarán los encabezados De, Asunto y En respuesta a, a menos que estén
eliminado.

Se solicitarán los encabezados que faltan de o en respuesta a.

Consulte la sección CONFIGURACIÓN para enviaremail.multiEditar.

--desde =
Especifique el remitente de los correos electrónicos. Si no se especifica en la línea de comando, el valor de
las sendemail. de se utiliza la opción de configuración. Si ni la opción de la línea de comandos
ni sendemail. de están configurados, se le pedirá al usuario el valor. El valor por defecto
para el mensaje será el valor de GIT_AUTHOR_IDENT, o GIT_COMMITTER_IDENT si ese
no está establecido, como lo devuelve "git var -l".

--in-reply-to =
Hacer que el primer correo (o todos los correos con --no-thread) aparezcan como respuesta al
Message-Id, que evita romper hilos para proporcionar una nueva serie de parches. El segundo
y los correos electrónicos subsiguientes se enviarán como respuestas de acuerdo con - [no] -chain-reply-to
ajuste.

Entonces, por ejemplo, cuando se especifican --thread y --no-chain-reply-to, el segundo y
los parches posteriores serán respuestas al primero como en la siguiente ilustración
donde [PATCH v2 0/3] es en respuesta a [PATCH 0/2]:

[PARCHE 0/2] Esto es lo que hice ...
[PATCH 1/2] Limpieza y pruebas
[PATCH 2/2] Implementación
[PATCH v2 0/3] Aquí hay una repetición
[PATCH v2 1/3] Limpiar
[PATCH v2 2/3] Nuevas pruebas
[PATCH v2 3/3] Implementación

Solo es necesario si también se establece --compose. Si no se establece --compose, esto será
solicitado.

--subject =
Especifique el asunto inicial del hilo de correo electrónico. Solo es necesario si --compose también
colocar. Si no se establece --compose, se le solicitará.

--to = ...
Especifique el destinatario principal de los correos electrónicos generados. Generalmente, esta será la
mantenedor upstream del proyecto involucrado. Por defecto es el valor de la Enviar el email a
valor de configuración; si no se especifica y no se especifica --to-cmd, esto
se le solicite.

Esta opción se puede especificar varias veces.

- codificación de 8 bits =
Al encontrar un mensaje o asunto no ASCII que no declara su codificación,
agregue encabezados / citas para indicar que está codificado en . Por defecto es el valor de
las sendemail.assume8bitCodificación; si no está especificado, se le pedirá si
se encuentran archivos no ASCII.

Tenga en cuenta que no se hace ningún intento de validar la codificación.

--compose-encoding =
Especifique la codificación del mensaje de redacción. Por defecto es el valor de la
enviaremail.composeencoding; si no se especifica, se asume UTF-8.

--transfer-encoding = (7 bits | 8 bits | imprimible entre comillas | base64)
Especifique la codificación de transferencia que se utilizará para enviar el mensaje a través de SMTP. 7bit fallará
al encontrar un mensaje no ASCII. quoted-printable puede ser útil cuando el
El repositorio contiene archivos que contienen retornos de carro, pero hace que el correo electrónico del parche sin formato
archivo (guardado desde un MUA) mucho más difícil de inspeccionar manualmente. base64 es aún más tonto
prueba, pero también aún más opaco. Por defecto es el valor de la
enviaremail.transferEncoding valor de configuración; si eso no está especificado, git usará
8 bits y no agregue un encabezado de codificación de transferencia de contenido.

--xmailer, --no-xmailer
Agregue (o evite agregar) el encabezado "X-Mailer:". De forma predeterminada, se agrega el encabezado, pero
se puede desactivar estableciendo la variable de configuración sendemail.xmailer en falso.

Enviando
--envelope-sender =
Especifique el remitente del sobre utilizado para enviar los correos electrónicos. Esto es útil si su
dirección no es la dirección que está suscrita a una lista. Para utilizar el Desde
dirección, establezca el valor en "auto". Si usa el binario sendmail, debe tener
privilegios adecuados para el parámetro -f. Por defecto es el valor de la
enviaremail.envelopeSender variable de configuración; si no está especificado, eligiendo el
El remitente del sobre se deja a su MTA.

--smtp-encryption =
Especifique el cifrado que se utilizará, ya sea ssl or tls. Cualquier otro valor vuelve a ser simple
SMTP. Por defecto es el valor de sendemail.smtpCifrado.

--smtp-domain =
Especifica el nombre de dominio completo (FQDN) utilizado en el comando HELO / EHLO para el
Servidor SMTP. Algunos servidores requieren que el FQDN coincida con su dirección IP. Si no está configurado, git
send-email intenta determinar su FQDN automáticamente. Por defecto es el valor de
enviaremail.smtpDomain.

--smtp-auth =
Lista separada por espacios en blanco de mecanismos SMTP-AUTH permitidos. Esta configuración obliga a utilizar
sólo los mecanismos enumerados. Ejemplo:

$ git send-email --smtp-auth = "INICIO DE SESIÓN PLAIN GSSAPI" ...

Si al menos uno de los mecanismos especificados coincide con los anunciados por el SMTP
servidor y si es compatible con la biblioteca SASL utilizada, el mecanismo se utiliza para
autenticación. Si ninguno enviaremail.smtpAuth ni --smtp-autorización se especifica, todo
Se pueden utilizar los mecanismos admitidos por la biblioteca SASL.

--smtp-pass [= ]
Contraseña para SMTP-AUTH. El argumento es opcional: si no se especifica ningún argumento, entonces
la cadena vacía se utiliza como contraseña. Por defecto es el valor de enviaremail.smtpPass,
sin embargo --smtp-pass siempre anula este valor.

Además, no es necesario especificar las contraseñas en los archivos de configuración o en el comando
línea. Si se ha especificado un nombre de usuario (con --smtp-usuario o un enviaremail.smtpUser), Pero
no se ha especificado ninguna contraseña (con --smtp-pass or enviaremail.smtpPass), Entonces un
la contraseña se obtiene usando git-credencial.

--smtp-server =
Si se establece, especifica el servidor SMTP saliente que se utilizará (p. Ej., Smtp.example.com o una IP sin procesar
Dirección). Alternativamente, puede especificar un nombre de ruta completo de un programa similar a sendmail
en lugar de; el programa debe admitir la opción -i. El valor predeterminado puede ser especificado por el
enviaremail.smtpServer opción de configuración; el valor predeterminado incorporado es / usr / sbin / sendmail
or / usr / lib / sendmail si dicho programa está disponible, o localhost de lo contrario.

--smtp-servidor-puerto =
Especifica un puerto diferente del puerto predeterminado (los servidores SMTP generalmente escuchan
smtp puerto 25, pero también puede escuchar el puerto de envío 587, o el puerto común SSL smtp
465); También se aceptan nombres de puertos simbólicos (por ejemplo, "envío" en lugar de 587). los
El puerto también se puede configurar con el sendemail.smtpServerPort variable de configuración.

--smtp-server-option =
Si se establece, especifica la opción de servidor SMTP saliente que se utilizará. El valor predeterminado puede ser
especificado por el sendemail.smtpServerOption opción de configuración.

La opción --smtp-server-option debe repetirse para cada opción a la que desee pasar
el servidor. Asimismo, se deben utilizar diferentes líneas en los archivos de configuración para cada
.

--smtp-ssl
Alias ​​heredado para - cifrado smtp ssl.

--smtp-ssl-cert-ruta
Ruta a un almacén de certificados CA de confianza para la validación de certificados SMTP SSL / TLS
(ya sea un directorio que ha sido procesado por c_rehash, o un solo archivo que contenga
uno o más certificados de formato PEM concatenados juntos: consulte verificar(1) -CAfile y
-CApath para obtener más información sobre estos). Configúrelo en una cadena vacía para deshabilitar
verificación del certificado. Por defecto, el valor de la sendemail.smtpsslcertpath
variable de configuración, si se establece, o el valor predeterminado compilado de la biblioteca SSL de respaldo
de lo contrario (que debería ser la mejor opción en la mayoría de las plataformas).

--smtp-user =
Nombre de usuario para SMTP-AUTH. Por defecto es el valor de enviaremail.smtpUser; si un nombre de usuario es
no especificado (con --smtp-usuario or enviaremail.smtpUser), la autenticación no es
intentó.

--smtp-debug = 0 | 1
Habilite (1) o deshabilite (0) la salida de depuración. Si está habilitado, los comandos SMTP y las respuestas serán
impreso. Útil para depurar problemas de autenticación y conexión TLS.

Automatización
--to-cmd =
Especifique un comando para ejecutar una vez por archivo de parche que debería generar un archivo de parche
entradas específicas "Para:". La salida de este comando debe ser una única dirección de correo electrónico por línea.
Por defecto es el valor de enviaremail.tocmd valor de configuración.

--cc-cmd =
Especifique un comando para ejecutar una vez por archivo de parche que debería generar un archivo de parche
entradas específicas "Cc:". La salida de este comando debe ser una única dirección de correo electrónico por línea.
Por defecto es el valor de enviaremail.ccCmd valor de configuración.

- [no-] responder en cadena
Si se configura, cada correo electrónico se enviará como respuesta al correo electrónico enviado anteriormente. Si
desactivado con "--no-chain-reply-to", todos los correos electrónicos posteriores al primero se enviarán como
responde al primer correo electrónico enviado. Al usar esto, se recomienda que la primera
El archivo proporcionado debe ser una descripción general de toda la serie de parches. Desactivado de forma predeterminada, pero el
enviaremail.chainReplyTo La variable de configuración se puede utilizar para habilitarlo.

--identidad =
Una identidad de configuración. Cuando se da, causa valores en el enviar correo electrónico.
subsección para tener prioridad sobre los valores en el enviar correo electrónico sección. El valor por defecto
la identidad es el valor de enviaremail.identidad.

- [no-] firmado por cc
Si está configurado, agregue los correos electrónicos que se encuentran en las líneas Firmado por: o Cc: a la lista de cc.
Por defecto es el valor de enviaremail.signedoffbycc valor de configuración; si eso es
sin especificar, predeterminado en --signed-off-by-cc.

- [no-] cc-cover
Si está configurado, los correos electrónicos que se encuentran en Cc: encabezados en el primer parche de la serie
(normalmente la carta de presentación) se agregan a la lista de cc para cada conjunto de correo electrónico. El valor predeterminado es
el valor de enviaremail.cccover valor de configuración; si no está especificado, por defecto
--no-cc-cubierta.

- [no-] para cubrir
Si está configurado, los correos electrónicos que se encuentran en Para: encabezados en el primer parche de la serie
(normalmente la carta de presentación) se agregan a la lista para para cada conjunto de correo electrónico. El valor predeterminado es
el valor de enviaremail.tocover valor de configuración; si no está especificado, por defecto
--no a taparse.

--suppress-cc =
Especifique una categoría adicional de destinatarios para suprimir el autocierre de:

· autor evitará incluir al autor del parche

· yo evitará incluir al remitente

· cc evitará incluir a cualquier persona mencionada en las líneas CC en el encabezado del parche, excepto
para uno mismo (usar yo para eso).

· cuerpocc evitará incluir a cualquier persona mencionada en las líneas Cc en el cuerpo del parche (confirmar
mensaje) excepto para uno mismo (uso yo para eso).

· sollozo Evitará incluir a cualquier persona mencionada en las líneas firmadas por, excepto a sí mismo.
(utilizar yo para eso).

· ccmd evitará ejecutar el --cc-cmd.

· cuerpo es equivalente a sollozo + cuerpocc

· todos suprimirá todos los valores de cc automático.

Por defecto es el valor de enviaremail.suppresscc valor de configuración; si eso es
sin especificar, predeterminado a yo si se especifica --suppress-from, así como cuerpo if
--no -igned-off-cc está especificado.

- [no-] suprimir-de
Si está configurado, no agregue la dirección De: a la lista cc :. Por defecto es el valor de
enviarcorreo.suprimirDesde valor de configuración; si no está especificado, por defecto
--no-suprimir-de.

- [no-] hilo
Si está configurado, los encabezados In-Reply-To y References se agregarán a cada correo electrónico
enviado. Si cada correo se refiere al correo electrónico anterior (subprocesos profundos por git
parche de formato redacción) o al primer correo electrónico (subprocesos superficiales) se rige por
"- [no-] responder en cadena a".

Si está deshabilitado con "--no-thread", esos encabezados no se agregarán (a menos que se especifique con
--en respuesta a). Por defecto es el valor de la enviarcorreo.hilo valor de configuración; si
que no está especificado, por defecto es --thread.

Depende del usuario asegurarse de que no exista ningún encabezado In-Reply-To cuando git
enviar correo electrónico se le pide que lo agregue (especialmente tenga en cuenta que git parche de formato se puede configurar
para hacer el enhebrado mismo). Si no lo hace, es posible que no produzca el resultado esperado en
MUA del destinatario.

Administrando
--confirm =
Confirme justo antes de enviar:

· hacerlo siempre confirmará antes de enviar

· nunca nunca confirmará antes de enviar

· cc confirmará antes de enviar cuando el correo electrónico haya agregado direcciones automáticamente
del parche a la lista Cc

· componer confirmará antes de enviar el primer mensaje cuando use --compose.

· auto es equivalente a cc + componer

Por defecto es el valor de enviarcorreo.confirmar valor de configuración; si eso no está especificado,
predeterminado a auto a menos que se haya especificado alguna de las opciones de supresión, en cuyo caso
predeterminado a componer.

- corrida en seco
Haga todo menos enviar los correos electrónicos.

- [no-] formato-parche
Cuando un argumento puede entenderse como una referencia o como un nombre de archivo, elija
entiéndalo como un argumento de parche de formato (- parche de formato) o como nombre de archivo
(--no-formato-parche). De forma predeterminada, cuando se produce un conflicto de este tipo, git send-email
fallar.

--tranquilo
Haga que git-send-email sea menos detallado. Una línea por correo electrónico debería ser todo lo que se genere.

- [no-] validar
Realice controles de cordura en los parches. Actualmente, validación significa lo siguiente:

· Advierte de parches que contienen líneas de más de 998 caracteres; esto se debe a SMTP
límites descritos por http://www.ietf.org/rfc/rfc2821.txt.

Por defecto es el valor de enviarcorreo.validar; si esto no está configurado, por defecto --validar.

--fuerza
Envíe correos electrónicos incluso si los controles de seguridad lo impiden.

Información
--dump-alias
En lugar de la operación normal, descargue los nombres de alias abreviados de la configuración
archivo (s) de alias, uno por línea en orden alfabético. Tenga en cuenta que esto solo incluye el alias
nombre y no sus direcciones de correo electrónico expandidas. Ver enviaremail.aliasesfile
información sobre alias.

CONFIGURACIÓN

sendemail.aliasesArchivo
Para evitar escribir direcciones de correo electrónico largas, apunte esto a uno o más archivos de alias de correo electrónico.
También debes suministrar enviaremail.aliasFileType.

enviaremail.aliasFileType
Formato de los archivos especificados en sendemail.aliasesFile. Debe ser uno de chucho, correo,
pino, olmoo ñuso sendmail.

El aspecto de un archivo de alias en cada formato se puede encontrar en la documentación del
programa de correo electrónico del mismo nombre. Las diferencias y limitaciones del estándar
Los formatos se describen a continuación:

sendmail

· Los alias y las direcciones entre comillas no son compatibles: líneas que contienen un "
los símbolos se ignoran.

· No se admite la redirección a un archivo (/ ruta / nombre) o canalización (| comando).

· No se admite la inclusión de archivos (: incluir: / ruta / nombre).

· Las advertencias se imprimen en la salida de error estándar para cualquier
construcciones no admitidas, y cualquier otra lnea que no sea reconocida por el
analizador.

enviaremail.multiEditar
Si es verdadero (predeterminado), se generará una única instancia de editor para editar los archivos que debe
editar (parches cuando --anotar se utiliza, y el resumen cuando --componer se utiliza). Si
falso, los archivos se editarán uno tras otro, generando un nuevo editor cada vez.

enviarcorreo.confirmar
Establece el valor predeterminado para confirmar antes de enviar. Debe ser uno de hacerlo, nunca,
cc, componero auto. Vea --confirmar en la sección anterior para conocer el significado de estos
valores.

EJEMPLO

Uso gmail as las smtp servidor
Para utilizar git enviar correo electrónico para enviar sus parches a través del servidor SMTP de GMail, edite
~ / .gitconfig para especificar la configuración de su cuenta:

[enviar correo electrónico]
smtpEncryption = tls
smtpServer = smtp.gmail.com
usuario smtp = [email protected]
PuertoServidorsmtp = 587

Una vez que sus confirmaciones estén listas para enviarse a la lista de correo, ejecute los siguientes comandos:

$ git format-patch --cover-letter -M origin / master -o outgoing /
$ editar saliente / 0000- *
$ git enviar-correo electrónico saliente / *

Nota: se requieren los siguientes módulos de Perl Net :: SMTP :: SSL, MIME :: Base64 y
Authen :: SASL

Use git-send-email en línea usando los servicios de onworks.net