libnetconf is a NETCONF library in C intended for building NETCONF clients and servers. It provides basic functions to connect NETCONF client and server to each other via SSH or TLS, to send and receive NETCONF messages and to store and work with the configuration data in a datastore.

libnetconf implements the NETCONF protocol introduced by IETF. More information about the NETCONF protocol can be found at NETCONF WG.

libnetconf is currently under development at the TMC department of CESNET. Any testing of the library is welcome. Please inform us about your experiences with libnetconf via our mailing list or the Google Code's Issue section. Any feature suggestion or bugreport is also appreciated.

In November 2012, CESNET attended the NETCONF Interoperability Event held in Atlanta, prior to the IETF 85 meeting. We went to the event with the libnetconf-based client and server and successfully tested interoperability with other implementations. The notes from the event can be found here.

Features

• NETCONF v1.0 and v1.1 compliant (RFC 6241)
• NETCONF over SSH (RFC 6242) including Chunked Framing Mechanism
• NETCONF over TLS (RFC 5539bis)
• NETCONF Writable-running capability (RFC 6241)
• NETCONF Candidate configuration capability (RFC 6241)
• NETCONF Validate capability (RFC 6241)
• NETCONF Distinct startup capability (RFC 6241)
• NETCONF URL capability (RFC 6241)
• NETCONF Event Notifications (RFC 5277 and RFC 6470)
• NETCONF With-defaults capability (RFC 6243)
• NETCONF Access Control (RFC 6536)
• NETCONF Call Home (Reverse SSH draft, RFC 5539bis)

Example Applications

Examples of applications built on top of the libnetconf library can be found in the Netopeer project.

BSD License

Copyright (c) 2012-2014 CESNET, z.s.p.o.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the Company nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

ALTERNATIVELY, provided that this notice is retained in full, this product may be distributed under the terms of the GNU General Public License (GPL) version 2 or later, in which case the provisions of the GPL apply INSTEAD OF those given above.

This software is provided "as is", and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the company or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.