README.rst 1.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. Docsis utility
  2. ==============
  3. This program encodes a DOCSIS binary configuration file from a human-readable text configuration file.
  4. It was originaly developed at http://docsis.sourceforge.net and later on moved to https://github.com/rlaager/docsis
  5. This build is an experimental one and is based on a fork from the GitHub project. Please use this build on your own risk.
  6. Linux/Unix
  7. ----------
  8. 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.
  9. Dependencies:
  10. .. code:: bash
  11. apt-get install automake libtool libsnmp-dev bison make gcc flex git
  12. Installation steps for Debian based systems:
  13. .. code:: bash
  14. git clone https://github.com/AdrianSimionov/docsis.git
  15. cd docsis
  16. ./autogen.sh
  17. ./configure
  18. make
  19. make install (optional)
  20. Windows and Mac OS X
  21. --------------------
  22. Not tested. If someone has the resources to do it, please post your findings.
  23. Bug reporting
  24. -------------
  25. Please use the GitHub system to report feature request and bugs.
  26. Known issues
  27. ------------
  28. CMTS and CM MIC are 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.
  29. Quoting the hex strings will result in a crash. Do not use something similar to "0xABCD".
  30. Following TLVs can only be decoded but not encoded: SNMPv1v2cTransportAddress, SNMPv1v2cTransportAddressMask.