Networking Services Library Functions            nisserver(3NSL)



NAME
     nisserver, nismkdir, nisrmdir, nisservstate,  nisstats,
     nisgetservlist,  nisfreeservlist,  nisfreetags  - miscel-
     laneous NIS] functions

SYNOPSIS
     cc [ flag... ] file... -lnsl [ library... ]
     #include 

     niserror nismkdir(nisname dirname, nisserver *machine);


     niserror nisrmdir(nisname dirname, nisserver *machine);


     niserror nisservstate(nisserver *machine, nistag *tags, int numtags,
          nistag **result);


     niserror nisstats(nisserver *machine, nistag *tags, int numtags,
          nistag **result);


     void nisfreetags(nistag *tags, int numtags);


     nisserver **nisgetservlist(nisname dirname);


     void nisfreeservlist(nisserver **machines);


DESCRIPTION
     These functions provide  a  variety  of  services  for  NIS]
     applications.


     The nismkdir() function is used  to  create  the  necessary
     databases  to support NIS] service for a directory, dirname,
     on a server, machine. If this operation  is  successful,  it
     means  that the directory object describing dirname has been
     updated to reflect that server machine is serving the  named
     directory.  For  a  description of the nisserver structure,
     refer to nisobjects(3NSL).


     Per-server and per-directory access restrictions  can  apply
     to the nismkdir() function. See nisopaccess(1).


     The nisrmdir() function is used to  delete  the  directory,
     dirname,  from  the  specified  server  machine. The machine



SunOS 5.11          Last change: 10 Nov 2005                    1






Networking Services Library Functions            nisserver(3NSL)



     parameter cannot be NUL. The nisrmdir() function does  not
     remove  the directory dirname from the namespace or remove a
     server from the server list  in  the  directory  object.  To
     remove   a  directory  from  the  namespace  you  must  call
     nisremove()  to  remove  the  directory  dirname  from  the
     namespace  and  call  thenisrmdir()  for each server in the
     server list to remove the  directory  from  the  server.  To
     remove  a  replica  from  the server list, you need to first
     call nismodify() to remove the server  from  the  directory
     object and then call nisrmdir() to remove the replica.


     Per-server and per-directory access restrictions  can  apply
     to nisrmdir(). See nisopaccess(1).


     For a description of  the  nisserver  structure,  refer  to
     nisobjects(3NSL).


     The nisservstate() function is used to  set  and  read  the
     various  state  variables of the NIS] servers. In particular
     the internal debugging state of the servers can be  set  and
     queried.


     The nisstats() function  is  used  to  retrieve  statistics
     about how the server is operating. Tracking these statistics
     can help administrators determine  when  they  need  to  add
     additional replicas or to break up a domain into two or more
     subdomains. For more information on reading statistics,  see
     nisstat(1M)


     The nisservstate() and nisstats() functions  use  the  tag
     list.  The  tag  list  is a variable length array of nistag
     structures whose length is passed to  the  function  in  the
     numtags  parameter. The set of legal tags are defined in the
     file        which    is    included    in
     .  Because  these tags can and do vary between
     implementations of the NIS] service, it is best  to  consult
     this  file for the supported list. Passing unrecognized tags
     to a server will result in their tagvalue member being  set
     to  the string unknown. Both of these functions return their
     results in malloced tag structure, *result. If there  is  an
     error, *result is set to NUL. The tagvalue pointers points
     to allocated string memory which contains the  results.  Use
     nisfreetags() to free the tag structure.


     Per-server and per-directory access restrictions  can  apply
     to  the NISERVSTATE or NISTATUS (nisstats()) operations



SunOS 5.11          Last change: 10 Nov 2005                    2






Networking Services Library Functions            nisserver(3NSL)



     and their sub-operations (tags). See nisopaccess(1).


     The nisgetservlist() function  returns  a  null  terminated
     list  of  nisserver  structures  that represent the list of
     servers that serve the domain named  dirname.  Servers  from
     this  list  can  be used when calling functions that require
     the name  of  a  NIS]  server.  For  a  description  of  the
     nisserver  refer  to  nisobjects(3NSL). nisfreeservlist()
     frees the list  of  servers  list  of  servers  returned  by
     nisgetservlist().  Note  that this is the only legal way to
     free that list.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     nisopaccess(1),        nisstat(1M),         nisnames(3NSL),
     nisobjects(3NSL), nissubr(3NSL), attributes(5)

NOTES
     NIS] might not  be  supported  in  future  releases  of  the
     Solaris  operating  system.  Tools to aid the migration from
     NIS] to LDAP are available in the current  Solaris  release.
     For            more            information,            visit
     http:/www.sun.com/directory/nisplus/transition.html.



















SunOS 5.11          Last change: 10 Nov 2005                    3