L2CAPComm.cpp

Go to the documentation of this file.

/*
 * Author: Sven Gothel <sgothel@jausoft.com>
 * Copyright (c) 2020 Gothel Software e.K.
 * Copyright (c) 2020 ZAFENA AB
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
 
#include <cstring>
#include <string>
#include <memory>
#include <cstdint>
#include <vector>
#include <cstdio>
 
#include  <algorithm>
 
// #define PERF_PRINT_ON 1
#include <jau/debug.hpp>
 
#include "L2CAPComm.hpp"
#include "DBTConst.hpp"
 
#include "BTIoctl.hpp"
#include "L2CAPIoctl.hpp"
 
#include "BTDevice.hpp"
 
extern "C" {
    #include <unistd.h>
    #include <sys/socket.h>
    #include <poll.h>
    #include <pthread.h>
    #include <signal.h>
 
    #if defined(__FreeBSD__)
        // FIXME
        #define SOL_BLUETOOTH   274
    #endif
}
 
using namespace direct_bt;
 
L2CAPEnv::L2CAPEnv() noexcept
: exploding( jau::environment::getExplodingProperties("direct_bt.l2cap") ),
  L2CAP_READER_POLL_TIMEOUT( jau::environment::getInt32Property("direct_bt.l2cap.reader.timeout", 10000, 1500 /* min */, INT32_MAX /* max */) ),
  L2CAP_RESTART_COUNT_ON_ERROR( jau::environment::getInt32Property("direct_bt.l2cap.restart.count", 5, INT32_MIN /* min */, INT32_MAX /* max */) ), // FIXME: Move to L2CAPComm
  DEBUG_DATA( jau::environment::getBooleanProperty("direct_bt.debug.l2cap.data", false) )
{
}
 
// *************************************************
// *************************************************
// *************************************************
 
/**
 * Setting BT_SECURITY within open() after bind() and before connect()
 * causes BlueZ/Kernel to immediately process SMP, leading to a potential deadlock.
 *
 * Here we experience, setting security level before connect()
 * will block the thread within connect(), potentially a mutex used in the SMP procedure.
 *
 * Hence we set BT_SECURITY after connect() within open().
 */
inline constexpr const bool SET_BT_SECURITY_POST_CONNECT = true;
 
std::string L2CAPComm::getStateString(bool isOpen, bool hasIOError) noexcept {
    return "State[open "+std::to_string(isOpen)+
            ", ioerr "+std::to_string(hasIOError)+
            ", errno "+std::to_string(errno)+" ("+std::string(strerror(errno))+")]";
}
 
std::string L2CAPComm::getStateString(bool isOpen, bool irqed_int, bool irqed_ext, bool hasIOError) noexcept {
    return "State[open "+std::to_string(isOpen)+
           ", irqed "+std::to_string(irqed_int || irqed_ext)+" [int "+std::to_string(irqed_int)+", ext "+std::to_string(irqed_ext)+
           "], ioerr "+std::to_string(hasIOError)+
           ", errno "+std::to_string(errno)+" ("+std::string(strerror(errno))+")]";
}
 
int L2CAPComm::l2cap_open_dev(const BDAddressAndType & adapterAddressAndType, const L2CAP_PSM psm, const L2CAP_CID cid) noexcept {
    sockaddr_l2 a;
    int fd, err;
 
#if defined(__linux__)
    // OK, tested
#elif defined(__FreeBSD__)
    // #warning add implementation
    ABORT("add implementation for FreeBSD");
#else
    #warning add implementation
    ABORT("add implementation");
#endif
 
    // Create a loose L2CAP socket
    fd = ::socket(AF_BLUETOOTH, // AF_BLUETOOTH == PF_BLUETOOTH
                  SOCK_SEQPACKET, BTPROTO_L2CAP);
 
    if( 0 > fd ) {
        ERR_PRINT("L2CAPComm::l2cap_open_dev: socket failed");
        return fd;
    }
 
    // Bind socket to the L2CAP adapter
    // BT Core Spec v5.2: Vol 3, Part A: L2CAP_CONNECTION_REQ
    bzero((void *)&a, sizeof(a));
    a.l2_family=AF_BLUETOOTH;
    a.l2_psm = jau::cpu_to_le(direct_bt::number(psm));
    a.l2_bdaddr = jau::cpu_to_le(adapterAddressAndType.address);
    a.l2_cid = jau::cpu_to_le(direct_bt::number(cid));
    a.l2_bdaddr_type = ::number(adapterAddressAndType.type);
    if ( ::bind(fd, (struct sockaddr *) &a, sizeof(a)) < 0 ) {
        ERR_PRINT("L2CAPComm::l2cap_open_dev: bind failed");
        goto failed;
    }
    return fd;
 
failed:
    err = errno;
    ::close(fd);
    errno = err;
 
    return -1;
}
 
int L2CAPComm::l2cap_close_dev(int dd) noexcept
{
    return ::close(dd);
}
 
L2CAPComm::L2CAPComm(const uint16_t adev_id_, BDAddressAndType localAddressAndType_, const L2CAP_PSM psm_, const L2CAP_CID cid_) noexcept
: env(L2CAPEnv::get()),
  adev_id(adev_id_),
  localAddressAndType(std::move(localAddressAndType_)),
  psm(psm_), cid(cid_),
  socket_(-1),
  is_open_(false), interrupted_intern(false), is_interrupted_extern(/* Null Type */)
{ }
 
bool L2CAPComm::setBTSecurityLevelImpl(const BTSecurityLevel sec_level, const BDAddressAndType& remoteAddressAndType) noexcept {
    if( BTSecurityLevel::NONE > sec_level ) {
        DBG_PRINT("L2CAP::setBTSecurityLevel: sec_level %s not set: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  to_string(sec_level).c_str(),
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        return false;
    }
 
    if constexpr ( USE_LINUX_BT_SECURITY ) {
        struct bt_security bt_sec;
        int result;
 
        BTSecurityLevel old_sec_level = getBTSecurityLevelImpl(remoteAddressAndType);
        if( old_sec_level != sec_level ) {
            bzero(&bt_sec, sizeof(bt_sec));
            bt_sec.level = direct_bt::number(sec_level);
            result = ::setsockopt(socket_, SOL_BLUETOOTH, BT_SECURITY, &bt_sec, sizeof(bt_sec));
            if ( 0 == result ) {
                DBG_PRINT("L2CAP::setBTSecurityLevel: Success: sec_level %s -> %s: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                          to_string(old_sec_level).c_str(), to_string(sec_level).c_str(),
                          adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                          to_string(psm).c_str(), to_string(cid).c_str(),
                          getStateString().c_str());
                return true;
            } else {
                ERR_PRINT("L2CAP::setBTSecurityLevel: Failed: sec_level %s -> %s: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                          to_string(old_sec_level).c_str(), to_string(sec_level).c_str(),
                          adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                          to_string(psm).c_str(), to_string(cid).c_str(),
                          getStateString().c_str());
                return false;
            }
        } else {
            DBG_PRINT("L2CAP::setBTSecurityLevel: Unchanged: sec_level %s -> %s: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                      to_string(old_sec_level).c_str(), to_string(sec_level).c_str(),
                      adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                      to_string(psm).c_str(), to_string(cid).c_str(),
                      getStateString().c_str());
            return true;
        }
    } else {
        DBG_PRINT("L2CAP::setBTSecurityLevel: Not implemented: sec_level %s: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  to_string(sec_level).c_str(),
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        return false;
    }
}
 
BTSecurityLevel L2CAPComm::getBTSecurityLevelImpl(const BDAddressAndType& remoteAddressAndType) noexcept {
    BTSecurityLevel sec_level = BTSecurityLevel::UNSET;
    if constexpr ( USE_LINUX_BT_SECURITY ) {
        struct bt_security bt_sec;
        socklen_t optlen = sizeof(bt_sec);
        int result;
 
        bzero(&bt_sec, sizeof(bt_sec));
        result = ::getsockopt(socket_, SOL_BLUETOOTH, BT_SECURITY, &bt_sec, &optlen);
        if ( 0 == result ) {
            if( optlen == sizeof(bt_sec) ) {
                sec_level = static_cast<BTSecurityLevel>(bt_sec.level);
                DBG_PRINT("L2CAP::getBTSecurityLevel: Success: sec_level %s: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                          to_string(sec_level).c_str(),
                          adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                          to_string(psm).c_str(), to_string(cid).c_str(),
                          getStateString().c_str());
            } else {
                ERR_PRINT("L2CAP::getBTSecurityLevel: Failed: sec_level %s, size %zd returned != %zd bt_sec: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                          to_string(sec_level).c_str(), optlen, sizeof(bt_sec),
                          adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                          to_string(psm).c_str(), to_string(cid).c_str(),
                          getStateString().c_str());
            }
        } else {
            ERR_PRINT("L2CAP::getBTSecurityLevel: Failed: sec_level %s, result %d: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                      to_string(sec_level).c_str(), result,
                      adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                      to_string(psm).c_str(), to_string(cid).c_str(),
                      getStateString().c_str());
        }
    } else {
        DBG_PRINT("L2CAP::getBTSecurityLevel: Not implemented: sec_level %s: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  to_string(sec_level).c_str(),
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
    }
    return sec_level;
}
 
// *************************************************
// *************************************************
// *************************************************
 
L2CAPClient::L2CAPClient(const uint16_t adev_id_, BDAddressAndType adapterAddressAndType_, const L2CAP_PSM psm_, const L2CAP_CID cid_) noexcept
: L2CAPComm(adev_id_, std::move(adapterAddressAndType_), psm_, cid_),
  remoteAddressAndType(BDAddressAndType::ANY_BREDR_DEVICE),
  has_ioerror(false), tid_connect(0), tid_read(0)
{ }
 
L2CAPClient::L2CAPClient(const uint16_t adev_id_, BDAddressAndType adapterAddressAndType_, const L2CAP_PSM psm_, const L2CAP_CID cid_,
                         BDAddressAndType remoteAddressAndType_, int client_socket_) noexcept
: L2CAPComm(adev_id_, std::move(adapterAddressAndType_), psm_, cid_),
  remoteAddressAndType(std::move(remoteAddressAndType_)),
  has_ioerror(false), tid_connect(0), tid_read(0)
{
    socket_ = client_socket_;
    is_open_ = 0 <= client_socket_;
}
 
bool L2CAPClient::open(const BTDevice& device, const BTSecurityLevel sec_level) noexcept {
 
    bool expOpen = false; // C++11, exp as value since C++20
    if( !is_open_.compare_exchange_strong(expOpen, true) ) {
        DBG_PRINT("L2CAPClient::open(%s, %s): Already open: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  device.getAddressAndType().toString().c_str(), to_string(sec_level).c_str(),
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        return false;
    }
    const std::lock_guard<std::recursive_mutex> lock(mtx_write); // RAII-style acquire and relinquish via destructor
 
    has_ioerror = false; // always clear last ioerror flag (should be redundant)
 
    /**
     * bt_io_connect ( create_io ) with source address
     * - fd = socket(.._)
     * - bind(fd, ..)
     * - l2cap_set
     * -- set imtu, omtu, mode
     * -- l2cap_set_master
     * -- l2cap_set_flushable
     * -- set_priority
     * -- set_sec_level
     * --- setsockopt(.. BT_SECURITY ..)
     *
     * - l2cap_connect with destination address
     * -- connect(fd, ..)
     */
    remoteAddressAndType = device.getAddressAndType();
 
    /** BT Core Spec v5.2: Vol 3, Part A: L2CAP_CONNECTION_REQ */
    sockaddr_l2 req;
    int res;
    int to_retry_count=0; // ETIMEDOUT retry count
 
    DBG_PRINT("L2CAPClient::open: Start Connect: dev_id %u, dd %d, %s, psm %s, cid %s, sec_level %s; %s",
              adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
              to_string(psm).c_str(), to_string(cid).c_str(), to_string(sec_level).c_str(),
              getStateString().c_str());
 
    socket_ = l2cap_open_dev(localAddressAndType, psm, cid);
 
    if( 0 > socket_ ) {
        goto failure; // open failed
    }
 
    if constexpr ( !SET_BT_SECURITY_POST_CONNECT && USE_LINUX_BT_SECURITY ) {
        if( BTSecurityLevel::UNSET < sec_level ) {
            if( !setBTSecurityLevelImpl(sec_level, remoteAddressAndType) ) {
                goto failure; // sec_level failed
            }
        }
    }
 
    tid_connect = ::pthread_self(); // temporary safe tid to allow interruption
 
    // actual request to connect to remote device
    bzero((void *)&req, sizeof(req));
    req.l2_family = AF_BLUETOOTH;
    req.l2_psm = jau::cpu_to_le(direct_bt::number(psm));
    req.l2_bdaddr = jau::cpu_to_le(remoteAddressAndType.address);
    req.l2_cid = jau::cpu_to_le(direct_bt::number(cid));
    req.l2_bdaddr_type = ::number(remoteAddressAndType.type);
 
    while( !interrupted() ) {
        // blocking
        res = ::connect(socket_, (struct sockaddr*)&req, sizeof(req));
 
        DBG_PRINT("L2CAPClient::open: Connect Result: %d, errno 0x%X %s, dev_id %u, %s, psm %s, cid %s",
                  res, errno, strerror(errno),
                  adev_id, remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str());
 
        if( !res )
        {
            break; // done
 
        } else if( ETIMEDOUT == errno ) {
            to_retry_count++;
            if( to_retry_count < number(Defaults::L2CAP_CONNECT_MAX_RETRY) ) {
                WORDY_PRINT("L2CAPClient::open: Connect timeout, retry %d: dev_id %u, dd %d, %s, psm %s, cid %s, sec_level %s; %s",
                          to_retry_count,
                          adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                          to_string(psm).c_str(), to_string(cid).c_str(), to_string(sec_level).c_str(),
                          getStateString().c_str());
                continue;
            } else {
                ERR_PRINT("L2CAPClient::open: Connect timeout, retried %d: dev_id %u, dd %d, %s, psm %s, cid %s, sec_level %s; %s",
                          to_retry_count,
                          adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                          to_string(psm).c_str(), to_string(cid).c_str(), to_string(sec_level).c_str(),
                          getStateString().c_str());
                goto failure; // exit
            }
 
        } else if( !interrupted() ) {
            // EALREADY == errno || ENETUNREACH == errno || EHOSTUNREACH == errno || ..
            ERR_PRINT("L2CAPClient::open: Connect failed: dev_id %u, dd %d, %s, psm %s, cid %s, sec_level %s; %s",
                      adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                      to_string(psm).c_str(), to_string(cid).c_str(), to_string(sec_level).c_str(),
                      getStateString().c_str());
            goto failure; // exit
        } else {
            goto failure; // exit on interrupt
        }
    }
    // success
    tid_connect = 0;
 
    if constexpr ( SET_BT_SECURITY_POST_CONNECT && USE_LINUX_BT_SECURITY ) {
        if( BTSecurityLevel::UNSET < sec_level ) {
            if( !setBTSecurityLevelImpl(sec_level, remoteAddressAndType) ) {
                goto failure; // sec_level failed
            }
        }
    }
 
    return true;
 
failure:
    const int err = errno;
    close();
    errno = err;
    return false;
}
 
bool L2CAPClient::close_impl() noexcept {
    bool expOpen = true; // C++11, exp as value since C++20
    if( !is_open_.compare_exchange_strong(expOpen, false) ) {
        DBG_PRINT("L2CAPClient::close: Not connected: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        has_ioerror = false; // always clear last ioerror flag (should be redundant)
        set_interrupted_query(L2CAPComm::get_boolean_callback_t()); // Null-Type
        return true;
    }
    const std::lock_guard<std::recursive_mutex> lock(mtx_write); // RAII-style acquire and relinquish via destructor
 
    DBG_PRINT("L2CAPClient::close: Start: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
              adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
              to_string(psm).c_str(), to_string(cid).c_str(),
              getStateString().c_str());
    has_ioerror = false;
    set_interrupted_query(L2CAPComm::get_boolean_callback_t()); // Null-Type
    PERF_TS_T0();
 
    // interrupt connect() and read(), avoiding prolonged hang
    interrupted_intern = true;
    {
        ::pthread_t tid_self = ::pthread_self();
        ::pthread_t _tid_connect = tid_connect;
        ::pthread_t _tid_read = tid_read;
        tid_read = 0;
        tid_connect = 0;
 
        // interrupt read(), avoiding prolonged hang
        if( 0 != _tid_read && tid_self != _tid_read ) {
            int kerr;
            if( 0 != ( kerr = ::pthread_kill(_tid_read, SIGALRM) ) ) {
                ERR_PRINT("L2CAPClient::close: pthread_kill read %p FAILED: %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                          (void*)_tid_read, kerr, // NOLINT(performance-no-int-to-ptr)
                          adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                          to_string(psm).c_str(), to_string(cid).c_str(),
                          getStateString().c_str());
            }
        }
        // interrupt connect(), avoiding prolonged hang
        if( 0 != _tid_connect && _tid_read != _tid_connect && tid_self != _tid_connect ) {
            int kerr;
            if( 0 != ( kerr = ::pthread_kill(_tid_connect, SIGALRM) ) ) {
                ERR_PRINT("L2CAPClient::close: Start: pthread_kill connect %p FAILED: %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                          (void*)_tid_connect, kerr, // NOLINT(performance-no-int-to-ptr)
                          adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                          to_string(psm).c_str(), to_string(cid).c_str(),
                          getStateString().c_str());
            }
        }
    }
 
    l2cap_close_dev(socket_);
    socket_ = -1;
    interrupted_intern = false;
    PERF_TS_TD("L2CAPClient::close");
    DBG_PRINT("L2CAPClient::close: End: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
              adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
              to_string(psm).c_str(), to_string(cid).c_str(),
              getStateString().c_str());
    return true;
}
 
bool L2CAPClient::setBTSecurityLevel(const BTSecurityLevel sec_level) noexcept {
    if( !is_open_ ) {
        DBG_PRINT("L2CAPClient::setBTSecurityLevel(%s): Not connected: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  to_string(sec_level).c_str(),
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        return false;
    }
    const std::lock_guard<std::recursive_mutex> lock(mtx_write); // RAII-style acquire and relinquish via destructor
    if( BTSecurityLevel::UNSET < sec_level ) {
        if( setBTSecurityLevelImpl(sec_level, remoteAddressAndType) ) {
            return true;
        } else {
            close();
            return false;
        }
    } else {
        return true;
    }
}
 
BTSecurityLevel L2CAPClient::getBTSecurityLevel() noexcept {
    if( !is_open_ ) {
        DBG_PRINT("L2CAPClient::getBTSecurityLevel: Not connected: dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        return BTSecurityLevel::UNSET;
    }
    const std::lock_guard<std::recursive_mutex> lock(mtx_write); // RAII-style acquire and relinquish via destructor
 
    return getBTSecurityLevelImpl(remoteAddressAndType);
}
 
#define RWEXITCODE_ENUM(X) \
        X(RWExitCode, SUCCESS) \
        X(RWExitCode, NOT_OPEN) \
        X(RWExitCode, INTERRUPTED) \
        X(RWExitCode, INVALID_SOCKET_DD) \
        X(RWExitCode, POLL_ERROR) \
        X(RWExitCode, POLL_TIMEOUT) \
        X(RWExitCode, READ_ERROR) \
        X(RWExitCode, READ_TIMEOUT) \
        X(RWExitCode, WRITE_ERROR)
 
#define CASE2_TO_STRING(U,V) case U::V: return #V;
 
std::string L2CAPClient::getRWExitCodeString(const RWExitCode ec) noexcept {
    if( number(ec) >= 0 ) {
        return "SUCCESS";
    }
    switch(ec) {
        RWEXITCODE_ENUM(CASE2_TO_STRING)
        default: ; // fall through intended
    }
    return "Unknown ExitCode";
}
 
jau::snsize_t L2CAPClient::read(uint8_t* buffer, const jau::nsize_t capacity) noexcept {
    const int32_t timeoutMS = env.L2CAP_READER_POLL_TIMEOUT;
    jau::snsize_t len = 0;
    jau::snsize_t err_res = 0;
 
    if( !is_open_ ) {
        err_res = number(RWExitCode::NOT_OPEN);
        goto errout;
    }
    if( interrupted() ) {
        err_res = number(RWExitCode::INTERRUPTED);
        goto errout;
    }
    if( 0 > socket_ ) {
        err_res = number(RWExitCode::INVALID_SOCKET_DD);
        goto errout;
    }
    if( 0 == capacity ) {
        goto done;
    }
 
    tid_read = ::pthread_self(); // temporary safe tid to allow interruption
 
    if( timeoutMS ) {
        struct pollfd p;
        int n = 1;
 
        p.fd = socket_; p.events = POLLIN;
        while ( is_open_ && !interrupted() && ( n = ::poll( &p, 1, timeoutMS ) ) < 0 ) {
            if( !is_open_ ) {
                err_res = number(RWExitCode::NOT_OPEN);
                goto errout;
            }
            if( interrupted() ) {
                err_res = number(RWExitCode::INTERRUPTED);
                goto errout;
            }
            if ( errno == EAGAIN || errno == EINTR ) {
                // cont temp unavail or interruption
                continue;
            }
            if( errno == ETIMEDOUT ) {
                err_res = number(RWExitCode::POLL_TIMEOUT);
            } else {
                err_res = number(RWExitCode::POLL_ERROR);
            }
            goto errout;
        }
        if ( 0 == n ) {
            err_res = number(RWExitCode::POLL_TIMEOUT);
            errno = ETIMEDOUT;
            goto errout;
        }
    }
 
    while ( is_open_ && !interrupted() && ( len = ::read(socket_, buffer, capacity) ) < 0 ) {
        if( !is_open_ ) {
            err_res = number(RWExitCode::NOT_OPEN);
            goto errout;
        }
        if( interrupted() ) {
            err_res = number(RWExitCode::INTERRUPTED);
            goto errout;
        }
        if ( errno == EAGAIN || errno == EINTR ) {
            // cont temp unavail or interruption
            continue;
        }
        if( errno == ETIMEDOUT ) {
            err_res = number(RWExitCode::READ_TIMEOUT);
        } else {
            err_res = number(RWExitCode::READ_ERROR);
        }
        goto errout;
    }
 
done:
    tid_read = 0;
    return len;
 
errout:
    tid_read = 0;
    if( err_res == number(RWExitCode::NOT_OPEN) ) {
        WORDY_PRINT("L2CAPClient::read: Not open res %d (%s), len %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
              err_res, getRWExitCodeString(err_res).c_str(), len,
              adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
              to_string(psm).c_str(), to_string(cid).c_str(),
              getStateString().c_str());
    } else if( err_res == number(RWExitCode::INTERRUPTED) ) { // interrupted (internal or external)
        WORDY_PRINT("L2CAPClient::read: IRQed res %d (%s), len %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
              err_res, getRWExitCodeString(err_res).c_str(), len,
              adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
              to_string(psm).c_str(), to_string(cid).c_str(),
              getStateString().c_str());
    } else if( err_res != number(RWExitCode::POLL_TIMEOUT) ) { // expected POLL_TIMEOUT if idle
        // open and not intentionally interrupted
        if( err_res == number(RWExitCode::READ_TIMEOUT) ) {
            DBG_PRINT("L2CAPClient::read: Read Timeout res %d (%s), len %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  err_res, getRWExitCodeString(err_res).c_str(), len,
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        } else { // actual error case
            has_ioerror = true;
            if( env.L2CAP_RESTART_COUNT_ON_ERROR < 0 ) {
                ABORT("L2CAPClient::read: Error res %d (%s), len %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                      err_res, getRWExitCodeString(err_res).c_str(), len,
                      adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                      to_string(psm).c_str(), to_string(cid).c_str(),
                      getStateString().c_str());
            } else {
                IRQ_PRINT("L2CAPClient::read: Error res %d (%s), len %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                      err_res, getRWExitCodeString(err_res).c_str(), len,
                      adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                      to_string(psm).c_str(), to_string(cid).c_str(),
                      getStateString().c_str());
            }
        }
    }
    return err_res;
}
 
jau::snsize_t L2CAPClient::write(const uint8_t * buffer, const jau::nsize_t length) noexcept {
    const std::lock_guard<std::recursive_mutex> lock(mtx_write); // RAII-style acquire and relinquish via destructor
    jau::snsize_t len = 0;
    jau::snsize_t err_res = 0;
 
    if( !is_open_ ) {
        err_res = number(RWExitCode::NOT_OPEN);
        goto errout;
    }
    if( interrupted() ) {
        err_res = number(RWExitCode::INTERRUPTED);
        goto errout;
    }
    if( 0 > socket_ ) {
        err_res = number(RWExitCode::INVALID_SOCKET_DD);
        goto errout;
    }
    if( 0 == length ) {
        goto done;
    }
 
    while ( is_open_ && !interrupted() && ( len = ::write(socket_, buffer, length) ) < 0 ) {
        if( !is_open_ ) {
            err_res = number(RWExitCode::NOT_OPEN);
            goto errout;
        }
        if( interrupted() ) {
            err_res = number(RWExitCode::INTERRUPTED);
            goto errout;
        }
        if( EAGAIN == errno || EINTR == errno ) {
            // cont temp unavail or interruption
            continue;
        }
        err_res = number(RWExitCode::WRITE_ERROR);
        goto errout;
    }
 
done:
    return len;
 
errout:
    if( err_res == number(RWExitCode::NOT_OPEN) || err_res == number(RWExitCode::INTERRUPTED) ) {
        // closed or intentionally interrupted
        WORDY_PRINT("L2CAPClient::write: IRQed res %d (%s), len %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
              err_res, getRWExitCodeString(err_res).c_str(), len,
              adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
              to_string(psm).c_str(), to_string(cid).c_str(),
              getStateString().c_str());
    } else {
        // open and not intentionally interrupted
        has_ioerror = true;
 
        if( env.L2CAP_RESTART_COUNT_ON_ERROR < 0 ) {
            ABORT("L2CAPClient::write: Error res %d (%s), len %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  err_res, getRWExitCodeString(err_res).c_str(), len,
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        } else {
            IRQ_PRINT("L2CAPClient::write: Error res %d (%s), len %d; dev_id %u, dd %d, %s, psm %s, cid %s; %s",
                  err_res, getRWExitCodeString(err_res).c_str(), len,
                  adev_id, socket_.load(), remoteAddressAndType.toString().c_str(),
                  to_string(psm).c_str(), to_string(cid).c_str(),
                  getStateString().c_str());
        }
    }
    return err_res;
}
 
std::string L2CAPClient::toString() const noexcept {
    return "L2CAPClient[dev_id "+std::to_string(adev_id)+", dd "+std::to_string(socket_)+
            ", psm "+to_string(psm)+
            ", cid "+to_string(cid)+
            ", local "+localAddressAndType.toString()+
            ", remote "+remoteAddressAndType.toString()+
            ", "+getStateString()+"]";
}
 
// *************************************************
// *************************************************
// *************************************************
 
L2CAPServer::L2CAPServer(const uint16_t adev_id_, BDAddressAndType localAddressAndType_, const L2CAP_PSM psm_, const L2CAP_CID cid_) noexcept
: L2CAPComm(adev_id_, std::move(localAddressAndType_), psm_, cid_), tid_accept(0)
{ }
 
bool L2CAPServer::open() noexcept {
    bool expOpen = false; // C++11, exp as value since C++20
    if( !is_open_.compare_exchange_strong(expOpen, true) ) {
        DBG_PRINT("L2CAPServer::open: Already open: dev_id %u, dd %d, psm %s, cid %s, local %s",
                  adev_id, socket_.load(), to_string(psm).c_str(), to_string(cid).c_str(),
                  localAddressAndType.toString().c_str());
        return false;
    }
    const std::lock_guard<std::recursive_mutex> lock(mtx_open); // RAII-style acquire and relinquish via destructor
    int res;
 
    DBG_PRINT("L2CAPServer::open: Start: dev_id %u, dd %d, psm %s, cid %s, local %s",
              adev_id, socket_.load(), to_string(psm).c_str(), to_string(cid).c_str(),
              localAddressAndType.toString().c_str());
 
    socket_ = l2cap_open_dev(localAddressAndType, psm, cid);
 
    if( 0 > socket_ ) {
        goto failure; // open failed
    }
 
    res = ::listen(socket_, 10);
 
    DBG_PRINT("L2CAPServer::open: End: res %d, dev_id %u, dd %d, psm %s, cid %s, local %s",
              res, adev_id, socket_.load(), to_string(psm).c_str(), to_string(cid).c_str(),
              localAddressAndType.toString().c_str());
 
    if( res < 0 ) {
        goto failure;
    }
 
    return true;
 
failure:
    ERR_PRINT("L2CAPServer::open: Failed: dev_id %u, dd %d, psm %s, cid %s, local %s",
              adev_id, socket_.load(), to_string(psm).c_str(), to_string(cid).c_str(),
              localAddressAndType.toString().c_str());
    const int err = errno;
    close();
    errno = err;
    return false;
}
 
bool L2CAPServer::close_impl() noexcept {
    bool expOpen = true; // C++11, exp as value since C++20
    if( !is_open_.compare_exchange_strong(expOpen, false) ) {
        DBG_PRINT("L2CAPServer::close: Not connected: dev_id %u, dd %d, psm %s, cid %s, local %s",
                  adev_id, socket_.load(), to_string(psm).c_str(), to_string(cid).c_str(),
                  localAddressAndType.toString().c_str());
        set_interrupted_query(L2CAPComm::get_boolean_callback_t()); // Null-Type
        return true;
    }
    const std::lock_guard<std::recursive_mutex> lock(mtx_open); // RAII-style acquire and relinquish via destructor
 
    DBG_PRINT("L2CAPServer::close: Start: dev_id %u, dd %d, psm %s, cid %s, local %s",
              adev_id, socket_.load(), to_string(psm).c_str(), to_string(cid).c_str(),
              localAddressAndType.toString().c_str());
    set_interrupted_query(L2CAPComm::get_boolean_callback_t()); // Null-Type
    PERF_TS_T0();
 
    // interrupt accept(..), avoiding prolonged hang
    interrupted_intern = true;
    {
        ::pthread_t tid_self = ::pthread_self();
        ::pthread_t _tid_accept = tid_accept;
        tid_accept = 0;
 
        if( 0 != _tid_accept && tid_self != _tid_accept ) {
            int kerr;
            if( 0 != ( kerr = ::pthread_kill(_tid_accept, SIGALRM) ) ) {
                ERR_PRINT("L2CAPServer::close: Start: pthread_kill connect %p FAILED: %d; dev_id %u, dd %d, psm %s, cid %s, local %s",
                          (void*)_tid_accept, kerr, // NOLINT(performance-no-int-to-ptr)
                          adev_id, socket_.load(), to_string(psm).c_str(), to_string(cid).c_str(),
                          localAddressAndType.toString().c_str());
            }
        }
    }
 
    l2cap_close_dev(socket_);
    socket_ = -1;
    interrupted_intern = false;
    PERF_TS_TD("L2CAPServer::close");
    DBG_PRINT("L2CAPServer::close: End: dev_id %u, dd %d, psm %s, cid %s, local %s",
              adev_id, socket_.load(), to_string(psm).c_str(), to_string(cid).c_str(),
              localAddressAndType.toString().c_str());
    return true;
}
 
std::unique_ptr<L2CAPClient> L2CAPServer::accept() noexcept {
    sockaddr_l2 peer;
    int to_retry_count=0; // ETIMEDOUT retry count
 
    tid_accept = ::pthread_self(); // temporary safe tid to allow interruption
 
    if( !is_open_ ) {
        ERR_PRINT("L2CAPServer::accept: Not open: dev_id %u, dd[s %d], errno 0x%X %s, psm %s, cid %s, local %s",
                  adev_id, socket_.load(), errno, strerror(errno),
                  to_string(psm).c_str(),
                  to_string(cid).c_str(),
                  localAddressAndType.toString().c_str());
    }
 
    while( is_open_ && !interrupted() ) {
        // blocking
        bzero((void *)&peer, sizeof(peer));
        socklen_t addrlen = sizeof(peer); // on return it will contain the actual size of the peer address
        int client_socket = ::accept(socket_, (struct sockaddr*)&peer, &addrlen);
 
        BDAddressAndType remoteAddressAndType(jau::le_to_cpu(peer.l2_bdaddr), static_cast<BDAddressType>(peer.l2_bdaddr_type));
        L2CAP_PSM c_psm = static_cast<L2CAP_PSM>(jau::le_to_cpu(peer.l2_psm));
        L2CAP_CID c_cid = static_cast<L2CAP_CID>(jau::le_to_cpu(peer.l2_cid));
 
        if( 0 <= client_socket )
        {
            DBG_PRINT("L2CAPServer::accept: Success: dev_id %u, dd[s %d, c %d], errno 0x%X %s, psm %s -> %s, cid %s -> %s, local %s -> remote %s",
                      adev_id, socket_.load(), client_socket, errno, strerror(errno),
                      to_string(psm).c_str(), to_string(c_psm).c_str(),
                      to_string(cid).c_str(), to_string(c_cid).c_str(),
                      localAddressAndType.toString().c_str(),
                      remoteAddressAndType.toString().c_str());
            // success
            tid_accept = 0;
            return std::make_unique<L2CAPClient>(adev_id, localAddressAndType, c_psm, c_cid, remoteAddressAndType, client_socket);
        } else if( ETIMEDOUT == errno ) {
            to_retry_count++;
            if( to_retry_count < L2CAPClient::number(L2CAPClient::Defaults::L2CAP_CONNECT_MAX_RETRY) ) {
                WORDY_PRINT("L2CAPServer::accept: Timeout # %d (retry): dev_id %u, dd[s %d, c %d], errno 0x%X %s, psm %s -> %s, cid %s -> %s, local %s -> remote %s",
                          to_retry_count, adev_id, socket_.load(), client_socket, errno, strerror(errno),
                          to_string(psm).c_str(), to_string(c_psm).c_str(),
                          to_string(cid).c_str(), to_string(c_cid).c_str(),
                          localAddressAndType.toString().c_str(),
                          remoteAddressAndType.toString().c_str());
                continue;
            } else {
                WORDY_PRINT("L2CAPServer::accept: Timeout # %d (done): dev_id %u, dd[s %d, c %d], errno 0x%X %s, psm %s -> %s, cid %s -> %s, local %s -> remote %s",
                          to_retry_count, adev_id, socket_.load(), client_socket, errno, strerror(errno),
                          to_string(psm).c_str(), to_string(c_psm).c_str(),
                          to_string(cid).c_str(), to_string(c_cid).c_str(),
                          localAddressAndType.toString().c_str(),
                          remoteAddressAndType.toString().c_str());
                break; // exit
            }
 
        } else if( !interrupted() ) {
            // EALREADY == errno || ENETUNREACH == errno || EHOSTUNREACH == errno || ..
            IRQ_PRINT("L2CAPServer::accept: Failed: dev_id %u, dd[s %d, c %d], errno 0x%X %s, psm %s -> %s, cid %s -> %s, local %s -> remote %s",
                      adev_id, socket_.load(), client_socket, errno, strerror(errno),
                      to_string(psm).c_str(), to_string(c_psm).c_str(),
                      to_string(cid).c_str(), to_string(c_cid).c_str(),
                      localAddressAndType.toString().c_str(),
                      remoteAddressAndType.toString().c_str());
            break; // exit
        }
    }
    // failure
    tid_accept = 0;
    return nullptr;
}
 
std::string L2CAPServer::toString() const noexcept {
    return "L2CAPServer[dev_id "+std::to_string(adev_id)+", dd "+std::to_string(socket_)+
            ", psm "+to_string(psm)+
            ", cid "+to_string(cid)+
            ", local "+localAddressAndType.toString()+
            ", "+getStateString()+"]";
}