Cross Reference: /ohac/man/man3ha/scds_pmf_get_status.3ha

te
CDDL HEADER START

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 CDDL.txt
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 CDDL.txt.
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]

CDDL HEADER END
Copyright 2008 Sun Microsystems, Inc. All
rights reserved. Use is subject to license terms.

scds_pmf_get_status 3HA "13 Aug 2008" "Sun Cluster 3.2" "Sun Cluster HA and Data Services"

NAME

scds_pmf_get_status - determine if a PMF-monitored process tree exists

SYNOPSIS

cc [flags.\|.\|.] -I /usr/cluster/include file -L /usr/cluster/lib  -l  dsdev
#include <rgm/libdsdev.h>

scha_err_t scds_pmf_get_status(scds_handle_t handle, scds_pmf_type_t program_type,
 int instance,  scds_pmf_status_t*pmf_status);

DESCRIPTION

The scds_pmf_get_status() function determines if the specified instance is being monitored under PMF control. This function is equivalent to the pmfadm(1M) command with the -q option.

PARAMETERS

The following parameters are supported:

.na handle .ad The handle returned from scds_initialize()

.na program_type .ad Type of program to execute. Valid types are:

.na SCDS_PMF_TYPE_SVC .ad Data service application

.na SCDS_PMF_TYPE_MON .ad Fault monitor

.na SCDS_PMF_TYPE_OTHER .ad Other

.na instance .ad For resources with multiple instances, this integer, starting at 0, uniquely identifies the instance. For single instance resources, use 0.

.na pmf_status .ad If PMF is monitoring the specified instance, pmf_status is set to SCDS_PMF_MONITORED. Otherwise it is set to SCDS_PMF_NOT_MONITORED.

RETURN VALUES

The scds_pmf_get_status() function returns the following:

.na 0 .ad The function succeeded.

.na non-zero .ad The function failed.

ERRORS

.na SCHA_ERR_NOERR .ad Function succeeded

See scha_calls(3HA) for a description of other error codes.

FILES

.na /usr/cluster/include/rgm/libdsdev.h .ad Include file

.na /usr/cluster/lib/libdsdev.so .ad Library

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:


ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWscdev
Interface Stability	Evolving

SEE ALSO

pmfadm(1M), scds_initialize(3HA), scha_calls(3HA), attributes(5)