Console/Readline.cc

   1 // $Id$
   2 //
   3 // Copyright (C) 2008
   4 // Fraunhofer Institute for Open Communication Systems (FOKUS)
   5 // Competence Center NETwork research (NET), St. Augustin, GERMANY
   6 //     Stefan Bund <g0dil@berlios.de>
   7 //
   8 // This program is free software; you can redistribute it and/or modify
   9 // it under the terms of the GNU General Public License as published by
  10 // the Free Software Foundation; either version 2 of the License, or
  11 // (at your option) any later version.
  12 //
  13 // This program is distributed in the hope that it will be useful,
  14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 // GNU General Public License for more details.
  17 //
  18 // You should have received a copy of the GNU General Public License
  19 // along with this program; if not, write to the
  20 // Free Software Foundation, Inc.,
  21 // 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  22
  23 /** \file
  24     \brief Readline non-inline non-template implementation */
  25
  26 #include "Readline.hh"
  27 //#include "Readline.ih"
  28
  29 // Custom includes
  30 #include <stdio.h>
  31 #include <readline/readline.h>
  32 #include <readline/history.h>
  33 #include <boost/algorithm/string/trim.hpp>
  34 #include <boost/algorithm/string/replace.hpp>
  35 #include "../Utils/membind.hh"
  36
  37 //#include "Readline.mpp"
  38 #define prefix_
  39 ///////////////////////////////cc.p////////////////////////////////////////
  40
  41 //
  42 // Readline integration is a bit awkward. There are several things to it:
  43 //
  44 //  - Readline uses global variables for all state. Therefore, we can use readline only for one
  45 //    console.
  46 //  - We need to make readline to read from the socket handle instead of some input stream. We can
  47 //    do this by setting a custom rl_getc_function.
  48 //  - We need to make readline to write to the NonblockingSocketOStream. This is possible in glibc
  49 //    by using a 'cookie stream'.
  50 //  - We need to correctly handle the terminal mode settings. Currently we unconditionally
  51 //    initialize the remote telnet by sending a fixed telnet option string and ignoring any otpions
  52 //    sent back to us.
  53 //  - We need to make sure, readline never uses stderr -> we must disable beeping
  54 //  - There are places, where readline calls read_key unconditionally even when NOT prompted by the
  55 //    callback that another key is available. One such place is completion. (The 'show all
  56 //    completions (y/n)?' question). For now, we disable completion support.
  57 //
  58
  59 ///////////////////////////////////////////////////////////////////////////
  60 // senf::console::detail::ReadlineClientReader
  61
  62 extern "C" {
  63     extern int readline_echoing_p;
  64     extern int _rl_bell_preference;
  65
  66     void _rl_erase_entire_line();
  67 }
  68
  69
  70 namespace {
  71
  72     int readline_getc_function(FILE *)
  73     {
  74         if (senf::console::detail::ReadlineClientReader::active())
  75             return senf::console::detail::ReadlineClientReader::instance().getc();
  76         else
  77             return -1;
  78     }
  79
  80     void readline_callback(char * input)
  81     {
  82         if (senf::console::detail::ReadlineClientReader::active() && input)
  83             return senf::console::detail::ReadlineClientReader::instance().callback(
  84                 std::string(input) );
  85     }
  86
  87     ssize_t readline_cookie_write_function(void * cookie, char const * buffer, size_t size)
  88     {
  89         if (senf::console::detail::ReadlineClientReader::active() && buffer)
  90             senf::console::detail::ReadlineClientReader::instance().write(
  91                 std::string(buffer, size));
  92         return size;
  93     }
  94
  95     void readline_prep_term(int meta)
  96     {
  97         readline_echoing_p = 1;
  98     }
  99
 100     void readline_deprep_term()
 101     {}
 102
 103 }
 104
 105 prefix_ senf::console::detail::ReadlineClientReader::ReadlineClientReader(Client & client)
 106     : ClientReader(client), ch_ (-1), skipChars_ (0),
 107       schedBinding_ ( client.handle(),
 108                       senf::membind(&ReadlineClientReader::charEvent, this),
 109                       Scheduler::EV_READ,
 110                       false ),
 111       terminate_ (false)
 112 {
 113     if (instance_ != 0)
 114         throw DuplicateReaderException();
 115     instance_ = this;
 116
 117     cookie_io_functions_t cookie_io = { 0, &readline_cookie_write_function, 0, 0 };
 118     rl_outstream = fopencookie(0, "a", cookie_io);
 119     if (rl_outstream == 0)
 120         SENF_THROW_SYSTEM_EXCEPTION("");
 121     if (setvbuf(rl_outstream, 0, _IONBF, BUFSIZ) < 0)
 122         SENF_THROW_SYSTEM_EXCEPTION("");
 123     rl_instream = rl_outstream;
 124     rl_terminal_name = "vt100";
 125     strncpy(nameBuffer_, client.name().c_str(), 128);
 126     nameBuffer_[127] = 0;
 127     rl_readline_name = nameBuffer_;
 128     rl_prep_term_function = &readline_prep_term;
 129     rl_deprep_term_function = &readline_deprep_term;
 130     rl_getc_function = &readline_getc_function;
 131     rl_bind_key('\t', &rl_insert);
 132     using_history();
 133
 134     // Don't ask me, where I found this ...
 135     static char options[] = { 0xFF, 0xFB, 0x01, // IAC WILL ECHO
 136                               0xFF, 0xFE, 0x22, // IAC DONT LINEMODE
 137                               0xFF, 0xFB, 0x03, // IAC WILL SGA
 138                               0x00 };
 139     handle().write(options, options+sizeof(options));
 140
 141     strncpy(promptBuffer_, promptString().c_str(), 1024);
 142     promptBuffer_[1023] = 0;
 143     rl_callback_handler_install(promptBuffer_, &readline_callback);
 144
 145     _rl_bell_preference = 0; // Set this *after* the config file has been read
 146
 147     schedBinding_.enable();
 148 }
 149
 150 prefix_ senf::console::detail::ReadlineClientReader::~ReadlineClientReader()
 151 {
 152     rl_callback_handler_remove();
 153     fclose(rl_outstream);
 154     rl_outstream = 0;
 155     rl_instream = 0;
 156     instance_ = 0;
 157 }
 158
 159 prefix_ void senf::console::detail::ReadlineClientReader::callback(std::string line)
 160 {
 161     boost::trim(line);
 162     if (!line.empty())
 163         add_history(line.c_str());
 164     handleInput(line);
 165     stream() << std::flush;
 166     strncpy(promptBuffer_, promptString().c_str(), 1024);
 167     promptBuffer_[1023] = 0;
 168     rl_set_prompt(promptBuffer_);
 169 }
 170
 171 prefix_ void senf::console::detail::ReadlineClientReader::v_disablePrompt()
 172 {
 173     _rl_erase_entire_line();
 174 }
 175
 176 prefix_ void senf::console::detail::ReadlineClientReader::v_enablePrompt()
 177 {
 178     rl_forced_update_display();
 179 }
 180
 181 prefix_ void senf::console::detail::ReadlineClientReader::v_translate(std::string & data)
 182 {
 183     boost::replace_all(data, "\n", "\n\r");
 184     boost::replace_all(data, "\xff", "\xff\xff");
 185 }
 186
 187 prefix_ void senf::console::detail::ReadlineClientReader::charEvent(Scheduler::EventId event)
 188 {
 189     char ch;
 190     if (event != Scheduler::EV_READ || handle().read(&ch, &ch+1) <= &ch) {
 191         stopClient();
 192         return;
 193     }
 194     ch_ = ch;
 195
 196     if (skipChars_ > 0)
 197         --skipChars_;
 198     else if (ch_ == static_cast<char>(0xff))
 199         skipChars_ = 2;
 200     else if (ch_ != 0)
 201         rl_callback_read_char();
 202
 203     if (terminate_)
 204         stopClient();
 205 }
 206
 207 senf::console::detail::ReadlineClientReader *
 208     senf::console::detail::ReadlineClientReader::instance_ (0);
 209
 210 ///////////////////////////////////////////////////////////////////////////
 211 // senf::console::detail::SafeReadlineClientReader
 212
 213 prefix_ void senf::console::detail::SafeReadlineClientReader::v_disablePrompt()
 214 {
 215     reader_->disablePrompt();
 216 }
 217
 218 prefix_ void senf::console::detail::SafeReadlineClientReader::v_enablePrompt()
 219 {
 220     reader_->enablePrompt();
 221 }
 222
 223 prefix_ void senf::console::detail::SafeReadlineClientReader::v_translate(std::string & data)
 224 {
 225     reader_->translate(data);
 226 }
 227
 228 ///////////////////////////////cc.e////////////////////////////////////////
 229 #undef prefix_
 230 //#include "Readline.mpp"
 231
 232 \f
 233 // Local Variables:
 234 // mode: c++
 235 // fill-column: 100
 236 // comment-column: 40
 237 // c-file-style: "senf"
 238 // indent-tabs-mode: nil
 239 // ispell-local-dictionary: "american"
 240 // compile-command: "scons -u test"
 241 // End: