c-api-inlines.h File

C header file with the empty inline stubs for the C trace API when tracing is disabled. More...

Description

C header file with the empty inline stubs for the C trace API when tracing is disabled.

Function declarations are located in c-api.h. The stubs are separated into this file to improve project structure and maintainability.

File Listing

The file content with the documentation metadata removed is:

1/*

2 * This file is part of the µOS++ project (https://micro-os-plus.github.io/).

3 * Copyright (c) 2015-2026 Liviu Ionescu. All rights reserved.

4 *

5 * Permission to use, copy, modify, and/or distribute this software for any

6 * purpose is hereby granted, under the terms of the MIT license.

7 *

8 * If a copy of the license was not distributed with this file, it can be

9 * obtained from https://opensource.org/licenses/mit.

10 */

11

12// ----------------------------------------------------------------------------

13

24

25// ----------------------------------------------------------------------------

26

27#if !defined(MICRO_OS_PLUS_DIAG_TRACE_H_)

28#error "Do not include this file directly; use "micro-os-plus/diag/trace.h"."

29#endif // MICRO_OS_PLUS_DIAG_TRACE_H_

30

31// ----------------------------------------------------------------------------

32

33#ifndef MICRO_OS_PLUS_DIAG_TRACE_INLINES_C_API_INLINES_H_

34#define MICRO_OS_PLUS_DIAG_TRACE_INLINES_C_API_INLINES_H_

35

36// ----------------------------------------------------------------------------

37

38// When TRACE is not enabled, define all as empty.

39#if !defined(MICRO_OS_PLUS_DIAG_TRACE_ENABLED)

40

41// ----------------------------------------------------------------------------

42

43#include <stdarg.h>

44#include <sys/types.h>

45

46// ----------------------------------------------------------------------------

47// Empty definitions.

48

49#if defined(__GNUC__)

50#pragma GCC diagnostic push

51

52#pragma GCC diagnostic ignored "-Wunused-parameter"

53#endif // defined(__GNUC__)

54

55static inline __attribute__ ((always_inline)) void

56micro_os_plus_trace_initialise (void)

57{

58}

59

60#if defined(__GNUC__)

61#pragma GCC diagnostic push

62

63#if defined(__cplusplus)

64#pragma GCC diagnostic ignored "-Wold-style-cast"

65#endif // defined(__cplusplus)

66#endif // defined(__GNUC__)

67

68static inline __attribute__ ((always_inline)) ssize_t

69micro_os_plus_trace_write (const void* buf, size_t nbyte)

70{

71 return (ssize_t)(nbyte);

72}

73

74static inline __attribute__ ((always_inline)) void

75micro_os_plus_trace_flush (void)

76{

77}

78

79#if defined(__GNUC__)

80#pragma GCC diagnostic pop

81#endif // defined(__GNUC__)

82

83// ----------------------------------------------------------------------------

84

85static inline __attribute__ ((always_inline, format (printf, 1, 2))) int

86micro_os_plus_trace_printf (const char* format, ...)

87{

88 return 0;

89}

90

91static inline __attribute__ ((always_inline, format (printf, 1, 0))) int

92micro_os_plus_trace_vprintf (const char* format, va_list arguments)

93{

94 return 0;

95}

96

97static inline __attribute__ ((always_inline)) int

98micro_os_plus_trace_puts (const char* s)

99{

100 return 0;

101}

102

103static inline __attribute__ ((always_inline)) int

104micro_os_plus_trace_putchar (int c)

105{

106 return c;

107}

108

109static inline __attribute__ ((always_inline)) void

110micro_os_plus_trace_dump_args (int argc, char* argv[])

111{

112}

113

114#if defined(__GNUC__)

115#pragma GCC diagnostic pop

116#endif // defined(__GNUC__)

117

118// ----------------------------------------------------------------------------

119

120#endif // !defined(MICRO_OS_PLUS_DIAG_TRACE_ENABLED)

121

122// ----------------------------------------------------------------------------

123

124#endif // MICRO_OS_PLUS_DIAG_TRACE_INLINES_C_API_INLINES_H_

125

126// ----------------------------------------------------------------------------

---

Generated via doxygen2docusaurus 2.2.2 by Doxygen 1.17.0.