src/openvpn/status.h
6fbf66fa
 /*
  *  OpenVPN -- An application to securely tunnel IP networks
  *             over a single TCP/UDP port, with support for SSL/TLS-based
  *             session authentication and key exchange,
  *             packet encryption, packet authentication, and
  *             packet compression.
  *
49979459
  *  Copyright (C) 2002-2018 OpenVPN Inc <sales@openvpn.net>
6fbf66fa
  *
  *  This program is free software; you can redistribute it and/or modify
  *  it under the terms of the GNU General Public License version 2
  *  as published by the Free Software Foundation.
  *
  *  This program 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 for more details.
  *
caa54ac3
  *  You should have received a copy of the GNU General Public License along
  *  with this program; if not, write to the Free Software Foundation, Inc.,
  *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
6fbf66fa
  */
 
 #ifndef STATUS_H
 #define STATUS_H
 
 #include "interval.h"
 
 /*
  * virtual function interface for status output
  */
 struct virtual_output {
81d882d5
     void *arg;
     unsigned int flags_default;
     void (*func) (void *arg, const unsigned int flags, const char *str);
6fbf66fa
 };
 
 static inline void
81d882d5
 virtual_output_print(const struct virtual_output *vo, const unsigned int flags, const char *str)
6fbf66fa
 {
81d882d5
     (*vo->func)(vo->arg, flags, str);
6fbf66fa
 }
 
 /*
  * printf-style interface for inputting/outputting status info
  */
 
 struct status_output
 {
81d882d5
 #define STATUS_OUTPUT_READ  (1<<0)
 #define STATUS_OUTPUT_WRITE (1<<1)
     unsigned int flags;
6fbf66fa
 
81d882d5
     char *filename;
     int fd;
     int msglevel;
     const struct virtual_output *vout;
6fbf66fa
 
81d882d5
     struct buffer read_buf;
6fbf66fa
 
81d882d5
     struct event_timeout et;
6fbf66fa
 
81d882d5
     bool errors;
6fbf66fa
 };
 
81d882d5
 struct status_output *status_open(const char *filename,
                                   const int refresh_freq,
                                   const int msglevel,
                                   const struct virtual_output *vout,
                                   const unsigned int flags);
 
 bool status_trigger_tv(struct status_output *so, struct timeval *tv);
 
 bool status_trigger(struct status_output *so);
 
 void status_reset(struct status_output *so);
 
 void status_flush(struct status_output *so);
 
 bool status_close(struct status_output *so);
 
 void status_printf(struct status_output *so, const char *format, ...)
6fbf66fa
 #ifdef __GNUC__
ce386278
 #if __USE_MINGW_ANSI_STDIO
81d882d5
 __attribute__ ((format(gnu_printf, 2, 3)))
ce386278
 #else
81d882d5
 __attribute__ ((format(__printf__, 2, 3)))
ce386278
 #endif
6fbf66fa
 #endif
81d882d5
 ;
6fbf66fa
 
81d882d5
 bool status_read(struct status_output *so, struct buffer *buf);
6fbf66fa
 
 static inline unsigned int
81d882d5
 status_rw_flags(const struct status_output *so)
6fbf66fa
 {
81d882d5
     if (so)
     {
         return so->flags;
     }
     else
     {
         return 0;
     }
6fbf66fa
 }
 
81d882d5
 #endif /* ifndef STATUS_H */