Manual Pages for UNIX Operating System command usage for man SLPReg

Service Location Protocol Library Functions          SLPReg(3SLP)



NAME
     SLPReg - register an SLP advertisement

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

     SLPError SLPReg(SLPHandle hSLP, const char *pcSrvURL,
          const unsigned short usLifetime, const char *pcSrvType,
          const char *pcAttrs, SLPBoolean fresh,
          SLPRegReport callback, void *pvCookie);


DESCRIPTION
     The SLPReg() function registers the  URL  in pcSrvURL   hav-
     ing   the  lifetime  usLifetime with  the attribute  list in
     pcAttrs.   The  pcAttrs list is  a comma-separated  list  of
     attribute   assignments  in  on-the-wire  format  (including
     escaping   of   reserved   characters).     The    sLifetime
     parameter   must   be   nonzero   and  less than or equal to
     SLP_LIFETIME_MAXIMUM. If the fresh  flag is  SLP_TRUE,  then
     the  registration  is  new, the SLP protocol  fresh  flag is
     set, and the registration replaces  any  existing  registra-
     tions.


     The pcSrvType parameter is a service type name  and  can  be
     included  for  service  URLs  that  are  not in the service:
     scheme.   If  the  URL  is  in  the  service:   scheme,  the
     pcSrvType  parameter  is  ignored.   If  the  fresh  flag is
     SLP_FALSE, then an existing registration is  updated.  Rules
     for  new  and  updated  registrations,  and  the  format for
     pcAttrs and pcScopeList, can be found in RFC 2608. Registra-
     tions  and  updates take place in the language locale of the
     hSLP handle.


     The API library is required to perform the operation in  all
     scopes obtained through configuration.

PARAMETERS
     hSLP          The language specific  SLPHandle on  which  to
                   register  the  advertisement.   hSLP cannot be
                   NULL.


     pcSrvURL      The URL  to register.  The value  of  pcSrvURL
                   cannot be NULL  or the  empty  string.


     usLifetime    An unsigned short giving the life time of  the
                   service  advertisement, in seconds.  The value



SunOS 5.11          Last change: 16 Jan 2003                    1






Service Location Protocol Library Functions          SLPReg(3SLP)



                   must be an unsigned integer less than or equal
                   to SLP_LIFETIME_MAXIMUM.


     pcSrvType     The service type. If pURL is  a service:  URL,
                   then this parameter is ignored. pcSrvType can-
                   not be NULL.


     pcAttrs       A   comma-separated    list    of    attribute
                   assignment  expressions for the  attributes of
                   the  advertisement. pcAttrs  cannot  be  NULL.
                   Use  the  empty   string,  "",  to indicate no
                   attributes.


     fresh         An SLPBoolean that is SLP_TRUE if  the  regis-
                   tration  is  new  or   SLP_FALSE  if  it  is a
                   reregistration.


     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 An Initial Registration


     The following example shows an initial registration for  the
     "service:video://bldg15" camera service for three hours:


       SLPError err;
       SLPHandle hSLP;
       SLPRegReport regreport;
       err = SLPReg(hSLP, "service:video://bldg15",
            10800, "", "(location=B15-corridor),
            (scan-rate=100)", SLP_TRUE,
            regRpt, NULL);


ENVIRONMENT VARIABLES




SunOS 5.11          Last change: 16 Jan 2003                    2






Service Location Protocol Library Functions          SLPReg(3SLP)



     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 Loca-
     tion. The Internet Society. June 1999.
























SunOS 5.11          Last change: 16 Jan 2003                    3