git-send-email - Интернет в облаке

ПРОГРАММА:

ИМЯ

git-send-email - отправить коллекцию патчей по электронной почте

СИНТАКСИС

мерзавец отправить электронное письмо [параметры] ...
мерзавец отправить электронное письмо --dump-псевдонимы

ОПИСАНИЕ

Принимает исправления, указанные в командной строке, и отправляет их по электронной почте. Патчи могут быть указаны
как файлы, каталоги (которые отправят все файлы в каталоге) или напрямую как
список ревизий. В последнем случае любой формат, принятый git-формат-патч(1) можно передать
в git send-email.

Заголовок электронного письма можно настроить с помощью параметров командной строки. Если не указано в
в командной строке пользователю будет предложен интерфейс с поддержкой ReadLine для предоставления
нужная информация.

Для файлов патчей принимаются два формата:

1. Файлы формата mbox

Это то, что git-формат-патч(1) порождает. Большинство заголовков и форматирования MIME
игнорируются.

2. Исходный формат, используемый Грегом Кроа-Хартманом. send_lots_of_email.pl скрипт

Этот формат предполагает, что первая строка файла будет содержать значение «Копия:» и
«Тема:» сообщения во второй строке.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

составление
- аннотировать
Просмотрите и отредактируйте каждый патч, который вы собираетесь отправить. По умолчанию это значение
sendemail.annotate. См. Раздел КОНФИГУРАЦИЯ для sendemail.multiПравить.

--bcc = , ...
Укажите значение «Скрытая копия:» для каждого электронного письма. По умолчанию это значение sendemail.bcc.

Этот параметр можно указывать несколько раз.

--cc = , ...
Укажите начальное значение «Копия:» для каждого электронного письма. По умолчанию это значение sendemail.cc.

Этот параметр можно указывать несколько раз.

- сочинять
Вызовите текстовый редактор (см. GIT_EDITOR в git-вар(1)) для редактирования вступительного сообщения
для серии патчей.

После появления - сочинять используется, git send-email будет использовать From, Subject и In-Reply-To
заголовки, указанные в сообщении. Если тело сообщения (то, что вы вводите после
заголовки и пустая строка) содержит только пустые (или с префиксом Git:) строки, сводка
не будут отправлены, но будут использоваться заголовки From, Subject и In-Reply-To, если они не
удален.

Будет запрошено отсутствие заголовков From или In-Reply-To.

См. Раздел КОНФИГУРАЦИЯ для sendemail.multiПравить.

--from =
Укажите отправителя писем. Если не указано в командной строке, значение
домен отправить электронное письмо.от опция конфигурации используется. Если ни один из параметров командной строки
ни отправить электронное письмо.от заданы, то пользователю будет предложено ввести значение. По умолчанию
для подсказки будет значение GIT_AUTHOR_IDENT или GIT_COMMITTER_IDENT, если это
не установлен, как возвращается "git var -l".

--in-reply-to =
Сделать так, чтобы первое письмо (или все письма с --no-thread) отображалось как ответ на заданное
Message-Id, который позволяет избежать прерывания потоков для предоставления новой серии исправлений. Секунда
и последующие электронные письма будут отправлены как ответы в соответствии с - [no] -chain-reply-to
установка.

Так, например, когда указаны --thread и --no-chain-reply-to, второй и
последующие патчи будут ответами на первый, как на иллюстрации ниже
где [PATCH v2 0/3] отвечает на [PATCH 0/2]:

[ПАТЧ 0/2] Вот что я сделал ...
[ПАТЧ 1/2] Очистка и тесты
[PATCH 2/2] Реализация
[PATCH v2 0/3] Это переброс
[PATCH v2 1/3] Очистить
[PATCH v2 2/3] Новые тесты
[PATCH v2 3/3] Реализация

Требуется, только если также задано --compose. Если --compose не установлен, это будет
запрошено.

--subject =
Укажите начальную тему цепочки писем. Требуется только в том случае, если --compose также
установленный. Если --compose не установлен, это будет запрошено.

--to = , ...
Укажите основного получателя создаваемых писем. Как правило, это будет
Вовлеченный сопровождающий проекта. По умолчанию это значение отправить электронное письмо.кому
значение конфигурации; если это не указано и --to-cmd не указано, это будет
быть запрошенным.

Этот параметр можно указывать несколько раз.

--8bit-encoding =
При обнаружении сообщения или темы, отличных от ASCII, в которых не указана его кодировка,
добавьте заголовки / цитаты, чтобы указать, что он закодирован в . По умолчанию это значение
домен sendemail.assume8bitEncoding; если это не указано, будет запрошено, если
встречаются любые файлы, отличные от ASCII.

Обратите внимание, что никаких попыток проверить кодировку не предпринимается.

--compose-encoding =
Укажите кодировку для создания сообщения. По умолчанию это значение
sendemail.composeencoding; если это не указано, предполагается UTF-8.

--transfer-encoding = (7 бит | 8 бит | печать в кавычках | base64)
Укажите кодировку передачи, которая будет использоваться для отправки сообщения по SMTP. 7bit выйдет из строя
при обнаружении сообщения, отличного от ASCII. quoted-printable может быть полезен, когда
репозиторий содержит файлы, содержащие символы возврата каретки, но делает необработанное сообщение с исправлением
файл (сохраненный из MUA) намного сложнее проверить вручную. base64 еще глупее
стойкий, но еще более непрозрачный. По умолчанию это значение
sendemail.transferEncoding значение конфигурации; если это не указано, git будет использовать
8bit и не добавлять заголовок Content-Transfer-Encoding.

--xmailer, --no-xmailer
Добавьте (или запретите добавление) заголовок «X-Mailer:». По умолчанию добавляется заголовок, но
его можно отключить, установив для переменной конфигурации sendemail.xmailer значение false.

Посылающий
--envelope-sender =
Укажите отправителя конверта, который использовался для отправки электронных писем. Это полезно, если по умолчанию
адрес - это не адрес, на который подписан список. Чтобы использовать от
адрес, установите значение "авто". Если вы используете двоичный файл sendmail, у вас должен быть
подходящие привилегии для параметра -f. По умолчанию это значение
sendemail.envelopeSender переменная конфигурации; если это не указано, выбирая
отправитель конверта остается на усмотрение вашего MTA.

--smtp-encryption =
Укажите используемое шифрование либо SSL or TLS. Любое другое значение возвращается к обычному
SMTP. По умолчанию это значение sendemail.smtpШифрование.

--smtp-domain =
Задает полное доменное имя (FQDN), используемое в команде HELO / EHLO для
SMTP-сервер. Некоторым серверам требуется, чтобы полное доменное имя соответствовало вашему IP-адресу. Если не установлен, git
send-email пытается автоматически определить ваше полное доменное имя. По умолчанию это значение
sendemail.smtpДомен.

--smtp-auth =
Список разрешенных механизмов SMTP-AUTH, разделенных пробелами. Этот параметр заставляет использовать
только перечисленные механизмы. Пример:

$ git send-email --smtp-auth = "ОБЫЧНЫЙ ВХОД GSSAPI" ...

Если хотя бы один из указанных механизмов соответствует тем, которые объявлены SMTP
сервер, и если он поддерживается используемой библиотекой SASL, механизм используется для
аутентификация. Если ни то, ни другое sendemail.smtpAuth ни --smtp-аутентификация указано, все
могут использоваться механизмы, поддерживаемые библиотекой SASL.

--smtp-pass [= ]
Пароль для SMTP-AUTH. Аргумент является необязательным: если аргумент не указан, то
пустая строка используется в качестве пароля. По умолчанию это значение sendemail.smtpPass,
однако --smtp-проход всегда отменяет это значение.

Кроме того, пароли не нужно указывать в файлах конфигурации или в команде
линия. Если было указано имя пользователя (с --smtp-пользователь или sendemail.smtpUser), но
пароль не указан (с --smtp-проход or sendemail.smtpPass), потом
пароль получается с помощью git-учетные данные.

--smtp-server =
Если установлено, указывает исходящий SMTP-сервер для использования (например, smtp.example.com или необработанный IP-адрес).
адрес). В качестве альтернативы он может указать полный путь к программе, подобной sendmail.
вместо; программа должна поддерживать параметр -i. Значение по умолчанию можно указать с помощью
sendemail.smtpServer вариант конфигурации; встроенное значение по умолчанию / usr / sbin / sendmail
or / usr / lib / sendmail если такая программа доступна, или localhost в противном случае.

--smtp-server-port =
Задает порт, отличный от порта по умолчанию (SMTP-серверы обычно слушают
smtp порт 25, но также может прослушивать порт отправки 587 или общий SSL-порт smtp
465); также принимаются символические имена портов (например, «подчинение» вместо 587). В
порт также можно настроить с помощью sendemail.smtpServerPort переменная конфигурация.

--smtp-server-option =
Если установлено, задает параметр исходящего SMTP-сервера, который следует использовать. Значение по умолчанию может быть
определяется sendemail.smtpServerOption вариант конфигурации.

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

--smtp-ssl
Устаревший псевдоним для --smtp-шифрование SSL.

--smtp-ssl-сертификат-путь
Путь к хранилищу доверенных сертификатов ЦС для проверки сертификата SMTP SSL / TLS
(либо каталог, обработанный c_rehash, или один файл, содержащий
один или несколько сертификатов формата PEM, объединенных вместе: см. проверить(1) -CAfile и
-CApath для получения дополнительной информации об этом). Установите пустую строку, чтобы отключить
проверка сертификата. По умолчанию значение sendemail.smtpsslcertpath
переменная конфигурации, если она установлена, или значение по умолчанию, скомпилированное в резервной библиотеке SSL.
в противном случае (что должно быть лучшим выбором на большинстве платформ).

--smtp-user =
Имя пользователя для SMTP-AUTH. По умолчанию это значение sendemail.smtpUser; если имя пользователя
не указано (с --smtp-пользователь or sendemail.smtpUser), то аутентификация не выполняется.
попытался.

--smtp-debug = 0 | 1
Включение (1) или отключение (0) отладочного вывода. Если этот параметр включен, команды и ответы SMTP будут
напечатаны. Полезно для отладки TLS-соединения и проблем с аутентификацией.

Automating
--to-cmd =
Укажите команду для выполнения один раз для каждого файла исправления, которая должна генерировать файл исправления.
конкретные записи «Кому:». Вывод этой команды должен быть одним адресом электронной почты в каждой строке.
По умолчанию это значение sendemail.tocmd значение конфигурации.

--cc-cmd =
Укажите команду для выполнения один раз для каждого файла исправления, которая должна генерировать файл исправления.
конкретные записи «Копия:». Вывод этой команды должен быть одним адресом электронной почты в каждой строке.
По умолчанию это значение sendemail.ccmd значение конфигурации.

- [no-] цепочка-ответ-на
Если это установлено, каждое электронное письмо будет отправляться как ответ на предыдущее отправленное письмо. Если
отключено с помощью "--no-chain-reply-to", все письма после первого будут отправляться как
отвечает на первое отправленное письмо. При использовании рекомендуется, чтобы первый
Данный файл представляет собой обзор всей серии патчей. По умолчанию отключено, но
sendemail.chainReplyTo переменную конфигурации можно использовать для его включения.

--identity =
Идентификатор конфигурации. Когда задано, вызывает значения в отправитель.
подраздел, чтобы иметь приоритет над значениями в отправить почту раздел. По умолчанию
идентичность - это ценность sendemail.identity.

- [no-] подписано cc
Если это установлено, добавьте электронные письма, найденные в строках Signed-off-by: или Cc: в список cc.
По умолчанию это значение sendemail.signedoffbycc значение конфигурации; если это
не указано, по умолчанию --signed-off-by-cc.

- [no-] cc-cover
Если это установлено, электронные письма, найденные в заголовках Cc: в первом патче серии
(обычно сопроводительное письмо) добавляются в список копий для каждого набора адресов электронной почты. По умолчанию
Значение sendemail.cccover значение конфигурации; если это не указано, по умолчанию
--no-cc-обложка.

- [нет-] в обложку
Если это установлено, электронные письма найдены в заголовках To: в первом патче серии.
(обычно сопроводительное письмо) добавляются в список для каждого набора адресов электронной почты. По умолчанию
Значение sendemail.tocover значение конфигурации; если это не указано, по умолчанию
- без покрытия.

--suppress-cc =
Укажите дополнительную категорию получателей для подавления автоматической копии:

· автор будет избегать включения автора патча

· себя не будет включать отправителя

· cc будет избегать включения кого-либо, упомянутого в строках Cc, в заголовок патча, кроме
для себя (используйте себя для этого).

· телоcc будет избегать включения кого-либо, упомянутого в строках Cc, в тело патча (фиксация
сообщение) кроме себя (используйте себя для этого).

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

· cccmd позволит избежать запуска --cc-cmd.

· тело эквивалентна рыдание + телоcc

· Найти подавит все значения автоматической копии.

По умолчанию это значение sendemail.suppresscc значение конфигурации; если это
не указано, по умолчанию себя если указан --suppress-from, а также тело if
--no-signed-off-cc указан.

- [нет-] подавить-из
Если это установлено, не добавляйте адрес From: в список cc :. По умолчанию это значение
sendemail.suppressFrom значение конфигурации; если это не указано, по умолчанию
--no-подавить-от.

- [нет-] тема
Если это установлено, заголовки In-Reply-To и References будут добавляться к каждому электронному письму.
послал. Относится ли каждое письмо к предыдущему электронному письму (глубокая цепочка на мерзавец
формат-патч формулировка) или к первому электронному письму (мелкая цепочка) регулируется
"- [no-] chain-reply-to".

Если отключено с помощью «--no-thread», эти заголовки не будут добавлены (если не указано с помощью
--в ответ на). По умолчанию это значение sendemail.thread значение конфигурации; если
который не указан, по умолчанию --thread.

Пользователь должен убедиться, что заголовок In-Reply-To еще не существует, когда мерзавец
отправить электронное письмо просят добавить его (особенно обратите внимание, что мерзавец формат-патч можно настроить
для самой заправки). Невыполнение этого требования может не привести к ожидаемому результату.
MUA получателя.

Администрирование
--confirm =
Подтвердите непосредственно перед отправкой:

· всегда всегда будет подтверждать перед отправкой

· никогда никогда не подтвердит перед отправкой

· cc подтвердит перед отправкой, когда электронная почта автоматически добавила адреса
из патча в список Cc

· сочинять подтвердит перед отправкой первого сообщения при использовании --compose.

· автоматический эквивалентна cc + сочинять

По умолчанию это значение sendemail.подтвердить значение конфигурации; если это не указано,
по умолчанию автоматический если не указан какой-либо из параметров подавления, и в этом случае
по умолчанию сочинять.

--прогон, репетиция
Делайте все, кроме фактической отправки электронных писем.

- [no-] формат-патч
Если аргумент можно понимать как ссылку или имя файла, выберите
понимать это как аргумент патча формата (--format-patch) или как имя файла
(--no-format-patch). По умолчанию, когда возникает такой конфликт, git send-email будет
потерпеть неудачу.

--тихий
Сделайте git-send-email менее подробным. Все, что выводится, должна быть одна строка в электронном письме.

- [нет-] проверить
Выполните проверки исправности исправлений. В настоящее время валидация означает следующее:

· Предупреждать о патчах, содержащих строки длиннее 998 символов; это из-за SMTP
ограничения, как описано http://www.ietf.org/rfc/rfc2821.txt.

По умолчанию это значение sendemail.validate; если не установлен, по умолчанию --подтвердить.

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

Информация
--dump-псевдонимы
Вместо нормальной работы выгрузите сокращенные имена псевдонимов из настроенного
файл (ы) псевдонимов, по одному на строку в алфавитном порядке. Обратите внимание, это включает только псевдоним
имя, а не его расширенные адреса электронной почты. Видеть sendemail.aliasesfile для большего
информация о псевдонимах.

КОНФИГУРАЦИЯ

sendemail.aliasesFile
Чтобы не вводить длинные адреса электронной почты, укажите здесь один или несколько файлов псевдонимов электронной почты.
Вы также должны поставить sendemail.aliasFileType.

sendemail.aliasFileType
Формат файла (ов), указанного в sendemail.aliasesFile. Должен быть одним из остолоп, почта,
сосновый, вязили гнуили Отправить письмо.

Как выглядит файл псевдонима в каждом формате, можно найти в документации
одноименная почтовая программа. Отличия и ограничения от стандарта
форматы описаны ниже:

Отправить письмо

· Псевдонимы в кавычках и адреса в кавычках не поддерживаются: строки, содержащие "
символ игнорируются.

· Перенаправление к файлу (/ путь / имя) или каналу (| команда) не поддерживается.

· Включение файлов (: include: / path / name) не поддерживается.

· Предупреждения печатаются в стандартном выводе ошибок для любых явных
неподдерживаемые конструкции и любые другие строки, которые не распознаются
парсер.

sendemail.multiПравить
Если true (по умолчанию), будет создан один экземпляр редактора для редактирования файлов, которые вам нужно
редактировать (патчи, когда - аннотировать используется, а сводка, когда - сочинять используется). Если
false, файлы будут редактироваться один за другим, каждый раз создавая новый редактор.

sendemail.подтвердить
Устанавливает значение по умолчанию для подтверждения перед отправкой. Должен быть одним из всегда, никогда,
cc, сочинятьили автоматический. Посмотреть --подтверждать в предыдущем разделе о значении этих
значения.

ПРИМЕР

Используйте Gmail as домен SMTP сервер
Использовать мерзавец отправить электронное письмо для отправки патчей через SMTP-сервер GMail, отредактируйте
~ / .gitconfig чтобы указать настройки вашей учетной записи:

[отправитель]
smtpEncryption = TLS
smtpServer = smtp.gmail.com
smtpUser = [электронная почта защищена]
смтпсерверпорт = 587

Когда ваши коммиты будут готовы к отправке в список рассылки, выполните следующие команды:

$ git format-patch --cover-letter -M origin / master -o outgoing /
$ редактировать исходящие / 0000- *
$ git send-email исходящий / *

Примечание: требуются следующие модули Perl Net :: SMTP :: SSL, MIME :: Base64 и
Authen :: SASL

Используйте git-send-email онлайн с помощью сервисов onworks.net