自己紹介岩松信洋 (IWAMATSU Nobuhiro) Linux カーネル開発をしています (Renesas SH) U-Boot のSHアーキテクチャメンテナしています Debian の開発に参加しています Debian Maintainer / Debian JP Project Lead

Size: px

Start display at page:

Download "自己紹介岩松信洋 (IWAMATSU Nobuhiro) Linux カーネル開発をしています (Renesas SH) U-Boot のSHアーキテクチャメンテナしています Debian の開発に参加しています Debian Maintainer / Debian JP Project Lead"

いちえいおとじま
6 years ago
Views:

1 Linux カーネル開発者予備軍のための Git Howto Japan Technical Jamboree 2009/05/12 ( 株 ) ルネサスソリューションズシステムビジネス本部システム推進部第三グループ岩松信洋 1

2 自己紹介岩松信洋 (IWAMATSU Nobuhiro) Linux カーネル開発をしています (Renesas SH) U-Boot のSHアーキテクチャメンテナしています Debian の開発に参加しています Debian Maintainer / Debian JP Project Leader 2

3 今回のお題 Linuxカーネル開発者予軍のためのGit Howto 1.Gitの基本的なコマンド 2.Gitを使った開発の流れ 3. 質疑応答 1. パッチを送るまで 2. 最新機能を試す 3

4 1. Git の基本的なコマンド 4

5 Subversion 作業 PC ネットワークコミットワーキングコピーリポジトリチェックアウトユーザー編集コミット権が必要 5

6 Git 作業 PC ネットワーク index コミットプッシュワーキングコピーチェックアウトローカルリポジトリフェッチリモートリポジトリユーザー編集これはあなたのリポジトリコミット権が必要 6

7 Git の基本的なコマンド git clone( リポジトリのコピー ) git add/rm/mv( ファイルの追加削除リネイム ) git commit( ローカルリポジトリへコミット ) git diff( 差分の表示 ) git log( コミットログの確認 ) git format-patch( パッチの作成 ) git remote ( リモートリポジトリの管理 ) git rebase/merge ( 間のリベースマージ ) git pull ( リモートリポジトリからコピーマージ ) git branch / git checkout ( の操作 ) 7

8 Git の基本的なコマンドワーキングコピー index ローカルリポジトリリモートリポジトリ git clone git diff git add git commit git commit -a git push git pull git branch / git checkout git merge / git rebase 8

9 2. Git を使った開発の流れ 9

10 2.1. パッチを送るまで基本的な考え方パッチは開発者の最新のコミットに対して修正を送るカーネルでは各機能毎にメンテナがいるのでメンテナがメンテナンスしているリポジトリに対して修正を行うパッチもメンテナおよび機能毎に用意されているメーリングリストに送る 10

11 パッチを送るまで linus crypto net ドライバアーキテクチャ mtd sh netdev arm sh arm 11

12 例 ) SH アーキテクチャに関するパッチを送る場合 12

13 0. 環境の設定 Linux カーネル開発 /Git では名前とメールアドレスを利用する Git で使う名前とメールアドレスを設定する $ git config -global \ user.name "Nobuhiro Iwamatsu" $ git config -global user. \ "iwamatsu.nobuhiro@renesas.com" 13

14 1. リポジトリをコピーする SH アーキテクチャの Git リポジトリは MAINTAINERS ファイルに書いてある SUPERH P: Paul Mundt M: L: W: T: git git://git.kernel.org/pub/scm/linux/kernel/gi t/lethal/sh-2.6.git 14

15 1. リポジトリをコピーする git clone コマンドでリポジトリをコピー $ git clone \ git://git.kernel.org/pub/scm/linux/kernel/gi t/lethal/sh-2.6.git 15

16 1. リポジトリをコピーする sh-2.6 リモートリポジトリ 16

17 1. リポジトリをコピーする sh-2.6 リモートリポジトリリポジトリをコピー 17

18 1. リポジトリをコピーする sh-2.6 リモートリポジトリリポジトリをコピーローカルリポジトリ origin/ 18

19 1. リポジトリをコピーする sh-2.6 リモートリポジトリリポジトリをコピーローカルリポジトリ origin/ heads/ リモートリポジトリのをローカルとして登録する 19

20 2. git clone を実行すると sh-2.6 ディレクトリができているので cd する $ ls sh-2.6 $ cd sh

21 3. 不具合の修正をする $ vi arch/sh/kconfig... edit... $ git diff diff --git a/arch/sh/kconfig b/arch/sh/kconfig index 8d50d c a/arch/sh/kconfig ,7 source kernel/kconfig.hz config KEXEC bool "kexec system call (EXPERIMENTAL)" - depends on SUPERH32 && EXPERIMENTAL + depends on SUPERH32 && EXPERIMENTAL && MMU help kexec is a system call that implements the ability... 21

22 4. ドライバの修正ができたらソースのチェックコンパイルテストを行う $ make ARCH=sh menuconfig $ make ARCH=sh CROSS_COMPILE=sh4-linux-gnu-\ -j8 $ 実機でテスト 22

23 4. 問題がなければ変更をコミットする $ git commit arch/sh/kconfig -s -s は Signed-off をつけるという意味 git commit 実行するとエディタが立ち上がる 23

24 4. 問題がなければ変更をコミットする sh: Add MMU dependency for kexec Kexec is not likely to work on NON-MMU CPU because this added depend on MMU for kexec. $ git commit drivers/net/sh_eth.c -s Signed-off-by: Nobuhiro Iwamatsu \ <iwamatsu.nobuhiro@renesas.com> 1 行目はメールのサブジェクトになる ( 後で説明 ) 空行を入れて次の行からメールの本文になる 24

25 4. 問題がなければ変更をコミットする $ git log commit f36b59d1a4fa1e29be606d0513b5f7fa6e720f79 Author: Nobuhiro Iwamatsu <iwamatsu.nobuhiro@renesas.com> Date: Thu Mar 26 08:32: sh: Add MMU dependency for kexec Kexec is not likely to work on NON-MMU CPU because this added depend on MMU for kexec. $ git commit drivers/net/sh_eth.c -s Signed-off-by: Nobuhiro Iwamatsu \ <iwamatsu.nobuhiro@renesas.com> diff --git a/arch/sh/kconfig b/arch/sh/kconfig index 8d50d c a/arch/sh/kconfig ,7 source kernel/kconfig.hz config KEXEC 25

26 4. 問題がなければ変更をコミットする sh-2.6 リモートリポジトリローカルリポジトリ origin/ heads/ 26

27 4. 問題がなければ変更をコミットする sh-2.6 リモートリポジトリローカルリポジトリ origin/ heads/ α heads/ にコミットされる 27

28 5. 修正している間にリモートリポジトリが更新されている可能性があるのでリモートリポジトリの状態をアップデートする $ git remote update 28

29 5. 修正している間にリモートリポジトリが更新されている可能性があるのでリモートリポジトリの状態をアップデートする sh-2.6 リモートリポジトリローカルリポジトリ origin/ heads/ α 29

30 5. 修正している間にリモートリポジトリが更新されている可能性があるのでリモートリポジトリの状態をアップデートする sh-2.6 リモートリポジトリ 3 4 ローカルリポジトリ origin/ heads/ α 30

31 5. 修正している間にリモートリポジトリが更新されている可能性があるのでリモートリポジトリの状態をアップデートする sh-2.6 リモートリポジトリ 3 4 git remote update ローカルリポジトリ origin/ heads/ α 31

32 5. 修正している間にリモートリポジトリが更新されている可能性があるのでリモートリポジトリの状態をアップデートする sh-2.6 リモートリポジトリ 3 4 git remote update ローカルリポジトリ origin/ 3 4 heads/ α 32

33 6. リモートリポジトリの状態に対して rebase を行う $ git rebase origin git pull -rebase でも可能ソースコードのマージには 2 種類ある git rebase は指定したをベースに自分の修正を追加するコマンド Git merge は指定したの修正を自分のに追加するコマンド 33

34 6. リモートリポジトリの状態に対して rebase を行う sh-2.6 リモートリポジトリ 3 4 ローカルリポジトリ origin/ 3 4 heads/ α 34

35 6. リモートリポジトリの状態に対して rebase を行う sh-2.6 リモートリポジトリ 3 4 ローカルリポジトリ origin/ 3 4 git rebase origin heads/ α 35

36 6. リモートリポジトリの状態に対して rebase を行う sh-2.6 リモートリポジトリ 3 4 ローカルリポジトリ origin/ 3 4 git rebase origine heads/ 3 4 α 36

37 6. リモートリポジトリの状態に対して rebase を行う sh-2.6 リモートリポジトリ 3 4 ローカルリポジトリ origin/ 3 4 git merge origin/ heads/ α 37

38 6. リモートリポジトリの状態に対して rebase を行う sh-2.6 リモートリポジトリ 3 4 ローカルリポジトリ origin/ 3 4 git merge origin/ heads/ α X

39 7. 再度テスト $ make ARCH=sh CROSS_COMPILE=sh4-linux-gnu-\ -j8 $ 実機でテスト 39

40 8. git format-patch コマンドでコミットからパッチメールを作成 $ git format-patch -o../ origin../0001-sh-add-mmu-dependency-for-kexec.patch 40

41 8. git format-patch コマンドでコミットからパッチメールを作成 $ cat \../0001-sh-Add-MMU-dependency-for-kexec.patch From f36b59d1a4fa1e29be606d0513b5f7fa6e720f79 Mon Sep 17 00:00: From: Nobuhiro Iwamatsu <iwamatsu.nobuhiro@renesas.com> Date: Thu, 26 Mar :32: Subject: [PATCH] sh: Add MMU dependency for kexec Kexec is not likely to work on NON-MMU CPU because this added depend on MMU for kexec. Signed-off-by: Nobuhiro Iwamatsu <iwamatsu.nobuhiro@renesas.com> --- arch/sh/kconfig files changed, 1 insertions(+), 1 deletions(-) diff --git a/arch/sh/kconfig b/arch/sh/kconfig index 8d50d c a/arch/sh/kconfig ,7 source kernel/kconfig.hz... 41

42 8. git format-patch コマンドでコミットからパッチメールを作成 sh-2.6 リモートリポジトリ 3 4 ローカルリポジトリ origin/ 3 4 heads/ 3 4 α 現在のと origin との差分を出力 42

43 9. 作成したパッチをメーリングリストに投稿する $ git send- \ -to linux-sh@vger.kernel.org \ -cc lethal@linux-sh.org \../0001-sh-Add-MMU-dependency-for-kexec.patch 43

44 2.2. 最新機能を試す最新のドライバとか最新の機能とか試したい事があるというか試す必要がある場合があるどのようにするか 44

45 例 ) sh-2.6のリポジトリをベースにしたにbluetoothドライバのコードをマージしてテストをする 45

46 1. リモートリポジトリを追加する Bluetooth の Git リポジトリは MAINTAINERS ファイルに書いてある BLUETOOTH SUBSYSTEM P: Marcel Holtmann M: L: W: T: git git://git.kernel.org/pub/scm/linux/kernel/gi t/holtmann/bluetooth-2.6.git 46

47 1. リモートリポジトリを追加する git remote コマンドでリモートリポジトリを追加 $ git remote add bluetooth \ git://git.kernel.org/pub/scm/linux/kernel/gi t/holtmann/bluetooth-2.6.git 47

48 1. リモートリポジトリを追加する sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B ローカルリポジトリ origin/ heads/ 48

49 1. リモートリポジトリを追加する sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B ローカルリポジトリ origin/ heads/ 49

50 1. リモートリポジトリを追加する sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B git remote add ローカルリポジトリ origin/ heads/ 50

51 1. リモートリポジトリを追加する sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B git remote add ローカルリポジトリ origin/ heads/ bluetooth 51

52 2. リモートリポジトリの状態をアップデートする $ git remote update bluetooth Updating bluetooth From git://git.kernel.org/pub/scm/linux/kernel/gi t/holtmann/bluetooth-2.6.git * [new branch] -> \ bluetooth/ 52

53 2. リモートリポジトリの状態をアップデートする sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B git remote update bluetooth ローカルリポジトリ origin/ heads/ bluetooth 53

54 2. リモートリポジトリの状態をアップデートする sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B git remote update bluetooth ローカルリポジトリ origin/ heads/ bluetooth/ 0 A B 54

55 3.bluetooth の変更をに取り込む $ git branch * $ git merge bluetooth/ Merge made by recursive. Counting objects: , done. Delta compression using up to 4 threads. Compressing objects: 100% (147281/147281), done. Writing objects: 100% (976200/976200), done. Total (delta ), reused (delta )... 55

56 3.bluetooth の変更をに取り込む sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B git merge bluetooth/ ローカルリポジトリ origin/ heads/ bluetooth/ 0 A B 56

57 3.bluetooth の変更をに取り込む sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B git merge bluetooth/ ローカルリポジトリ origin/ heads/ bluetooth/ A B 0 A B X 57

58 3.bluetooth の変更をに取り込む $ git show HEAD commit 52b4ab9e bf2a3f34dae5367a7ef5e9b4f Merge: 138f025 4c71318 Author: Nobuhiro Iwamatsu <iwamatsu.nobuhiro@renesas.com> Date: Thu Jun 11 16:23: Merge commit 'bluetooth/' into 58

59 3.bluetooth の変更をに取り込む $ git show HEAD commit 52b4ab9e bf2a3f34dae5367a7ef5e9b4f Merge: 138f025 4c71318 Author: Nobuhiro Iwamatsu <iwamatsu.nobuhiro@renesas.com> Date: Thu Jun 11 16:23: Merge commit 'bluetooth/' into 59

60 3.bluetooth の変更をに取り込む sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B git merge bluetooth/ ローカルリポジトリ origin/ heads/ bluetooth/ A B 0 A B X 60

61 4. テストを行う $ make ARCH=sh CROSS_COMPILE=sh4-linux-gnu-\ -j8 $ 実機でテスト 61

62 5. を元に戻す $ git reset -hard origin/ 62

63 5. を元に戻す sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B ローカルリポジトリ origin/ heads/ bluetooth/ A B 0 A B X 63

64 5. を元に戻す sh-2.6 リモートリポジトリ Bluetooth リモートリポジトリ 0 A B ローカルリポジトリ origin/ heads/ リセットする bluetooth/ 0 A B 64

65 まとめリモートリポジトリとローカルリポジトリを理解しましょうパッチを送るときは rebase して最新のコミットに対してのパッチを送るようにしましょうリモートリポジトリは git remote を使うと楽です merge と rebase は使い分けましょう 65

66 その他知っておくとよい事 Git オブジェクトの仕組み index の動きコンフリクト時の復旧方法 git bisect/ blame の使い方 66

67 質疑応答 67

68 ご清聴ありがとうございました 68

バージョン管理ツールを使い Debian パッケージを管理する - Git 編

バージョン管理ツールを使い Debian パッケージを管理する - Git 編 Debian Git iwamatu@debian.or.jp IRC nick: iwamatsu 2008 4 19 VCS Debian VCS 2008 4 Debian VCS git-buildpackage git-buildpackage git-dch Git Debian Changelog git-import-dsc Debian Package Git git-import-orig

自己紹介 岩松信洋 (IWAMATSU Nobuhiro) Linux カーネル開発をしています (Renesas SH) U-Boot のSHアーキテクチャメンテナしています Debian の開発に参加しています Debian Maintainer / Debian JP Project Lead

自己紹介岩松信洋 (IWAMATSU Nobuhiro) Linux カーネル開発をしています (Renesas SH) U-Boot のSHアーキテクチャメンテナしています Debian の開発に参加しています Debian Maintainer / Debian JP Project Lead