git-send-email - Online na nuvem

PROGRAMA:

NOME

git-send-email - Envie uma coleção de patches como e-mails

SINOPSE

git enviar email [opções] ...
git enviar email --dump-aliases

DESCRIÇÃO

Pega os patches fornecidos na linha de comando e os envia por e-mail. Patches podem ser especificados
como arquivos, diretórios (que enviarão todos os arquivos do diretório) ou diretamente como um
lista de revisão. No último caso, qualquer formato aceito por patch de formato git(1) pode ser passado
para fazer o git send-email.

O cabeçalho do e-mail é configurável por meio de opções de linha de comando. Se não for especificado no
linha de comando, o usuário receberá uma interface habilitada para ReadLine para fornecer o
informação necessária.

Existem dois formatos aceitos para arquivos de patch:

1. arquivos de formato mbox

Isso é o que patch de formato git(1) gera. A maioria dos cabeçalhos e formatação MIME são
ignorado.

2. O formato original usado por Greg Kroah-Hartman's send_lots_of_email.pl escrita

Este formato espera que a primeira linha do arquivo contenha o valor "Cc:" e o
"Assunto:" da mensagem como segunda linha.

OPÇÕES

Composição
--anotar
Revise e edite cada patch que você está prestes a enviar. O padrão é o valor de
enviaremail.anotar. Veja a seção CONFIGURAÇÃO para sendemail.multi.

--bcc = , ...
Especifique um valor "Cco:" para cada e-mail. O padrão é o valor de enviar e-mail.bcc.

Esta opção pode ser especificada várias vezes.

--cc = , ...
Especifique um valor inicial "Cc:" para cada e-mail. O padrão é o valor de enviaremail.cc.

Esta opção pode ser especificada várias vezes.

--compor
Invoque um editor de texto (veja GIT_EDITOR em git-var(1)) para editar uma mensagem introdutória
para a série de patch.

Quando --compor for usado, git send-email usará De, Assunto e Em-Responder-Para
cabeçalhos especificados na mensagem. Se o corpo da mensagem (o que você digita depois do
cabeçalhos e uma linha em branco) contém apenas linhas em branco (ou Git: prefixadas), o resumo
não será enviado, mas os cabeçalhos De, Assunto e Em-Responder-Para serão usados, a menos que sejam
removido.

Os cabeçalhos de falta ou Em resposta a serão solicitados.

Veja a seção CONFIGURAÇÃO para sendemail.multi.

--de =
Especifique o remetente dos emails. Se não for especificado na linha de comando, o valor de
que o enviar e-mail.de opção de configuração é usada. Se nenhuma das opções de linha de comando
nem enviar e-mail.de estiverem configurados, o valor será solicitado ao usuário. O padrão
para o prompt será o valor de GIT_AUTHOR_IDENT, ou GIT_COMMITTER_IDENT se aquele
não está definido, conforme retornado por "git var -l".

--in-reply-to =
Faça o primeiro e-mail (ou todos os e-mails com --no-thread) aparecer como uma resposta ao dado
Message-Id, que evita a quebra de threads para fornecer uma nova série de patch. O segundo
e os e-mails subsequentes serão enviados como respostas de acordo com o - [no] -chain-responder-para
criação.

Por exemplo, quando --thread e --no-chain-reply-to são especificados, o segundo e
patches subsequentes serão respostas ao primeiro como na ilustração abaixo
onde [PATCH v2 0/3] é uma resposta a [PATCH 0/2]:

[PATCH 0/2] Aqui está o que eu fiz ...
[PATCH 1/2] Limpeza e testes
[PATCH 2/2] Implementação
[PATCH v2 0/3] Aqui está uma nova rolagem
[PATCH v2 1/3] Limpar
[PATCH v2 2/3] Novos testes
[PATCH v2 3/3] Implementação

Somente necessário se --compose também estiver definido. Se --compose não estiver definido, será
solicitado.

--subject =
Especifique o assunto inicial do tópico do email. Somente necessário se --compose também for
definir. Se --compose não estiver definido, isso será solicitado.

--to = , ...
Especifique o destinatário principal dos emails gerados. Geralmente, este será o
mantenedor superior do projeto envolvido. O padrão é o valor do enviar um email a
valor de configuração; se não for especificado e --to-cmd não for especificado,
ser solicitado.

Esta opção pode ser especificada várias vezes.

- codificação de 8 bits =
Ao encontrar uma mensagem não ASCII ou assunto que não declara sua codificação,
adicione cabeçalhos / aspas para indicar que está codificado em . O padrão é o valor de
que o sendemail.assume8bitEncoding; se não for especificado, será solicitado se
quaisquer arquivos não-ASCII são encontrados.

Observe que nenhuma tentativa é feita para validar a codificação.

--compose-encoding =
Especifique a codificação da mensagem escrita. O padrão é o valor do
sendemail.composeencoding; se não for especificado, UTF-8 será assumido.

--transfer-encoding = (7bit | 8bit | quoted-printable | base64)
Especifique a codificação de transferência a ser usada para enviar a mensagem por SMTP. 7 bits irá falhar
ao encontrar uma mensagem não ASCII. quoted-printable pode ser útil quando o
repositório contém arquivos que contêm retornos de carro, mas torna o e-mail de patch bruto
(conforme salvo de um MUA) muito mais difícil de inspecionar manualmente. base64 é ainda mais idiota
prova, mas também ainda mais opaca. O padrão é o valor do
sendemail.transferEncoding valor de configuração; se não for especificado, o git usará
8 bits e não adicionar um cabeçalho Content-Transfer-Encoding.

--xmailer, --no-xmailer
Adicione (ou evite adicionar) o cabeçalho "X-Mailer:" Por padrão, o cabeçalho é adicionado, mas
ele pode ser desligado definindo a variável de configuração sendemail.xmailer como false.

transmissão
--envelope-sender =
Especifique o remetente do envelope usado para enviar os e-mails. Isso é útil se o seu padrão
endereço não é o endereço inscrito em uma lista. Para usar o De
endereço, defina o valor para "auto". Se você usar o binário sendmail, você deve ter
privilégios adequados para o parâmetro -f. O padrão é o valor do
sendemail.envelopeSender variável de configuração; se isso não for especificado, escolhendo o
o remetente do envelope é deixado para o seu MTA.

--smtp-encryption =
Especifique a criptografia a ser usada, ssl or tls. Qualquer outro valor reverte para normal
SMTP. O padrão é o valor de sendemail.smtpCriptografia.

--smtp-domain =
Especifica o nome de domínio totalmente qualificado (FQDN) usado no comando HELO / EHLO para o
Servidor SMTP. Alguns servidores exigem que o FQDN corresponda ao seu endereço IP. Se não for definido, git
Send-email tenta determinar seu FQDN automaticamente. O padrão é o valor de
sendemail.smtpDomain.

--smtp-auth =
Lista separada por espaços em branco de mecanismos SMTP-AUTH permitidos. Esta configuração força o uso de
apenas os mecanismos listados. Exemplo:

$ git send-email --smtp-auth = "PLAIN LOGIN GSSAPI" ...

Se pelo menos um dos mecanismos especificados corresponder aos anunciados pelo SMTP
servidor e se for suportado pela biblioteca SASL utilizada, o mecanismo é usado para
autenticação. Se nenhum sendemail.smtpAuth nem --smtp-auth é especificado, tudo
mecanismos suportados pela biblioteca SASL podem ser usados.

--smtp-pass [= ]
Senha para SMTP-AUTH. O argumento é opcional: Se nenhum argumento for especificado, então
a string vazia é usada como senha. O padrão é o valor de sendemail.smtpPass,
contudo --smtp-pass sempre substitui esse valor.

Além disso, as senhas não precisam ser especificadas nos arquivos de configuração ou no comando
linha. Se um nome de usuário foi especificado (com --smtp-usuário ou um sendemail.smtpUser), Mas
nenhuma senha foi especificada (com --smtp-pass or sendemail.smtpPass), então uma
a senha é obtida usando credencial git.

--smtp-server =
Se definido, especifica o servidor SMTP de saída a ser usado (por exemplo, smtp.example.com ou um IP bruto
Morada). Alternativamente, pode especificar um nome de caminho completo de um programa semelhante ao sendmail
em vez de; o programa deve suportar a opção -i. O valor padrão pode ser especificado pelo
sendemail.smtpServer opção de configuração; o padrão embutido é / usr / sbin / sendmail
or / usr / lib / sendmail se tal programa estiver disponível, ou localhost caso contrário.

--smtp-server-port =
Especifica uma porta diferente da porta padrão (servidores SMTP geralmente ouvem
smtp porta 25, mas também pode ouvir a porta de envio 587 ou a porta SSL smtp comum
465); nomes de porta simbólicos (por exemplo, "envio" em vez de 587) também são aceitos. o
a porta também pode ser definida com o sendemail.smtpServerPort configuração variável.

--smtp-server-option =
Se definido, especifica a opção de servidor SMTP de saída a ser usada. O valor padrão pode ser
especificado pelo sendemail.smtpServerOption opção de configuração.

A opção --smtp-server-option deve ser repetida para cada opção que você deseja passar
o servidor. Da mesma forma, diferentes linhas nos arquivos de configuração devem ser usadas para cada
opção.

--smtp-ssl
Alias ​​legado para --smtp-criptografia ssl.

--smtp-ssl-cert-path
Caminho para um armazenamento de certificados CA confiáveis ​​para validação de certificado SSL / TLS SMTP
(um diretório que foi processado por c_rehash, ou um único arquivo contendo
um ou mais certificados de formato PEM concatenados juntos: consulte verificar(1) -CAfile e
-CApath para obter mais informações sobre estes). Defina-o como uma string vazia para desabilitar
verificação de certificado. O padrão é o valor de sendemail.smtpsslcertpath
variável de configuração, se definida, ou o padrão compilado da biblioteca SSL de apoio
caso contrário (que deve ser a melhor escolha na maioria das plataformas).

--smtp-user =
Nome de usuário para SMTP-AUTH. O padrão é o valor de sendemail.smtpUser; se um nome de usuário é
não especificado (com --smtp-usuário or sendemail.smtpUser), então a autenticação não é
tentada.

--smtp-debug = 0 | 1
Ative (1) ou desative (0) a saída de depuração. Se ativado, os comandos e respostas SMTP serão
impresso. Útil para depurar problemas de conexão e autenticação TLS.

Automatizando
--to-cmd =
Especifique um comando para executar uma vez por arquivo de patch que deve gerar o arquivo de patch
entradas específicas "Para:". A saída deste comando deve ser um único endereço de e-mail por linha.
O padrão é o valor de enviaremail.tocmd valor de configuração.

--cc-cmd =
Especifique um comando para executar uma vez por arquivo de patch que deve gerar o arquivo de patch
entradas "Cc:" específicas. A saída deste comando deve ser um único endereço de e-mail por linha.
O padrão é o valor de enviaremail.ccCmd valor de configuração.

- [sem-] responder em cadeia
Se isso for definido, cada e-mail será enviado como uma resposta ao e-mail anterior enviado. Se
desativado com "--no-chain-reply-to", todos os e-mails após o primeiro serão enviados como
respostas ao primeiro e-mail enviado. Ao usar isso, é recomendado que o primeiro
arquivo fornecido seja uma visão geral de toda a série de patches. Desativado por padrão, mas o
sendemail.chainReplyTo a variável de configuração pode ser usada para habilitá-lo.

--identity =
Uma identidade de configuração. Quando fornecido, causa valores no enviar email.
subseção para ter precedência sobre os valores no enviar email seção. O padrão
identidade é o valor de enviaremail.identity.

- [sem-] assinado por cc
Se estiver definido, adicione e-mails encontrados nas linhas Signed-off-by: ou Cc: à lista de cc.
O padrão é o valor de enviaremail.signedoffbycc valor de configuração; se isso é
não especificado, padrão para --signed-off-by-cc.

- [sem-] capa cc
Se estiver definido, os e-mails encontrados em Cc: cabeçalhos no primeiro patch da série
(normalmente a carta de apresentação) são adicionados à lista de cc para cada conjunto de e-mail. O padrão é
o valor de sendemail.cccover valor de configuração; se não for especificado, o padrão é
--cobertura sem cc.

- [não-] para cobrir
Se estiver definido, os e-mails encontrados nos cabeçalhos Para: no primeiro patch da série
(normalmente a carta de apresentação) são adicionados à lista para para cada conjunto de e-mail. O padrão é
o valor de enviar e-mail.tocover valor de configuração; se não for especificado, o padrão é
- não para cobrir.

--suppress-cc =
Especifique uma categoria adicional de destinatários para suprimir o auto-cc de:

· autor irá evitar a inclusão do autor do patch

· eu evitará incluir o remetente

· cc evitará a inclusão de qualquer pessoa mencionada nas linhas Cc no cabeçalho do patch, exceto
para si mesmo (use eu por isso).

· corpocc irá evitar a inclusão de qualquer pessoa mencionada nas linhas Cc no corpo do patch (commit
mensagem), exceto para si mesmo (usar eu por isso).

· soluço evitará incluir qualquer pessoa mencionada nas linhas de assinados, exceto para si mesmo
(usar eu por isso).

· cccmd irá evitar a execução do --cc-cmd.

· corpo é equivalente a soluço + corpocc

· todos os irá suprimir todos os valores auto cc.

O padrão é o valor de enviar e-mail.suppresscc valor de configuração; se isso é
não especificado, padrão para eu se --suppress-from for especificado, bem como corpo if
--no-signed-off-cc é especificado.

- [não-] suprimir de
Se estiver definido, não adicione o endereço De: à lista cc :. O padrão é o valor de
enviar e-mail.suppressFrom valor de configuração; se não for especificado, o padrão é
--no-supress-from.

- [sem-] tópico
Se estiver definido, os cabeçalhos In-Reply-To e References serão adicionados a cada e-mail
enviei. Se cada e-mail se refere ao e-mail anterior (deep threading por git
patch de formato texto) ou para o primeiro e-mail (discussão superficial) é regido por
"- [sem-] resposta em cadeia".

Se desativado com "--no-thread", esses cabeçalhos não serão adicionados (a menos que especificado com
--em resposta a). O padrão é o valor do enviaremail.thread valor de configuração; E se
que não é especificado, o padrão é --thread.

Cabe ao usuário garantir que nenhum cabeçalho In-Reply-To exista quando git
enviar email é solicitado a adicioná-lo (observe especialmente que git patch de formato pode ser configurado
para fazer o threading propriamente dito). Não fazer isso pode não produzir o resultado esperado em
o MUA do destinatário.

Administrando
--confirm =
Confirme antes de enviar:

· sempre sempre confirmará antes de enviar

· nunca nunca irá confirmar antes de enviar

· cc irá confirmar antes de enviar quando enviar-e-mail tiver adicionado endereços automaticamente
do patch para a lista Cc

· compor irá confirmar antes de enviar a primeira mensagem ao usar --compose.

· auto é equivalente a cc + compor

O padrão é o valor de enviar e-mail. confirme valor de configuração; se isso não for especificado,
padrão para auto a menos que qualquer uma das opções de supressão tenha sido especificada, caso em que
padrão para compor.

--funcionamento a seco
Faça tudo, exceto enviar os e-mails.

- [sem-] patch de formato
Quando um argumento pode ser entendido como uma referência ou como um nome de arquivo, escolha
entendê-lo como um argumento de patch de formato (--formato-patch) ou como um nome de arquivo
(--sem-formato-patch) Por padrão, quando tal conflito ocorre, git send-email irá
falhou.

--quieto
Tornar git-send-email menos prolixo. Uma linha por e-mail deve ser a única saída.

- [não-] validar
Execute verificações de integridade nos patches. Atualmente, a validação significa o seguinte:

· Avisar sobre patches que contêm linhas com mais de 998 caracteres; isso é devido ao SMTP
limites conforme descrito por http://www.ietf.org/rfc/rfc2821.txt.

O padrão é o valor de enviaremail.validate; se não estiver definido, o padrão é --validar.

--força
Envie e-mails mesmo que as verificações de segurança o impeçam.

Dados Pessoais
--dump-aliases
Em vez da operação normal, despeje os nomes de alias abreviados do configurado
arquivo (s) de alias, um por linha em ordem alfabética. Observe, isso inclui apenas o alias
nome e não seus endereços de e-mail expandidos. Ver arquivo sendemail.aliases para mais
informações sobre apelidos.

CONFIGURAÇÃO

sendemail.aliasesFile
Para evitar digitar endereços de e-mail longos, aponte para um ou mais arquivos de aliases de e-mail.
Você também deve fornecer sendemail.aliasFileType.

sendemail.aliasFileType
Formato do (s) arquivo (s) especificado (s) em sendemail.aliasesFile. Deve ser um dos vira-lata, mailrc,
pinheiro, olmoou desgostoou enviar correio.

A aparência de um arquivo de alias em cada formato pode ser encontrada na documentação do
programa de e-mail com o mesmo nome. As diferenças e limitações do padrão
formatos são descritos abaixo:

enviar correio

· Aliases citados e endereços citados não são suportados: linhas que contêm um "
símbolo são ignorados.

· O redirecionamento para um arquivo (/ caminho / nome) ou canal (| comando) não é suportado.

· Inclusão de arquivo (: incluir: / caminho / nome) não é suportada.

· Os avisos são impressos na saída de erro padrão para qualquer explicitamente
construções não suportadas e quaisquer outras linhas que não sejam reconhecidas pelo
analisador.

sendemail.multi
Se verdadeiro (padrão), uma única instância do editor será gerada para editar os arquivos que você precisa
editar (patches quando --anotar é usado, e o resumo quando --compor é usado). Se
false, os arquivos serão editados um após o outro, gerando um novo editor a cada vez.

enviar e-mail. confirme
Define o padrão para confirmar antes de enviar. Deve ser um dos sempre, nunca,
cc, comporou auto. Ver --confirme na seção anterior para o significado desses
valores.

EXEMPLO

Use gmail as que o smtp servidor
Para utilizar o git enviar email para enviar seus patches através do servidor SMTP do GMail, edite
~ / .gitconfig para especificar as configurações da sua conta:

[enviar email]
smtpEncryption = tls
servidor smtp = smtp.gmail.com
usuário smtp = [email protegido]
SMTPServerPort = 587

Assim que seus commits estiverem prontos para serem enviados para a lista de e-mails, execute os seguintes comandos:

$ git format-patch --cover-letter -M origin / master -o outgoing /
$ editar saída / 0000- *
$ git send-email outgoing / *

Nota: os seguintes módulos perl são necessários Net :: SMTP :: SSL, MIME :: Base64 e
Authen :: SASL

Use git-send-email online usando serviços onworks.net