[Spice-devel] [PATCH spice-common v3 1/3] agent-interface: introduce the core of the Agent Interface

Frediano Ziglio fziglio at redhat.com
Fri Oct 18 16:06:00 UTC 2019


> 
> When initialized (recorder_initialization), the Agent Interface launch
> a GThread (handle_communications) that opens a TCP server socket and
> waits for Smart Local Agent connections. When a Local Agent connects
> to the sockets, the communication is initialized
> (agent_initialize_communication), the communication socket is stored
> and the list of Recorders is sent. In return, the local agent
> indicates which recorders to enable.
> 
> On the SPICE side, the Agent Interface handles the record() calls
> (recorder_append*). When a record is received from SPICE, and if the
> recorder is enabled, the record entry is sent through the TCP
> connection. Otherwise, the record is dropped.
> 
> Signed-off-by: Kevin Pouget <kpouget at redhat.com>

Acked the series

> ---
> v2->v3: unchanged
> ---
>  common/agent_interface.c    | 467 +++++++++++++++++++++++++++++++
>  common/agent_interface.h    | 542 ++++++++++++++++++++++++++++++++++++
>  tests/test-dummy-recorder.c |   3 +-
>  3 files changed, 1011 insertions(+), 1 deletion(-)
>  create mode 100644 common/agent_interface.c
>  create mode 100644 common/agent_interface.h
> 
> diff --git a/common/agent_interface.c b/common/agent_interface.c
> new file mode 100644
> index 0000000..768b6a9
> --- /dev/null
> +++ b/common/agent_interface.c
> @@ -0,0 +1,467 @@
> +/* -*- Mode: C; c-basic-offset: 4; indent-tabs-mode: nil -*- */
> +/*
> +   Copyright (C) 2019 Red Hat, Inc.
> +
> +   This library is free software; you can redistribute it and/or
> +   modify it under the terms of the GNU Lesser General Public
> +   License as published by the Free Software Foundation; either
> +   version 2.1 of the License, or (at your option) any later version.
> +
> +   This library is distributed in the hope that it will be useful,
> +   but WITHOUT ANY WARRANTY; without even the implied warranty of
> +   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
> +   Lesser General Public License for more details.
> +
> +   You should have received a copy of the GNU Lesser General Public
> +   License along with this library; if not, see
> <http://www.gnu.org/licenses/>.
> +*/
> +
> +#include <config.h>
> +#include <stdlib.h>
> +#include <sys/time.h>
> +#include <string.h>
> +#include <glib.h>
> +#include <stdio.h>
> +#include <sys/socket.h>
> +#include <netinet/in.h>
> +#include <unistd.h>
> +#include <arpa/inet.h>
> +#include <sys/eventfd.h>
> +#include <errno.h>
> +#include <poll.h>
> +
> +#include <common/agent_interface.h>
> +
> +typedef struct sockaddr SA;
> +
> +static GThread *recorder_comm_thr;
> +static bool agent_terminated = false;
> +static int terminate_efd = -1;
> +static FILE *communication_f = NULL;
> +
> +#define NB_MAX_RECORDERS 16
> +static recorder_info *recorders[NB_MAX_RECORDERS];
> +static uint32_t nb_recorders = 0;
> +
> +static uintptr_t recorder_tick(void);
> +
> +#ifndef RECORDER_HZ
> +#define RECORDER_HZ     1000000
> +#endif // RECORDER_HZ
> +
> +static GMutex mutex_socket;
> +
> +static int agent_initialize_communication(int socket)
> +{
> +    uint32_t i;
> +    int ret = -1;
> +    FILE *socket_f;
> +
> +    g_mutex_lock(&mutex_socket);
> +
> +    if (communication_f != NULL) {
> +        g_warning("A client is already connected, rejecting the
> connection.");
> +
> +        goto unlock;
> +    }
> +
> +    socket_f = fdopen(socket, "w+b");
> +
> +    fprintf(socket_f, "Recorders: ");
> +    for (i = 0; i < nb_recorders; i++) {
> +        g_debug("Sending %s", recorders[i]->name);
> +        fprintf(socket_f, "%s;", recorders[i]->name);
> +    }
> +    fprintf(socket_f, "\n");
> +    fflush(socket_f);
> +
> +    for (i = 0; i < nb_recorders; i++) {
> +        char enable;
> +
> +        if (read(socket, &enable, sizeof(enable)) != sizeof(enable)) {
> +            g_warning("Invalid read on the client socket");
> +
> +            goto unlock;
> +        }
> +        if (enable != '0' && enable != '1') {
> +            g_critical("Invalid enable-value received for recorder '%s':
> %u",
> +                       recorders[i]->name, enable);
> +
> +            goto unlock;
> +        }
> +
> +        if (enable == '0') {
> +            continue;
> +        }
> +
> +        recorders[i]->trace = 1;
> +        g_info("Enable recorder '%s'", recorders[i]->name);
> +    }
> +
> +    communication_f = socket_f;
> +    ret = 0;
> +
> +unlock:
> +    g_mutex_unlock(&mutex_socket);
> +
> +    return ret;
> +}
> +
> +static void agent_finalize_communication(int socket)
> +{
> +    uint32_t i;
> +    g_info("Communication socket closed.");
> +
> +    g_mutex_lock(&mutex_socket);
> +    g_assert(socket == fileno(communication_f));
> +
> +    fclose(communication_f);
> +    communication_f = NULL;
> +
> +    for (i = 0; i < nb_recorders; i++) {
> +        recorders[i]->trace = 0;
> +    }
> +    g_mutex_unlock(&mutex_socket);
> +}
> +
> +static int agent_process_communication(int socket)
> +{
> +    static char msg_in[128];
> +
> +    static long unsigned int len = 0;
> +
> +    g_assert(socket == fileno(communication_f));
> +
> +    int nbytes = read(socket, msg_in + len, 1);
> +
> +    if (nbytes < 0 && errno == EINTR) {
> +       return 0;
> +    }
> +
> +    if (nbytes <= 0) {
> +        agent_finalize_communication(socket);
> +        return -1; // socket closed
> +    }
> +
> +    if (msg_in[len] == '\0') {
> +        // TODO: process quality indicator
> +        len = 0;
> +        return 0;
> +    }
> +
> +    len += nbytes;
> +
> +    if (len >= sizeof(msg_in) - 1) {
> +        msg_in[sizeof(msg_in) - 1] = '\0';
> +        g_warning("Invalid message received (too long?): %s", msg_in);
> +        len = 0;
> +    }
> +
> +    return 0;
> +}
> +
> +static int make_socket(guint port)
> +{
> +    struct sockaddr_in servaddr;
> +    int listen_socket = socket(AF_INET, SOCK_STREAM, 0);
> +
> +    if (listen_socket == -1) {
> +        g_critical("socket creation failed");
> +        return -1;
> +    }
> +
> +    int enable = 1;
> +    if (setsockopt(listen_socket, SOL_SOCKET, SO_REUSEADDR, &enable,
> sizeof(int)) < 0) {
> +        g_critical("setsockopt(SO_REUSEADDR) failed");
> +        close(listen_socket);
> +        return -1;
> +    }
> +
> +    memset(&servaddr, 0, sizeof(servaddr));
> +
> +    servaddr.sin_family = AF_INET;
> +    servaddr.sin_addr.s_addr = htonl(INADDR_ANY);
> +    servaddr.sin_port = htons(port);
> +
> +    if (bind(listen_socket, (SA *) &servaddr, sizeof(servaddr)) != 0) {
> +        g_critical("socket bind failed");
> +        close(listen_socket);
> +        return -1;
> +    }
> +
> +    return listen_socket;
> +}
> +
> +static gpointer handle_communications(gpointer user_data)
> +{
> +    struct pollfd fds[3];
> +    int nb_fd = 0;
> +    int listen_socket;
> +    int i;
> +    guint port = GPOINTER_TO_UINT(user_data);
> +
> +    listen_socket = make_socket(port);
> +    if (listen_socket < 0) {
> +        return NULL;
> +    }
> +
> +    g_debug("Listening!");
> +
> +    if ((listen(listen_socket, 1)) != 0) {
> +        g_critical("listen failed: %m");
> +        return NULL;
> +    }
> +
> +    fds[0].fd = terminate_efd;
> +    fds[0].events = POLLIN;
> +    fds[1].fd = listen_socket;
> +    fds[1].events = POLLIN;
> +    nb_fd = 2;
> +
> +    while (!agent_terminated) {
> +
> +        /* Block until input arrives on one or more active sockets. */
> +        int ret = poll(fds, nb_fd, -1);
> +
> +        if (ret < 0) {
> +            g_critical("poll failed: %m");
> +            break;
> +        }
> +
> +        /* Service all the sockets with input pending. */
> +        for (i = 0; i < nb_fd; i++) {
> +            int fd = fds[i].fd;
> +            if (fd == terminate_efd) {
> +                if (fds[i].revents & POLLIN) {
> +                    g_assert(agent_terminated);
> +                    break;
> +                }
> +            } else if (fd == listen_socket) {
> +                if (fds[i].revents & ~POLLIN) {
> +                    g_critical("server socket closed");
> +                    break;
> +                }
> +                if (!(fds[i].revents & POLLIN)) {
> +                    continue;
> +                }
> +
> +                /* Connection request on original socket. */
> +                int new_fd = accept(listen_socket, NULL, NULL);
> +
> +                if (new_fd < 0) {
> +                    g_critical("accept failed: %m");
> +                    break;
> +                }
> +
> +                if (nb_fd == 3) {
> +                    close(new_fd);
> +                    g_warning("Too many clients accepted ...");
> +                    continue;
> +                }
> +
> +                g_debug("Agent Interface: client connected!");
> +
> +                if (agent_initialize_communication(new_fd)) {
> +                    close(new_fd);
> +                    g_warning("Initialization failed ...");
> +                    continue;
> +                }
> +
> +                fds[nb_fd].fd = new_fd;
> +                fds[nb_fd].events = POLLIN;
> +                nb_fd++;
> +
> +                /* fds array modified, restart the poll. */
> +                break;
> +            } else {
> +                if (!(fds[i].revents & POLLIN)) {
> +                    continue;
> +                }
> +
> +                /* Data arriving on an already-connected socket. */
> +                if (agent_process_communication(fd) < 0) {
> +                    nb_fd--;
> +                }
> +            }
> +        }
> +    }
> +
> +    close(terminate_efd);
> +    close(listen_socket);
> +
> +    g_info("Agent interface thread: bye!");
> +    return NULL;
> +}
> +
> +static void recorder_deregister(void);
> +
> +static void recorder_initialization(unsigned int port)
> +{
> +    GError *error = NULL;
> +
> +    terminate_efd = eventfd(0, 0);
> +    if (terminate_efd == -1) {
> +        g_critical("eventfd failed: %m");
> +        return;
> +    }
> +
> +    recorder_comm_thr = g_thread_try_new("smart_agent_interface",
> +                                         handle_communications,
> +                                         GUINT_TO_POINTER((guint) port),
> &error);
> +    if (error) {
> +        g_assert(!recorder_comm_thr);
> +        g_critical("Error: Could not start the agent interface thread: %s",
> error->message);
> +        g_error_free(error);
> +        return;
> +    }
> +
> +    atexit(recorder_deregister);
> +}
> +
> +static void recorder_interrupt_communications(void)
> +{
> +    agent_terminated = true;
> +
> +    uint64_t msg = 1;
> +    ssize_t s = write(terminate_efd, &msg, sizeof(uint64_t));
> +
> +    if (s != sizeof(uint64_t)) {
> +        g_warning("failed to send recorder thread termination event: %m");
> +    }
> +}
> +
> +
> +static void recorder_deregister(void)
> +{
> +    if (recorder_comm_thr) {
> +        recorder_interrupt_communications();
> +        g_thread_join(recorder_comm_thr);
> +        recorder_comm_thr = NULL;
> +    }
> +}
> +
> +void recorder_activate(recorder_info *recorder)
> +{
> +    if (nb_recorders >= NB_MAX_RECORDERS) {
> +        g_critical("Too many recorders configured (nb max: %d)",
> NB_MAX_RECORDERS);
> +        return;
> +    }
> +
> +    recorders[nb_recorders] = recorder;
> +    nb_recorders++;
> +}
> +
> +static void do_send_entry(FILE *dest, recorder_info *info, recorder_entry
> *entry, va_list args)
> +{
> +    fprintf(dest, "Name: %s\nFunction: %s\nTime: %lu\n",
> +            info->name, entry->where, entry->timestamp);
> +
> +    vfprintf(dest, entry->format, args);
> +    fprintf(dest, "\n\n");
> +
> +    fflush(dest);
> +}
> +
> +
> +static void recorder_trace_entry(recorder_info *info, recorder_entry *entry,
> ...)
> +//
> ----------------------------------------------------------------------------
> +//   Show a recorder entry when a trace is enabled
> +//
> ----------------------------------------------------------------------------
> +{
> +    va_list args;
> +
> +    if (strchr(entry->format, '\n') != NULL) {
> +        g_critical("Agent records cannot contain '\n' char ... (%s)",
> entry->where);
> +        return;
> +    }
> +
> +    // send info/entry to the socket
> +    g_mutex_lock(&mutex_socket);
> +
> +    if (communication_f == NULL) {
> +        g_mutex_unlock(&mutex_socket);
> +        return;
> +    }
> +
> +    va_start(args, entry);
> +    do_send_entry(communication_f, info, entry, args);
> +    va_end(args);
> +
> +    if (g_strcmp0(g_getenv("SPICE_AGENT_LOG_RECORDS"), "1") == 0) {
> +        va_start(args, entry);
> +        do_send_entry(stderr, info, entry, args);
> +        va_end(args);
> +    }
> +
> +    g_mutex_unlock(&mutex_socket);
> +}
> +
> +void recorder_append(recorder_info *rec,
> +                     const char *where,
> +                     const char *format,
> +                     uintptr_t a0,
> +                     uintptr_t a1,
> +                     uintptr_t a2,
> +                     uintptr_t a3)
> +//
> ----------------------------------------------------------------------------
> +//  Enter a record entry in ring buffer with given set of args
> +//
> ----------------------------------------------------------------------------
> +{
> +    recorder_entry entry;
> +
> +    if (!rec->trace) {
> +        return;
> +    }
> +
> +    entry.format = format;
> +    entry.timestamp = recorder_tick();
> +    entry.where = where;
> +
> +    recorder_trace_entry(rec, &entry, a0, a1, a2, a3);
> +}
> +
> +void recorder_append2(recorder_info *rec,
> +                      const char *where,
> +                      const char *format,
> +                      uintptr_t a0,
> +                      uintptr_t a1,
> +                      uintptr_t a2,
> +                      uintptr_t a3,
> +                      uintptr_t a4,
> +                      uintptr_t a5,
> +                      uintptr_t a6,
> +                      uintptr_t a7)
> +//
> ----------------------------------------------------------------------------
> +//   Enter a double record (up to 8 args)
> +//
> ----------------------------------------------------------------------------
> +{
> +    recorder_entry entry;
> +
> +    if (!rec->trace) {
> +        return;
> +    }
> +
> +    entry.format = format;
> +    entry.timestamp = recorder_tick();
> +    entry.where = where;
> +
> +    recorder_trace_entry(rec, &entry, a0, a1, a2, a3, a4, a5, a6, a7);
> +}
> +
> +//
> ============================================================================
> +//
> +//    Support functions
> +//
> +//
> ============================================================================
> +
> +static uintptr_t recorder_tick(void)
> +//
> ----------------------------------------------------------------------------
> +//   Return the "ticks" as stored in the recorder
> +//
> ----------------------------------------------------------------------------
> +{
> +    struct timeval t;
> +
> +    gettimeofday(&t, NULL);
> +
> +    return t.tv_sec * RECORDER_HZ + t.tv_usec / (1000000 / RECORDER_HZ);
> +}
> diff --git a/common/agent_interface.h b/common/agent_interface.h
> new file mode 100644
> index 0000000..042120e
> --- /dev/null
> +++ b/common/agent_interface.h
> @@ -0,0 +1,542 @@
> +#pragma once
> +
> +//
> *****************************************************************************
> +// This software is licensed under the GNU Lesser General Public License v2+
> +// (C) 2017-2019, Christophe de Dinechin <christophe at dinechin.org>
> +//
> *****************************************************************************
> +// This file was part of Recorder
> +//
> +// Recorder is free software: you can redistribute it and/or modify
> +// it under the terms of the GNU Lesser General Public License as published
> by
> +// the Free Software Foundation, either version 2 of the License, or
> +// (at your option) any later version.
> +//
> +// Recorder is distributed in the hope that it will be useful,
> +// but WITHOUT ANY WARRANTY; without even the implied warranty of
> +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
> +// GNU Lesser General Public License for more details.
> +//
> +// You should have received a copy of the GNU Lesser General Public License
> +// along with Recorder, in a file named COPYING.
> +// If not, see <https://www.gnu.org/licenses/>.
> +//
> *****************************************************************************
> +/* This file is based on Recorder's recorder.h file, that describes a
> general-
> + * purpose instrumentation interface. agent_interface.h is a trimmed-down
> + * version of it. */
> +
> +#include <stdarg.h>
> +#include <stdint.h>
> +#include <stdbool.h>
> +#include <stddef.h>
> +
> +#ifdef __cplusplus
> +extern "C" {
> +#endif // __cplusplus
> +
> +static inline void
> +recorder_dump_on_common_signals(unsigned add, unsigned remove)
> +{
> +}
> +
> +//
> ============================================================================
> +//
> +//    Recorder data structures
> +//
> +//
> ============================================================================
> +
> +typedef struct recorder_entry
> +///
> ---------------------------------------------------------------------------
> +///   Entry in the flight recorder.
> +///----------------------------------------------------------------------------
> +///  Notice that the arguments are stored as "intptr_t" because that type
> +///  is guaranteed to be the same size as a pointer. This allows us to
> +///  properly align recorder entries to powers of 2 for efficiency.
> +///  Also read explanations of \ref _recorder_double and \ref
> _recorder_float
> +///  below regarding how to use floating-point with the recorder.
> +{
> +    const char *format;         ///< Printf-style format for record +
> file/line
> +    uintptr_t   timestamp;      ///< Time at which record took place
> +    const char *where;          ///< Source code function
> +    uintptr_t   args[4];        ///< Four arguments, for a total of 8 fields
> +} recorder_entry;
> +
> +
> +/// A global counter indicating the order of entries across recorders.
> +/// this is incremented atomically for each record() call.
> +/// It must be exposed because all XYZ_record() implementations need to
> +/// touch the same shared variable in order to provide a global order.
> +extern uintptr_t recorder_order;
> +
> +typedef struct recorder_info
> +///----------------------------------------------------------------------------
> +///   A linked list of the activated recorders
> +///----------------------------------------------------------------------------
> +{
> +    intptr_t                trace;      ///< Trace this recorder
> +    const char *            name;       ///< Name of this parameter /
> recorder
> +    const char *            description;///< Description of what is recorded
> +    recorder_entry          data[0];    ///< Data for this recorder
> +} recorder_info;
> +
> +//
> ============================================================================
> +//
> +//   Adding data to a recorder
> +//
> +//
> ============================================================================
> +
> +extern void recorder_append(recorder_info *rec,
> +                            const char *where,
> +                            const char *format,
> +                            uintptr_t a0,
> +                            uintptr_t a1,
> +                            uintptr_t a2,
> +                            uintptr_t a3);
> +extern void recorder_append2(recorder_info *rec,
> +                             const char *where,
> +                             const char *format,
> +                             uintptr_t a0,
> +                             uintptr_t a1,
> +                             uintptr_t a2,
> +                             uintptr_t a3,
> +                             uintptr_t a4,
> +                             uintptr_t a5,
> +                             uintptr_t a6,
> +                             uintptr_t a7);
> +extern void recorder_append3(recorder_info *rec,
> +                             const char *where,
> +                             const char *format,
> +                             uintptr_t a0,
> +                             uintptr_t a1,
> +                             uintptr_t a2,
> +                             uintptr_t a3,
> +                             uintptr_t a4,
> +                             uintptr_t a5,
> +                             uintptr_t a6,
> +                             uintptr_t a7,
> +                             uintptr_t a8,
> +                             uintptr_t a9,
> +                             uintptr_t a10,
> +                             uintptr_t a11);
> +
> +/// Activate a recorder (during construction time)
> +extern void recorder_activate(recorder_info *recorder);
> +
> +//
> ============================================================================
> +//
> +//    Declaration of recorders and tweaks
> +//
> +//
> ============================================================================
> +
> +#define RECORDER_DECLARE(Name)                                          \
> +/* ----------------------------------------------------------------*/   \
> +/*  Declare a recorder with the given name (for use in headers)    */   \
> +/* ----------------------------------------------------------------*/   \
> +    extern recorder_info * const recorder_info_ptr_for_##Name;          \
> +    extern struct recorder_info_for_##Name recorder_info_for_##Name
> +
> +
> +//
> ============================================================================
> +//
> +//    Definition of recorders and tweaks
> +//
> +//
> ============================================================================
> +
> +#define RECORDER(Name, Size, Info)      RECORDER_DEFINE(Name,Size,Info)
> +
> +#define RECORDER_DEFINE(Name, Size, Info)                               \
> +/*!----------------------------------------------------------------*/   \
> +/*! Define a recorder type with Size elements                      */   \
> +/*!----------------------------------------------------------------*/   \
> +/*! \param Name is the C name fo the recorder.                          \
> + *! \param Size is the number of entries in the circular buffer.        \
> + *! \param Info is a description of the recorder for help. */           \
> +                                                                        \
> +/* The entry in linked list for this type */                            \
> +struct recorder_info_for_##Name                                         \
> +{                                                                       \
> +    recorder_info       info;                                           \
> +    recorder_entry      data[Size];                                     \
> +}                                                                       \
> +recorder_info_for_##Name =                                              \
> +{                                                                       \
> +    {                                                                   \
> +        0, #Name, Info, {}                                              \
> +    },                                                                  \
> +    {}                                                                  \
> +};                                                                      \
> +recorder_info * const recorder_info_ptr_for_##Name =                    \
> +    &recorder_info_for_##Name.info;                                     \
> +                                                                        \
> +RECORDER_CONSTRUCTOR                                                    \
> +static void recorder_activate_##Name(void)                              \
> +/* ----------------------------------------------------------------*/   \
> +/*  Activate recorder before entering main()                       */   \
> +/* ----------------------------------------------------------------*/   \
> +{                                                                       \
> +    recorder_activate(RECORDER_INFO(Name));                             \
> +}                                                                       \
> +                                                                        \
> +/* Purposefully generate compile error if macro not followed by ; */    \
> +extern void recorder_activate(recorder_info *recorder)
> +
> +typedef struct SpiceDummyTweak {
> +    intptr_t tweak_value;
> +} SpiceDummyTweak;
> +
> +typedef struct SpiceEmptyStruct {
> +    char dummy[0];
> +} SpiceEmptyStruct;
> +
> +#define RECORDER_TWEAK_DECLARE(rec) \
> +    extern const SpiceDummyTweak spice_recorder_tweak_ ## rec
> +
> +#define RECORDER_TWEAK_DEFINE(rec, value, comment) \
> +    const SpiceDummyTweak spice_recorder_tweak_ ## rec = { (value) }
> +
> +#define RECORDER_TWEAK(rec) \
> +    ((spice_recorder_tweak_ ## rec).tweak_value)
> +
> +#define RECORDER_TRACE(rec) \
> +    (sizeof(struct recorder_info_for_ ## rec) != sizeof(SpiceEmptyStruct))
> +
> +
> +//
> ============================================================================
> +//
> +//    Access to recorder and tweak info
> +//
> +//
> ============================================================================
> +
> +#define RECORDER_INFO(Name)     (recorder_info_ptr_for_##Name)
> +
> +//
> ============================================================================
> +//
> +//    Recording stuff
> +//
> +//
> ============================================================================
> +
> +#define record(Name, ...)               RECORD_MACRO(Name, __VA_ARGS__)
> +#define RECORD(Name,...)                RECORD_MACRO(Name, __VA_ARGS__)
> +#define RECORD_MACRO(Name, Format,...)                                  \
> +    RECORD_(RECORD,RECORD_COUNT_(__VA_ARGS__),Name,Format,##__VA_ARGS__)
> +#define RECORD_(RECORD,RCOUNT,Name,Format,...)                          \
> +    RECORD__(RECORD,RCOUNT,Name,Format,## __VA_ARGS__)
> +#define RECORD__(RECORD,RCOUNT,Name,Format,...)                         \
> +    RECORD##RCOUNT(Name,Format,##__VA_ARGS__)
> +#define RECORD_COUNT_(...)
> RECORD_COUNT__(Dummy,##__VA_ARGS__,_X,_X,_12,_11,_10,_9,_8,_7,_6,_5,_4,_3,_2,_1,_0)
> +#define
> RECORD_COUNT__(Dummy,_0,_1,_2,_3,_4,_5,_6,_7,_8,_9,_10,_11,_12,_13,_N,...)
> _N
> +
> +#define RECORD_0(Name, Format)                          \
> +    recorder_append(RECORDER_INFO(Name),                \
> +                    RECORDER_SOURCE_FUNCTION,           \
> +                    RECORDER_SOURCE_LOCATION            \
> +                    Format, 0, 0, 0, 0)
> +#define RECORD_1(Name, Format, a)                       \
> +    recorder_append(RECORDER_INFO(Name),                \
> +                    RECORDER_SOURCE_FUNCTION,           \
> +                    RECORDER_SOURCE_LOCATION            \
> +                    Format,                             \
> +                    RECORDER_ARG(a), 0, 0, 0)
> +#define RECORD_2(Name, Format, a,b)                     \
> +    recorder_append(RECORDER_INFO(Name),                \
> +                    RECORDER_SOURCE_FUNCTION,           \
> +                    RECORDER_SOURCE_LOCATION            \
> +                    Format,                             \
> +                    RECORDER_ARG(a),                    \
> +                    RECORDER_ARG(b), 0, 0)
> +#define RECORD_3(Name, Format, a,b,c)                   \
> +    recorder_append(RECORDER_INFO(Name),                \
> +                    RECORDER_SOURCE_FUNCTION,           \
> +                    RECORDER_SOURCE_LOCATION            \
> +                    Format,                             \
> +                    RECORDER_ARG(a),                    \
> +                    RECORDER_ARG(b),                    \
> +                    RECORDER_ARG(c), 0)
> +#define RECORD_4(Name, Format, a,b,c,d)                 \
> +    recorder_append(RECORDER_INFO(Name),                \
> +                    RECORDER_SOURCE_FUNCTION,           \
> +                    RECORDER_SOURCE_LOCATION            \
> +                    Format,                             \
> +                    RECORDER_ARG(a),                    \
> +                    RECORDER_ARG(b),                    \
> +                    RECORDER_ARG(c),                    \
> +                    RECORDER_ARG(d))
> +#define RECORD_5(Name, Format, a,b,c,d,e)               \
> +    recorder_append2(RECORDER_INFO(Name),               \
> +                     RECORDER_SOURCE_FUNCTION,          \
> +                     RECORDER_SOURCE_LOCATION           \
> +                     Format,                            \
> +                     RECORDER_ARG(a),                   \
> +                     RECORDER_ARG(b),                   \
> +                     RECORDER_ARG(c),                   \
> +                     RECORDER_ARG(d),                   \
> +                     RECORDER_ARG(e), 0, 0, 0)
> +#define RECORD_6(Name, Format, a,b,c,d,e,f)             \
> +    recorder_append2(RECORDER_INFO(Name),               \
> +                     RECORDER_SOURCE_FUNCTION,          \
> +                     RECORDER_SOURCE_LOCATION           \
> +                     Format,                            \
> +                     RECORDER_ARG(a),                   \
> +                     RECORDER_ARG(b),                   \
> +                     RECORDER_ARG(c),                   \
> +                     RECORDER_ARG(d),                   \
> +                     RECORDER_ARG(e),                   \
> +                     RECORDER_ARG(f), 0, 0)
> +#define RECORD_7(Name, Format, a,b,c,d,e,f,g)           \
> +    recorder_append2(RECORDER_INFO(Name),               \
> +                     RECORDER_SOURCE_FUNCTION,          \
> +                     RECORDER_SOURCE_LOCATION           \
> +                     Format,                            \
> +                     RECORDER_ARG(a),                   \
> +                     RECORDER_ARG(b),                   \
> +                     RECORDER_ARG(c),                   \
> +                     RECORDER_ARG(d),                   \
> +                     RECORDER_ARG(e),                   \
> +                     RECORDER_ARG(f),                   \
> +                     RECORDER_ARG(g), 0)
> +#define RECORD_8(Name, Format, a,b,c,d,e,f,g,h)         \
> +    recorder_append2(RECORDER_INFO(Name),               \
> +                     RECORDER_SOURCE_FUNCTION,          \
> +                     RECORDER_SOURCE_LOCATION           \
> +                     Format,                            \
> +                     RECORDER_ARG(a),                   \
> +                     RECORDER_ARG(b),                   \
> +                     RECORDER_ARG(c),                   \
> +                     RECORDER_ARG(d),                   \
> +                     RECORDER_ARG(e),                   \
> +                     RECORDER_ARG(f),                   \
> +                     RECORDER_ARG(g),                   \
> +                     RECORDER_ARG(h))
> +#define RECORD_9(Name, Format, a,b,c,d,e,f,g,h,i)       \
> +    recorder_append3(RECORDER_INFO(Name),               \
> +                     RECORDER_SOURCE_FUNCTION,          \
> +                     RECORDER_SOURCE_LOCATION           \
> +                     Format,                            \
> +                     RECORDER_ARG(a),                   \
> +                     RECORDER_ARG(b),                   \
> +                     RECORDER_ARG(c),                   \
> +                     RECORDER_ARG(d),                   \
> +                     RECORDER_ARG(e),                   \
> +                     RECORDER_ARG(f),                   \
> +                     RECORDER_ARG(g),                   \
> +                     RECORDER_ARG(h),                   \
> +                     RECORDER_ARG(i), 0,0,0)
> +#define RECORD_10(Name, Format, a,b,c,d,e,f,g,h,i,j)    \
> +    recorder_append3(RECORDER_INFO(Name),               \
> +                     RECORDER_SOURCE_FUNCTION,          \
> +                     RECORDER_SOURCE_LOCATION           \
> +                     Format,                            \
> +                     RECORDER_ARG(a),                   \
> +                     RECORDER_ARG(b),                   \
> +                     RECORDER_ARG(c),                   \
> +                     RECORDER_ARG(d),                   \
> +                     RECORDER_ARG(e),                   \
> +                     RECORDER_ARG(f),                   \
> +                     RECORDER_ARG(g),                   \
> +                     RECORDER_ARG(h),                   \
> +                     RECORDER_ARG(i),                   \
> +                     RECORDER_ARG(j), 0,0)
> +#define RECORD_11(Name, Format, a,b,c,d,e,f,g,h,i,j,k)  \
> +    recorder_append3(RECORDER_INFO(Name),               \
> +                     RECORDER_SOURCE_FUNCTION,          \
> +                     RECORDER_SOURCE_LOCATION           \
> +                     Format,                            \
> +                     RECORDER_ARG(a),                   \
> +                     RECORDER_ARG(b),                   \
> +                     RECORDER_ARG(c),                   \
> +                     RECORDER_ARG(d),                   \
> +                     RECORDER_ARG(e),                   \
> +                     RECORDER_ARG(f),                   \
> +                     RECORDER_ARG(g),                   \
> +                     RECORDER_ARG(h),                   \
> +                     RECORDER_ARG(i),                   \
> +                     RECORDER_ARG(j),                   \
> +                     RECORDER_ARG(k),0)
> +#define RECORD_12(Name,Format,a,b,c,d,e,f,g,h,i,j,k,l)  \
> +    recorder_append3(RECORDER_INFO(Name),               \
> +                     RECORDER_SOURCE_FUNCTION,          \
> +                     RECORDER_SOURCE_LOCATION           \
> +                     Format,                            \
> +                     RECORDER_ARG(a),                   \
> +                     RECORDER_ARG(b),                   \
> +                     RECORDER_ARG(c),                   \
> +                     RECORDER_ARG(d),                   \
> +                     RECORDER_ARG(e),                   \
> +                     RECORDER_ARG(f),                   \
> +                     RECORDER_ARG(g),                   \
> +                     RECORDER_ARG(h),                   \
> +                     RECORDER_ARG(i),                   \
> +                     RECORDER_ARG(j),                   \
> +                     RECORDER_ARG(k),                   \
> +                     RECORDER_ARG(l))
> +#define RECORD_X(Name, Format, ...)   RECORD_TOO_MANY_ARGS(printf(Format,
> __VA_ARGS__))
> +
> +
> +// Some ugly macro drudgery to make things easy to use. Adjust type.
> +#ifdef __cplusplus
> +#define RECORDER_ARG(arg)       _recorder_arg(arg)
> +#else // !__cplusplus
> +
> +#if defined(__GNUC__) && !defined(__clang__)
> +#  if __GNUC__ <= 4 || (__GNUC__ == 4 && __GNUC_MINOR__ < 9)
> +#    define RECORDER_WITHOUT_GENERIC
> +#  endif
> +#endif // __GNUC__
> +
> +#ifdef RECORDER_WITHOUT_GENERIC
> +#define RECORDER_ARG(arg) ((uintptr_t) (arg))
> +#else // !RECORDER_WITHOUT_GENERIC
> +#define RECORDER_ARG(arg)                               \
> +    _Generic(arg,                                       \
> +             unsigned char:     _recorder_unsigned,     \
> +             unsigned short:    _recorder_unsigned,     \
> +             unsigned:          _recorder_unsigned,     \
> +             unsigned long:     _recorder_unsigned,     \
> +             unsigned long long:_recorder_unsigned,     \
> +             char:              _recorder_char,         \
> +             signed char:       _recorder_signed,       \
> +             signed short:      _recorder_signed,       \
> +             signed:            _recorder_signed,       \
> +             signed long:       _recorder_signed,       \
> +             signed long long:  _recorder_signed,       \
> +             float:             _recorder_float,        \
> +             double:            _recorder_double,       \
> +             default:           _recorder_pointer)(arg)
> +#endif // RECORDER_WITHOUT_GENERIC
> +#endif // __cplusplus
> +
> +//
> ============================================================================
> +//
> +//    Timing information
> +//
> +//
> ============================================================================
> +
> +#define RECORD_TIMING_BEGIN(rec) \
> +    do { RECORD(rec, "begin");
> +#define RECORD_TIMING_END(rec, op, name, value) \
> +        RECORD(rec, "end" op name); \
> +    } while (0)
> +
> +
> +//
> ============================================================================
> +//
> +//   Support macros
> +//
> +//
> ============================================================================
> +
> +#define RECORDER_SOURCE_FUNCTION    __func__ /* Works in C99 and C++11 */
> +#define RECORDER_SOURCE_LOCATION    __FILE__ ":" RECORDER_STRING(__LINE__)
> ":"
> +#define RECORDER_STRING(LINE)       RECORDER_STRING_(LINE)
> +#define RECORDER_STRING_(LINE)      #LINE
> +
> +#ifdef __GNUC__
> +#define RECORDER_CONSTRUCTOR            __attribute__((constructor))
> +#else
> +#define RECORDER_CONSTRUCTOR
> +#endif
> +
> +#ifdef __cplusplus
> +}
> +#endif // __cplusplus
> +
> +//
> ============================================================================
> +//
> +//    Utility: Convert floating point values for vararg format
> +//
> +//
> ============================================================================
> +//
> +//   The recorder stores only uintptr_t in recorder entries. Integer types
> +//   are promoted, pointer types are converted. Floating point values
> +//   are converted a floating point type of the same size as uintptr_t,
> +//   i.e. float are converted to double on 64-bit platforms, and conversely.
> +
> +#ifdef __cplusplus
> +#include <string>
> +
> +// In C++, we don't use _Generic but actual overloading
> +template <class inttype>
> +static inline uintptr_t         _recorder_arg(inttype i)
> +{
> +    return (uintptr_t) i;
> +}
> +
> +
> +static inline uintptr_t         _recorder_arg(const std::string &arg)
> +{
> +    return (uintptr_t) arg.c_str();
> +}
> +#define _recorder_float         _recorder_arg
> +#define _recorder_double        _recorder_arg
> +
> +#else // !__cplusplus
> +
> +static inline uintptr_t _recorder_char(char c)
> +//
> ----------------------------------------------------------------------------
> +//   Necessary because of the way generic selections work
> +//
> ----------------------------------------------------------------------------
> +{
> +    return c;
> +}
> +
> +
> +static inline uintptr_t _recorder_unsigned(uintptr_t i)
> +//
> ----------------------------------------------------------------------------
> +//   Necessary because of the way generic selections work
> +//
> ----------------------------------------------------------------------------
> +{
> +    return i;
> +}
> +
> +
> +static inline uintptr_t _recorder_signed(intptr_t i)
> +//
> ----------------------------------------------------------------------------
> +//   Necessary because of the way generic selections work
> +//
> ----------------------------------------------------------------------------
> +{
> +    return (uintptr_t) i;
> +}
> +
> +
> +static inline uintptr_t _recorder_pointer(const void *i)
> +//
> ----------------------------------------------------------------------------
> +//   Necessary because of the way generic selections work
> +//
> ----------------------------------------------------------------------------
> +{
> +    return (uintptr_t) i;
> +}
> +
> +#endif // __cplusplus
> +
> +
> +static inline uintptr_t _recorder_float(float f)
> +//
> ----------------------------------------------------------------------------
> +//   Convert floating point number to intptr_t representation for recorder
> +//
> ----------------------------------------------------------------------------
> +{
> +    if (sizeof(float) == sizeof(intptr_t)) {
> +        union { float f; uintptr_t i; } u;
> +        u.f = f;
> +        return u.i;
> +    } else {
> +        union { double d; uintptr_t i; } u;
> +        u.d = (double) f;
> +        return u.i;
> +    }
> +}
> +
> +
> +static inline uintptr_t _recorder_double(double d)
> +//
> ----------------------------------------------------------------------------
> +//   Convert double-precision floating point number to intptr_t
> representation
> +//
> ----------------------------------------------------------------------------
> +{
> +    if (sizeof(double) == sizeof(intptr_t)) {
> +        union { double d; uintptr_t i; } u;
> +        u.d = d;
> +        return u.i;
> +    } else {
> +        // Better to lose precision than not store any data
> +        union { float f; uintptr_t i; } u;
> +        u.f = d;
> +        return u.i;
> +    }
> +}
> diff --git a/tests/test-dummy-recorder.c b/tests/test-dummy-recorder.c
> index 4e674a9..5be4cbd 100644
> --- a/tests/test-dummy-recorder.c
> +++ b/tests/test-dummy-recorder.c
> @@ -19,7 +19,8 @@
>  #include <config.h>
>  #include <assert.h>
> 
> -#undef ENABLE_RECORDER
> +#undef ENABLE_C3D_RECORDER
> +#undef ENABLE_AGENT_INTERFACE
> 
>  #include <common/recorder.h>
> 

Frediano


More information about the Spice-devel mailing list