nis_local_names(3NSL)				       Networking Services Library Functions				     nis_local_names(3NSL)

NAME

       nis_local_names, nis_local_directory, nis_local_host, nis_local_group, nis_local_principal - NIS+ local names

SYNOPSIS

       cc [ flag ... ] file ... -lnsl [ library ... ]
       #include <rpcsvc/nis.h>

       nis_name nis_local_directory(void);

       nis_name nis_local_host(void);

       nis_name nis_local_group(void);

       nis_name nis_local_principal(void);

DESCRIPTION

       These functions 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.

       nis_local_host() returns the  NIS+ name of the current machine. This is the fully qualified name for the  host  and  is	either	the  value
       returned by the	gethostname(3C) function or, if the host name is only partially qualified, the concatenation of that value and the name of
       the NIS+ directory. Note that if a machine's name and address cannot be found in the local NIS+ directory, its hostname must be fully qual-
       ified.

       nis_local_group()  returns  the name of the current NIS+ group name. This is currently set by setting the environment variable NIS_GROUP to
       the groupname.

       nis_local_principal() returns the  NIS+ principal name for the user associated with the effective UID of the calling process. This function
       maps  the effective uid into a principal name by looking for a LOCAL type credential in the table named cred.org_dir in the default domain.
       See nisaddcred(1M).

       The result returned by these routines 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 VARIABLES

       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.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       nisdefaults(1), nisaddcred(1M), sysinfo(2), gethostname(3C), nis_names(3NSL), nis_objects(3NSL), attributes(5)

NOTES

       NIS+ might not be supported in future releases of the SolarisTM Operating Environment. Tools to aid the migration from  NIS+  to  LDAP  are
       available in the Solaris 9 operating environment. For more information, visit http://www.sun.com/directory/nisplus/transition.html.

SunOS 5.10							    18 Dec 2001 					     nis_local_names(3NSL)