blob: 81fb5bb04a03383f6eac089a7c463bbe43519c35 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2019. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="STYLESHEET" href="../book.css" type="text/css">
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script>
<title>Tracing</title>
</head>
<body>
<h1>Tracing</h1>
<img src="../images/tracing_preferences.png" alt="Tracing preference page" border="0">
<p>The <a class="command-link"
href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.trace.tracingPage)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link">
<strong>General &gt; Tracing</strong></a> preference page allows you to modify the tracing options of plug-ins dynamically.</p>
<p>Plug-ins may provide OSGi tracing options that write out additional logging information when the appropriate flag is set. You
can set tracing options using a <em>.options</em> file. However, any changes to the flags require a restart.</p>
<p>If a plug-in supports changing tracing options dynamically (without restarting) they will be listed on this preference page. The
changes will be made once <strong>OK</strong> is pressed.</p>
<p>The <strong>Tracing output</strong> settings allow more control over where tracing messages are put. A different output file
can be chosen. A new file will be created each time the plug-in is started. If the maximum number of trace files stored has been
reached, the oldest file will be deleted. Setting a maximum trace file size prevents excessively large log files from being created.</p>
<p>Not all plug-ins will write their trace messages to the output file. Some plug-ins instead write to console output or
perform other tasks.</p>
</body>
</html>