30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen/*
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * CDDL HEADER START
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen *
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * The contents of this file are subject to the terms of the
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * Common Development and Distribution License (the "License").
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * You may not use this file except in compliance with the License.
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen *
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * or http://www.opensolaris.org/os/licensing.
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * See the License for the specific language governing permissions
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * and limitations under the License.
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen *
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * When distributing Covered Code, include this CDDL HEADER in each
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * If applicable, add the following below this CDDL HEADER, with the
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * fields enclosed by brackets "[]" replaced with your own identifying
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * information: Portions Copyright [yyyy] [name of copyright owner]
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen *
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * CDDL HEADER END
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen/*
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * Use is subject to license terms.
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#ifndef _LIBDS_H
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#define _LIBDS_H
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#ifdef __cplusplus
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern "C" {
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#endif
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#include <sys/types.h>
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen/*
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * LDOMs User Domain Services library Interfaces
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensentypedef uint64_t ds_hdl_t; /* service handle */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensentypedef uint64_t ds_domain_hdl_t; /* domain handle */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensentypedef void *ds_cb_arg_t; /* client callback arg */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#define DS_INVALID_HDL (0) /* a ds handle cannot be zero */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen/*
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * LDOMs User Domain Services versioning
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensentypedef struct ds_ver {
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen uint16_t major;
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen uint16_t minor;
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen} ds_ver_t;
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen/*
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * LDOMs User Domain Services capability
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensentypedef struct ds_capability {
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen char *svc_id; /* service identifier */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen ds_ver_t *vers; /* list of supported versions */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen uint_t nvers; /* number of supported versions */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen} ds_capability_t;
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen/*
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen * LDOMs User Domain Services event callbacks
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen */
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensentypedef struct ds_ops {
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen void (*ds_reg_cb)(ds_hdl_t hdl, ds_cb_arg_t arg, ds_ver_t *ver,
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen ds_domain_hdl_t dhdl);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen void (*ds_unreg_cb)(ds_hdl_t hdl, ds_cb_arg_t arg);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen void (*ds_data_cb)(ds_hdl_t hdl, ds_cb_arg_t arg, void *buf,
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen size_t buflen);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen ds_cb_arg_t cb_arg;
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen} ds_ops_t;
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_init(void);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_svc_reg(ds_capability_t *cap, ds_ops_t *ops);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_clnt_reg(ds_capability_t *cap, ds_ops_t *ops);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_hdl_lookup(char *service, boolean_t is_client, ds_hdl_t *hdlsp,
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen uint_t maxhdls, uint_t *nhdlsp);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_domain_lookup(ds_hdl_t hdl, ds_domain_hdl_t *dhdlp);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_unreg_hdl(ds_hdl_t hdl);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_send_msg(ds_hdl_t hdl, void *buf, size_t buflen);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_recv_msg(ds_hdl_t hdl, void *buf, size_t buflen,
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen size_t *msglen);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_isready(ds_hdl_t hdl, boolean_t *is_ready);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_dom_name_to_hdl(char *domain_name, ds_domain_hdl_t *dhdlp);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern int ds_dom_hdl_to_name(ds_domain_hdl_t dhdl, char *domain_name,
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen uint_t maxnamlen);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern void ds_unreg_svc(char *service, boolean_t is_client);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensenextern void ds_fini(void);
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#ifdef __cplusplus
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen}
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#endif
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen
30588217a56ff2c9137248fb2e5065c4f0101459Mike Christensen#endif /* _LIBDS_H */