/*

[0] Fix | Delete

* Copyright (C) the libgit2 contributors. All rights reserved.

[1] Fix | Delete

*

[2] Fix | Delete

* This file is part of libgit2, distributed under the GNU GPL v2 with

[3] Fix | Delete

* a Linking Exception. For full terms see the included COPYING file.

[4] Fix | Delete

*/

[5] Fix | Delete

#ifndef INCLUDE_git_trace_h__

[6] Fix | Delete

#define INCLUDE_git_trace_h__

[7] Fix | Delete

[8] Fix | Delete

#include "common.h"

[9] Fix | Delete

#include "types.h"

[10] Fix | Delete

[11] Fix | Delete

/**

[12] Fix | Delete

* @file git2/trace.h

[13] Fix | Delete

* @brief Git tracing configuration routines

[14] Fix | Delete

* @defgroup git_trace Git tracing configuration routines

[15] Fix | Delete

* @ingroup Git

[16] Fix | Delete

* @{

[17] Fix | Delete

*/

[18] Fix | Delete

GIT_BEGIN_DECL

[19] Fix | Delete

[20] Fix | Delete

/**

[21] Fix | Delete

* Available tracing levels. When tracing is set to a particular level,

[22] Fix | Delete

* callers will be provided tracing at the given level and all lower levels.

[23] Fix | Delete

*/

[24] Fix | Delete

typedef enum {

[25] Fix | Delete

/** No tracing will be performed. */

[26] Fix | Delete

GIT_TRACE_NONE = 0,

[27] Fix | Delete

[28] Fix | Delete

/** Severe errors that may impact the program's execution */

[29] Fix | Delete

GIT_TRACE_FATAL = 1,

[30] Fix | Delete

[31] Fix | Delete

/** Errors that do not impact the program's execution */

[32] Fix | Delete

GIT_TRACE_ERROR = 2,

[33] Fix | Delete

[34] Fix | Delete

/** Warnings that suggest abnormal data */

[35] Fix | Delete

GIT_TRACE_WARN = 3,

[36] Fix | Delete

[37] Fix | Delete

/** Informational messages about program execution */

[38] Fix | Delete

GIT_TRACE_INFO = 4,

[39] Fix | Delete

[40] Fix | Delete

/** Detailed data that allows for debugging */

[41] Fix | Delete

GIT_TRACE_DEBUG = 5,

[42] Fix | Delete

[43] Fix | Delete

/** Exceptionally detailed debugging data */

[44] Fix | Delete

GIT_TRACE_TRACE = 6

[45] Fix | Delete

} git_trace_level_t;

[46] Fix | Delete

[47] Fix | Delete

/**

[48] Fix | Delete

* An instance for a tracing function

[49] Fix | Delete

*/

[50] Fix | Delete

typedef void GIT_CALLBACK(git_trace_cb)(git_trace_level_t level, const char *msg);

[51] Fix | Delete

[52] Fix | Delete

/**

[53] Fix | Delete

* Sets the system tracing configuration to the specified level with the

[54] Fix | Delete

* specified callback. When system events occur at a level equal to, or

[55] Fix | Delete

* lower than, the given level they will be reported to the given callback.

[56] Fix | Delete

*

[57] Fix | Delete

* @param level Level to set tracing to

[58] Fix | Delete

* @param cb Function to call with trace data

[59] Fix | Delete

* @return 0 or an error code

[60] Fix | Delete

*/

[61] Fix | Delete

GIT_EXTERN(int) git_trace_set(git_trace_level_t level, git_trace_cb cb);

[62] Fix | Delete

[63] Fix | Delete

/** @} */

[64] Fix | Delete

GIT_END_DECL

[65] Fix | Delete

#endif

[66] Fix | Delete

[67] Fix | Delete