本文是在Ubunt 12.04環境下測試的。

1、安裝必要的軟體

1. # apt-get install git git-core git-email

2、配置send-email的環境，主要是設定本地email的客戶端，用msmtp

vim ~/.msmtprc
 

1. # default
   
2. account gmail
   
3. protocol smtp
   
4. host smtp.gmail.com
   
5. from [email protected].com
   
6. user [email protected].com
   
7. password ******
   
8. port 587 
   
9. auth on
   
10. tls on
    
    
11. tls_trust_file /etc/ssl/certs/ca-certificates.crt
    
12. syslog LOG_MAIL
    
13. # set a default account
    
14. account default : gmail

3、設定git send-email的配置
vim ~/.gitconfig

1. [user]
   
2.     name = your name
   
3.     email = [email protected].com
   
4. [sendemail]
   
5.         smtpencryption = tls 
   
6.         smtpuser = [email protected]
   .com
   
7.         smtpserverport = 587 
   
8.         smtpserver = smtp.gmail.com 
   
9. # to = [email protected].com
   
10. # cc = [email protected].com
    
11. # from = [email protected].com

        

其中，上面配置檔案的最後三行在git send-email傳送補丁檔案時也可以通過命令列指定。建議大家最好通過命令列指定，因為核心補丁檔案需要傳送給相關模組的maintainer。

4、下面就以例項來說明如果製作一個符合規範的核心補丁。
Linux核心補丁的製作規範和傳送格式參見核心文件Documentation/SubmittingPatches。
a、修改核心

1. diff --git a/net/sunrpc/auth_null.c b/net/sunrpc/auth_null.c
   
2. index a5c36c0..f8e0d73 100644
   
3. --- a/net/sunrpc/auth_null.c
   
4. +++ b/net/sunrpc/auth_null.c
   
5. @@ -27,6 +27,7 @@ nul_create(struct rpc_clnt *clnt, rpc_authflavor_t flavor)
   
6.  static void
   
7.  nul_destroy(struct rpc_auth *auth)
   
8.  {
   
9. + pr_info("hellor world!\n");
   
10.  }

b、提交修改

1. git commit -a -s -m"test" -e

其中，-a表示all，-s表示在補丁檔案頭部增加Signed-off-by行，-m表示指定commit資訊，-e表示使用git預設的編輯器來對commit資訊進一步編輯，我這裡預設的編輯器是nano。關於更詳細的引數選項可以用命令git commit -h來察看。

執行上面那個命令以後，會進入到nano編輯器中，然後進行編輯。其中第一行顯示的是補丁檔案頭部的Subject資訊，第二行文字顯示的是補丁檔案的註釋資訊。編輯完以後，ctrl-o儲存，ctrl-x退出。  
 
 
c、生成補丁檔案

1. git format-patch -1

其中，-1表示生成一個補丁檔案，即最後git commit時的修改。用vim開啟補丁檔案，如下所示：
 
 
之所以要有Subject，Signed-off-by檔案，那是因為核心文件Documentation/SubmittingPatches檔案中有說明：

15) The canonical patch format

The canonical patch subject line is: 

    Subject: [PATCH 001/123] subsystem: summary phrase

The canonical patch message body contains the following:

- A "from" line specifying the patch author.

- An empty line.

- The body of the explanation, which will be copied to the 
    permanent changelog to describe this patch.

- The "Signed-off-by:" lines, described above, which will
    also go in the changelog.

- A marker line containing simply "---".

- Any additional comments not suitable for the changelog.

- The actual patch (diff output).

d、檢測補丁
製作完補丁檔案以後，不要急著把補丁檔案mail出去，需要先檢測一下這個補丁的正確性。核心中提供了一個補丁檢測指令碼。在核心原始碼根目錄下，補丁檢測如下：

1. # ./scripts/checkpatch.pl 0001-nfs-add-a-pr_info.patch 
   
2. total: 0 errors, 0 warnings, 7 lines checked
   
3. 0001-nfs-add-a-pr_info.patch has no obvious style problems and is ready for submission.

e、確定補丁傳送給誰
補丁檢測通過以後，就可以mail出去了。但是該mail給誰呢？嗯，核心裡面也同樣提供了一個指令碼，用於檢測某個目錄的maintainer是誰。以我修改的net/sunrpc目錄裡面的檔案為例，執行下面的命令：

1. [email protected]-PC:~/code/linux-3.5.4# ./scripts/get_maintainer.pl net/sunrpc/ -f
   
2. Trond Myklebust <Trond.[email protected].com> (maintainer:NFS, SUNRPC, AND...)
   
3. "J. Bruce Fields" <[email protected].org> (supporter:KERNEL NFSD, SUNR...)
   
4. "David S. Miller" <[email protected].net> (maintainer:NETWORKING [GENERAL])
   
5. linux-[email protected].kernel.org (open list:NFS, SUNRPC, AND...)
   
6. [email protected].kernel.org (open list:NETWORKING [GENERAL])
   
7. linux-[email protected].kernel.org (open list)

從上面輸出可以看到，email destination有三個人。而後面的3個則用於email carbon copy (cc)，即抄送。

5、傳送補丁
命令如下所示：

1. [email protected]-PC:~# git send-email --smtp-server /usr/bin/msmtp --to [email protected].com 
   
2. --cc [email protected].com 0001-nfs-add-a-pr_info.patch

其中，git send-email的選項選項說明如下：
--to 郵件的To地址 sendmail.to
--cc 郵件的Cc地址 sendmail.cc
--smtp-server SMTP伺服器名稱 sendmail.smtp-server

關於git send-email的詳細選項說明，可以通過執行命令git send-email -h察看。
注意，這裡是通過命令列引數設定，前面說過，在~/.msmtprc檔案也可以設定全域性引數。
如果大家要測試的話，可以將--to和--cc設定成自己的郵箱地址。