Blame src/log.c

Packit Service 31306d
/*
Packit Service 31306d
 * log.c - logging and debugging functions
Packit Service 31306d
 *
Packit Service 31306d
 * This file is part of the SSH Library
Packit Service 31306d
 *
Packit Service 31306d
 * Copyright (c) 2008-2013   by Aris Adamantiadis
Packit Service 31306d
 *
Packit Service 31306d
 * The SSH Library is free software; you can redistribute it and/or modify
Packit Service 31306d
 * it under the terms of the GNU Lesser General Public License as published by
Packit Service 31306d
 * the Free Software Foundation; either version 2.1 of the License, or (at your
Packit Service 31306d
 * option) any later version.
Packit Service 31306d
 *
Packit Service 31306d
 * The SSH Library is distributed in the hope that it will be useful, but
Packit Service 31306d
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
Packit Service 31306d
 * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
Packit Service 31306d
 * License for more details.
Packit Service 31306d
 *
Packit Service 31306d
 * You should have received a copy of the GNU Lesser General Public License
Packit Service 31306d
 * along with the SSH Library; see the file COPYING.  If not, write to
Packit Service 31306d
 * the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
Packit Service 31306d
 * MA 02111-1307, USA.
Packit Service 31306d
 */
Packit Service 31306d
Packit Service 31306d
#include "config.h"
Packit Service 31306d
Packit Service 31306d
#include <stdio.h>
Packit Service 31306d
#include <stdarg.h>
Packit Service 31306d
#include <string.h>
Packit Service 31306d
#ifdef HAVE_SYS_TIME_H
Packit Service 31306d
#include <sys/time.h>
Packit Service 31306d
#endif /* HAVE_SYS_TIME_H */
Packit Service 31306d
#ifdef HAVE_SYS_UTIME_H
Packit Service 31306d
#include <sys/utime.h>
Packit Service 31306d
#endif /* HAVE_SYS_UTIME_H */
Packit Service 31306d
#include <time.h>
Packit Service 31306d
Packit Service 31306d
#include "libssh/priv.h"
Packit Service 31306d
#include "libssh/misc.h"
Packit Service 31306d
#include "libssh/session.h"
Packit Service 31306d
Packit Service 31306d
static LIBSSH_THREAD int ssh_log_level;
Packit Service 31306d
static LIBSSH_THREAD ssh_logging_callback ssh_log_cb;
Packit Service 31306d
static LIBSSH_THREAD void *ssh_log_userdata;
Packit Service 31306d
Packit Service 31306d
/**
Packit Service 31306d
 * @defgroup libssh_log The SSH logging functions.
Packit Service 31306d
 * @ingroup libssh
Packit Service 31306d
 *
Packit Service 31306d
 * Logging functions for debugging and problem resolving.
Packit Service 31306d
 *
Packit Service 31306d
 * @{
Packit Service 31306d
 */
Packit Service 31306d
Packit Service 31306d
static int current_timestring(int hires, char *buf, size_t len)
Packit Service 31306d
{
Packit Service 31306d
    char tbuf[64];
Packit Service 31306d
    struct timeval tv;
Packit Service 31306d
    struct tm *tm;
Packit Service 31306d
    time_t t;
Packit Service 31306d
Packit Service 31306d
    gettimeofday(&tv, NULL);
Packit Service 31306d
    t = (time_t) tv.tv_sec;
Packit Service 31306d
Packit Service 31306d
    tm = localtime(&t);
Packit Service 31306d
    if (tm == NULL) {
Packit Service 31306d
        return -1;
Packit Service 31306d
    }
Packit Service 31306d
Packit Service 31306d
    if (hires) {
Packit Service 31306d
        strftime(tbuf, sizeof(tbuf) - 1, "%Y/%m/%d %H:%M:%S", tm);
Packit Service 31306d
        snprintf(buf, len, "%s.%06ld", tbuf, (long)tv.tv_usec);
Packit Service 31306d
    } else {
Packit Service 31306d
        strftime(tbuf, sizeof(tbuf) - 1, "%Y/%m/%d %H:%M:%S", tm);
Packit Service 31306d
        snprintf(buf, len, "%s", tbuf);
Packit Service 31306d
    }
Packit Service 31306d
Packit Service 31306d
    return 0;
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
static void ssh_log_stderr(int verbosity,
Packit Service 31306d
                           const char *function,
Packit Service 31306d
                           const char *buffer)
Packit Service 31306d
{
Packit Service 31306d
    char date[128] = {0};
Packit Service 31306d
    int rc;
Packit Service 31306d
Packit Service 31306d
    rc = current_timestring(1, date, sizeof(date));
Packit Service 31306d
    if (rc == 0) {
Packit Service 31306d
        fprintf(stderr, "[%s, %d] %s:", date, verbosity, function);
Packit Service 31306d
    } else {
Packit Service 31306d
        fprintf(stderr, "[%d] %s", verbosity, function);
Packit Service 31306d
    }
Packit Service 31306d
Packit Service 31306d
    fprintf(stderr, "  %s\n", buffer);
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
void ssh_log_function(int verbosity,
Packit Service 31306d
                      const char *function,
Packit Service 31306d
                      const char *buffer)
Packit Service 31306d
{
Packit Service 31306d
    ssh_logging_callback log_fn = ssh_get_log_callback();
Packit Service 31306d
    if (log_fn) {
Packit Service 31306d
        char buf[1024];
Packit Service 31306d
Packit Service 31306d
        snprintf(buf, sizeof(buf), "%s: %s", function, buffer);
Packit Service 31306d
Packit Service 31306d
        log_fn(verbosity,
Packit Service 31306d
               function,
Packit Service 31306d
               buf,
Packit Service 31306d
               ssh_get_log_userdata());
Packit Service 31306d
        return;
Packit Service 31306d
    }
Packit Service 31306d
Packit Service 31306d
    ssh_log_stderr(verbosity, function, buffer);
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
void _ssh_log(int verbosity,
Packit Service 31306d
              const char *function,
Packit Service 31306d
              const char *format, ...)
Packit Service 31306d
{
Packit Service 31306d
    char buffer[1024];
Packit Service 31306d
    va_list va;
Packit Service 31306d
Packit Service 31306d
    if (verbosity <= ssh_get_log_level()) {
Packit Service 31306d
        va_start(va, format);
Packit Service 31306d
        vsnprintf(buffer, sizeof(buffer), format, va);
Packit Service 31306d
        va_end(va);
Packit Service 31306d
        ssh_log_function(verbosity, function, buffer);
Packit Service 31306d
    }
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
/* LEGACY */
Packit Service 31306d
Packit Service 31306d
void ssh_log(ssh_session session,
Packit Service 31306d
             int verbosity,
Packit Service 31306d
             const char *format, ...)
Packit Service 31306d
{
Packit Service 31306d
  char buffer[1024];
Packit Service 31306d
  va_list va;
Packit Service 31306d
Packit Service 31306d
  if (verbosity <= session->common.log_verbosity) {
Packit Service 31306d
    va_start(va, format);
Packit Service 31306d
    vsnprintf(buffer, sizeof(buffer), format, va);
Packit Service 31306d
    va_end(va);
Packit Service 31306d
    ssh_log_function(verbosity, "", buffer);
Packit Service 31306d
  }
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
/** @internal
Packit Service 31306d
 * @brief log a SSH event with a common pointer
Packit Service 31306d
 * @param common       The SSH/bind session.
Packit Service 31306d
 * @param verbosity     The verbosity of the event.
Packit Service 31306d
 * @param format        The format string of the log entry.
Packit Service 31306d
 */
Packit Service 31306d
void ssh_log_common(struct ssh_common_struct *common,
Packit Service 31306d
                    int verbosity,
Packit Service 31306d
                    const char *function,
Packit Service 31306d
                    const char *format, ...)
Packit Service 31306d
{
Packit Service 31306d
    char buffer[1024];
Packit Service 31306d
    va_list va;
Packit Service 31306d
Packit Service 31306d
    if (verbosity <= common->log_verbosity) {
Packit Service 31306d
        va_start(va, format);
Packit Service 31306d
        vsnprintf(buffer, sizeof(buffer), format, va);
Packit Service 31306d
        va_end(va);
Packit Service 31306d
        ssh_log_function(verbosity, function, buffer);
Packit Service 31306d
    }
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
Packit Service 31306d
/* PUBLIC */
Packit Service 31306d
Packit Service 31306d
/**
Packit Service 31306d
 * @brief Set the log level of the library.
Packit Service 31306d
 *
Packit Service 31306d
 * @param[in]  level    The level to set.
Packit Service 31306d
 *
Packit Service 31306d
 * @return              SSH_OK on success, SSH_ERROR on error.
Packit Service 31306d
 */
Packit Service 31306d
int ssh_set_log_level(int level) {
Packit Service 31306d
  if (level < 0) {
Packit Service 31306d
    return SSH_ERROR;
Packit Service 31306d
  }
Packit Service 31306d
Packit Service 31306d
  ssh_log_level = level;
Packit Service 31306d
Packit Service 31306d
  return SSH_OK;
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
/**
Packit Service 31306d
 * @brief Get the log level of the library.
Packit Service 31306d
 *
Packit Service 31306d
 * @return    The value of the log level.
Packit Service 31306d
 */
Packit Service 31306d
int ssh_get_log_level(void) {
Packit Service 31306d
  return ssh_log_level;
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
int ssh_set_log_callback(ssh_logging_callback cb) {
Packit Service 31306d
  if (cb == NULL) {
Packit Service 31306d
    return SSH_ERROR;
Packit Service 31306d
  }
Packit Service 31306d
Packit Service 31306d
  ssh_log_cb = cb;
Packit Service 31306d
Packit Service 31306d
  return SSH_OK;
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
ssh_logging_callback ssh_get_log_callback(void) {
Packit Service 31306d
  return ssh_log_cb;
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
/**
Packit Service 31306d
 * @brief Get the userdata of the logging function.
Packit Service 31306d
 *
Packit Service 31306d
 * @return    The userdata if set or NULL.
Packit Service 31306d
 */
Packit Service 31306d
void *ssh_get_log_userdata(void)
Packit Service 31306d
{
Packit Service 31306d
    if (ssh_log_userdata == NULL) {
Packit Service 31306d
        return NULL;
Packit Service 31306d
    }
Packit Service 31306d
Packit Service 31306d
    return ssh_log_userdata;
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
/**
Packit Service 31306d
 * @brief Set the userdata for the logging function.
Packit Service 31306d
 *
Packit Service 31306d
 * @param[in]  data     The userdata to set.
Packit Service 31306d
 *
Packit Service 31306d
 * @return              SSH_OK on success.
Packit Service 31306d
 */
Packit Service 31306d
int ssh_set_log_userdata(void *data)
Packit Service 31306d
{
Packit Service 31306d
    ssh_log_userdata = data;
Packit Service 31306d
Packit Service 31306d
    return 0;
Packit Service 31306d
}
Packit Service 31306d
Packit Service 31306d
/** @} */