Blame src/log.c

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