SLPDelAttrs(3SLP) Service Location Protocol Library Functions SLPDelAttrs(3SLP)NAME
SLPDelAttrs - delete attributes
SYNOPSIS
#include <slp.h>
SLPError SLPDelAttrs(SLPHandle hSLP, const char *pcURL, const char *pcAttrs, SLPRegReport *callback, void *pvCookie);
DESCRIPTION
The SLPDelAttrs() function deletes the selected attributes in the locale of the SLPHandle. 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 to delete attributes. It cannot be NULL.
pcURL The URL of the advertisement from which the attributes should be deleted. It cannot be NULL.
pcAttrs A comma-separated list of attribute ids for the attributes to deregister.
callback A callback to report the operation's completion status. It cannot be NULL.
pvCookie Memory passed to the callback code from the client. It cannot 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: Deleting Attributes
Use the following example to delete the location and dpi attributes for the URL service:printer:lpr://serv/queve1
SLPHandle hSLP;
SLPError err;
SLPRegReport report;
err = SLPDelAttrs(hSLP, "service:printer:lpr://serv/queue1",
"location,dpi", report, NULL);
ENVIRONMENT VARIABLES
SLP_CONF_FILE When set, use this file for configuration.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWslpu |
+-----------------------------+-----------------------------+
SEE ALSO slpd(1M), slp_api(3SLP), slp.conf(4), slpd.reg(4), attributes(5)
System Administration Guide: Network Services
Kempf, J. and Guttman, E. RFC 2614, An API for Service Location. The Internet Society. June 1999.
SunOS 5.10 16 Jan 2003 SLPDelAttrs(3SLP)
Check Out this Related Man Page
SLPReg(3SLP) Service Location Protocol Library Functions SLPReg(3SLP)NAME
SLPReg - register an SLP advertisement
SYNOPSIS
#include <slp.h>
SLPError SLPReg(SLPHandle hSLP, const char *pcSrvURL, const unsigned short usLifetime , const char *pcSrvType, const char *pcAttrs, SLP-
Boolean fresh, SLPRegReport callback, void *pvCookie);
DESCRIPTION
The SLPReg() function registers the URL in pcSrvURL having 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 pro-
tocol fresh flag is set, and the registration replaces any existing registrations.
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. Registrations 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 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 cannot be NULL.
pcAttrs A comma-separated list of attribute assignment expressions for the attributes of the advertisement. pcAttrs can-
not be NULL. Use the empty string, "",
to indicate no attributes.
fresh An SLPBoolean that is SLP_TRUE if the registration 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
SLP_CONF_FILE When set, use this file for configuration.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWslpu |
+-----------------------------+-----------------------------+
SEE ALSO slpd(1M), slp_api(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 Location. The Internet Society. June 1999.
SunOS 5.10 16 Jan 2003 SLPReg(3SLP)