Changeset 34 for SimpleSample/trunk/README.txt

Timestamp:

Jun 24, 2012, 7:42:09 PM (11 years ago)

Author:

okuma-top

Message:

totally brush up

File:

• SimpleSample/trunk/README.txt (modified) (9 diffs)

SimpleSample/trunk/README.txt

@@ -1 @@
-Simple な Sample
+TECS の Simple な Sample
 
                                                                                 2012年 6月17日
@@ -9 +9 @@
 
 【概要】
+
 TECS のもっとも単純なサンプルです。 exerb 版の TECS ジェネレータと 
-cygwin 版の gcc だけで動作します。
-
-cygwin 上で pthread を用いた tTask 等のセルタイプを用意していますが、
-あくまでテスト用であり、完成度はもう一歩です。いろいろ変更して試そうと
-すると、期待した動作にならない可能性が高いのでご注意ください。
+cygwin 版の gcc だけで動作します。Linux などの POSIX 環境でも動作しま
+す。
+exerb 版で動作しますので、Ruby や racc のインストールする必要がありま
+せん。
 
 【動作環境】
 
-cygwin 上でビルドし動作します。Linux などで動作させるときは Makefile 
-の TECSGEN を tecsgen.exe から tecsgen に変更してください。
+cygwin 上でビルドし動作します。2012.6.2 に発行された tecs_package
+(TECS ジェネレータ V1.1.0.4 を同梱) を用いてください。exerb 版を用いる
+ようになっているため、Ruby インタープリターは不要です。
 
-【使用方法】
+   exerb 版とは ruby インタプリタと TECS ジェネレータが一体の exe 化さ
+   れたもので、ruby インタプリタのインストールを必要としません。
+
+Linux などの POSIX 環境でも動作させることができます。その場合 Makefile 
+の TECSGEN_EXE を tecsgen.exe から tecsgen に変更してください。Ruby
+1.8 がインストールされている必要があります。Ruby 1.9 には対応しません。
+
+【準備】
 
 1) ファイルの展開
 
  tecs_package ディレクトリの直下 asp+tecs, tecsgen の並びに 
- SimpleSample を置いてください。exerb 版
+ SimpleSample を置いてください。exerb 版を用いる都合上、tecsgen コマン
+ ド引数に与えるパスは、すべて相対パスで指定しています。
 
   tecs_package-+- asp+tecs
@@ -33 +42 @@
                |
                +- SimpleSample -+- SimpleSample
-                                 (※)       |
-                                                                +- SimpleSampleOpaqueRPC
-                                            |
-                                                                +- SimpleSampleTransparentRPC
+                     (※)       |
+                                +- SimpleSampleTrace
+                                |
+                                +- SimpleSampleOpaqueRPC
+                                |
+                                +- SimpleSampleTransparentRPC
 
-  svn の trunk のディレクトリの位置に対応します。名前は変更しても構いません。
+※ svn の trunk のディレクトリの位置に対応します。名前は変更しても構いません。
 
-2) 準備
+2) パスの設定
 
- cygwin コンソールを開き、以下のような方法で set_env.sh ないの PATH 等
- を取り込みます。
+ cygwin コンソールを開き、以下のような方法で set_env.sh 内の PATH 等を
+ 取り込みます。
 
   % cd tecs_package/tecsgen
@@ -49 +60 @@
 
   exerb 版を使用するため、TECS ジェネレータのビルドは不要です。
+
+【ビルドと実行】
 
 3) 直接結合版のビルドと実行
@@ -62 +75 @@
   % ./SimpleSample.exe
 
-・trace ありのビルド
+4) 直接結合の TracePlugin あり版のビルドと実行
 
-  % cd tecs_package/SimpleSample/SimpleSample
-  % make tecs -f Makefile-trace
-  % make all -f Makefile-trace
+  % cd tecs_package/SimpleSample/SimpleSampleTrace
+  % make tecs
+  % make all
 
 ・実行
 
-  % ./SimpleSample-trace.exe
+  % ./SimpleSample.exe
 
-4) transparent RPC 版のビルドと実行
+5) transparent RPC 版のビルドと実行
 
 ・ビルド
@@ -88 +101 @@
   わかりにくいですが、Simple と Sample は異なるタスクで実行されています。
 
-4) transparent RPC 版のビルドと実行
+6) opaque RPC 版のビルドと実行
 
 ・ビルド
@@ -103 +116 @@
   % ./rSample/SimpleSample-rSample.exe
 
- 2 つ目のコンソールでクライアント側を起動します。
+ 次に 2 つ目のコンソールでクライアント側を起動します。
 
   % cd tecs_package/SimpleSample/SimpleSampleOpaqueRPC
@@ -113 +126 @@
  が、これは out 引数で返されたものを表示しているためです。
 
-重要なことは、tSimple.c, tSample.c は、まったく無変更で 4 つのパターンに
-対応しています。簡単に再利用が図られることがわかります。
+【ポイント】
+
+ポイントは、各 CDL 内の tSimple, tSample の定義、セルタイプコード 
+tSimple.c, tSample.c は、まったく無変更で 4 つのパターンに対応している
+ことです。再利用が図られることがわかります。
 
 【次のステップ】
@@ -123 +139 @@
    まずは、これの手順を理解しましょう。
 
+ ・もう一組インスタンスを設ける
 
+【cygwin_kernel について】
+
+cygwin 上で pthread を用いた tTask 等のセルタイプを用意していますが、
+テストドライバーまたはスタブであり、ほとんど機能は備わっていません。
+