[unitrace] clarify installation artifacts and locations

オープン
#124 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
20/100
issue の種類
リファクタリング
明瞭さ
おおむね明確
活発さ
活発
技術スタック
linux, ubuntu

調査の方向性

The layout to change is the install tree in the issue: bin/summary/ (including schemas/), etc/unitrace/metrics/config/, lib/libunitrace_tool.so, and the bin/addrasm.py, analyzeperfmetrics.py and mergetrace.py scripts. Find where the install step places these files in the repository's build or packaging scripts. Done means the maintainers have answered the four questions and the agreed paths are applied, so this needs a maintainer decision before any code change.

索引モデルが issue の本文から書いたものです。

説明

On:

Below are unitrace installation artifacts:

/opt/install/
|-- bin
|   |-- addrasm.py
|   |-- analyzeperfmetrics.py
|   |-- mergetrace.py
|   |-- summary
|   |   |-- categorize.py
|   |   |-- schemas
|   |   |   |-- LLaMA.ini
|   |   |   `-- LLaMA.json
|   |   `-- summary.py
|   |-- unitrace
|   `-- uniview.py
|-- etc
|   `-- unitrace
|       `-- metrics
|           `-- config
|               |-- bmg
|               |   |-- ComputeBasic.txt
|               |   `-- MemoryProfile.txt
|               `-- pvc
|                   |-- ComputeBasic.txt
|                   |-- GpuOffload.txt
|                   |-- L1ProfileReads.txt
|                   |-- L1ProfileSlmBankConflicts.txt
|                   |-- L1ProfileWrites.txt
|                   `-- MemProfile.txt
`-- lib
    `-- libunitrace_tool.so

11 directories, 18 files

I have concerns that above layout will be acceptable to package unitrace for Linux distribution packaging:

  1. Some stuff installed into /usr/bin/ have too wide names without clear affiliation to unitrace. These are addrasm.py, analyzeperfmetrics.py, mergetrace.py. I would consider renaming them with some some kind of uni* prefix.
  2. What is the purpose of libunitrace_tool.so? It does not have associated development environment (header files) and there seem to be only one actual executable - unitrace. So why the library needs to be dynamic?
  3. Does user supposed to modify stuff landed in /etc/unitrace/metrics/config/? If yes - these are indeed configuration files. If not - then these are unitrace internal stuff and should be moved to /usr/lib/unitrace/ folder.
  4. /usr/bin/summary/* - this location is definitely not correct. This must be moved to /usr/lib/unitrace/

@androniychuk, do you have any other questions/comments for the above unitrace installation artifacts?

CC: @mschilling0

主要言語
C++
スター
278
フォーク
74
PR マージ指標
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

intel/pti-gpu のほかの issue

intel/pti-gpu の issue をすべて見る

似ている issue

C++ の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。