<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<?asciidoc-toc?>
<?asciidoc-numbered?>
<refentry>
<refmeta>
<refentrytitle>modbus_close</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class="source">libmodbus</refmiscinfo>
<refmiscinfo class="version">v3.1.2</refmiscinfo>
<refmiscinfo class="manual">libmodbus Manual</refmiscinfo>
</refmeta>
<refnamediv>
  <refname>modbus_close</refname>
  <refpurpose>close a Modbus connection</refpurpose>
</refnamediv>
<refsynopsisdiv id="_synopsis">
<simpara><emphasis role="strong">void modbus_close(modbus_t *<emphasis>ctx</emphasis>);</emphasis></simpara>
</refsynopsisdiv>
<refsect1 id="_description">
<title>DESCRIPTION</title>
<simpara>The <emphasis role="strong">modbus_close()</emphasis> function shall close the connection established with the
backend set in the context.</simpara>
</refsect1>
<refsect1 id="_return_value">
<title>RETURN VALUE</title>
<simpara>There is no return value.</simpara>
</refsect1>
<refsect1 id="_example">
<title>EXAMPLE</title>
<programlisting language="c" linenumbering="unnumbered">modbus_t *ctx;

ctx = modbus_new_tcp("127.0.0.1", 502);
if (modbus_connect(ctx) == -1) {
    fprintf(stderr, "Connection failed: %s\n", modbus_strerror(errno));
    modbus_free(ctx);
    return -1;
}

modbus_close(ctx);
modbus_free(ctx);</programlisting>
</refsect1>
<refsect1 id="_see_also">
<title>SEE ALSO</title>
<simpara><citerefentry>
<refentrytitle>modbus_connect</refentrytitle><manvolnum>3</manvolnum>
</citerefentry></simpara>
</refsect1>
<refsect1 id="_authors">
<title>AUTHORS</title>
<simpara>The libmodbus documentation was written by Stéphane Raimbault
&lt;<ulink url="mailto:stephane.raimbault@gmail.com">stephane.raimbault@gmail.com</ulink>&gt;</simpara>
</refsect1>
</refentry>
