Trema の API をどのように決めているか、舞台裏を紹介します。Trema API の唯一の設計方針は「短く簡潔に書けるかどうか」ですが、具体的にはこんな方法で設計しています。
Trema塾
OpenFlow プログラミングフレームワーク Trema で遊ぼう
Category Archives: API
新しいアクション API
Tagged actions, api
パケットの VLAN VID とプライオリティを書き換える
Tagged actions, priority, vid, vlan
Trema API のチートシート
Trema Ruby ライブラリのクラスは 100 個以上ありますが、そのうちよく使うものはせいぜい 10 個とかそこらです。そこで今日は、このようなよく使うクラスやメソッドだけを集めた便利な URL を紹介します。
パケットの VLAN ヘッダを取り除く
Tagged actions, modify-field, vlan
パケットの送信元・宛先 TCP/UDP ポート番号を書き換える
しばらく Modify-Field アクションでパケットを書き換える記事が続いています。今日はパケットの送信元・宛先 TCP/UDP ポート番号を書き換える方法です。
パケットの送信元・宛先 MAC アドレスを書き換える
OpenFlow では Modify-Field アクションを使ってパケットのいろいろな部分を書き換えることができるのでした。今回はこのうち、パケットの送信元と宛先 MAC アドレスを書き換える方法を説明します。
Exact Match を楽に作る
マッチングルールの中でもすべての条件が指定されたものを Exact Match と呼びます。たとえばよくある例ですが Packet In としてコントローラに入ってきたパケットと
- スイッチの物理ポート番号
- 送信元 MAC アドレス
- 宛先 MAC アドレス
- …
などなどマッチングルールが定義する 12 個の条件がすべてまったく同じ、というものが Exact Match です。これを普通にコードにするとこうなります。
Flow Mod してみよう 1
Flow Mod はスイッチのフローテーブルを変更する OpenFlow メッセージの総称で、次の 3 種類があります。
- Add フローエントリを追加する
- Delete フローエントリを削除する
- Modify フローエントリを変更する
Trema の Flow Mod API はそれぞれ
というメソッドで定義されています。今回は、この中でもとくによく使う send_flow_mod_add メソッドの API 定義を見ていきましょう。