manページ  — LOGIN_CLASS

#include <sys/types.h>

#include <login_cap.h>

これらの関数は、ログインクラスデータベース関して login_cap(3) のマニュアルに記載されているインタフェースより高次のインタフェースを 提供します。これらの関数が使用されるのは、リソースに関する限界値や、 環境およびシステムにログインするユーザへの課金の設定、およびログインクラス に基づくシステムデーモンの設定と環境の適切な組を設定するときです。これらの 関数呼び出しは、現在のプロセスが root 権限で実行されているときだけ 可能です。LOGIN_SETLOGIN フラグが使用される場合、この関数は setlogin(2) の呼び出しを実行し、当該関数についてはマニュアルページに説明してある注意を 払う必要があります。これは同一のセッションで実行されているすべてのプロセス に影響をあたえますが、現在のプロセスが影響を受けることはありません。

setclasscontext() は、種々の、指定された名前付クラスの値に基づくクラス のコンテキスト値 (リソースの限界値、umask やプロセスの優先順位) を 設定します。

setusercontext() は、指定された login_cap_t オブジェクト、 指定された passwd レコード (login_cap_t が nullの場合) に基づく、クラスのコンテキストバリューを設定します。 また最新のセッションへのログインや、 最新のプロセスのユーザおよびグループの所有者を設定します。 これらの関数は、それぞれ flags パラメータで渡されたビットフラグにより選択でき、次に示す中の 複数のものから構成されます。

LOGIN_SETLOGIN	現在のセッションと関連を持つログインに passwd 構造で定義されたユーザを対応させます。 setlogin(2) このオプションが使用される場合、 pwd パラメータは NULL 値以外を指定する必要があります。
LOGIN_SETUSER	現在のプロセスの所有者に、 setuid(2) を使用して uid パラメータで指定された uid を設定します。
LOGIN_SETGROUP	現在のプロセスのグループとしての所有者に、 setgid(2) を使用して passwd 構造で定義されたグループ識別子を設定します。 また、 initgroups(3) 呼出を実行して現在のプロセスに 関するグループのアクセスリストを整えます。 pwd パラメータは、このオプションが使用される場合、 NULL 以外の値を指定する必要があります。
LOGIN_SETRESOURCES
	システムのログインクラスデータベースで定義される 設定値に基づき現在のプロセスのリソースの限界値を設定します。クラス権限タグ は、-cur (ソフトリミット) または -max (ハードリミット) の接尾語と次に示す リソース設定子を適切に組み合わせて使用します。 cputime RLIMIT_CPU filesize RLIMIT_FSIZE datasize RLIMIT_DATA stacksize RLIMIT_STACK coredumpsize RLIMIT_CORE memoryuse RLIMIT_RSS memorylocked RLIMIT_MEMLOCK maxproc RLIMIT_NPROC openfiles       RLIMIT_NOFILE sbsize          RLIMIT_SBSIZE
LOGIN_SETPRIORITY	システムのログインクラスデータベースで定義された 値に基づき、現プロセスのスケジュール時の優先順位を設定します。使用される クラス権限タグは次のとおりです。 priority
LOGIN_SETUMASK	現在のプロセスの umask にユーザまたはシステムの ログインクラスデータベースでの値を設定します。 使用されるクラス権限タグは次のとおりです。 umask
LOGIN_SETPATH	ユーザまたはシステムのログインクラスデータベースに基づく値を amp;'path' および 'manpath' 環境変数に設定します。該当する環境変数 セットとともに使用されるクラス権限タグは次のとおりです。 path PATH manpath MANPATH
LOGIN_SETENV	ユーザまたはシステムのログインクラスデータベースに 基づく値を種々の環境変数に設定します。該当する環境変数セットとともに 使用されるクラス権限タグは次のとおりです。 lang LANG charset MM_CHARSET timezone TZ term TERM 環境変数の追加として、リスト型の 権限設定 'setenv=var1 val1,var2 val2..,varN valN ' を使用できます。
LOGIN_SETALL	上記の設定をすべて可能にします。

環境変数の設定時と適切な passwd ポインタが pwd により与えられる場合、文字 ‘amp;~’ と ‘amp;$’ はそれぞれユーザのホームディレクトリおよびログイン名と 置きかえられことがあることに注意してください。

関数 setclassresources() および setclassenvironment() は、上記コンテキスト設定の関数の サブセットですが、単独でも使用できます。

setclasscontext() および setusercontext() は、エラーが起きた場合 -1 を返します。 正常終了の場合 0 を返します。 ユーザ、ログイン、グループまたはリソースの設定を行っている最中に エラーが起きた場合、LOG_ERR の優先順位によりメッセージが syslog(3) に通知され、現在アクティブ状態の機能に通知されます。

setgid(2), setlogin(2), setuid(2), getcap(3), initgroups(3), login_cap(3), login.conf(5), termcap(5)