// Copyright (c) 2021 PaddlePaddle Authors. All Rights Reserved. // // 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. #include "paddle/fluid/distributed/fleet_executor/interceptor.h" #include "paddle/fluid/distributed/fleet_executor/carrier.h" #include "paddle/fluid/distributed/fleet_executor/message_bus.h" #include "paddle/fluid/distributed/fleet_executor/task_node.h" namespace paddle { namespace distributed { Interceptor::Interceptor(int64_t interceptor_id, TaskNode* node) : interceptor_id_(interceptor_id), node_(node) { interceptor_thread_ = std::thread([this]() { VLOG(3) << "Interceptor " << interceptor_id_ << " starts the thread pooling it's local mailbox."; PoolTheMailbox(); }); } Interceptor::~Interceptor() { Join(); } void Interceptor::Join() { if (interceptor_thread_.joinable()) { interceptor_thread_.join(); } } void Interceptor::RegisterMsgHandle(MsgHandle handle) { handle_ = handle; } void Interceptor::Handle(const InterceptorMessage& msg) { if (handle_) { handle_(msg); } else { VLOG(3) << "Interceptor is using default message handler. This handler is " "only used for test purpose. Check whether you init interceptor " "in the proper way."; if (msg.message_type() == DATA_IS_READY) { VLOG(3) << "Fake handler is sending stop message to it self."; InterceptorMessage msg; msg.set_message_type(STOP); Send(interceptor_id_, msg); } else if (msg.message_type() == STOP) { stop_ = true; StopCarrier(); } } } void Interceptor::StopCarrier() { Carrier& carrier_instance = Carrier::Instance(); std::condition_variable& cond_var = carrier_instance.GetCondVar(); // probably double notify, but ok for ut cond_var.notify_all(); } std::condition_variable& Interceptor::GetCondVar() { // get the conditional var return cond_var_; } int64_t Interceptor::GetInterceptorId() const { // return the interceptor id return interceptor_id_; } bool Interceptor::EnqueueRemoteInterceptorMessage( const InterceptorMessage& interceptor_message) { // Called by Carrier, enqueue an InterceptorMessage to remote mailbox VLOG(3) << "Enqueue message: " << interceptor_message.message_type() << " into " << interceptor_id_ << "'s remote mailbox."; std::unique_lock lock(remote_mailbox_mutex_); remote_mailbox_.push(interceptor_message); return true; } bool Interceptor::Send(int64_t dst_id, InterceptorMessage& msg) { msg.set_src_id(interceptor_id_); msg.set_dst_id(dst_id); return MessageBus::Instance().Send(msg); } void Interceptor::PoolTheMailbox() { // pool the local mailbox, parse the Message for (;;) { if (local_mailbox_.empty()) { // local mailbox is empty, fetch the remote mailbox VLOG(3) << interceptor_id_ << "'s local mailbox is empty. " << "Fetch the remote mailbox."; PADDLE_ENFORCE_EQ(FetchRemoteMailbox(), true, platform::errors::InvalidArgument( "Error encountered when fetch remote mailbox.")); } const InterceptorMessage interceptor_message = local_mailbox_.front(); local_mailbox_.pop(); const MessageType message_type = interceptor_message.message_type(); VLOG(3) << "Interceptor " << interceptor_id_ << " has received a message" << " from interceptor " << interceptor_message.src_id() << " with message: " << message_type << "."; Handle(interceptor_message); if (stop_) { // break the pooling thread VLOG(3) << "Interceptor " << interceptor_id_ << " is quiting."; break; } } } bool Interceptor::FetchRemoteMailbox() { // fetch all Message from remote mailbox to local mailbox // return true if remote mailbox not empty, otherwise return false std::unique_lock lock(remote_mailbox_mutex_); cond_var_.wait(lock, [this]() { return !remote_mailbox_.empty(); }); if (remote_mailbox_.empty()) { // the thread has been unblocked accidentally return false; } while (!remote_mailbox_.empty()) { local_mailbox_.push(std::move(remote_mailbox_.front())); remote_mailbox_.pop(); } return true; } static InterceptorFactory::CreateInterceptorMap& GetInterceptorMap() { static InterceptorFactory::CreateInterceptorMap interceptorMap; return interceptorMap; } std::unique_ptr InterceptorFactory::Create(const std::string& type, int64_t id, TaskNode* node) { auto& interceptor_map = GetInterceptorMap(); auto iter = interceptor_map.find(type); PADDLE_ENFORCE_NE( iter, interceptor_map.end(), platform::errors::NotFound("interceptor %s is not register", type)); return iter->second(id, node); } void InterceptorFactory::Register( const std::string& type, InterceptorFactory::CreateInterceptorFunc func) { auto& interceptor_map = GetInterceptorMap(); interceptor_map.emplace(type, func); } } // namespace distributed } // namespace paddle