Manual Pages for UNIX Operating System command usage for man SLPFindAttrs

Service Location Protocol Library Functions    SLPFindAttrs(3SLP)



NAME
     SLPFindAttrs - return service attributes

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

     SLPError SLPFindAttrs(SLPHandle hSLP, const char *pcURL,
          const char *pcScopeList, const char *pcAttrIds,
          SLPAttrCallback *callback, void *pvCookie);


DESCRIPTION
     The  SLPFindAttrs()  function  returns  service   attributes
     matching  the attribute tags for the  indicated full or par-
     tial URL.If pcURL is a complete URL, the attribute  informa-
     tion returned is for that particular service in the language
     locale of the  SLPHandle. If pcURL is a service  type,  then
     all  attributes  for the service type  are returned, regard-
     less of the language of registration. Results  are  returned
     through the callback parameter.


     The result is  filtered   with  an  SLP  attribute   request
     filter   string   parameter,   the   syntax   of   which  is
     described  in  RFC 2608.  If   the  filter  string  is   the
     empty string,  "",  all  attributes are returned.


     If an error occurs in starting the  operation,  one  of  the
     SLPError codes is returned.

PARAMETERS
     hSLP           The language-specific SLPHandle on  which  to
                    search for attributes. It cannot  be NULL.


     pcURL          The full or partial URL.  See  RFC  2608  for
                    partial URL syntax. It cannot  be NULL.


     pcScopeList    A pointer  to  a  char  containing  a  comma-
                    separated   list   of  scope names. It cannot
                    be NULL or an empty string, "".


     pcAttrIds      The filter  string indicating   which  attri-
                    bute   values  to  return. Use  empty  string
                    ""  to indicate all values.  Wildcards match-
                    ing   all attribute ids  having  a particular
                    prefix or suffix are also possible. It cannot
                    be NULL.



SunOS 5.11          Last change: 16 Jan 2003                    1






Service Location Protocol Library Functions    SLPFindAttrs(3SLP)



     callback       A callback function through which the results
                    of  the  operation are reported. It cannot be
                    NULL.


     pvCookie       Memory passed to the callback code  from  the
                    client. It may 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 Returning Service Attributes for a Specific URL


     Use the following example to return  the  attributes  "loca-
     tion"        and        "dpi"        for       the       URL
     "service:printer:lpr://serv/queue1"  through  the   callback
     attrReturn:


       SLPHandle hSLP;
       SLPAttrCallback attrReturn;
       SLPError err;

       err = SLPFindAttrs(hSLP "service:printer:lpr://serv/queue1",
            "default", "location,dpi", attrReturn, err);


     Example 2 Returning Service Attributes for  All  URLs  of  a
     Specific Type


     Use the following example to return  the  attributes  "loca-
     tion"   and   "dpi"   for   all  service  URLs  having  type
     "service:printer:lpr":


       err = SLPFindAttrs(hSLP, "service:printer:lpr",
            "default", "location, pi",
            attrReturn, NULL);


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


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



SunOS 5.11          Last change: 16 Jan 2003                    2






Service Location Protocol Library Functions    SLPFindAttrs(3SLP)



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


     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