書式
#include <sys/types.h>
int modify_ldt(int func, void *ptr, unsigned long bytecount);
注: このシステムコールには glibc のラッパー関数は存在しない。「注意」の節を参照。
説明
modify_ldt() はプロセスのローカル・ディスクリプタ・テーブル (local descriptor table; ldt) を読み書きする。 ldt は i386 プロセッサで使用されるプロセスごとのメモリ管理テーブルである。 このテーブルに関してのより詳しい情報は Intel 386 processor handbook を 参照すること。func が 0 ならば、 modify_ldt() は ldt を ptr が指しているメモリに読み込む。 読み込むバイト数は実際の ldt のサイズか bytecount より小さい方である。
func が 1 ならば、 modify_ldt() は ldt エントリの一つを変更する。 ptr は user_desc 構造体を指し、 bytecount はこの構造体の大きさに等しくなければならない。
user_desc 構造体は <asm/ldt.h> で以下のように定義されている:
struct user_desc {
unsigned int entry_number;
unsigned long base_addr;
unsigned int limit;
unsigned int seg_32bit:1;
unsigned int contents:2;
unsigned int read_exec_only:1;
unsigned int limit_in_pages:1;
unsigned int seg_not_present:1;
unsigned int useable:1;
};
Linux 2.4 以前では、この構造体は modify_ldt_ldt_s という名前であった。
返り値
成功した場合は、 modify_ldt() は (読み込みの場合は) 実際に読み込んだバイト数、 または (書き込みの場合は) 0 を返す。 失敗した場合は modify_ldt() は -1 を返し、 errno をエラーを示す値に設定する。エラー
- EFAULT
- ptr がアドレス空間の外を指している。
- EINVAL
- ptr が 0 である、 または func が 1 で bytecount が modify_ldt_ldt_s 構造体のサイズと等しくないか、 func が 1 で新しい ldt エントリが無効な値である。
- ENOSYS
- func が 0 でも 1 でもない。
準拠
このコールは Linux 特有であり、移植を意図したプログラムでは 使用してはいけない。注意
glibc はこのシステムコールに対するラッパー関数を提供していない。 syscall(2) を使って呼び出すこと。この文書について
この man ページは Linux man-pages プロジェクトのリリース 3.65 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。