<book_title> を検索 ...

Storage Foundation 8.0.2 管理者ガイド - Solaris

Last Published: 2023-07-18

Product(s): InfoScale & Storage Foundation (8.0.2)

Platform: Solaris

Veritas File System ファイルの変更ログのプログラミングインターフェース

VxFS には、次の 2 つの方法で FCL ファイルの読み取りと解析を単純化するための拡張 API が用意されています。

読み取りの単純化

PI により FCL エントリ解析に必要な追加のコードが削減され、ユーザータスクが単純化されます。4.1 では、削除やリンクなどのイベント情報を取得するために、ユーザーは削除やリンクされたファイル名を取得するための追加のコードを書く必要がありました。このリリースでは、ユーザーは API を使ってアセンブルされたレコードを直接読み取ることができます。また、API を使って、目的のイベントレコードのサブセットを示すためのフィルタを指定できます。

後方互換

FCL への API アクセス機能により、アプリケーションの後方互換に対応します。API を使うことで、アプリケーションは FCL のレイアウト変更に関係なく FCL ファイルを解析できます。FCL の隠されたレコードレイアウトが変更されても、API は戻りデータを自動的に変換して求められる出力レコードに一致させます。その結果、ユーザーは、オンディスクの FCL レイアウトの変更により、アプリケーションを修正または再コンパイルする必要はありません。

次のサンプルコードは、FCL スーパーブロックを読み取り、FCL の状態が VX_FCLS_ON であることを確認します。次に、vxfs_fcl_sync への呼び出しを発行して、読み取り先の最後のオフセットを取得し、FCL ファイル内の最初の有効なオフセットを特定します。最後に、このオフセットから 8 K のチャンクでエントリを読み取ります。FCL エントリ処理（process fcl entries）とコメントされた行付近に、FCL 内のエントリに対する処理レコードをアプリケーション開発者が提供する必要があります。

  #include <stdint.h>
  #include <stdio.h>
  #include <stdlib.h>
  #include <sys/types.h>
  #include <sys/fcntl.h>
  #include <errno.h>
  #include <fcl.h>
  #include <vxfsutil.h>
  #define FCL_READSZ 8192
  char* fclname = "/mnt/lost+found/changelog";
  int read_fcl(fclname) char* fclname;
  {
      struct fcl_sb fclsb;
      uint64_t off, lastoff;
      size_t size;
      char buf[FCL_READSZ], *bufp = buf;
      int fd;
      int err = 0;
      if ((fd = open(fclname, O_RDONLY)) < 0) {
          return ENOENT;
      }
      if ((off = lseek(fd, 0, SEEK_SET)) != 0) {
          close(fd);
          return EIO;
      }
      size = read(fd, &fclsb, sizeof (struct fcl_sb));
      if (size < 0) {
          close(fd);
          return EIO;
      }
      if (fclsb.fc_state == VX_FCLS_OFF) {
          close(fd);
          return 0;
      }
      if (err = vxfs_fcl_sync(fclname, &lastoff)) {
          close(fd);
          return err;
      }
      if ((off = lseek(fd, off_t, uint64_t)) != uint64_t) {
          close(fd);
          return EIO;
      }
      while (off < lastoff) {
          if ((size = read(fd, bufp, FCL_READSZ)) <= 0) {
              close(fd);
              return errno;
          }
          /* process fcl entries */
          off += size;
      }
      close(fd);
      return 0;
  }