名称
nis_server, nis_mkdir, nis_rmdir, nis_servstate, nis_stats,
nis_getservlist, nis_freeservlist, nis_freetags ― その他の NIS+ 関数
構文
cc [ flag
... ] file... -lnsl [ library... ]
#include <rpcsvc/nis.h>
nis_error nis_mkdir(const nis_name dirname,
const nis_server *machine);
nis_error nis_rmdir(const nis_name dirname,
const nis_server *machine);
nis_error nis_servstate(const nis_server *machine,
const nis_tag *tags,
const int numtags,
nis_tag **result);
nis_error nis_stats(const nis_server *machine,
const nis_tag *tags,
const int numtags,
nis_tag **result);
void nis_freetags(nis_tag *tags,
const int numtags);
nis_server **nis_getservlist(const nis_name dirname);
void nis_freeservlist(nis_server **machines);
説明
これらの関数は、NIS+ アプリケーションにさまざまなサービスを提供します。
nis_mkdir() を使用すると、 サーバ machine 上のディレクトリ dirname に NIS+ サービスをサポートするデータベースを作成します。
この操作が正常終了するとディレクトリオブジェクトが更新され、サーバ machine は指定のディレクトリ dirname に対して機能するようになります。 nis_server 構造体についての説明は、 nis_objects(3N) を参照してください。
nis_rmdir() を使用して、ディレクトリ dirname を指定のマシンから削除します。 machine パラメータは NULL であってはなりません。 nis_server 構造体についての説明は、 nis_objects(3N) を参照してください。
nis_servstate() を使用して、 NIS+ サーバのさまざまな状態変数の設定や読み取りを行います。
特に、サーバの内部デバッギング状態を設定したり照会することができます。
nis_stats() を使用して、サーバの運用に関する統計情報を取り出します。
管理者はこの統計情報を追跡して、レプリカを追加したり、ドメインを
2 つ以上のサブドメインに分割したりする判断の参考にします。 統計情報を読み取る方法については、 nisstat(1M) を参照してください。
nis_servstate() と nis_stats() はタグリストを使用します。
このタグリストは可変長配列の nis_tag 構造体で、この長さは numtags パラメータで関数に渡されます。 有効な一連のタグは <rpcsvc/nis.h> にインクルードされているファイル <rpcsvc/nis_tags.h> で定義されます。
タグは NIS+ サービスの実装方法に応じて多種にわたっているので、サポートされているリストをこのファイルで調べるようにしてください。
認識されないタグをサーバに渡すと、 tag_value メンバーが文字列 ``unknown'' に設定されます。 上記のどちらの関数も
malloc されたタグ構造体の *result に結果を戻します。 エラーが発生すると、 *result は NULL に設定されます。 tag_value ポインタは、結果の入っている文字列メモリをポイントします。
タグ構造体を解放するには、 nis_freetags() を使用します。
nis_getservlist() は、リストがヌルで終了する nis_server 構造体を戻します。この構造体は、 dirname のドメインに機能するサーバのリストを表しています。
NIS+ サーバの名前を必要とする関数を呼び出すときは、このリスト中のサーバを使用します。 nis_server 構造体についての説明は、 nis_objects(3N) を参照してください。 nis_freeservlist() は、 nis_getservlist() で戻されたサーバのリストを解放します。
この関数が、このリストを解放できる唯一の手段です。
マルチスレッドの使用法
| Thread
Safe: | | Yes |
| Cancel Safe: | | Yes |
| Fork Safe: | | No |
| Async-cancel Safe: |
| | | No |
| Async-signal Safe: |
| | | No |
これらの関数は、マルチスレッド環境で支障なく呼び出すことができます。
これらの関数は、キャンセルポイントの関数を呼び出した時点でキャンセルポイントになります。
マルチスレッド環境では fork() の後および exec() の前で、子プロセスからこれらの関数を呼び出すことは安全ではありません。
非同期キャンセル、または、非同期シグナルをサポートするマルチスレッドアプリケーションでこれらの関数は呼び出さないようにしてください。
警告
HP-UX 11i Version 2 は、NIS+ がサポートされる最後の HP-UX
リリースです。
NIS+ の代わりに LDAP を推奨します。 HP は、LDAP に基づく業界標準のネームサービスを完全にサポートします。
印刷用画面へ 
