README.rst 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. Docsis utility
  2. ==============
  3. .. image:: https://travis-ci.org/AdrianSimionov/docsis.svg?branch=master
  4. :target: https://travis-ci.org/AdrianSimionov/docsis
  5. This program encodes a DOCSIS binary configuration file from a human-readable text configuration file.
  6. It was originaly developed at http://docsis.sourceforge.net and later on moved to https://github.com/rlaager/docsis
  7. This build is an experimental one and is based on a fork from the GitHub project. Please use this build on your own risk.
  8. Linux/Unix
  9. ----------
  10. This was tested on Ubuntu 14.04 amd64 (little endian) and Debian 7.5 Sparc64 (big endian) and it is known to work without issues.
  11. Dependencies:
  12. .. code:: bash
  13. apt-get install automake libtool libsnmp-dev bison make gcc flex git
  14. Installation steps for Debian based systems:
  15. .. code:: bash
  16. git clone https://github.com/AdrianSimionov/docsis.git
  17. cd docsis
  18. ./autogen.sh
  19. ./configure
  20. make
  21. make install (optional)
  22. Windows and Mac OS X
  23. --------------------
  24. Not tested. If someone has the resources to do it, please post your findings.
  25. Bug reporting
  26. -------------
  27. Please use the GitHub system to report feature request and bugs.
  28. Known issues
  29. ------------
  30. CMTS and CM MIC have the wrong value when calculated on a big endian CPU. Using the MIC values and a big endian CPU should be avoided in production systems.
  31. Quoting the hex strings will result in a crash. Do not use something similar to "0xABCD".
  32. Following TLVs can only be decoded but not encoded: SNMPv1v2cTransportAddress, SNMPv1v2cTransportAddressMask.