Files
pcas/documentation/RELEASE_NOTES.html
2015-06-03 00:15:39 -05:00

53 lines
1.7 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>EPICS Base R3.16.0 Release Notes</title>
</head>
<body lang="en">
<h1 align="center">EPICS Base Release 3.16.0</h1>
<p style="color:red">This version of EPICS Base has not been released yet.</p>
<h2 align="center">Changes between 3.15.x and 3.16.0</h2>
<!-- Insert new items immediately below this template ...
<h3>Title...</h3>
<p>Description</p>
-->
<h3>epicsTime API return status</h3>
<p>The epicsTime routines that used to return epicsTimeERROR now return a specific
S_time_ status value, allowing the caller to discover the reason for any failure.
The identifier <tt>epicsTimeERROR</tt> is no longer defined, so any references to
it in source code will no longer compile. The identifier epicsTimeOK still exists
and has the value 0 as before, so most code that uses these APIs can be changed in
a way that is backwards-compatible with the previous return status.</p>
<p>Time providers that have to return a status value and still need to be built
with earlier versions of Base can define the necessary status symbols like this:</p>
<blockquote><pre>
#include "epicsTime.h"
#ifndef M_time
/* S_time_... status values were not provided before Base 3.16 */
#define S_time_unsynchronized epicsTimeERROR
#define S_time_...whatever... epicsTimeERROR
#endif
</pre></blockquote>
<h3>Callback subsystem API</h3>
<p>Added a new macro <tt>callbackGetPriority(prio, callback)</tt> to the
callback.h header and removed the need for dbScan.c to reach into the internals
of its CALLBACK objects.</p>
</body>
</html>