File: comstack.diagnostics.html

package info (click to toggle)
yaz 5.37.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 16,568 kB
  • sloc: xml: 124,223; ansic: 73,221; sh: 5,738; tcl: 2,189; makefile: 1,274; yacc: 382
file content (27 lines) | stat: -rw-r--r-- 2,821 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<html><head><meta charset="ISO-8859-1"><title>8.Diagnostics</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><link rel="home" href="index.html" title="YAZ User's Guide and Reference"><link rel="up" href="comstack.html" title="Chapter9.The COMSTACK Module"><link rel="prev" href="comstack.ssl.html" title="7.SSL"><link rel="next" href="comstack.summary.html" title="9.Summary and Synopsis"></head><body><link rel="stylesheet" type="text/css" href="common/style1.css"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">8.Diagnostics</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="comstack.ssl.html">Prev</a></td><th width="60%" align="center">Chapter9.The COMSTACK Module</th><td width="20%" align="right"><a accesskey="n" href="comstack.summary.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="comstack.diagnostics"></a>8.Diagnostics</h2></div></div></div><p>
    All functions return -1 if an error occurs. Typically, the functions
    will return 0 on success, but the data exchange functions
    (<code class="function">cs_get</code>, <code class="function">cs_put</code>,
    <code class="function">cs_more</code>) follow special rules. Consult their
    descriptions.
   </p><p>
    The error code for the COMSTACK can be retrieved using C macro
    <code class="function">cs_errno</code> which will return one
    of the error codes <code class="literal">CSYSERR</code>,
    <code class="literal">CSOUTSTATE</code>,
    <code class="literal">CSNODATA</code>, ...
   </p><pre class="synopsis">
    int cs_errno(COMSTACK handle);
   </pre><p>
    You can the textual representation of the error code
    by using <code class="function">cs_errmsg</code>, which
    works like <code class="function">strerror(3)</code>.
   </p><pre class="synopsis">
    const char *cs_errmsg(int n);
   </pre><p>
    It is also possible to get straight to the textual representation
    without the error code, by using
    <code class="function">cs_strerror</code>.
   </p><pre class="synopsis">
    const char *cs_strerror(COMSTACK h);
   </pre></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="comstack.ssl.html">Prev</a></td><td width="20%" align="center"><a accesskey="u" href="comstack.html">Up</a></td><td width="40%" align="right"><a accesskey="n" href="comstack.summary.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">7.SSL</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">9.Summary and Synopsis</td></tr></table></div></body></html>