summaryrefslogtreecommitdiffstats
path: root/src/logging.h
blob: a8e3432f5351c1b54921b16b04fef84281dd93eb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
/*
 *  logging.c:  Logging facilities for nwipe.
 *
 *  Copyright Darik Horn <dajhorn-dban@vanadac.com>.
 *
 *  This program is free software; you can redistribute it and/or modify it under
 *  the terms of the GNU General Public License as published by the Free Software
 *  Foundation, version 2.
 *
 *  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.
 *
 *  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.
 *
 */

#ifndef LOGGING_H_
#define LOGGING_H_

/* Maximum size of a log message */
#define MAX_LOG_LINE_CHARS 1024

#define MAX_SIZE_OS_STRING 1024 /* Maximum size of acceptable OS string */

#define OS_info_Line_offset 31 /* OS_info line offset in log */
#define OS_info_Line_Length 48 /* OS_info line length */

typedef enum nwipe_log_t_ {
    NWIPE_LOG_NONE = 0,
    NWIPE_LOG_DEBUG,  // Output only when --verbose option used on cmd line.
    NWIPE_LOG_INFO,  // General Info not specifically relevant to the wipe.
    NWIPE_LOG_NOTICE,  // Most logging happens at this level related to wiping.
    NWIPE_LOG_WARNING,  // Things that the user should know about.
    NWIPE_LOG_ERROR,  // Non-fatal errors that result in failure.
    NWIPE_LOG_FATAL,  // Errors that cause the program to exit.
    NWIPE_LOG_SANITY,  // Programming errors.
    NWIPE_LOG_NOTIMESTAMP  // logs the message without the timestamp
} nwipe_log_t;

/**
 * Writes a string to the log. nwipe_log timestamps the string
 * @param level the tag to display:
 * NWIPE_LOG_NONE Don't display a tag
 * NWIPE_LOG_DEBUG, Very verbose logging.
 * NWIPE_LOG_INFO,  Verbose logging.
 * NWIPE_LOG_NOTICE,  Most logging happens at this level.
 * NWIPE_LOG_WARNING, Things that the user should know about.
 * NWIPE_LOG_ERROR, Non-fatal errors that result in failure.
 * NWIPE_LOG_FATAL, Errors that cause the program to exit.
 * NWIPE_LOG_SANITY, Programming errors.
 * NWIPE_LOG_NOTIMESTAMP logs the message without the timestamp
 * @param format the string to be logged
 */
void nwipe_log( nwipe_log_t level, const char* format, ... );

void nwipe_perror( int nwipe_errno, const char* f, const char* s );
void nwipe_log_OSinfo();
int nwipe_log_sysinfo();
void nwipe_log_summary( nwipe_context_t**, int );  // This produces the wipe status table on exit

#endif /* LOGGING_H_ */