
	TraceLogVisualizer(TLV)（バージョン 2.0.1）

					最終更新 : 2013年05月11日

----------------------------------------------------------------------
 TraceLogVisualizer(TLV)

 Copyright (C) 2008-2011 Nagoya University, JAPAN
 
 上記著作権者は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
 ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
 変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
 (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
     権表示，この利用条件および下記の無保証規定が，そのままの形でソー
     スコード中に含まれていること．
 (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
     用できる形で再配布する場合には，再配布に伴うドキュメント（利用
     者マニュアルなど）に，上記の著作権表示，この利用条件および下記
     の無保証規定を掲載すること．
 (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
     用できない形で再配布する場合には，次のいずれかの条件を満たすこ
     と．
   (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
       作権表示，この利用条件および下記の無保証規定を掲載すること．
   (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
       報告すること．
 (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
     害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
     また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
     由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
     免責すること．

 本ソフトウェアは，無保証で提供されているものである．上記著作権者お
 よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
 に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
 アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
 の責任を負わない．

 ----------------------------------------------------------------------

TraceLogVisualizer（以下，TLV)は，各種のログを可視化するWindowsアプリケー
ションである．TLVの大部分は，文部科学省 先導的ITスペシャリスト育成推進
プログラム『OJL(On-the-Job Learning)による最先端技術適応能力を持つIT 人
材育成拠点形成』の一環で，名古屋大学を中心に開発したものである．

【ドキュメント】

TLVの使用方法や変換ルール・可視化ルールに関するマニュアルが，doc にあ
る．内容はまだ限定的であるため，今後充実させる予定である．

  ・TLV.pdf                   
     TLVマニュアル

  ・TLV_convert_rules.pdf
     TOPPERS/ASPカーネルのトレースログの標準形式トレースログへの変換ルール例

  ・TLV_visualize_rules.pdf
     TOPPERS/ASPカーネル標準トレースログの可視化変換ルール例

【サポートするログ形式】

TLVは，変換ルールや可視化ルールを要することにより，各種のログを可視化
することが可能である．標準では，以下のログに対する変換ルールと可視化ル
ールが含まれている．

 ・TOPPERS/ASPカーネルのトレースログ
 ・TOPPERS/FMPカーネルのトレースログ
 ・TECSのトレースログ

TOPPERS/ASPカーネルのトレースログを取得するためのルーチンは，
logtrace/asp に，TOPPERS/FMPカーネルのトレースログを取得するためのルー
チンは，logtrace/fmpにある．使用方法はTLVマニュアルを参照のこと．

【ソースコードのビルド環境】

以下の環境を，ソースコードの標準的なビルド環境として用いている．

	Microsoft Visual Studio 2010 Professional

※多くの警告が出力されるが，無償版（Visual Studio 2010 Express）でもビ
ルドは可能である．

【利用条件】

TLVの利用条件は，各ファイルの先頭に表示されているTOPPERSライセンスです．
TOPPERSライセンスに関するFAQが，以下のページにあります．

	http://www.toppers.jp/faq/faq_ct12.html

【現状分かっている問題点】

・【ASP/FMP】多重割込みのサポート
  多重割込みが入ると，システムコールの発行元の割込みハンドラが正しく表
  示されないという問題がある．

・変換・可視化ルールのマニュアル
  現状，変換・可視化ルールのマニュアルは存在しない．今後整備していく予
  定である．

・アプリログのスペースが無視される
　　例えばアプリログ機能によって"XXX Start" という文字列を表示させたくても，
　　TLV上では "XXXStart" というようにスペースが無視されて表示される．
　　スペース無視は仕様としてマニュアルに記載する予定．

・時刻0から始まるイベントを含むログの可視化に失敗する
　　時刻0〜時刻x まで続くようなイベントが存在している場合，可視に失敗する．

・丸括弧"(",")"のネストを含む標準形式トレースログの可視化に失敗する
　　変換ルール・可視化ルールマニュアル(doc/rule-manual.pdf)には
  対応している記述がなされているが，現状では正しく可視化できない．

【質問・バグレポート・意見等の送付先】

TLVをより良いものにするためのご意見等を歓迎します．
TLVに関する質問やバグレポート，ご意見等は，
tlv＠nces.is.nagoya-u.ac.jp 宛にお送り下さい．
（＠は@に置き換えて下さい）

【公式サイト】

    http://www.toppers.jp/tlv.html

【ファイル構成】

	CANGELOG.txt				変更点のリスト
	README.txt					TLVの簡単な紹介
	TraceLogVisualizer.exe		TLVの本体

	doc/
		TLV.pdf					TLV本体のマニュアル
		TLV_convert_rules.pdf	変換ルールのマニュアル
		TLV_visualize_rules.pdf	可視化ルールのマニュアル

	convertRules/
		asp.cnv					TOPPERS/ASPカーネルの変換ルール
		fmp.cnv					TOPPERS/FMPカーネルの変換ルール
		fmp_mig.cnv				TOPPERS/FMPカーネルの変換ルール（プロセッサ毎）
		tecs.cnv				TECSの変換ルール

	resourceHeaders/
		asp.resh				TOPPERS/ASPカーネルのリソースファイル
		fmp.resh				TOPPERS/FMPカーネルのリソースファイル
		tecs.resh				TECSのリソースファイル

	visualizeRules/
		asp_rules.viz			TOPPERS/ASPカーネルの可視化ルール
		asp_shapes.viz			TOPPERS/ASPカーネルの図形定義
		fmp_rules.viz			TOPPERS/FMPカーネルの可視化ルール
		fmp_shapes.viz			TOPPERS/FMPカーネルの図形定義
		fmp_mig_rules.viz		TOPPERS/FMPカーネルの可視化ルール（プロセッサ毎）
		fmp_mig_shapes.viz		TOPPERS/FMPカーネルの図形定義（プロセッサ毎）
		tecs.viz				TECSの可視化ルール
		toppers_rules.viz		TOPPERS共通の可視化ルール
		toppers_shapes.viz		TOPPERS共通の図形定義

	sampleFiles/
		asp/					TOPPERS/ASPカーネルのトレースログのサンプル
			asp_short.log
			asp_short.res
			asp_short.tlv
			asp_long.log
			asp_long.res
			asp_long.tlv

		fmp/					TOPPERS/FMPカーネルのトレースログのサンプル
			fmp_short.log
			fmp_short.res
			fmp_short.tlv
			fmp_long.log
			fmp_long.res
			fmp_long.tlv

		fmp_mig/				TOPPERS/FMPカーネルのトレースログのサンプル
									（プロセッサ毎のタスク表示）
			fmp_short.log
			fmp_mig.res
			fmp_mig.tlv

		tecs/					TECSのトレースログのサンプル
			tecs.log
			tecs.res
			tecs.tlv

	logtrace/
		asp/					TOPPERS/ASPカーネルのログトレースモジュール
			kernel_fncode.h
			tlv.tf
			trace_config.c
			trace_config.h
			trace_dump.c
		fmp/					TOPPERS/FMPカーネルのログトレースモジュール
			tlv.tf
		fmp_mig/				TOPPERS/FMPカーネルのログトレースモジュール
									（プロセッサ毎のタスク表示）
			tlv.tf

【バージョン履歴】

	2009年05月13日	Release	1.0rc1		TOPPERS会員向け早期リリース
	2009年10月01日	Release	1.1rc		TOPPERS会員向け早期リリース
	2009年10月26日	Release	1.1rc2		TOPPERS会員向け早期リリース
	2009年11月16日	Release	1.1			一般向けリリース
	2010年04月06日	Release	1.1.1
	2010年04月15日	Release	1.1.2
	2010年08月06日	Release	1.2			機能追加
	2010年11月30日	Release	1.3rc		機能追加
	2011年03月10日	Release 1.3			リファクタリング
	2011年05月22日	Release 2.0rc		機能追加,.NET Framework4.0への移行
	2012年03月23日	Release 2.0       
	2013年05月11日	Release 2.0.1		バグフィックス

以上．
