<
/*
 * Copyright (c) 2017-2019 Cisco and/or its affiliates.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at:
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef __HICN_DPO_MW_H__
#define __HICN_DPO_MW_H__

#include <vnet/dpo/dpo.h>
#include "../strategy_dpo_ctx.h"

typedef struct hicn_strategy_mw_ctx_s
{
  hicn_dpo_ctx_t default_ctx;

  u8 weight[HICN_PARAM_FIB_ENTRY_NHOPS_MAX];
} hicn_strategy_mw_ctx_t;

/**
 * @brief Lock the mw ctx
 *
 * @param dpo Identifier of the dpo of the mw ctx
 */
void hicn_strategy_mw_ctx_lock (dpo_id_t * dpo);

/**
 * @brief Unlock the mw ctx
 *
 * @param dpo Identifier of the dpo of the mw ctx
 */
void hicn_strategy_mw_ctx_unlock (dpo_id_t * dpo);

/**
 * @brief Format the dpo ctx for a human-readable string
 *
 * @param s String to which to append the formatted dpo ctx
 * @param ap List of parameters for the formatting
 *
 * @result The string with the formatted dpo ctx
 */
u8 *format_hicn_strategy_mw_ctx (u8 * s, va_list * ap);

const static dpo_vft_t dpo_strategy_mw_ctx_vft = {
  .dv_lock = hicn_strategy_mw_ctx_lock,
  .dv_unlock = hicn_strategy_mw_ctx_unlock,
  .dv_format = format_hicn_strategy_mw_ctx,
};

/**
 * @brief Retrieve an hicn_strategy_mw_ctx object
 *
 * @param indext Index of the hicn_dpo_ctx to retrieve
 * @return The hicn_dpo_ctx object or NULL
 */
hicn_dpo_ctx_t *hicn_strategy_mw_ctx_get (index_t index);

/**
 * @brief Create a new mw ctx
 *
 * @param proto The protocol to which the dpo is meant for (see vpp docs)
 * @param next_hop A list of next hops to be inserted in the dpo ctx
 * @param nh_len Size of the list
 * @param dpo_idx index_t that will hold the index of the created dpo ctx
 * @return HICN_ERROR_NONE if the creation was fine, otherwise EINVAL
 */
int
hicn_strategy_mw_ctx_create (dpo_proto_t proto, const dpo_id_t * next_hop,
			     int nh_len, index_t * dpo_idx);

/**
 * @brief Add or update a next hop in the dpo ctx.
 *
 * This function is meant to be used in the control plane and not in the data plane,
 * as it is not optimized for the latter.
 *
 * @param nh Next hop to insert in the dpo ctx
 * @param dpo_idx Index of the dpo ctx to update with the new or updated next
 * hop
 * @return HICN_ERROR_NONE if the update or insert was fine,
 * otherwise HICN_ERROR_DPO_CTX_NOT_FOUND
 */
int hicn_strategy_mw_ctx_add_nh (const dpo_id_t * nh, index_t dpo_idx);

/**
 * @brief Delete a next hop in the dpo ctx.
 *
 * @param face_id Face identifier of the next hop
 * @param dpo_idx Index of the dpo ctx to update with the new or updated next
 * hop
 * @return HICN_ERROR_NONE if the update or insert was fine,
 * otherwise HICN_ERROR_DPO_CTS_NOT_FOUND
 */
int
hicn_strategy_mw_ctx_del_nh (hicn_face_id_t face_id, index_t dpo_idx,
			     fib_prefix_t * fib_pfx);

/**
 * @brief Prefetch a dpo
 *
 * @param dpo_idx Index of the dpo ctx to prefetch
 */
void hicn_strategy_mw_ctx_prefetch (index_t dpo_idx);

int hicn_dpo_is_type_strategy_mw (const dpo_id_t * dpo);

void hicn_dpo_strategy_mw_module_init (void);

dpo_type_t hicn_dpo_strategy_mw_get_type (void);

u8 *format_hicn_dpo_strategy_mw (u8 * s, va_list * ap);


#endif // __HICN_DPO_MW_H__

/*
 * fd.io coding-style-patch-verification: ON
 *
 * Local Variables:
 * eval: (c-set-style "gnu")
 * End:
 */