<html lang='en'>
<head>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
<title>
GitLab
</title>
</meta>
</head>
<style>
img {
max-width: 100%;
height: auto;
}
p.details {
font-style:italic;
color:#777
}
.footer p {
font-size:small;
color:#777
}
pre.commit-message {
white-space: pre-wrap;
}
.file-stats a {
text-decoration: none;
}
.file-stats .new-file {
color: #090;
}
.file-stats .deleted-file {
color: #B00;
}
</style>
<body>
<div class='content'>
<h3>Shane Snyder pushed to branch dev-modular at <a href="https://xgitlab.cels.anl.gov/darshan/darshan">darshan / darshan</a></h3>
<h4>
Commits:
</h4>
<ul>
<li>
<strong><a href="https://xgitlab.cels.anl.gov/darshan/darshan/commit/d7c2e81c1bd8f5c84bc564d9b61a1da95fa4a8e1">d7c2e81c</a></strong>
<div>
<span>by Shane Snyder</span>
<i>at 2016-01-21T16:15:41Z</i>
</div>
<pre class='commit-message'>small darshan-runtime documentation changes</pre>
</li>
</ul>
<h4>1 changed file:</h4>
<ul>
<li class='file-stats'>
<a href='#diff-0'>
darshan-runtime/doc/darshan-runtime.txt
</a>
</li>
</ul>
<h4>Changes:</h4>
<li id='diff-0'>
<a href='https://xgitlab.cels.anl.gov/darshan/darshan/commit/d7c2e81c1bd8f5c84bc564d9b61a1da95fa4a8e1#diff-0'>
<strong>
darshan-runtime/doc/darshan-runtime.txt
</strong>
</a>
<hr>
<pre class="highlight"><code><span style="color: #000000;background-color: #ffdddd">--- a/darshan-runtime/doc/darshan-runtime.txt
</span><span style="color: #000000;background-color: #ddffdd">+++ b/darshan-runtime/doc/darshan-runtime.txt
</span><span style="color: #aaaaaa">@@ -483,20 +483,17 @@ runtime environment variables] are equally applicable to both versions.
</span> However, we do provide some suggestions and expectations for system administrators to keep in
mind when upgrading to Darshan 3.x:
-* Log file compatibility was broken in the upgrade, and thus 3.x log utilities do not
-work directly with logs generated by 2.x versions of Darshan (and vice versa).
<span style="color: #000000;background-color: #ffdddd">- - There is currently no tool for converting 2.x logs into the 3.x log format.
- - The `darshan-logutils` library will provide error messages to indicate whether a given
</span><span style="color: #000000;background-color: #ddffdd">+* Darshan 2.x and Darshan 3.x produce incompatible log file formats
+ ** log files named *.darshan.gz or *.darshan.bz2: Darshan 2.x format
+ ** log files named *.darshan: Darshan 3.x format
+ *** a field in the log file header indicates underlying compression method in 3.x logs
+ ** There is currently no tool for converting 2.x logs into the 3.x log format.
+ ** The `darshan-logutils` library will provide error messages to indicate whether a given
</span> log file is incompatible with the correspnonding library version.
-* The darshan log file extension has been changed from `.darshan.gz` (or `.darshan.bz2` for
-log files converted to use bzip2 compression) to `.darshan`.
<span style="color: #000000;background-color: #ffdddd">- - A field in the Darshan log header is used to indicate whether a log is compressed using
</span>-libz or bzip2 compression.
-
* We encourage administrators to use the same log file directory for version 3.x as had been
used for version 2.x.
<span style="color: #000000;background-color: #ffdddd">- - Within this directory, the determination on which set of log utilities (version 2.x
</span><span style="color: #000000;background-color: #ddffdd">+ ** Within this directory, the determination on which set of log utilities (version 2.x
</span> or version 3.x) to use can be based on the file extension for a given log (as explained
above).
</code></pre>
<br>
</li>
</div>
<div class='footer' style='margin-top: 10px;'>
<p>
—
<br>
<a href="https://xgitlab.cels.anl.gov/darshan/darshan/commit/d7c2e81c1bd8f5c84bc564d9b61a1da95fa4a8e1">View it on GitLab</a>
<script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","action":{"@type":"ViewAction","name":"View Commit","url":"https://xgitlab.cels.anl.gov/darshan/darshan/commit/d7c2e81c1bd8f5c84bc564d9b61a1da95fa4a8e1"}}</script>
</p>
</div>
</body>
</html>