Home | History | Annotate | Line # | Download | only in docs
      1 
      2 
      3 
      4 <!DOCTYPE html>
      5 <html lang="en-us">
      6   <head>
      7     <meta charset="UTF-8">
      8     <title>libcbor - CBOR format implementation</title>
      9     <meta name="viewport" content="width=device-width, initial-scale=1">
     10     <link rel="stylesheet" type="text/css" href="stylesheets/normalize.css" media="screen">
     11     <link href='http://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
     12     <link rel="stylesheet" type="text/css" href="stylesheets/stylesheet.css" media="screen">
     13     <link rel="stylesheet" type="text/css" href="stylesheets/github-light.css" media="screen">
     14   </head>
     15   <body>
     16     <section class="page-header">
     17       <h1 class="project-name">libcbor</h1>
     18       <h2 class="project-tagline">CBOR format implementation for C &amp; others</h2>
     19       <h2 class="project-tagline">Latest release: v0.5.0</h2>
     20       <a href="https://github.com/PJK/libcbor" class="btn">View on GitHub</a>
     21       <a href="https://github.com/PJK/libcbor/archive/v0.5.0.tar.gz" class="btn">Download source</a>
     22       <a href="http://libcbor.readthedocs.io/en/v0.5.0/using.html" class="btn">Get started</a>
     23     </section>
     24 
     25     <section class="main-content">
     26 
     27 
     28 <p><strong>libcbor</strong> is a C library for parsing and generating <a href="http://tools.ietf.org/html/rfc7049">CBOR</a>, the general-purpose schema-less binary data format.</p>
     29 
     30 <h2>
     31 <a id="main-features" class="anchor" href="#main-features" aria-hidden="true"><span class="octicon octicon-link"></span></a>Main features</h2>
     32 
     33 <ul>
     34   <li>Complete RFC conformance</li>
     35   <li>Robust portable C99 implementation</li>
     36   <li>Layered architecture offers both control and convenience</li>
     37   <li>Flexible memory management</li>
     38   <li>Proper handling of UTF-8</li>
     39   <li>Full support for streams &amp; incremental processing</li>
     40   <li>Extensive documentation and test suite</li>
     41   <li>No runtime dependencies, small footprint</li>
     42   <li>Tested across architectures and operating systems</li>
     43 </ul>
     44 
     45 <h2>A taste of the API</h2>
     46 <script src="https://gist.github.com/PJK/962a468886d24195d1ee.js"></script>
     47 
     48 <h2><a id="distrib" class="anchor" href="#distrib" aria-hidden="true"><span class="octicon octicon-link"></span></a>Distribution</h2>
     49 
     50 <h3>OS X</h3>
     51 <pre><code>brew tap pjk/libcbor
     52 brew install libcbor
     53 </code></pre>
     54 
     55 <h3>Linux</h3>
     56 <p>
     57   Please refer to <a href="http://libcbor.readthedocs.io/en/latest/getting_started.html">the documentation</a> on how to build <i>libcbor</i>.
     58 </p>
     59 
     60 <p>
     61   deb and RPM packages can be built effortlessly using <a href="https://cmake.org/cmake/help/v3.0/module/CPack.html">CPack</a>. <i>libcbor</i> also comes with <a href="https://www.freedesktop.org/wiki/Software/pkg-config/">pkg-config</a> support</li>.
     62 </p>
     63 
     64 <h3>Windows</h3>
     65 <p>
     66   Windows are supported and <a href="https://ci.appveyor.com/project/PJK/libcbor">tested for</a>. CMake can target both MSVC and Cygwin toolchains. Please refer to <a href="http://libcbor.readthedocs.io/en/latest/getting_started.html">the documentation</a> on how to do so.
     67 </p>
     68 
     69 <h3>Other platforms</h3>
     70 <p>
     71   As long as CMake and a C99 compiler are available, <i>libcbor</i> will work. Read more <a href="http://libcbor.readthedocs.io/en/latest/getting_started.html">here</a>.
     72 </p>
     73 
     74 <h2>
     75 <a id="documentation" class="anchor" href="#documentation" aria-hidden="true"><span class="octicon octicon-link"></span></a>Resources &amp; documentation</h2>
     76 
     77 <ul>
     78   <li>User documentation is available online from <a href="http://libcbor.readthedocs.org/en/latest/">http://libcbor.readthedocs.org/en/latest/</a></li>
     79   <li>Detailed build instructions are a part of the documentation</li>
     80   <li>API reference is available either <a href="doxygen/index.html">online</a> or <a href="https://github.com/PJK/libcbor/releases/download/v0.5.0/libcbor_api_docs.tar.gz">as a part of the release</a></li>
     81   <li><a href="https://github.com/PJK/libcbor/issues">Bug tracker</a>
     82   <li><a href="https://github.com/PJK/libcbor/blob/master/CHANGELOG.md">Changelog</a>
     83   <li><a href="https://github.com/PJK/libcbor/releases">Older releases</a>
     84 </ul>
     85 
     86 <h2>Ruby bindings</h2>
     87 <p>If you write Ruby, you might be interested in the <a href="https://github.com/PJK/libcbor-ruby">Ruby bindings for <i>libcbor</i></a>.</p>
     88 
     89 
     90 <h2><a id="license" class="anchor" href="#license" aria-hidden="true"><span class="octicon octicon-link"></span></a>Licensing</h2>
     91 
     92 <p><i>libcbor</i> is distributed under the terms of the MIT license, as found in the source code.</p>
     93 
     94 <p>Copyright (c) Pavel Kalvoda, 2014 - 2017</p>
     95 
     96       <footer class="site-footer">
     97         <span class="site-footer-owner"><a href="https://github.com/PJK/libcbor">libcbor</a> is maintained by <a href="https://github.com/PJK">PJK</a>.</span>
     98         <span class="site-footer-credits">This page is based on the <a href="https://github.com/jasonlong/cayman-theme">Cayman theme</a> by <a href="https://twitter.com/jasonlong">Jason Long</a>.</span>
     99       </footer>
    100 
    101     </section>
    102 
    103 <script>
    104   (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
    105   (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
    106   m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
    107   })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
    108 
    109   ga('create', 'UA-8187884-5', 'auto');
    110   ga('send', 'pageview');
    111 
    112 </script>
    113   </body>
    114 </html>
    115