Skip to content

Latest commit

 

History

History
92 lines (68 loc) · 4.24 KB

sai-sourcecode.md

File metadata and controls

92 lines (68 loc) · 4.24 KB

SAIソースコードの場所と呼び出しフロー

タイトルは内容に応じて適宜変更

SAI の定義（ヘッダファイル）

https://github.com/opencomputeproject/SAI の SAI: /inc にヘッダファイルが存在する。 実質これがSAIの定義（スペック）となっている。

TODO: SAI Objects は ER図 を使って図示する？ TODO: SAI API はモジュールに分かれている -> sai.h: _sai_api_t TODO: モジュール毎の定義（具体例で） TODO: ココか別のところで、SAI が CRUD API である事の説明 ⇒ sairedis QUAD API との関係の解説 TODO: SAI Object と ObjectID について TODO: Orchagent や Syncd の VIDCOUNTER、VirtualID(VID), SAI ODI == Real Object ID(RID)の関係について。例えば Interface (INTF)など。VID/RIDのマッピングはSyncdでやっている。なお、チップによって挙動が異なる可能性があるので注意（例：Object毎にVID/RIDマッピングが必要ないチップもある？） TODO: SAI エラーコードとオフセットについて。下位の数値でどのAttrが問題なのか示している。 TODO: SAIの初期化～終了まで。SAISWITCH Objectとは何か？（PTFやsai-sanityなど小さなテストプログラムと合わせて解説すると分かりやすい？） TODO: （別ファイル？）SAIテスト方法：PTF、sai-sanity、など https://github.com/oopt-goldstone/goldstone-buildimage/tree/master/packages/base/any/sai-sanity

SONiC 実装 (TODO: sairedis, orchagentの構成、等、具体的なタイトルに変更)

TODO: sairedis (orchagent->ASIC_DB), syncd に章立てを分けて解説

sonic-swss/orchagent$ grep -r create_my_sid_entry
srv6orch.cpp:        status = sai_srv6_api->create_my_sid_entry(&my_sid_entry, (uint32_t) attributes.size(), attributes.data());

SAI_API_SRV6 という ID と、SAIの分類に応じたメソッドが格納されている構造体へのマップ

sonic-swss/orchagent$ grep SAI_API_SRV6 *

saihelper.cpp:    sai_api_query(SAI_API_SRV6,                 (void **)&sai_srv6_api);
saihelper.cpp:    sai_log_set(SAI_API_SRV6,                   SAI_LOG_LEVEL_NOTICE);
ebiken@dcig17:~/sandbox/sonic-swss/orchagent$ grep -r SAI_API_SRV6
saihelper.cpp:    sai_api_query(SAI_API_SRV6,                 (void **)&sai_srv6_api);
saihelper.cpp:    sai_log_set(SAI_API_SRV6,                   SAI_LOG_LEVEL_NOTICE);

SAIの分類ごとのメソッドを格納している場所

SAI/inc$ grep -r sai_srv6_api_t
saisrv6.h:typedef struct _sai_srv6_api_t
saisrv6.h:} sai_srv6_api_t;
sai.h:    SAI_API_SRV6             = 35, /**< sai_srv6_api_t */

> SAI/inc$ vi saisrv6.h
/**
 * @brief SRV6 methods table retrieved with sai_api_query()
 */
typedef struct _sai_srv6_api_t
{
    sai_create_srv6_sidlist_fn             create_srv6_sidlist;
    sai_remove_srv6_sidlist_fn             remove_srv6_sidlist;
    sai_set_srv6_sidlist_attribute_fn      set_srv6_sidlist_attribute;
    sai_get_srv6_sidlist_attribute_fn      get_srv6_sidlist_attribute;
    sai_bulk_object_create_fn              create_srv6_sidlists;
    sai_bulk_object_remove_fn              remove_srv6_sidlists;

    sai_create_my_sid_entry_fn             create_my_sid_entry;
    sai_remove_my_sid_entry_fn             remove_my_sid_entry;
    sai_set_my_sid_entry_attribute_fn      set_my_sid_entry_attribute;
    sai_get_my_sid_entry_attribute_fn      get_my_sid_entry_attribute;

    sai_bulk_create_my_sid_entry_fn        create_my_sid_entries;
    sai_bulk_remove_my_sid_entry_fn        remove_my_sid_entries;
    sai_bulk_set_my_sid_entry_attribute_fn set_my_sid_entries_attribute;
    sai_bulk_get_my_sid_entry_attribute_fn get_my_sid_entries_attribute;

} sai_srv6_api_t;

メソッドの定義

> SAI/inc$ vi saisrv6.h
typedef sai_status_t (*sai_create_my_sid_entry_fn)(
        _In_ const sai_my_sid_entry_t *my_sid_entry,
        _In_ uint32_t attr_count,
        _In_ const sai_attribute_t *attr_list);

Tofino 実装

Tofino の SAI Driver のソースコードは公開されていないが、NDA/SLA契約を締結してアクセス可能な Intel SDE に含まれている。

SDEにアクセス可能な場合は switch-p4-16/sai/*.cpp を参照。