framebuf(7)

サイズ、特徴、フレームバッファーのマップされた範囲を記述します。 情報はデータ構造体 crt_frame_buffer_t に納められて呼び出しプロセスに返され、パラメータは crt_frame_buffer_t *arg; として定義されます。 １ つまたはそれ以上のフレームバッファー デバイスの範囲を持つ 構造体フィールドがありますが、これらのフィールドの値は いつも定義されているわけではありません。 正常に終了した後にのみ、使われた GCMAP コマンド (以下参照) は正しいアドレスを返し、返されたアドレスを 用いて直接フレームバッファーの範囲をアクセスできるようになります。

デバイスの識別番号を返します。 パラメータは int *arg; として定義されています。 このコマンドを用いたときに返された情報は、GCDESCRIBE によって返される情報のサブセットで、旧製品との互換性のためだけに 提供されています。

グラフィックをオンまたはオフします。 この操作は、GCDESCRIBE コマンドが返したデータ構造体 crt_frame_buffer_t のフィールド crt_attributes 内で、CRT_GRAPHICS_ON_OFF ビットがセットされているデバイスに有効です。 他の場合は、これらのコマンドの影響はありません。

alpha をオンまたはオフします。 これらの操作は、GCDESCRIBE コマンドが返したデータ構造体 crt_frame_buffer_t のフィールド crt_attributes 内で、CRT_ALPHA_ON_OFF ビットがセットされているデバイスに有効です。 他の場合は、これらのコマンドの影響はありません。

フレームバッファー メモリー、グラフィックコントロール、および コールを行なうユーザープロセスのアクセス可能なその他のデバイス範囲を 作成します。 これをリクエストしたプロセスのみが、直接フレームバッファー メモリー をアクセスでき、レジスタをコントロールできます。GCMAP コールに正常に終了した後に、 (GCDESCRIBE ioctl() コールによって返される) データ構造体 crt_frame_buffer_t 内のフィールド crt_frame_base および crt_control_base は、フレームバッファーの ２ つの範囲の有効なアドレスを持ちます。 指定したデバイスで、ユーザーのアドレス空間に ２ つ以上の範囲をマップするような場合は、 特別なデバイスの範囲 CRT_MAX_REGIONS までのベースアドレスが順次配列 crt_region に置かれます。 指定したフレームバッファーに関連した範囲のみがマップされます。 データ構造体 crt_frame_buffer_t 内の不適切なフィールドは 0. にセットされます。 パラメータ arg の使用はインプリメンテーションに依存しています (『制約』 参照)。 フレームバッファーの範囲のベースアドレスはいつもページに合わされます。

フレームバッファー メモリーへのアクセス、グラフィック制御、 および他のデバイスの範囲のリクエストプロセスからの削除を行います。 パラメータ arg は無視して 0 にセットしてください。GCUNMAP コールが正常に終了した後は、 これらのメモリーの範囲へのアクセスはメモリーフォルトになり、 シグナル SIGSEGV がプロセスに送られます。

協調プロセスによるフレームバッファー デバイスの排他的な使用を 行ないます。 呼び出しプロセスはデバイスのロックおよび継続を行うか、 またはブロックされます。 この場合ブロックは、フレームバッファーが 使用可能な場合またはコールがシグナルにより割り込まれた場合にのみ、 コールから返ってきます。 コールが割り込まれた場合はエラーを返し、errno が EINTR にセットされます。 他のプロセスが GCLOCK コマンドを使ってすでにこのフレームバッファー ロックしていて、GCUNLOCK がまだ実行されていないときには待ち状態がおこります。GCLOCK コマンドは他の非協調プロセスのフレームバッファーへの書き込みを 妨げないので、 パラメータ arg は無視して 0 にセットしてください。

このコールは内蔵ターミナルエミュレータ (ITE) がグラフィックハードウェア (termio(7) 参照) の状態を改悪することを避けます。 いくつかのシステムでは、GCLOCK コマンドによってフレームバッファーがロックされている限りは、ITE はテキストを出力しません (『制約』 参照)。 同じプロセスによる １ 回以上のデバイスのロックは失敗し、errno が EBUSY にセットされます。

協調プロセスによるフレームバッファー デバイスの排他的な使用を行います。 このリクエストは GCLOCK リクエストと同じ影響をフレームバッファー デバイスに与えます。 しかし、 このコールは他のプロセスによってフレームバッファーがリリースされるのを 待ちません。 フレームバッファー デバイスがロックされている場合は、 プロセスはブロックせず、代わりにシステムコールがエラーを返し、errno が EAGAIN にセットされます。パラメータ arg は無視して 0 にセットされます。

別の方法で送られた呼び出しプロセスへのすべての入力シグナルが ブロックしている間、 協調プロセスによるフレームバッファー デバイスの排他的な使用を 提供します。 このコールは GCLOCK コールのスーパーセットです。パラメータ arg は無視され 0 にセットされます。 排他的な使用でディスプレイを取得した場合、GCLOCK コールのときにプロセスが受け取ったすべてのシグナルを、GCUNLOCK を取得するまで保留 (ブロック) します。GCUNLOCK リクエストの前のプロセスのシグナルのマスクの変更 (sigsetmask(2) 参照) は、これらのブロックしたシグナルでは影響を持ちません。 ロックが行われるまでシグナルはブロックされず、ロックを待っている間も シグナルは受け取られます。

シグナル SIGTSTP はそれが受け取られても受け取られなくても、 ブロックされます。SIGTTIN および SIGTTOU もデバイスがロックしている間、ITE がデバイスに出力を 行なわないフレームバッファー デバイス上でブロックされます。『制約』 を参照してください。

上で述べた ３ つのシグナルを除いて、 このコールはプロセスが受け取ることを予期しないシグナルをブロックせず、 受け取れないまたは無視できないシグナルをブロックしません。 このコマンドは他の非協調プロセスのフレームバッファーへの 書き込みを妨げません。

別の方法で送られた呼び出しプロセスへのすべての入力シグナルが ブロックしている間、 協調プロセスによるフレームバッファー デバイスの排他的な使用を 提供します。 このリクエストは GCLOCK_BLOCKSIG リクエストと同じ影響をフレームバッファー デバイスに与えます。 しかし、 このコールは他のプロセスによってフレームバッファーがリリースされるのを 待ちません。 フレームバッファー デバイスがロックされている場合は、 プロセスはブロックせず、代わりにシステムコールがエラーを返し、errno が EAGAIN にセットされます。パラメータ arg は無視され 0 にセットされます。

フレームバッファー デバイスの排他的使用を止めます。 デバイスが GCLOCK_BLOCKSIG または GCLOCK_BLOCKSIG_NOWAIT ioctl() リクエストによりロックされている場合は、 呼び出しプロセスのシグナルマスクが ロックリクエストに優先してその元の状態に戻されます。

フレームバッファー デバイスに対応するグラフィックハードウェアが、 定義された初期状態にリセットされます。 このコールによりフレームバッファー デバイスがここで定義した ioctl に応えられるようになります。

DMA の出力をフレームバッファー デバイスに送ります。 このシステムコールはユーザーの配列から グラフィック フレームバッファーの長方形の部分、 またはデバイスのグラフィック制御空間へデータを転送するために使われます。

DMA のパラメータはデータ構造体 crt_dma_ctrl_t でわたされ、次のフィールドが含まれています。

グラフィック フレームバッファーへ書くためには、 描く長方形の左上のアドレスに fb_addr をセットします。DMA は各フレームバッファーの列上に linelength バイト書き、メモリーデータの次の skipcount バイトを無視し、成功したフレームバッファーの列と同じスタート位置に 再び書き始めます。 このことを、length バイト書き終えるかまたは無視されるまで続けます。

グラフィック制御空間に書くためには、fb_addr を最初のグラフィック制御レジスタのアドレスにセットします。 この時、linelength および skipcount は無視されます。

パラメータ flags は DMA のオプションを指定します。 現在サポートしているフラグはないので、 このパラメータは 0 にセットしてください。 他の場合、システムコールは失敗し、errno は EINVAL にセットされます。

DMA はデータを書く命令をストアするのと同じ効果を フレームバッファー デバイスに与えます。 このように、 様々なグラフィック制御レジスタが DMA の結果に影響を与えます。DMA が望んだ結果をもたらすよう、 必要なフレームバッファー デバイスの設定を行うのは、 ユーザープログラムの責任です。

パラメータ イメージの一部を再描画する必要がある場合に、skipcount によりユーザーはメモリーにストアしたウィンドウイメージの一部を 再描画することができます。 ウィンドウイメージはアップデートされた長方形のスーパーセットで、 大きさが異なります。skipcount は長方形から除かれる大きい方のウィンドウイメージ内の列の １ 部を 指定します。linelength + skipcount は大きい方のウィンドウイメージの配列の各列のバイト数です。

特別なフレームバッファー デバイスがこのシステムコールを サポートしている場合、 構造体 crt_frame_buffer_t のフィールド crt_attributes 内のフラグ CRT_DMA_OUTPUT はセットされます。DMA を サポートするフレームバッファー デバイスに よってはいくつかのパラメータの境界を 制限します。『制約』 を参照してください。カーネルはこれらの制限条項が守られることを 保証し、制限がシステムコールでない場合はそれは失敗し、errno に EINVAL がセットされます。

システムの物理メモリーが、プロセッサのデータキャッシュのフラッシュにより アップデートされることを保証するのはアプリケーションの責任です。 データが DMA 転送を初期化する前に矛盾していないことを保証するには、GCDMA_DATAFLUSH ioctl を使用してください。

指定したデータを プロセッサのデータキャッシュからシステムの主メモリーへフラッシュします。 このシステムコールは DMA の前に使われ、 新しいデータを フレームバッファーまたは制御空間へ転送したことを保証します。

吐き出すためのパラメータはデータ構造体 crt_flush_t へ渡され、それには次のフィールドが含まれています。

カーネルは flush_addr で始まる flush_len バイトがキャッシュと主メモリーとで一貫していることを保証します。

システム全体のグラフィック ロックメカニズムに 関連した呼び出しプロセスについての情報を 提供します (GCLOCK 参照)。GCSLOT リクエストは実際のロック機能を行いません。 ロックの情報が呼び出しプロセスにデータ構造体 crt_gcslot_t で返されます。 パラメータは crt_gcslot_t *arg; として定義されています。 データ構造体 crt_gcslot_t は <sys/framebuf.h> で定義されています。

内蔵ターミナルエミュレータ (ITE) のデバイスのカラーマップの変更を 禁止します。

内蔵ターミナルエミュレータ (ITE) のデバイスのカラーマップの変更を 許可します。

GCMAP をリクエストしているとき、パラメータ arg は無視して 0 にセットしてください。

出力時サポートしたすべての ITE はフレームバッファーを無視します。

GCID コールおよび GCDESCRIBE コールで、データ構造体 crt_frame_buffer_t のフィールド crt_id に返されるデバイス識別定数は次のようになっています。

メモリーマップ グラフィック協調プロセッサが使用可能な場合、それは GCMAP の結果として他のグラフィックとともにマップされ、そのアドレスは GCDESCRIBE コールにより、crt の範囲の配列に最後のエントリーとして記録されます。

次のデバイス識別定数が、GCID コールおよび GCDESCRIBE コールによりデータ構造体 crt_frame_buffer_t のフィールド crt_id に返されます。

HPA1047A インタフェースカードの場合、構造体 crt_dma_info のフィールドには次の制限条項があります。

操作が呼び出しプロセスの停止を引き起こしましたが、リクエストは GCLOCK_NOWAIT または GCLOCK_BLOCKSIG_NOWAIT です。

デバイスをロックしようとしましたが、すでに同じプロセスにより ロックされていました。

ioctl() コールがシグナルにより停止させられました。

無効な ioctl() コマンドを行いました。

デバイス上で read() または write() のシステムコールを行おうとしました。

十分なメモリーを取得できませんでした。

要求したリソースを取得できませんでした。

デバイスファイルのマイナー番号が存在しないデバイスを参照しています。

GCUNLOCK ioctl() コマンドを要求したが、デバイスは違うプロセスにロックされていました。