git-send-email

Проверить и отредактировать каждое исправление перед отправкой. По умолчанию используется значение sendemail.annotate. См. описание sendemail.multiEdit в разделе НАСТРОЙКА.

Указать значение Bcc: для каждого письма. По умолчанию используется значение sendemail.bcc.

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

Указать начальное значение Cc: для каждого письма. По умолчанию используется значение sendemail.cc.

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

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

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

Если заголовки From или In-Reply-To отсутствуют, система предложит ввести их.

См. описание sendemail.multiEdit в разделе НАСТРОЙКА.

Указать отправителя электронных писем. Если параметр не указан в командной строке, используется значение параметра настройки sendemail.from. Если не задан ни параметр командной строки, ни sendemail.from, система предложит ввести значение. В качестве значения по умолчанию для запроса используется значение GIT_AUTHOR_IDENT или, если оно не задано, GIT_COMMITTER_IDENT, возвращаемое командой git var -l.

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

Сделать так, чтобы первое письмо (или все письма с параметром --no-thread) выглядело ответом на указанный Message-ID. Это позволяет начать новую серию исправлений, не нарушая существующие цепочки обсуждений. Второе и последующие письма будут отправлены как ответы в соответствии с настройкой --[no-]chain-reply-to.

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

[PATCH 0/2] Here is what I did...
  [PATCH 1/2] Clean up and tests
  [PATCH 2/2] Implementation
  [PATCH v2 0/3] Here is a reroll
    [PATCH v2 1/3] Clean up
    [PATCH v2 2/3] New tests
    [PATCH v2 3/3] Implementation

Используется только при наличии параметра --compose. Если параметр --compose не задан, система предложит ввести его.

SMTP-серверы Microsoft Outlook отбрасывают переданный в письме Message-ID и назначают новый случайный Message-ID, нарушая тем самым цепочки обсуждений.

При использовании --outlook-id-fix git send-email применяет механизм, специфичный для серверов Outlook, чтобы определить назначенный сервером Message-ID и исправить цепочку. Используйте его только в том случае, если известно, что сервер сообщает изменённый Message-ID так же, как серверы Outlook.

Если параметр не указан, исправление выполняется по умолчанию при подключении к smtp.office365.com или smtp-mail.outlook.com. Используйте --no-outlook-id-fix, чтобы отключить исправление и при подключении к этим двум серверам.

Указать начальную тему цепочки писем. Используется только при наличии параметра --compose. Если параметр --compose не задан, система предложит ввести тему.

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

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

При обнаружении сообщения или темы с символами вне ASCII, в которых не указана кодировка, добавить заголовки или кавычки, обозначающие кодировку <encoding>. По умолчанию используется значение параметра sendemail.assume8bitEncoding; если оно не задано, система предложит ввести кодировку при обнаружении файлов с символами вне ASCII.

Обратите внимание: проверка кодировки не выполняется.

Указать кодировку составляемого сообщения. По умолчанию используется значение параметра sendemail.composeEncoding; если оно не задано, предполагается UTF-8.

Указать кодировку передачи сообщения по SMTP. Значение 7bit приведёт к ошибке при обнаружении сообщения с символами вне ASCII. Значение quoted-printable может быть полезно, если репозиторий содержит файлы с символами возврата каретки, но значительно затрудняет ручной просмотр исходного файла письма с исправлением (сохранённого из почтового клиента). Значение base64 ещё надёжнее, но делает содержимое ещё менее прозрачным. Значение auto использует 8bit, если это возможно, и в противном случае — quoted-printable.

По умолчанию используется значение параметра настройки sendemail.transferEncoding; если оно не задано, используется auto.

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

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

Указать команду для отправки электронных писем. Команда должна быть совместима с sendmail; в частности, она должна поддерживать параметр -i. При необходимости команда будет выполнена в оболочке. По умолчанию используется значение sendemail.sendmailCmd. Если оно и --smtp-server не заданы, git send-email будет искать sendmail в /usr/sbin, /usr/lib и $PATH.

Указать способ начала шифрования SMTP-соединения. Допустимые значения: ssl и tls. Любое другое значение включает обычный (незашифрованный) SMTP, использующий по умолчанию порт 25. Несмотря на названия, оба значения используют одну и ту же, более новую версию TLS; эти названия сохранились по историческим причинам. ssl означает «неявное» шифрование (иногда называемое SMTPS), по умолчанию использующее порт 465. tls означает «явное» шифрование (часто называемое STARTTLS), по умолчанию использующее порт 25. SMTP-сервер может использовать и другие порты, отличные от указанных по умолчанию. Часто используемый альтернативный порт для tls и незашифрованного соединения — 587. Чтобы определить подходящий вариант, ознакомьтесь с документацией провайдера или конфигурацией сервера. По умолчанию используется значение sendemail.smtpEncryption.

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

Разделённый пробелами список разрешённых механизмов SMTP-AUTH. Этот параметр позволяет использовать только перечисленные механизмы. Например:

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

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

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

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

Отключить аутентификацию SMTP. Краткая форма параметра --smtp-auth=none.

Указать исходящий SMTP-сервер (например, smtp.example.com или необработанный IP-адрес). Если параметр не задан, а также не задан --sendmail-cmd, по умолчанию выполняется поиск sendmail в /usr/sbin, /usr/lib и $PATH, если такая программа доступна; в противном случае используется localhost.

Для обратной совместимости этот параметр также может указывать полный путь к программе, совместимой с sendmail; программа должна поддерживать параметр -i. Этот способ не позволяет передавать аргументы или использовать обычные имена команд. Для таких случаев используйте вместо него --sendmail-cmd.

Указать порт, отличный от порта по умолчанию (SMTP-серверы обычно принимают соединения SMTP на порту 25, но также могут использовать порт отправки 587 или распространённый порт SSL SMTP 465). Допускаются и символьные имена портов (например, submission вместо 587). Порт также можно задать с помощью переменной настройки sendemail.smtpServerPort.

Указать параметр исходящего SMTP-сервера. Значение по умолчанию можно задать с помощью параметра настройки sendemail.smtpServerOption.

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

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

Путь к хранилищу доверенных сертификатов CA для проверки сертификатов SMTP SSL/TLS (каталог, обработанный командой c_rehash, или отдельный файл с одним или несколькими объединёнными сертификатами в формате PEM: дополнительные сведения см. в описаниях параметров -CAfile <file> и -CApath <dir> на https://docs.openssl.org/master/man1/openssl-verify/ [странице руководства OpenSSL verify(1)]). Чтобы отключить проверку сертификатов, задайте пустую строку. По умолчанию используется значение переменной настройки sendemail.smtpSSLCertPath, если она задана; в противном случае используется значение по умолчанию, скомпилированное в SSL-библиотеке (оно должно быть оптимальным для большинства платформ).

Путь к файлу сертификата клиента, который будет предоставлен по запросу сервера. Этот параметр необходим, если сервер настроен на проверку сертификатов клиента. Если соответствующий закрытый ключ не включён в файл, его необходимо указать с помощью переменной настройки sendemail.smtpSSLClientKey или параметра --smtp-ssl-client-key. По умолчанию используется значение переменной настройки sendemail.smtpSSLClientCert, если она задана.

Путь к файлу закрытого ключа клиента, соответствующего сертификату клиента. Во избежание неправильной настройки этот параметр необходимо использовать вместе с переменной настройки sendemail.smtpSSLClientKey или параметром --smtp-ssl-client-cert. Если ключ клиента включён в сертификат клиента, выбор закрытого ключа зависит от формата сертификата. Дополнительные сведения см. на странице https://metacpan.org/pod/IO::Socket::SSL. По умолчанию используется значение переменной настройки sendemail.smtpSSLClientKey, если она задана.

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

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

Некоторые почтовые провайдеры (например, iCloud) не сохраняют копии писем, отправленных через SMTP, в папке Sent или аналогичной папке почтового ящика. Используйте этот параметр, чтобы с помощью git imap-send отправлять копии писем в указанную папку. Выполните команду git imap-send --list, чтобы получить список допустимых имён папок, включая правильное имя папки Sent в вашем почтовом ящике. Этот параметр также можно использовать для отправки писем в выбранную вами отдельную папку IMAP.

Для работы этой функции необходимо настроить git imap-send. Инструкции см. в git-imap-send[1].

Если параметр включён, все письма будут только копироваться в папку IMAP, указанную с помощью --imap-sent-folder или sendemail.imapSentFolder, и не будут отправляться получателям. Это полезно, если вы хотите лишь создать черновики писем, а отправить их с помощью другого почтового клиента. Если отключить параметр с помощью --no-use-imap-only, письма будут отправляться обычным образом. По умолчанию параметр отключён, но для его включения можно использовать переменную настройки sendemail.useImapOnly.

Для работы этой функции необходимо настроить git imap-send. Инструкции см. в git-imap-send[1].

Некоторые почтовые серверы (например, smtp.163.com) ограничивают число писем, отправляемых за один сеанс (соединение), что может привести к сбою при отправке большого количества сообщений. С этим параметром send-email разорвёт соединение после отправки <num> сообщений, подождёт несколько секунд (см. --relogin-delay) и подключится снова, чтобы обойти такое ограничение. Чтобы не вводить пароль при каждом повторном подключении, можно использовать помощник для учётных данных. Значение по умолчанию задаётся переменной настройки sendemail.smtpBatchSize.

Ожидание <int> секунд перед повторным подключением к SMTP-серверу. Используется вместе с параметром --batch-size. Значение по умолчанию задаётся переменной настройки sendemail.smtpReloginDelay.

Очистить все списки адресов To:, Cc:, Bcc:, заданные ранее с помощью конфигурации.

Очистить ранее прочитанное значение sendemail.identity, заданное с помощью конфигурации, если оно есть.

Указать команду, которую нужно выполнить для каждого файла патча, чтобы получить специфичные для этого файла записи To:. Эта команда должна выводить по одному адресу электронной почты в каждой строке. По умолчанию используется значение параметра конфигурации sendemail.toCmd.

Указать команду, которую нужно выполнить для каждого файла патча, чтобы получить специфичные для этого файла записи Cc:. Эта команда должна выводить по одному адресу электронной почты в каждой строке. По умолчанию используется значение параметра конфигурации sendemail.ccCmd.

Указать команду, которая выполняется один раз для каждого исходящего сообщения и выводит строки заголовков в формате RFC 2822 для вставки в эти сообщения. Если задана переменная конфигурации sendemail.headerCmd, всегда используется её значение. Если в командной строке указан параметр --header-cmd, его значение имеет приоритет над переменной конфигурации sendemail.headerCmd.

Отключить используемую команду для заголовков.

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

Идентификатор конфигурации. Если он указан, значения из подраздела sendemail.<identity> имеют приоритет над значениями из раздела sendemail. По умолчанию используется значение sendemail.identity.

Если параметр включён, адреса электронной почты из завершающего блока Signed-off-by или строк Cc: добавляются в список копий (Cc). По умолчанию используется значение параметра конфигурации sendemail.signedOffByCc; если оно не задано, используется --signed-off-by-cc.

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

Если параметр включён, адреса электронной почты из заголовков To: первого патча серии (обычно сопроводительного письма) добавляются в список получателей (To) для каждого набора писем. По умолчанию используется значение параметра конфигурации sendemail.toCover; если оно не задано, используется --no-to-cover.

Указать дополнительную категорию получателей, адреса которых не следует автоматически добавлять в список копий (Cc):

По умолчанию используется значение параметра конфигурации sendemail.suppressCc; если оно не задано, используется self, если указан --suppress-from, а также body, если указан --no-signed-off-by-cc.

Если параметр включён, адрес From: не добавляется в список Cc:. По умолчанию используется значение параметра конфигурации sendemail.suppressFrom; если оно не задано, используется --no-suppress-from.

Если параметр включён, к каждому отправляемому письму добавляются заголовки In-Reply-To и References. То, будет ли каждое письмо ссылаться на предыдущее (deep — ветвление согласно формулировке git format-patch) или на первое письмо (shallow — ветвление), определяется параметром --[no-]chain-reply-to.

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

Пользователь должен убедиться, что заголовок In-Reply-To ещё не существует, прежде чем запрашивать его добавление с помощью git send-email (особенно обратите внимание, что git format-patch можно настроить для самостоятельного создания веток переписки). Если этого не сделать, результат в почтовой программе получателя может оказаться не таким, как ожидалось.

Использовать файл mailmap (см. gitmailmap[5]) для сопоставления всех адресов с каноническими настоящими именами и адресами электронной почты. Дополнительные данные mailmap, относящиеся к git send-email, можно указать с помощью параметров конфигурации sendemail.mailmap.file или sendemail.mailmap.blob. По умолчанию используется sendemail.mailmap.

Запрашивать подтверждение непосредственно перед отправкой:

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

Выполнить все действия, кроме фактической отправки писем.

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

Сделать вывод команды git send-email менее подробным. Должна выводиться только одна строка для каждого письма.

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

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

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

Вместо обычной работы вывести краткие имена псевдонимов из настроенных файлов псевдонимов, по одному в строке в алфавитном порядке. Обратите внимание, что выводятся только имена псевдонимов, а не соответствующие им адреса электронной почты. Дополнительные сведения о псевдонимах см. в sendemail.aliasesFile.

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