Manual Pages for UNIX Operating System command usage for man SLPFindScopes

Service Location Protocol Library Functions   SLPFindScopes(3SLP)



NAME
     SLPFindScopes - return list  of  configured  and  discovered
     scopes

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

     SLPError SLPFindScopes(SLPHandle hSLP, char** ppcScopes);


DESCRIPTION
     The SLPFindScopes() function sets  the  ppcScopes  parameter
     to   a  pointer  to  a  comma-separated  list including  all
     available scope  names. The list of  scopes  comes  from   a
     variety   of    sources:   the   configuration   file,   the
     net.slp.useScopes property and the net.slp.DAAddresses  pro-
     perty,   DHCP,   or  through the  DA discovery  process.  If
     there is  any  order  to  the   scopes,   preferred   scopes
     are   listed   before  less   desirable   scopes.  There  is
     always  at  least one  string in the   array,  the   default
     scope,  DEFAULT.


     If no error occurs, SLPFindScopes() returns  SLP_OK,  other-
     wise, it returns the appropriate error code.

PARAMETERS
     hSLP         The SLPHandle on which to  search  for  scopes.
                  hSLP cannot be NULL.


     ppcScopes    A  pointer to  a  char   pointer   into   which
                  the   buffer pointer is placed upon return. The
                  buffer is null-terminated.   The memory  should
                  be    freed    by    calling   SLPFree().   See
                  SLPFree(3SLP)


ERRORS
     This function or its callback may return any SLP error code.
     See the ERRORS section in slp_api(3SLP).

EXAMPLES
     Example 1 Finding Configured or Discovered Scopes


     Use the following example to find configured  or  discovered
     scopes:


       SLPHandle hSLP;



SunOS 5.11          Last change: 16 Jan 2003                    1






Service Location Protocol Library Functions   SLPFindScopes(3SLP)



       char *ppcScopes;
       SLPError err;

       error = SLPFindScopes(hSLP, & ppcScopes);


ENVIRONMENT VARIABLES
     SLP_CONF_FILE    When set, use this file for configuration.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | service/network/slp         |
    |_____________________________|_____________________________|


SEE ALSO
     slpd(1M),   slp_api(3SLP),    SLPFree(3SLP),    slp.conf(4),
     slpd.reg(4), attributes(5)


     System Administration Guide: Network Services


     Guttman, E.,  Perkins, C., Veizades, J.,  and  Day,  M.  RFC
     2608,  Service  Location  Protocol,  Version 2. The Internet
     Society. June 1999.


     Kempf, J. and Guttman, E. RFC 2614, An API for Service Loca-
     tion. The Internet Society. June 1999.

















SunOS 5.11          Last change: 16 Jan 2003                    2