xref: /illumos-gate/usr/src/man/man3slp/SLPGetProperty.3slp (revision 241c90a06e8d1708235651863df515a2d522a03a)
te
Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
SLPGETPROPERTY 3SLP "Jan 16, 2003"
NAME
SLPGetProperty - return SLP configuration property
SYNOPSIS

cc [ flag... ] file... -lslp [ library... ]
#include <slp.h>

const char* SLPGetProperty(const char* pcName);
DESCRIPTION

The SLPGetProperty() function returns the value of the corresponding SLP property name, or NULL, if none. If there is no error, SLPGetProperty() returns a pointer to the property value. If the property was not set, it returns the empty string, "". If an error occurs, SLPGetProperty() returns NULL. The returned string should not be freed.

PARAMETERS
pcName

A null-terminated string with the property name. pcName 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 Using SLPGetProperty()

Use the following example to return a list of configured scopes:

const char* useScopes

useScopes = SLPGetProperty("net.slp.useScopes");
ENVIRONMENT VARIABLES
SLP_CONF_FILE

When set, use this file for configuration.

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.