/*
 * Copyright 2017-2026 the Pacemaker project contributors
 *
 * The version control history for this file may have further details.
 *
 * This source code is licensed under the GNU Lesser General Public License
 * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
 */

#ifndef PCMK__INCLUDED_CRM_COMMON_INTERNAL_H
#error "Include <crm/common/internal.h> instead of <bundles_internal.h> directly"
#endif

#ifndef PCMK__CRM_COMMON_BUNDLES_INTERNAL__H
#define PCMK__CRM_COMMON_BUNDLES_INTERNAL__H

#include <stdio.h>                          // NULL
#include <stdbool.h>                        // bool, false

#include <crm/common/nodes_internal.h>      // struct pcmk__node_private
#include <crm/common/remote_internal.h>     // pcmk__is_guest_or_bundle_node()
#include <crm/common/resources_internal.h>  // pcmk__rsc_variant_bundle etc.
#include <crm/common/scheduler_types.h>     // pcmk_resource_t, pcmk_node_t

#ifdef __cplusplus
extern "C" {
#endif

//! A single instance of a bundle
typedef struct {
    int offset;                 //!< 0-origin index of this instance in bundle
    char *ipaddr;               //!< IP address associated with this instance
    pcmk_node_t *node;          //!< Copy of node created for this instance
    pcmk_resource_t *ip;        //!< IP address resource for ipaddr
    pcmk_resource_t *child;     //!< Instance of bundled resource
    pcmk_resource_t *container; //!< Container associated with this instance
    pcmk_resource_t *remote;    //!< Pacemaker Remote connection into container
} pcmk__bundle_replica_t;

/*!
 * \internal
 * \brief Check whether a resource is a bundle resource
 *
 * \param[in] rsc  Resource to check
 *
 * \return true if \p rsc is a bundle, otherwise false
 * \note This does not return true if \p rsc is part of a bundle
 *       (see pcmk__is_bundled()).
 */
static inline bool
pcmk__is_bundle(const pcmk_resource_t *rsc)
{
    return (rsc != NULL) && (rsc->priv->variant == pcmk__rsc_variant_bundle);
}

/*!
 * \internal
 * \brief Check whether a resource is part of a bundle
 *
 * \param[in] rsc  Resource to check
 *
 * \return true if \p rsc is part of a bundle, otherwise false
 */
static inline bool
pcmk__is_bundled(const pcmk_resource_t *rsc)
{
    if (rsc == NULL) {
        return false;
    }
    while (rsc->priv->parent != NULL) {
        rsc = rsc->priv->parent;
    }
    return rsc->priv->variant == pcmk__rsc_variant_bundle;
}

/*!
 * \internal
 * \brief Check whether a node is a bundle node
 *
 * \param[in] node  Node to check
 *
 * \return true if \p node is a bundle node, otherwise false
 */
static inline bool
pcmk__is_bundle_node(const pcmk_node_t *node)
{
    return pcmk__is_guest_or_bundle_node(node)
           && pcmk__is_bundled(node->priv->remote);
}

#ifdef __cplusplus
}
#endif

#endif // PCMK__CRM_COMMON_BUNDLES_INTERNAL__H
