Special instruction challenge チュートリアル

Special instruction challenge チュートリアル
(環境構築)

■ 環境構築

(多種アーキテクチャの開発環境の構築)

Debian環境などに，自前でインストールする場合
※ 競技サーバのＶＭイメージ(Debianベースです)を流用して，競技サーバ上に以下のようにして開発環境を構築して，サーバ内で閉じて検証することも可能です

http://kozos.jp/books/asm/gcc494.html の cross-gcc494-v1.0.zip をインストールしてください．
競技サーバのＶＭイメージを流用する場合は，以下にcross-gcc494-v1.0.zipがあります．
```
/home/user/archive/cross-gcc494-v1.0.zip
```

必要なアーキテクチャは，以下の10個です．

bfin-elf msp430-elf mn10300-elf v850-elf mips64-elf
arm-elf rl78-elf microblaze-elf mips-elf aarch64-elf

手順の概略

$ su
Password:
# mkdir /usr/local/cross-gcc494
# chmod 777 /usr/local/cross-gcc494
# exit

$ mkdir ~/cross
$ cd ~/cross
$ unzip ~/cross-gcc494-v1.0.zip
$ cd cross-gcc494
$ vi config.sh (コア数に応じて makeopt のオプションを調整・有効化するとビルドが高速になる)
$ cd toolchain

(競技サーバのＶＭイメージを流用する場合には，ここで以下をしておくことでダウンロード負荷を削減できます)
$ mkdir orig ; cp /home/user/archive/*.tar.* orig

(ファイルの取得とチェックサム確認を行う．ダウンロード済でもチェックサム確認のために実施要)
$ ./fetch.sh
(ファイルのチェックサムが一致していることを確認)
$ ./setup.sh
$ cd ../build

(gdbとエミュレータのみをビルド／インストールする場合)(通常はこちらで十分です)
$ cd gdb
$ ./all.sh -build -install bfin-elf msp430-elf mn10300-elf v850-elf mips64-elf arm-elf rl78-elf microblaze-elf mips-elf aarch64-elf

(フルセット環境をビルド／インストールする場合)(gccなどの開発環境もビルドされますが時間がかかります)
$ ./setup-all.sh
$ ./build-install-all.sh bfin-elf msp430-elf mn10300-elf v850-elf mips64-elf arm-elf rl78-elf microblaze-elf mips-elf aarch64-elf

→ /usr/local/cross-gcc494 にインストールされます

開発環境が構築済みのＶＭイメージを利用する場合
- http://kozos.jp/vmimage/burning-asm.html の cross2-gcc494-Debian8.ova をＶＭ環境にインポートして利用してください

(競技サーバの準備)

VirtualBoxなどのＶＭ環境をインストールし，競技サーバのＶＭイメージをインポートしてください
(競技サーバのＶＭイメージ)
http://kozos.jp/vmimage/seccon.html

(runme.xを実行できる環境の構築)

Debian環境などに，自前でインストールする場合
- http://kozos.jp/seccon/seccon2018.html の「サーバ構成ファイル一式」(server.zip)に含まれている，cross-gcc494 を利用して開発環境をビルドしてください．
  ビルド方法は cross-gcc494-v1.0.zip と同様ですが，こちらには特殊命令の対応パッチが入っています．
  インストール先は /home/user/tools になっています．
競技サーバのＶＭイメージを流用する場合
- 競技サーバ内に，ビルド済みの実行環境がインストールされています (/home/user/tools にインストール済みです)．
  競技サーバを流用する，もしくは競技サーバのＶＭイメージを別途インポートして runme.xの実行専用として使うなど，適宜工夫してください．

(競技サーバのパスワード変更)

競技サーバのデフォルトのパスワードは推測しやすい簡単なものです．
ネットワークに接続すると，SSHでログイン可能です．

ネットワークへの接続前に，パスワード変更をしておいてください．

競技サーバのＶＭを起動すると，以下でログインできます．

Login:user / Password:progtooluser
Login:root / Password:progtoolroot

以下でパスワード変更できます．

# passwd user (userのパスワードの変更)
# passwd root (rootのパスワードの変更)

またSSHでのログインが不要ならば，そもそもSSHサーバは無効化しておいたり， 22番ポートをフィルタリングしておいたほうがいいでしょう．

(ネットワークの接続)

ネットワークの設定を調整して，開発環境が構築してあるＰＣ(もしくはＶＭ)から競技サーバまで，ネットワークで接続してください．

競技サーバでは，ネットワーク経由でデバッガで接続して自由に操作できるプログラムが動作します．
また，デフォルトのパスワードは推測しやすい簡単なものです．
ネットワーク上で動作させる場合，不正にアクセスされないように十分に留意してください．

競技サーバのＶＭは，ネットワークはNATの設定になっており，以下のポートフォワーディングの設定がされています．適宜，調整してください．

127.0.0.1:10080→80 (競技のインフォメーションページ)
127.0.0.1:20022→22 (管理用SSH)
127.0.0.1:9999→9999 (チームフラッグのコミット用ポート)
127.0.0.1:10000→10000 (デバッガ(GDB)による接続用ポート)
127.0.0.1:10001→10001
127.0.0.1:10002→10002
127.0.0.1:10003→10003
127.0.0.1:10004→10004

■ 動作パラメータの調整

競技サーバのＶＭを起動してください．

実験のために動作パラメータを調整したり，各種リミットを解除したい場合には，競技サーバにログインし，以下を参考にしてリミット解除をしておいてください．

とくに，デバッガの通信量上限(size-connect.txt)の解除と接続時間(run.sh)の拡張はしておかないと，この後デバッガで試すことがあまりうまくできなかったりするので注意してください．

http://kozos.jp/seccon/seccon2018.html

※ 修正後の反映にリブートが必要かどうかは，上の説明を参照してください．