Date: Fri, 23 May 2014 11:43:07 +0000 (UTC) From: Ryusuke SUZUKI <ryusuke@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44913 - head/ja_JP.eucJP/books/handbook/cutting-edge Message-ID: <201405231143.s4NBh7X2095115@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: ryusuke Date: Fri May 23 11:43:07 2014 New Revision: 44913 URL: http://svnweb.freebsd.org/changeset/doc/44913 Log: - Merge the following from the English version: r44732 -> r44733 head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Thu May 22 23:21:27 2014 (r44912) +++ head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.xml Fri May 23 11:43:07 2014 (r44913) @@ -3,7 +3,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: r44732 + Original revision: r44733 $FreeBSD$ --> <chapter xmlns="http://docbook.org/ns/docbook" @@ -1142,7 +1142,7 @@ before running "/usr/sbin/freebsd-update <secondary>コンパイル</secondary> </indexterm> する前に <filename>/usr/src/Makefile</filename> を注意深く読み、 - <link linkend="makeworld">"world" の再構築</link> + <xref linkend="makeworld"/> に書かれている手順に従ってください。 &a.current; と <filename>/usr/src/UPDATING</filename> を読めば、 次のリリースへ向けて移ってゆくに当たって、 @@ -1257,7 +1257,7 @@ before running "/usr/sbin/freebsd-update <secondary>構築、コンパイル</secondary> </indexterm> する前に、 <filename>/usr/src/Makefile</filename> を注意深く読み、 - <link linkend="makeworld">"world" の再構築</link> + <xref linkend="makeworld"/> に書かれている手順に従ってください。 &a.stable; と <filename>/usr/src/UPDATING</filename> を読んで、 次のリリースへ向けて移ってゆくに当たって、 @@ -1341,7 +1341,7 @@ before running "/usr/sbin/freebsd-update </sect1> <sect1 xml:id="makeworld"> - <title><quote>world</quote> の再構築</title> + <title>world の再構築</title> <indexterm> <primary><quote>world</quote> の再構築</primary> @@ -1387,13 +1387,12 @@ before running "/usr/sbin/freebsd-update </step> <step> - <para>buildworld 前の必要なステップとして、 - 同期しているバージョンのソースの - <filename>/usr/src/UPDATING</filename> を読んでください。 + <para><filename>/usr/src/UPDATING</filename> を読み、 + 同期しているソースのバージョンで必要となるステップがないかどうかを調べて下さい。 このファイルには潜在的な問題や特定のコマンドを実行する順などの重要な情報が含まれています。 - 大きなアップグレードでは、nstallworld - の前に特定のファイルの名前を変更したり、削除するといった、 - 特別なステップが追加で必要となることがあります。 + 大きなアップグレードでは、world + をインストールする前に特定のファイルの名前を変更したり、 + 削除するといった、特別なステップが追加で必要となることがあります。 ファイルの最後には、 現在推奨されているアップグレードの手順が詳しく正確に説明されています。 もし、<filename>UPDATING</filename> に書かれている手順が、 @@ -1492,14 +1491,27 @@ before running "/usr/sbin/freebsd-update <step> <para>コンパイラとカーネルのミスマッチを防ぐため、 <filename class="directory">/usr/obj</filename> - にある新しいコンパイラを用いて新しいカーネルを構築します。</para> + にある新しいコンパイラを用いて新しいカーネルを構築します。 + 再構築は、ある種のメモリ構造体が変更されたような場合には必須で、 + <command>ps</command> や <command>top</command> + のようなプログラムは、 + カーネルとソースコードのバージョンが一致しないと正常に動作しないでしょう。</para> <screen>&prompt.root; <userinput>make buildkernel</userinput></screen> </step> <step> <para>新しくアップデートされたカーネルで起動できるように、 - 新しいカーネルとカーネルモジュールをディスク上に配置します。</para> + 新しいカーネルとカーネルモジュールをディスク上に配置します。 + <varname>kern.securelevel</varname> を 1 より大きくしていて、 + <emphasis>かつ</emphasis> カーネルのバイナリファイルに + <literal>noschg</literal> のようなフラグを設定している場合は、 + まず、シングルユーザモードに移行してください。 + それ以外の場合は、 + マルチユーザモードでこれらのコマンドを問題なく動かせるはずです。 + <varname>kern.securelevel</varname> について詳しくは + &man.init.8; を、ファイルに対するさまざまなフラグについて詳しくは + &man.chflags.1; をご覧ください。</para> <screen>&prompt.root; <userinput>make installkernel</userinput></screen> </step> @@ -1539,7 +1551,13 @@ before running "/usr/sbin/freebsd-update </step> <step> - <para>次に、新しい world + <para>システムの再構築では、 + <filename>/etc</filename>, + <filename>/var</filename> や + <filename>/usr</filename> + といったディレクトリに新規に導入されたファイルや、 + 変更された設定ファイルに対する更新は行なわれません。 + 次に、新しい world に対する <filename class="directory">/etc</filename> の最初の設定ファイルのアップデートを行います。 以下のコマンドは @@ -1548,14 +1566,17 @@ before running "/usr/sbin/freebsd-update たとえば、 このステップでは、最後のアップデート後に &os; に追加された、 新しいグループや新しいシステムアカウント、 - もしくはスタートアップスクリプトがシステムに追加されることがあります。</para> + もしくはスタートアップスクリプトがシステムに追加されることがあります。 + 次のコマンドに関する詳細な情報については、 + <xref linkend="mergemaster"/> を参照してください。</para> <screen>&prompt.root; <userinput>mergemaster -iF</userinput></screen> </step> <step> <para><filename class="directory">/usr/obj</filename> - にある新しい world をインストールします。</para> + にある新しい world + およびシステムのバイナリをインストールします。</para> <screen>&prompt.root; <userinput>cd /usr/src</userinput> &prompt.root; <userinput>make installworld</userinput></screen> @@ -1614,21 +1635,20 @@ before running "/usr/sbin/freebsd-update <primary><filename>make.conf</filename></primary> </indexterm> - <para>この節では world - の構築のプロセスで使われるコンフィグレーションファイルについて説明します。</para> + <para>world + の構築プロセスでは、いくつかの設定ファイルが使われます。</para> - <para>&man.make.1; で利用可能なオプションの説明は &man.make.conf.5; や、 - 共通の例が + <para><command>make</command> で利用可能なオプションの説明は + &man.make.conf.5; や、共通の例が <filename>/usr/share/examples/etc/make.conf</filename> にあります。 これらの設定を <filename>/etc/make.conf</filename> に追加すると、 - &man.make.1; の実行やプログラムの構築方法を設定できます。 + <command>make</command> の実行やプログラムの構築方法を設定できます。 これらのオプションは、 - &man.make.1; が使われる際には常に有効となるため、 + <command>make</command> が使われる際には常に有効となるため、 Ports Collection からアプリケーションをコンパイルする時、 ユーザが書いた C プログラムや &os; - オペレーティングシステムを構築する際に影響を及ぼします。</para> - - <para>ある設定を変更したことにより、影響が広い範囲におよび、 + オペレーティングシステムを構築する際に影響を及ぼします。 + ある設定を変更したことにより、影響が広い範囲におよび、 驚くべき結果をもたらす可能性があります。 両方のファイルに書かれているコメントを読むことと、 デフォルトの設定は、パフォーマンスと安全性の観点から選ばれていることを覚えておいてください。</para> @@ -1808,69 +1828,6 @@ Script done, …</screen> トリックや近道を使わずに普通に構築した場合、&os.stable; の構築には 1, 2 時間しかかからないでしょう。 &os.current; の構築は、もう少し時間がかかります。</para> - </sect2> - - <sect2 xml:id="new-kernel"> - <title>新しいカーネルの構築とインストール</title> - <indexterm> - <primary>カーネル (kernel)</primary> - <secondary>構築、コンパイル</secondary> - </indexterm> - - <para>新しいシステムの全機能を完全に利用できるようにするには、 - カーネルを再構築してください。 - 再構築は、ある種のメモリ構造体が変更された時には特に必須であり、 - &man.ps.1; や &man.top.1; のようなプログラムは、 - カーネルとソースコードのバージョンが一致しないと正常に動作しないでしょう。</para> - - <para>最も簡単で安全にカーネルの再構築を行なう方法は、 - <filename>GENERIC</filename> - を使ったカーネルを構築・インストールすることです。 - <filename>GENERIC</filename> - にはあなたが必要とするデバイスがすべて含まれていないかも知れませんが、 - あなたのシステムをシングルユーザモードで - 起動させるのに必要なものはすべて入っています。 - これは新しいバージョンのシステムがきちんと動作するかどうか調べる良い方法の一つです。 - <filename>GENERIC</filename> で起動して、 - システムが正常に動作しているかどうかを確かめたら、 - カスタムカーネルコンフィグレーションファイルを使って新しいカーネルを構築してください。</para> - - <para>&os; では、新しいカーネルを構築する前に <link linkend="make-buildworld">build world</link> を行うことが重要です。</para> - - <note> - <para>既にあるコンフィグレーションファイルを使ってカスタムカーネルを構築するには、 - <literal>KERNCONF=<replaceable>MYKERNEL</replaceable></literal> - を使ってください。</para> - - <screen>&prompt.root; <userinput>cd /usr/src</userinput> -&prompt.root; <userinput>make buildkernel KERNCONF=<replaceable>MYKERNEL</replaceable></userinput> -&prompt.root; <userinput>make installkernel KERNCONF=<replaceable>MYKERNEL</replaceable></userinput></screen> - - </note> - - <para><literal>kern.securelevel</literal> を 1 より大きくしていて、 - <emphasis>かつ</emphasis> カーネルのバイナリファイルに - <literal>noschg</literal> のようなフラグを設定している場合は、 - <buildtarget>installkernel</buildtarget> - を行うのにシングルユーザモードに移行してください。 - それ以外の場合は、 - マルチユーザモードでこれらのコマンドを問題なく動かせるはずです。 - <literal>kern.securelevel</literal> について詳しくは - &man.init.8; を、ファイルの様々なフラグについて詳しくは - &man.chflags.1; をご覧ください。</para> - - <para>新しいカーネルが動作するかどうかテストするために、 - シングルユーザモードで再起動してください。</para> - </sect2> - - <sect2 xml:id="make-installworld"> - <title>新しいシステムバイナリのインストール</title> - - <para>次に、<buildtarget>installworld</buildtarget> - を使って新しいシステムバイナリのインストールを行ないます。</para> - - <screen>&prompt.root; <userinput>cd /usr/src</userinput> -&prompt.root; <userinput>make installworld</userinput></screen> <note> <para><command>make buildworld</command> @@ -1893,24 +1850,9 @@ Script done, …</screen> </note> </sect2> - <sect2 xml:id="post-installworld-updates"> - <title><command>make installworld</command> で更新されないファイルの更新</title> - - <para>システムの再構築は、いくつかのディレクトリ、 - 特に、<filename>/etc</filename> や - <filename>/var</filename> や - <filename>/usr</filename> において、 - 新規に導入されたり、変更された設定ファイルによる - ファイルの更新は行なわれません。</para> - - <para>これらのディレクトリのファイルを更新するもっとも簡単な方法は、 - &man.mergemaster.8; を使うことです。 - 必ず <filename>/etc</filename> - のバックアップを取って不測の事態に備えてください。</para> - - <sect3 xml:id="mergemaster"> + <sect2 xml:id="mergemaster"> <info> - <title><command>mergemaster</command></title> + <title>設定ファイルの同期</title> <authorgroup> <author> @@ -1991,10 +1933,6 @@ Script done, …</screen> &man.mergemaster.8; が、パスワードファイルを再構築するかどうかを尋ねることがあります。 最後に残った一時ファイルを削除するかどうかを尋ねて終了します。</para> - </sect3> - - <sect3> - <title>手動での更新</title> <para>手動で更新する場合には、単にファイルを <filename>/usr/src/etc</filename> @@ -2154,7 +2092,6 @@ Script done, …</screen> <screen>&prompt.root; <userinput>mkdir /var/tmp/root-`date "+%Y%m%d"`</userinput></screen> </tip> - </sect3> </sect2> <sect2 xml:id="make-delete-old">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201405231143.s4NBh7X2095115>