Technical Reference: Communications, Volume 1

nis_local_directory (NIS+ API)

Purpose

Returns the name of the NIS+ domain for this machine.

Syntax

cc [ flag . . . ] file. . . -lnsl [ library. . . ]

#include <rpcsvc/nis.h>

nis_name nis_local_directory(void)

Description

One of a group of NIS+ APIs that return several default NIS+ names associated with the current process, nis_local_directory( ) returns the name of the NIS+ domain for this machine. This is currently the same as the Secure RPC domain returned by the sysinfo(2) system call.

Note: The result returned by this routine is a pointer to a data structure with the NIS+ library, and should be considered a "read-only" result and should not be modified.

Environment

nis_group

This variable contains the name of the local NIS+ group. If the name is not fully qualified, the value returned by nis_local_directory( ) will be concatenated to it.

Related Information

nis_add_entry, nis_first_entry, nis_list, nis_lookup, nis_modify_entry, nis_next_entry, nis_perror, nis_remove_entry, and nis_sperror.

Network Information Services+ and NIS+ Namespace and Structure in AIX 5L Version 5.1 Network Information Services (NIS and NIS+) Guide.

TCP/IP Protocols in AIX 5L Version 5.1 System Management Guide: Communications and Networks.

List of NIS and NIS+ Programming References and Remote Procedure Call (RPC) Overview for Programming in AIX 5L Version 5.1 Communications Programming Concepts.