gentoo ebuild FUQ :-)

lucida

这个FUQ＝Gentoo Frequently Unanswered Questions(FUQ)

主要是受到这个页面的启发
http://gentoo.zhware.net/fuq.html
这里说得很杂，我只结合自己的使用说说portage系统的一些技巧。

0. 定位ebuild
基础知识，比如
$emerge -s gcal
*  app-misc/gcal
      Latest version available: 3.01
      Latest version installed: [ Not Installed ]
      Size of downloaded files: 2,315 kB
      Homepage:    http://www.gnu.org/software/gcal/gcal.html
      Description: The GNU Calendar - a replacement for cal

那么gcal这个软件的ebuild就在/usr/portage/app-misc/gcal/下面
在这个目录下，一般能看到很多ebuild文件，分别对应不同版本号

1.  怎么继续前次的ebuild操作?
比如，emerge到一半，发现一个错误，你google/去论坛搜了一圈，找出了解决办法，难道非要从头开始么? 解决办法其实很多了，说几个最常用的
a. 使用ccache
每个人都应该把它打开
emerge ccache之后，在/etc/make.conf里面
找到FEATURES设置，加上
FEATURES="ccache"
以及CCACHE_SIZE="2G"
默认好像是2G，我觉得如果硬盘空间足够，多多益善。
下次emerge的时候，你会发现编译的速度快了很多。这样间接起到了中断继续的效果。个人推荐这个方法，最简单。

b.继续make
emerge也就是一个用源码编译/安装的过程，而gnu make系统也保证了它实际上是可以"断点续传"的。而gentoo的portage系统在每次开始新的emerge的时候，会自己删掉以前的临时目录，重新生成，造成中断的emerge过程不可恢复。
你只要进入到临时目录，一般是
/var/tmp/portage/ebuild名称/work/ebuild名称/
下继续make，然后make install就行
不用怀疑，这样已经装好了。。但是，这样安装的软件包不会被记载在portage的world file里面。。所以，更优雅的办法是
0. 找到ebuild文件，比如abc-1.0.1.ebuild
1. ebuild abc-1.0.1.ebuild  compile
2. ebuild abc-1.0.1.ebuild  install
3. ebuild abc-1.0.1.ebuild  qmerge

lucida

2. 作自己的ebuild
ebuild文件只是按照一定规律写的shell script而已，一般来说，它们是非常简单的(只限于100行以内条理清晰的 :p xfree的ebuild就是个很好的例外 ) 可以看看gentoo的ebuild guide，
http://www.gentoo.org/doc/en/gentoo-howto.xml
大概而言，只要知道
$A/$P等几个变量的含义就可以了。
从头写ebuild还是有点麻烦的，对于一个普通用户来说也没必要，但是
对于大多数软件的版本升级，你只要复制+改名+做digest就可以了
比如stardict最近出了2.2.1，但是ebuild只到2.2.0

2. fancyworld stardict # cp stardict-2.2.0.ebuild stardict-2.2.1.ebuild
3. fancyworld stardict # ebuild stardict-2.2.1.ebuild digest
4. >>> Downloading ftp://ftp.ussg.iu.edu/pub/linux/gentoo/distfiles/stardict-2.2.1.tar.bz2
5. --22:26:57--  ftp://ftp.ussg.iu.edu/pub/linux/gentoo/distfiles/stardict-2.2.1.tar.bz2
6.            => `/usr/portage/distfiles/stardict-2.2.1.tar.bz2'
7. Resolving ftp.ussg.iu.edu... done.
8. Connecting to ftp.ussg.iu.edu[129.79.6.12]:21... connected.
9. Logging in as anonymous ... Logged in!
10. ==> SYST ... done.    ==> PWD ... done.
11. ==> TYPE I ... done.  ==> CWD /pub/linux/gentoo/distfiles ... done.
12. ==> PASV ... done.    ==> RETR stardict-2.2.1.tar.bz2 ...
13. No such file `stardict-2.2.1.tar.bz2'.
15. >>> Downloading http://aleron.dl.sourceforge.net/sourceforge/stardict/stardict-2.2.1.tar.bz2
16. --22:26:58--  http://aleron.dl.sourceforge.net/sourceforge/stardict/stardict-2.2.1.tar.bz2
17.            => `/usr/portage/distfiles/stardict-2.2.1.tar.bz2'
18. Resolving aleron.dl.sourceforge.net... done.
19. Connecting to aleron.dl.sourceforge.net[204.157.3.229]:80... connected.
20. HTTP request sent, awaiting response... 200 OK
21. Length: 608,829 [application/x-bzip2]
23. 100%[====================================>] 608,829      144.56K/s    ETA 00:00
25. 22:28:02 (144.56 KB/s) - `/usr/portage/distfiles/stardict-2.2.1.tar.bz2' saved [608829/608829]
27. >>> Generating digest file...
28. <<< stardict-2.2.1.tar.bz2
29. >>> Generating manifest file...
30. <<< stardict-2.0.0.ebuild
31. <<< stardict-2.2.1.ebuild
32. <<< stardict-2.2.0.ebuild
33. <<< ChangeLog
34. <<< files/stardict-gentoo.patch
35. <<< files/stardict-config.sh
36. <<< files/digest-stardict-2.0.0
37. <<< files/digest-stardict-2.2.0
38. <<< files/digest-stardict-2.2.1
39. >>> Computed message digests.

复制代码

然后试着emerge  stardict-2.2.1.ebuild看看?

当然大多数时候，没有这么简单，可能会做一些小修改。我的标准步骤是
cp xxx.1.ebuild xxx.2.ebuild
ebuild xxx.2.ebuild  digest
ebuild xxx.2.ebuild  unpack
如果到这里一帆风顺，那么估计后面也没问题了，否则，仔细检查，看看是哪里出错了。出错的原因很多，但是一般都是因为几个变量的写法，或者是下载地址变更，再就是老的ebuild里的patch，在新版本上无法使用。总之，看看ebuild guide，自己多熟悉一下，升级软件真的很简单。

lucida

3. 加patch
做法有两种，参考前面提到的介绍
a. 在临时目录里面修改

从1.知道，临时文件在/var/tmp/portage/下面
以fontconfig 2.2.1+firefly的patch为例

2. fancyworld superkaramba # emerge -p fontconfig
4. These are the packages that I would merge, in order:
6. Calculating dependencies ...done!
7. [ebuild    N ] media-libs/fontconfig-2.2.0-r2
9. fancyworld superkaramba # cd /usr/portage/media-libs/fontconfig/
10. fancyworld fontconfig # ebuild fontconfig-2.2.1.ebuild unpack
11. fancyworld fontconfig # ebuild fontconfig-2.2.1.ebuild unpack
12. >>> md5 src_uri ;-) fontconfig-2.2.1.tar.gz
13. >>> Unpacking source...
14. >>> Unpacking fontconfig-2.2.1.tar.gz to /var/tmp/portage/fontconfig-2.2.1/work
15. * Applying fontconfig-2.1-slighthint.patch...                            [ ok ]
16. * Applying fontconfig-2.2-local_fontdir-r1.patch...                      [ ok ]
17. * Applying fontconfig-2.2-blacklist.patch...                             [ ok ]
18. * Applying fontconfig-2.2-remove_subpixel_test.patch...                  [ ok ]
19. >>> Source unpacked.
20. fancyworld fontconfig # cd /var/tmp/portage/fontconfig-2.2.1/work/fontconfig-2.2.1/
21. fancyworld fontconfig-2.2.1 # wget [url]http://firefly.idv.tw/setfont-xft/patches/fontconfig/fontconfig-2.2.1-multifamily-20030618.patch[/url] [url]http://firefly.idv.tw/setfont-xft/patches/fontconfig/fontconfig-2.2.1-include_CJK_charmaps-20030626.patch.gz[/url] [url]http://firefly.idv.tw/setfont-xft/patches/fontconfig/fontconfig-2.2.1-fclang-miss_1_percent-20030617.patch[/url]
23. fancyworld fontconfig-2.2.1 # patch -p1 < fontconfig-2.2.1-fclang-miss_1_percent-20030617.patch
24. patching file src/fclang.c
26. .............

复制代码

然后
fancyworld fontconfig-2.2.1 # ebuild /usr/portage/media-libs/fontconfig/fontconfig-2.2.1.ebuild merge

这个merge操作会保留临时目录，在这个基础上进行./configure, make, make install的动作

b. 修改ebuild

gentoo的portage系统恐怕是最适合patch 的包管理系统了
还是以上为例
fancyworld fontconfig-2.2.1 # cd /usr/portage/media-libs/fontconfig/files/
下载patch
fancyworld files # wget http://firefly.idv.tw/setfont-xf ... mily-20030618.patch http://firefly.idv.tw/setfont-xf ... s-20030626.patch.gz http://firefly.idv.tw/setfont-xf ... cent-20030617.patch
解压.gz(特例，因为这个patch太大了，所以firefly把它打包了一下)
gunzip fontconfig-2.2.1-include_CJK_charmaps-20030626.patch.gz
得到fontconfig-2.2.1-include_CJK_charmaps-20030626.patch
回到上一级，修改ebuild
fancyworld files # cd ..
fancyworld fontconfig # vi fontconfig-2.2.1.ebuild
可以看到

2. src_unpack() {
3.     unpack ${A}
4.     cd ${S}
6.     local PPREFIX="${FILESDIR}/patch/${PN}"
8.     # Some patches from Redhat
9.     epatch ${PPREFIX}-2.1-slighthint.patch
10.     # Add our local fontpaths (duh dont forget!)
11.     epatch ${PPREFIX}-2.2-local_fontdir-r1.patch
12.     # Blacklist some fonts that break fontconfig
13.     epatch ${PPREFIX}-2.2-blacklist.patch
14.     # Remove the subpixel test from local.conf (#12757)
15.     epatch ${PPREFIX}-2.2-remove_subpixel_test.patch
17.     # The date can be troublesome
18.     sed -i "s:\`date\`::" configure
19. }

复制代码

这里的${FILESDIR}就等于 /usr/portage/media-libs/fontconfig/files/目录
${P}表示的是完整软件名+版本号，这里是fontconfig-2.2.1
${PN}就只是单纯的软件名，这里是fontconfig
注意    epatch ${PPREFIX}-2.2-local_fontdir-r1.patch
和 firefly的patch部分冲突，把它去掉。
为了避免不必要的困扰，你的ebuild没有必要写的那么漂亮，所以，修改如下

src_unpack() {
    unpack ${A}
    cd ${S}

    local PPREFIX="${FILESDIR}/patch/${PN}"

    # Some patches from Redhat
    epatch ${PPREFIX}-2.1-slighthint.patch
    # Add our local fontpaths (duh dont forget!)
#    epatch ${PPREFIX}-2.2-local_fontdir-r1.patch
    # Blacklist some fonts that break fontconfig
    epatch ${PPREFIX}-2.2-blacklist.patch
    # Remove the subpixel test from local.conf (#12757)
    epatch ${PPREFIX}-2.2-remove_subpixel_test.patch


#  CJK font patch by firefly
     epatch ${FILESDIR}/fontconfig-2.2.1-fclang-miss_1_percent-20030617.patch
     epatch ${FILESDIR}/fontconfig-2.2.1-include_CJK_charmaps-20030626.patch
     epatch ${FILESDIR}/fontconfig-2.2.1-multifamily-20030618.patch  

    # The date can be troublesome
    sed -i "s:\`date\`::" configure
}

epatch是个eclass，它的特点就是屏蔽了patch的细节，让你无需考虑patch的参数问题。
最后直接emerge这个修改过的ebuild文件就行了。

这一部分说起来有点长，自己做一次就知道其实非常简单了。

lucida

4. 其他要注意的。。

a. emerge gentoolkit
我不知道为什么没把它作为基本系统的一部分，但是里面的qpkg工具绝对是gentoo必备的，它提供了各种对已安装package的查询，列表等功能，具体的自己man一下

b. 尽量减小编译带来的影响
新的portage系统已经引入优先级设置了，在
/etc/make.conf里面,
PORTAGE_NICENESS=10
我一般用10，这样在emerge 的时候基本没什么感觉了。这个比较适合基本系统已经完成的情况，否则可以把这个数值设成0甚至-10，然后看看滚屏，也很有成就感。

c. 只编译需要的部分
比如koffice里面包括kword, kspread, kexi, kchat等等，我不需要kword kchat，可以这样
export DO_NOT_COMPILE="kword kchat"
emerge koffice

d. 善用sudo
用visudo，我把下面的一些命令都加到/etc/sudoers里面了

lucida fancyworld=NOPASSWD: /usr/bin/emerge
lucida fancyworld=NOPASSWD: /usr/bin/ebuild
lucida fancyworld=NOPASSWD: /usr/bin/make
lucida fancyworld=NOPASSWD: /usr/bin/vi

要装软件，直接sudo emerge xxx就行，或者make, sudo make install。。。在日常操作中避免用root而又不损失方便性，sudo是个很好的解决办法。

e. 查看use变量
emerge -pv xxx

顺便说一下，ebuild被mask其实是有两个可能的
一个是ebuild文件本身
如果里面有KEYWORDS="~x86"
那么ACCEPT_KEYWORDS＝"~x86" emerge xxx就行
另外一个是/usr/portage/profiles/package.mask文件
这个列表里面的东东只能
emerge xxx.ebuild才行，或者直接修改文件，去掉黑名单

f. 多看看info
info提供的内容比man丰富的多，可以emerge pinfo，然后pinfo xxx, 它支持彩色，看起来更加舒服。或者用konqueror，试试在地址栏输入
info:/gcc

5. 一些有用的站点
http://www.breakmygentoo.net/
这里有很多软件的非官方ebuild
http://cvs.gentoo.org/~danarmak/kde-cvs.html
kde的cvs版ebuild(我一直在用的)
大概来说，在/etc/make.conf里面加上
PORTDIR_OVERLAY=/usr/local/portage
然后把下载的ebuild解压到这个目录下面就可以了
它会和正常的portage tree整合在一起，唯一的区别是emerge sync的时候，这个目录下面的内容会得以保留。

sunsolve

好！！

qing

有一[精品]...

allen1970

极好！

tram

推荐gentoo的老手新手都看看，精品啊！

liuspider

我说一下我的个人习惯

自己打 patch 时，我是不去修改 ebuild 文件的，因为下次 emerge sync 也会被覆盖掉，所以我直接使用 ebuild

ebuild /usr/portage/your/package/your.pachage.x.y.z.ebuild unpack

然后 cd 到临时目录，自己使用 patch 命令打补丁

然后再
ebuild /usr/portage/your/package/your.pachage.x.y.z.ebuild merge

就好了


关于继续上一次断掉的编译过程，除了上面提到的，还可以打开开发人员使用的 porage 的 feature, 这样就不会默认删除存在临时目录了


最后，我想如果某些软件出了新的版本，而GENTOO中还没有相应的ebuild ，而你又自己做了一个时，可以提交到 gentoo 的 bugzilla 中，这样很快新版本就会出现在portage 中的

doooom

MERGE包括UNPACK的动作,但是源码一旦展开了就条过UNPACK了.

KONQUEROR 下面可以看INFO,不错