genseq 装置構成サブルーチン

目的

デバイスの論理名を作成するための固有のシーケンス番号を生成します。

構文

#include <cf.h>
#include <sys/cfgodm.h>
#include <sys/cfgdb.h>

int genseq (prefix)
char *prefix;

パラメーター

説明

Genseq 装置構成サブルーチンは、装置の接頭部名と連結される固有のシーケンス番号を生成します。 カスタマイズ・デバイス (CuDv) オブジェクト・クラス のデバイス名は、接頭部の名前とシーケンス番号を連結したものです。 シーケンス番号を生成するための規則は、以下のとおりです。

• シーケンス番号は負でない整数です。 最小のシーケンス番号は 0 です。
• デバイス・インスタンス論理名を派生させる場合、次に使用可能なシーケンス番号 (指定された接頭部名に対する相対番号) が割り振られます。 この次に使用可能なシーケンス番号は、同じ接頭部名を使用して装置インスタンスにまだ割り振られていない最小のシーケンス番号として定義されます。
• シーケンス番号が割り振られるかどうかは、 CuDv オブジェクト・クラスのデバイス・インスタンスによって決定されます。 必要な接頭部を使用する項目がこのクラスに存在する場合には, その項目の順序番号は既に割り振られています。

このシーケンス番号を文字フォーマットに変換して、接頭部に連結して装置名を形成できるようにするかどうかは、アプリケーションによって異なります。

戻り値

Genseq サブルーチンが成功すると、生成されたシーケンス番号が整数形式で戻されます。 サブルーチンが失敗した場合、次の値を返します。-1 。

ファイル