xref: /illumos-gate/usr/src/man/man3slp/SLPGetProperty.3slp (revision 6140ef003e4253c1c1f0b9c100687487e4f1954b)
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 "16 Jan 2003" "SunOS 5.11" "Service Location Protocol Library Functions"
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.