2 * Copyright (c) 2017 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 #ifndef __VOM_DUMP_CMD_H__
17 #define __VOM_DUMP_CMD_H__
21 #include "vom/cmd.hpp"
24 #include <vapi/vapi.hpp>
28 * A function type def for calculating a message's size
30 typedef unsigned int (*get_msg_size_t)(void*);
33 * A base class for VPP dump commands.
34 * Dump commands are one of the sub-set of command types to VPP. Here the
36 * makes a read request on the resource and VPP responds with all the
38 * This command is executed synchronously. Once complete the client can
40 * the records from the command object
42 template <typename MSG>
43 class dump_cmd : public cmd
47 typedef typename MSG::resp_type record_t;
49 typedef typename vapi::Result_set<typename MSG::resp_type>::const_iterator
63 virtual ~dump_cmd() {}
65 const_iterator begin() { return (m_dump->get_result_set().begin()); }
67 const_iterator end() { return (m_dump->get_result_set().end()); }
70 * Wait for the issue of the command to complete
74 std::future_status status;
75 std::future<rc_t> result;
77 result = m_promise.get_future();
78 status = result.wait_for(std::chrono::seconds(5));
80 if (status != std::future_status::ready) {
81 return (rc_t::TIMEOUT);
84 return (result.get());
88 * Call operator called when the dump is complete
90 vapi_error_e operator()(MSG& d)
92 m_promise.set_value(rc_t::OK);
98 * Retire/cancel a long running command
100 virtual void retire(connection& con) {}
104 * The underlying promise that implements the synchornous nature
105 * of the command issue
107 std::promise<rc_t> m_promise;
110 * Dump commands should not be issued whilst the HW is disabled
115 * The HW::cmd_q is a friend so it can call suceedded.
117 friend class HW::cmd_q;
120 * The VAPI event registration
122 std::unique_ptr<MSG> m_dump;
127 * fd.io coding-style-patch-verification: ON
130 * eval: (c-set-style "mozilla")