libcc1/connection.hh

   1 /* Plugin connection declarations
   2    Copyright (C) 2014-2019 Free Software Foundation, Inc.
   3
   4 This file is part of GCC.
   5
   6 GCC is free software; you can redistribute it and/or modify it under
   7 the terms of the GNU General Public License as published by the Free
   8 Software Foundation; either version 3, or (at your option) any later
   9 version.
  10
  11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14 for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GCC; see the file COPYING3.  If not see
  18 <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef CC1_PLUGIN_CONNECTION_HH
  21 #define CC1_PLUGIN_CONNECTION_HH
  22
  23 #include "status.hh"
  24 #include "callbacks.hh"
  25
  26 namespace cc1_plugin
  27 {
  28   // The connection class represents one side of the connection
  29   // between the gdb-side library and the gcc plugin.  It handles the
  30   // low-level details of reading and writing data.
  31   class connection
  32   {
  33   public:
  34
  35     connection (int fd)
  36       : m_fd (fd),
  37         m_aux_fd (-1),
  38         m_callbacks ()
  39     {
  40     }
  41
  42     connection (int fd, int aux_fd)
  43       : m_fd (fd),
  44         m_aux_fd (aux_fd),
  45         m_callbacks ()
  46     {
  47     }
  48
  49     virtual ~connection ();
  50
  51     // Send a single character.  This is used to introduce various
  52     // higher-level protocol elements.
  53     status send (char c);
  54
  55     // Send data in bulk.
  56     status send (const void *buf, int len);
  57
  58     // Read a single byte from the connection and verify that it
  59     // matches the argument C.
  60     status require (char c);
  61
  62     // Read data in bulk.
  63     status get (void *buf, int len);
  64
  65     // This is called after a query (remote function call) has been
  66     // sent to the remote.  It waits for a response packet.  The
  67     // response character is read before returning.  Any query packets
  68     // sent from the remote while waiting for a response are handled
  69     // by this function.
  70     status wait_for_result ()
  71     {
  72       return do_wait (true);
  73     }
  74
  75     // Read and respond to query packets sent by the remote.  This
  76     // function returns when the connection is closed.
  77     status wait_for_query ()
  78     {
  79       return do_wait (false);
  80     }
  81
  82     // Register a callback with this connection.  NAME is the name of
  83     // the method being registered.  FUNC is the function.  It must
  84     // know how to decode its own arguments.  When a query packet is
  85     // received by one of the wait_* methods, the corresponding
  86     // callback is invoked.
  87     void add_callback (const char *name, callback_ftype *func)
  88     {
  89       m_callbacks.add_callback (name, func);
  90     }
  91
  92     virtual void print (const char *);
  93
  94   private:
  95
  96     // Declared but not defined, to prevent use.
  97     connection (const connection &);
  98     connection &operator= (const connection &);
  99
 100     // Helper function for the wait_* methods.
 101     status do_wait (bool);
 102
 103     // The file descriptor.
 104     int m_fd;
 105
 106     // An auxiliary file descriptor, or -1 if none.
 107     int m_aux_fd;
 108
 109     // Callbacks associated with this connection.
 110     callbacks m_callbacks;
 111   };
 112 }
 113
 114 #endif // CC1_PLUGIN_CONNECTION_HH