unix_command_mgr.cc

Go to the documentation of this file.

// Copyright (C) 2015-2024 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
#include <config.h>
 
#include <asiolink/asio_wrapper.h>
#include <asiolink/interval_timer.h>
#include <asiolink/io_service.h>
#include <asiolink/unix_domain_socket.h>
#include <asiolink/unix_domain_socket_acceptor.h>
#include <asiolink/unix_domain_socket_endpoint.h>
#include <config/command_mgr.h>
#include <config/unix_command_mgr.h>
#include <cc/data.h>
#include <cc/command_interpreter.h>
#include <cc/json_feed.h>
#include <dhcp/iface_mgr.h>
#include <config/config_log.h>
#include <config/timeouts.h>
#include <util/watch_socket.h>
#include <boost/enable_shared_from_this.hpp>
#include <array>
#include <functional>
#include <unistd.h>
#include <sys/file.h>
 
using namespace isc;
using namespace isc::asiolink;
using namespace isc::config;
using namespace isc::data;
using namespace isc::dhcp;
namespace ph = std::placeholders;
 
namespace {
 
const size_t BUF_SIZE = 32768;
 
class ConnectionPool;
 
class Connection : public boost::enable_shared_from_this<Connection> {
public:
 
    Connection(const IOServicePtr& io_service,
               const boost::shared_ptr<UnixDomainSocket>& socket,
               ConnectionPool& connection_pool,
               const long timeout,
               bool use_external)
        : socket_(socket), timeout_timer_(io_service), timeout_(timeout),
          buf_(), response_(), connection_pool_(connection_pool), feed_(),
          response_in_progress_(false), watch_socket_(),
          use_external_(use_external) {
 
        LOG_DEBUG(command_logger, DBG_COMMAND, COMMAND_SOCKET_CONNECTION_OPENED)
            .arg(socket_->getNative());
 
        // Callback value of 0 is used to indicate that callback function is
        // not installed.
        if (use_external_) {
            watch_socket_.reset(new util::WatchSocket());
            IfaceMgr::instance().addExternalSocket(watch_socket_->getSelectFd(), 0);
            IfaceMgr::instance().addExternalSocket(socket_->getNative(), 0);
        }
 
        // Initialize state model for receiving and preparsing commands.
        feed_.initModel();
 
        // Start timer for detecting timeouts.
        scheduleTimer();
    }
 
    ~Connection() {
        timeout_timer_.cancel();
    }
 
    void scheduleTimer() {
        timeout_timer_.setup(std::bind(&Connection::timeoutHandler, this),
                             timeout_, IntervalTimer::ONE_SHOT);
    }
 
    void stop() {
        if (!response_in_progress_) {
            LOG_DEBUG(command_logger, DBG_COMMAND, COMMAND_SOCKET_CONNECTION_CLOSED)
                .arg(socket_->getNative());
 
            if (use_external_) {
                IfaceMgr::instance().deleteExternalSocket(watch_socket_->getSelectFd());
                IfaceMgr::instance().deleteExternalSocket(socket_->getNative());
 
                // Close watch socket and log errors if occur.
                std::string watch_error;
                if (!watch_socket_->closeSocket(watch_error)) {
                    LOG_ERROR(command_logger, COMMAND_WATCH_SOCKET_CLOSE_ERROR)
                        .arg(watch_error);
                }
            }
 
            socket_->close();
            timeout_timer_.cancel();
        }
    }
 
    void terminate();
 
    void doReceive() {
        socket_->asyncReceive(&buf_[0], sizeof(buf_),
                              std::bind(&Connection::receiveHandler,
                                        shared_from_this(), ph::_1, ph::_2));
    }
 
    void doSend() {
        size_t chunk_size = (response_.size() < BUF_SIZE) ? response_.size() : BUF_SIZE;
        socket_->asyncSend(&response_[0], chunk_size,
           std::bind(&Connection::sendHandler, shared_from_this(), ph::_1, ph::_2));
 
        if (use_external_) {
            // Asynchronous send has been scheduled and we need to indicate this
            // to break the synchronous select(). The handler should clear this
            // status when invoked.
            try {
                watch_socket_->markReady();
            } catch (const std::exception& ex) {
                LOG_ERROR(command_logger, COMMAND_WATCH_SOCKET_MARK_READY_ERROR)
                    .arg(ex.what());
            }
        }
    }
 
    //
    void receiveHandler(const boost::system::error_code& ec,
                        size_t bytes_transferred);
 
    void sendHandler(const boost::system::error_code& ec,
                     size_t bytes_transferred);
 
    void timeoutHandler();
 
private:
 
    boost::shared_ptr<UnixDomainSocket> socket_;
 
    IntervalTimer timeout_timer_;
 
    long timeout_;
 
    std::array<char, BUF_SIZE> buf_;
 
    std::string response_;
 
    ConnectionPool& connection_pool_;
 
    JSONFeed feed_;
 
    bool response_in_progress_;
 
    util::WatchSocketPtr watch_socket_;
 
    bool use_external_;
};
 
typedef boost::shared_ptr<Connection> ConnectionPtr;
 
class ConnectionPool {
public:
 
    void start(const ConnectionPtr& connection) {
        connection->doReceive();
        connections_.insert(connection);
    }
 
    void stop(const ConnectionPtr& connection) {
        try {
            connection->stop();
            connections_.erase(connection);
        } catch (const std::exception& ex) {
            LOG_ERROR(command_logger, COMMAND_SOCKET_CONNECTION_CLOSE_FAIL)
                .arg(ex.what());
        }
    }
 
    void stopAll() {
        for (auto const& conn : connections_) {
            conn->stop();
        }
        connections_.clear();
    }
 
private:
 
    std::set<ConnectionPtr> connections_;
 
};
 
void
Connection::terminate() {
    try {
        socket_->shutdown();
 
    } catch (const std::exception& ex) {
        LOG_ERROR(command_logger, COMMAND_SOCKET_CONNECTION_SHUTDOWN_FAIL)
            .arg(ex.what());
    }
}
 
void
Connection::receiveHandler(const boost::system::error_code& ec,
                           size_t bytes_transferred) {
    if (ec) {
        if (ec.value() == boost::asio::error::eof) {
            std::stringstream os;
            if (feed_.getProcessedText().empty()) {
               os << "no input data to discard";
            } else {
               os << "discarding partial command of "
                  << feed_.getProcessedText().size() << " bytes";
            }
 
            // Foreign host has closed the connection. We should remove it from the
            // connection pool.
            LOG_INFO(command_logger, COMMAND_SOCKET_CLOSED_BY_FOREIGN_HOST)
                .arg(socket_->getNative()).arg(os.str());
        } else if (ec.value() != boost::asio::error::operation_aborted) {
            LOG_ERROR(command_logger, COMMAND_SOCKET_READ_FAIL)
                .arg(ec.value()).arg(socket_->getNative());
        }
 
        connection_pool_.stop(shared_from_this());
        return;
 
    } else if (bytes_transferred == 0) {
        // Nothing received. Close the connection.
        connection_pool_.stop(shared_from_this());
        return;
    }
 
    LOG_DEBUG(command_logger, DBG_COMMAND, COMMAND_SOCKET_READ)
        .arg(bytes_transferred).arg(socket_->getNative());
 
    // Reschedule the timer because the transaction is ongoing.
    scheduleTimer();
 
    ConstElementPtr cmd;
    ConstElementPtr rsp;
 
    try {
        // Received some data over the socket. Append them to the JSON feed
        // to see if we have reached the end of command.
        feed_.postBuffer(&buf_[0], bytes_transferred);
        feed_.poll();
        // If we haven't yet received the full command, continue receiving.
        if (feed_.needData()) {
            doReceive();
            return;
        }
 
        // Received entire command. Parse the command into JSON.
        if (feed_.feedOk()) {
            cmd = feed_.toElement();
            response_in_progress_ = true;
 
            // Cancel the timer to make sure that long lasting command
            // processing doesn't cause the timeout.
            timeout_timer_.cancel();
 
            // If successful, then process it as a command.
            rsp = CommandMgr::instance().processCommand(cmd);
 
            response_in_progress_ = false;
 
        } else {
            // Failed to parse command as JSON or process the received command.
            // This exception will be caught below and the error response will
            // be sent.
            isc_throw(BadValue, feed_.getErrorMessage());
        }
 
    } catch (const Exception& ex) {
        LOG_WARN(command_logger, COMMAND_PROCESS_ERROR1).arg(ex.what());
        rsp = createAnswer(CONTROL_RESULT_ERROR, std::string(ex.what()));
    }
 
    // No response generated. Connection will be closed.
    if (!rsp) {
        LOG_WARN(command_logger, COMMAND_RESPONSE_ERROR)
            .arg(cmd ? cmd->str() : "unknown");
        rsp = createAnswer(CONTROL_RESULT_ERROR,
                           "internal server error: no response generated");
 
    } else {
 
        // Reschedule the timer as it may be either canceled or need to be
        // updated to not timeout before we manage to the send the reply.
        scheduleTimer();
 
        // Let's convert JSON response to text. Note that at this stage
        // the rsp pointer is always set.
        response_ = rsp->str();
 
        doSend();
        return;
    }
 
    // Close the connection if we have sent the entire response.
    connection_pool_.stop(shared_from_this());
}
 
void
Connection::sendHandler(const boost::system::error_code& ec,
                        size_t bytes_transferred) {
    if (use_external_) {
        // Clear the watch socket so as the future send operation can mark it
        // again to interrupt the synchronous select() call.
        try {
            watch_socket_->clearReady();
        } catch (const std::exception& ex) {
            LOG_ERROR(command_logger, COMMAND_WATCH_SOCKET_CLEAR_ERROR)
                .arg(ex.what());
        }
    }
 
    if (ec) {
        // If an error occurred, log this error and stop the connection.
        if (ec.value() != boost::asio::error::operation_aborted) {
            LOG_ERROR(command_logger, COMMAND_SOCKET_WRITE_FAIL)
                .arg(socket_->getNative()).arg(ec.message());
        }
 
    } else {
 
        // Reschedule the timer because the transaction is ongoing.
        scheduleTimer();
 
        // No error. We are in a process of sending a response. Need to
        // remove the chunk that we have managed to sent with the previous
        // attempt.
        response_.erase(0, bytes_transferred);
 
        LOG_DEBUG(command_logger, DBG_COMMAND, COMMAND_SOCKET_WRITE)
            .arg(bytes_transferred).arg(response_.size())
            .arg(socket_->getNative());
 
        // Check if there is any data left to be sent and sent it.
        if (!response_.empty()) {
            doSend();
            return;
        }
 
        // Gracefully shutdown the connection and close the socket if
        // we have sent the whole response.
        terminate();
    }
 
    // All data sent or an error has occurred. Close the connection.
    connection_pool_.stop(shared_from_this());
}
 
void
Connection::timeoutHandler() {
    LOG_INFO(command_logger, COMMAND_SOCKET_CONNECTION_TIMEOUT)
        .arg(socket_->getNative());
 
    try {
        socket_->cancel();
 
    } catch (const std::exception& ex) {
        LOG_ERROR(command_logger, COMMAND_SOCKET_CONNECTION_CANCEL_FAIL)
            .arg(socket_->getNative())
            .arg(ex.what());
    }
 
    std::stringstream os;
    os << "Connection over control channel timed out";
    if (!feed_.getProcessedText().empty()) {
        os << ", discarded partial command of "
           << feed_.getProcessedText().size() << " bytes";
    }
 
    ConstElementPtr rsp = createAnswer(CONTROL_RESULT_ERROR, os.str());
    response_ = rsp->str();
    doSend();
}
 
}
 
namespace isc {
namespace config {
 
class UnixCommandMgrImpl {
public:
 
    UnixCommandMgrImpl()
        : io_service_(), acceptor_(), socket_(), socket_name_(),
          connection_pool_(), timeout_(TIMEOUT_DHCP_SERVER_RECEIVE_COMMAND),
          use_external_(true), lock_fd_(-1) {
    }
 
    void openCommandSocket(const isc::data::ConstElementPtr& socket_info);
 
    void closeCommandSocket();
 
    void doAccept();
 
    std::string getLockName() {
        return (std::string(socket_name_ + ".lock"));
    }
 
    IOServicePtr io_service_;
 
    boost::shared_ptr<UnixDomainSocketAcceptor> acceptor_;
 
    boost::shared_ptr<UnixDomainSocket> socket_;
 
    std::string socket_name_;
 
    ConnectionPool connection_pool_;
 
    long timeout_;
 
    bool use_external_;
 
    int lock_fd_;
};
 
void
UnixCommandMgrImpl::openCommandSocket(const isc::data::ConstElementPtr& socket_info) {
    socket_name_.clear();
 
    if (!socket_info) {
        isc_throw(BadSocketInfo, "Missing socket_info parameters, can't create socket.");
    }
 
    ConstElementPtr type = socket_info->get("socket-type");
    if (!type) {
        isc_throw(BadSocketInfo, "Mandatory 'socket-type' parameter missing");
    }
 
    // Only supporting unix sockets right now.
    if (type->stringValue() != "unix") {
        isc_throw(BadSocketInfo, "Invalid 'socket-type' parameter value "
                  << type->stringValue());
    }
 
    // UNIX socket is requested. It takes one parameter: socket-name that
    // specifies UNIX path of the socket.
    ConstElementPtr name = socket_info->get("socket-name");
    if (!name) {
        isc_throw(BadSocketInfo, "Mandatory 'socket-name' parameter missing");
    }
 
    if (name->getType() != Element::string) {
        isc_throw(BadSocketInfo, "'socket-name' parameter expected to be a string");
    }
 
    socket_name_ = name->stringValue();
 
    // First let's open lock file.
    std::string lock_name = getLockName();
    lock_fd_ = open(lock_name.c_str(), O_RDONLY | O_CREAT, 0600);
    if (lock_fd_ == -1) {
        std::string errmsg = strerror(errno);
        isc_throw(SocketError, "cannot create socket lockfile, "
                  << lock_name  << ", : " << errmsg);
    }
 
    // Try to acquire lock. If we can't somebody else is actively
    // using it.
    int ret = flock(lock_fd_, LOCK_EX | LOCK_NB);
    if (ret != 0) {
        std::string errmsg = strerror(errno);
        close(lock_fd_);
        lock_fd_ = -1;
        isc_throw(SocketError, "cannot lock socket lockfile, "
                  << lock_name  << ", : " << errmsg);
    }
 
    // We have the lock, so let's remove the pre-existing socket
    // file if it exists.
    static_cast<void>(::remove(socket_name_.c_str()));
 
    LOG_INFO(command_logger, COMMAND_ACCEPTOR_START)
        .arg(socket_name_);
 
    try {
        // Start asynchronous acceptor service.
        acceptor_.reset(new UnixDomainSocketAcceptor(io_service_));
        UnixDomainSocketEndpoint endpoint(socket_name_);
        acceptor_->open(endpoint);
        acceptor_->bind(endpoint);
        acceptor_->listen();
        if (use_external_) {
            // Install this socket in Interface Manager.
            IfaceMgr::instance().addExternalSocket(acceptor_->getNative(), 0);
        }
 
        doAccept();
 
    } catch (const std::exception& ex) {
        isc_throw(SocketError, ex.what());
    }
}
 
void
UnixCommandMgrImpl::closeCommandSocket() {
    // Close acceptor if the acceptor is open.
    if (acceptor_ && acceptor_->isOpen()) {
        if (use_external_) {
            IfaceMgr::instance().deleteExternalSocket(acceptor_->getNative());
        }
        acceptor_->close();
        static_cast<void>(::remove(socket_name_.c_str()));
        static_cast<void>(::remove(getLockName().c_str()));
    }
 
    // Stop all connections which can be closed. The only connection that won't
    // be closed is the one over which we have received a request to reconfigure
    // the server. This connection will be held until the UnixCommandMgr
    // responds to such request.
    connection_pool_.stopAll();
    if (lock_fd_ != -1) {
        close(lock_fd_);
        lock_fd_ = -1;
    }
}
 
void
UnixCommandMgrImpl::doAccept() {
    // Create a socket into which the acceptor will accept new connection.
    socket_.reset(new UnixDomainSocket(io_service_));
    acceptor_->asyncAccept(*socket_, [this](const boost::system::error_code& ec) {
        if (!ec) {
            // New connection is arriving. Start asynchronous transmission.
            ConnectionPtr connection(new Connection(io_service_, socket_,
                                                    connection_pool_,
                                                    timeout_,
                                                    use_external_));
            connection_pool_.start(connection);
 
        } else if (ec.value() != boost::asio::error::operation_aborted) {
            LOG_ERROR(command_logger, COMMAND_SOCKET_ACCEPT_FAIL)
                .arg(acceptor_->getNative()).arg(ec.message());
        }
 
        // Unless we're stopping the service, start accepting connections again.
        if (ec.value() != boost::asio::error::operation_aborted) {
            doAccept();
        }
    });
}
 
UnixCommandMgr::UnixCommandMgr() : impl_(new UnixCommandMgrImpl()) {
}
 
void
UnixCommandMgr::openCommandSocket(const isc::data::ConstElementPtr& socket_info) {
    impl_->openCommandSocket(socket_info);
}
 
void
UnixCommandMgr::closeCommandSocket() {
    impl_->closeCommandSocket();
}
 
int
UnixCommandMgr::getControlSocketFD() {
    return (impl_->acceptor_ ? impl_->acceptor_->getNative() : -1);
}
 
UnixCommandMgr&
UnixCommandMgr::instance() {
    static UnixCommandMgr cmd_mgr;
    return (cmd_mgr);
}
 
void
UnixCommandMgr::setIOService(const IOServicePtr& io_service) {
    impl_->io_service_ = io_service;
}
 
void
UnixCommandMgr::setConnectionTimeout(const long timeout) {
    impl_->timeout_ = timeout;
}
 
void
UnixCommandMgr::addExternalSockets(bool use_external) {
    impl_->use_external_ = use_external;
}
 
} // end of isc::config
} // end of isc