OpenBSD Patch Branches

=================================================================== RCS file: /cvsrepo/anoncvs/cvs/www/stable.html,v retrieving revision 1.17 retrieving revision 1.18 diff -c -r1.17 -r1.18 *** www/stable.html 2006/05/01 08:44:50 1.17 --- www/stable.html 2006/05/02 18:02:36 1.18 *************** *** 3,8 **** --- 3,9 ---- OpenBSD Patch Branches + *************** *** 10,100 **** ! !

What is the patch branch?

! Starting with 2.7, OpenBSD provides a source tree that contains ! important patches and fixes (i.e. those from the ! errata plus others which are obvious and simple, ! but do not deserve an errata entry) ! and makes it available via CVS in addition to the ! current source. Thus, users can choose three options :

Stick with our latest release and apply the patches by hand. !
Use the patch branch which has the most important patches applied. !
Use current source for all of the latest features.

! ! As a general principle, all ! Errata entries will be merged into the patch ! branch within 48 hours of when an errata is published. Other post release ! patches may be merged in as well, subject to a number of conditions:

The patches must be simple, short, and obviously 100% correct. !
Errata entries are made for bugs which affect many people. Other ! patches may be merged into the patch branch if they affect a few ! people in drastic ways. !
Please do not ask for large subsystems or patches to be merged. ! Maintaining the patch tree takes a lot of effort which could be ! better spent on making our next release better. !
As an exception to the above rules, OpenSSH release versions will be ! merged into the patch branch.

Getting a stable branch

! To obtain the patch branch for a particular release of OpenBSD, you ! can update on top of a pre-existing source tree ! (from FTP or the CD) ! or you can grab the source tree freshly from ! an AnonCVS server. ! Instructions for getting the patch branch and staying up to date are ! described in the Getting Started section of the ! AnonCVS documentation. ! Note that patch branches do not help to upgrade from one release of ! OpenBSD to another, e.g. to go from 3.8 to 3.9. They only provide ! a means for staying up to date with the patches within a given release. ! If you are trying to go from one release to another via source, please visit ! the upgrade guide. ! Also, you cannot go backwards, from -current back to -stable, because of ! library versioning problems. !

Building from an OpenBSD patch branch

! Once you have obtained a source tree via anoncvs, ! you must rebuild the system. The stages for doing so are:

Rebuild the kernel !
Reboot with the new kernel !
Rebuild the binaries

Rebuilding the kernel

! To rebuild the default kernel from stable:

  # cd /usr/src/sys/arch/i386/conf
  # /usr/sbin/config GENERIC
--- 11,101 ----
  
  
  
! 
  
! 
  
! 
パッチブランチ
  
  
! 
目次
! パッチブランチとは何ですか ?
! 
パッチブランチの入手
! 
パッチブランチからの構築
  
  
  
  
  
! パッチブランチとは何ですか ?
  
  
! OpenBSD プロジェクトでは OpenBSD 2.7 以降、重要なパッチと修正
! (errata および、errata
! に含まれていないような単純で明らかなもの)
! を取り込んだソースツリーを提供するようになりました。
! これは最新のソースと同じように CVS 経由で
! 入手することができます。つまり修正パッチを利用する方法には、次の 3 種類があります。

  

! 最新のリリースを使い、手動で修正パッチを適用する。
! 
パッチブランチを利用する。これには重要な修正パッチの大部分が含まれています。
! 
最新のソースを利用する。これには最新の機能すべてが含まれています。
  
  
! 
! 一般的に、公開された
! errata はすべて、それが発行された時点から
! 48 時間以内にパッチブランチに取り込まれます。また、リリース後に作成されたその他の修正パッチも、
! たとえば次のような条件が満たされていれば同様に取り込まれることがあります。
  

! 修正パッチが単純で短く、100% 正しいことが明らかなもの。
! 
多くの人々に影響するバグによる errata の場合。あるいは
!     限られた人々に非常に大きな影響を与えるバグの修正は
!     パッチブランチに取り込まれる場合があります。
! 
大きなサブシステムや修正パッチの取り込みを要求するのはやめてください。
!     パッチブランチの保守は非常に大変な作業であり、次のリリースを
!     改善するための時間を削ることになります。
! 
ただし、OpenSSH のリリースバージョンはパッチブランチに取り込まれます。
!     これは上にあげたルールに対するひとつの例外です。
  
  
  
  
! 
パッチブランチの入手
  
  
! OpenBSD のあるリリースに対応するパッチブランチを入手するには、
! (FTP 経由、あるいは CD を使用して)
! 入手したソースツリーの一番上 (訳注: /usr/src) で更新を行うか、
! AnonCVS サーバから新たにソースツリーを入手するという方法があります。
! パッチブランチの入手と最新を維持する方法については、
! AnonCVS の文書のはじめに
! (Getting Started) の節に記載されています。ただし、
! パッチブランチはリリース間のアップグレード (たとえば 3.8 から 3.9)
! を行うわけではありませんのでご注意ください。
! これはそのリリースにおいて最新の修正パッチが適用された
! バージョンを維持する手段を提供するというだけです。
! ソースを用いてリリース間アップグレードを行う場合は
! アップグレードガイド
! をご覧ください。それともうひとつ、-current から -stable へ戻ることはできません。
! これはライブラリのバージョンに互換性がないためです。
  
  
! 
パッチブランチからの構築
! anoncvs 経由でソースツリーを入手したら、
! システムを再構築する必要があります。再構築には次の段階があります。
  
  
!  カーネルの再構築
!  
構築した新しいカーネルを使って再起動
!  
バイナリの再構築
  
  
! カーネルの再構築
  
  
! stable の標準カーネルを再構築するには、次のようにします。
  
  # cd /usr/src/sys/arch/i386/conf
  # /usr/sbin/config GENERIC
***************
*** 103,130 ****
  
  
  
! Replace i386 with your architecture, e.g.
! sparc, alpha, etc.
  
! 
Rebooting with the new kernel
  
  
! To reboot with the newly compiled kernel:
  
  # cd /usr/src/sys/arch/i386/compile/GENERIC
! # cp /bsd /bsd.old          (Save an old copy of your kernel)
! # cp bsd /bsd               (Copy the new kernel into place)
  # reboot
  
  
  
! As above, substitute your architecture for i386.  If your system has
! trouble booting the new kernel, you can easily go back and reboot from the
! old kernel, now called bsd.old.
  
! 
Rebuilding the binaries
  
!  To rebuild the system binaries:
  
  # rm -rf /usr/obj/*
  # cd /usr/src
--- 104,131 ----
  
  
  
! i386 の部分をご使用のアーキテクチャ
! (たとえば sparc、alpha など) に置き換えてください。
  
! 
構築した新しいカーネルを使って再起動
  
  
! 新しく構築したカーネルを使って再起動します。
  
  # cd /usr/src/sys/arch/i386/compile/GENERIC
! # cp /bsd /bsd.old          (古いカーネルのバックアップをとる)
! # cp bsd /bsd               (新しいカーネルを上書きコピーする)
  # reboot
  
  
  
! これも先ほどと同様に、i386 の部分をお使いのアーキテクチャに置き換えてください。
! もし、システムが新しいカーネルで起動しない場合は、bsd.old という名前の古いカーネルを
! 使用して再起動することで、元の状態に復帰することができます。
  
! 
バイナリの再構築
  
! 次のようにして、システムバイナリの再構築を行います。
  
  # rm -rf /usr/obj/*
  # cd /usr/src
***************
*** 134,144 ****
  # make build
  
  
! This will take awhile...
  

! 
  www@openbsd.org
! 
$OpenBSD: stable.html,v 1.17 2006/05/01 08:44:50 steven Exp $
  
  
- 
--- 135,151 ----
  # make build

この作業にはしばらく時間がかかるでしょう。

www@openbsd.org !
! ! ! $OpenBSD: stable.html,v 1.18 2006/05/02 18:02:36 jufi Exp $ !

Patch Branches

Table Of Contents

What is the patch branch?

Getting a stable branch

Building from an OpenBSD patch branch

Rebuilding the kernel

パッチブランチ

目次

パッチブランチとは何ですか ?

パッチブランチの入手

パッチブランチからの構築

カーネルの再構築

Rebooting with the new kernel

Rebuilding the binaries

構築した新しいカーネルを使って再起動

バイナリの再構築