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)  func-
     tion  or,  if the host name is only partially qualified, the
     concatenation of that value and the name of the NIS+  direc-
     tory.  Note  that  if a machine's name and address cannot be
     found in the local NIS+  directory,  its  hostname  must  be
     fully qualified.

     nis_local_group() returns the name of the current NIS+ group
     name. This is currently set by setting the environment vari-
     able 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 princi-
     pal  name  by  looking  for  a  LOCAL  type  credential (see
     nisaddcred(1M)) in  the  table  named  cred.org_dir  in  the
     default domain.

     Note: The result returned by these routines is a pointer  to
     a  data  structure with the NIS+ library, and should be con-
     sidered 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

SunOS 5.8           Last change: 30 Dec 1996                    1

Networking Services Library Functions       nis_local_names(3NSL)

           returned by nis_local_directory() will be concatenated
           to it.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       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)

SunOS 5.8           Last change: 30 Dec 1996                    2