libslp.3n (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

libslp(3N) libslp(3N)

NAME

libslp: SLPOpen(), SLPClose(), SLPReg(), SLPDereg(), SLPDelAttrs(), SLPFindSrvs(),

SLPFindSrvTypes(), SLPFindAttrs(), SLPParseSrvURL(), SLPEscape(), SLPUnescape(), SLPFree(),

SLPGetRefreshInterval(), SLPFindScopes(), SLPGetProperty(), SLPSetProperty() - SLP (Service Location

Protocol) library routines

SYNOPSIS

#include <slp.h>

cc [ flag... ] file... -lslp [ library... ]

SLPError SLPOpen(

cnst char *lang,

SLPBoolean isasync,

SLPHandle *hslp,

);

void SLPClose(

SLPHandle *hslp

);

SLPError SLPReg(

SLPHandle hslp,

const char* srvurl,

unsigned short lifetime,

const char* srvtype,

const char* attrs,

SLPBoolean fresh,

SLPRegReport callback,

void* cookie

);

SLPError SLPDereg(

SLPHandle hslp,

const char* srvurl,

SLPRegReport callback,

void* cookie

);

SLPError SLPDelAttrs(

SLPHandle hslp,

const char* srvurl,

const char* attrs,

SLPRegReport callback,

void* cookie

);

SLPError SLPFindSrvs(

SLPHandle hslp,

const char* srvtype,

const char* scopelist,

const char* filter,

SLPSrvURLCallback callback,

void* cookie

);

SLPError SLPFindSrvTypes(

SLPHandle hslp,

const char* namingauthority,

const char* scopelist,

SLPSrvURLCallback callback,

void* cookie

);

SLPError SLPFindAttrs(:

SLPHandle hslp,

const char* srvurlorsrvtype,

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)

PAGE 1
libslp(3N) libslp(3N) NAME libslp: SLPOpen(), SLPClose(), SLPReg(), SLPDereg(), SLPDelAttrs(), SLPFindSrvs(), SLPFindSrvTypes(), SLPFindAttrs(), SLPParseSrvURL(), SLPEscape(), SLPUnescape(), SLPFree(), SLPGetRefreshInterval(), SLPFindScopes(), SLPGetProperty(), SLPSetProperty() - SLP (Service Location Protocol) library routines SYNOPSIS #include cc [ flag... ] file... -lslp [ library...
PAGE 2
libslp(3N) libslp(3N) const char* scopelist, const char* attrids, SLPSrvURLCallback callback, void* cookie ); DESCRIPTION The SLP (Service Location Protocol) library routines provide a standard interface for writing application programs that are SLP enabled. The SLP API is an interface that allows programmers to write client and server applications to provide dynamic service discovery and selection. The C language binding presents a minimal overhead implementation that maps directly into the protocol.
PAGE 3
libslp(3N) libslp(3N) callback function as one of the paramaters to the library function, to continue to perform its job, while the result of that operation is being evaluated by the callback function. The callback function is called whenever the API library has results to report. The callback code is required to check the error code parameter before looking at the other parameters. If the error code is not SLP_OK, the other parameters may be NULL or otherwise invalid.
PAGE 4
libslp(3N) libslp(3N) If lifetime is set to SLP_LIFETIME_MAXIMUM, it will remain registered for the lifetime of the calling process. The srvtype parameter is always ignored because the Service URL syntax required for the srvurl parameter encapsulates the service-type. Attributes list consists of comma separated attribute assignment expressions for the registered service. If no attributes are to be provided, use an empty string "" when registering services.
PAGE 5
libslp(3N) libslp(3N) void* cookie) The SLPSrvURLCallback type is the type of the callback function parameter to SLPFindSrvs() function. If the hslp handle parameter was opened asynchronously, the results returned through the callback MAY be uncollated. The callback should return SLP_TRUE if more data is desired. The callback may continue to return SLP_TRUE until it is called with an errcode of SLP_LAST_CALL. If no more data is requested the callback should return SLP_FALSE.
PAGE 6
libslp(3N) libslp(3N) Returns the minimum refresh interval that will be accepted by all SLP SA and DA agents on the network. This call is not implemented and always returns SLP_NOT_IMPLEMENTED. SLPError SLPFindScopes(SLPHandle hslp, char** scopelist) Sets the scopelist parameter to a pointer to a comma separated list of all available scope values. The most desirable values are always placed first in the list. There is always one value, "DEFAULT", in the list.