]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blob - ubuntu/vbox/vboxguest/VBox/log-vbox.c
UBUNTU: ubuntu: vbox -- update to 5.1.6-dfsg-1
[mirror_ubuntu-zesty-kernel.git] / ubuntu / vbox / vboxguest / VBox / log-vbox.c
1 /* $Id: log-vbox.cpp $ */
2 /** @file
3 * VirtualBox Runtime - Logging configuration.
4 */
5
6 /*
7 * Copyright (C) 2006-2016 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 *
17 * The contents of this file may alternatively be used under the terms
18 * of the Common Development and Distribution License Version 1.0
19 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
20 * VirtualBox OSE distribution, in which case the provisions of the
21 * CDDL are applicable instead of those of the GPL.
22 *
23 * You may elect to license modified versions of this file under the
24 * terms and conditions of either the GPL or the CDDL or both.
25 */
26
27 /** @page pg_rtlog Runtime - Logging
28 *
29 * VBox uses the IPRT logging system which supports group level flags and multiple
30 * destinations. The GC logging is making it even more interesting since GC logging will
31 * have to be buffered and written when back in host context.
32 *
33 * [more later]
34 *
35 *
36 * @section sec_logging_destination The Destination Specifier.
37 *
38 * The {logger-env-base}_DEST environment variable can be used to specify where
39 * the log output goes. The following specifiers are recognized:
40 *
41 * - file=\<filename\>
42 * This sets the logger output filename to \<filename\>. Not formatting
43 * or anything is supported. Each logger specifies a default name if
44 * file logging should be enabled by default.
45 *
46 * - nofile
47 * This disables the file output.
48 *
49 * - stdout
50 * Enables logger output to stdout.
51 *
52 * - nostdout
53 * Disables logger output to stdout.
54 *
55 * - stderr
56 * Enables logger output to stderr.
57 *
58 * - nostderr
59 * Disables logger output to stderr.
60 *
61 * - debugger
62 * Enables logger output to native debugger. (Win32/64 only)
63 *
64 * - nodebugger
65 * Disables logger output to native debugger. (Win32/64 only)
66 *
67 * - user
68 * Enables logger output to special backdoor if in guest r0.
69 *
70 * - nodebugger
71 * Disables logger output to special user stream.
72 *
73 *
74 *
75 * @section sec_logging_group The Group Specifier.
76 *
77 * The {logger-env-base} environment variable can be used to specify which
78 * logger groups to enable and which to disable. By default all groups are
79 * disabled. For your convenience this specifier is case in-sensitive (ASCII).
80 *
81 * The specifier is evaluated from left to right.
82 *
83 * [more later]
84 *
85 * The groups settings can be reprogrammed during execution using the
86 * RTLogGroupSettings() command and a group specifier.
87 *
88 *
89 *
90 * @section sec_logging_default The Default Logger
91 *
92 * The default logger uses VBOX_LOG_DEST as destination specifier. File output is
93 * enabled by default and goes to a file "./VBox-\<pid\>.log".
94 *
95 * The default logger have all groups turned off by default to force the developer
96 * to be careful with what log information to collect - logging everything is
97 * generally NOT a good idea.
98 *
99 * The log groups of the default logger can be found in the LOGGROUP in enum. The
100 * VBOX_LOG environment variable and the .log debugger command can be used to
101 * configure the groups.
102 *
103 * Each group have flags in addition to the enable/disable flag. These flags can
104 * be appended to the group name using dot separators. The flags correspond to
105 * RTLOGGRPFLAGS and have a short and a long version:
106 *
107 * - e - Enabled: Whether the group is enabled at all.
108 * - l - Level2: Level-2 logging.
109 * - f - Flow: Execution flow logging (entry messages)
110 * - s - Sander: Special Sander logging messages.
111 * - b - Bird: Special Bird logging messages.
112 *
113 * @todo Update this section...
114 *
115 * Example:
116 *
117 * VBOX_LOG=+all+pgm.e.s.b.z.l-qemu
118 *
119 * Space and ';' separators are allowed:
120 *
121 * VBOX_LOG=+all +pgm.e.s.b.z.l ; - qemu
122 *
123 */
124
125
126 /*********************************************************************************************************************************
127 * Header Files *
128 *********************************************************************************************************************************/
129 #ifdef IN_RING3
130 # if defined(RT_OS_WINDOWS)
131 # include <iprt/win/windows.h>
132 # elif defined(RT_OS_LINUX)
133 # include <unistd.h>
134 # elif defined(RT_OS_FREEBSD) || defined(RT_OS_NETBSD)
135 # include <sys/param.h>
136 # include <sys/sysctl.h>
137 # if defined(RT_OS_FREEBSD)
138 # include <sys/user.h>
139 # endif
140 # include <stdlib.h>
141 # include <unistd.h>
142 # elif defined(RT_OS_HAIKU)
143 # include <OS.h>
144 # elif defined(RT_OS_SOLARIS)
145 # define _STRUCTURED_PROC 1
146 # undef _FILE_OFFSET_BITS /* procfs doesn't like this */
147 # include <sys/procfs.h>
148 # include <unistd.h>
149 # elif defined(RT_OS_OS2)
150 # include <stdlib.h>
151 # endif
152 #endif
153
154 #include <VBox/log.h>
155 #include <iprt/asm.h>
156 #include <iprt/err.h>
157 #include <iprt/time.h>
158 #ifdef IN_RING3
159 # include <iprt/param.h>
160 # include <iprt/assert.h>
161 # include <iprt/path.h>
162 # include <iprt/process.h>
163 # include <iprt/string.h>
164 # include <iprt/mem.h>
165 # include <stdio.h>
166 #endif
167 #if defined(IN_RING0) && defined(RT_OS_DARWIN)
168 # include <iprt/asm-amd64-x86.h>
169 # include <iprt/thread.h>
170 #endif
171
172
173 /*********************************************************************************************************************************
174 * Global Variables *
175 *********************************************************************************************************************************/
176 /** The default logger. */
177 static PRTLOGGER g_pLogger = NULL;
178 /** The default logger groups.
179 * This must match LOGGROUP! */
180 static const char *g_apszGroups[] =
181 VBOX_LOGGROUP_NAMES;
182
183
184 /**
185 * Creates the default logger instance for a VBox process.
186 *
187 * @returns Pointer to the logger instance.
188 */
189 RTDECL(PRTLOGGER) RTLogDefaultInit(void)
190 {
191 /*
192 * Initialize the default logger instance.
193 * Take care to do this once and not recursively.
194 */
195 static volatile uint32_t fInitializing = 0;
196 PRTLOGGER pLogger;
197 int rc;
198
199 if (g_pLogger || !ASMAtomicCmpXchgU32(&fInitializing, 1, 0))
200 return g_pLogger;
201
202 #ifdef IN_RING3
203 /*
204 * Assert the group definitions.
205 */
206 #define ASSERT_LOG_GROUP(grp) ASSERT_LOG_GROUP2(LOG_GROUP_##grp, #grp)
207 #define ASSERT_LOG_GROUP2(def, str) \
208 do { if (strcmp(g_apszGroups[def], str)) {printf("%s='%s' expects '%s'\n", #def, g_apszGroups[def], str); RTAssertDoPanic(); } } while (0)
209 ASSERT_LOG_GROUP(DEFAULT);
210 ASSERT_LOG_GROUP(AUDIO_MIXER);
211 ASSERT_LOG_GROUP(AUDIO_MIXER_BUFFER);
212 ASSERT_LOG_GROUP(AUTOLOGON);
213 ASSERT_LOG_GROUP(CFGM);
214 ASSERT_LOG_GROUP(CPUM);
215 ASSERT_LOG_GROUP(CSAM);
216 ASSERT_LOG_GROUP(DBGC);
217 ASSERT_LOG_GROUP(DBGF);
218 ASSERT_LOG_GROUP(DBGF_INFO);
219 ASSERT_LOG_GROUP(DBGG);
220 ASSERT_LOG_GROUP(DEV);
221 ASSERT_LOG_GROUP(DEV_AC97);
222 ASSERT_LOG_GROUP(DEV_ACPI);
223 ASSERT_LOG_GROUP(DEV_APIC);
224 ASSERT_LOG_GROUP(DEV_BUSLOGIC);
225 ASSERT_LOG_GROUP(DEV_DMA);
226 ASSERT_LOG_GROUP(DEV_E1000);
227 ASSERT_LOG_GROUP(DEV_EFI);
228 ASSERT_LOG_GROUP(DEV_EHCI);
229 ASSERT_LOG_GROUP(DEV_FDC);
230 ASSERT_LOG_GROUP(DEV_GIM);
231 ASSERT_LOG_GROUP(DEV_HDA);
232 ASSERT_LOG_GROUP(DEV_HDA_CODEC);
233 ASSERT_LOG_GROUP(DEV_HPET);
234 ASSERT_LOG_GROUP(DEV_IDE);
235 ASSERT_LOG_GROUP(DEV_INIP);
236 ASSERT_LOG_GROUP(DEV_KBD);
237 ASSERT_LOG_GROUP(DEV_LPC);
238 ASSERT_LOG_GROUP(DEV_LSILOGICSCSI);
239 ASSERT_LOG_GROUP(DEV_NVME);
240 ASSERT_LOG_GROUP(DEV_OHCI);
241 ASSERT_LOG_GROUP(DEV_PARALLEL);
242 ASSERT_LOG_GROUP(DEV_PC);
243 ASSERT_LOG_GROUP(DEV_PC_ARCH);
244 ASSERT_LOG_GROUP(DEV_PC_BIOS);
245 ASSERT_LOG_GROUP(DEV_PCI);
246 ASSERT_LOG_GROUP(DEV_PCI_RAW);
247 ASSERT_LOG_GROUP(DEV_PCNET);
248 ASSERT_LOG_GROUP(DEV_PIC);
249 ASSERT_LOG_GROUP(DEV_PIT);
250 ASSERT_LOG_GROUP(DEV_RTC);
251 ASSERT_LOG_GROUP(DEV_SB16);
252 ASSERT_LOG_GROUP(DEV_SERIAL);
253 ASSERT_LOG_GROUP(DEV_SMC);
254 ASSERT_LOG_GROUP(DEV_VGA);
255 ASSERT_LOG_GROUP(DEV_VIRTIO);
256 ASSERT_LOG_GROUP(DEV_VIRTIO_NET);
257 ASSERT_LOG_GROUP(DEV_VMM);
258 ASSERT_LOG_GROUP(DEV_VMM_BACKDOOR);
259 ASSERT_LOG_GROUP(DEV_VMM_STDERR);
260 ASSERT_LOG_GROUP(DEV_VMSVGA);
261 ASSERT_LOG_GROUP(DEV_XHCI);
262 ASSERT_LOG_GROUP(DIS);
263 ASSERT_LOG_GROUP(DRV);
264 ASSERT_LOG_GROUP(DRV_ACPI);
265 ASSERT_LOG_GROUP(DRV_AUDIO);
266 ASSERT_LOG_GROUP(DRV_BLOCK);
267 ASSERT_LOG_GROUP(DRV_CHAR);
268 ASSERT_LOG_GROUP(DRV_DISK_INTEGRITY);
269 ASSERT_LOG_GROUP(DRV_DISPLAY);
270 ASSERT_LOG_GROUP(DRV_FLOPPY);
271 ASSERT_LOG_GROUP(DRV_HOST_AUDIO);
272 ASSERT_LOG_GROUP(DRV_HOST_BASE);
273 ASSERT_LOG_GROUP(DRV_HOST_DVD);
274 ASSERT_LOG_GROUP(DRV_HOST_FLOPPY);
275 ASSERT_LOG_GROUP(DRV_HOST_PARALLEL);
276 ASSERT_LOG_GROUP(DRV_HOST_SERIAL);
277 ASSERT_LOG_GROUP(DRV_INTNET);
278 ASSERT_LOG_GROUP(DRV_ISO);
279 ASSERT_LOG_GROUP(DRV_KBD_QUEUE);
280 ASSERT_LOG_GROUP(DRV_LWIP);
281 ASSERT_LOG_GROUP(DRV_MINIPORT);
282 ASSERT_LOG_GROUP(DRV_MOUSE_QUEUE);
283 ASSERT_LOG_GROUP(DRV_NAMEDPIPE);
284 ASSERT_LOG_GROUP(DRV_NAT);
285 ASSERT_LOG_GROUP(DRV_RAW_IMAGE);
286 ASSERT_LOG_GROUP(DRV_SCSI);
287 ASSERT_LOG_GROUP(DRV_SCSIHOST);
288 ASSERT_LOG_GROUP(DRV_TCP);
289 ASSERT_LOG_GROUP(DRV_TRANSPORT_ASYNC);
290 ASSERT_LOG_GROUP(DRV_TUN);
291 ASSERT_LOG_GROUP(DRV_UDPTUNNEL);
292 ASSERT_LOG_GROUP(DRV_USBPROXY);
293 ASSERT_LOG_GROUP(DRV_VBOXHDD);
294 ASSERT_LOG_GROUP(DRV_VD);
295 ASSERT_LOG_GROUP(DRV_VRDE_AUDIO);
296 ASSERT_LOG_GROUP(DRV_VSWITCH);
297 ASSERT_LOG_GROUP(DRV_VUSB);
298 ASSERT_LOG_GROUP(EM);
299 ASSERT_LOG_GROUP(FTM);
300 ASSERT_LOG_GROUP(GIM);
301 ASSERT_LOG_GROUP(GMM);
302 ASSERT_LOG_GROUP(GUEST_CONTROL);
303 ASSERT_LOG_GROUP(GUEST_DND);
304 ASSERT_LOG_GROUP(GUI);
305 ASSERT_LOG_GROUP(GVMM);
306 ASSERT_LOG_GROUP(HGCM);
307 ASSERT_LOG_GROUP(HGSMI);
308 ASSERT_LOG_GROUP(HM);
309 ASSERT_LOG_GROUP(IEM);
310 ASSERT_LOG_GROUP(IOM);
311 ASSERT_LOG_GROUP(IPC);
312 ASSERT_LOG_GROUP(LWIP);
313 ASSERT_LOG_GROUP(LWIP_API_LIB);
314 ASSERT_LOG_GROUP(LWIP_API_MSG);
315 ASSERT_LOG_GROUP(LWIP_ETHARP);
316 ASSERT_LOG_GROUP(LWIP_ICMP);
317 ASSERT_LOG_GROUP(LWIP_IGMP);
318 ASSERT_LOG_GROUP(LWIP_INET);
319 ASSERT_LOG_GROUP(LWIP_IP4);
320 ASSERT_LOG_GROUP(LWIP_IP4_REASS);
321 ASSERT_LOG_GROUP(LWIP_IP6);
322 ASSERT_LOG_GROUP(LWIP_MEM);
323 ASSERT_LOG_GROUP(LWIP_MEMP);
324 ASSERT_LOG_GROUP(LWIP_NETIF);
325 ASSERT_LOG_GROUP(LWIP_PBUF);
326 ASSERT_LOG_GROUP(LWIP_RAW);
327 ASSERT_LOG_GROUP(LWIP_SOCKETS);
328 ASSERT_LOG_GROUP(LWIP_SYS);
329 ASSERT_LOG_GROUP(LWIP_TCP);
330 ASSERT_LOG_GROUP(LWIP_TCPIP);
331 ASSERT_LOG_GROUP(LWIP_TCP_CWND);
332 ASSERT_LOG_GROUP(LWIP_TCP_FR);
333 ASSERT_LOG_GROUP(LWIP_TCP_INPUT);
334 ASSERT_LOG_GROUP(LWIP_TCP_OUTPUT);
335 ASSERT_LOG_GROUP(LWIP_TCP_QLEN);
336 ASSERT_LOG_GROUP(LWIP_TCP_RST);
337 ASSERT_LOG_GROUP(LWIP_TCP_RTO);
338 ASSERT_LOG_GROUP(LWIP_TCP_WND);
339 ASSERT_LOG_GROUP(LWIP_TIMERS);
340 ASSERT_LOG_GROUP(LWIP_UDP);
341 ASSERT_LOG_GROUP(MAIN);
342 ASSERT_LOG_GROUP(MAIN_ADDITIONSFACILITY);
343 ASSERT_LOG_GROUP(MAIN_ADDITIONSSTATECHANGEDEVENT);
344 ASSERT_LOG_GROUP(MAIN_APPLIANCE);
345 ASSERT_LOG_GROUP(MAIN_AUDIOADAPTER);
346 ASSERT_LOG_GROUP(MAIN_BANDWIDTHCONTROL);
347 ASSERT_LOG_GROUP(MAIN_BANDWIDTHGROUP);
348 ASSERT_LOG_GROUP(MAIN_BANDWIDTHGROUPCHANGEDEVENT);
349 ASSERT_LOG_GROUP(MAIN_BIOSSETTINGS);
350 ASSERT_LOG_GROUP(MAIN_CANSHOWWINDOWEVENT);
351 ASSERT_LOG_GROUP(MAIN_CLIPBOARDMODECHANGEDEVENT);
352 ASSERT_LOG_GROUP(MAIN_CONSOLE);
353 ASSERT_LOG_GROUP(MAIN_CPUCHANGEDEVENT);
354 ASSERT_LOG_GROUP(MAIN_CPUEXECUTIONCAPCHANGEDEVENT);
355 ASSERT_LOG_GROUP(MAIN_DHCPSERVER);
356 ASSERT_LOG_GROUP(MAIN_DIRECTORY);
357 ASSERT_LOG_GROUP(MAIN_DISPLAY);
358 ASSERT_LOG_GROUP(MAIN_DISPLAYSOURCEBITMAP);
359 ASSERT_LOG_GROUP(MAIN_DNDBASE);
360 ASSERT_LOG_GROUP(MAIN_DNDMODECHANGEDEVENT);
361 ASSERT_LOG_GROUP(MAIN_DNDSOURCE);
362 ASSERT_LOG_GROUP(MAIN_DNDTARGET);
363 ASSERT_LOG_GROUP(MAIN_EMULATEDUSB);
364 ASSERT_LOG_GROUP(MAIN_EVENT);
365 ASSERT_LOG_GROUP(MAIN_EVENTLISTENER);
366 ASSERT_LOG_GROUP(MAIN_EVENTSOURCE);
367 ASSERT_LOG_GROUP(MAIN_EVENTSOURCECHANGEDEVENT);
368 ASSERT_LOG_GROUP(MAIN_EXTPACK);
369 ASSERT_LOG_GROUP(MAIN_EXTPACKBASE);
370 ASSERT_LOG_GROUP(MAIN_EXTPACKFILE);
371 ASSERT_LOG_GROUP(MAIN_EXTPACKMANAGER);
372 ASSERT_LOG_GROUP(MAIN_EXTPACKPLUGIN);
373 ASSERT_LOG_GROUP(MAIN_EXTRADATACANCHANGEEVENT);
374 ASSERT_LOG_GROUP(MAIN_EXTRADATACHANGEDEVENT);
375 ASSERT_LOG_GROUP(MAIN_FILE);
376 ASSERT_LOG_GROUP(MAIN_FRAMEBUFFER);
377 ASSERT_LOG_GROUP(MAIN_FRAMEBUFFEROVERLAY);
378 ASSERT_LOG_GROUP(MAIN_FSOBJINFO);
379 ASSERT_LOG_GROUP(MAIN_GUEST);
380 ASSERT_LOG_GROUP(MAIN_GUESTDIRECTORY);
381 ASSERT_LOG_GROUP(MAIN_GUESTDNDSOURCE);
382 ASSERT_LOG_GROUP(MAIN_GUESTDNDTARGET);
383 ASSERT_LOG_GROUP(MAIN_GUESTERRORINFO);
384 ASSERT_LOG_GROUP(MAIN_GUESTFILE);
385 ASSERT_LOG_GROUP(MAIN_GUESTFILEEVENT);
386 ASSERT_LOG_GROUP(MAIN_GUESTFILEIOEVENT);
387 ASSERT_LOG_GROUP(MAIN_GUESTFILEOFFSETCHANGEDEVENT);
388 ASSERT_LOG_GROUP(MAIN_GUESTFILEREADEVENT);
389 ASSERT_LOG_GROUP(MAIN_GUESTFILEREGISTEREDEVENT);
390 ASSERT_LOG_GROUP(MAIN_GUESTFILESTATECHANGEDEVENT);
391 ASSERT_LOG_GROUP(MAIN_GUESTFILEWRITEEVENT);
392 ASSERT_LOG_GROUP(MAIN_GUESTFSOBJINFO);
393 ASSERT_LOG_GROUP(MAIN_GUESTKEYBOARDEVENT);
394 ASSERT_LOG_GROUP(MAIN_GUESTMONITORCHANGEDEVENT);
395 ASSERT_LOG_GROUP(MAIN_GUESTMOUSEEVENT);
396 ASSERT_LOG_GROUP(MAIN_GUESTMULTITOUCHEVENT);
397 ASSERT_LOG_GROUP(MAIN_GUESTOSTYPE);
398 ASSERT_LOG_GROUP(MAIN_GUESTPROCESS);
399 ASSERT_LOG_GROUP(MAIN_GUESTPROCESSEVENT);
400 ASSERT_LOG_GROUP(MAIN_GUESTPROCESSINPUTNOTIFYEVENT);
401 ASSERT_LOG_GROUP(MAIN_GUESTPROCESSIOEVENT);
402 ASSERT_LOG_GROUP(MAIN_GUESTPROCESSOUTPUTEVENT);
403 ASSERT_LOG_GROUP(MAIN_GUESTPROCESSREGISTEREDEVENT);
404 ASSERT_LOG_GROUP(MAIN_GUESTPROCESSSTATECHANGEDEVENT);
405 ASSERT_LOG_GROUP(MAIN_GUESTPROPERTYCHANGEDEVENT);
406 ASSERT_LOG_GROUP(MAIN_GUESTSESSION);
407 ASSERT_LOG_GROUP(MAIN_GUESTSESSIONEVENT);
408 ASSERT_LOG_GROUP(MAIN_GUESTSESSIONREGISTEREDEVENT);
409 ASSERT_LOG_GROUP(MAIN_GUESTSESSIONSTATECHANGEDEVENT);
410 ASSERT_LOG_GROUP(MAIN_GUESTUSERSTATECHANGEDEVENT);
411 ASSERT_LOG_GROUP(MAIN_HOST);
412 ASSERT_LOG_GROUP(MAIN_HOSTNAMERESOLUTIONCONFIGURATIONCHANGEEVENT);
413 ASSERT_LOG_GROUP(MAIN_HOSTNETWORKINTERFACE);
414 ASSERT_LOG_GROUP(MAIN_HOSTPCIDEVICEPLUGEVENT);
415 ASSERT_LOG_GROUP(MAIN_HOSTUSBDEVICE);
416 ASSERT_LOG_GROUP(MAIN_HOSTUSBDEVICEFILTER);
417 ASSERT_LOG_GROUP(MAIN_HOSTVIDEOINPUTDEVICE);
418 ASSERT_LOG_GROUP(MAIN_INTERNALMACHINECONTROL);
419 ASSERT_LOG_GROUP(MAIN_INTERNALSESSIONCONTROL);
420 ASSERT_LOG_GROUP(MAIN_KEYBOARD);
421 ASSERT_LOG_GROUP(MAIN_KEYBOARDLEDSCHANGEDEVENT);
422 ASSERT_LOG_GROUP(MAIN_MACHINE);
423 ASSERT_LOG_GROUP(MAIN_MACHINEDATACHANGEDEVENT);
424 ASSERT_LOG_GROUP(MAIN_MACHINEDEBUGGER);
425 ASSERT_LOG_GROUP(MAIN_MACHINEEVENT);
426 ASSERT_LOG_GROUP(MAIN_MACHINEREGISTEREDEVENT);
427 ASSERT_LOG_GROUP(MAIN_MACHINESTATECHANGEDEVENT);
428 ASSERT_LOG_GROUP(MAIN_MEDIUM);
429 ASSERT_LOG_GROUP(MAIN_MEDIUMATTACHMENT);
430 ASSERT_LOG_GROUP(MAIN_MEDIUMCHANGEDEVENT);
431 ASSERT_LOG_GROUP(MAIN_MEDIUMCONFIGCHANGEDEVENT);
432 ASSERT_LOG_GROUP(MAIN_MEDIUMFORMAT);
433 ASSERT_LOG_GROUP(MAIN_MEDIUMREGISTEREDEVENT);
434 ASSERT_LOG_GROUP(MAIN_MOUSE);
435 ASSERT_LOG_GROUP(MAIN_MOUSECAPABILITYCHANGEDEVENT);
436 ASSERT_LOG_GROUP(MAIN_MOUSEPOINTERSHAPE);
437 ASSERT_LOG_GROUP(MAIN_MOUSEPOINTERSHAPECHANGEDEVENT);
438 ASSERT_LOG_GROUP(MAIN_NATENGINE);
439 ASSERT_LOG_GROUP(MAIN_NATNETWORK);
440 ASSERT_LOG_GROUP(MAIN_NATNETWORKALTEREVENT);
441 ASSERT_LOG_GROUP(MAIN_NATNETWORKCHANGEDEVENT);
442 ASSERT_LOG_GROUP(MAIN_NATNETWORKCREATIONDELETIONEVENT);
443 ASSERT_LOG_GROUP(MAIN_NATNETWORKPORTFORWARDEVENT);
444 ASSERT_LOG_GROUP(MAIN_NATNETWORKSETTINGEVENT);
445 ASSERT_LOG_GROUP(MAIN_NATNETWORKSTARTSTOPEVENT);
446 ASSERT_LOG_GROUP(MAIN_NATREDIRECTEVENT);
447 ASSERT_LOG_GROUP(MAIN_NETWORKADAPTER);
448 ASSERT_LOG_GROUP(MAIN_NETWORKADAPTERCHANGEDEVENT);
449 ASSERT_LOG_GROUP(MAIN_PARALLELPORT);
450 ASSERT_LOG_GROUP(MAIN_PARALLELPORTCHANGEDEVENT);
451 ASSERT_LOG_GROUP(MAIN_PCIADDRESS);
452 ASSERT_LOG_GROUP(MAIN_PCIDEVICEATTACHMENT);
453 ASSERT_LOG_GROUP(MAIN_PERFORMANCECOLLECTOR);
454 ASSERT_LOG_GROUP(MAIN_PERFORMANCEMETRIC);
455 ASSERT_LOG_GROUP(MAIN_PROCESS);
456 ASSERT_LOG_GROUP(MAIN_PROGRESS);
457 ASSERT_LOG_GROUP(MAIN_REUSABLEEVENT);
458 ASSERT_LOG_GROUP(MAIN_RUNTIMEERROREVENT);
459 ASSERT_LOG_GROUP(MAIN_SERIALPORT);
460 ASSERT_LOG_GROUP(MAIN_SERIALPORTCHANGEDEVENT);
461 ASSERT_LOG_GROUP(MAIN_SESSION);
462 ASSERT_LOG_GROUP(MAIN_SESSIONSTATECHANGEDEVENT);
463 ASSERT_LOG_GROUP(MAIN_SHAREDFOLDER);
464 ASSERT_LOG_GROUP(MAIN_SHAREDFOLDERCHANGEDEVENT);
465 ASSERT_LOG_GROUP(MAIN_SHOWWINDOWEVENT);
466 ASSERT_LOG_GROUP(MAIN_SNAPSHOT);
467 ASSERT_LOG_GROUP(MAIN_SNAPSHOTCHANGEDEVENT);
468 ASSERT_LOG_GROUP(MAIN_SNAPSHOTDELETEDEVENT);
469 ASSERT_LOG_GROUP(MAIN_SNAPSHOTEVENT);
470 ASSERT_LOG_GROUP(MAIN_SNAPSHOTRESTOREDEVENT);
471 ASSERT_LOG_GROUP(MAIN_SNAPSHOTTAKENEVENT);
472 ASSERT_LOG_GROUP(MAIN_STATECHANGEDEVENT);
473 ASSERT_LOG_GROUP(MAIN_STORAGECONTROLLER);
474 ASSERT_LOG_GROUP(MAIN_STORAGECONTROLLERCHANGEDEVENT);
475 ASSERT_LOG_GROUP(MAIN_STORAGEDEVICECHANGEDEVENT);
476 ASSERT_LOG_GROUP(MAIN_SYSTEMPROPERTIES);
477 ASSERT_LOG_GROUP(MAIN_TOKEN);
478 ASSERT_LOG_GROUP(MAIN_USBCONTROLLER);
479 ASSERT_LOG_GROUP(MAIN_USBCONTROLLERCHANGEDEVENT);
480 ASSERT_LOG_GROUP(MAIN_USBDEVICE);
481 ASSERT_LOG_GROUP(MAIN_USBDEVICEFILTERS);
482 ASSERT_LOG_GROUP(MAIN_USBDEVICESTATECHANGEDEVENT);
483 ASSERT_LOG_GROUP(MAIN_VBOXSVCAVAILABILITYCHANGEDEVENT);
484 ASSERT_LOG_GROUP(MAIN_VIRTUALBOX);
485 ASSERT_LOG_GROUP(MAIN_VIRTUALBOXCLIENT);
486 ASSERT_LOG_GROUP(MAIN_VIRTUALSYSTEMDESCRIPTION);
487 ASSERT_LOG_GROUP(MAIN_VRDESERVER);
488 ASSERT_LOG_GROUP(MAIN_VRDESERVERCHANGEDEVENT);
489 ASSERT_LOG_GROUP(MAIN_VRDESERVERINFO);
490 ASSERT_LOG_GROUP(MAIN_VRDESERVERINFOCHANGEDEVENT);
491 ASSERT_LOG_GROUP(MISC);
492 ASSERT_LOG_GROUP(MM);
493 ASSERT_LOG_GROUP(MM_HEAP);
494 ASSERT_LOG_GROUP(MM_HYPER);
495 ASSERT_LOG_GROUP(MM_HYPER_HEAP);
496 ASSERT_LOG_GROUP(MM_PHYS);
497 ASSERT_LOG_GROUP(MM_POOL);
498 ASSERT_LOG_GROUP(NAT_SERVICE);
499 ASSERT_LOG_GROUP(NET_ADP_DRV);
500 ASSERT_LOG_GROUP(NET_FLT_DRV);
501 ASSERT_LOG_GROUP(NET_SERVICE);
502 ASSERT_LOG_GROUP(NET_SHAPER);
503 ASSERT_LOG_GROUP(PATM);
504 ASSERT_LOG_GROUP(PDM);
505 ASSERT_LOG_GROUP(PDM_ASYNC_COMPLETION);
506 ASSERT_LOG_GROUP(PDM_BLK_CACHE);
507 ASSERT_LOG_GROUP(PDM_DEVICE);
508 ASSERT_LOG_GROUP(PDM_DRIVER);
509 ASSERT_LOG_GROUP(PDM_LDR);
510 ASSERT_LOG_GROUP(PDM_QUEUE);
511 ASSERT_LOG_GROUP(PGM);
512 ASSERT_LOG_GROUP(PGM_DYNMAP);
513 ASSERT_LOG_GROUP(PGM_PHYS);
514 ASSERT_LOG_GROUP(PGM_PHYS_ACCESS);
515 ASSERT_LOG_GROUP(PGM_POOL);
516 ASSERT_LOG_GROUP(PGM_SHARED);
517 ASSERT_LOG_GROUP(REM);
518 ASSERT_LOG_GROUP(REM_DISAS);
519 ASSERT_LOG_GROUP(REM_HANDLER);
520 ASSERT_LOG_GROUP(REM_IOPORT);
521 ASSERT_LOG_GROUP(REM_MMIO);
522 ASSERT_LOG_GROUP(REM_PRINTF);
523 ASSERT_LOG_GROUP(REM_RUN);
524 ASSERT_LOG_GROUP(SELM);
525 ASSERT_LOG_GROUP(SHARED_CLIPBOARD);
526 ASSERT_LOG_GROUP(SHARED_CROPENGL);
527 ASSERT_LOG_GROUP(SHARED_FOLDERS);
528 ASSERT_LOG_GROUP(SHARED_OPENGL);
529 ASSERT_LOG_GROUP(SRV_INTNET);
530 ASSERT_LOG_GROUP(SSM);
531 ASSERT_LOG_GROUP(STAM);
532 ASSERT_LOG_GROUP(SUP);
533 ASSERT_LOG_GROUP(TM);
534 ASSERT_LOG_GROUP(TRPM);
535 ASSERT_LOG_GROUP(USB_CARDREADER);
536 ASSERT_LOG_GROUP(USB_DRV);
537 ASSERT_LOG_GROUP(USB_FILTER);
538 ASSERT_LOG_GROUP(USB_KBD);
539 ASSERT_LOG_GROUP(USB_MOUSE);
540 ASSERT_LOG_GROUP(USB_MSD);
541 ASSERT_LOG_GROUP(USB_REMOTE);
542 ASSERT_LOG_GROUP(USB_WEBCAM);
543 ASSERT_LOG_GROUP(VGDRV);
544 ASSERT_LOG_GROUP(VBGL);
545 ASSERT_LOG_GROUP(VD);
546 ASSERT_LOG_GROUP(VD_DMG);
547 ASSERT_LOG_GROUP(VD_ISCSI);
548 ASSERT_LOG_GROUP(VD_PARALLELS);
549 ASSERT_LOG_GROUP(VD_QCOW);
550 ASSERT_LOG_GROUP(VD_QED);
551 ASSERT_LOG_GROUP(VD_RAW);
552 ASSERT_LOG_GROUP(VD_VDI);
553 ASSERT_LOG_GROUP(VD_VHD);
554 ASSERT_LOG_GROUP(VD_VHDX);
555 ASSERT_LOG_GROUP(VD_VMDK);
556 ASSERT_LOG_GROUP(VM);
557 ASSERT_LOG_GROUP(VMM);
558 ASSERT_LOG_GROUP(VRDE);
559 ASSERT_LOG_GROUP(VRDP);
560 ASSERT_LOG_GROUP(VSCSI);
561 ASSERT_LOG_GROUP(WEBSERVICE);
562 #undef ASSERT_LOG_GROUP
563 #undef ASSERT_LOG_GROUP2
564 #endif /* IN_RING3 */
565
566 /*
567 * Create the default logging instance.
568 */
569 #ifdef IN_RING3
570 # ifndef IN_GUEST
571 char szExecName[RTPATH_MAX];
572 if (!RTProcGetExecutablePath(szExecName, sizeof(szExecName)))
573 strcpy(szExecName, "VBox");
574 RTTIMESPEC TimeSpec;
575 RTTIME Time;
576 RTTimeExplode(&Time, RTTimeNow(&TimeSpec));
577 rc = RTLogCreate(&pLogger, 0, NULL, "VBOX_LOG", RT_ELEMENTS(g_apszGroups), &g_apszGroups[0], RTLOGDEST_FILE,
578 "./%04d-%02d-%02d-%02d-%02d-%02d.%03d-%s-%d.log",
579 Time.i32Year, Time.u8Month, Time.u8MonthDay, Time.u8Hour, Time.u8Minute, Time.u8Second, Time.u32Nanosecond / 10000000,
580 RTPathFilename(szExecName), RTProcSelf());
581 if (RT_SUCCESS(rc))
582 {
583 /*
584 * Write a log header.
585 */
586 char szBuf[RTPATH_MAX];
587 RTTimeSpecToString(&TimeSpec, szBuf, sizeof(szBuf));
588 RTLogLoggerEx(pLogger, 0, ~0U, "Log created: %s\n", szBuf);
589 RTLogLoggerEx(pLogger, 0, ~0U, "Executable: %s\n", szExecName);
590
591 /* executable and arguments - tricky and all platform specific. */
592 # if defined(RT_OS_WINDOWS)
593 RTLogLoggerEx(pLogger, 0, ~0U, "Commandline: %ls\n", GetCommandLineW());
594
595 # elif defined(RT_OS_SOLARIS)
596 psinfo_t psi;
597 char szArgFileBuf[80];
598 RTStrPrintf(szArgFileBuf, sizeof(szArgFileBuf), "/proc/%ld/psinfo", (long)getpid());
599 FILE* pFile = fopen(szArgFileBuf, "rb");
600 if (pFile)
601 {
602 if (fread(&psi, sizeof(psi), 1, pFile) == 1)
603 {
604 # if 0 /* 100% safe:*/
605 RTLogLoggerEx(pLogger, 0, ~0U, "Args: %s\n", psi.pr_psargs);
606 # else /* probably safe: */
607 const char * const *argv = (const char * const *)psi.pr_argv;
608 for (int iArg = 0; iArg < psi.pr_argc; iArg++)
609 RTLogLoggerEx(pLogger, 0, ~0U, "Arg[%d]: %s\n", iArg, argv[iArg]);
610 # endif
611
612 }
613 fclose(pFile);
614 }
615
616 # elif defined(RT_OS_LINUX)
617 FILE *pFile = fopen("/proc/self/cmdline", "r");
618 if (pFile)
619 {
620 /* braindead */
621 unsigned iArg = 0;
622 int ch;
623 bool fNew = true;
624 while (!feof(pFile) && (ch = fgetc(pFile)) != EOF)
625 {
626 if (fNew)
627 {
628 RTLogLoggerEx(pLogger, 0, ~0U, "Arg[%u]: ", iArg++);
629 fNew = false;
630 }
631 if (ch)
632 RTLogLoggerEx(pLogger, 0, ~0U, "%c", ch);
633 else
634 {
635 RTLogLoggerEx(pLogger, 0, ~0U, "\n");
636 fNew = true;
637 }
638 }
639 if (!fNew)
640 RTLogLoggerEx(pLogger, 0, ~0U, "\n");
641 fclose(pFile);
642 }
643
644 # elif defined(RT_OS_HAIKU)
645 team_info info;
646 if (get_team_info(0, &info) == B_OK)
647 {
648 /* there is an info.argc, but no way to know arg boundaries */
649 RTLogLoggerEx(pLogger, 0, ~0U, "Commandline: %.64s\n", info.args);
650 }
651
652 # elif defined(RT_OS_FREEBSD) || defined(RT_OS_NETBSD)
653 /* Retrieve the required length first */
654 int aiName[4];
655 # if defined(RT_OS_FREEBSD)
656 aiName[0] = CTL_KERN;
657 aiName[1] = KERN_PROC;
658 aiName[2] = KERN_PROC_ARGS; /* Introduced in FreeBSD 4.0 */
659 aiName[3] = getpid();
660 # elif defined(RT_OS_NETBSD)
661 aiName[0] = CTL_KERN;
662 aiName[1] = KERN_PROC_ARGS;
663 aiName[2] = getpid();
664 aiName[3] = KERN_PROC_ARGV;
665 # endif
666 size_t cchArgs = 0;
667 int rcBSD = sysctl(aiName, RT_ELEMENTS(aiName), NULL, &cchArgs, NULL, 0);
668 if (cchArgs > 0)
669 {
670 char *pszArgFileBuf = (char *)RTMemAllocZ(cchArgs + 1 /* Safety */);
671 if (pszArgFileBuf)
672 {
673 /* Retrieve the argument list */
674 rcBSD = sysctl(aiName, RT_ELEMENTS(aiName), pszArgFileBuf, &cchArgs, NULL, 0);
675 if (!rcBSD)
676 {
677 unsigned iArg = 0;
678 size_t off = 0;
679 while (off < cchArgs)
680 {
681 size_t cchArg = strlen(&pszArgFileBuf[off]);
682 RTLogLoggerEx(pLogger, 0, ~0U, "Arg[%u]: %s\n", iArg, &pszArgFileBuf[off]);
683
684 /* advance */
685 off += cchArg + 1;
686 iArg++;
687 }
688 }
689 RTMemFree(pszArgFileBuf);
690 }
691 }
692
693 # elif defined(RT_OS_OS2) || defined(RT_OS_DARWIN)
694 /* commandline? */
695 # else
696 # error needs porting.
697 # endif
698 }
699
700 # else /* IN_GUEST */
701 /* The user destination is backdoor logging. */
702 rc = RTLogCreate(&pLogger, 0, NULL, "VBOX_LOG", RT_ELEMENTS(g_apszGroups), &g_apszGroups[0], RTLOGDEST_USER, "VBox.log");
703 # endif /* IN_GUEST */
704
705 #else /* IN_RING0 */
706
707 /* Some platforms has trouble allocating memory with interrupts and/or
708 preemption disabled. Check and fail before we panic. */
709 # if defined(RT_OS_DARWIN)
710 if ( !ASMIntAreEnabled()
711 || !RTThreadPreemptIsEnabled(NIL_RTTHREAD))
712 return NULL;
713 # endif
714
715 # ifndef IN_GUEST
716 rc = RTLogCreate(&pLogger, 0, NULL, "VBOX_LOG", RT_ELEMENTS(g_apszGroups), &g_apszGroups[0], RTLOGDEST_FILE, "VBox-ring0.log");
717 # else /* IN_GUEST */
718 rc = RTLogCreate(&pLogger, 0, NULL, "VBOX_LOG", RT_ELEMENTS(g_apszGroups), &g_apszGroups[0], RTLOGDEST_USER, "VBox-ring0.log");
719 # endif /* IN_GUEST */
720 if (RT_SUCCESS(rc))
721 {
722 /*
723 * This is where you set your ring-0 logging preferences.
724 *
725 * On platforms which don't differ between debugger and kernel
726 * log printing, STDOUT is gonna be a stub and the DEBUGGER
727 * destination is the one doing all the work. On platforms
728 * that do differ (like Darwin), STDOUT is the kernel log.
729 */
730 # if defined(DEBUG_bird)
731 /*RTLogGroupSettings(pLogger, "all=~0 -default.l6.l5.l4.l3");*/
732 RTLogFlags(pLogger, "enabled unbuffered pid tid");
733 # ifndef IN_GUEST
734 pLogger->fDestFlags |= RTLOGDEST_DEBUGGER | RTLOGDEST_STDOUT;
735 # endif
736 # endif
737 # if defined(DEBUG_sandervl) && !defined(IN_GUEST)
738 RTLogGroupSettings(pLogger, "+all");
739 RTLogFlags(pLogger, "enabled unbuffered");
740 pLogger->fDestFlags |= RTLOGDEST_DEBUGGER;
741 # endif
742 # if defined(DEBUG_ramshankar) /* Guest ring-0 as well */
743 RTLogGroupSettings(pLogger, "+all.e.l.f");
744 RTLogFlags(pLogger, "enabled unbuffered");
745 pLogger->fDestFlags |= RTLOGDEST_DEBUGGER;
746 # endif
747 # if defined(DEBUG_aleksey) /* Guest ring-0 as well */
748 //RTLogGroupSettings(pLogger, "net_flt_drv.e.l.f.l3.l4.l5 +net_adp_drv.e.l.f.l3.l4.l5");
749 RTLogGroupSettings(pLogger, "net_flt_drv.e.l.f.l3.l4.l5.l6");
750 RTLogFlags(pLogger, "enabled unbuffered");
751 pLogger->fDestFlags |= RTLOGDEST_DEBUGGER | RTLOGDEST_STDOUT;
752 # endif
753 # if defined(DEBUG_andy) /* Guest ring-0 as well */
754 RTLogGroupSettings(pLogger, "+all.e.l.f");
755 RTLogFlags(pLogger, "enabled unbuffered pid tid");
756 pLogger->fDestFlags |= RTLOGDEST_DEBUGGER | RTLOGDEST_STDOUT;
757 # endif
758 # if defined(DEBUG_misha) /* Guest ring-0 as well */
759 RTLogFlags(pLogger, "enabled unbuffered");
760 pLogger->fDestFlags |= RTLOGDEST_DEBUGGER;
761 # endif
762 # if defined(DEBUG_michael) && defined(IN_GUEST)
763 RTLogGroupSettings(pLogger, "+vga.e.l.f");
764 RTLogFlags(pLogger, "enabled unbuffered");
765 pLogger->fDestFlags |= RTLOGDEST_DEBUGGER | RTLOGDEST_STDOUT;
766 # endif
767 # if 0 /* vboxdrv logging - ATTENTION: this is what we're referring to guys! Change to '# if 1'. */
768 RTLogGroupSettings(pLogger, "all=~0 -default.l6.l5.l4.l3");
769 RTLogFlags(pLogger, "enabled unbuffered tid");
770 pLogger->fDestFlags |= RTLOGDEST_DEBUGGER | RTLOGDEST_STDOUT;
771 # endif
772 }
773 #endif /* IN_RING0 */
774 return g_pLogger = RT_SUCCESS(rc) ? pLogger : NULL;
775 }