[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Ports/ia64/faq.xml: 1.6 -> 1.9
以下のページの更新をしました。ツッコミをお願いします。
Ports/ia64/faq.xml: 1.6 -> 1.9
月曜日までに異議がなければ、 commit します。
以下、訳と原文の差分です。
--- Ports/ia64/faq.xml.orig 2006-04-23 19:51:18.000000000 +0900
+++ Ports/ia64/faq.xml 2006-04-23 19:51:18.000000000 +0900
@@ -5,10 +5,10 @@
<webpage id="ja-Ports-ia64-faq">
<config param="desc" value="NetBSD/ia64 よくある質問"/>
-<config param="cvstag" value="$NetBSD: faq.xml,v 1.6 2006/02/10 04:00:41 kochi Exp $"/>
+<config param="cvstag" value="$NetBSD: faq.xml,v 1.9 2006/04/20 13:35:52 kano Exp $"/>
<!-- Based on english version: -->
-<!-- NetBSD: faq.xml,v 1.6 2006/02/10 04:00:41 kochi Exp -->
-<config param="rcsdate" value="$Date: 2006/02/10 04:00:41 $"/>
+<!-- NetBSD: faq.xml,v 1.9 2006/04/20 13:35:52 kano Exp -->
+<config param="rcsdate" value="$Date: 2006/04/20 13:35:52 $"/>
<head>
<!-- Copyright (c) 2005
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
@@ -24,78 +24,134 @@
<title>何から始めればよいですか?</title>
<para>
- 執筆時点では、NetBSD/ia64 を使い始めるための手順は、
- まず HP の "SKI" エミュレーターをインストールし、
- ブートローダーとカーネルをダウンロードしてから、
- 以下のようにして SKI を起動することです:
+ NetBSD/ia64 の開発は HP の "SKI" エミュレーター上でおこないます。
</para>
<orderedlist>
<listitem>
- SKI ia64 エミュレーターは
- <ulink url="http://www.NetBSD.org/packages/emulators/ski/">pkgsrc/emulators/ski</ulink> にあります。
- また、さらなる資料も
- <ulink url="http://wiki.onetbsd.org/index.php/SkiSimulator">あります</ulink>。
+ ski エミュレーター(
+ <ulink url="http://www.NetBSD.org/packages/emulators/ski/">pkgsrc/emulators/ski</ulink>
+ ) をインストールします。NetBSD/i386 上での ski のインストールと実行についての詳細は、
+ <ulink url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/emulators/ski/DESCR">DESCR</ulink>
+ ファイルをご覧ください。
</listitem>
<listitem>
<para>
- <ulink
- url="http://cherry.beevomit.org/downloads/netbsd-anvil/">修正版の
- ソース</ulink>を入手します -- 今のところ、これは本家の
- NetBSD ソースツリーには統合されていません。
+ ia64 の toolchain を構築します。
+ <screen>
+ build.sh -mia64 tools
+ </screen>
+ </para>
+
+ <para>
+ ブートローダーを構築します。
+ <screen>
+ cd arch/ia64/stand/ia64/ski
+ $TOOLDIR/bin/nbmake-ia64
+ </screen>
+ ブートローダーのバイナリーは、arch/ia64/stand/ia64/skiload になります。
+ </para>
+
+ <para>
+ カーネルを構築します。
+ <screen>
+ build.sh -mia64 kernel=GENERIC.SKI
+ </screen>
+ カーネルのバイナリーは、arch/ia64/compile/GENERIC.SKI/netbsd になります。
</para>
</listitem>
-
+
<listitem>
<para>
- ブートローダーとカーネルの構築についての情報提供がメールでありましたが、
- これはメーリングリストのアーカイブに保存されないため、
- ここに抜粋します:
+ ブートローダーとカーネルの両バイナリー、またはそれらへのソフトリンクを
+ カレントディレクトリーに置いて、以下のようにタイプします。
+ <screen>
+ ski skiload
+ </screen>
+
+ これで、ski のデバッガープロンプトが起動します。
</para>
- <screen>
-Date: Tue, 27 Dec 2005 10:23:27 +0530
-From: Cherry G. Mathew <cherry@mahiti.org>
-To: Hubert Feyrer <hubert@feyrer.de>
-Cc: port-ia64@NetBSD.org, sunil@mahiti.org
-Subject: Re: Announce DDB:
+ <para>
+ 'c' をタイプして先に進みます。 すると、
+ 仮想ターミナルウィンドウ内でブートローダーが起動します。'boot netbsd'
+ とタイプしてカーネルをブートします。あとはお楽しみください。
+ </para>
-[...]
+ </listitem>
-修正はほとんど dev 以下に対しておこなわれているので、
-ブートローダーとカーネルを両方構築する必要があります。
+ </orderedlist>
+</sect3>
-まず、ブートローダーを構築します:
+<sect3 id="XXX1">
+<title> このポートを使い物になるようにするには、何が必要か ? </title>
-cd arch/ia64/stand/ia64/ski
-$TOOLDIR/bin/nbmake-ia64
-これにより 'skiload' という名前のバイナリーができます。これがブートローダーです。
+ <para>
+ 必須の課題:
+ </para>
-次に、カーネルを構築します。
+ <orderedlist>
+ <listitem>
+ pmap モジュール: クリーンアップとデバッグ。
+ </listitem>
+ <listitem>
+ ブートコードのクリーンアップ: FreeBSD のブートコードと NetBSD
+ のスタンドアローンのライブラリーとのグルーコードをクリーンアップする。
+ </listitem>
+ <listitem>
+ IA64 のスタック巻き戻しコード: 未対応の巻き戻し記述子型への対応。
+ ( arch/ia64/unwind/TODO 参照)
+ </listitem>
+ </orderedlist>
+
+ <para>
+ ヨサゲな課題:
+ </para>
-これは普通に、以下のようにします:
+ <orderedlist>
+ <listitem>
+ カーネルモジュールのブートローダー経由での事前読み込み。
+ </listitem>
+ <listitem>
+ ski ネットワークドライバーの作成。
+ </listitem>
+ <listitem>
+ SMP 対応の有効化。
+ </listitem>
+ </orderedlist>
+</sect3>
-build.sh -mia64 tools
-build.sh -mia64 kernel=GENERIC.SKI
+<sect3 id="XXX2">
+<title> どうすれば手伝いができるか ? </title>
-[...]
- </screen>
- </listitem>
- <listitem>
<para>
- エミュレーターの起動と NetBSD のブートについては、
- <ulink url="http://mail-index.NetBSD.org/port-ia64/2005/12/12/0001.html">このメール</ulink>
- に情報があります。
+ あなた好みの課題を選び、作業の重複を防ぐために port-ia64@NetBSD.org
+ にメールを送ってから、ハックをはじめましょう。
</para>
- </listitem>
- <listitem>
+</sect3>
+
+<sect3 id="XXX3">
+<title> このプラットフォームの移植とは何か ? </title>
+
<para>
- さらなる情報が、
- <ulink url="http://wiki.onetbsd.org/index.php/Ia64">移植プロジェクトの Wiki</ulink> にあります。
+ 現在、私たちが集中しているのは、NetBSD/ia64 を
+ ski エミュレーター上でちゃんと動くようにすることです。NetBSD を本物の
+ Itanium マシンで動作させるためには、さらにコードを書く必要があります。
+ 以下のような重要な課題があります。
</para>
- </listitem>
- </orderedlist>
+
+ <orderedlist>
+ <listitem>
+ uga コンソールドライバー。
+ </listitem>
+ <listitem>
+ bus_dma フレームワーク。
+ </listitem>
+ <listitem>
+ デバイスドライバー。
+ </listitem>
+ </orderedlist>
</sect3>
Index: Ports/ia64/faq.xml
===================================================================
RCS file: /cvsroot/htdocs/Ports/ia64/faq.xml,v
retrieving revision 1.6
retrieving revision 1.9
diff -u -r1.6 -r1.9
--- Ports/ia64/faq.xml 10 Feb 2006 04:00:41 -0000 1.6
+++ Ports/ia64/faq.xml 20 Apr 2006 13:35:52 -0000 1.9
@@ -5,8 +5,8 @@
<webpage id="Ports-ia64-faq">
<config param="desc" value="NetBSD/ia64 Frequently Asked Questions"/>
-<config param="cvstag" value="$NetBSD: faq.xml,v 1.6 2006/02/10 04:00:41 kochi Exp $"/>
-<config param="rcsdate" value="$Date: 2006/02/10 04:00:41 $"/>
+<config param="cvstag" value="$NetBSD: faq.xml,v 1.9 2006/04/20 13:35:52 kano Exp $"/>
+<config param="rcsdate" value="$Date: 2006/04/20 13:35:52 $"/>
<head>
<!-- Copyright (c) 2005
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
@@ -22,77 +22,134 @@
<title>Where to start?</title>
<para>
- As of this writing, the process to get started with NetBSD/ia64 is to
- first install HP's "SKI" emulator, then download or compile a
- bootloader and kernel, then start SKI with that:
+ Development for NetBSD/ia64 is on HP's "SKI" emulator:
</para>
<orderedlist>
<listitem>
- The SKI ia64 emulator can be found in
- <ulink url="http://www.NetBSD.org/packages/emulators/ski/">pkgsrc/emulators/ski</ulink>,
- more documentation is
- <ulink url="http://wiki.onetbsd.org/index.php/SkiSimulator">available</ulink>.
+ Install the ski emulator:
+ <ulink url="http://www.NetBSD.org/packages/emulators/ski/">pkgsrc/emulators/ski</ulink>
+ See the
+ <ulink url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/emulators/ski/DESCR">DESCR</ulink>
+ file for details about installing and running ski on NetBSD/i386.
</listitem>
<listitem>
<para>
- Get the <ulink
- url="http://cherry.beevomit.org/downloads/netbsd-anvil/">modified
- sources</ulink> -- they are currently not merged with the main
- NetBSD source tree.
+ Build the ia64 toolchain:
+ <screen>
+ build.sh -mia64 tools
+ </screen>
+ </para>
+
+ <para>
+ Build the bootloader:
+ <screen>
+ cd arch/ia64/stand/ia64/ski
+ $TOOLDIR/bin/nbmake-ia64
+ </screen>
+ The bootloader binary is arch/ia64/stand/ia64/skiload
+ </para>
+
+ <para>
+ Build the kernel:
+ <screen>
+ build.sh -mia64 kernel=GENERIC.SKI
+ </screen>
+ The kernel binary is arch/ia64/compile/GENERIC.SKI/netbsd
</para>
</listitem>
-
+
<listitem>
<para>
- Information on building the bootloader and kernel came into a
- mail that never made it to the mailing list archive, so here is
- a copy:
+ With both bootloader and kernel binaries, or softlinks to
+ them, in the current directory, type:
+ <screen>
+ ski skiload
+ </screen>
+
+ This will launch the ski debugger prompt.
</para>
- <screen>
-Date: Tue, 27 Dec 2005 10:23:27 +0530
-From: Cherry G. Mathew <cherry@mahiti.org>
-To: Hubert Feyrer <hubert@feyrer.de>
-Cc: port-ia64@NetBSD.org, sunil@mahiti.org
-Subject: Re: Announce DDB:
+ <para>
+ Type 'c' to continue. This will launch the bootloader in a
+ pseudo terminal window. Type 'boot netbsd' to boot the
+ kernel. Have fun!
+ </para>
-[...]
+ </listitem>
-Since things are pretty much in dev, yes, you need to build both the
-bootloader and the kernel.
+ </orderedlist>
+</sect3>
-You need to build the bootloader first:
+<sect3 id="XXX1">
+<title> What needs to be done, to make the port functional ? </title>
-cd arch/ia64/stand/ia64/ski
-$TOOLDIR/bin/nbmake-ia64
-will give you a binary called 'skiload' which is the bootloader.
+ <para>
+ Must have tasks:
+ </para>
-Then you need to build the kernel.
+ <orderedlist>
+ <listitem>
+ pmap module: Clean ups and debug.
+ </listitem>
+ <listitem>
+ Boot Code Cleanup: clean up glue code between FreeBSD's boot
+ code and NetBSD's standalone library.
+ </listitem>
+ <listitem>
+ IA64 Stack unwind code: Support remaining unwind descriptor
+ types. ( See: arch/ia64/unwind/TODO )
+ </listitem>
+ </orderedlist>
+
+ <para>
+ Nice to have tasks:
+ </para>
-Its the usual:
+ <orderedlist>
+ <listitem>
+ Kernel module pre-loading via the bootloader.
+ </listitem>
+ <listitem>
+ Write a ski network driver.
+ </listitem>
+ <listitem>
+ Enable SMP support.
+ </listitem>
+ </orderedlist>
+</sect3>
-build.sh -mia64 tools
-build.sh -mia64 kernel=GENERIC.SKI
+<sect3 id="XXX2">
+<title> How can I help ? </title>
-[...]
- </screen>
- </listitem>
- <listitem>
<para>
- Information about starting the emulator and booting NetBSD in it
- is
- <ulink url="http://mail-index.NetBSD.org/port-ia64/2005/12/12/0001.html">in this mail</ulink>
+ Pick a task you like, send a mail to port-ia64@NetBSD.org to
+ avoid duplication of work, and start hacking!
</para>
- </listitem>
- <listitem>
+</sect3>
+
+<sect3 id="XXX3">
+<title> What is the platform port ? </title>
+
<para>
- More information is available in
- <ulink url="http://wiki.onetbsd.org/index.php/Ia64">porting project's Wiki</ulink>.
+ Currently our focus is to enable NetBSD/ia64 to run reasonably
+ well on the ski emulator. In order to enable NetBSD to run on
+ a real Itanium machine, further code needs to be written.
+ Some important tasks are:
</para>
- </listitem>
- </orderedlist>
+
+ <orderedlist>
+ <listitem>
+ The uga console driver.
+ </listitem>
+ <listitem>
+ The bus_dma framework.
+ </listitem>
+ <listitem>
+ device drivers.
+ </listitem>
+ </orderedlist>
</sect3>