cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib –l scha#include <scha.h>scha_err_t scha_get_function( handle, const char *tag...);
scha_err_t scha_control(const char *tag…
Oracle Solaris Cluster ライブラリ関数である scha_resource_get(3HA)、scha_resourcetype_get(3HA)、scha_resourcegroup_get(3HA)、scha_cluster_get(3HA)、scha_control(3HA)、scha_strerror(3HA)、および scha_resource_setstatus(3HA) は、コールバックメソッドの実装やリソースタイプのモニターで使用されるインタフェースを提供します。リソースタイプは、クラスタの Resource Group Manager (RGM) 機能によって制御されるサービスを表します。
「get」関数はクラスタ構成情報にアクセスします。これらの関数はすべて、同じ汎用シグニチャを持ちます。これらの関数は、以前の「open」関数の呼び出しから返された handle 引数を取ります。この handle は、クラスタ構成情報内のアクセスされるオブジェクトを示します。tag 引数は、アクセスされるオブジェクトのプロパティーを示します。tag の値により、引数を追加する必要があるかどうかと、要求された情報を返す最後の「out」引数の型が決定されます。「close」呼び出しが行われるまでは、同じハンドルを使って繰り返し「get」呼び出しを行えます。「close」呼び出しは、ハンドルを無効化し、「get」呼び出しから返された値に割り当てられているメモリーを解放します。
値を返す必要がある場合、各「get」呼び出しでメモリーが割り当てられます。ある呼び出しで値を返すために割り当てられたメモリーが、以降の呼び出しによって上書きされたり、再利用されたりすることはありません。
scha_control(3HA) 関数にはまた、制御操作を示すが、出力引数で情報を返さない tag 引数もあります。
scha_resource_setstatus(1HA) コマンドは、RGM によって管理されるリソースの Status および Status_msg プロパティーを設定します。
各関数の tag 引数値として受け付けられるマクロ値と各 tag の引数型については、個々の関数のマニュアルページを参照してください。次のセクションでは、出力引数の型について説明します。
scha 関数には、scha_err_t enum 型の戻り値が 1 セットあります。enum の記号、整数値、および終了コードの意味については、戻り値 を参照してください。
scha_strerror(3HA) 関数は、scha 関数によって返された scha_err_t コードを適切なエラーメッセージに変換します。
符号なし整数型。このタイプは、システムヘッダーファイル sys/types.h で定義されます。
このタイプは、システムヘッダーファイル sys/types.h で定義されます。
typedef enum { B_FALSE, B_TRUE } boolean_t;
リソースプロパティーの値 On_Off_switch または Monitored_switch を示す enum 型です。
typedef enum scha_switch { SCHA_SWITCH_DISABLED = 0, SCHA_SWITCH_ENABLED } scha_switch_t;
Preemption_mode リソースグループプロパティーの値を示す enum 型。
typedef enum scha_rg_preemption_mode { SCHA_HAS_PREEMPTION_COST = 0, SCHA_NO_PREEMPTION_COST, SCHA_NEVER_PREEMPT_RG } scha_rg_preemption_mode_t;
リソースの状態を示す enum 型です。
typedef enum scha_rsstate { SCHA_RSSTATE_ONLINE = 0, SCHA_RSSTATE_OFFLINE, SCHA_RSSTATE_START_FAILED, SCHA_RSSTATE_STOP_FAILED, SCHA_RSSTATE_MONITOR_FAILED, SCHA_RSSTATE_ONLINE_NOT_MONITORED, SCHA_RSSTATE_STARTING, SCHA_RSSTATE_STOPPING } scha_rsstate_t;
リソースグループの状態を示す enum 型です。
typedef enum scha_rgstate { SCHA_RGSTATE_UNMANAGED = 0, SCHA_RGSTATE_ONLINE, SCHA_RGSTATE_OFFLINE, SCHA_RGSTATE_PENDING_ONLINE, SCHA_RGSTATE_PENDING_OFFLINE, SCHA_RGSTATE_ERROR_STOP_FAILED SCHA_RGSTATE_ONLINE_FAULTED, SCHA_RGSTATE_PENDING_ONLINE_BLOCKED } scha_rgstate_t;
リソースグループのモードがフェイルオーバーかスケーラブルかを示す enum 型です。
typedef enum scha_rgmode { RGMODE_NONE = 0, RGMODE_FAILOVER, RGMODE_SCALABLE } scha_rgmode_t;
リソースプロパティー Failover_Mode の値を示す enum 型です。
typedef enum scha_failover_mode { SCHA_FOMODE_NONE = 0, SCHA_FOMODE_HARD, SCHA_FOMODE_SOFT, SCHA_FOMODE_RESTART_ONLY, SCHA_FOMODE_LOG_ONLY } scha_failover_mode_t;
リソースタイププロパティー Init_nodes の値を示す enum 型です。
typedef enum scha_initnodes_flag { SCHA_INFLAG_RG_PRIMARIES = 0, SCHA_INFLAG_RT_INSTALLED_NODES } scha_initnodes_flag_t;
ノードが起動しているかどうかを示す enum 型です。
typedef enum scha_node_state { SCHA_NODE_UP = 0, SCHA_NODE_DOWN } scha_node_state_t;
文字列のリストの値を格納する構造体です。
typedef struct scha_str_array { uint_t array_cnt; boolean_t is_ALL_value; char **str_array; } scha_str_array_t;
リスト内の要素数を示します。
プロパティーの値が「all」 (ワイルドカードまたはアスタリスク (*) 文字ともいう) に設定されると、is_ALL_value は B_TRUE に、str_array は NULL にそれぞれ設定されます。そのため、str_array は無視されます。
array_cnt strings 配列へのポインタです。
符号なし整数のリストの値を格納する構造体です。
typedef struct scha_uint_array { uint_t array_cnt; uint_t *int_array; } scha_uint_array_t;
リスト内の要素数です。
符号なし整数 array_cnt の配列へのポインタです。
リソースのステータスとステータスメッセージを返す構造体です。
typedef struct scha_status_value { scha_rsstatus_t status; char *status_msg; } scha_status_value_t; typedef enum scha_rsstatus { SCHA_RSSTATUS_ONLINE = 0, SCHA_RSSTATUS_OFFLINE, SCHA_RSSTATUS_FAULTED, SCHA_RSSTATUS_DEGRADED, SCHA_RSSTATUS_UNKNOWN } scha_rsstatus_t;
リソースモニターの設定に従ってリソースのステータスを示す enum の値です。
拡張プロパティーの値を返すために使用される構造体です。
prop_type 構造体メンバーは、拡張プロパティーの型を示し、prop_type フィールドと戻り値で使用される共用体要素を決めます。
SCHA_PTYPE_STRING val_str SCHA_PTYPE_INT val_int SCHA_PTYPE_ENUM val_enum SCHA_PTYPE_BOOLEAN val_boolean SCHA_PTYPE_STRINGARRAY val_strarray typedef struct scha_extprop_value { scha_prop_type_t prop_type; union { char *val_str; int val_int; char *val_enum; boolean_t val_boolean; scha_str_array_t *val_strarray; } val; } scha_extprop_value_t;
次は、scha_strerror(3HA) から返される scha_err_t エラー番号およびエラーコードの一覧です。
エラーは検出されませんでした。
スワップが十分ではありません。
無効なリソース管理ハンドルです。
無効な入力引数です。
無効な API タグです。
クラスタは再構成されます。
アクセス権が拒否されました。
最後の scha_*_open 呼び出し以降に、リソース、リソースグループまたはリソースタイプが更新されました。
オブジェクトの依存の問題です。
オブジェクトの状態が不正です。
無効なメソッドです。
無効なノードです。
無効なリソースグループです。
無効なリソースタイプです。
無効なリソースです。
無効なプロパティーです。
妥当性検査に失敗しました。
リソースのステータスが不正です。
内部エラーが発生しました。
ほかのクラスタと通信できません。
ゾーンクラスタが無効です。
ゾーンクラスタの状態が「実行中」ではありません。
負荷制限が無効です。
操作がタイムアウトしました。
フェイルオーバーの試みが失敗しました。
インクルードファイル
ライブラリ
次の属性については、attributes(5) を参照してください。
|
scha_cmds(1HA), scha_resource_setstatus(1HA)scha_cluster_get(3HA), scha_control(3HA), scha_resource_get(3HA), scha_resourcegroup_get(3HA), scha_resource_setstatus(3HA), scha_resourcetype_get(3HA), scha_strerror(3HA), attributes(5)