Mercurial > jdk8-mips64-public > hotspot / file revision

 /*

  * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.

  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

  *

  * This code is free software; you can redistribute it and/or modify it

  * under the terms of the GNU General Public License version 2 only, as

  * published by the Free Software Foundation.

  *

  * This code 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 General Public License

  * version 2 for more details (a copy is included in the LICENSE file that

  * accompanied this code).

  *

  * You should have received a copy of the GNU General Public License version

  * 2 along with this work; if not, write to the Free Software Foundation,

  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

  *

  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

  * or visit www.oracle.com if you need additional information or have any

  * questions.

  *

  */

 #ifndef SHARE_VM_UTILITIES_OSTREAM_HPP

 #define SHARE_VM_UTILITIES_OSTREAM_HPP

 #include "memory/allocation.hpp"

 #include "runtime/timer.hpp"

 // Output streams for printing

 //

 // Printing guidelines:

 // Where possible, please use tty->print() and tty->print_cr().

 // For product mode VM warnings use warning() which internally uses tty.

 // In places where tty is not initialized yet or too much overhead,

 // we may use jio_printf:

 //     jio_fprintf(defaultStream::output_stream(), "Message");

 // This allows for redirection via -XX:+DisplayVMOutputToStdout and

 // -XX:+DisplayVMOutputToStderr

 class outputStream : public ResourceObj {

  protected:

    int _indentation; // current indentation

    int _width;       // width of the page

    int _position;    // position on the current line

    int _newlines;    // number of '\n' output so far

    julong _precount; // number of chars output, less _position

    TimeStamp _stamp; // for time stamps

    void update_position(const char* s, size_t len);

    static const char* do_vsnprintf(char* buffer, size_t buflen,

                                    const char* format, va_list ap,

                                    bool add_cr,

                                    size_t& result_len);

  public:

    // creation

    outputStream(int width = 80);

    outputStream(int width, bool has_time_stamps);

    // indentation

    void indent();

    void inc() { _indentation++; };

    void dec() { _indentation--; };

    int  indentation() const    { return _indentation; }

    void set_indentation(int i) { _indentation = i;    }

    void fill_to(int col);

    void move_to(int col, int slop = 6, int min_space = 2);

    // sizing

    int width()    const { return _width;    }

    int position() const { return _position; }

    int newlines() const { return _newlines; }

    julong count() const { return _precount + _position; }

    void set_count(julong count) { _precount = count - _position; }

    void set_position(int pos)   { _position = pos; }

    // printing

    void print(const char* format, ...);

    void print_cr(const char* format, ...);

    void vprint(const char *format, va_list argptr);

    void vprint_cr(const char* format, va_list argptr);

    void print_raw(const char* str)            { write(str, strlen(str)); }

    void print_raw(const char* str, int len)   { write(str,         len); }

    void print_raw_cr(const char* str)         { write(str, strlen(str)); cr(); }

    void print_raw_cr(const char* str, int len){ write(str,         len); cr(); }

    void put(char ch);

    void sp(int count = 1);

    void cr();

    void bol() { if (_position > 0)  cr(); }

    // Time stamp

    TimeStamp& time_stamp() { return _stamp; }

    void stamp();

    void stamp(bool guard, const char* prefix, const char* suffix);

    void stamp(bool guard) {

      stamp(guard, "", ": ");

    }

    // Date stamp

    void date_stamp(bool guard, const char* prefix, const char* suffix);

    // A simplified call that includes a suffix of ": "

    void date_stamp(bool guard) {

      date_stamp(guard, "", ": ");

    }

    // portable printing of 64 bit integers

    void print_jlong(jlong value);

    void print_julong(julong value);

    // flushing

    virtual void flush() {}

    virtual void write(const char* str, size_t len) = 0;

    virtual ~outputStream() {}  // close properly on deletion

    void dec_cr() { dec(); cr(); }

    void inc_cr() { inc(); cr(); }

 };

 // standard output

                                 // ANSI C++ name collision

 extern outputStream* tty;           // tty output

 extern outputStream* gclog_or_tty;  // stream for gc log if -Xloggc:<f>, or tty

 // advisory locking for the shared tty stream:

 class ttyLocker: StackObj {

  private:

   intx _holder;

  public:

   static intx  hold_tty();                // returns a "holder" token

   static void  release_tty(intx holder);  // must witness same token

   static void  break_tty_lock_for_safepoint(intx holder);

   ttyLocker()  { _holder = hold_tty(); }

   ~ttyLocker() { release_tty(_holder); }

 };

 // for writing to strings; buffer will expand automatically

 class stringStream : public outputStream {

  protected:

   char*  buffer;

   size_t buffer_pos;

   size_t buffer_length;

   bool   buffer_fixed;

  public:

   stringStream(size_t initial_bufsize = 256);

   stringStream(char* fixed_buffer, size_t fixed_buffer_size);

   ~stringStream();

   virtual void write(const char* c, size_t len);

   size_t      size() { return buffer_pos; }

   const char* base() { return buffer; }

   void  reset() { buffer_pos = 0; _precount = 0; _position = 0; }

   char* as_string();

 };

 class fileStream : public outputStream {

  protected:

   FILE* _file;

   bool  _need_close;

  public:

   fileStream(const char* file_name);

   fileStream(FILE* file) { _file = file; _need_close = false; }

   ~fileStream();

   bool is_open() const { return _file != NULL; }

   virtual void write(const char* c, size_t len);

   void flush();

 };

 // unlike fileStream, fdStream does unbuffered I/O by calling

 // open() and write() directly. It is async-safe, but output

 // from multiple thread may be mixed together. Used by fatal

 // error handler.

 class fdStream : public outputStream {

  protected:

   int  _fd;

   bool _need_close;

  public:

   fdStream(const char* file_name);

   fdStream(int fd = -1) { _fd = fd; _need_close = false; }

   ~fdStream();

   bool is_open() const { return _fd != -1; }

   void set_fd(int fd) { _fd = fd; _need_close = false; }

   int fd() const { return _fd; }

   virtual void write(const char* c, size_t len);

   void flush() {};

 };

 void ostream_init();

 void ostream_init_log();

 void ostream_exit();

 void ostream_abort();

 // staticBufferStream uses a user-supplied buffer for all formatting.

 // Used for safe formatting during fatal error handling.  Not MT safe.

 // Do not share the stream between multiple threads.

 class staticBufferStream : public outputStream {

  private:

   char* _buffer;

   size_t _buflen;

   outputStream* _outer_stream;

  public:

   staticBufferStream(char* buffer, size_t buflen,

                      outputStream *outer_stream);

   ~staticBufferStream() {};

   virtual void write(const char* c, size_t len);

   void flush();

   void print(const char* format, ...);

   void print_cr(const char* format, ...);

   void vprint(const char *format, va_list argptr);

   void vprint_cr(const char* format, va_list argptr);

 };

 // In the non-fixed buffer case an underlying buffer will be created and

 // managed in C heap. Not MT-safe.

 class bufferedStream : public outputStream {

  protected:

   char*  buffer;

   size_t buffer_pos;

   size_t buffer_max;

   size_t buffer_length;

   bool   buffer_fixed;

  public:

   bufferedStream(size_t initial_bufsize = 256, size_t bufmax = 1024*1024*10);

   bufferedStream(char* fixed_buffer, size_t fixed_buffer_size, size_t bufmax = 1024*1024*10);

   ~bufferedStream();

   virtual void write(const char* c, size_t len);

   size_t      size() { return buffer_pos; }

   const char* base() { return buffer; }

   void  reset() { buffer_pos = 0; _precount = 0; _position = 0; }

   char* as_string();

 };

 #define O_BUFLEN 2000   // max size of output of individual print() methods

 #ifndef PRODUCT

 class networkStream : public bufferedStream {

   private:

     int _socket;

   public:

     networkStream();

     ~networkStream();

     bool connect(const char *host, short port);

     bool is_open() const { return _socket != -1; }

     int read(char *buf, size_t len);

     void close();

     virtual void flush();

 };

 #endif

 #endif // SHARE_VM_UTILITIES_OSTREAM_HPP