Contiki-NG
log.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2017, RISE SICS.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  * notice, this list of conditions and the following disclaimer in the
12  * documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the Institute nor the names of its contributors
14  * may be used to endorse or promote products derived from this software
15  * without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  * This file is part of the Contiki operating system.
30  *
31  */
32 
33 /**
34  * \file
35  * Header file for the logging system
36  * \author
37  * Simon Duquennoy <simon.duquennoy@ri.se>
38  */
39 
40 /** \addtogroup sys
41  * @{ */
42 
43 /**
44  * \defgroup log Per-module, per-level logging
45  * @{
46  *
47  * The log module performs per-module, per-level logging
48  *
49  */
50 
51 #include "sys/log.h"
52 #include "net/ipv6/ip64-addr.h"
53 #include "net/ipv6/uiplib.h"
54 #include "deployment/deployment.h"
55 
56 int curr_log_level_rpl = LOG_CONF_LEVEL_RPL;
57 int curr_log_level_tcpip = LOG_CONF_LEVEL_TCPIP;
58 int curr_log_level_ipv6 = LOG_CONF_LEVEL_IPV6;
59 int curr_log_level_6lowpan = LOG_CONF_LEVEL_6LOWPAN;
60 int curr_log_level_nullnet = LOG_CONF_LEVEL_NULLNET;
61 int curr_log_level_mac = LOG_CONF_LEVEL_MAC;
62 int curr_log_level_framer = LOG_CONF_LEVEL_FRAMER;
63 int curr_log_level_6top = LOG_CONF_LEVEL_6TOP;
64 int curr_log_level_coap = LOG_CONF_LEVEL_COAP;
65 int curr_log_level_lwm2m = LOG_CONF_LEVEL_LWM2M;
66 int curr_log_level_main = LOG_CONF_LEVEL_MAIN;
67 
68 struct log_module all_modules[] = {
69  {"rpl", &curr_log_level_rpl, LOG_CONF_LEVEL_RPL},
70  {"tcpip", &curr_log_level_tcpip, LOG_CONF_LEVEL_TCPIP},
71  {"ipv6", &curr_log_level_ipv6, LOG_CONF_LEVEL_IPV6},
72  {"6lowpan", &curr_log_level_6lowpan, LOG_CONF_LEVEL_6LOWPAN},
73  {"nullnet", &curr_log_level_nullnet, LOG_CONF_LEVEL_NULLNET},
74  {"mac", &curr_log_level_mac, LOG_CONF_LEVEL_MAC},
75  {"framer", &curr_log_level_framer, LOG_CONF_LEVEL_FRAMER},
76  {"6top", &curr_log_level_6top, LOG_CONF_LEVEL_6TOP},
77  {"coap", &curr_log_level_coap, LOG_CONF_LEVEL_COAP},
78  {"lwm2m", &curr_log_level_lwm2m, LOG_CONF_LEVEL_LWM2M},
79  {"main", &curr_log_level_main, LOG_CONF_LEVEL_MAIN},
80  {NULL, NULL, 0},
81 };
82 
83 #if NETSTACK_CONF_WITH_IPV6
84 
85 /*---------------------------------------------------------------------------*/
86 void
87 log_6addr(const uip_ipaddr_t *ipaddr)
88 {
89  char buf[UIPLIB_IPV6_MAX_STR_LEN];
90  uiplib_ipaddr_snprint(buf, sizeof(buf), ipaddr);
91  LOG_OUTPUT("%s", buf);
92 }
93 /*---------------------------------------------------------------------------*/
94 int
95 log_6addr_compact_snprint(char *buf, size_t size, const uip_ipaddr_t *ipaddr)
96 {
97  if(ipaddr == NULL) {
98  return snprintf(buf, size, "6A-NULL");
99  } else {
100  char *prefix = NULL;
101  if(uip_is_addr_mcast(ipaddr)) {
102  prefix = "6M";
103  } else if(uip_is_addr_linklocal(ipaddr)) {
104  prefix = "6L";
105  } else {
106  prefix = "6G";
107  }
108 #if BUILD_WITH_DEPLOYMENT
109  return snprintf(buf, size, "%s-%03u", prefix, deployment_id_from_iid(ipaddr));
110 #else /* BUILD_WITH_DEPLOYMENT */
111  return snprintf(buf, size, "%s-%04x", prefix, UIP_HTONS(ipaddr->u16[sizeof(uip_ipaddr_t)/2-1]));
112 #endif /* BUILD_WITH_DEPLOYMENT */
113  }
114 }
115 /*---------------------------------------------------------------------------*/
116 void
117 log_6addr_compact(const uip_ipaddr_t *ipaddr)
118 {
119  char buf[8];
120  log_6addr_compact_snprint(buf, sizeof(buf), ipaddr);
121  LOG_OUTPUT("%s", buf);
122 }
123 #endif /* NETSTACK_CONF_WITH_IPV6 */
124 /*---------------------------------------------------------------------------*/
125 void
126 log_lladdr(const linkaddr_t *lladdr)
127 {
128  if(lladdr == NULL) {
129  LOG_OUTPUT("(NULL LL addr)");
130  return;
131  } else {
132  unsigned int i;
133  for(i = 0; i < LINKADDR_SIZE; i++) {
134  if(i > 0 && i % 2 == 0) {
135  LOG_OUTPUT(".");
136  }
137  LOG_OUTPUT("%02x", lladdr->u8[i]);
138  }
139  }
140 }
141 /*---------------------------------------------------------------------------*/
142 void
143 log_lladdr_compact(const linkaddr_t *lladdr)
144 {
145  if(lladdr == NULL || linkaddr_cmp(lladdr, &linkaddr_null)) {
146  LOG_OUTPUT("LL-NULL");
147  } else {
148 #if BUILD_WITH_DEPLOYMENT
149  LOG_OUTPUT("LL-%04u", deployment_id_from_lladdr(lladdr));
150 #else /* BUILD_WITH_DEPLOYMENT */
151 #if LINKADDR_SIZE == 8
152  LOG_OUTPUT("LL-%04x", UIP_HTONS(lladdr->u16[LINKADDR_SIZE/2-1]));
153 #elif LINKADDR_SIZE == 2
154  LOG_OUTPUT("LL-%04x", UIP_HTONS(lladdr->u16));
155 #endif
156 #endif /* BUILD_WITH_DEPLOYMENT */
157  }
158 }
159 /*---------------------------------------------------------------------------*/
160 void
161 log_set_level(const char *module, int level)
162 {
163  if(level >= LOG_LEVEL_NONE && level <= LOG_LEVEL_DBG) {
164  int i = 0;
165  int module_all = !strcmp("all", module);
166  while(all_modules[i].name != NULL) {
167  if(module_all || !strcmp(module, all_modules[i].name)) {
168  *all_modules[i].curr_log_level = MIN(level, all_modules[i].max_log_level);
169  }
170  i++;
171  }
172  }
173 }
174 /*---------------------------------------------------------------------------*/
175 int
176 log_get_level(const char *module)
177 {
178  int i = 0;
179  if(module == NULL) {
180  return -1;
181  }
182  while(all_modules[i].name != NULL) {
183  if(!strcmp(module, all_modules[i].name)) {
184  return *all_modules[i].curr_log_level;
185  }
186  i++;
187  }
188  return -1;
189 }
190 /*---------------------------------------------------------------------------*/
191 const char *
193 {
194  switch(level) {
195  case LOG_LEVEL_NONE:
196  return "None";
197  case LOG_LEVEL_ERR:
198  return "Errors";
199  case LOG_LEVEL_WARN:
200  return "Warnings";
201  case LOG_LEVEL_INFO:
202  return "Info";
203  case LOG_LEVEL_DBG:
204  return "Debug";
205  default:
206  return "N/A";
207  }
208 }
209 /** @} */
210 /** @} */
static uip_ipaddr_t ipaddr
Pointer to prefix information option in uip_buf.
Definition: uip-nd6.c:116
const linkaddr_t linkaddr_null
The null link-layer address.
void log_lladdr_compact(const linkaddr_t *lladdr)
Logs a link-layer address with a compact format.
Definition: log.c:143
void log_set_level(const char *module, int level)
Sets a log level at run-time.
Definition: log.c:161
void log_lladdr(const linkaddr_t *lladdr)
Logs a link-layer address.
Definition: log.c:126
Header file for the IP address manipulation library.
Per-deployment MAC <-> nodeid mapping.
#define uip_is_addr_mcast(a)
is address a multicast address, see RFC 4291 a is of type uip_ipaddr_t*
Definition: uip.h:1961
void log_6addr(const uip_ipaddr_t *ipaddr)
Logs an IPv6 address.
Definition: log.c:87
int linkaddr_cmp(const linkaddr_t *addr1, const linkaddr_t *addr2)
Compare two link-layer addresses.
Definition: linkaddr.c:69
#define UIP_HTONS(n)
Convert 16-bit quantity from host byte order to network byte order.
Definition: uip.h:1223
const char * log_level_to_str(int level)
Returns a textual description of a log level.
Definition: log.c:192
int log_get_level(const char *module)
Returns the current log level.
Definition: log.c:176
int log_6addr_compact_snprint(char *buf, size_t size, const uip_ipaddr_t *ipaddr)
Write at most size - 1 characters of the IP address to the output string, in a compact representation...
Definition: log.c:95
uint16_t deployment_id_from_lladdr(const linkaddr_t *lladdr)
Get node ID from a link-layer address, from the deployment mapping table.
Definition: deployment.c:82
#define uip_is_addr_linklocal(a)
is addr (a) a link local unicast address, see RFC 4291 i.e.
Definition: uip.h:1877
Header file for the logging system
uint16_t deployment_id_from_iid(const uip_ipaddr_t *ipaddr)
Get node ID from the IID of an IPv6 address.
Definition: deployment.c:115
void log_6addr_compact(const uip_ipaddr_t *ipaddr)
Logs an IPv6 address with a compact format.
Definition: log.c:117
int uiplib_ipaddr_snprint(char *buf, size_t size, const uip_ipaddr_t *addr)
Write at most size - 1 characters of the IP address to the output string.
Definition: uiplib.c:166