d88dmp 0.14.0

*.D88 file dump tool.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

d88dmp
=======
![](https://github.com/ORYZAPAO/d88dmp/workflows/Rust/badge.svg)
[![CircleCI](https://circleci.com/gh/ORYZAPAO/d88dmp/tree/main.svg?style=svg)](https://circleci.com/gh/ORYZAPAO/d88dmp/tree/main)

[English](/d88dmp/README.md)

はじめに
--------

日本のレトロPCエミュレータ用のディスクイメージ形式*.d88形式のファイルを、byte単位でテキストでダンプするツールです。  
d88ファイル解析およびRust勉強用として、個人的に作成したものです。  

出力内容
--------

下記情報を表示します。  
--summaryオプションをつけると、サマリ情報を表示します。  
### ディスクヘッダ情報
  + ディスク名
  + ライトプロテクトの有無
  + ディスクの種類(2D/2DD/2HD)
  + ディスクサイズ(byte単位)
### 各トラックへのオフセットテーブル
  + ![example](https://github.com/ORYZAPAO/d88dmp/blob/main/image/d88dmp_track_offset.png?raw=true)
### セクタヘッダ情報
  + シリンダ番号(0開始〜)
  + サイド情報(0:表、1:裏) 
  + セクタ番号(1開始〜) 
  + セクタサイズ(byte単位)
  + トラック中のセクタ数
  + 記録密度(単密度/倍密度/高密度)
  + 削除フラグ
  + ステータス
  + セクタのデータサイズ(byte単位)
    + セクタ情報のサマリ  
      + ![example](https://github.com/ORYZAPAO/d88dmp/blob/main/image/d88dmp_sector_summary.png?raw=true)
### セクタのデータ
  + データをbyte単位でダンプ  
    + ![example](https://github.com/ORYZAPAO/d88dmp/blob/main/image/d88dmp_row_data.png?raw=true)


インストール方法
---------------------
rustのcargoコマンドから
```
cargo install d88dmp
```

動作環境/Download
------------
--> ![Download](https://github.com/ORYZAPAO/d88dmp/releases)

開発はLinux環境メイン（+ MacOS(Intel)、64bit版Windows10）で行っています。  
他の環境では試していません。

使い方
------
基本的な使い方は、コマンドライン等からD88形式のファイル名を指定するだけ。
```
 $ d88dmp <D88形式のファイル名>
```

## usage 
```
d88dmp ver 0.14.0
ORYZA (https://github.com/ORYZAPAO)
D88 Disk Image Dump.

USAGE:
    d88dmp [OPTIONS] <*.D88>

ARGS:
    <*.D88>    D88 Disk Image

OPTIONS:
    -h, --help
            Print help information      ヘルプメッセージ

    -n, --no-info
            No information              ディスクやセクタのヘッダ情報を表示しない

        --no-color
            No color                    カラー表示の無効化

    -p, --position <TRACK,SIDE,SECTOR>  特定のセクタを表示
            Sector position
              <TRACK>  0,1,2, ...         トラック番号   0,1,2, ... (0スタート)
              <SIDE>   0:front or 1:back  ディスクサイド 0:表, 1:裏 
              <SECTOR> 1,2,3, ...         セクタ番号     1,2,3, ... (1スタート)

    -s, --sort                          セクタ番号順に表示(セクタ番号順に記録されていない場合)
            Sort by disk sector order

        --summary
            Summary only                サマリのみ表示（データのダンプリストは表示しない）

    -v, --verbose
            Verbose report              詳細表示（サマリ、データのダンプリストを表示）

    -V, --version
            Print version information   バージョン情報
```

実行例）X1 turbo用のturbo CP/Mでファーマットしたディスクイメージ(CPM_data.d88)を表示  

```
$ .\d88dmp sample/CPM_Format_2D_turboCPM_X1turbo.d88
```

ビルド、コンパイル方法
---------------------

ソースコードからのコンパイルは [Rust](https://www.rust-lang.org) が必要です。  
GitHub から git clone したあと、ビルド方法は普通にcargoコマンドを叩くだけです。  
```d
$ git clone git@github.com:ORYZAPAO/d88dmp.git
$ cargo build --release
```

ライセンス
----------
 MIT Licens

更新履歴
----------
+ [更新履歴](CHANGELOG.md)

参考情報
---------------------

開発にあたり、こちらの情報を参考にさせていただきました。

+ [.D88形式のフロッピーディスクイメージフォーマット - （仮）](https://gra4.hatenadiary.jp/entry/20171108/1510096429)
+ [D88形式フォーマット | HuDisk](https://boukichi.github.io/HuDisk/DISK.html)
+ [wii88/FORMAT.TXT at master · jpzm/wii88](https://github.com/jpzm/wii88/blob/master/document/FORMAT.TXT)