GETAUXVAL

名前

書式

#include <sys/auxv.h>

unsigned long getauxval(unsigned long type);

説明

補助ベクトルの各エントリーは、 このエントリーを示すタイプとそのタイプの値のペアで構成される。 引数 type が指定されると、 getauxval() は対応する値を返す。

それぞれの type に対して返される値の詳細を以下に示す。 すべてのアーキテクチャーですべて type 値が存在するわけではない。

AT_BASE

プログラムインタープリター (通常は動的ローダー) のベースアドレス。

AT_BASE_PLATFORM

A pointer to a string (PowerPC and MIPS only). On PowerPC, this identifies the real platform; may differ from AT_PLATFORM. On MIPS, this identifies the ISA level (since Linux 5.7).

AT_CLKTCK

times(2) のカウントが行われる周波数。 この値は sysconf(_SC_CLK_TCK) でも取得できる。

AT_DCACHEBSIZE

データキャッシュのブロックサイズ。

AT_EGID

このスレッドの実効グループ ID。

AT_ENTRY

実行ファイルのエントリーアドレス。

AT_EUID

このスレッドの実効ユーザー ID。

AT_EXECFD

プログラムのファイルディスクリプター。

AT_EXECFN

A pointer to a string containing the pathname used to execute the program.

AT_FLAGS

フラグ (未使用)。

AT_FPUCW

使用された FPU 制御ワード (SuperH アーキテクチャーのみ)。 カーネルが実行した FPU 初期化に関する情報を提供するためのものである。

AT_GID

このスレッドの実グループ ID。

AT_HWCAP

An architecture and ABI dependent bit-mask whose settings indicate detailed processor capabilities. The contents of the bit mask are hardware dependent (for example, see the kernel source file arch/x86/include/asm/cpufeature.h for details relating to the Intel x86 architecture; the value returned is the first 32-bit word of the array described there). A human-readable version of the same information is available via /proc/cpuinfo.

AT_HWCAP2 (glibc 2.18 以降)

Further machine-dependent hints about processor capabilities.

AT_ICACHEBSIZE

命令キャッシュのブロックサイズ。

AT_L1D_CACHEGEOMETRY

Geometry of the L1 data cache, encoded with the cache line size in bytes in the bottom 16 bits and the cache associativity in the next 16 bits. The associativity is such that if N is the 16-bit value, the cache is N-way set associative.

AT_L1D_CACHESIZE

L1 データキャッシュのサイズ。

AT_L1I_CACHEGEOMETRY

Geometry of the L1 instruction cache, encoded as for AT_L1D_CACHEGEOMETRY.

AT_L1I_CACHESIZE

L1 命令キャッシュのサイズ。

AT_L2_CACHEGEOMETRY

Geometry of the L2 cache, encoded as for AT_L1D_CACHEGEOMETRY.

AT_L2_CACHESIZE

L2 キャッシュのサイズ。

AT_L3_CACHEGEOMETRY

Geometry of the L3 cache, encoded as for AT_L1D_CACHEGEOMETRY.

AT_L3_CACHESIZE

L3 キャッシュのサイズ。

AT_PAGESZ

システムページサイズ (sysconf(_SC_PAGESIZE) が返す値と同じ)。

AT_PHDR

実行プログラムのプログラムヘッダーのアドレス。

AT_PHENT

プログラムヘッダーエントリーのサイズ。

AT_PHNUM

プログラムヘッダー数。

AT_PLATFORM

このプログラムが実行されているハードウェアプラットフォームを特定する文字列へのポインター。 動的リンカーは rpath 値の解釈を行う際にこの値を使用する。

AT_RANDOM

ランダム値が入った 16 バイトがあるアドレス。

AT_SECURE

Has a nonzero value if this executable should be treated securely. Most commonly, a nonzero value indicates that the process is executing a set-user-ID or set-group-ID binary (so that its real and effective UIDs or GIDs differ from one another), or that it gained capabilities by executing a binary file that has capabilities (see capabilities(7)). Alternatively, a nonzero value may be triggered by a Linux Security Module. When this value is nonzero, the dynamic linker disables the use of certain environment variables (see ld-linux.so(8)) and glibc changes other aspects of its behavior. (See also secure_getenv(3).)

AT_SYSINFO

vDSO のシステムコール関数へのエントリーポイント。すべてのアーキテクチャーで存在するわけではなく、 また必要というわけでもない (例えば x86-64 には存在しない)。

AT_SYSINFO_EHDR

仮想動的共有オブジェクト (vDSO; virtual Dynamic Shared Object) が入ったページのアドレス。 vDSO は、 特定のシステムコールの高速な実装を提供するためにカーネルが作成する共有オブジェクトである。

AT_UCACHEBSIZE

ユニファイド (unified) キャッシュのブロックサイズ。

AT_UID

このスレッドの実ユーザー ID。

返り値

エラー

ENOENT (glibc 2.19 以降)

type に対応するエントリーが補助ベクトルになかった。

バージョン

属性

準拠

注意

補助ベクトルには、 単に、 プロセスのアドレス空間の引数リストと環境上に存在するだけである。 プログラム実行時に LD_SHOW_AUXV 環境変数を設定すると、 プログラムに渡された補助ベクトルを表示することができる。

$ LD_SHOW_AUXV=1 sleep 1

任意のプロセスの補助ベクトルは (ファイルのアクセス許可があれば) /proc/[pid]/auxv 経由で取得できる。 詳細は proc(5) を参照。  

バグ

関連項目

この文書について

Index

名前

書式

説明

返り値

エラー

バージョン

属性

準拠

注意

バグ

関連項目

この文書について