Shell のコマンド¶
Shell は Family mruby のコマンドラインです。ランチャー、デスクトップのアイコン、または
デスクトップで S を押して開きます。help で、その端末で使えるコマンドの一覧が出ます。
(開発版) と書いたコマンドは開発ブランチ (と スタジオ) にあり、3.0.0 には ありません。
操作¶
| キー | 働き |
|---|---|
Tab |
ファイル名・ディレクトリ名を補完します |
↑ / ↓ |
前に打った行・次の行 |
PgUp / PgDn、マウスのホイール |
出力をさかのぼって見ます |
Ctrl + C |
Shell の中で実行中のスクリプトを止めます |
Ctrl + V |
クリップボードを行に貼り付けます |
/ で始まらないパスは、今のディレクトリからの相対パスです。引用符はなく、引数は空白で
区切られます。
ファイルとディレクトリ¶
| コマンド | 内容 | 例 |
|---|---|---|
cd [path] |
今のディレクトリを変えます (cd だけなら /) |
cd /home |
pwd |
今のディレクトリを表示します | pwd |
ls [path] |
ディレクトリの中身を一覧します | ls /app/demo |
cat <file> |
ファイルの中身を表示します | cat /etc/system_conf.toml |
less <file> |
ファイルを 1 ページずつ表示します (Space / b でページ送り、q で終了) |
less /usr/share/doc/kanji.md |
mkdir <dir> |
ディレクトリを作ります | mkdir /home/games |
rm <path...> |
ファイルと、空のディレクトリを消します | rm old.rb notes.txt |
cp <src> <dst> |
ファイルをコピーします | cp hello.rb /home/backup.rb |
mv <src> <dst> |
ファイルを移動・名前変更します | mv draft.rb final.rb |
コードを書く・動かす¶
| コマンド | 内容 | 例 |
|---|---|---|
edit [-f] <file> |
ファイルをエディタで開きます。無ければ作ります。-f で全画面 |
edit -f /home/hello.rb |
create_app <name> |
すぐ編集できるアプリのひな型 /app/usr/<name>.app.rb と .app.toml を作ります (Hello World を参照) |
create_app my_clock |
run <script> [args] [&] |
スクリプトを実行します。アプリはアプリとして起動し、普通の .rb は Shell の中で動いて出力を Shell に出します。& を付けるとバックグラウンドのジョブになります |
run /home/fib.rb 20 |
run <script> > <file> |
出力をファイルに書きます (>> で追記、< でファイルを入力に渡す) |
run report.rb > /home/out.txt |
open <file> |
ファイルの種類に 関連付け られたアプリで開きます | open /usr/share/samples/slides/demo.md |
irb |
対話型の Ruby。$shell はこの Shell のアプリです |
irb |
アプリ・ジョブ・サービス¶
| コマンド | 内容 | 例 |
|---|---|---|
ps |
動いているタスク (PID、種類、エンジン、状態、名前)、バックグラウンドのジョブ、サービスを一覧します。ENGINE の欄は各アプリを動かしているもの (mruby・lua・basic・python・wasm・native) です (ENGINE は開発版から) |
ps |
kill <pid> |
ユーザのアプリを終了させます (PID は ps で) |
kill 12 |
kill <service> |
サービス をこのセッションの間だけ止めます | kill hourly_chime |
kill_job <id> |
バックグラウンドのジョブを止めます (ps の JOB の番号) |
kill_job 1 |
svc list |
バックグラウンドのサービスを一覧します | svc list |
svc start / svc stop <name> |
サービスをこのセッションの間だけ起動・停止します | svc start timesync |
svc enable / svc disable <name> |
同じことをして、再起動の後も覚えておきます | svc disable hourly_chime |
端末の間でアプリとファイルを運ぶ¶
運べるように書いたアプリ (movable = true。動いているアプリを運ぶ
を参照) と、Asterism を使う
コマンドです。相手の端末は Asterism のノード ID で指定します。ノード ID は anodes で
分かります。
| コマンド | 内容 | 例 |
|---|---|---|
checkpoint [-r] <pid> |
アプリをイメージ /tmp/<name>.ckpt に書いて閉じます。-r ですぐ起動し直します |
checkpoint -r 14 |
restore <image> |
イメージからアプリを起動します | restore /tmp/counter.ckpt |
amove <pid\|name> <node> |
動いているアプリを別の端末へ移します。名前は ps に出るもの。3.0.0 では move <pid> <node> です (開発版) |
amove Counter fmruby-aaaaaa |
anodes [list] |
今 Asterism にいる端末を名前つきで一覧します。この端末には印が付きます (開発版) | anodes |
anodes info <node> |
1 台の端末について、プロフィール、アプリとその状態、ファイルとアプリを受け取るかを表示します (開発版) | anodes info fmruby-aaaaaa |
asend <node> <file> [-o] [-s] |
ファイルを相手の端末の /home/inbox/ に送ります。-o で同じ名前のファイルを上書きします (付けなければ別の名前になります)。-s (または --sd) で相手の SD カードの /sd/inbox/ に置きます (開発版) |
asend fmruby-aaaaaa /home/hello.rb |
asend -c |
送っているファイルを取りやめます (開発版) | asend -c |
asend -l |
この端末にファイルを送ってよい相手を表示します (開発版) | asend -l |
asend on\|off |
送るためにこの端末をネットワークにつないだままにし、ウィンドウのメニューの 送る にすぐ相手が並ぶようにします。asend だけなら今の状態を表示します。asend でのファイル送信と amove は、これが off でも使えます (開発版) |
asend on |
areceive |
この端末がファイルとアプリを受け取るか、誰から受け取るかを表示します (開発版) | areceive |
areceive on\|off |
受け取りを始める・やめます (開発版) | areceive on |
areceive allow\|deny <file\|checkpoint> <node> |
ある端末にファイルを送ること (file) やアプリを移すこと (checkpoint) を許す・取り消します。* はネットワークの全員です (開発版) |
areceive allow file fmruby-aaaaaa |
アプリを移せるのは、同じ版の端末どうしです。
受け取る相手: receive.toml¶
端末は、設定するまで何も受け取りません。受け取る相手は /home/asterism/receive.toml に
書きます。このファイルが無い間は、システムの写し /etc/asterism/receive.toml (何も受け取らない
設定) を読みます。areceive や 受け取り のアプリ (/app/tool) で最初に変更したときに、
/etc のものを元に /home のファイルが作られます。
enabled = true # 受け取るかどうか。off (か行が無い) なら、一覧に何があっても受け取らない
send_enabled = false # 「送る」のためにネットワークにつないだままにする
[file] # /home/inbox (と /sd/inbox) にファイルを置いてよい相手
from = ["fmruby-aaaaaa", "fmruby-*"]
[checkpoint] # アプリを移してよい相手
from = ["*"] # "*": ネットワークの全員
一覧にはノード ID とパターン (fmruby-*) を書きます。アクセス制御のあるルータでは、ルータの
側でも相手を通す必要があります。端末が コンソール のメンバーなら、コンソールが
同じファイルに書く節で、コンソールで選んだ相手が加わります。areceive はその節を表示しますが、
書き換えません。2 つのスイッチのどちらかが on なら、起動時に転送のアプリが立ち上がります。
(開発版) enabled と send_enabled のスイッチ、/etc の写し、[file] の一覧、受け取りの
アプリは新しいものです。3.0.0 は /home/asterism/receive.toml だけを、それも
[checkpoint] from の一覧だけを読みます。
Linux のコマンド (Linux 版だけ)¶
Linux 版 では、! で始まる行を Linux で実行します。場所は今のディレクトリに
対応する Linux のディレクトリです (/mnt/host/src なら ~/src)。ほかの端末では、Linux が
無いと答えます。
| コマンド | 内容 | 例 |
|---|---|---|
!<command> |
Linux のコマンドを実行し、出力 (色つき) を Shell に出します。Ctrl + C で止めます |
!git status |
! |
Linux のシェルに入ります。exit か Ctrl + D で戻ります |
! |
Ctrl + Shift + V |
実行中の Linux のコマンドに貼り付けます |
vim や top のような全画面のプログラムには対応していません (TERM=dumb)。
その他¶
| コマンド | 内容 | 例 |
|---|---|---|
color |
Shell の 2 つの色を表示します | color |
color bg\|text <colour> |
背景色・文字色を 色の名前 か数値 (0x1F) で変えます。/home/colors.toml に保存します |
color bg navy |
color names / color reset |
色の名前を一覧します / テーマの色に戻します | color reset |
logo |
PicoRuby のロゴを描きます | logo |
help |
コマンドの一覧を表示します | help |