Manual Pages for UNIX Operating System command usage for man SLPDereg

Service Location Protocol Library Functions        SLPDereg(3SLP)



NAME
     SLPDereg - deregister the SLP advertisement

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

     SLPError SLPDereg(SLPHandle hSLP, const char *pcURL,
          SLPRegReport callback, void *pvCookie);


DESCRIPTION
     The SLPDereg() function deregisters  the  advertisement  for
     URL  pcURL in all scopes where the service is registered and
     in all language locales, not just the locale of the  SLPHan-
     dle.  If  no error occurs, the return value is 0. Otherwise,
     one of the SLPError codes is returned.

PARAMETERS
     hSLP        The language  specific   SLPHandle  to  use  for
                 deregistering. hSLP cannot be NULL.


     pcURL       The URLto deregister. The value of pcURL  cannot
                 be NULL.


     callback    A callback to report  the  operation  completion
                 status. callback cannot be NULL.


     pvCookie    Memory passed to  the  callback  code  from  the
                 client.  pvCookie can be NULL.


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

EXAMPLES
     Example 1 Using SLPDereg()


     Use the following example to  deregister  the  advertisement
     for the URL "service:ftp://csserver":


       SLPerror err;
       SLPHandle hSLP;
       SLPRegReport regreport;

       err = SLPDereg(hSLP, "service:ftp://csserver", regreport, NULL);



SunOS 5.11          Last change: 16 jan 2003                    1






Service Location Protocol Library Functions        SLPDereg(3SLP)



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),  slp.conf(4),  slpd.reg(4),  attri-
     butes(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
     Location, The Internet Society, June 1999.























SunOS 5.11          Last change: 16 jan 2003                    2