ufdcreate カーネル・サービス

目的

ファイル記述子を割り振り、初期化します。

構文

#include <fcntl.h>
#include <sys/types.h>
#include <sys/file.h>

int ufdcreate (flags, ops, datap, type, fdp, cnp)

パラメーター

説明

ufdcreate カーネル・サービスは、カーネル・エクステンションへのファイル・インターフェースを提供します。 カーネル・エクステンションは、このサービスを使用して、ファイル・ディスクリプターとファイル構造のペアを作成します。 また、このサービスを使用すると、カーネル・エクステンションは、独自のファイル・ディスクリプター・ベースのシステム・コールを提供して、ファイル・システム外部のオブジェクトに対する読み取り/書き込み、ioctl、選択、fstat、およびクローズ操作を使用可能にすることができます。 ufdcreate カーネル・サービスは、論理ファイル・システム (LFS) の同期要件を理解したり、それに準拠したりするために拡張機能を必要としません。

ufdcreate カーネル・サービスは、呼び出し元にファイル記述子を提供し、基礎となるファイル構造を作成します。 呼び出し側は、読み取り/書き込み、ioctl、選択、fstat、およびクローズ操作のために、サブシステム提供ルーチンへのポインターを組み込む必要があります。 呼び出し側サブシステムがいずれかの操作を必要としない場合、呼び出し側は適切な エラー番号 値へのポインターを提供する必要があります。 通常、この目的には EOPNOUPP (EOPNOTSUPP) 値が使用されます。 サブシステム提供ルーチンの要件については、 "ファイル操作" を参照してください。

ファイル記述子の除去

ufdcreate カーネル・サービスによって作成されたファイル記述子 (および付随する構造) を除去するための、対応する操作はありません。 ファイル・ディスクリプターを除去するには、 閉じる サブルーチンへの呼び出しを使用します。 閉じる サブルーチンは、ルーチンから、またはカーネルまたはカーネル・エクステンション内から呼び出すことができます。 クローズが呼び出されない場合は、プロセスの終了時にファイルがクローズされます。

ufdcreate カーネル・サービスへの呼び出しが行われると、サービスへの呼び出しが戻る前に、ファイル記述子はオープンしていると見なされます。 閉じる または 出口 サブルーチンが呼び出されると、 ufdcreate インターフェースへの呼び出しで指定されたファイル・クローズ操作が呼び出されます。

ファイル操作

ufdcreate カーネル・サービスにより、カーネル・エクステンションは独自のファイル・ディスクリプター・ベースのシステム・コールを提供し、ファイル・システム外部のオブジェクトに対する読み取り/書き込み、ioctl、選択、fstat、およびクローズ操作を可能にします。 sys/file.h ファイルに定義されている fileops 構造体は、これらのルーチンのインターフェースを提供します。

読み取り/書き込み要件

読み取り/書き込み操作は、 FP パラメーターで指定されたオブジェクトへの入出力を管理します。 この操作によって実行されるアクションは、オブジェクト・タイプによって異なります。 操作の構文は次のとおりです。

#include <sys/types.h>
#include <sys/uio.h>

int (*fo_rw) (fp, rw, uiop, ext)

struct file *fp;
enum uio_rw rw;
struct uio *uiop;
int ext;

パラメーターには、以下の値があります。

正常に実行された場合、 発泡スチロール 操作は値 0 を戻します。 ゼロ以外の戻り値は、エラーを示すようにプログラムする必要があります。 可能な値のリストについては、 sys/errno.h ファイルを参照してください。

ioctl の要件

ioctl 操作は、オブジェクト依存の特殊コマンド処理を提供します。 Ioctl サブルーチンは、指定されたオープン ファイル 構造体に関連したオブジェクトに対してさまざまな制御操作を実行します。 このサブルーチンは通常、文字特殊ファイルまたはブロック特殊ファイルで使用され、通常のファイルの場合はエラーを返します。

ioctl 操作によって提供される制御操作は、 引数 パラメーターのデータ・タイプおよび内容と同様に、アドレス指定されるオブジェクトに固有のものです。

ioctl 操作の構文は、次のとおりです。

#include <sys/types.h>
#include <sys/ioctl.h>

int (*fo_ioctl) (fp, cmd, arg, ext, kflag)

struct file *fp;
int cmd, ext, kflag;
caddr_t arg; 

パラメーターには、以下の値があります。

正常に実行された場合、 フォイオクトル 操作は値 0 を戻します。 エラーの場合、 フォイオクトル 操作は、エラーを示すゼロ以外の戻り値を戻す必要があります。 可能な値のリストについては、 sys/errno.h ファイルを参照してください。

要件の選択

選択操作は、 FP パラメーターで指定されたオブジェクトに対して選択操作を実行します。 この操作の構文は次のとおりです。

#include <sys/types.h>

int (*fo_select) (fp, corl, reqevents, rtneventsp, notify)

struct file *fp;
int corl;
ushort reqevents, *rtneventsp;
void (notify) ();

パラメーターには、以下の値があります。

正常に実行された場合、 発泡スチロール 操作は値 0 を戻します。 この操作は、エラーを示すゼロ以外の戻り値を戻す必要があります。 可能な値のリストについては、 sys/errno.h ファイルを参照してください。

fstat 要件

fstat 操作は、 属性 構造体を埋めます。 FP パラメーターで指定されたオブジェクト・タイプによっては、構造内の多くのフィールドが適用されない場合があります。 この操作から戻される値は、オブジェクト・タイプと、そのタイプを認識するルーチンが予期するものの両方によって異なります。 この操作の構文は次のとおりです。

#include <sys/types.h>

int (*fo_fstat) (fp, sbp)

struct file *fp;
struct stat *sbp;

パラメーターには、以下の値があります。

正常に実行された場合、 FSTAT 操作は値 0 を戻します。 ゼロ以外の戻り値は、エラーを示すようにプログラムする必要があります。 可能な値のリストについては、 sys/errno.h ファイルを参照してください。

要件を閉じる

クローズ操作は、 FP パラメーターで指定されたオブジェクトへのルーチン・アクセスを無効にし、そのアクセスに関連するデータをすべて解放します。 この操作は、 ファイル 構造体の使用回数が 0 に減少したときに、 閉じる サブルーチン・コードから呼び出されます。 例えば、オブジェクト ( Dup、 フォーク、またはその他のサブシステム固有の操作によって作成された) へのアクセスが複数ある場合、 閉じる サブルーチンは、クローズされる ファイル 構造体によるアクセスが残っていないことを判別すると、クローズ操作を呼び出します。

LFS によってファイル記述子と ファイル 構造がセットアップされると、ファイル記述子はオープンしていると見なされます。 ファイル・クローズ操作は、クローズまたは出口が指定されるたびに呼び出されます。 その結果、クローズ操作は、 ファイル 構造体が初期設定される前に呼び出し元が行ったことに応じて、完全にオープンされていないオブジェクトをクローズできなければなりません。

クローズ操作の構文は次のとおりです。

#include <sys/file.h>

int (*fo_close) (fp)
struct file *fp;

パラメーターは以下のとおりです。

正常に実行された場合、 発泡スチロール 操作は値 0 を戻します。 この操作は、エラーを示すゼロ以外の戻り値を戻す必要があります。 可能な値のリストについては、 sys/errno.h ファイルを参照してください。

実行環境

ufdcreate カーネル・サービスは、 プロセス環境 からのみ呼び出すことができます。

戻り値

ufdcreate カーネル・サービスが成功すると、値 0 を返します。 カーネル・サービスが失敗すると、ゼロ以外の値を戻し、 エラー番号 グローバル変数を設定します。

エラー・コード

以下の 1 つ以上のエラーが発生すると、 ufdcreate カーネル・サービスは失敗します。