Veritas™ File System プログラマーズリファレンスガイド - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (7.3.1)
  1. Veritas File System Software Developer's Kit
    1.  
      Software Developer's Kit について
    2. File System Software Developer's Kit の機能
      1.  
        API ライブラリインターフェース
      2.  
        FCL(File Change Log)
      3.  
        マルチボリュームサポート
      4.  
        Veritas File System I/O
    3.  
      Software Developer's Kit RPM
    4.  
      必要なライブラリとヘッダーファイル
    5. コンパイル環境
      1.  
        異なるコンパイラによる再コンパイル
  2. FCL(File Change Log)
    1. FCL ファイルについて
      1.  
        記録される変更
      2. FCL(File Change Log)ファイルの使用
        1.  
          領域の使用状況
        2.  
          システムの完全スキャンの削減
        3.  
          ファイル履歴のトレース
      3.  
        FCL ログ記録のアクティブ化
      4. FCL ファイルのレイアウト
        1.  
          FCL(File Change Log)スーパーブロック
        2.  
          FCL(File Change Log)レコード
    2. レコードタイプ
      1.  
        特殊レコード
      2.  
        一般的なレコードの順番
    3. FCL(File Change Log)チューニングパラメータ
      1.  
        チューニングパラメータで FCL の拡張サイズを処理するには
    4. FCL(File Change Log)のアプリケーションプログラミングインターフェース
      1.  
        操作性
      2.  
        後方互換
      3. API 関数
        1.  
          FCL レコードにアクセスするための関数
        2.  
          FCL でオフセットとタイムスタンプをシークするための関数
        3. vxfs_fcl_open
          1.  
            戻り値
        4. vxfs_fcl_close
          1.  
            パラメータ
        5. vxfs_fcl_getinfo
          1.  
            戻り値
        6. vxfs_fcl_read
          1.  
            パラメータ
          2.  
            入力
          3.  
            出力
          4.  
            戻り値
        7. vxfs_fcl_getcookie
          1.  
            パラメータ
        8. vxfs_fcl_seek
          1.  
            パラメータ
          2.  
            戻り値
        9. vxfs_fcl_seektime
          1.  
            パラメータ
          2.  
            戻り値
        10. vxfs_fcl_sync
          1.  
            パラメータ
      4. FCL(File Change Log)レコード
        1.  
          定義
        2.  
          fcl_iostats 構造体
        3.  
          fcl_acsinfo 構造体
        4.  
          レコードの構造体のフィールド
      5. FCL(File Change Log)レコードのコピー
        1.  
          インデックス保守アプリケーション
        2. 使用状況プロファイルのコンピューティング
          1.  
            初期設定
          2.  
            手順の例
          3.  
            オフホスト処理
      6. Veritas File System と FCL のアップグレードとダウングレード
        1.  
          FCL バージョン 4 へのバージョン 3 ファイルの変換
        2.  
          Veritas File System バージョンのダウングレード
    5. パス名の逆引きルックアップ
      1.  
        i ノード
      2.  
        vxfs_inotopath_gen
  3. マルチボリュームサポート
    1.  
      MVS について
    2.  
      MVS の利用
    3. ボリュームアプリケーションプログラミングインターフェース
      1.  
        ボリュームセットの管理
      2.  
        ファイルシステムのボリュームセットの問い合わせ
      3.  
        ファイルシステム内のボリュームの変更
      4.  
        ボリュームのカプセル化とカプセル化の解除
    4. 割り当てポリシーアプリケーションプログラミングインターフェース
      1.  
        ファイル割り当ての指示
      2.  
        ポリシーの作成と割り当て
      3.  
        定義されたポリシーの問い合わせ
      4.  
        ポリシーの実施
    5.  
      データ構造
    6. ポリシーとアプリケーションプログラミングインターフェースの使用
      1.  
        割り当てポリシーの定義と割り当て
      2.  
        ボリュームアプリケーションプログラミングインターフェースの使用
  4. 名前付きデータストリーム
    1.  
      名前付きデータストリームについて
    2.  
      名前付きデータストリームの使用
    3.  
      名前付きデータストリームのアプリケーションプログラミングインターフェース
    4.  
      名前付きデータストリームの一覧表示
    5.  
      名前付きデータストリームの名前空間
    6.  
      ほかのシステムコールにおける動作の変更
    7.  
      名前付きデータストリームの問い合わせ
    8.  
      アプリケーションプログラミングインターフェース
    9.  
      コマンドリファレンス
  5. Veritas File System I/O
    1.  
      Veritas File System I/O について
    2.  
      凍結と解凍
    3. キャッシュアドバイザリ
      1.  
        ダイレクト I/O
      2.  
        同時 I/O
      3.  
        非バッファ I/O
      4.  
        その他のキャッシュアドバイザリ
    4. エクステント
      1. エクステント属性
        1.  
          属性の詳細
      2.  
        領域予約: ファイルへの事前領域割り当て
      3.  
        固定エクステントサイズ
      4.  
        エクステント属性のアプリケーションプログラミングインターフェース
      5. 割り当てフラグ
        1.  
          領域の予約での割り当てフラグ
        2.  
          予約領域の解放
        3.  
          非永続的な予約
        4.  
          予約領域を超えた書き込みの禁止
        5.  
          連続した予約領域
        6.  
          ファイルサイズに予約領域を含める
        7.  
          ファイルの増加分の読み取り
      6.  
        固定エクステントサイズでの割り当てフラグ
      7.  
        エクステント属性 API の使用方法
      8.  
        固定エクステントサイズの設定
  6. シン再生
    1.  
      シンストレージについて
    2.  
      シン再生について
    3. シン再生のアプリケーションプログラミングインターフェース
      1.  
        vxfs_ts_reclaim の戻り値

レコードの構造体のフィールド

表: FCL レコードの構造体のフィールド は、fcl_record 構造体の各フィールドを説明し、対象となる有効なレコードの種類を示します。

表: FCL レコードの構造体のフィールド

フィールド

説明

有効性

fr_reclen

FCL レコードの長さ。これには、FCL レコードの構造体の長さと、構造体の直後に格納されているデータの長さが含まれます。この長さは、vxfs_fcl_read によってバッファで返された FCL レコードをスキャンするときに使ってください。

すべてのレコードに対して有効です。

fr_inonum

変更されたファイルの i ノード番号。変更されたオブジェクトのフルパス名は、vxfs_inotopath_gen を使い、i ノード番号と世代数(fr_inogen)から作成されます。

レコードが FCL_EVNTMSK_CHG である場合を除き、すべての FCL レコードに対して有効です。イベントマスクの変更の場合、ファイルは暗黙として FCL ファイルです。

fr_op

この FCL レコードの操作。たとえば、作成、リンク解除、書き込み、ファイル属性の変更、その他の変更などが含まれます。fr_op には、表 2-1 に一覧表示されているレコードの種類のいずれかの値が採用されます。

このパラメータを使って、FCL レコードのどのフィールドが有効であるかを判定します。

すべてのレコードに対して有効です。

fr_time

変更が FCL ファイルに記録された、およその時間。 このフィールドを解釈するには、ctime() 呼び出しを使います。

すべてのレコードに対して有効です。

fr_inogen

変更されたファイルの世代数。世代数と、(ファイルの) i ノード番号を組み合わせて vxfs_inotopath_gen に渡すことで、オブジェクトの正確なフルパス名を取得できます。世代数を指定しないと、返されるパス名は再利用された i ノードである可能性があります。

イベントマスクの変更とリンク解除を除き、すべての FCL レコードに対して有効です。イベントマスクの変更の場合、i ノード番号と世代数が暗黙です。リンク解除の場合、名前の逆引きルックアップによってファイル名を取得するために世代数は必要ありません。これは、ファイル名がレコードとともにすでに存在するためです。

fr_pinonum

fr_pinogen

fr_filename

削除や名前の変更のような FCL レコードについては、ディレクトリエントリが削除された場合、名前の逆引きルックアップによってファイル名を判断できません。同様にリンクレコードの場合、あいまいでない方法でファイル名を判断できません。したがってこれらの場合、変更されるファイルを含む親ディレクトリのファイル名、i ノード番号、世代数が記録されます。親ディレクトリの i ノード(fr_pinonum)と世代数(fr_pinogen)を、名前の逆引きルックアップ API とともに使うと、親ディレクトリの絶対パス名を識別できます。 後続ファイル名を追加して、オブジェクトの完全な名前を生成できます。

FCL レコードが VX_FCL_UNLINK、VX_FCL_RENAMEVX_FCL_LINK のいずれかであるときに有効です。リンク解除と名前の変更、ファイル名と親 i ノード番号、世代数には、削除された古いファイルに関する情報が含まれます。リンクについては、新しいファイル名を表します。

fr_cmdname

fr_inonumfr_inogen によって表されるファイルを開いたコマンドの短い名前です。

FCL レコードが VX_FCL_FILEOPEN である場合にのみ有効です。

fr_stats

FCL_iostat レコードを指すポインタ。fcl_iostat レコードには、ファイルで起きる読み取りや書き込みの数、読み取りや書き込みの平均時間などの I/O 統計が含まれます。これらの特定時点のレコードを使うと、ファイルについて一定期間にわたる集計や平均の I/O 統計を計算できます。

FCL レコードが VX_FCL_FILESTATS である場合にのみ有効です。

fr_oldmask

fr_newmask

これらのフィールドはそれぞれ、古いイベントマスクと新しいイベントマスクを含みます。 各イベントマスクは、fcl.h で定義されているマスクのセットの論理和です。

FCL レコードが VX_FCL_EVNTMASK_CHG である場合にのみ有効です。

fr_acsinfo

FCL_acsinfo 構造体を指すポインタ。この構造体は、特定の操作を実行したアプリケーションのユーザーやグループの ID、プロセス ID、アクセスしているノードの ID などの情報を含みます。

有効性は、fcl_acsinfovalid bit-field により判断されます。これは、潜在的にすべての種類のレコードとともに存在できます。これはオプションのフィールドです。