XRT-3852: sync with upstream

.clabot

@@ -0,0 +1,66 @@
+{
+    "contributors": [
+        "0x34d",
+        "20162026",
+        "2128506",
+        "alongl",
+        "arkapkaj",
+        "bobbybelieve",
+        "ccdmuro",
+        "cedricboudinet",
+        "DavidKorczynski",
+        "devotip",
+        "diplfranzhoepfinger",
+        "embeddedmz",
+        "fcntlcc",
+        "fedepell",
+        "franzhoepfinger",
+        "franzhollerer",
+        "ghorwin",
+        "jbysewski",
+        "jcarrano",
+        "jeroendoggen",
+        "jetforme",
+        "jiriki86",
+        "jordanjohnson56",
+        "kay30kim",
+        "kyllingstad",
+        "mek-x",
+        "merkag",
+        "mhei",
+        "msk-repo-0x4d",
+        "ndunks",
+        "peternewman",
+        "philj56",
+        "raymondbh",
+        "ringlej",
+        "rm5248",
+        "rongli-eaton",
+        "sebastianpsm",
+        "SergeyMy",
+        "sirsoweird",
+        "taikiakita",
+        "vancepym",
+        "vvck",
+        "woodsnake",
+        "EchterAgo",
+        "Su-Yuming",
+        "anrodlo",
+        "chowchin",
+        "desteemy",
+        "jimklimov",
+        "jonathanfleming135",
+        "mbeards",
+        "richardash1981",
+        "titania7777",
+        "micrictor",
+        "jyjsunny",
+        "ProtocolSpecChecker",
+        "raenray",
+        "hbrodin",
+        "PGZXB",
+        "philj56",
+        "diplfranzhoepfinger"
+    ],
+    "message": "We require contributors to sign our Contributor License Agreement. In order for us to review and merge your code, please fill https://forms.gle/5635zjphDo5JEJQSA to get added. Your document will be manually checked by the maintainer. Be patient..."
+}

.clang-format

@@ -0,0 +1,56 @@
+---
+BasedOnStyle: LLVM
+AlignArrayOfStructures: Left
+AlignOperands: true
+AlignConsecutiveAssignments: false
+AlignConsecutiveMacros: true
+AlignEscapedNewlines: Left
+AlignTrailingComments: true
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortEnumsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: Never
+BreakBeforeBraces: Custom
+BraceWrapping:
+    AfterClass: false
+    AfterControlStatement: false
+    AfterEnum: false
+    AfterFunction: true
+    AfterNamespace: true
+    AfterObjCDeclaration: true
+    AfterStruct: false
+    AfterUnion: false
+    AfterExternBlock: false
+    BeforeCatch: false
+    BeforeElse: false
+    IndentBraces: false
+    SplitEmptyFunction: true
+    SplitEmptyRecord: true
+    SplitEmptyNamespace: true
+BinPackArguments: false
+BinPackParameters: false
+ColumnLimit: 90
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+IncludeBlocks: Preserve
+IndentWidth: 4
+ObjCBlockIndentWidth: 4
+PointerAlignment: Right
+ReferenceAlignment: Right
+SpaceAfterCStyleCast: true
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatementsExceptForEachMacros
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles: false
+SpacesInContainerLiterals: false
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SeparateDefinitionBlocks: Always
+UseTab: Never
+PPIndentWidth: 2

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+
+# Tab indentation (no size specified)
+[Makefile]
+indent_style = tab

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: [stephane]
+polar: stephane

.github/workflows/build.yml

@@ -0,0 +1,20 @@
+name: Build libmodbus
+
+on:
+    push:
+        branches: ["master"]
+    pull_request:
+        branches: ["master"]
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+
+        steps:
+            - uses: actions/checkout@v6.0.1
+            - name: configure
+              run: ./autogen.sh && ./configure
+            - name: make
+              run: make
+            - name: make distcheck
+              run: make distcheck

.gitignore

@@ -1,3 +1,4 @@
+# Temporary files
 *~
 *.swp
 *.o
@@ -7,10 +8,14 @@
 *.trs
 .deps
 .libs
-GPATH
-GRTAGS
-GSYMS
-GTAGS
+.DS_Store
+
+# Editors
+/*.sublime-*
+/.vscode
+/.venv
+
+# Generated by Autotools
 INSTALL
 Makefile
 Makefile.in
@@ -22,25 +27,27 @@ Makefile.in
 /configure.scan
 /depcomp
 /install-sh
+/libmodbus.pc
 /libtool
 /ltmain.sh
 /missing
-/libmodbus.pc
 /stamp-h1
-/*.sublime-*
-/.vscode
 src/modbus-version.h
 src/win32/modbus.dll.manifest
+tests/unit-test.h
+
+# mkdocs
+/site
+
+# Binary
 tests/bandwidth-client
 tests/bandwidth-server-many-up
 tests/bandwidth-server-one
 tests/random-test-client
 tests/random-test-server
+tests/proxy-test-client
+tests/proxy-test-server
 tests/unit-test-client
-tests/unit-test.h
 tests/unit-test-server
 tests/version
 tests/stamp-h2
-doc/*.html
-doc/*.3
-doc/*.7

CLA.txt

@@ -0,0 +1,113 @@
+libmodbus Contributor License Agreement
+
+Thank you for your interest in contributing to libmodbus (the "Project") created
+by Stéphane Raimbault.
+
+In order to clarify the intellectual property license granted with Contributions
+from any person or entity, the Project must have a Contributor License Agreement
+(CLA) on file that has been signed by each Contributor, indicating agreement to
+the license terms below. This license is for your protection as a Contributor as
+well as the protection of the Project and its users; it does not change your
+rights to use your own Contributions for any other purpose.
+
+This Agreement allows an entity (the "Corporation") to submit Contributions to
+The Project, to authorize Contributions submitted by its designated employees to
+The Project, and to grant copyright and patent licenses thereto.
+
+If you have not already done so, please complete and sign this Agreement using
+the electronic signature portal made available to you by the Project or its
+third-party service providers, or email a PDF of the signed agreement to
+stephane.raimbault@gmail.com. Please read this document carefully before signing
+and keep a copy for your records.
+
+You accept and agree to the following terms and conditions for Your present and
+future Contributions submitted to the Project. Except for the license granted
+herein to The Project and recipients of software distributed by The Project, You
+reserve all right, title, and interest in and to Your Contributions.
+
+1. Definitions
+
+"You" (or "Your") shall mean the copyright owner or legal entity authorized by
+the copyright owner that is making this Agreement with The Project. For legal
+entities, the entity making a Contribution and all other entities that control,
+are controlled by, or are under common control with that entity are considered
+to be a single Contributor. For the purposes of this definition, "control" means
+(i) the power, direct or indirect, to cause the direction or management of such
+entity, whether by contract or otherwise, or (ii) ownership of fifty percent
+(50%) or more of the outstanding shares, or (iii) beneficial ownership of such
+entity.
+
+"Contribution" shall mean the code, documentation or other original works of
+authorship expressly identified in Schedule B, as well as any original work of
+authorship, including any modifications or additions to an existing work, that
+is intentionally submitted by You to The Project for inclusion in, or
+documentation of, any of the products owned or managed by the Foundation (the
+"Work"). For the purposes of this definition, "submitted" means any form of
+electronic, verbal, or written communication sent to The Project or its
+representatives, including but not limited to communication on electronic
+mailing lists, source code control systems, and issue tracking systems that are
+managed by, or on behalf of, The Project for the purpose of discussing and
+improving the Work, but excluding communication that is conspicuously marked or
+otherwise designated in writing by You as "Not a Contribution."
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+   Agreement, You hereby grant to The Project and to recipients of software
+   distributed by The Project a perpetual, worldwide, non-exclusive, no-charge,
+   royalty-free, irrevocable copyright license to reproduce, prepare derivative
+   works of, publicly display, publicly perform, sublicense, and distribute Your
+   Contributions and such derivative works.
+
+3. Grant of Patent License. Subject to the terms and conditions of this
+   Agreement, You hereby grant to The Project and to recipients of software
+   distributed by The Project a perpetual, worldwide, non-exclusive, no-charge,
+   royalty-free, irrevocable (except as stated in this section) patent license
+   to make, have made, use, offer to sell, sell, import, and otherwise transfer
+   the Work, where such license applies only to those patent claims licensable
+   by You that are necessarily infringed by Your Contribution(s) alone or by
+   combination of Your Contribution(s) with the Work to which such
+   Contribution(s) were submitted. If any entity institutes patent litigation
+   against You or any other entity (including a cross-claim or counterclaim in a
+   lawsuit) alleging that Your Contribution, or the Work to which You have
+   contributed, constitutes direct or contributory patent infringement, then any
+   patent licenses granted to that entity under this Agreement for that
+   Contribution or Work shall terminate as of the date such litigation is filed.
+
+4. You represent that You are legally entitled to grant the above license. If
+   You are an individual, if Your employer(s) has rights to intellectual
+   property that You create that includes Your Contributions, You represent that
+   You have received permission to make Contributions on behalf of that
+   employer, that Your employer has waived such rights for Your Contributions to
+   The Project, or that Your employer has executed a separate CLA with The
+   Project. If You are a legal entity, You represent further that each employee
+   of the Corporation designated on Schedule A below (or in a subsequent written
+   modification to that Schedule) is authorized to submit Contributions on
+   behalf of the Corporation.
+
+5. You represent that each of Your Contributions is Your original creation (see
+   section 7 for submissions on behalf of others).
+
+6. You are not expected to provide support for Your Contributions, except to the
+   extent You desire to provide support. You may provide support for free, for a
+   fee, or not at all. Unless required by applicable law or agreed to in
+   writing, You provide Your Contributions on an "AS IS" BASIS, WITHOUT
+   WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including,
+   without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT,
+   MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
+
+7. Should You wish to submit work that is not Your original creation, You may
+   submit it to the Foundation separately from any Contribution, identifying the
+   complete details of its source and of any license or other restriction
+   (including, but not limited to, related patents, trademarks, and license
+   agreements) of which You are personally aware, and conspicuously marking the
+   work as "Submitted on behalf of a third-party: [named here]".
+
+8. You agree to notify The Project of any facts or circumstances of which You
+   become aware that would make these representations inaccurate in any respect.
+   If You are a legal entity, it is Your responsibility to notify The Project
+   when any change is required to the list of designated employees authorized to
+   submit Contributions on behalf of the Corporation, or to the Corporation's
+   Point of Contact with The Project.
+
+9. Should You wish to submit work that is not Your original creation, You may submit it to the Project separately from any Contribution, identifying the complete details of its source and of any license or other restriction (including, but not limited to, related patents, trademarks, and license agreements) of which you are personally aware, and conspicuously marking the work as “Submitted on behalf of a third-party: [named here]”.
+
+10. You agree to notify the Project of any facts or circumstances of which you become aware that would make these representations inaccurate in any respect.

CONTRIBUTING.md

@@ -1,29 +1,34 @@
-How Do I Submit A Good Bug Report?
-----------------------------------
+# How Do I Submit A Good Bug Report?
 
 Please, don't send direct emails to Stéphane Raimbault unless you want
 commercial support.
 
-Take care to read the documentation at http://libmodbus.org/documentation/.
+Take care to read the documentation at http://libmodbus.org/.
 
-- *Be sure it's a bug before creating an issue*, in doubt, post a message on
-  https://groups.google.com/forum/#!forum/libmodbus or send an email to
-  libmodbus@googlegroups.com
+- _Be sure it's a bug before creating an issue_, in doubt, post a message on
+  <https://groups.google.com/forum/#!forum/libmodbus> or send an email to
+  <libmodbus@googlegroups.com>
 
-- *Use a clear and decriptive title* for the issue to identify
+- _Use a clear and descriptive title_ for the issue to identify
 
-- *Which version of libmodbus are you using?* you can obtain this information
-from your package manager or by running `pkg-config --modversion libmodbus`.
-You can provide the sha1 of the commit if you have fetched the code with `git`.
+- _Which version of libmodbus are you using?_ you can obtain this information
+  from your package manager or by running `pkg-config --modversion libmodbus`.
+  You can provide the sha1 of the commit if you have fetched the code with `git`.
 
-- *Which operating system are you using?*
+- _Which operating system are you using?_
 
-- *Describe the exact steps which reproduce the problem* in as many details as
-possible. For example, the software/equipement which runs the Modbus server, how
-the clients are connected (TCP, RTU, ASCII) and the source code you are using.
+- _Describe the exact steps which reproduce the problem_ in as many details as
+  possible. For example, the software/equipment which runs the Modbus server, how
+  the clients are connected (TCP, RTU, ASCII) and the source code you are using.
 
-- *Enable the debug mode*, libmodbus provides a function to display the content
-of the Modbus messages and it's very convenient to analyze issues
-(http://libmodbus.org/docs/latest/modbus_set_debug.html).
+- _Enable the debug mode_, libmodbus provides a function to display the content
+  of the Modbus messages and it's very convenient to analyze issues
+  (http://libmodbus.org/docs/modbus_set_debug/).
 
 Good bug reports provide right and quick fixes!
+
+## Contributor License Agreement
+
+By submitting a contribution to libmodbus, you agree to the terms of the
+[Contributor License Agreement](CLA.txt). Please read it before submitting a
+pull request.