v2.0.2-rc (#27)

## v2.0.2-rc

### BREAKING CHANGES

* Refactored `config.json` - will need to verify configuration settings prior to mounting

### Issues

* \#12 \[Unit Test\] Complete all providers unit tests
* \#14 \[Unit Test\] SQLite mini-ORM unit tests and cleanup
* \#16 Add support for bucket name in Sia provider
* \#17 Update to common c++ build system
  * A single 64-bit Linux Jenkins server is used to build all Linux and Windows versions
  * All dependency sources are now included
  * MSVC is no longer supported
  * MSYS2 is required for building Windows binaries on Windows
  * OS X support is temporarily disabled
* \#19 \[bug\] Rename file is broken for files that are existing
* \#23 \[bug\] Incorrect file size displayed while upload is pending
* \#24 RocksDB implementations should be transactional
* \#25 Writes should block when maximum cache size is reached
* \#26 Complete ring buffer and direct download support

### Changes from v2.0.1-rc

* Ability to choose between RocksDB and SQLite databases
* Added direct reads and implemented download fallback
* Corrected file times on S3 and Sia providers
* Corrected handling of `chown()` and `chmod()`
* Fixed erroneous download of chunks after resize

Reviewed-on: #27

support/3rd_party/boost_1_87_0.tar.gz.sha256

@@ -0,0 +1 @@
+f55c340aa49763b1925ccf02b2e83f35fdcf634c9d5164a2acb87540173c741d *boost_1_87_0.tar.gz

support/3rd_party/cpp-httplib-0.18.1.tar.gz.sha256

@@ -0,0 +1 @@
+405abd8170f2a446fc8612ac635d0db5947c0d2e156e32603403a4496255ff00 *cpp-httplib-0.18.1.tar.gz

support/3rd_party/curl-8.11.0.tar.gz.sha256

@@ -0,0 +1 @@
+5a231145114589491fc52da118f9c7ef8abee885d1cb1ced99c7290e9a352f07 *curl-8.11.0.tar.gz

support/3rd_party/googletest-1.15.2.tar.gz.sha256

@@ -0,0 +1 @@
+7b42b4d6ed48810c5362c265a17faebe90dc2373c885e5216439d37927f02926  googletest-1.15.2.tar.gz

support/3rd_party/json-3.11.3.tar.gz.sha256

@@ -0,0 +1 @@
+0d8ef5af7f9794e3263480193c491549b2ba6cc74bb018906202ada498a79406  json-3.11.3.tar.gz

support/3rd_party/libsodium-1.0.20.tar.gz.sha256

@@ -0,0 +1 @@
+8e5aeca07a723a27bbecc3beef14b0068d37e7fc0e97f51b3f1c82d2a58005c1  libsodium-1.0.20.tar.gz

support/3rd_party/libsodium_configure.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+if [ "$1" == "mingw64" ]; then
+  HOST_CFG=--host=x86_64-w64-mingw32
+fi
+
+CFLAGS="-O3 -fomit-frame-pointer -march=$2 -mtune=generic" ./configure \
+  --disable-asm \
+  --disable-ssp \
+  --enable-shared=$4 \
+  --enable-static=yes \
+  --prefix="$3" \
+  ${HOST_CFG}

support/3rd_party/mingw64/binutils-2.41.tar.xz.sha256

@@ -0,0 +1 @@
+ae9a5789e23459e59606e6714723f2d3ffc31c03174191ef0d015bdf06007450  binutils-2.41.tar.xz

support/3rd_party/mingw64/expat-2.6.2.tar.gz.sha256

@@ -0,0 +1 @@
+fbd032683370d761ba68dba2566d3280a154f5290634172d60a79b24d366d9dc  expat-2.6.2.tar.gz

support/3rd_party/mingw64/expat-2.6.4.tar.gz.sha256

@@ -0,0 +1 @@
+372b18f6527d162fa9658f1c74d22a37429b82d822f5a1e1fc7e00f6045a06a2 *expat-2.6.4.tar.gz

support/3rd_party/mingw64/gcc-14.2.0.tar.gz.sha256

@@ -0,0 +1 @@
+7d376d445f93126dc545e2c0086d0f647c3094aae081cdb78f42ce2bc25e7293  gcc-14.2.0.tar.gz

support/3rd_party/mingw64/icu-release-75-1.tar.gz.sha256

@@ -0,0 +1 @@
+925e6b4b8cf8856e0ac214f6f34e30dee63b7bb7a50460ab4603950eff48f89e  icu-release-75-1.tar.gz

support/3rd_party/mingw64/mingw-w64-v11.0.1.tar.bz2.sha256

@@ -0,0 +1 @@
+3f66bce069ee8bed7439a1a13da7cb91a5e67ea6170f21317ac7f5794625ee10  mingw-w64-v11.0.1.tar.bz2

support/3rd_party/mingw64/pkg-config-0.29.2.tar.gz.sha256

@@ -0,0 +1 @@
+6fc69c01688c9458a57eb9a1664c9aba372ccda420a02bf4429fe610e7e7d591  pkg-config-0.29.2.tar.gz

support/3rd_party/mingw64/zlib-1.3.1.tar.gz.sha256

@@ -0,0 +1 @@
+17e88863f3600672ab49182f217281b6fc4d3c762bde361935e436a95214d05c  zlib-1.3.1.tar.gz

support/3rd_party/openssl-3.4.0.tar.gz.sha256

@@ -0,0 +1 @@
+e15dda82fe2fe8139dc2ac21a36d4ca01d5313c75f99f46c4e8a27709b7294bf *openssl-3.4.0.tar.gz

support/3rd_party/pugixml-1.14.tar.gz.sha256

@@ -0,0 +1 @@
+2f10e276870c64b1db6809050a75e11a897a8d7456c4be5c6b2e35a11168a015  pugixml-1.14.tar.gz

support/3rd_party/rocksdb-9.7.4.tar.gz.sha256

@@ -0,0 +1 @@
+9b810c81731835fda0d4bbdb51d3199d901fa4395733ab63752d297da84c5a47 *rocksdb-9.7.4.tar.gz

support/3rd_party/spdlog-1.15.0.tar.gz.sha256

@@ -0,0 +1 @@
+9962648c9b4f1a7bbc76fd8d9172555bad1871fdb14ff4f842ef87949682caa5 *spdlog-1.15.0.tar.gz

support/3rd_party/sqlite-amalgamation-3460100.zip.sha256

@@ -0,0 +1 @@
+77823cb110929c2bcb0f5d48e4833b5c59a8a6e40cdea3936b99e199dbbe5784  sqlite-amalgamation-3460100.zip

support/3rd_party/stduuid-1.2.3.tar.gz.sha256

@@ -0,0 +1 @@
+b1176597e789531c38481acbbed2a6894ad419aab0979c10410d59eb0ebf40d3  stduuid-1.2.3.tar.gz

support/3rd_party/winfsp-2.0/License.txt

@@ -0,0 +1,708 @@
+The WinFsp project is Copyright (C) Bill Zissimopoulos. It is licensed
+under the terms of the GPLv3.
+
+As a special exception to GPLv3, Bill Zissimopoulos grants additional
+permissions to Free/Libre and Open Source Software ("FLOSS") without requiring
+that such software is covered by the GPLv3.
+
+    1. Permission to link with a platform specific version of the WinFsp DLL
+    (one of: winfsp-a64.dll, winfsp-x64.dll, winfsp-x86.dll, winfsp-msil.dll).
+
+    2. Permission to distribute unmodified binary releases of the WinFsp
+    installer (as released by the WinFsp project).
+
+    These permissions (and no other) are granted provided that the software:
+
+    1. Is distributed under a license that satisfies the Free Software
+    Definition Version 1.141 (https://www.gnu.org/philosophy/free-sw.en.html)
+    or the Open Source Definition Version 1.9 (https://opensource.org/osd).
+
+    2. Includes the copyright notice "WinFsp - Windows File System Proxy,
+    Copyright (C) Bill Zissimopoulos" and a link to the WinFsp repository in
+    its user-interface and any user-facing documentation.
+
+    3. Is not linked or distributed with proprietary (non-FLOSS) software.
+    [You cannot mix FLOSS and proprietary software while using WinFsp under
+    this special exception.]
+
+Commercial licensing options are also available: Please contact
+Bill Zissimopoulos <billziss at navimatics.com>.
+
+The full text of the GPLv3 license follows below.
+
+-----------------------------------------------------------------------
+
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

support/3rd_party/winfsp-2.0/bin/diag.bat

@@ -0,0 +1,54 @@
+@echo off
+
+setlocal
+setlocal EnableDelayedExpansion
+
+REM Determine the SxS (side-by-side) identifier.
+set SxsDir=
+set RegKey="HKLM\SOFTWARE\WinFsp"
+set RegVal="SxsDir"
+reg query !RegKey! /v !RegVal! /reg:32 >nul 2>&1
+if !ERRORLEVEL! equ 0 (
+    for /f "tokens=2,*" %%i in ('reg query !RegKey! /v !RegVal! /reg:32 ^| findstr !RegVal!') do (
+        set SxsDir=%%j
+    )
+)
+set SxsSuffix=
+if defined SxsDir (
+    set SxsSuffix=!SxsDir:*SxS\sxs.=!
+    if !SxsSuffix:~-1!==\ set SxsSuffix=!SxsSuffix:~0,-1!
+    set SxsSuffix=+!SxsSuffix!
+)
+
+echo WINFSP FSD
+sc query WinFsp!SxsSuffix!
+sc qc WinFsp!SxsSuffix!
+sc sdshow WinFsp!SxsSuffix!
+echo.
+echo.
+
+echo WINFSP DLL
+reg query HKLM\SYSTEM\CurrentControlSet\Control\NetworkProvider\Order
+reg query HKLM\SYSTEM\CurrentControlSet\Services\WinFsp.Np\NetworkProvider
+reg query HKLM\SYSTEM\CurrentControlSet\Services\EventLog\Application\WinFsp
+echo.
+
+echo WINFSP LAUNCHER
+sc query WinFsp.Launcher
+sc qc WinFsp.Launcher
+sc sdshow WinFsp.Launcher
+echo.
+echo.
+
+echo WINFSP REGISTRY
+reg query HKLM\SOFTWARE\WinFsp /s /reg:32
+echo.
+
+echo FILE SYSTEM FILTERS (REQUIRES ADMINISTRATOR)
+fltmc filters
+echo.
+echo.
+
+echo OS INFORMATION
+systeminfo
+echo.

support/3rd_party/winfsp-2.0/bin/fsreg.bat

@@ -0,0 +1,42 @@
+@echo off
+
+setlocal
+setlocal EnableDelayedExpansion
+
+set RegKey=HKLM\Software\WinFsp\Services
+
+if not X%1==X-u (
+	set unreg=0
+
+	if not X%1==X set fsname=%1
+	if not X%2==X set fsexec="%~f2"
+	if not X%3==X set fscmdl=%3
+	if not X%4==X set fssecu=%4
+
+	if X!fscmdl!==X goto usage
+	if not exist !fsexec! goto notfound
+
+	reg add !RegKey!\!fsname! /v Executable /t REG_SZ /d !fsexec! /f /reg:32
+	reg add !RegKey!\!fsname! /v CommandLine /t REG_SZ /d !fscmdl! /f /reg:32
+	reg add !RegKey!\!fsname! /v JobControl /t REG_DWORD /d 1 /f /reg:32
+	if not X!fssecu!==X reg add !RegKey!\!fsname! /v Security /t REG_SZ /d !fssecu! /f /reg:32
+) else (
+	set unreg=1
+
+	if not X%2==X set fsname=%2
+
+	if X!fsname!==X goto usage
+
+	reg delete !RegKey!\!fsname! /f /reg:32
+)
+
+exit /b 0
+
+:notfound
+echo executable !fsexec! not found >&2
+exit /b 2
+
+:usage
+echo usage: fsreg NAME EXECUTABLE COMMANDLINE [SECURITY] >&2
+echo usage: fsreg -u NAME >&2
+exit /b 2

support/3rd_party/winfsp-2.0/inc/fuse/fuse.h

@@ -0,0 +1,271 @@
+/**
+ * @file fuse/fuse.h
+ * WinFsp FUSE compatible API.
+ *
+ * This file is derived from libfuse/include/fuse.h:
+ *     FUSE: Filesystem in Userspace
+ *     Copyright (C) 2001-2007  Miklos Szeredi <miklos@szeredi.hu>
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef FUSE_H_
+#define FUSE_H_
+
+#include "fuse_common.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+struct fuse;
+
+typedef int (*fuse_fill_dir_t)(void *buf, const char *name,
+    const struct fuse_stat *stbuf, fuse_off_t off);
+typedef struct fuse_dirhandle *fuse_dirh_t;
+typedef int (*fuse_dirfil_t)(fuse_dirh_t h, const char *name,
+    int type, fuse_ino_t ino);
+
+struct fuse_operations
+{
+    /* S - supported by WinFsp */
+    /* S */ int (*getattr)(const char *path, struct fuse_stat *stbuf);
+    /* S */ int (*getdir)(const char *path, fuse_dirh_t h, fuse_dirfil_t filler);
+    /* S */ int (*readlink)(const char *path, char *buf, size_t size);
+    /* S */ int (*mknod)(const char *path, fuse_mode_t mode, fuse_dev_t dev);
+    /* S */ int (*mkdir)(const char *path, fuse_mode_t mode);
+    /* S */ int (*unlink)(const char *path);
+    /* S */ int (*rmdir)(const char *path);
+    /* S */ int (*symlink)(const char *dstpath, const char *srcpath);
+    /* S */ int (*rename)(const char *oldpath, const char *newpath);
+    /* _ */ int (*link)(const char *srcpath, const char *dstpath);
+    /* S */ int (*chmod)(const char *path, fuse_mode_t mode);
+    /* S */ int (*chown)(const char *path, fuse_uid_t uid, fuse_gid_t gid);
+    /* S */ int (*truncate)(const char *path, fuse_off_t size);
+    /* S */ int (*utime)(const char *path, struct fuse_utimbuf *timbuf);
+    /* S */ int (*open)(const char *path, struct fuse_file_info *fi);
+    /* S */ int (*read)(const char *path, char *buf, size_t size, fuse_off_t off,
+        struct fuse_file_info *fi);
+    /* S */ int (*write)(const char *path, const char *buf, size_t size, fuse_off_t off,
+        struct fuse_file_info *fi);
+    /* S */ int (*statfs)(const char *path, struct fuse_statvfs *stbuf);
+    /* S */ int (*flush)(const char *path, struct fuse_file_info *fi);
+    /* S */ int (*release)(const char *path, struct fuse_file_info *fi);
+    /* S */ int (*fsync)(const char *path, int datasync, struct fuse_file_info *fi);
+    /* S */ int (*setxattr)(const char *path, const char *name, const char *value, size_t size,
+        int flags);
+    /* S */ int (*getxattr)(const char *path, const char *name, char *value, size_t size);
+    /* S */ int (*listxattr)(const char *path, char *namebuf, size_t size);
+    /* S */ int (*removexattr)(const char *path, const char *name);
+    /* S */ int (*opendir)(const char *path, struct fuse_file_info *fi);
+    /* S */ int (*readdir)(const char *path, void *buf, fuse_fill_dir_t filler, fuse_off_t off,
+        struct fuse_file_info *fi);
+    /* S */ int (*releasedir)(const char *path, struct fuse_file_info *fi);
+    /* S */ int (*fsyncdir)(const char *path, int datasync, struct fuse_file_info *fi);
+    /* S */ void *(*init)(struct fuse_conn_info *conn);
+    /* S */ void (*destroy)(void *data);
+    /* S */ int (*access)(const char *path, int mask);
+    /* S */ int (*create)(const char *path, fuse_mode_t mode, struct fuse_file_info *fi);
+    /* S */ int (*ftruncate)(const char *path, fuse_off_t off, struct fuse_file_info *fi);
+    /* S */ int (*fgetattr)(const char *path, struct fuse_stat *stbuf, struct fuse_file_info *fi);
+    /* _ */ int (*lock)(const char *path,
+        struct fuse_file_info *fi, int cmd, struct fuse_flock *lock);
+    /* S */ int (*utimens)(const char *path, const struct fuse_timespec tv[2]);
+    /* _ */ int (*bmap)(const char *path, size_t blocksize, uint64_t *idx);
+    /* _ */ unsigned int flag_nullpath_ok:1;
+    /* _ */ unsigned int flag_nopath:1;
+    /* _ */ unsigned int flag_utime_omit_ok:1;
+    /* _ */ unsigned int flag_reserved:29;
+    /* S */ int (*ioctl)(const char *path, int cmd, void *arg, struct fuse_file_info *fi,
+        unsigned int flags, void *data);
+    /* _ */ int (*poll)(const char *path, struct fuse_file_info *fi,
+        struct fuse_pollhandle *ph, unsigned *reventsp);
+    /* FUSE 2.9 */
+    /* _ */ int (*write_buf)(const char *path,
+        struct fuse_bufvec *buf, fuse_off_t off, struct fuse_file_info *fi);
+    /* _ */ int (*read_buf)(const char *path,
+        struct fuse_bufvec **bufp, size_t size, fuse_off_t off, struct fuse_file_info *fi);
+    /* _ */ int (*flock)(const char *path, struct fuse_file_info *, int op);
+    /* _ */ int (*fallocate)(const char *path, int mode, fuse_off_t off, fuse_off_t len,
+        struct fuse_file_info *fi);
+    /* WinFsp */
+    /* S */ int (*getpath)(const char *path, char *buf, size_t size,
+        struct fuse_file_info *fi);
+    /* OSXFUSE */
+    /* _ */ int (*reserved01)();
+    /* _ */ int (*reserved02)();
+    /* _ */ int (*statfs_x)(const char *path, struct fuse_statfs *stbuf);
+    /* _ */ int (*setvolname)(const char *volname);
+    /* _ */ int (*exchange)(const char *oldpath, const char *newpath, unsigned long flags);
+    /* _ */ int (*getxtimes)(const char *path,
+        struct fuse_timespec *bkuptime, struct fuse_timespec *crtime);
+    /* _ */ int (*setbkuptime)(const char *path, const struct fuse_timespec *tv);
+    /* S */ int (*setchgtime)(const char *path, const struct fuse_timespec *tv);
+    /* S */ int (*setcrtime)(const char *path, const struct fuse_timespec *tv);
+    /* S */ int (*chflags)(const char *path, uint32_t flags);
+    /* _ */ int (*setattr_x)(const char *path, struct fuse_setattr_x *attr);
+    /* _ */ int (*fsetattr_x)(const char *path, struct fuse_setattr_x *attr,
+        struct fuse_file_info *fi);
+};
+
+struct fuse_context
+{
+    struct fuse *fuse;
+    fuse_uid_t uid;
+    fuse_gid_t gid;
+    fuse_pid_t pid;
+    void *private_data;
+    fuse_mode_t umask;
+};
+
+#define fuse_main(argc, argv, ops, data)\
+    fuse_main_real(argc, argv, ops, sizeof *(ops), data)
+
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_main_real)(struct fsp_fuse_env *env,
+    int argc, char *argv[],
+    const struct fuse_operations *ops, size_t opsize, void *data);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_is_lib_option)(struct fsp_fuse_env *env,
+    const char *opt);
+FSP_FUSE_API struct fuse *FSP_FUSE_API_NAME(fsp_fuse_new)(struct fsp_fuse_env *env,
+    struct fuse_chan *ch, struct fuse_args *args,
+    const struct fuse_operations *ops, size_t opsize, void *data);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse_destroy)(struct fsp_fuse_env *env,
+    struct fuse *f);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_loop)(struct fsp_fuse_env *env,
+    struct fuse *f);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_loop_mt)(struct fsp_fuse_env *env,
+    struct fuse *f);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse_exit)(struct fsp_fuse_env *env,
+    struct fuse *f);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_exited)(struct fsp_fuse_env *env,
+    struct fuse *f);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_notify)(struct fsp_fuse_env *env,
+    struct fuse *f, const char *path, uint32_t action);
+FSP_FUSE_API struct fuse_context *FSP_FUSE_API_NAME(fsp_fuse_get_context)(struct fsp_fuse_env *env);
+
+FSP_FUSE_SYM(
+int fuse_main_real(int argc, char *argv[],
+    const struct fuse_operations *ops, size_t opsize, void *data),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_main_real)
+        (fsp_fuse_env(), argc, argv, ops, opsize, data);
+})
+
+FSP_FUSE_SYM(
+int fuse_is_lib_option(const char *opt),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_is_lib_option)
+        (fsp_fuse_env(), opt);
+})
+
+FSP_FUSE_SYM(
+struct fuse *fuse_new(struct fuse_chan *ch, struct fuse_args *args,
+    const struct fuse_operations *ops, size_t opsize, void *data),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_new)
+        (fsp_fuse_env(), ch, args, ops, opsize, data);
+})
+
+FSP_FUSE_SYM(
+void fuse_destroy(struct fuse *f),
+{
+    FSP_FUSE_API_CALL(fsp_fuse_destroy)
+        (fsp_fuse_env(), f);
+})
+
+FSP_FUSE_SYM(
+int fuse_loop(struct fuse *f),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_loop)
+        (fsp_fuse_env(), f);
+})
+
+FSP_FUSE_SYM(
+int fuse_loop_mt(struct fuse *f),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_loop_mt)
+        (fsp_fuse_env(), f);
+})
+
+FSP_FUSE_SYM(
+void fuse_exit(struct fuse *f),
+{
+    FSP_FUSE_API_CALL(fsp_fuse_exit)
+        (fsp_fuse_env(), f);
+})
+
+FSP_FUSE_SYM(
+int fuse_exited(struct fuse *f),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_exited)
+        (fsp_fuse_env(), f);
+})
+
+FSP_FUSE_SYM(
+int fuse_notify(struct fuse *f, const char *path, uint32_t action),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_notify)
+        (fsp_fuse_env(), f, path, action);
+})
+
+FSP_FUSE_SYM(
+struct fuse_context *fuse_get_context(void),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_get_context)
+        (fsp_fuse_env());
+})
+
+FSP_FUSE_SYM(
+int fuse_getgroups(int size, fuse_gid_t list[]),
+{
+    (void)size;
+    (void)list;
+    return -ENOSYS;
+})
+
+FSP_FUSE_SYM(
+int fuse_interrupted(void),
+{
+    return 0;
+})
+
+FSP_FUSE_SYM(
+int fuse_invalidate(struct fuse *f, const char *path),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_notify)
+        (fsp_fuse_env(), f, path, 0);
+})
+
+FSP_FUSE_SYM(
+int fuse_notify_poll(struct fuse_pollhandle *ph),
+{
+    (void)ph;
+    return 0;
+})
+
+FSP_FUSE_SYM(
+struct fuse_session *fuse_get_session(struct fuse *f),
+{
+    return (struct fuse_session *)f;
+})
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/fuse/fuse_common.h

@@ -0,0 +1,202 @@
+/**
+ * @file fuse/fuse_common.h
+ * WinFsp FUSE compatible API.
+ *
+ * This file is derived from libfuse/include/fuse_common.h:
+ *     FUSE: Filesystem in Userspace
+ *     Copyright (C) 2001-2007  Miklos Szeredi <miklos@szeredi.hu>
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef FUSE_COMMON_H_
+#define FUSE_COMMON_H_
+
+#include "winfsp_fuse.h"
+#include "fuse_opt.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define FUSE_MAJOR_VERSION              2
+#define FUSE_MINOR_VERSION              8
+#define FUSE_MAKE_VERSION(maj, min)     ((maj) * 10 + (min))
+#define FUSE_VERSION                    FUSE_MAKE_VERSION(FUSE_MAJOR_VERSION, FUSE_MINOR_VERSION)
+
+#define FUSE_CAP_ASYNC_READ             (1 << 0)
+#define FUSE_CAP_POSIX_LOCKS            (1 << 1)
+#define FUSE_CAP_ATOMIC_O_TRUNC         (1 << 3)
+#define FUSE_CAP_EXPORT_SUPPORT         (1 << 4)
+#define FUSE_CAP_BIG_WRITES             (1 << 5)
+#define FUSE_CAP_DONT_MASK              (1 << 6)
+#define FUSE_CAP_ALLOCATE               (1 << 27)   /* reserved (OSXFUSE) */
+#define FUSE_CAP_EXCHANGE_DATA          (1 << 28)   /* reserved (OSXFUSE) */
+#define FUSE_CAP_CASE_INSENSITIVE       (1 << 29)   /* file system is case insensitive */
+#define FUSE_CAP_VOL_RENAME             (1 << 30)   /* reserved (OSXFUSE) */
+#define FUSE_CAP_XTIMES                 (1 << 31)   /* reserved (OSXFUSE) */
+
+#define FSP_FUSE_CAP_READDIR_PLUS       (1 << 21)   /* file system supports enhanced readdir */
+#define FSP_FUSE_CAP_READ_ONLY          (1 << 22)   /* file system is marked read-only */
+#define FSP_FUSE_CAP_STAT_EX            (1 << 23)   /* file system supports fuse_stat_ex */
+#define FSP_FUSE_CAP_DELETE_ACCESS      (1 << 24)   /* file system supports access with DELETE_OK */
+#define FSP_FUSE_CAP_CASE_INSENSITIVE   FUSE_CAP_CASE_INSENSITIVE
+
+#define FUSE_IOCTL_COMPAT               (1 << 0)
+#define FUSE_IOCTL_UNRESTRICTED         (1 << 1)
+#define FUSE_IOCTL_RETRY                (1 << 2)
+#define FUSE_IOCTL_MAX_IOV              256
+
+/* from FreeBSD */
+#define FSP_FUSE_UF_HIDDEN              0x00008000
+#define FSP_FUSE_UF_READONLY            0x00001000
+#define FSP_FUSE_UF_SYSTEM              0x00000080
+#define FSP_FUSE_UF_ARCHIVE             0x00000800
+#if !defined(UF_HIDDEN)
+#define UF_HIDDEN                       FSP_FUSE_UF_HIDDEN
+#endif
+#if !defined(UF_READONLY)
+#define UF_READONLY                     FSP_FUSE_UF_READONLY
+#endif
+#if !defined(UF_SYSTEM)
+#define UF_SYSTEM                       FSP_FUSE_UF_SYSTEM
+#endif
+#if !defined(UF_ARCHIVE)
+#define UF_ARCHIVE                      FSP_FUSE_UF_ARCHIVE
+#endif
+
+/* delete access */
+#define FSP_FUSE_DELETE_OK              0x40000000
+
+/* notify extension */
+#define FSP_FUSE_NOTIFY_MKDIR           0x0001
+#define FSP_FUSE_NOTIFY_RMDIR           0x0002
+#define FSP_FUSE_NOTIFY_CREATE          0x0004
+#define FSP_FUSE_NOTIFY_UNLINK          0x0008
+#define FSP_FUSE_NOTIFY_CHMOD           0x0010
+#define FSP_FUSE_NOTIFY_CHOWN           0x0020
+#define FSP_FUSE_NOTIFY_UTIME           0x0040
+#define FSP_FUSE_NOTIFY_CHFLAGS         0x0080
+#define FSP_FUSE_NOTIFY_TRUNCATE        0x0100
+
+/* getpath extension */
+#define FSP_FUSE_HAS_GETPATH            1
+
+struct fuse_file_info
+{
+    int flags;
+    unsigned int fh_old;
+    int writepage;
+    unsigned int direct_io:1;
+    unsigned int keep_cache:1;
+    unsigned int flush:1;
+    unsigned int nonseekable:1;
+    unsigned int padding:28;
+    uint64_t fh;
+    uint64_t lock_owner;
+};
+
+struct fuse_conn_info
+{
+    unsigned proto_major;
+    unsigned proto_minor;
+    unsigned async_read;
+    unsigned max_write;
+    unsigned max_readahead;
+    unsigned capable;
+    unsigned want;
+    unsigned reserved[25];
+};
+
+struct fuse_session;
+struct fuse_chan;
+struct fuse_pollhandle;
+struct fuse_bufvec;
+struct fuse_statfs;
+struct fuse_setattr_x;
+
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_version)(struct fsp_fuse_env *env);
+FSP_FUSE_API struct fuse_chan *FSP_FUSE_API_NAME(fsp_fuse_mount)(struct fsp_fuse_env *env,
+    const char *mountpoint, struct fuse_args *args);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse_unmount)(struct fsp_fuse_env *env,
+    const char *mountpoint, struct fuse_chan *ch);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_parse_cmdline)(struct fsp_fuse_env *env,
+    struct fuse_args *args,
+    char **mountpoint, int *multithreaded, int *foreground);
+FSP_FUSE_API int32_t FSP_FUSE_API_NAME(fsp_fuse_ntstatus_from_errno)(struct fsp_fuse_env *env,
+    int err);
+
+FSP_FUSE_SYM(
+int fuse_version(void),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_version)
+        (fsp_fuse_env());
+})
+
+FSP_FUSE_SYM(
+struct fuse_chan *fuse_mount(const char *mountpoint, struct fuse_args *args),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_mount)
+        (fsp_fuse_env(), mountpoint, args);
+})
+
+FSP_FUSE_SYM(
+void fuse_unmount(const char *mountpoint, struct fuse_chan *ch),
+{
+    FSP_FUSE_API_CALL(fsp_fuse_unmount)
+        (fsp_fuse_env(), mountpoint, ch);
+})
+
+FSP_FUSE_SYM(
+int fuse_parse_cmdline(struct fuse_args *args,
+    char **mountpoint, int *multithreaded, int *foreground),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_parse_cmdline)
+        (fsp_fuse_env(), args, mountpoint, multithreaded, foreground);
+})
+
+FSP_FUSE_SYM(
+void fuse_pollhandle_destroy(struct fuse_pollhandle *ph),
+{
+    (void)ph;
+})
+
+FSP_FUSE_SYM(
+int fuse_daemonize(int foreground),
+{
+    return fsp_fuse_daemonize(foreground);
+})
+
+FSP_FUSE_SYM(
+int fuse_set_signal_handlers(struct fuse_session *se),
+{
+    return fsp_fuse_set_signal_handlers(se);
+})
+
+FSP_FUSE_SYM(
+void fuse_remove_signal_handlers(struct fuse_session *se),
+{
+    (void)se;
+    fsp_fuse_set_signal_handlers(0);
+})
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/fuse/fuse_opt.h

@@ -0,0 +1,133 @@
+/**
+ * @file fuse/fuse_opt.h
+ * WinFsp FUSE compatible API.
+ *
+ * This file is derived from libfuse/include/fuse_opt.h:
+ *     FUSE: Filesystem in Userspace
+ *     Copyright (C) 2001-2007  Miklos Szeredi <miklos@szeredi.hu>
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef FUSE_OPT_H_
+#define FUSE_OPT_H_
+
+#include "winfsp_fuse.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define FUSE_OPT_KEY(templ, key)        { templ, -1, key }
+#define FUSE_OPT_END                    { NULL, 0, 0 }
+
+#define FUSE_OPT_KEY_OPT                -1
+#define FUSE_OPT_KEY_NONOPT             -2
+#define FUSE_OPT_KEY_KEEP               -3
+#define FUSE_OPT_KEY_DISCARD            -4
+
+#define FUSE_ARGS_INIT(argc, argv)      { argc, argv, 0 }
+
+struct fuse_opt
+{
+    const char *templ;
+    unsigned int offset;
+    int value;
+};
+
+struct fuse_args
+{
+    int argc;
+    char **argv;
+    int allocated;
+};
+
+typedef int (*fuse_opt_proc_t)(void *data, const char *arg, int key,
+    struct fuse_args *outargs);
+
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_opt_parse)(struct fsp_fuse_env *env,
+    struct fuse_args *args, void *data,
+    const struct fuse_opt opts[], fuse_opt_proc_t proc);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_opt_add_arg)(struct fsp_fuse_env *env,
+    struct fuse_args *args, const char *arg);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_opt_insert_arg)(struct fsp_fuse_env *env,
+    struct fuse_args *args, int pos, const char *arg);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse_opt_free_args)(struct fsp_fuse_env *env,
+    struct fuse_args *args);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_opt_add_opt)(struct fsp_fuse_env *env,
+    char **opts, const char *opt);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_opt_add_opt_escaped)(struct fsp_fuse_env *env,
+    char **opts, const char *opt);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse_opt_match)(struct fsp_fuse_env *env,
+    const struct fuse_opt opts[], const char *opt);
+
+FSP_FUSE_SYM(
+int fuse_opt_parse(struct fuse_args *args, void *data,
+    const struct fuse_opt opts[], fuse_opt_proc_t proc),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_opt_parse)
+        (fsp_fuse_env(), args, data, opts, proc);
+})
+
+FSP_FUSE_SYM(
+int fuse_opt_add_arg(struct fuse_args *args, const char *arg),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_opt_add_arg)
+        (fsp_fuse_env(), args, arg);
+})
+
+FSP_FUSE_SYM(
+int fuse_opt_insert_arg(struct fuse_args *args, int pos, const char *arg),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_opt_insert_arg)
+        (fsp_fuse_env(), args, pos, arg);
+})
+
+FSP_FUSE_SYM(
+void fuse_opt_free_args(struct fuse_args *args),
+{
+    FSP_FUSE_API_CALL(fsp_fuse_opt_free_args)
+        (fsp_fuse_env(), args);
+})
+
+FSP_FUSE_SYM(
+int fuse_opt_add_opt(char **opts, const char *opt),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_opt_add_opt)
+        (fsp_fuse_env(), opts, opt);
+})
+
+FSP_FUSE_SYM(
+int fuse_opt_add_opt_escaped(char **opts, const char *opt),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_opt_add_opt_escaped)
+        (fsp_fuse_env(), opts, opt);
+})
+
+FSP_FUSE_SYM(
+int fuse_opt_match(const struct fuse_opt opts[], const char *opt),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse_opt_match)
+        (fsp_fuse_env(), opts, opt);
+})
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/fuse/winfsp_fuse.h

@@ -0,0 +1,434 @@
+/**
+ * @file fuse/winfsp_fuse.h
+ * WinFsp FUSE compatible API.
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef FUSE_WINFSP_FUSE_H_INCLUDED
+#define FUSE_WINFSP_FUSE_H_INCLUDED
+
+#include <errno.h>
+#include <stdint.h>
+#if !defined(WINFSP_DLL_INTERNAL)
+#include <stdlib.h>
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if !defined(FSP_FUSE_API)
+#if defined(WINFSP_DLL_INTERNAL)
+#define FSP_FUSE_API                    __declspec(dllexport)
+#else
+#define FSP_FUSE_API                    __declspec(dllimport)
+#endif
+#endif
+
+#if !defined(FSP_FUSE_API_NAME)
+#define FSP_FUSE_API_NAME(n)            (n)
+#endif
+
+#if !defined(FSP_FUSE_API_CALL)
+#define FSP_FUSE_API_CALL(n)            (n)
+#endif
+
+#if !defined(FSP_FUSE_SYM)
+#if !defined(CYGFUSE)
+#define FSP_FUSE_SYM(proto, ...)        static inline proto { __VA_ARGS__ }
+#else
+#define FSP_FUSE_SYM(proto, ...)        proto;
+#endif
+#endif
+
+#define FSP_FUSE_DEVICE_TYPE            (0x8000 | 'W' | 'F' * 0x100) /* DeviceIoControl -> ioctl */
+#define FSP_FUSE_CTLCODE_FROM_IOCTL(cmd)\
+    (FSP_FUSE_DEVICE_TYPE << 16) | (((cmd) & 0x0fff) << 2)
+#define FSP_FUSE_IOCTL(cmd, isiz, osiz) \
+    (                                   \
+        (((osiz) != 0) << 31) |         \
+        (((isiz) != 0) << 30) |         \
+        (((isiz) | (osiz)) << 16) |     \
+        (cmd)                           \
+    )
+
+/*
+ * FUSE uses a number of types (notably: struct stat) that are OS specific.
+ * Furthermore there are sometimes multiple definitions of the same type even
+ * within the same OS. This is certainly true on Windows, where these types
+ * are not even native.
+ *
+ * For this reason we will define our own fuse_* types which represent the
+ * types as the WinFsp DLL expects to see them. We will define these types
+ * to be compatible with the equivalent Cygwin types as we want WinFsp-FUSE
+ * to be usable from Cygwin.
+ */
+
+#define FSP_FUSE_STAT_FIELD_DEFN        \
+    fuse_dev_t st_dev;                  \
+    fuse_ino_t st_ino;                  \
+    fuse_mode_t st_mode;                \
+    fuse_nlink_t st_nlink;              \
+    fuse_uid_t st_uid;                  \
+    fuse_gid_t st_gid;                  \
+    fuse_dev_t st_rdev;                 \
+    fuse_off_t st_size;                 \
+    struct fuse_timespec st_atim;       \
+    struct fuse_timespec st_mtim;       \
+    struct fuse_timespec st_ctim;       \
+    fuse_blksize_t st_blksize;          \
+    fuse_blkcnt_t st_blocks;            \
+    struct fuse_timespec st_birthtim;
+#define FSP_FUSE_STAT_EX_FIELD_DEFN     \
+    FSP_FUSE_STAT_FIELD_DEFN            \
+    uint32_t st_flags;                  \
+    uint32_t st_reserved32[3];          \
+    uint64_t st_reserved64[2];
+
+#if defined(_WIN64) || defined(_WIN32)
+
+typedef uint32_t fuse_uid_t;
+typedef uint32_t fuse_gid_t;
+typedef int32_t fuse_pid_t;
+
+typedef uint32_t fuse_dev_t;
+typedef uint64_t fuse_ino_t;
+typedef uint32_t fuse_mode_t;
+typedef uint16_t fuse_nlink_t;
+typedef int64_t fuse_off_t;
+
+#if defined(_WIN64)
+typedef uint64_t fuse_fsblkcnt_t;
+typedef uint64_t fuse_fsfilcnt_t;
+#else
+typedef uint32_t fuse_fsblkcnt_t;
+typedef uint32_t fuse_fsfilcnt_t;
+#endif
+typedef int32_t fuse_blksize_t;
+typedef int64_t fuse_blkcnt_t;
+
+#if defined(_WIN64)
+struct fuse_utimbuf
+{
+    int64_t actime;
+    int64_t modtime;
+};
+struct fuse_timespec
+{
+    int64_t tv_sec;
+    int64_t tv_nsec;
+};
+#else
+struct fuse_utimbuf
+{
+    int32_t actime;
+    int32_t modtime;
+};
+struct fuse_timespec
+{
+    int32_t tv_sec;
+    int32_t tv_nsec;
+};
+#endif
+
+#if !defined(FSP_FUSE_USE_STAT_EX)
+struct fuse_stat
+{
+    FSP_FUSE_STAT_FIELD_DEFN
+};
+#else
+struct fuse_stat
+{
+    FSP_FUSE_STAT_EX_FIELD_DEFN
+};
+#endif
+
+#if defined(_WIN64)
+struct fuse_statvfs
+{
+    uint64_t f_bsize;
+    uint64_t f_frsize;
+    fuse_fsblkcnt_t f_blocks;
+    fuse_fsblkcnt_t f_bfree;
+    fuse_fsblkcnt_t f_bavail;
+    fuse_fsfilcnt_t f_files;
+    fuse_fsfilcnt_t f_ffree;
+    fuse_fsfilcnt_t f_favail;
+    uint64_t f_fsid;
+    uint64_t f_flag;
+    uint64_t f_namemax;
+};
+#else
+struct fuse_statvfs
+{
+    uint32_t f_bsize;
+    uint32_t f_frsize;
+    fuse_fsblkcnt_t f_blocks;
+    fuse_fsblkcnt_t f_bfree;
+    fuse_fsblkcnt_t f_bavail;
+    fuse_fsfilcnt_t f_files;
+    fuse_fsfilcnt_t f_ffree;
+    fuse_fsfilcnt_t f_favail;
+    uint32_t f_fsid;
+    uint32_t f_flag;
+    uint32_t f_namemax;
+};
+#endif
+
+struct fuse_flock
+{
+    int16_t l_type;
+    int16_t l_whence;
+    fuse_off_t l_start;
+    fuse_off_t l_len;
+    fuse_pid_t l_pid;
+};
+
+#if defined(WINFSP_DLL_INTERNAL)
+#define FSP_FUSE_ENV_INIT               \
+    {                                   \
+        'W',                            \
+        MemAlloc, MemFree,              \
+        fsp_fuse_daemonize,             \
+        fsp_fuse_set_signal_handlers,   \
+        0/*conv_to_win_path*/,          \
+        0/*winpid_to_pid*/,             \
+        { 0 },                          \
+    }
+#else
+#define FSP_FUSE_ENV_INIT               \
+    {                                   \
+        'W',                            \
+        malloc, free,                   \
+        fsp_fuse_daemonize,             \
+        fsp_fuse_set_signal_handlers,   \
+        0/*conv_to_win_path*/,          \
+        0/*winpid_to_pid*/,             \
+        { 0 },                          \
+    }
+#endif
+
+#elif defined(__CYGWIN__)
+
+#include <fcntl.h>
+#include <pthread.h>
+#include <signal.h>
+#include <sys/stat.h>
+#include <sys/statvfs.h>
+#include <sys/types.h>
+#include <utime.h>
+
+#define fuse_uid_t                      uid_t
+#define fuse_gid_t                      gid_t
+#define fuse_pid_t                      pid_t
+
+#define fuse_dev_t                      dev_t
+#define fuse_ino_t                      ino_t
+#define fuse_mode_t                     mode_t
+#define fuse_nlink_t                    nlink_t
+#define fuse_off_t                      off_t
+
+#define fuse_fsblkcnt_t                 fsblkcnt_t
+#define fuse_fsfilcnt_t                 fsfilcnt_t
+#define fuse_blksize_t                  blksize_t
+#define fuse_blkcnt_t                   blkcnt_t
+
+#define fuse_utimbuf                    utimbuf
+#define fuse_timespec                   timespec
+
+#if !defined(FSP_FUSE_USE_STAT_EX)
+#define fuse_stat                       stat
+#else
+struct fuse_stat
+{
+    FSP_FUSE_STAT_EX_FIELD_DEFN
+};
+#endif
+#define fuse_statvfs                    statvfs
+#define fuse_flock                      flock
+
+#define FSP_FUSE_ENV_INIT               \
+    {                                   \
+        'C',                            \
+        malloc, free,                   \
+        fsp_fuse_daemonize,             \
+        fsp_fuse_set_signal_handlers,   \
+        fsp_fuse_conv_to_win_path,      \
+        fsp_fuse_winpid_to_pid,         \
+        { 0 },                          \
+    }
+
+/*
+ * Note that long is 8 bytes long in Cygwin64 and 4 bytes long in Win64.
+ * For this reason we avoid using long anywhere in these headers.
+ */
+
+#else
+#error unsupported environment
+#endif
+
+struct fuse_stat_ex
+{
+    FSP_FUSE_STAT_EX_FIELD_DEFN
+};
+
+struct fsp_fuse_env
+{
+    unsigned environment;
+    void *(*memalloc)(size_t);
+    void (*memfree)(void *);
+    int (*daemonize)(int);
+    int (*set_signal_handlers)(void *);
+    char *(*conv_to_win_path)(const char *);
+    fuse_pid_t (*winpid_to_pid)(uint32_t);
+    void (*reserved[2])();
+};
+
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse_signal_handler)(int sig);
+
+#if defined(_WIN64) || defined(_WIN32)
+
+static inline int fsp_fuse_daemonize(int foreground)
+{
+    (void)foreground;
+    return 0;
+}
+
+static inline int fsp_fuse_set_signal_handlers(void *se)
+{
+    (void)se;
+    return 0;
+}
+
+#elif defined(__CYGWIN__)
+
+static inline int fsp_fuse_daemonize(int foreground)
+{
+    int daemon(int nochdir, int noclose);
+    int chdir(const char *path);
+
+    if (!foreground)
+    {
+        if (-1 == daemon(0, 0))
+            return -1;
+    }
+    else
+        chdir("/");
+
+    return 0;
+}
+
+static inline void *fsp_fuse_signal_thread(void *psigmask)
+{
+    int sig;
+
+    if (0 == sigwait((sigset_t *)psigmask, &sig))
+        FSP_FUSE_API_CALL(fsp_fuse_signal_handler)(sig);
+
+    return 0;
+}
+
+static inline int fsp_fuse_set_signal_handlers(void *se)
+{
+#define FSP_FUSE_SET_SIGNAL_HANDLER(sig, newha)\
+    if (-1 != sigaction((sig), 0, &oldsa) &&\
+        oldsa.sa_handler == (se ? SIG_DFL : (newha)))\
+    {\
+        newsa.sa_handler = se ? (newha) : SIG_DFL;\
+        sigaction((sig), &newsa, 0);\
+    }
+#define FSP_FUSE_SIGADDSET(sig)\
+    if (-1 != sigaction((sig), 0, &oldsa) &&\
+        oldsa.sa_handler == SIG_DFL)\
+        sigaddset(&sigmask, (sig));
+
+    static sigset_t sigmask;
+    static pthread_t sigthr;
+    struct sigaction oldsa, newsa;
+
+    // memset instead of initializer to avoid GCC -Wmissing-field-initializers warning
+    memset(&newsa, 0, sizeof newsa);
+
+    if (0 != se)
+    {
+        if (0 == sigthr)
+        {
+            FSP_FUSE_SET_SIGNAL_HANDLER(SIGPIPE, SIG_IGN);
+
+            sigemptyset(&sigmask);
+            FSP_FUSE_SIGADDSET(SIGHUP);
+            FSP_FUSE_SIGADDSET(SIGINT);
+            FSP_FUSE_SIGADDSET(SIGTERM);
+            if (0 != pthread_sigmask(SIG_BLOCK, &sigmask, 0))
+                return -1;
+
+            if (0 != pthread_create(&sigthr, 0, fsp_fuse_signal_thread, &sigmask))
+                return -1;
+        }
+    }
+    else
+    {
+        if (0 != sigthr)
+        {
+            pthread_cancel(sigthr);
+            pthread_join(sigthr, 0);
+            sigthr = 0;
+
+            if (0 != pthread_sigmask(SIG_UNBLOCK, &sigmask, 0))
+                return -1;
+            sigemptyset(&sigmask);
+
+            FSP_FUSE_SET_SIGNAL_HANDLER(SIGPIPE, SIG_IGN);
+        }
+    }
+
+    return 0;
+
+#undef FSP_FUSE_SIGADDSET
+#undef FSP_FUSE_SET_SIGNAL_HANDLER
+}
+
+static inline char *fsp_fuse_conv_to_win_path(const char *path)
+{
+    void *cygwin_create_path(unsigned, const void *);
+    return (char *)cygwin_create_path(
+        0/*CCP_POSIX_TO_WIN_A*/ | 0x100/*CCP_RELATIVE*/,
+        path);
+}
+
+static inline fuse_pid_t fsp_fuse_winpid_to_pid(uint32_t winpid)
+{
+    pid_t cygwin_winpid_to_pid(int winpid);
+    pid_t pid = cygwin_winpid_to_pid(winpid);
+    return -1 != pid ? pid : (fuse_pid_t)winpid;
+}
+#endif
+
+
+static inline struct fsp_fuse_env *fsp_fuse_env(void)
+{
+    static struct fsp_fuse_env env = FSP_FUSE_ENV_INIT;
+    return &env;
+}
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/fuse3/fuse.h

@@ -0,0 +1,338 @@
+/**
+ * @file fuse3/fuse.h
+ * WinFsp FUSE3 compatible API.
+ *
+ * This file is derived from libfuse/include/fuse.h:
+ *     FUSE: Filesystem in Userspace
+ *     Copyright (C) 2001-2007  Miklos Szeredi <miklos@szeredi.hu>
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef FUSE_H_
+#define FUSE_H_
+
+#include "fuse_common.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+struct fuse3;
+
+enum fuse3_readdir_flags
+{
+    FUSE_READDIR_PLUS                   = (1 << 0),
+};
+
+enum fuse3_fill_dir_flags
+{
+    FUSE_FILL_DIR_PLUS                  = (1 << 1),
+};
+
+typedef int (*fuse3_fill_dir_t)(void *buf, const char *name,
+    const struct fuse_stat *stbuf, fuse_off_t off,
+    enum fuse3_fill_dir_flags flags);
+
+struct fuse3_config
+{
+    int set_gid;
+    unsigned int gid;
+    int set_uid;
+    unsigned int uid;
+    int set_mode;
+    unsigned int umask;
+    double entry_timeout;
+    double negative_timeout;
+    double attr_timeout;
+    int intr;
+    int intr_signal;
+    int remember;
+    int hard_remove;
+    int use_ino;
+    int readdir_ino;
+    int direct_io;
+    int kernel_cache;
+    int auto_cache;
+    int ac_attr_timeout_set;
+    double ac_attr_timeout;
+    int nullpath_ok;
+    /* private */
+    int show_help;
+    char *modules;
+    int debug;
+};
+
+struct fuse3_operations
+{
+    /* S - supported by WinFsp */
+    /* S */ int (*getattr)(const char *path, struct fuse_stat *stbuf,
+        struct fuse3_file_info *fi);
+    /* S */ int (*readlink)(const char *path, char *buf, size_t size);
+    /* S */ int (*mknod)(const char *path, fuse_mode_t mode, fuse_dev_t dev);
+    /* S */ int (*mkdir)(const char *path, fuse_mode_t mode);
+    /* S */ int (*unlink)(const char *path);
+    /* S */ int (*rmdir)(const char *path);
+    /* S */ int (*symlink)(const char *dstpath, const char *srcpath);
+    /* S */ int (*rename)(const char *oldpath, const char *newpath, unsigned int flags);
+    /* _ */ int (*link)(const char *srcpath, const char *dstpath);
+    /* S */ int (*chmod)(const char *path, fuse_mode_t mode,
+        struct fuse3_file_info *fi);
+    /* S */ int (*chown)(const char *path, fuse_uid_t uid, fuse_gid_t gid,
+        struct fuse3_file_info *fi);
+    /* S */ int (*truncate)(const char *path, fuse_off_t size,
+        struct fuse3_file_info *fi);
+    /* S */ int (*open)(const char *path, struct fuse3_file_info *fi);
+    /* S */ int (*read)(const char *path, char *buf, size_t size, fuse_off_t off,
+        struct fuse3_file_info *fi);
+    /* S */ int (*write)(const char *path, const char *buf, size_t size, fuse_off_t off,
+        struct fuse3_file_info *fi);
+    /* S */ int (*statfs)(const char *path, struct fuse_statvfs *stbuf);
+    /* S */ int (*flush)(const char *path, struct fuse3_file_info *fi);
+    /* S */ int (*release)(const char *path, struct fuse3_file_info *fi);
+    /* S */ int (*fsync)(const char *path, int datasync, struct fuse3_file_info *fi);
+    /* S */ int (*setxattr)(const char *path, const char *name, const char *value, size_t size,
+        int flags);
+    /* S */ int (*getxattr)(const char *path, const char *name, char *value, size_t size);
+    /* S */ int (*listxattr)(const char *path, char *namebuf, size_t size);
+    /* S */ int (*removexattr)(const char *path, const char *name);
+    /* S */ int (*opendir)(const char *path, struct fuse3_file_info *fi);
+    /* S */ int (*readdir)(const char *path, void *buf, fuse3_fill_dir_t filler, fuse_off_t off,
+        struct fuse3_file_info *fi, enum fuse3_readdir_flags);
+    /* S */ int (*releasedir)(const char *path, struct fuse3_file_info *fi);
+    /* S */ int (*fsyncdir)(const char *path, int datasync, struct fuse3_file_info *fi);
+    /* S */ void *(*init)(struct fuse3_conn_info *conn,
+        struct fuse3_config *conf);
+    /* S */ void (*destroy)(void *data);
+    /* _ */ int (*access)(const char *path, int mask);
+    /* S */ int (*create)(const char *path, fuse_mode_t mode, struct fuse3_file_info *fi);
+    /* _ */ int (*lock)(const char *path,
+        struct fuse3_file_info *fi, int cmd, struct fuse_flock *lock);
+    /* S */ int (*utimens)(const char *path, const struct fuse_timespec tv[2],
+        struct fuse3_file_info *fi);
+    /* _ */ int (*bmap)(const char *path, size_t blocksize, uint64_t *idx);
+    /* S */ int (*ioctl)(const char *path, int cmd, void *arg, struct fuse3_file_info *fi,
+        unsigned int flags, void *data);
+    /* _ */ int (*poll)(const char *path, struct fuse3_file_info *fi,
+        struct fuse3_pollhandle *ph, unsigned *reventsp);
+    /* _ */ int (*write_buf)(const char *path,
+        struct fuse3_bufvec *buf, fuse_off_t off, struct fuse3_file_info *fi);
+    /* _ */ int (*read_buf)(const char *path,
+        struct fuse3_bufvec **bufp, size_t size, fuse_off_t off, struct fuse3_file_info *fi);
+    /* _ */ int (*flock)(const char *path, struct fuse3_file_info *, int op);
+    /* _ */ int (*fallocate)(const char *path, int mode, fuse_off_t off, fuse_off_t len,
+        struct fuse3_file_info *fi);
+};
+
+struct fuse3_context
+{
+    struct fuse3 *fuse;
+    fuse_uid_t uid;
+    fuse_gid_t gid;
+    fuse_pid_t pid;
+    void *private_data;
+    fuse_mode_t umask;
+};
+
+#define fuse_main(argc, argv, ops, data)\
+    fuse3_main_real(argc, argv, ops, sizeof *(ops), data)
+
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse3_main_real)(struct fsp_fuse_env *env,
+    int argc, char *argv[],
+    const struct fuse3_operations *ops, size_t opsize, void *data);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse3_lib_help)(struct fsp_fuse_env *env,
+    struct fuse_args *args);
+FSP_FUSE_API struct fuse3 *FSP_FUSE_API_NAME(fsp_fuse3_new_30)(struct fsp_fuse_env *env,
+    struct fuse_args *args,
+    const struct fuse3_operations *ops, size_t opsize, void *data);
+FSP_FUSE_API struct fuse3 *FSP_FUSE_API_NAME(fsp_fuse3_new)(struct fsp_fuse_env *env,
+    struct fuse_args *args,
+    const struct fuse3_operations *ops, size_t opsize, void *data);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse3_destroy)(struct fsp_fuse_env *env,
+    struct fuse3 *f);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse3_mount)(struct fsp_fuse_env *env,
+    struct fuse3 *f, const char *mountpoint);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse3_unmount)(struct fsp_fuse_env *env,
+    struct fuse3 *f);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse3_loop)(struct fsp_fuse_env *env,
+    struct fuse3 *f);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse3_loop_mt_31)(struct fsp_fuse_env *env,
+    struct fuse3 *f, int clone_fd);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse3_loop_mt)(struct fsp_fuse_env *env,
+    struct fuse3 *f, struct fuse3_loop_config *config);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse3_exit)(struct fsp_fuse_env *env,
+    struct fuse3 *f);
+FSP_FUSE_API struct fuse3_context *FSP_FUSE_API_NAME(fsp_fuse3_get_context)(struct fsp_fuse_env *env);
+
+FSP_FUSE_SYM(
+int fuse3_main_real(int argc, char *argv[],
+    const struct fuse3_operations *ops, size_t opsize, void *data),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_main_real)
+        (fsp_fuse_env(), argc, argv, ops, opsize, data);
+})
+
+FSP_FUSE_SYM(
+void fuse3_lib_help(struct fuse_args *args),
+{
+    FSP_FUSE_API_CALL(fsp_fuse3_lib_help)
+        (fsp_fuse_env(), args);
+})
+
+#if FUSE_USE_VERSION == 30
+FSP_FUSE_SYM(
+struct fuse3 *fuse3_new_30(struct fuse_args *args,
+    const struct fuse3_operations *ops, size_t opsize, void *data),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_new_30)
+        (fsp_fuse_env(), args, ops, opsize, data);
+})
+#define fuse_new(args, op, size, data)\
+    fuse3_new_30(args, op, size, data)
+
+#else
+FSP_FUSE_SYM(
+struct fuse3 *fuse3_new(struct fuse_args *args,
+    const struct fuse3_operations *ops, size_t opsize, void *data),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_new)
+        (fsp_fuse_env(), args, ops, opsize, data);
+})
+#endif
+
+FSP_FUSE_SYM(
+void fuse3_destroy(struct fuse3 *f),
+{
+    FSP_FUSE_API_CALL(fsp_fuse3_destroy)
+        (fsp_fuse_env(), f);
+})
+
+FSP_FUSE_SYM(
+int fuse3_mount(struct fuse3 *f, const char *mountpoint),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_mount)
+        (fsp_fuse_env(), f, mountpoint);
+})
+
+FSP_FUSE_SYM(
+void fuse3_unmount(struct fuse3 *f),
+{
+    FSP_FUSE_API_CALL(fsp_fuse3_unmount)
+        (fsp_fuse_env(), f);
+})
+
+FSP_FUSE_SYM(
+int fuse3_loop(struct fuse3 *f),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_loop)
+        (fsp_fuse_env(), f);
+})
+
+#if FUSE_USE_VERSION < 32
+FSP_FUSE_SYM(
+int fuse3_loop_mt_31(struct fuse3 *f, int clone_fd),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_loop_mt_31)
+        (fsp_fuse_env(), f, clone_fd);
+})
+#define fuse_loop_mt(f, clone_fd)\
+    fuse3_loop_mt_31(f, clone_fd)
+
+#else
+FSP_FUSE_SYM(
+int fuse3_loop_mt(struct fuse3 *f, struct fuse3_loop_config *config),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_loop_mt)
+        (fsp_fuse_env(), f, config);
+})
+#endif
+
+FSP_FUSE_SYM(
+void fuse3_exit(struct fuse3 *f),
+{
+    FSP_FUSE_API_CALL(fsp_fuse3_exit)
+        (fsp_fuse_env(), f);
+})
+
+FSP_FUSE_SYM(
+struct fuse3_context *fuse3_get_context(void),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_get_context)
+        (fsp_fuse_env());
+})
+
+FSP_FUSE_SYM(
+int fuse3_getgroups(int size, fuse_gid_t list[]),
+{
+    (void)size;
+    (void)list;
+    return -ENOSYS;
+})
+
+FSP_FUSE_SYM(
+int fuse3_interrupted(void),
+{
+    return 0;
+})
+
+FSP_FUSE_SYM(
+int fuse3_invalidate_path(struct fuse3 *f, const char *path),
+{
+    (void)f;
+    (void)path;
+    return -ENOENT;
+})
+
+FSP_FUSE_SYM(
+int fuse3_notify_poll(struct fuse3_pollhandle *ph),
+{
+    (void)ph;
+    return 0;
+})
+
+FSP_FUSE_SYM(
+int fuse3_start_cleanup_thread(struct fuse3 *f),
+{
+    (void)f;
+    return 0;
+})
+
+FSP_FUSE_SYM(
+void fuse3_stop_cleanup_thread(struct fuse3 *f),
+{
+    (void)f;
+})
+
+FSP_FUSE_SYM(
+int fuse3_clean_cache(struct fuse3 *f),
+{
+    (void)f;
+    return 600;
+})
+
+FSP_FUSE_SYM(
+struct fuse3_session *fuse3_get_session(struct fuse3 *f),
+{
+    return (struct fuse3_session *)f;
+})
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/fuse3/fuse_common.h

@@ -0,0 +1,238 @@
+/**
+ * @file fuse3/fuse_common.h
+ * WinFsp FUSE3 compatible API.
+ *
+ * This file is derived from libfuse/include/fuse_common.h:
+ *     FUSE: Filesystem in Userspace
+ *     Copyright (C) 2001-2007  Miklos Szeredi <miklos@szeredi.hu>
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef FUSE_COMMON_H_
+#define FUSE_COMMON_H_
+
+#include "winfsp_fuse.h"
+#if !defined(WINFSP_DLL_INTERNAL)
+#include "fuse_opt.h"
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define FUSE_MAJOR_VERSION              3
+#define FUSE_MINOR_VERSION              2
+#define FUSE_MAKE_VERSION(maj, min)     ((maj) * 10 + (min))
+#define FUSE_VERSION                    FUSE_MAKE_VERSION(FUSE_MAJOR_VERSION, FUSE_MINOR_VERSION)
+
+#define FUSE_CAP_ASYNC_READ             (1 << 0)
+#define FUSE_CAP_POSIX_LOCKS            (1 << 1)
+#define FUSE_CAP_ATOMIC_O_TRUNC         (1 << 3)
+#define FUSE_CAP_EXPORT_SUPPORT         (1 << 4)
+#define FUSE_CAP_DONT_MASK              (1 << 6)
+#define FUSE_CAP_SPLICE_WRITE           (1 << 7)
+#define FUSE_CAP_SPLICE_MOVE            (1 << 8)
+#define FUSE_CAP_SPLICE_READ            (1 << 9)
+#define FUSE_CAP_FLOCK_LOCKS            (1 << 10)
+#define FUSE_CAP_IOCTL_DIR              (1 << 11)
+#define FUSE_CAP_AUTO_INVAL_DATA        (1 << 12)
+#define FUSE_CAP_READDIRPLUS            (1 << 13)
+#define FUSE_CAP_READDIRPLUS_AUTO       (1 << 14)
+#define FUSE_CAP_ASYNC_DIO              (1 << 15)
+#define FUSE_CAP_WRITEBACK_CACHE        (1 << 16)
+#define FUSE_CAP_NO_OPEN_SUPPORT        (1 << 17)
+#define FUSE_CAP_PARALLEL_DIROPS        (1 << 18)
+#define FUSE_CAP_POSIX_ACL              (1 << 19)
+#define FUSE_CAP_HANDLE_KILLPRIV        (1 << 20)
+#define FUSE_CAP_ALLOCATE               (1 << 27)   /* reserved (OSXFUSE) */
+#define FUSE_CAP_EXCHANGE_DATA          (1 << 28)   /* reserved (OSXFUSE) */
+#define FUSE_CAP_CASE_INSENSITIVE       (1 << 29)   /* file system is case insensitive */
+#define FUSE_CAP_VOL_RENAME             (1 << 30)   /* reserved (OSXFUSE) */
+#define FUSE_CAP_XTIMES                 (1 << 31)   /* reserved (OSXFUSE) */
+
+#define FSP_FUSE_CAP_CASE_INSENSITIVE   FUSE_CAP_CASE_INSENSITIVE
+
+#define FUSE_IOCTL_COMPAT               (1 << 0)
+#define FUSE_IOCTL_UNRESTRICTED         (1 << 1)
+#define FUSE_IOCTL_RETRY                (1 << 2)
+#define FUSE_IOCTL_DIR                  (1 << 4)
+#define FUSE_IOCTL_MAX_IOV              256
+
+#define FUSE_BUFVEC_INIT(s)             \
+    ((struct fuse3_bufvec){ 1, 0, 0, { {s, (enum fuse3_buf_flags)0, 0, -1, 0} } })
+
+struct fuse3_file_info
+{
+    int flags;
+    unsigned int writepage:1;
+    unsigned int direct_io:1;
+    unsigned int keep_cache:1;
+    unsigned int flush:1;
+    unsigned int nonseekable:1;
+    unsigned int flock_release:1;
+    unsigned int padding:27;
+    uint64_t fh;
+    uint64_t lock_owner;
+    uint32_t poll_events;
+};
+
+struct fuse3_loop_config
+{
+    int clone_fd;
+    unsigned int max_idle_threads;
+};
+
+struct fuse3_conn_info
+{
+    unsigned proto_major;
+    unsigned proto_minor;
+    unsigned max_write;
+    unsigned max_read;
+    unsigned max_readahead;
+    unsigned capable;
+    unsigned want;
+    unsigned max_background;
+    unsigned congestion_threshold;
+    unsigned time_gran;
+    unsigned reserved[22];
+};
+
+enum fuse3_buf_flags
+{
+    FUSE_BUF_IS_FD                      = (1 << 1),
+    FUSE_BUF_FD_SEEK                    = (1 << 2),
+    FUSE_BUF_FD_RETRY                   = (1 << 3),
+};
+
+enum fuse3_buf_copy_flags
+{
+    FUSE_BUF_NO_SPLICE                  = (1 << 1),
+    FUSE_BUF_FORCE_SPLICE               = (1 << 2),
+    FUSE_BUF_SPLICE_MOVE                = (1 << 3),
+    FUSE_BUF_SPLICE_NONBLOCK            = (1 << 4),
+};
+
+struct fuse3_buf
+{
+    size_t size;
+    enum fuse3_buf_flags flags;
+    void *mem;
+    int fd;
+    fuse_off_t pos;
+};
+
+struct fuse3_bufvec
+{
+    size_t count;
+    size_t idx;
+    size_t off;
+    struct fuse3_buf buf[1];
+};
+
+struct fuse3_session;
+struct fuse3_pollhandle;
+struct fuse3_conn_info_opts;
+
+FSP_FUSE_API struct fuse3_conn_info_opts *FSP_FUSE_API_NAME(fsp_fuse3_parse_conn_info_opts)(
+    struct fsp_fuse_env *env,
+    struct fuse_args *args);
+FSP_FUSE_API void FSP_FUSE_API_NAME(fsp_fuse3_apply_conn_info_opts)(struct fsp_fuse_env *env,
+    struct fuse3_conn_info_opts *opts, struct fuse3_conn_info *conn);
+FSP_FUSE_API int FSP_FUSE_API_NAME(fsp_fuse3_version)(struct fsp_fuse_env *env);
+FSP_FUSE_API const char *FSP_FUSE_API_NAME(fsp_fuse3_pkgversion)(struct fsp_fuse_env *env);
+FSP_FUSE_API int32_t FSP_FUSE_API_NAME(fsp_fuse_ntstatus_from_errno)(struct fsp_fuse_env *env,
+    int err);
+
+FSP_FUSE_SYM(
+struct fuse3_conn_info_opts* fuse3_parse_conn_info_opts(
+    struct fuse_args *args),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_parse_conn_info_opts)
+        (fsp_fuse_env(), args);
+})
+
+FSP_FUSE_SYM(
+void fuse3_apply_conn_info_opts(
+    struct fuse3_conn_info_opts *opts, struct fuse3_conn_info *conn),
+{
+    FSP_FUSE_API_CALL(fsp_fuse3_apply_conn_info_opts)
+        (fsp_fuse_env(), opts, conn);
+})
+
+FSP_FUSE_SYM(
+int fuse3_version(void),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_version)
+        (fsp_fuse_env());
+})
+
+FSP_FUSE_SYM(
+const char *fuse3_pkgversion(void),
+{
+    return FSP_FUSE_API_CALL(fsp_fuse3_pkgversion)
+        (fsp_fuse_env());
+})
+
+FSP_FUSE_SYM(
+void fuse3_pollhandle_destroy(struct fuse3_pollhandle *ph),
+{
+    (void)ph;
+})
+
+FSP_FUSE_SYM(
+size_t fuse3_buf_size(const struct fuse3_bufvec *bufv),
+{
+    (void)bufv;
+    return 0;
+})
+
+FSP_FUSE_SYM(
+ssize_t fuse3_buf_copy(struct fuse3_bufvec *dst, struct fuse3_bufvec *src,
+    enum fuse3_buf_copy_flags flags),
+{
+    (void)dst;
+    (void)src;
+    (void)flags;
+    return 0;
+})
+
+FSP_FUSE_SYM(
+int fuse3_daemonize(int foreground),
+{
+    return fsp_fuse_daemonize(foreground);
+})
+
+FSP_FUSE_SYM(
+int fuse3_set_signal_handlers(struct fuse3_session *se),
+{
+    return fsp_fuse_set_signal_handlers(se);
+})
+
+FSP_FUSE_SYM(
+void fuse3_remove_signal_handlers(struct fuse3_session *se),
+{
+    (void)se;
+    fsp_fuse_set_signal_handlers(0);
+})
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/fuse3/fuse_opt.h

@@ -0,0 +1,23 @@
+/**
+ * @file fuse3/fuse_opt.h
+ * WinFsp FUSE3 compatible API.
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#include "../fuse/fuse_opt.h"

support/3rd_party/winfsp-2.0/inc/fuse3/winfsp_fuse.h

@@ -0,0 +1,82 @@
+/**
+ * @file fuse3/winfsp_fuse.h
+ * WinFsp FUSE3 compatible API.
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef FUSE3_WINFSP_FUSE_H_INCLUDED
+#define FUSE3_WINFSP_FUSE_H_INCLUDED
+
+#include "../fuse/winfsp_fuse.h"
+
+#if defined(_WIN64) || defined(_WIN32)
+typedef intptr_t ssize_t;
+#endif
+
+#if !defined(WINFSP_DLL_INTERNAL)
+#define fuse3                           fuse
+#define fuse3_apply_conn_info_opts      fuse_apply_conn_info_opts
+#define fuse3_buf                       fuse_buf
+#define fuse3_buf_copy                  fuse_buf_copy
+#define fuse3_buf_copy_flags            fuse_buf_copy_flags
+#define fuse3_buf_flags                 fuse_buf_flags
+#define fuse3_buf_size                  fuse_buf_size
+#define fuse3_bufvec                    fuse_bufvec
+#define fuse3_clean_cache               fuse_clean_cache
+#define fuse3_config                    fuse_config
+#define fuse3_conn_info                 fuse_conn_info
+#define fuse3_conn_info_opts            fuse_conn_info_opts
+#define fuse3_context                   fuse_context
+#define fuse3_daemonize                 fuse_daemonize
+#define fuse3_destroy                   fuse_destroy
+#define fuse3_exit                      fuse_exit
+#define fuse3_file_info                 fuse_file_info
+#define fuse3_fill_dir_flags            fuse_fill_dir_flags
+#define fuse3_fill_dir_t                fuse_fill_dir_t
+#define fuse3_get_context               fuse_get_context
+#define fuse3_get_session               fuse_get_session
+#define fuse3_getgroups                 fuse_getgroups
+#define fuse3_interrupted               fuse_interrupted
+#define fuse3_invalidate_path           fuse_invalidate_path
+#define fuse3_lib_help                  fuse_lib_help
+#define fuse3_loop                      fuse_loop
+#define fuse3_loop_config               fuse_loop_config
+#define fuse3_loop_mt                   fuse_loop_mt
+#define fuse3_loop_mt_31                fuse_loop_mt_31
+#define fuse3_main_real                 fuse_main_real
+#define fuse3_mount                     fuse_mount
+#define fuse3_new                       fuse_new
+#define fuse3_new_30                    fuse_new_30
+#define fuse3_notify_poll               fuse_notify_poll
+#define fuse3_operations                fuse_operations
+#define fuse3_parse_conn_info_opts      fuse_parse_conn_info_opts
+#define fuse3_pkgversion                fuse_pkgversion
+#define fuse3_pollhandle                fuse_pollhandle
+#define fuse3_pollhandle_destroy        fuse_pollhandle_destroy
+#define fuse3_readdir_flags             fuse_readdir_flags
+#define fuse3_remove_signal_handlers    fuse_remove_signal_handlers
+#define fuse3_session                   fuse_session
+#define fuse3_set_signal_handlers       fuse_set_signal_handlers
+#define fuse3_start_cleanup_thread      fuse_start_cleanup_thread
+#define fuse3_stop_cleanup_thread       fuse_stop_cleanup_thread
+#define fuse3_unmount                   fuse_unmount
+#define fuse3_version                   fuse_version
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/winfsp/fsctl.h

@@ -0,0 +1,839 @@
+/**
+ * @file winfsp/fsctl.h
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef WINFSP_FSCTL_H_INCLUDED
+#define WINFSP_FSCTL_H_INCLUDED
+
+#include <devioctl.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* static_assert is a C++11 feature, but seems to work with C on MSVC 2015 */
+#if defined(WINFSP_SYS_INTERNAL) || defined(WINFSP_DLL_INTERNAL)
+#define FSP_FSCTL_STATIC_ASSERT(e, m) static_assert(e, m)
+#else
+#define FSP_FSCTL_STATIC_ASSERT(e, m) static_assert(1, "")
+#endif
+
+#define FSP_FSCTL_STR(x) FSP_FSCTL_STR_(x)
+#define FSP_FSCTL_STR_(x) #x
+#if defined(MyProductName)
+#define FSP_FSCTL_PRODUCT_NAME FSP_FSCTL_STR(MyProductName)
+#else
+#define FSP_FSCTL_PRODUCT_NAME "WinFsp"
+#endif
+#if defined(MyProductFileName)
+#define FSP_FSCTL_PRODUCT_FILE_NAME FSP_FSCTL_STR(MyProductFileName)
+#else
+#define FSP_FSCTL_PRODUCT_FILE_NAME "winfsp"
+#endif
+
+#define FSP_FSCTL_DRIVER_NAME FSP_FSCTL_PRODUCT_NAME
+#define FSP_FSCTL_DISK_DEVICE_NAME FSP_FSCTL_DRIVER_NAME ".Disk"
+#define FSP_FSCTL_NET_DEVICE_NAME FSP_FSCTL_DRIVER_NAME ".Net"
+#define FSP_FSCTL_MUP_DEVICE_NAME FSP_FSCTL_DRIVER_NAME ".Mup"
+
+#if defined(MyFspFsctlDeviceClassGuid)
+extern const __declspec(selectany) GUID FspFsctlDeviceClassGuid =
+    MyFspFsctlDeviceClassGuid;
+#else
+extern const __declspec(selectany) GUID FspFsctlDeviceClassGuid = {
+    0x6f9d25fa,
+    0x6dee,
+    0x4a9d,
+    {0x80, 0xf5, 0xe9, 0x8e, 0x14, 0xf3, 0x5e, 0x54}};
+#endif
+#if defined(MyFspFsvrtDeviceClassGuid)
+extern const __declspec(selectany) GUID FspFsvrtDeviceClassGuid =
+    MyFspFsvrtDeviceClassGuid;
+#else
+extern const __declspec(selectany) GUID FspFsvrtDeviceClassGuid = {
+    0xb48171c3,
+    0xdd50,
+    0x4852,
+    {0x83, 0xa3, 0x34, 0x4c, 0x50, 0xd9, 0x3b, 0x17}};
+#endif
+
+/* locations */
+#define FSP_FSCTL_PRODUCT_REGKEY "Software\\" FSP_FSCTL_PRODUCT_NAME
+#define FSP_FSCTL_PRODUCT_REGKEY_WOW64 KEY_WOW64_32KEY
+#if defined(_ARM64_)
+#define FSP_FSCTL_PRODUCT_FULL_REGKEY                                          \
+  "Software\\WOW6432Node\\" FSP_FSCTL_PRODUCT_NAME
+#define FSP_FSCTL_PRODUCT_FILE_ARCH "a64"
+#elif defined(_AMD64_)
+#define FSP_FSCTL_PRODUCT_FULL_REGKEY                                          \
+  "Software\\WOW6432Node\\" FSP_FSCTL_PRODUCT_NAME
+#define FSP_FSCTL_PRODUCT_FILE_ARCH "x64"
+#elif defined(_X86_)
+#define FSP_FSCTL_PRODUCT_FULL_REGKEY "Software\\" FSP_FSCTL_PRODUCT_NAME
+#define FSP_FSCTL_PRODUCT_FILE_ARCH "x86"
+#else
+#error unknown architecture
+#endif
+
+/* alignment macros */
+#define FSP_FSCTL_ALIGN_UP(x, s) (((x) + ((s)-1L)) & ~((s)-1L))
+#define FSP_FSCTL_DEFAULT_ALIGNMENT 8
+#define FSP_FSCTL_DEFAULT_ALIGN_UP(x)                                          \
+  FSP_FSCTL_ALIGN_UP(x, FSP_FSCTL_DEFAULT_ALIGNMENT)
+#define FSP_FSCTL_DECLSPEC_ALIGN __declspec(align(FSP_FSCTL_DEFAULT_ALIGNMENT))
+
+/* fsctl device codes */
+#define FSP_FSCTL_MOUNTDEV                                                     \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'M', METHOD_BUFFERED,              \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_MOUNTMGR                                                     \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'm', METHOD_BUFFERED,              \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_VOLUME_NAME                                                  \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'N', METHOD_BUFFERED,              \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_VOLUME_LIST                                                  \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'L', METHOD_BUFFERED,              \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_TRANSACT                                                     \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'T', METHOD_BUFFERED,              \
+           FILE_ANY_ACCESS)
+#define FSP_IOCTL_TRANSACT                                                     \
+  CTL_CODE(0x8000 | ('F' << 8) | 'W', 0x800 + 'T', METHOD_BUFFERED,            \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_TRANSACT_BATCH                                               \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 't', METHOD_OUT_DIRECT,            \
+           FILE_ANY_ACCESS)
+#define FSP_IOCTL_TRANSACT_BATCH                                               \
+  CTL_CODE(0x8000 | ('F' << 8) | 'W', 0x800 + 't', METHOD_BUFFERED,            \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_STOP                                                         \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'S', METHOD_BUFFERED,              \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_STOP0                                                        \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 's', METHOD_BUFFERED,              \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_NOTIFY                                                       \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'n', METHOD_NEITHER,               \
+           FILE_ANY_ACCESS)
+#define FSP_FSCTL_UNLOAD                                                       \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'U', METHOD_NEITHER,               \
+           FILE_ANY_ACCESS)
+
+/* fsctl internal device codes (usable only in-kernel) */
+#define FSP_FSCTL_TRANSACT_INTERNAL                                            \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + 'I', METHOD_NEITHER,               \
+           FILE_ANY_ACCESS)
+#define FSP_IOCTL_TRANSACT_INTERNAL                                            \
+  CTL_CODE(0x8000 | ('F' << 8) | 'W', 0x800 + 'I', METHOD_BUFFERED,            \
+           FILE_ANY_ACCESS)
+
+/* fsvol device codes */
+#define FSP_FSCTL_QUERY_WINFSP                                                 \
+  CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 0x800 + '?', METHOD_BUFFERED,              \
+           FILE_ANY_ACCESS)
+
+#define FSP_FSCTL_VOLUME_PARAMS_PREFIX "\\VolumeParams="
+
+#define FSP_FSCTL_VOLUME_NAME_SIZE (64 * sizeof(WCHAR))
+#define FSP_FSCTL_VOLUME_PREFIX_SIZE (192 * sizeof(WCHAR))
+#define FSP_FSCTL_VOLUME_FSNAME_SIZE (16 * sizeof(WCHAR))
+#define FSP_FSCTL_VOLUME_NAME_SIZEMAX                                          \
+  (FSP_FSCTL_VOLUME_NAME_SIZE + FSP_FSCTL_VOLUME_PREFIX_SIZE)
+FSP_FSCTL_STATIC_ASSERT(FSP_FSCTL_VOLUME_NAME_SIZEMAX <= 260 * sizeof(WCHAR),
+                        "Max volume name size is greater than MAX_PATH.");
+
+#define FSP_FSCTL_TRANSACT_PATH_SIZEMAX (1024 * sizeof(WCHAR))
+
+#define FSP_FSCTL_TRANSACT_REQ_SIZEMAX                                         \
+  (16 * 1024 - 64) /* 64: size for internal request header */
+#define FSP_FSCTL_TRANSACT_RSP_SIZEMAX (16 * 1024)
+#define FSP_FSCTL_TRANSACT_REQ_BUFFER_SIZEMAX                                  \
+  (FSP_FSCTL_TRANSACT_REQ_SIZEMAX - sizeof(FSP_FSCTL_TRANSACT_REQ))
+#define FSP_FSCTL_TRANSACT_RSP_BUFFER_SIZEMAX                                  \
+  (FSP_FSCTL_TRANSACT_RSP_SIZEMAX - sizeof(FSP_FSCTL_TRANSACT_RSP))
+#define FSP_FSCTL_TRANSACT_BATCH_BUFFER_SIZEMIN (64 * 1024)
+#define FSP_FSCTL_TRANSACT_BUFFER_SIZEMIN FSP_FSCTL_TRANSACT_REQ_SIZEMAX
+
+#define FSP_FSCTL_TRANSACT_REQ_TOKEN_HANDLE(T)                                 \
+  ((HANDLE)((UINT_PTR)((T) & 0xffffffff)))
+#define FSP_FSCTL_TRANSACT_REQ_TOKEN_PID(T) ((UINT32)(((T) >> 32) & 0xffffffff))
+
+#define FSP_FSCTL_DEVICECONTROL_SIZEMAX                                        \
+  (4 * 1024) /* must be < FSP_FSCTL_TRANSACT_{REQ,RSP}_SIZEMAX */
+
+/* marshalling */
+#pragma warning(push)
+#pragma warning(disable : 4200 4201) /* zero-sized array in struct/union;      \
+                                        nameless struct/union */
+enum {
+  FspFsctlTransactReservedKind = 0,
+  FspFsctlTransactCreateKind,
+  FspFsctlTransactOverwriteKind,
+  FspFsctlTransactCleanupKind,
+  FspFsctlTransactCloseKind,
+  FspFsctlTransactReadKind,
+  FspFsctlTransactWriteKind,
+  FspFsctlTransactQueryInformationKind,
+  FspFsctlTransactSetInformationKind,
+  FspFsctlTransactQueryEaKind,
+  FspFsctlTransactSetEaKind,
+  FspFsctlTransactFlushBuffersKind,
+  FspFsctlTransactQueryVolumeInformationKind,
+  FspFsctlTransactSetVolumeInformationKind,
+  FspFsctlTransactQueryDirectoryKind,
+  FspFsctlTransactFileSystemControlKind,
+  FspFsctlTransactDeviceControlKind,
+  FspFsctlTransactShutdownKind,
+  FspFsctlTransactLockControlKind,
+  FspFsctlTransactQuerySecurityKind,
+  FspFsctlTransactSetSecurityKind,
+  FspFsctlTransactQueryStreamInformationKind,
+  FspFsctlTransactKindCount,
+};
+enum {
+  FspFsctlTransactTimeoutMinimum = 1000,
+  FspFsctlTransactTimeoutMaximum = 10000,
+  FspFsctlTransactTimeoutDefault =
+      1000, /* DEPRECATED: default is unspecified */
+  FspFsctlIrpTimeoutMinimum = 60000,
+  FspFsctlIrpTimeoutMaximum = 600000,
+  FspFsctlIrpTimeoutDefault = 300000,
+  FspFsctlIrpTimeoutDebug = 142, /* special value for IRP timeout testing */
+  FspFsctlIrpCapacityMinimum = 100,
+  FspFsctlIrpCapacityMaximum = 1000,
+  FspFsctlIrpCapacityDefault = 1000,
+};
+#define FSP_FSCTL_VOLUME_PARAMS_V0_FIELD_DEFN                                  \
+  UINT16 Version; /* set to 0 or sizeof(FSP_FSCTL_VOLUME_PARAMS) */            \
+  /* volume information */                                                     \
+  UINT16 SectorSize;                                                           \
+  UINT16 SectorsPerAllocationUnit;                                             \
+  UINT16 MaxComponentLength; /* maximum file name component length (bytes) */  \
+  UINT64 VolumeCreationTime;                                                   \
+  UINT32 VolumeSerialNumber;                                                   \
+  /* I/O timeouts, capacity, etc. */                                           \
+  UINT32 TransactTimeout; /* DEPRECATED: (millis; 1 sec - 10 sec) */           \
+  UINT32 IrpTimeout;      /* pending IRP timeout (millis; 1 min - 10 min) */   \
+  UINT32 IrpCapacity;     /* maximum number of pending IRP's (100 - 1000)*/    \
+  UINT32 FileInfoTimeout; /* FileInfo/Security/VolumeInfo timeout (millis) */  \
+  /* FILE_FS_ATTRIBUTE_INFORMATION::FileSystemAttributes */                    \
+  UINT32 CaseSensitiveSearch : 1; /* file system supports case-sensitive file  \
+                                     names */                                  \
+  UINT32 CasePreservedNames : 1;  /* file system preserves the case of file    \
+                                     names */                                  \
+  UINT32 UnicodeOnDisk : 1;  /* file system supports Unicode in file names */  \
+  UINT32 PersistentAcls : 1; /* file system preserves and enforces access      \
+                                control lists */                               \
+  UINT32 ReparsePoints : 1;  /* file system supports reparse points */         \
+  UINT32 ReparsePointsAccessCheck : 1; /* file system performs reparse point   \
+                                          access checks */                     \
+  UINT32 NamedStreams : 1; /* file system supports named streams */            \
+  UINT32 HardLinks : 1;    /* unimplemented; set to 0 */                       \
+  UINT32                                                                       \
+  ExtendedAttributes:                                                          \
+  1; /* file system supports extended attributes */                            \
+  UINT32 ReadOnlyVolume : 1;                                                   \
+  /* kernel-mode flags */                                                      \
+  UINT32 PostCleanupWhenModifiedOnly : 1; /* post Cleanup when a file was      \
+                                             modified/deleted */               \
+  UINT32 PassQueryDirectoryPattern : 1; /* pass Pattern during QueryDirectory  \
+                                           operations */                       \
+  UINT32 AlwaysUseDoubleBuffering : 1;                                         \
+  UINT32                                                                       \
+  PassQueryDirectoryFileName:                                                  \
+  1;                                 /* pass FileName during QueryDirectory    \
+                                        (GetDirInfoByName) */                  \
+  UINT32 FlushAndPurgeOnCleanup : 1; /* keeps file off "standby" list */       \
+  UINT32 DeviceControl : 1;          /* support user-mode ioctl handling */    \
+  /* user-mode flags */                                                        \
+  UINT32 UmFileContextIsUserContext2 : 1; /* user mode: FileContext parameter  \
+                                             is UserContext2 */                \
+  UINT32 UmFileContextIsFullContext : 1;  /* user mode: FileContext parameter  \
+                                             is FullContext */                 \
+  UINT32 UmNoReparsePointsDirCheck : 1; /* user mode: no dir option check for  \
+                                           reparse points */                   \
+  UINT32 UmReservedFlags : 5;                                                  \
+  /* additional kernel-mode flags */                                           \
+  UINT32 AllowOpenInKernelMode : 1; /* allow kernel mode to open files when    \
+                                       possible */                             \
+  UINT32 CasePreservedExtendedAttributes : 1; /* preserve case of EA (default  \
+                                                 is UPPERCASE) */              \
+  UINT32 WslFeatures : 1; /* support features required for WSLinux */          \
+  UINT32 DirectoryMarkerAsNextOffset : 1; /* directory marker is next offset   \
+                                             instead of last name */           \
+  UINT32 RejectIrpPriorToTransact0 : 1;   /* DEPRECATED: reject IRP's prior to \
+                                             FspFsctlTransact0 */              \
+  UINT32 SupportsPosixUnlinkRename : 1;   /* file system supports POSIX-style  \
+                                             unlink and rename */              \
+  UINT32 PostDispositionWhenNecessaryOnly : 1; /* post Disposition for dirs or \
+                                                  READONLY attr check */       \
+  UINT32 KmReservedFlags : 1;                                                  \
+  WCHAR Prefix[FSP_FSCTL_VOLUME_PREFIX_SIZE /                                  \
+               sizeof(WCHAR)]; /* UNC prefix (\Server\Share) */                \
+  WCHAR FileSystemName[FSP_FSCTL_VOLUME_FSNAME_SIZE / sizeof(WCHAR)];
+#define FSP_FSCTL_VOLUME_PARAMS_V1_FIELD_DEFN                                  \
+  /* additional fields; specify .Version == sizeof(FSP_FSCTL_VOLUME_PARAMS) */ \
+  UINT32 VolumeInfoTimeoutValid : 1; /* VolumeInfoTimeout field is valid */    \
+  UINT32 DirInfoTimeoutValid : 1;    /* DirInfoTimeout field is valid */       \
+  UINT32 SecurityTimeoutValid : 1;   /* SecurityTimeout field is valid*/       \
+  UINT32 StreamInfoTimeoutValid : 1; /* StreamInfoTimeout field is valid */    \
+  UINT32 EaTimeoutValid : 1;         /* EaTimeout field is valid */            \
+  UINT32 KmAdditionalReservedFlags : 27;                                       \
+  UINT32 VolumeInfoTimeout; /* volume info timeout (millis); overrides         \
+                               FileInfoTimeout */                              \
+  UINT32 DirInfoTimeout;    /* dir info timeout (millis); overrides            \
+                               FileInfoTimeout */                              \
+  UINT32 SecurityTimeout;   /* security info timeout (millis); overrides       \
+                               FileInfoTimeout */                              \
+  UINT32 StreamInfoTimeout; /* stream info timeout (millis); overrides         \
+                               FileInfoTimeout */                              \
+  UINT32 EaTimeout; /* EA timeout (millis); overrides FileInfoTimeout */       \
+  UINT32 FsextControlCode;                                                     \
+  UINT32 Reserved32[1];                                                        \
+  UINT64 Reserved64[2];
+typedef struct {
+  FSP_FSCTL_VOLUME_PARAMS_V0_FIELD_DEFN
+} FSP_FSCTL_VOLUME_PARAMS_V0;
+FSP_FSCTL_STATIC_ASSERT(
+    456 == sizeof(FSP_FSCTL_VOLUME_PARAMS_V0),
+    "sizeof(FSP_FSCTL_VOLUME_PARAMS_V0) must be exactly 456.");
+typedef struct {
+  FSP_FSCTL_VOLUME_PARAMS_V0_FIELD_DEFN
+  FSP_FSCTL_VOLUME_PARAMS_V1_FIELD_DEFN
+} FSP_FSCTL_VOLUME_PARAMS;
+FSP_FSCTL_STATIC_ASSERT(504 == sizeof(FSP_FSCTL_VOLUME_PARAMS),
+                        "sizeof(FSP_FSCTL_VOLUME_PARAMS) is currently 504. "
+                        "Update this assertion check if it changes.");
+typedef struct {
+  UINT64 TotalSize;
+  UINT64 FreeSize;
+  UINT16 VolumeLabelLength;
+  WCHAR VolumeLabel[32];
+} FSP_FSCTL_VOLUME_INFO;
+FSP_FSCTL_STATIC_ASSERT(88 == sizeof(FSP_FSCTL_VOLUME_INFO),
+                        "sizeof(FSP_FSCTL_VOLUME_INFO) must be exactly 88.");
+typedef struct {
+  UINT32 FileAttributes;
+  UINT32 ReparseTag;
+  UINT64 AllocationSize;
+  UINT64 FileSize;
+  UINT64 CreationTime;
+  UINT64 LastAccessTime;
+  UINT64 LastWriteTime;
+  UINT64 ChangeTime;
+  UINT64 IndexNumber;
+  UINT32 HardLinks; /* unimplemented: set to 0 */
+  UINT32 EaSize;
+} FSP_FSCTL_FILE_INFO;
+FSP_FSCTL_STATIC_ASSERT(72 == sizeof(FSP_FSCTL_FILE_INFO),
+                        "sizeof(FSP_FSCTL_FILE_INFO) must be exactly 72.");
+typedef struct {
+  FSP_FSCTL_FILE_INFO FileInfo;
+  PWSTR NormalizedName;
+  UINT16 NormalizedNameSize;
+} FSP_FSCTL_OPEN_FILE_INFO;
+typedef struct {
+  UINT16 Size;
+  FSP_FSCTL_FILE_INFO FileInfo;
+  union {
+    UINT64 NextOffset;
+    UINT8 Padding[24];
+    /* make struct as big as FILE_ID_BOTH_DIR_INFORMATION; allows for in-place
+     * copying */
+  } DUMMYUNIONNAME;
+  WCHAR FileNameBuf[];
+} FSP_FSCTL_DIR_INFO;
+FSP_FSCTL_STATIC_ASSERT(104 == sizeof(FSP_FSCTL_DIR_INFO),
+                        "sizeof(FSP_FSCTL_DIR_INFO) must be exactly 104.");
+typedef struct {
+  UINT16 Size;
+  UINT64 StreamSize;
+  UINT64 StreamAllocationSize;
+  WCHAR StreamNameBuf[];
+} FSP_FSCTL_STREAM_INFO;
+FSP_FSCTL_STATIC_ASSERT(24 == sizeof(FSP_FSCTL_STREAM_INFO),
+                        "sizeof(FSP_FSCTL_STREAM_INFO) must be exactly 24.");
+typedef struct {
+  UINT16 Size;
+  UINT32 Filter;
+  UINT32 Action;
+  WCHAR FileNameBuf[];
+} FSP_FSCTL_NOTIFY_INFO;
+FSP_FSCTL_STATIC_ASSERT(12 == sizeof(FSP_FSCTL_NOTIFY_INFO),
+                        "sizeof(FSP_FSCTL_NOTIFY_INFO) must be exactly 12.");
+typedef struct {
+  UINT64 UserContext;
+  UINT64 UserContext2;
+} FSP_FSCTL_TRANSACT_FULL_CONTEXT;
+typedef struct {
+  UINT16 Offset;
+  UINT16 Size;
+} FSP_FSCTL_TRANSACT_BUF;
+typedef struct {
+  UINT16 Version;
+  UINT16 Size;
+  UINT32 Kind;
+  UINT64 Hint;
+  union {
+    struct {
+      UINT32 CreateOptions; /* Disposition: high 8 bits; Options: low 24 bits */
+      UINT32 FileAttributes; /* file attributes for new files */
+      FSP_FSCTL_TRANSACT_BUF
+      SecurityDescriptor;    /* security descriptor for new files */
+      UINT64 AllocationSize; /* initial allocation size */
+      UINT64 AccessToken;    /* request access token (PID,HANDLE) */
+      UINT32 DesiredAccess;  /* FILE_{READ_DATA,WRITE_DATA,etc.} */
+      UINT32 GrantedAccess;  /* FILE_{READ_DATA,WRITE_DATA,etc.} */
+      UINT32 ShareAccess;    /* FILE_SHARE_{READ,WRITE,DELETE} */
+      FSP_FSCTL_TRANSACT_BUF
+      Ea;                  /* extended attributes or reparse point buffer */
+      UINT32 UserMode : 1; /* request originated in user mode */
+      UINT32 HasTraversePrivilege : 1; /* requestor has
+                                          TOKEN_HAS_TRAVERSE_PRIVILEGE */
+      UINT32
+      HasBackupPrivilege : 1; /* requestor has TOKEN_HAS_BACKUP_PRIVILEGE */
+      UINT32 HasRestorePrivilege : 1; /* requestor has
+                                         TOKEN_HAS_RESTORE_PRIVILEGE */
+      UINT32 OpenTargetDirectory : 1; /* open target dir and report
+                                         FILE_{EXISTS,DOES_NOT_EXIST} */
+      UINT32
+      CaseSensitive : 1; /* FileName comparisons should be case-sensitive */
+      UINT32 HasTrailingBackslash : 1; /* FileName had trailing backslash */
+      UINT32 AcceptsSecurityDescriptor : 1;
+      UINT32 EaIsReparsePoint : 1; /* Ea buffer is reparse point */
+      UINT32 ReservedFlags : 24;
+      UINT16 NamedStream; /* request targets named stream; colon offset in
+                             FileName */
+    } Create;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT32
+      FileAttributes; /* file attributes for overwritten/superseded files */
+      UINT64
+      AllocationSize; /* allocation size for overwritten/superseded files */
+      UINT32 Supersede : 1; /* 0: FILE_OVERWRITE operation, 1: FILE_SUPERSEDE
+                               operation */
+      FSP_FSCTL_TRANSACT_BUF Ea; /* extended attributes buffer */
+    } Overwrite;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT32 Delete : 1; /* file must be deleted */
+      UINT32 SetAllocationSize : 1;
+      UINT32 SetArchiveBit : 1;
+      UINT32 SetLastAccessTime : 1;
+      UINT32 SetLastWriteTime : 1;
+      UINT32 SetChangeTime : 1;
+    } Cleanup;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+    } Close;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT64 Address;
+      UINT64 Offset;
+      UINT32 Length;
+      UINT32 Key;
+    } Read;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT64 Address;
+      UINT64 Offset;
+      UINT32 Length;
+      UINT32 Key;
+      UINT32 ConstrainedIo : 1;
+    } Write;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+    } QueryInformation;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT32 FileInformationClass;
+      union {
+        struct {
+          UINT64 AllocationSize;
+        } Allocation;
+        struct {
+          UINT32 FileAttributes;
+          UINT64 CreationTime;
+          UINT64 LastAccessTime;
+          UINT64 LastWriteTime;
+          UINT64 ChangeTime;
+        } Basic;
+        struct {
+          UINT32 Delete : 1;
+        } Disposition;
+        struct {
+          UINT32 Flags;
+        } DispositionEx;
+        struct {
+          UINT64 FileSize;
+        } EndOfFile;
+        struct {
+          FSP_FSCTL_TRANSACT_BUF NewFileName;
+          UINT64 AccessToken; /* request access token (PID,HANDLE) */
+        } Rename;
+        struct {
+          FSP_FSCTL_TRANSACT_BUF NewFileName;
+          UINT64 AccessToken; /* request access token (PID,HANDLE) */
+          UINT32 Flags;
+        } RenameEx;
+      } Info;
+    } SetInformation;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+    } QueryEa;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      FSP_FSCTL_TRANSACT_BUF Ea;
+    } SetEa;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+    } FlushBuffers;
+    struct {
+      UINT32 FsInformationClass;
+      union {
+        struct {
+          FSP_FSCTL_TRANSACT_BUF VolumeLabel;
+        } Label;
+      } Info;
+    } SetVolumeInformation;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT64 Address;
+      UINT32 Length;
+      FSP_FSCTL_TRANSACT_BUF Pattern;
+      FSP_FSCTL_TRANSACT_BUF Marker;
+      UINT32
+      CaseSensitive : 1; /* FileName comparisons should be case-sensitive */
+      UINT32 PatternIsFileName : 1; /* Pattern does not contain wildcards */
+    } QueryDirectory;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT32 FsControlCode;
+      FSP_FSCTL_TRANSACT_BUF Buffer;
+      UINT16 TargetOnFileSystem; /* the target of the symbolic link is on this
+                                    file system */
+    } FileSystemControl;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT32 IoControlCode;
+      FSP_FSCTL_TRANSACT_BUF Buffer;
+      UINT32 OutputLength;
+    } DeviceControl;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+    } QuerySecurity;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+      UINT32 SecurityInformation;
+      FSP_FSCTL_TRANSACT_BUF SecurityDescriptor;
+    } SetSecurity;
+    struct {
+      UINT64 UserContext;
+      UINT64 UserContext2;
+    } QueryStreamInformation;
+  } Req;
+  FSP_FSCTL_TRANSACT_BUF FileName;
+  /* Create,Cleanup,SetInformation{Disposition,Rename},FileSystemControl{ReparsePoint}
+   */
+  FSP_FSCTL_DECLSPEC_ALIGN UINT8 Buffer[];
+} FSP_FSCTL_TRANSACT_REQ;
+typedef struct {
+  UINT16 Version;
+  UINT16 Size;
+  UINT32 Kind;
+  UINT64 Hint;
+  struct {
+    UINT32 Information;
+    UINT32 Status;
+  } IoStatus;
+  union {
+    union {
+      /* IoStatus.Status == STATUS_SUCCESS */
+      struct {
+        UINT64 UserContext;   /* user context associated with file node */
+        UINT64 UserContext2;  /* user context associated with file descriptor
+                                 (handle) */
+        UINT32 GrantedAccess; /* FILE_{READ_DATA,WRITE_DATA,etc.} */
+        FSP_FSCTL_TRANSACT_BUF SecurityDescriptor;
+        FSP_FSCTL_FILE_INFO FileInfo;
+        FSP_FSCTL_TRANSACT_BUF FileName;
+        UINT32 DisableCache : 1;
+        UINT32 HasSecurityDescriptor : 1;
+      } Opened;
+      /* IoStatus.Status == STATUS_REPARSE */
+      struct {
+        FSP_FSCTL_TRANSACT_BUF Buffer;
+      } Reparse;
+    } Create;
+    struct {
+      FSP_FSCTL_FILE_INFO FileInfo;
+    } Overwrite;
+    struct {
+      FSP_FSCTL_FILE_INFO FileInfo;
+    } Write;
+    struct {
+      FSP_FSCTL_FILE_INFO FileInfo;
+    } QueryInformation;
+    struct {
+      FSP_FSCTL_FILE_INFO
+      FileInfo; /* valid: File{Allocation,Basic,EndOfFile}Information */
+    } SetInformation;
+    struct {
+      FSP_FSCTL_TRANSACT_BUF Ea;
+    } QueryEa;
+    struct {
+      FSP_FSCTL_FILE_INFO FileInfo;
+      FSP_FSCTL_TRANSACT_BUF
+      Ea; /* Size==0 means no extended atttributed returned */
+    } SetEa;
+    struct {
+      FSP_FSCTL_FILE_INFO FileInfo; /* valid when flushing file (not volume) */
+    } FlushBuffers;
+    struct {
+      FSP_FSCTL_VOLUME_INFO VolumeInfo;
+    } QueryVolumeInformation;
+    struct {
+      FSP_FSCTL_VOLUME_INFO VolumeInfo;
+    } SetVolumeInformation;
+    struct {
+      FSP_FSCTL_TRANSACT_BUF Buffer;
+    } FileSystemControl;
+    struct {
+      FSP_FSCTL_TRANSACT_BUF Buffer;
+    } DeviceControl;
+    struct {
+      FSP_FSCTL_TRANSACT_BUF SecurityDescriptor;
+    } QuerySecurity;
+    struct {
+      FSP_FSCTL_TRANSACT_BUF SecurityDescriptor; /* Size==0 means no security
+                                                    descriptor returned */
+    } SetSecurity;
+    struct {
+      FSP_FSCTL_TRANSACT_BUF Buffer;
+    } QueryStreamInformation;
+  } Rsp;
+  FSP_FSCTL_DECLSPEC_ALIGN UINT8 Buffer[];
+} FSP_FSCTL_TRANSACT_RSP;
+#pragma warning(pop)
+FSP_FSCTL_STATIC_ASSERT(FSP_FSCTL_TRANSACT_RSP_BUFFER_SIZEMAX >
+                            FSP_FSCTL_TRANSACT_PATH_SIZEMAX,
+                        "FSP_FSCTL_TRANSACT_RSP_BUFFER_SIZEMAX must be greater "
+                        "than FSP_FSCTL_TRANSACT_PATH_SIZEMAX "
+                        "to detect when a normalized name has been set during "
+                        "a Create/Open request.");
+static inline BOOLEAN
+FspFsctlTransactCanProduceRequest(FSP_FSCTL_TRANSACT_REQ *Request,
+                                  PVOID RequestBufEnd) {
+  return (PUINT8)Request + FSP_FSCTL_TRANSACT_REQ_SIZEMAX <=
+         (PUINT8)RequestBufEnd;
+}
+static inline FSP_FSCTL_TRANSACT_REQ *
+FspFsctlTransactProduceRequest(FSP_FSCTL_TRANSACT_REQ *Request,
+                               SIZE_T RequestSize) {
+  PVOID NextRequest = (PUINT8)Request + FSP_FSCTL_DEFAULT_ALIGN_UP(RequestSize);
+  return (FSP_FSCTL_TRANSACT_REQ *)NextRequest;
+}
+static inline FSP_FSCTL_TRANSACT_REQ *
+FspFsctlTransactConsumeRequest(FSP_FSCTL_TRANSACT_REQ *Request,
+                               PVOID RequestBufEnd) {
+  if ((PUINT8)Request + sizeof(Request->Size) > (PUINT8)RequestBufEnd ||
+      sizeof(FSP_FSCTL_TRANSACT_REQ) > Request->Size)
+    return 0;
+  PVOID NextRequest =
+      (PUINT8)Request + FSP_FSCTL_DEFAULT_ALIGN_UP(Request->Size);
+  return NextRequest <= RequestBufEnd ? (FSP_FSCTL_TRANSACT_REQ *)NextRequest
+                                      : 0;
+}
+static inline BOOLEAN
+FspFsctlTransactCanProduceResponse(FSP_FSCTL_TRANSACT_RSP *Response,
+                                   PVOID ResponseBufEnd) {
+  return (PUINT8)Response + FSP_FSCTL_TRANSACT_RSP_SIZEMAX <=
+         (PUINT8)ResponseBufEnd;
+}
+static inline FSP_FSCTL_TRANSACT_RSP *
+FspFsctlTransactProduceResponse(FSP_FSCTL_TRANSACT_RSP *Response,
+                                SIZE_T ResponseSize) {
+  PVOID NextResponse =
+      (PUINT8)Response + FSP_FSCTL_DEFAULT_ALIGN_UP(ResponseSize);
+  return (FSP_FSCTL_TRANSACT_RSP *)NextResponse;
+}
+static inline FSP_FSCTL_TRANSACT_RSP *
+FspFsctlTransactConsumeResponse(FSP_FSCTL_TRANSACT_RSP *Response,
+                                PVOID ResponseBufEnd) {
+  if ((PUINT8)Response + sizeof(Response->Size) > (PUINT8)ResponseBufEnd ||
+      sizeof(FSP_FSCTL_TRANSACT_RSP) > Response->Size)
+    return 0;
+  PVOID NextResponse =
+      (PUINT8)Response + FSP_FSCTL_DEFAULT_ALIGN_UP(Response->Size);
+  return NextResponse <= ResponseBufEnd ? (FSP_FSCTL_TRANSACT_RSP *)NextResponse
+                                        : 0;
+}
+
+#if !defined(_KERNEL_MODE)
+FSP_API NTSTATUS FspFsctlCreateVolume(
+    PWSTR DevicePath, const FSP_FSCTL_VOLUME_PARAMS *VolumeParams,
+    PWCHAR VolumeNameBuf, SIZE_T VolumeNameSize, PHANDLE PVolumeHandle);
+FSP_API NTSTATUS FspFsctlMakeMountdev(HANDLE VolumeHandle, BOOLEAN Persistent,
+                                      GUID *UniqueId);
+FSP_API NTSTATUS FspFsctlUseMountmgr(HANDLE VolumeHandle, PWSTR MountPoint);
+FSP_API NTSTATUS FspFsctlTransact(HANDLE VolumeHandle, PVOID ResponseBuf,
+                                  SIZE_T ResponseBufSize, PVOID RequestBuf,
+                                  SIZE_T *PRequestBufSize, BOOLEAN Batch);
+FSP_API NTSTATUS FspFsctlStop(HANDLE VolumeHandle);
+FSP_API NTSTATUS FspFsctlStop0(HANDLE VolumeHandle);
+FSP_API NTSTATUS FspFsctlNotify(HANDLE VolumeHandle,
+                                FSP_FSCTL_NOTIFY_INFO *NotifyInfo, SIZE_T Size);
+FSP_API NTSTATUS FspFsctlGetVolumeList(PWSTR DevicePath, PWCHAR VolumeListBuf,
+                                       PSIZE_T PVolumeListSize);
+FSP_API NTSTATUS FspFsctlPreflight(PWSTR DevicePath);
+FSP_API NTSTATUS FspFsctlStartService(VOID);
+FSP_API NTSTATUS FspFsctlStopService(VOID);
+FSP_API NTSTATUS FspFsctlEnumServices(VOID (*EnumFn)(PVOID Context,
+                                                     PWSTR ServiceName,
+                                                     BOOLEAN Running),
+                                      PVOID Context);
+
+typedef struct {
+  /* in */
+  HANDLE VolumeHandle; /* volume handle returned by FspFsctlCreateVolume */
+  PWSTR VolumeName;    /* volume name returned by FspFsctlCreateVolume */
+  PSECURITY_DESCRIPTOR
+  Security;        /* optional: security descriptor for directories */
+  UINT64 Reserved; /* reserved for future use */
+  /* in/out */
+  PWSTR MountPoint;   /* FspMountSet sets drive in buffer when passed "*:" */
+  HANDLE MountHandle; /* FspMountSet sets, FspMountRemove uses */
+} FSP_MOUNT_DESC;
+FSP_API NTSTATUS FspMountSet(FSP_MOUNT_DESC *Desc);
+FSP_API NTSTATUS FspMountRemove(FSP_MOUNT_DESC *Desc);
+#endif
+
+/*
+ * Atomics
+ *
+ * See https://www.cl.cam.ac.uk/~pes20/cpp/cpp0xmappings.html
+ * (https://archive.is/mJfFX)
+ */
+#if _MSC_VER >= 1920 /* VS2019 or later */
+__int32 __iso_volatile_load32(const volatile __int32 *);
+void __iso_volatile_store32(volatile __int32 *, __int32);
+__int64 __iso_volatile_load64(const volatile __int64 *);
+void __iso_volatile_store64(volatile __int64 *, __int64);
+#define FSP_INTERLOCKED__LOAD32(p) __iso_volatile_load32(p)
+#define FSP_INTERLOCKED__STORE32(p, v) __iso_volatile_store32(p, v)
+#define FSP_INTERLOCKED__LOAD64(p) __iso_volatile_load64(p)
+#define FSP_INTERLOCKED__STORE64(p, v) __iso_volatile_store64(p, v)
+#else
+#define FSP_INTERLOCKED__LOAD32(p) (*(p))
+#define FSP_INTERLOCKED__STORE32(p, v) (*(p) = (v))
+#define FSP_INTERLOCKED__LOAD64(p) (*(p))
+#define FSP_INTERLOCKED__STORE64(p, v) (*(p) = (v))
+#endif
+static inline INT32 FspInterlockedLoad32(INT32 volatile *p) {
+#if defined(_M_ARM64)
+  void __dmb(unsigned int);
+  INT32 v = FSP_INTERLOCKED__LOAD32(p);
+  __dmb(0xb);
+  return v;
+
+#elif defined(_M_X64) || defined(_M_IX86)
+#ifndef _ReadWriteBarrier
+  void _ReadWriteBarrier(void);
+#endif
+  INT32 v = FSP_INTERLOCKED__LOAD32(p);
+  _ReadWriteBarrier();
+  return v;
+
+#endif
+}
+static inline VOID FspInterlockedStore32(INT32 volatile *p, INT32 v) {
+#if defined(_M_ARM64)
+  void __dmb(unsigned int);
+  __dmb(0xb);
+  FSP_INTERLOCKED__STORE32(p, v);
+  __dmb(0xb);
+
+#elif defined(_M_X64) || defined(_M_IX86)
+  long _InterlockedExchange(long volatile *, long);
+  _InterlockedExchange((long volatile *)p, v);
+
+#endif
+}
+static inline VOID *FspInterlockedLoadPointer(VOID *volatile *p) {
+#if defined(_M_ARM64)
+  void __dmb(unsigned int);
+  VOID *v = (VOID *)FSP_INTERLOCKED__LOAD64((__int64 volatile *)(p));
+  __dmb(0xb);
+  return v;
+
+#elif defined(_M_X64)
+#ifndef _ReadWriteBarrier
+  void _ReadWriteBarrier(void);
+#endif
+  VOID *v = (VOID *)FSP_INTERLOCKED__LOAD64((__int64 volatile *)(p));
+  _ReadWriteBarrier();
+  return v;
+
+#elif defined(_M_IX86)
+#ifndef _ReadWriteBarrier
+  void _ReadWriteBarrier(void);
+#endif
+  VOID *v = (VOID *)FSP_INTERLOCKED__LOAD32((__int32 volatile *)(p));
+  _ReadWriteBarrier();
+  return v;
+
+#endif
+}
+static inline VOID FspInterlockedStorePointer(VOID *volatile *p, VOID *v) {
+#if defined(_M_ARM64)
+  void __dmb(unsigned int);
+  __dmb(0xb);
+  FSP_INTERLOCKED__STORE64((__int64 volatile *)(p), (__int64)(v));
+  __dmb(0xb);
+
+#elif defined(_M_X64) || defined(_M_IX86)
+  void *_InterlockedExchangePointer(void *volatile *, void *);
+  _InterlockedExchangePointer(p, v);
+
+#endif
+}
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/winfsp/launch.h

@@ -0,0 +1,350 @@
+/**
+ * @file winfsp/launch.h
+ * WinFsp Launch API.
+ *
+ * In order to use the WinFsp Launch API a program must include <winfsp/launch.h>
+ * and link with the winfsp_x64.dll (or winfsp_x86.dll) library.
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef WINFSP_LAUNCH_H_INCLUDED
+#define WINFSP_LAUNCH_H_INCLUDED
+
+#include <winfsp/winfsp.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define FSP_LAUNCH_REGKEY               FSP_FSCTL_PRODUCT_REGKEY "\\Services"
+#define FSP_LAUNCH_REGKEY_WOW64         FSP_FSCTL_PRODUCT_REGKEY_WOW64
+#define FSP_LAUNCH_FULL_REGKEY          FSP_FSCTL_PRODUCT_FULL_REGKEY "\\Services"
+
+#define FSP_LAUNCH_PIPE_NAME            "\\\\.\\pipe\\" FSP_FSCTL_PRODUCT_NAME ".{14E7137D-22B4-437A-B0C1-D21D1BDF3767}"
+#define FSP_LAUNCH_PIPE_BUFFER_SIZE     4096
+#define FSP_LAUNCH_PIPE_OWNER           ((PSID)WinLocalSystemSid)
+
+/*
+ * The launcher named pipe SDDL gives full access to LocalSystem and Administrators and
+ * GENERIC_READ and FILE_WRITE_DATA access to Everyone. We are careful not to give the
+ * FILE_CREATE_PIPE_INSTANCE right to Everyone to disallow the creation of additional
+ * pipe instances.
+ */
+#define FSP_LAUNCH_PIPE_SDDL            "O:SYG:SYD:P(A;;GA;;;SY)(A;;GA;;;BA)(A;;GRDCCR;;;WD)"
+
+/*
+ * The default service instance SDDL gives full access to LocalSystem and Administrators.
+ * The only possible service instance rights are as follows:
+ *     RP   SERVICE_START
+ *     WP   SERVICE_STOP
+ *     LC   SERVICE_QUERY_STATUS
+ *
+ * To create a service that can be started, stopped or queried by Everyone, you can set
+ * the following SDDL:
+ *     D:P(A;;RPWPLC;;;WD)
+ */
+#define FSP_LAUNCH_SERVICE_DEFAULT_SDDL "D:P(A;;RPWPLC;;;SY)(A;;RPWPLC;;;BA)"
+#define FSP_LAUNCH_SERVICE_WORLD_SDDL   "D:P(A;;RPWPLC;;;WD)"
+
+enum
+{
+    FspLaunchCmdStart                   = 'S',  /* requires: SERVICE_START */
+    FspLaunchCmdStartWithSecret         = 'X',  /* requires: SERVICE_START */
+    FspLaunchCmdStop                    = 'T',  /* requires: SERVICE_STOP */
+    FspLaunchCmdGetInfo                 = 'I',  /* requires: SERVICE_QUERY_STATUS */
+    FspLaunchCmdGetNameList             = 'L',  /* requires: none*/
+    FspLaunchCmdDefineDosDevice         = 'D',  /* internal: do not use! */
+    FspLaunchCmdQuit                    = 'Q',  /* DEBUG version only */
+};
+
+enum
+{
+    FspLaunchCmdSuccess                 = '$',
+    FspLaunchCmdFailure                 = '!',
+};
+
+/**
+ * @group Launch Control
+ */
+/**
+ * Call launcher pipe.
+ *
+ * This function is used to send a command to the launcher and receive a response.
+ *
+ * @param Command
+ *     Launcher command to send. For example, the 'L' launcher command instructs
+ *     the launcher to list all running service instances.
+ * @param Argc
+ *     Command argument count. May be 0.
+ * @param Argv
+ *     Command argument array. May be NULL.
+ * @param Argl
+ *     Command argument length array. May be NULL. If this is NULL all command arguments
+ *     are assumed to be NULL-terminated strings. It is also possible for specific arguments
+ *     to be NULL-terminated; in this case pass -1 in the corresponding Argl position.
+ * @param Buffer
+ *     Buffer that receives the command response. May be NULL.
+ * @param PSize
+ *     Pointer to a ULONG. On input it contains the size of the Buffer. On output it
+ *     contains the number of bytes transferred. May be NULL.
+ * @param PLauncherError
+ *     Receives the launcher error if any. This is always a Win32 error code. May not be NULL.
+ * @return
+ *     STATUS_SUCCESS if the command is sent successfully to the launcher, even if the launcher
+ *     returns an error. Other status codes indicate a communication error. Launcher errors are
+ *     reported through PLauncherError.
+ */
+FSP_API NTSTATUS FspLaunchCallLauncherPipe(
+    WCHAR Command, ULONG Argc, PWSTR *Argv, ULONG *Argl,
+    PWSTR Buffer, PULONG PSize,
+    PULONG PLauncherError);
+/**
+ * Call launcher pipe.
+ *
+ * This function is used to send a command to the launcher and receive a response.
+ *
+ * @param Command
+ *     Launcher command to send. For example, the 'L' launcher command instructs
+ *     the launcher to list all running service instances.
+ * @param Argc
+ *     Command argument count. May be 0.
+ * @param Argv
+ *     Command argument array. May be NULL.
+ * @param Argl
+ *     Command argument length array. May be NULL. If this is NULL all command arguments
+ *     are assumed to be NULL-terminated strings. It is also possible for specific arguments
+ *     to be NULL-terminated; in this case pass -1 in the corresponding Argl position.
+ * @param Buffer
+ *     Buffer that receives the command response. May be NULL.
+ * @param PSize
+ *     Pointer to a ULONG. On input it contains the size of the Buffer. On output it
+ *     contains the number of bytes transferred. May be NULL.
+ * @param AllowImpersonation
+ *     Allow caller to be impersonated by launcher.
+ * @param PLauncherError
+ *     Receives the launcher error if any. This is always a Win32 error code. May not be NULL.
+ * @return
+ *     STATUS_SUCCESS if the command is sent successfully to the launcher, even if the launcher
+ *     returns an error. Other status codes indicate a communication error. Launcher errors are
+ *     reported through PLauncherError.
+ */
+FSP_API NTSTATUS FspLaunchCallLauncherPipeEx(
+    WCHAR Command, ULONG Argc, PWSTR *Argv, ULONG *Argl,
+    PWSTR Buffer, PULONG PSize,
+    BOOLEAN AllowImpersonation,
+    PULONG PLauncherError);
+/**
+ * Start a service instance.
+ *
+ * @param ClassName
+ *     Class name of the service instance to start.
+ * @param InstanceName
+ *     Instance name of the service instance to start.
+ * @param Argc
+ *     Service instance argument count. May be 0.
+ * @param Argv
+ *     Service instance argument array. May be NULL.
+ * @param HasSecret
+ *     Whether the last argument in Argv is assumed to be a secret (e.g. password) or not.
+ *     Secrets are passed to service instances through standard input rather than the command
+ *     line.
+ * @param PLauncherError
+ *     Receives the launcher error if any. This is always a Win32 error code. May not be NULL.
+ * @return
+ *     STATUS_SUCCESS if the command is sent successfully to the launcher, even if the launcher
+ *     returns an error. Other status codes indicate a communication error. Launcher errors are
+ *     reported through PLauncherError.
+ */
+FSP_API NTSTATUS FspLaunchStart(
+    PWSTR ClassName, PWSTR InstanceName, ULONG Argc, PWSTR *Argv,
+    BOOLEAN HasSecret,
+    PULONG PLauncherError);
+/**
+ * Start a service instance.
+ *
+ * @param ClassName
+ *     Class name of the service instance to start.
+ * @param InstanceName
+ *     Instance name of the service instance to start.
+ * @param Argc
+ *     Service instance argument count. May be 0.
+ * @param Argv
+ *     Service instance argument array. May be NULL.
+ * @param HasSecret
+ *     Whether the last argument in Argv is assumed to be a secret (e.g. password) or not.
+ *     Secrets are passed to service instances through standard input rather than the command
+ *     line.
+ * @param AllowImpersonation
+ *     Allow caller to be impersonated by launcher.
+ * @param PLauncherError
+ *     Receives the launcher error if any. This is always a Win32 error code. May not be NULL.
+ * @return
+ *     STATUS_SUCCESS if the command is sent successfully to the launcher, even if the launcher
+ *     returns an error. Other status codes indicate a communication error. Launcher errors are
+ *     reported through PLauncherError.
+ */
+FSP_API NTSTATUS FspLaunchStartEx(
+    PWSTR ClassName, PWSTR InstanceName, ULONG Argc, PWSTR *Argv,
+    BOOLEAN HasSecret,
+    BOOLEAN AllowImpersonation,
+    PULONG PLauncherError);
+/**
+ * Stop a service instance.
+ *
+ * @param ClassName
+ *     Class name of the service instance to stop.
+ * @param InstanceName
+ *     Instance name of the service instance to stop.
+ * @param PLauncherError
+ *     Receives the launcher error if any. This is always a Win32 error code. May not be NULL.
+ * @return
+ *     STATUS_SUCCESS if the command is sent successfully to the launcher, even if the launcher
+ *     returns an error. Other status codes indicate a communication error. Launcher errors are
+ *     reported through PLauncherError.
+ */
+FSP_API NTSTATUS FspLaunchStop(
+    PWSTR ClassName, PWSTR InstanceName,
+    PULONG PLauncherError);
+/**
+ * Get information about a service instance.
+ *
+ * The information is a list of NULL-terminated strings: the class name of the service instance,
+ * the instance name of the service instance and the full command line used to start the service
+ * instance.
+ *
+ * @param ClassName
+ *     Class name of the service instance to stop.
+ * @param InstanceName
+ *     Instance name of the service instance to stop.
+ * @param Buffer
+ *     Buffer that receives the command response. May be NULL.
+ * @param PSize
+ *     Pointer to a ULONG. On input it contains the size of the Buffer. On output it
+ *     contains the number of bytes transferred. May be NULL.
+ * @param PLauncherError
+ *     Receives the launcher error if any. This is always a Win32 error code. May not be NULL.
+ * @return
+ *     STATUS_SUCCESS if the command is sent successfully to the launcher, even if the launcher
+ *     returns an error. Other status codes indicate a communication error. Launcher errors are
+ *     reported through PLauncherError.
+ */
+FSP_API NTSTATUS FspLaunchGetInfo(
+    PWSTR ClassName, PWSTR InstanceName,
+    PWSTR Buffer, PULONG PSize,
+    PULONG PLauncherError);
+/**
+ * List service instances.
+ *
+ * The information is a list of pairs of NULL-terminated strings. Each pair contains the class
+ * name and instance name of a service instance. All currently running service instances are
+ * listed.
+ *
+ * @param Buffer
+ *     Buffer that receives the command response. May be NULL.
+ * @param PSize
+ *     Pointer to a ULONG. On input it contains the size of the Buffer. On output it
+ *     contains the number of bytes transferred. May be NULL.
+ * @param PLauncherError
+ *     Receives the launcher error if any. This is always a Win32 error code. May not be NULL.
+ * @return
+ *     STATUS_SUCCESS if the command is sent successfully to the launcher, even if the launcher
+ *     returns an error. Other status codes indicate a communication error. Launcher errors are
+ *     reported through PLauncherError.
+ */
+FSP_API NTSTATUS FspLaunchGetNameList(
+    PWSTR Buffer, PULONG PSize,
+    PULONG PLauncherError);
+
+/**
+ * @group Service Registry
+ */
+#pragma warning(push)
+#pragma warning(disable:4200)           /* zero-sized array in struct/union */
+/**
+ * Service registry record.
+ */
+typedef struct _FSP_LAUNCH_REG_RECORD
+{
+    PWSTR Agent;
+    PWSTR Executable;
+    PWSTR CommandLine;
+    PWSTR WorkDirectory;
+    PWSTR RunAs;
+    PWSTR Security;
+    PWSTR AuthPackage;
+    PWSTR Stderr;
+    PVOID Reserved0[4];
+    ULONG JobControl;
+    ULONG Credentials;
+    ULONG AuthPackageId;
+    ULONG Recovery;
+    ULONG Reserved1[4];
+    UINT8 Buffer[];
+} FSP_LAUNCH_REG_RECORD;
+#pragma warning(pop)
+/**
+ * Add/change/delete a service registry record.
+ *
+ * @param ClassName
+ *     The service class name.
+ * @param Record
+ *     The record to set in the registry. If NULL, the registry record is deleted.
+ * @return
+ *     STATUS_SUCCESS or error code.
+ */
+FSP_API NTSTATUS FspLaunchRegSetRecord(
+    PWSTR ClassName,
+    const FSP_LAUNCH_REG_RECORD *Record);
+/**
+ * Get a service registry record.
+ *
+ * @param ClassName
+ *     The service class name.
+ * @param Agent
+ *     The name of the agent that is retrieving the service record. This API matches
+ *     the supplied Agent against the Agent in the service record and it only returns
+ *     the record if they match. Pass NULL to match any Agent.
+ * @param PRecord
+ *     Pointer to a record pointer. Memory for the service record will be allocated
+ *     and a pointer to it will be stored at this address. This memory must be later
+ *     freed using FspLaunchRegFreeRecord.
+ * @return
+ *     STATUS_SUCCESS or error code.
+ * @see
+ *     FspLaunchRegFreeRecord
+ */
+FSP_API NTSTATUS FspLaunchRegGetRecord(
+    PWSTR ClassName, PWSTR Agent,
+    FSP_LAUNCH_REG_RECORD **PRecord);
+/**
+ * Free a service registry record.
+ *
+ * @param Record
+ *     The service record to free.
+ * @see
+ *     FspLaunchRegGetRecord
+ */
+FSP_API VOID FspLaunchRegFreeRecord(
+    FSP_LAUNCH_REG_RECORD *Record);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

support/3rd_party/winfsp-2.0/inc/winfsp/winfsp.hpp

@@ -0,0 +1,902 @@
+/**
+ * @file winfsp/winfsp.hpp
+ * WinFsp C++ Layer.
+ *
+ * @copyright 2015-2022 Bill Zissimopoulos
+ */
+/*
+ * This file is part of WinFsp.
+ *
+ * You can redistribute it and/or modify it under the terms of the GNU
+ * General Public License version 3 as published by the Free Software
+ * Foundation.
+ *
+ * Licensees holding a valid commercial license may use this software
+ * in accordance with the commercial license agreement provided in
+ * conjunction with the software.  The terms and conditions of any such
+ * commercial license agreement shall govern, supersede, and render
+ * ineffective any application of the GPLv3 license to this software,
+ * notwithstanding of any reference thereto in the software or
+ * associated repository.
+ */
+
+#ifndef WINFSP_WINFSP_HPP_INCLUDED
+#define WINFSP_WINFSP_HPP_INCLUDED
+
+#ifndef __cplusplus
+#error this header requires a C++ compiler
+#endif
+
+#include <winfsp/winfsp.h>
+
+#define FSP_CPP_EXCEPTION_GUARD(...)                                           \
+  try {                                                                        \
+    __VA_ARGS__                                                                \
+  } catch (...) {                                                              \
+    return self->ExceptionHandler();                                           \
+  }
+#define FSP_CPP_EXCEPTION_GUARD_VOID(...)                                      \
+  try {                                                                        \
+    __VA_ARGS__                                                                \
+  } catch (...) {                                                              \
+    self->ExceptionHandler();                                                  \
+    return;                                                                    \
+  }
+
+namespace Fsp {
+
+inline NTSTATUS Initialize() {
+  static NTSTATUS LoadResult = FspLoad(0);
+  return LoadResult;
+}
+
+class FileSystemBase {
+public:
+  typedef FSP_FSCTL_VOLUME_INFO VolumeInfo;
+  typedef FSP_FSCTL_FILE_INFO FileInfo;
+  typedef FSP_FSCTL_OPEN_FILE_INFO OpenFileInfo;
+  typedef FSP_FSCTL_DIR_INFO DirInfo;
+  typedef FSP_FSCTL_STREAM_INFO StreamInfo;
+  enum CleanupFlags {
+    CleanupDelete = FspCleanupDelete,
+    CleanupSetAllocationSize = FspCleanupSetAllocationSize,
+    CleanupSetArchiveBit = FspCleanupSetArchiveBit,
+    CleanupSetLastAccessTime = FspCleanupSetLastAccessTime,
+    CleanupSetLastWriteTime = FspCleanupSetLastWriteTime,
+    CleanupSetChangeTime = FspCleanupSetChangeTime,
+  };
+
+public:
+  FileSystemBase() {}
+  virtual ~FileSystemBase() {}
+
+  /* operations */
+  virtual NTSTATUS ExceptionHandler() { return STATUS_UNEXPECTED_IO_ERROR; }
+  virtual NTSTATUS Init(PVOID Host) { return STATUS_SUCCESS; }
+  virtual NTSTATUS Mounted(PVOID Host) { return STATUS_SUCCESS; }
+  virtual VOID Unmounted(PVOID Host) {}
+  virtual NTSTATUS GetVolumeInfo(VolumeInfo *VolumeInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS SetVolumeLabel_(PWSTR VolumeLabel, VolumeInfo *VolumeInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS
+  GetSecurityByName(PWSTR FileName,
+                    PUINT32 PFileAttributes /* or ReparsePointIndex */,
+                    PSECURITY_DESCRIPTOR SecurityDescriptor,
+                    SIZE_T *PSecurityDescriptorSize) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS Create(PWSTR FileName, UINT32 CreateOptions,
+                          UINT32 GrantedAccess, UINT32 FileAttributes,
+                          PSECURITY_DESCRIPTOR SecurityDescriptor,
+                          UINT64 AllocationSize, PVOID *PFileNode,
+                          PVOID *PFileDesc, OpenFileInfo *OpenFileInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS Open(PWSTR FileName, UINT32 CreateOptions,
+                        UINT32 GrantedAccess, PVOID *PFileNode,
+                        PVOID *PFileDesc, OpenFileInfo *OpenFileInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS Overwrite(PVOID FileNode, PVOID FileDesc,
+                             UINT32 FileAttributes,
+                             BOOLEAN ReplaceFileAttributes,
+                             UINT64 AllocationSize, FileInfo *FileInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual VOID Cleanup(PVOID FileNode, PVOID FileDesc, PWSTR FileName,
+                       ULONG Flags) {}
+  virtual VOID Close(PVOID FileNode, PVOID FileDesc) {}
+  virtual NTSTATUS Read(PVOID FileNode, PVOID FileDesc, PVOID Buffer,
+                        UINT64 Offset, ULONG Length, PULONG PBytesTransferred) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS Write(PVOID FileNode, PVOID FileDesc, PVOID Buffer,
+                         UINT64 Offset, ULONG Length, BOOLEAN WriteToEndOfFile,
+                         BOOLEAN ConstrainedIo, PULONG PBytesTransferred,
+                         FileInfo *FileInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS Flush(PVOID FileNode, PVOID FileDesc, FileInfo *FileInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS GetFileInfo(PVOID FileNode, PVOID FileDesc,
+                               FileInfo *FileInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS SetBasicInfo(PVOID FileNode, PVOID FileDesc,
+                                UINT32 FileAttributes, UINT64 CreationTime,
+                                UINT64 LastAccessTime, UINT64 LastWriteTime,
+                                UINT64 ChangeTime, FileInfo *FileInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS SetFileSize(PVOID FileNode, PVOID FileDesc, UINT64 NewSize,
+                               BOOLEAN SetAllocationSize, FileInfo *FileInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS CanDelete(PVOID FileNode, PVOID FileDesc, PWSTR FileName) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS Rename(PVOID FileNode, PVOID FileDesc, PWSTR FileName,
+                          PWSTR NewFileName, BOOLEAN ReplaceIfExists) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS GetSecurity(PVOID FileNode, PVOID FileDesc,
+                               PSECURITY_DESCRIPTOR SecurityDescriptor,
+                               SIZE_T *PSecurityDescriptorSize) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS SetSecurity(PVOID FileNode, PVOID FileDesc,
+                               SECURITY_INFORMATION SecurityInformation,
+                               PSECURITY_DESCRIPTOR ModificationDescriptor) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS ReadDirectory(PVOID FileNode, PVOID FileDesc, PWSTR Pattern,
+                                 PWSTR Marker, PVOID Buffer, ULONG Length,
+                                 PULONG PBytesTransferred) {
+    return SeekableReadDirectory(FileNode, FileDesc, Pattern, Marker, Buffer,
+                                 Length, PBytesTransferred);
+  }
+  virtual NTSTATUS ReadDirectoryEntry(PVOID FileNode, PVOID FileDesc,
+                                      PWSTR Pattern, PWSTR Marker,
+                                      PVOID *PContext, DirInfo *DirInfo) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS ResolveReparsePoints(PWSTR FileName,
+                                        UINT32 ReparsePointIndex,
+                                        BOOLEAN ResolveLastPathComponent,
+                                        PIO_STATUS_BLOCK PIoStatus,
+                                        PVOID Buffer, PSIZE_T PSize) {
+    return FspFileSystemResolveReparsePoints(
+        0, GetReparsePointByName, this, FileName, ReparsePointIndex,
+        ResolveLastPathComponent, PIoStatus, Buffer, PSize);
+  }
+  virtual NTSTATUS GetReparsePointByName(PWSTR FileName, BOOLEAN IsDirectory,
+                                         PVOID Buffer, PSIZE_T PSize) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS GetReparsePoint(PVOID FileNode, PVOID FileDesc,
+                                   PWSTR FileName, PVOID Buffer,
+                                   PSIZE_T PSize) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS SetReparsePoint(PVOID FileNode, PVOID FileDesc,
+                                   PWSTR FileName, PVOID Buffer, SIZE_T Size) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS DeleteReparsePoint(PVOID FileNode, PVOID FileDesc,
+                                      PWSTR FileName, PVOID Buffer,
+                                      SIZE_T Size) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+  virtual NTSTATUS GetStreamInfo(PVOID FileNode, PVOID FileDesc, PVOID Buffer,
+                                 ULONG Length, PULONG PBytesTransferred) {
+    return STATUS_INVALID_DEVICE_REQUEST;
+  }
+
+  /* helpers */
+  static NTSTATUS NtStatusFromWin32(DWORD Error) {
+    return FspNtStatusFromWin32(Error);
+  }
+  static DWORD Win32FromNtStatus(NTSTATUS Status) {
+    return FspWin32FromNtStatus(Status);
+  }
+  static VOID DeleteDirectoryBuffer(PVOID *PDirBuffer) {
+    FspFileSystemDeleteDirectoryBuffer(PDirBuffer);
+  }
+  NTSTATUS SeekableReadDirectory(PVOID FileNode, PVOID FileDesc, PWSTR Pattern,
+                                 PWSTR Marker, PVOID Buffer, ULONG Length,
+                                 PULONG PBytesTransferred) {
+    PVOID Context = 0;
+    union {
+      UINT8 B[FIELD_OFFSET(FileSystemBase::DirInfo, FileNameBuf) +
+              MAX_PATH * sizeof(WCHAR)];
+      FileSystemBase::DirInfo D;
+    } DirInfoBuf;
+    FileSystemBase::DirInfo *DirInfo = &DirInfoBuf.D;
+    NTSTATUS Result = STATUS_SUCCESS;
+    *PBytesTransferred = 0;
+    for (;;) {
+      Result = ReadDirectoryEntry(FileNode, FileDesc, Pattern, Marker, &Context,
+                                  DirInfo);
+      if (STATUS_NO_MORE_FILES == Result) {
+        Result = STATUS_SUCCESS;
+        break;
+      }
+      if (!NT_SUCCESS(Result))
+        break;
+      if (!FspFileSystemAddDirInfo(DirInfo, Buffer, Length, PBytesTransferred))
+        break;
+    }
+    if (!NT_SUCCESS(Result))
+      return Result;
+    return STATUS_SUCCESS;
+  }
+  NTSTATUS BufferedReadDirectory(PVOID *PDirBuffer, PVOID FileNode,
+                                 PVOID FileDesc, PWSTR Pattern, PWSTR Marker,
+                                 PVOID Buffer, ULONG Length,
+                                 PULONG PBytesTransferred) {
+    PVOID Context = 0;
+    union {
+      UINT8 B[FIELD_OFFSET(FileSystemBase::DirInfo, FileNameBuf) +
+              MAX_PATH * sizeof(WCHAR)];
+      FileSystemBase::DirInfo D;
+    } DirInfoBuf;
+    FileSystemBase::DirInfo *DirInfo = &DirInfoBuf.D;
+    NTSTATUS Result = STATUS_SUCCESS;
+    *PBytesTransferred = 0;
+    if (FspFileSystemAcquireDirectoryBuffer(PDirBuffer, 0 == Marker, &Result)) {
+      try {
+        for (;;) {
+          Result = ReadDirectoryEntry(FileNode, FileDesc, Pattern, Marker,
+                                      &Context, DirInfo);
+          if (STATUS_NO_MORE_FILES == Result) {
+            Result = STATUS_SUCCESS;
+            break;
+          }
+          if (!NT_SUCCESS(Result))
+            break;
+          if (!FspFileSystemFillDirectoryBuffer(PDirBuffer, DirInfo, &Result))
+            break;
+        }
+      } catch (...) {
+        FspFileSystemReleaseDirectoryBuffer(PDirBuffer);
+        throw;
+      }
+      FspFileSystemReleaseDirectoryBuffer(PDirBuffer);
+    }
+    if (!NT_SUCCESS(Result))
+      return Result;
+    FspFileSystemReadDirectoryBuffer(PDirBuffer, Marker, Buffer, Length,
+                                     PBytesTransferred);
+    return STATUS_SUCCESS;
+  }
+  BOOLEAN FindReparsePoint(PWSTR FileName, PUINT32 PReparsePointIndex) {
+    return FspFileSystemFindReparsePoint(0, GetReparsePointByName, this,
+                                         FileName, PReparsePointIndex);
+  }
+  static NTSTATUS CanReplaceReparsePoint(PVOID CurrentReparseData,
+                                         SIZE_T CurrentReparseDataSize,
+                                         PVOID ReplaceReparseData,
+                                         SIZE_T ReplaceReparseDataSize) {
+    return FspFileSystemCanReplaceReparsePoint(
+        CurrentReparseData, CurrentReparseDataSize, ReplaceReparseData,
+        ReplaceReparseDataSize);
+  }
+  static BOOLEAN AddStreamInfo(StreamInfo *StreamInfo, PVOID Buffer,
+                               ULONG Length, PULONG PBytesTransferred) {
+    return FspFileSystemAddStreamInfo(StreamInfo, Buffer, Length,
+                                      PBytesTransferred);
+  }
+
+private:
+  static NTSTATUS GetReparsePointByName(FSP_FILE_SYSTEM *FileSystem,
+                                        PVOID Context, PWSTR FileName,
+                                        BOOLEAN IsDirectory, PVOID Buffer,
+                                        PSIZE_T PSize) {
+    FileSystemBase *self = (FileSystemBase *)Context;
+    FSP_CPP_EXCEPTION_GUARD(return self->GetReparsePointByName(
+        FileName, IsDirectory, Buffer, PSize);)
+  }
+
+private:
+  /* disallow copy and assignment */
+  FileSystemBase(const FileSystemBase &);
+  FileSystemBase &operator=(const FileSystemBase &);
+};
+
+class FileSystemHost {
+public:
+  /* ctor/dtor */
+  FileSystemHost(FileSystemBase &FileSystem)
+      : _VolumeParams(), _FileSystemPtr(0), _FileSystem(&FileSystem) {
+    Initialize();
+    _VolumeParams.UmFileContextIsFullContext = 1;
+  }
+  virtual ~FileSystemHost() {
+    if (0 != _FileSystemPtr)
+      FspFileSystemDelete(_FileSystemPtr);
+  }
+
+  /* properties */
+  UINT16 SectorSize() { return _VolumeParams.SectorSize; }
+  VOID SetSectorSize(UINT16 SectorSize) {
+    _VolumeParams.SectorSize = SectorSize;
+  }
+  UINT16 SectorsPerAllocationUnit() {
+    return _VolumeParams.SectorsPerAllocationUnit;
+  }
+  VOID SetSectorsPerAllocationUnit(UINT16 SectorsPerAllocationUnit) {
+    _VolumeParams.SectorsPerAllocationUnit = SectorsPerAllocationUnit;
+  }
+  UINT16 MaxComponentLength() { return _VolumeParams.MaxComponentLength; }
+  VOID SetMaxComponentLength(UINT16 MaxComponentLength) {
+    _VolumeParams.MaxComponentLength = MaxComponentLength;
+  }
+  UINT64 VolumeCreationTime() { return _VolumeParams.VolumeCreationTime; }
+  VOID SetVolumeCreationTime(UINT64 VolumeCreationTime) {
+    _VolumeParams.VolumeCreationTime = VolumeCreationTime;
+  }
+  UINT32 VolumeSerialNumber() { return _VolumeParams.VolumeSerialNumber; }
+  VOID SetVolumeSerialNumber(UINT32 VolumeSerialNumber) {
+    _VolumeParams.VolumeSerialNumber = VolumeSerialNumber;
+  }
+  UINT32 FileInfoTimeout() { return _VolumeParams.FileInfoTimeout; }
+  VOID SetFileInfoTimeout(UINT32 FileInfoTimeout) {
+    _VolumeParams.FileInfoTimeout = FileInfoTimeout;
+  }
+  BOOLEAN CaseSensitiveSearch() { return _VolumeParams.CaseSensitiveSearch; }
+  VOID SetCaseSensitiveSearch(BOOLEAN CaseSensitiveSearch) {
+    _VolumeParams.CaseSensitiveSearch = !!CaseSensitiveSearch;
+  }
+  BOOLEAN CasePreservedNames() { return _VolumeParams.CasePreservedNames; }
+  VOID SetCasePreservedNames(BOOLEAN CasePreservedNames) {
+    _VolumeParams.CasePreservedNames = !!CasePreservedNames;
+  }
+  BOOLEAN UnicodeOnDisk() { return _VolumeParams.UnicodeOnDisk; }
+  VOID SetUnicodeOnDisk(BOOLEAN UnicodeOnDisk) {
+    _VolumeParams.UnicodeOnDisk = !!UnicodeOnDisk;
+  }
+  BOOLEAN PersistentAcls() { return _VolumeParams.PersistentAcls; }
+  VOID SetPersistentAcls(BOOLEAN PersistentAcls) {
+    _VolumeParams.PersistentAcls = !!PersistentAcls;
+  }
+  BOOLEAN ReparsePoints() { return _VolumeParams.ReparsePoints; }
+  VOID SetReparsePoints(BOOLEAN ReparsePoints) {
+    _VolumeParams.ReparsePoints = !!ReparsePoints;
+  }
+  BOOLEAN ReparsePointsAccessCheck() {
+    return _VolumeParams.ReparsePointsAccessCheck;
+  }
+  VOID SetReparsePointsAccessCheck(BOOLEAN ReparsePointsAccessCheck) {
+    _VolumeParams.ReparsePointsAccessCheck = !!ReparsePointsAccessCheck;
+  }
+  BOOLEAN NamedStreams() { return _VolumeParams.NamedStreams; }
+  VOID SetNamedStreams(BOOLEAN NamedStreams) {
+    _VolumeParams.NamedStreams = !!NamedStreams;
+  }
+  BOOLEAN PostCleanupWhenModifiedOnly() {
+    return _VolumeParams.PostCleanupWhenModifiedOnly;
+  }
+  VOID SetPostCleanupWhenModifiedOnly(BOOLEAN PostCleanupWhenModifiedOnly) {
+    _VolumeParams.PostCleanupWhenModifiedOnly = !!PostCleanupWhenModifiedOnly;
+  }
+  BOOLEAN PassQueryDirectoryPattern() {
+    return _VolumeParams.PassQueryDirectoryPattern;
+  }
+  VOID SetPassQueryDirectoryPattern(BOOLEAN PassQueryDirectoryPattern) {
+    _VolumeParams.PassQueryDirectoryPattern = !!PassQueryDirectoryPattern;
+  }
+  BOOLEAN FlushAndPurgeOnCleanup() {
+    return _VolumeParams.FlushAndPurgeOnCleanup;
+  }
+  VOID SetFlushAndPurgeOnCleanup(BOOLEAN FlushAndPurgeOnCleanup) {
+    _VolumeParams.FlushAndPurgeOnCleanup = !!FlushAndPurgeOnCleanup;
+  }
+  PWSTR Prefix() { return _VolumeParams.Prefix; }
+  VOID SetPrefix(PWSTR Prefix) {
+    int Size = lstrlenW(Prefix) * sizeof(WCHAR);
+    if (Size > sizeof _VolumeParams.Prefix - sizeof(WCHAR))
+      Size = sizeof _VolumeParams.Prefix - sizeof(WCHAR);
+    RtlCopyMemory(_VolumeParams.Prefix, Prefix, Size);
+    _VolumeParams.Prefix[Size / sizeof(WCHAR)] = L'\0';
+  }
+  PWSTR FileSystemName() { return _VolumeParams.FileSystemName; }
+  VOID SetFileSystemName(PWSTR FileSystemName) {
+    int Size = lstrlenW(FileSystemName) * sizeof(WCHAR);
+    if (Size > sizeof _VolumeParams.FileSystemName - sizeof(WCHAR))
+      Size = sizeof _VolumeParams.FileSystemName - sizeof(WCHAR);
+    RtlCopyMemory(_VolumeParams.FileSystemName, FileSystemName, Size);
+    _VolumeParams.FileSystemName[Size / sizeof(WCHAR)] = L'\0';
+  }
+
+  /* control */
+  NTSTATUS Preflight(PWSTR MountPoint) {
+    return FspFileSystemPreflight((PWSTR)(_VolumeParams.Prefix[0]
+                                              ? L"" FSP_FSCTL_NET_DEVICE_NAME
+                                              : L"" FSP_FSCTL_DISK_DEVICE_NAME),
+                                  MountPoint);
+  }
+  NTSTATUS Mount(PWSTR MountPoint, PSECURITY_DESCRIPTOR SecurityDescriptor = 0,
+                 BOOLEAN Synchronized = FALSE, UINT32 DebugLog = 0) {
+    NTSTATUS Result;
+    try {
+      Result = _FileSystem->Init(this);
+    } catch (...) {
+      Result = _FileSystem->ExceptionHandler();
+    }
+    if (!NT_SUCCESS(Result))
+      return Result;
+    Result = FspFileSystemCreate((PWSTR)(_VolumeParams.Prefix[0]
+                                             ? L"" FSP_FSCTL_NET_DEVICE_NAME
+                                             : L"" FSP_FSCTL_DISK_DEVICE_NAME),
+                                 &_VolumeParams, Interface(), &_FileSystemPtr);
+    if (!NT_SUCCESS(Result))
+      return Result;
+    _FileSystemPtr->UserContext = _FileSystem;
+    FspFileSystemSetOperationGuardStrategy(
+        _FileSystemPtr, Synchronized
+                            ? FSP_FILE_SYSTEM_OPERATION_GUARD_STRATEGY_COARSE
+                            : FSP_FILE_SYSTEM_OPERATION_GUARD_STRATEGY_FINE);
+    FspFileSystemSetDebugLog(_FileSystemPtr, DebugLog);
+    Result = FspFileSystemSetMountPointEx(_FileSystemPtr, MountPoint,
+                                          SecurityDescriptor);
+    if (NT_SUCCESS(Result)) {
+      try {
+        Result = _FileSystem->Mounted(this);
+      } catch (...) {
+        Result = _FileSystem->ExceptionHandler();
+      }
+      if (NT_SUCCESS(Result)) {
+        Result = FspFileSystemStartDispatcher(_FileSystemPtr, 0);
+        if (!NT_SUCCESS(Result))
+          try {
+            _FileSystem->Unmounted(this);
+          } catch (...) {
+            _FileSystem->ExceptionHandler();
+          }
+      }
+    }
+    if (!NT_SUCCESS(Result)) {
+      FspFileSystemDelete(_FileSystemPtr);
+      _FileSystemPtr = 0;
+    }
+    return Result;
+  }
+  VOID Unmount() {
+    FspFileSystemStopDispatcher(_FileSystemPtr);
+    try {
+      _FileSystem->Unmounted(this);
+    } catch (...) {
+      _FileSystem->ExceptionHandler();
+    }
+    _FileSystemPtr->UserContext = 0;
+    FspFileSystemDelete(_FileSystemPtr);
+    _FileSystemPtr = 0;
+  }
+  PWSTR MountPoint() {
+    return 0 != _FileSystemPtr ? FspFileSystemMountPoint(_FileSystemPtr) : 0;
+  }
+  FSP_FILE_SYSTEM *FileSystemHandle() { return _FileSystemPtr; }
+  FileSystemBase &FileSystem() { return *_FileSystem; }
+  static NTSTATUS SetDebugLogFile(PWSTR FileName) {
+    HANDLE Handle;
+    if ('-' == FileName[0] && '\0' == FileName[1])
+      Handle = GetStdHandle(STD_ERROR_HANDLE);
+    else
+      Handle = CreateFileW(FileName, FILE_APPEND_DATA,
+                           FILE_SHARE_READ | FILE_SHARE_WRITE, 0, OPEN_ALWAYS,
+                           FILE_ATTRIBUTE_NORMAL, 0);
+    if (INVALID_HANDLE_VALUE == Handle)
+      return FspNtStatusFromWin32(GetLastError());
+    FspDebugLogSetHandle(Handle);
+    return STATUS_SUCCESS;
+  }
+
+private:
+  /* FSP_FILE_SYSTEM_INTERFACE */
+  static NTSTATUS GetVolumeInfo(FSP_FILE_SYSTEM *FileSystem0,
+                                FSP_FSCTL_VOLUME_INFO *VolumeInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->GetVolumeInfo(VolumeInfo);)
+  }
+  static NTSTATUS SetVolumeLabel_(FSP_FILE_SYSTEM *FileSystem0,
+                                  PWSTR VolumeLabel,
+                                  FSP_FSCTL_VOLUME_INFO *VolumeInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(
+        return self->SetVolumeLabel_(VolumeLabel, VolumeInfo);)
+  }
+  static NTSTATUS
+  GetSecurityByName(FSP_FILE_SYSTEM *FileSystem0, PWSTR FileName,
+                    PUINT32 PFileAttributes /* or ReparsePointIndex */,
+                    PSECURITY_DESCRIPTOR SecurityDescriptor,
+                    SIZE_T *PSecurityDescriptorSize) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->GetSecurityByName(
+        FileName, PFileAttributes, SecurityDescriptor,
+        PSecurityDescriptorSize);)
+  }
+  static NTSTATUS Create(FSP_FILE_SYSTEM *FileSystem0, PWSTR FileName,
+                         UINT32 CreateOptions, UINT32 GrantedAccess,
+                         UINT32 FileAttributes,
+                         PSECURITY_DESCRIPTOR SecurityDescriptor,
+                         UINT64 AllocationSize, PVOID *FullContext,
+                         FSP_FSCTL_FILE_INFO *FileInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    PVOID FileNode, FileDesc;
+    NTSTATUS Result;
+    FSP_CPP_EXCEPTION_GUARD(
+        Result =
+            self->Create(FileName, CreateOptions, GrantedAccess, FileAttributes,
+                         SecurityDescriptor, AllocationSize, &FileNode,
+                         &FileDesc, FspFileSystemGetOpenFileInfo(FileInfo));)
+    ((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)->UserContext =
+        (UINT64)(UINT_PTR)FileNode;
+    ((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)->UserContext2 =
+        (UINT64)(UINT_PTR)FileDesc;
+    return Result;
+  }
+  static NTSTATUS Open(FSP_FILE_SYSTEM *FileSystem0, PWSTR FileName,
+                       UINT32 CreateOptions, UINT32 GrantedAccess,
+                       PVOID *FullContext, FSP_FSCTL_FILE_INFO *FileInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    PVOID FileNode, FileDesc;
+    NTSTATUS Result;
+    FSP_CPP_EXCEPTION_GUARD(
+        Result = self->Open(FileName, CreateOptions, GrantedAccess, &FileNode,
+                            &FileDesc, FspFileSystemGetOpenFileInfo(FileInfo));)
+    ((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)->UserContext =
+        (UINT64)(UINT_PTR)FileNode;
+    ((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)->UserContext2 =
+        (UINT64)(UINT_PTR)FileDesc;
+    return Result;
+  }
+  static NTSTATUS Overwrite(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                            UINT32 FileAttributes,
+                            BOOLEAN ReplaceFileAttributes,
+                            UINT64 AllocationSize,
+                            FSP_FSCTL_FILE_INFO *FileInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->Overwrite(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileAttributes, ReplaceFileAttributes, AllocationSize, FileInfo);)
+  }
+  static VOID Cleanup(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                      PWSTR FileName, ULONG Flags) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD_VOID(return self->Cleanup(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileName, Flags);)
+  }
+  static VOID Close(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD_VOID(return self->Close(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2);)
+  }
+  static NTSTATUS Read(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                       PVOID Buffer, UINT64 Offset, ULONG Length,
+                       PULONG PBytesTransferred) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->Read(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        Buffer, Offset, Length, PBytesTransferred);)
+  }
+  static NTSTATUS Write(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                        PVOID Buffer, UINT64 Offset, ULONG Length,
+                        BOOLEAN WriteToEndOfFile, BOOLEAN ConstrainedIo,
+                        PULONG PBytesTransferred,
+                        FSP_FSCTL_FILE_INFO *FileInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->Write(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        Buffer, Offset, Length, WriteToEndOfFile, ConstrainedIo,
+        PBytesTransferred, FileInfo);)
+  }
+  static NTSTATUS Flush(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                        FSP_FSCTL_FILE_INFO *FileInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->Flush(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileInfo);)
+  }
+  static NTSTATUS GetFileInfo(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                              FSP_FSCTL_FILE_INFO *FileInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->GetFileInfo(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileInfo);)
+  }
+  static NTSTATUS SetBasicInfo(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                               UINT32 FileAttributes, UINT64 CreationTime,
+                               UINT64 LastAccessTime, UINT64 LastWriteTime,
+                               UINT64 ChangeTime,
+                               FSP_FSCTL_FILE_INFO *FileInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->SetBasicInfo(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileAttributes, CreationTime, LastAccessTime, LastWriteTime, ChangeTime,
+        FileInfo);)
+  }
+  static NTSTATUS SetFileSize(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                              UINT64 NewSize, BOOLEAN SetAllocationSize,
+                              FSP_FSCTL_FILE_INFO *FileInfo) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->SetFileSize(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        NewSize, SetAllocationSize, FileInfo);)
+  }
+  static NTSTATUS CanDelete(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                            PWSTR FileName) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->CanDelete(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileName);)
+  }
+  static NTSTATUS Rename(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                         PWSTR FileName, PWSTR NewFileName,
+                         BOOLEAN ReplaceIfExists) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->Rename(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileName, NewFileName, ReplaceIfExists);)
+  }
+  static NTSTATUS GetSecurity(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                              PSECURITY_DESCRIPTOR SecurityDescriptor,
+                              SIZE_T *PSecurityDescriptorSize) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->GetSecurity(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        SecurityDescriptor, PSecurityDescriptorSize);)
+  }
+  static NTSTATUS SetSecurity(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                              SECURITY_INFORMATION SecurityInformation,
+                              PSECURITY_DESCRIPTOR ModificationDescriptor) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->SetSecurity(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        SecurityInformation, ModificationDescriptor);)
+  }
+  static NTSTATUS ReadDirectory(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                                PWSTR Pattern, PWSTR Marker, PVOID Buffer,
+                                ULONG Length, PULONG PBytesTransferred) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->ReadDirectory(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        Pattern, Marker, Buffer, Length, PBytesTransferred);)
+  }
+  static NTSTATUS ResolveReparsePoints(FSP_FILE_SYSTEM *FileSystem0,
+                                       PWSTR FileName, UINT32 ReparsePointIndex,
+                                       BOOLEAN ResolveLastPathComponent,
+                                       PIO_STATUS_BLOCK PIoStatus, PVOID Buffer,
+                                       PSIZE_T PSize) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->ResolveReparsePoints(
+        FileName, ReparsePointIndex, ResolveLastPathComponent, PIoStatus,
+        Buffer, PSize);)
+  }
+  static NTSTATUS GetReparsePoint(FSP_FILE_SYSTEM *FileSystem0,
+                                  PVOID FullContext, PWSTR FileName,
+                                  PVOID Buffer, PSIZE_T PSize) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->GetReparsePoint(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileName, Buffer, PSize);)
+  }
+  static NTSTATUS SetReparsePoint(FSP_FILE_SYSTEM *FileSystem0,
+                                  PVOID FullContext, PWSTR FileName,
+                                  PVOID Buffer, SIZE_T Size) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->SetReparsePoint(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileName, Buffer, Size);)
+  }
+  static NTSTATUS DeleteReparsePoint(FSP_FILE_SYSTEM *FileSystem0,
+                                     PVOID FullContext, PWSTR FileName,
+                                     PVOID Buffer, SIZE_T Size) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->DeleteReparsePoint(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        FileName, Buffer, Size);)
+  }
+  static NTSTATUS GetStreamInfo(FSP_FILE_SYSTEM *FileSystem0, PVOID FullContext,
+                                PVOID Buffer, ULONG Length,
+                                PULONG PBytesTransferred) {
+    FileSystemBase *self = (FileSystemBase *)FileSystem0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->GetStreamInfo(
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext,
+        (PVOID)(UINT_PTR)((FSP_FSCTL_TRANSACT_FULL_CONTEXT *)FullContext)
+            ->UserContext2,
+        Buffer, Length, PBytesTransferred);)
+  }
+  static FSP_FILE_SYSTEM_INTERFACE *Interface() {
+    static FSP_FILE_SYSTEM_INTERFACE _Interface = {
+        GetVolumeInfo,
+        SetVolumeLabel_,
+        GetSecurityByName,
+        Create,
+        Open,
+        Overwrite,
+        Cleanup,
+        Close,
+        Read,
+        Write,
+        Flush,
+        GetFileInfo,
+        SetBasicInfo,
+        SetFileSize,
+        CanDelete,
+        Rename,
+        GetSecurity,
+        SetSecurity,
+        ReadDirectory,
+        ResolveReparsePoints,
+        GetReparsePoint,
+        SetReparsePoint,
+        DeleteReparsePoint,
+        GetStreamInfo,
+    };
+    return &_Interface;
+  }
+
+private:
+  /* disallow copy and assignment */
+  FileSystemHost(const FileSystemHost &);
+  FileSystemHost &operator=(const FileSystemHost &);
+
+private:
+  FSP_FSCTL_VOLUME_PARAMS _VolumeParams;
+  FSP_FILE_SYSTEM *_FileSystemPtr;
+  FileSystemBase *_FileSystem;
+};
+
+class Service {
+public:
+  /* ctor/dtor */
+  Service(PWSTR ServiceName) : _Service(0) {
+    Initialize();
+    FspServiceCreate(ServiceName, OnStart, OnStop, 0, &_Service);
+    if (0 != _Service)
+      _Service->UserContext = this;
+  }
+  virtual ~Service() {
+    if (0 != _Service)
+      FspServiceDelete(_Service);
+  }
+
+  /* control */
+  ULONG Run() {
+    if (0 == _Service) {
+      FspServiceLog(EVENTLOG_ERROR_TYPE,
+                    L"The service cannot be created (Status=%lx).",
+                    STATUS_INSUFFICIENT_RESOURCES);
+      return FspWin32FromNtStatus(STATUS_INSUFFICIENT_RESOURCES);
+    }
+    FspServiceAllowConsoleMode(_Service);
+    NTSTATUS Result = FspServiceLoop(_Service);
+    ULONG ExitCode = FspServiceGetExitCode(_Service);
+    if (!NT_SUCCESS(Result)) {
+      FspServiceLog(EVENTLOG_ERROR_TYPE,
+                    L"The service has failed to run (Status=%lx).", Result);
+      return FspWin32FromNtStatus(Result);
+    }
+    return ExitCode;
+  }
+  VOID Stop() {
+    if (0 == _Service)
+      return;
+    FspServiceStop(_Service);
+  }
+  VOID RequestTime(ULONG Time) {
+    if (0 == _Service)
+      return;
+    FspServiceRequestTime(_Service, Time);
+  }
+  ULONG GetExitCode() {
+    return 0 != _Service ? FspServiceGetExitCode(_Service)
+                         : ERROR_NO_SYSTEM_RESOURCES;
+  }
+  VOID SetExitCode(ULONG ExitCode) {
+    if (0 == _Service)
+      return;
+    FspServiceSetExitCode(_Service, ExitCode);
+  }
+  FSP_SERVICE *ServiceHandle() { return _Service; }
+  static VOID Log(ULONG Type, PWSTR Format, ...) {
+    va_list ap;
+    va_start(ap, Format);
+    FspServiceLogV(Type, Format, ap);
+    va_end(ap);
+  }
+  static VOID LogV(ULONG Type, PWSTR Format, va_list ap) {
+    FspServiceLogV(Type, Format, ap);
+  }
+
+protected:
+  /* start/stop */
+  virtual NTSTATUS ExceptionHandler() {
+    return 0xE06D7363 /*STATUS_CPP_EH_EXCEPTION*/;
+  }
+  virtual NTSTATUS OnStart(ULONG Argc, PWSTR *Argv) { return STATUS_SUCCESS; }
+  virtual NTSTATUS OnStop() { return STATUS_SUCCESS; }
+
+private:
+  /* callbacks */
+  static NTSTATUS OnStart(FSP_SERVICE *Service0, ULONG Argc, PWSTR *Argv) {
+    Service *self = (Service *)Service0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->OnStart(Argc, Argv);)
+  }
+  static NTSTATUS OnStop(FSP_SERVICE *Service0) {
+    Service *self = (Service *)Service0->UserContext;
+    FSP_CPP_EXCEPTION_GUARD(return self->OnStop();)
+  }
+
+private:
+  /* disallow copy and assignment */
+  Service(const Service &);
+  Service &operator=(const Service &);
+
+private:
+  FSP_SERVICE *_Service;
+};
+
+} // namespace Fsp
+
+#undef FSP_CPP_EXCEPTION_GUARD
+#undef FSP_CPP_EXCEPTION_GUARD_VOID
+
+#endif

support/3rd_party/winfsp-2.0/lib/fuse.pc

@@ -0,0 +1,11 @@
+arch=x64 
+prefix=${pcfiledir}/..
+incdir=${prefix}/inc/fuse
+implib=${prefix}/bin/winfsp-${arch}.dll
+
+Name: fuse
+Description: WinFsp FUSE compatible API
+Version: 2.8
+URL: https://winfsp.dev
+Libs: "${implib}"
+Cflags: -I"${incdir}"

support/3rd_party/winfsp-2.0/lib/fuse3.pc

@@ -0,0 +1,11 @@
+arch=x64 
+prefix=${pcfiledir}/..
+incdir=${prefix}/inc/fuse3
+implib=${prefix}/bin/winfsp-${arch}.dll
+
+Name: fuse3
+Description: WinFsp FUSE3 compatible API
+Version: 3.2
+URL: https://winfsp.dev
+Libs: "${implib}"
+Cflags: -I"${incdir}"

support/include/utils/all.hpp

@@ -0,0 +1,59 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_ALL_HPP_
+#define REPERTORY_INCLUDE_UTILS_ALL_HPP_
+
+#include "utils/config.hpp"
+
+#include "utils/base64.hpp"
+#include "utils/collection.hpp"
+#if defined(_WIN32)
+#include "utils/com_init_wrapper.hpp"
+#endif // defined(_WIN32)
+#include "utils/common.hpp"
+#if defined(PROJECT_ENABLE_SQLITE)
+#include "utils/db/sqlite/db_common.hpp"
+#include "utils/db/sqlite/db_delete.hpp"
+#include "utils/db/sqlite/db_insert.hpp"
+#include "utils/db/sqlite/db_select.hpp"
+#include "utils/db/sqlite/db_update.hpp"
+#endif // defined(PROJECT_ENABLE_SQLITE)
+#if defined(PROJECT_ENABLE_LIBSODIUM)
+#include "utils/encrypting_reader.hpp"
+#include "utils/encryption.hpp"
+#endif // defined(PROJECT_ENABLE_LIBSODIUM)
+#include "utils/error.hpp"
+#include "utils/file.hpp"
+#if defined(PROJECT_ENABLE_LIBSODIUM)
+#include "utils/hash.hpp"
+#endif // defined(PROJECT_ENABLE_LIBSODIUM)
+#include "utils/path.hpp"
+#include "utils/string.hpp"
+#include "utils/time.hpp"
+#if !defined(_WIN32)
+#include "utils/unix.hpp"
+#endif // !defined(_WIN32)
+#if defined(_WIN32)
+#include "utils/windows.hpp"
+#endif // defined(_WIN32)
+
+#endif // REPERTORY_INCLUDE_UTILS_ALL_HPP_

support/include/utils/base64.hpp

@@ -0,0 +1,174 @@
+// NOLINTBEGIN
+#ifndef _MACARON_BASE64_H_
+#define _MACARON_BASE64_H_
+
+/**
+ * The MIT License (MIT)
+ * Copyright (c) 2016 tomykaira
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+#ifdef __clang__
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wunknown-warning-option"
+#endif
+
+#ifdef __GNUC__
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wconversion"
+#pragma GCC diagnostic ignored "-Wold-style-cast"
+#pragma GCC diagnostic ignored "-Wuseless-cast"
+#endif
+
+#include <array>
+#include <string>
+#include <vector>
+
+namespace macaron::Base64 {
+static std::string Encode(const unsigned char *data, std::size_t len) {
+  static constexpr std::array<unsigned char, 64U> sEncodingTable{
+      'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
+      'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
+      'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
+      'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z',
+      '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '+', '/',
+  };
+
+  auto in_len{len};
+  std::string ret;
+  if (in_len > 0) {
+    std::size_t out_len{4U * ((in_len + 2U) / 3U)};
+    ret = std::string(out_len, '\0');
+    std::size_t i;
+    auto *p = reinterpret_cast<unsigned char *>(ret.data());
+
+    for (i = 0U; i < in_len - 2U; i += 3U) {
+      *p++ = sEncodingTable[(data[i] >> 2U) & 0x3F];
+      *p++ = sEncodingTable[((data[i] & 0x3) << 4U) |
+                            ((int)(data[i + 1U] & 0xF0) >> 4U)];
+      *p++ = sEncodingTable[((data[i + 1] & 0xF) << 2) |
+                            ((int)(data[i + 2U] & 0xC0) >> 6U)];
+      *p++ = sEncodingTable[data[i + 2U] & 0x3F];
+    }
+    if (i < in_len) {
+      *p++ = sEncodingTable[(data[i] >> 2U) & 0x3F];
+      if (i == (in_len - 1U)) {
+        *p++ = sEncodingTable[((data[i] & 0x3) << 4U)];
+        *p++ = '=';
+      } else {
+        *p++ = sEncodingTable[((data[i] & 0x3) << 4U) |
+                              ((int)(data[i + 1U] & 0xF0) >> 4U)];
+        *p++ = sEncodingTable[((data[i + 1U] & 0xF) << 2U)];
+      }
+      *p++ = '=';
+    }
+  }
+
+  return ret;
+}
+
+[[maybe_unused]] static std::string Encode(std::string_view data) {
+  return Encode(reinterpret_cast<const unsigned char *>(data.data()),
+                data.size());
+}
+
+[[maybe_unused]] static std::vector<unsigned char>
+Decode(std::string_view input) {
+  static constexpr std::array<unsigned char, 256> kDecodingTable{
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 62, 64, 64, 64, 63, 52, 53, 54, 55, 56, 57,
+      58, 59, 60, 61, 64, 64, 64, 64, 64, 64, 64, 0,  1,  2,  3,  4,  5,  6,
+      7,  8,  9,  10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24,
+      25, 64, 64, 64, 64, 64, 64, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36,
+      37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64,
+      64, 64, 64, 64,
+  };
+
+  std::vector<unsigned char> out;
+  if (not input.empty()) {
+    auto in_len{input.size()};
+    if (in_len % 4U != 0U) {
+      throw std::runtime_error("Input data size is not a multiple of 4");
+    }
+
+    std::size_t out_len{in_len / 4U * 3U};
+    if (input[in_len - 1U] == '=') {
+      out_len--;
+    }
+    if (input[in_len - 2U] == '=') {
+      out_len--;
+    }
+
+    out.resize(out_len);
+
+    for (std::size_t i = 0U, j = 0U; i < in_len;) {
+      std::uint32_t a =
+          input.at(i) == '='
+              ? 0U & i++
+              : kDecodingTable[static_cast<unsigned char>(input.at(i++))];
+      std::uint32_t b =
+          input.at(i) == '='
+              ? 0U & i++
+              : kDecodingTable[static_cast<unsigned char>(input.at(i++))];
+      std::uint32_t c =
+          input.at(i) == '='
+              ? 0U & i++
+              : kDecodingTable[static_cast<unsigned char>(input.at(i++))];
+      std::uint32_t d =
+          input.at(i) == '='
+              ? 0U & i++
+              : kDecodingTable[static_cast<unsigned char>(input.at(i++))];
+
+      std::uint32_t triple =
+          (a << 3U * 6U) + (b << 2U * 6U) + (c << 1U * 6U) + (d << 0U * 6U);
+
+      if (j < out_len)
+        out[j++] = (triple >> 2U * 8U) & 0xFF;
+      if (j < out_len)
+        out[j++] = (triple >> 1U * 8U) & 0xFF;
+      if (j < out_len)
+        out[j++] = (triple >> 0U * 8U) & 0xFF;
+    }
+  }
+
+  return out;
+}
+} // namespace macaron::Base64
+
+#ifdef __GNUC__
+#pragma GCC diagnostic pop
+#endif
+
+#ifdef __clang__
+#pragma clang diagnostic pop
+#endif
+
+#endif /* _MACARON_BASE64_H_ */
+
+// NOLINTEND

support/include/utils/collection.hpp

@@ -0,0 +1,178 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_COLLECTION_HPP_
+#define REPERTORY_INCLUDE_UTILS_COLLECTION_HPP_
+
+#include "utils/config.hpp"
+
+#include "utils/error.hpp"
+#include "utils/string.hpp"
+
+namespace repertory::utils::collection {
+template <typename col_t>
+[[nodiscard]] inline auto excludes(const col_t &collection,
+                                   const typename col_t::value_type &val)
+    -> bool;
+
+template <typename col_t>
+[[nodiscard]] inline auto includes(const col_t &collection,
+                                   const typename col_t::value_type &val)
+    -> bool;
+
+template <typename val_t>
+[[nodiscard]] inline auto from_hex_string(std::string_view str, val_t &val)
+    -> bool;
+
+template <typename val_t>
+[[nodiscard]] inline auto from_hex_string(std::wstring_view str, val_t &val)
+    -> bool;
+template <typename col_t>
+inline auto remove_element(col_t &collection,
+                           const typename col_t::value_type &value) -> col_t &;
+
+template <typename col_t>
+[[nodiscard]] inline auto to_hex_string(const col_t &collection) -> std::string;
+
+template <typename col_t>
+[[nodiscard]] inline auto to_hex_wstring(const col_t &collection)
+    -> std::wstring;
+
+template <typename col_t>
+inline auto excludes(const col_t &collection,
+                     const typename col_t::value_type &val) -> bool {
+  return std::find(collection.begin(), collection.end(), val) ==
+         collection.end();
+}
+
+template <typename col_t>
+inline auto includes(const col_t &collection,
+                     const typename col_t::value_type &val) -> bool {
+  return std::find(collection.begin(), collection.end(), val) !=
+         collection.end();
+}
+
+template <typename val_t>
+[[nodiscard]] inline auto from_hex_string_t(std::string_view str, val_t &val)
+    -> bool {
+  REPERTORY_USES_FUNCTION_NAME();
+
+  static constexpr const auto base16{16};
+
+  try {
+    val.clear();
+
+    std::string fmt_val{str};
+    utils::string::trim(fmt_val);
+    if (fmt_val.empty()) {
+      return true;
+    }
+
+    fmt_val = utils::string::to_lower(fmt_val);
+    if (utils::string::begins_with(fmt_val, "0x")) {
+      fmt_val = fmt_val.substr(2U);
+    }
+
+    if (fmt_val.empty()) {
+      throw utils::error::create_exception(function_name,
+                                           {
+                                               "hex string is invalid",
+                                               str,
+                                           });
+    }
+
+    if (fmt_val.length() % 2U) {
+      fmt_val = '0' + fmt_val;
+    }
+
+    auto iter = std::find_if_not(
+        fmt_val.begin(), fmt_val.end(), [](auto cur_char) -> bool {
+          auto check = static_cast<std::uint32_t>(cur_char);
+          return ((check >= 48U && check <= 57U) ||
+                  (check >= 97U && check <= 102U));
+        });
+    if (iter != fmt_val.end()) {
+      auto invalid_idx{std::distance(fmt_val.begin(), iter)};
+      throw std::range_error(utils::error::create_error_message({
+          function_name,
+          "invalid character in hex string",
+          std::to_string(invalid_idx),
+          std::string(1U, str.at(invalid_idx)),
+          str,
+      }));
+    }
+
+    val.resize(fmt_val.length() / 2U);
+    for (std::size_t idx = 0U; idx < fmt_val.length(); idx += 2U) {
+      val.at(idx / 2U) = static_cast<typename val_t::value_type>(
+          std::strtoul(fmt_val.substr(idx, 2U).c_str(), nullptr, base16));
+    }
+
+    return true;
+  } catch (const std::exception &e) {
+    utils::error::handle_exception(function_name, e);
+  } catch (...) {
+    utils::error::handle_exception(function_name);
+  }
+
+  val.clear();
+  return false;
+}
+template <typename val_t>
+inline auto from_hex_string(std::string_view str, val_t &val) -> bool {
+  return from_hex_string_t<val_t>(str, val);
+}
+
+template <typename val_t>
+inline auto from_hex_string(std::wstring_view str, val_t &val) -> bool {
+  return from_hex_string_t<val_t>(utils::string::to_utf8(str), val);
+}
+
+template <typename col_t>
+inline auto remove_element(col_t &collection,
+                           const typename col_t::value_type &value) -> col_t & {
+  collection.erase(std::remove(collection.begin(), collection.end(), value),
+                   collection.end());
+  return collection;
+}
+
+template <typename col_t>
+inline auto to_hex_string(const col_t &collection) -> std::string {
+  static_assert(sizeof(typename col_t::value_type) == 1U,
+                "value_type must be 1 byte in size");
+  static constexpr const auto mask = 0xFF;
+
+  std::stringstream stream{};
+  for (auto &&val : collection) {
+    stream << std::setfill('0') << std::setw(2) << std::hex
+           << (static_cast<std::uint32_t>(val) & mask);
+  }
+
+  return stream.str();
+}
+
+template <typename col_t>
+inline auto to_hex_wstring(const col_t &collection) -> std::wstring {
+  return utils::string::from_utf8(to_hex_string<col_t>(collection));
+}
+} // namespace repertory::utils::collection
+
+#endif // REPERTORY_INCLUDE_UTILS_COLLECTION_HPP_

support/include/utils/com_init_wrapper.hpp

@@ -0,0 +1,54 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_COM_INIT_WRAPPER_HPP_
+#define REPERTORY_INCLUDE_UTILS_COM_INIT_WRAPPER_HPP_
+#if defined(_WIN32)
+
+#include "utils/config.hpp"
+
+namespace repertory::utils {
+struct com_init_wrapper final {
+  com_init_wrapper()
+      : initialized_(
+            SUCCEEDED(::CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED))) {}
+
+  com_init_wrapper(const com_init_wrapper &) = delete;
+  com_init_wrapper(com_init_wrapper &&) = delete;
+
+  ~com_init_wrapper() {
+    if (initialized_) {
+      ::CoUninitialize();
+    }
+  }
+
+  auto operator=(const com_init_wrapper &) -> com_init_wrapper & = delete;
+  auto operator=(com_init_wrapper &&) -> com_init_wrapper & = delete;
+
+  [[nodiscard]] auto is_initialized() const -> bool { return initialized_; }
+
+private:
+  BOOL initialized_;
+};
+} // namespace repertory::utils
+
+#endif // defined(_WIN32)
+#endif // REPERTORY_INCLUDE_UTILS_COM_INIT_WRAPPER_HPP_

support/include/utils/common.hpp

@@ -0,0 +1,145 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_COMMON_HPP_
+#define REPERTORY_INCLUDE_UTILS_COMMON_HPP_
+
+#include "utils/config.hpp"
+
+namespace repertory::utils {
+struct result final {
+  std::string function_name;
+  bool ok{true};
+  std::string reason{"success"};
+
+  [[nodiscard]] operator bool() const { return ok; }
+};
+
+using retryable_action_t = std::function<bool()>;
+
+[[nodiscard]] inline constexpr auto
+calculate_read_size(std::uint64_t total_size, std::size_t read_size,
+                    std::uint64_t offset) -> std::size_t {
+  return static_cast<std::size_t>(
+      ((offset + read_size) > total_size)
+          ? ((offset < total_size) ? total_size - offset : 0U)
+          : read_size);
+}
+
+[[nodiscard]] auto compare_version_strings(std::string version1,
+                                           std::string version2)
+    -> std::int32_t;
+
+[[nodiscard]] auto compare_version_strings(std::wstring_view version1,
+                                           std::wstring_view version2)
+    -> std::int32_t;
+
+#if defined(PROJECT_ENABLE_STDUUID)
+[[nodiscard]] auto create_uuid_string() -> std::string;
+
+[[nodiscard]] auto create_uuid_wstring() -> std::wstring;
+#endif // defined(PROJECT_ENABLE_STDUUID)
+
+template <typename result_t, typename data_t>
+[[nodiscard]] inline constexpr auto divide_with_ceiling(result_t numerator,
+                                                        data_t denominator)
+    -> result_t;
+
+template <typename data_t>
+[[nodiscard]] inline auto generate_random_between(data_t begin, data_t end)
+    -> data_t;
+
+[[nodiscard]] auto generate_random_string(std::size_t length) -> std::string;
+
+[[nodiscard]] auto generate_random_wstring(std::size_t length) -> std::wstring;
+
+#if defined(PROJECT_ENABLE_LIBSODIUM)
+template <typename data_t>
+[[nodiscard]] inline auto generate_secure_random() -> data_t;
+
+template <typename data_t>
+[[nodiscard]] inline auto generate_secure_random(std::size_t size) -> data_t;
+#endif // defined(PROJECT_ENABLE_LIBSODIUM)
+
+[[nodiscard]] auto get_environment_variable(std::string_view variable)
+    -> std::string;
+
+[[nodiscard]] auto get_environment_variable(std::wstring_view variable)
+    -> std::wstring;
+
+#if defined(PROJECT_ENABLE_BOOST)
+[[nodiscard]] auto get_next_available_port(std::uint16_t first_port,
+                                           std::uint16_t &available_port)
+    -> bool;
+#endif // defined(PROJECT_ENABLE_BOOST)
+
+[[nodiscard]] auto retry_action(
+    retryable_action_t action, std::size_t retry_count = 200U,
+    std::chrono::milliseconds retry_wait = std::chrono::milliseconds(10))
+    -> bool;
+
+template <typename result_t, typename data_t>
+inline constexpr auto divide_with_ceiling(result_t numerator,
+                                          data_t denominator) -> result_t {
+  static_assert(std::is_integral_v<std::remove_cv_t<data_t>>,
+                "denominator must be an integral type");
+
+  return denominator == 0
+             ? 0
+             : (numerator / denominator) + (numerator % denominator != 0);
+}
+
+template <typename data_t>
+inline auto generate_random_between(data_t begin, data_t end) -> data_t {
+  static_assert(std::is_integral_v<std::remove_cv_t<data_t>>,
+                "data_t must be an integral type");
+  if (end <= begin) {
+    throw std::range_error("end must be greater than begin");
+  }
+
+  thread_local std::mt19937 gen(
+      static_cast<unsigned long>(std::time(nullptr) ^ std::random_device{}()));
+  std::uniform_int_distribution<data_t> dis(begin, end);
+  return dis(gen);
+}
+
+#if defined(PROJECT_ENABLE_LIBSODIUM)
+template <typename data_t> inline auto generate_secure_random() -> data_t {
+  static_assert(!is_collection<std::decay_t<data_t>>::value,
+                "data_t is a vector or collection");
+  data_t ret{};
+  randombytes_buf(&ret, sizeof(ret));
+  return ret;
+}
+
+template <typename data_t>
+inline auto generate_secure_random(std::size_t size) -> data_t {
+  static_assert(is_collection<std::decay_t<data_t>>::value,
+                "data_t is not a vector or collection");
+  data_t ret;
+  ret.resize(size);
+  randombytes_buf(ret.data(), ret.size() * sizeof(typename data_t::value_type));
+  return ret;
+}
+#endif // defined(PROJECT_ENABLE_LIBSODIUM)
+} // namespace repertory::utils
+
+#endif // REPERTORY_INCLUDE_UTILS_COMMON_HPP_

support/include/utils/config.hpp

@@ -0,0 +1,483 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_CONFIG_HPP_
+#define REPERTORY_INCLUDE_UTILS_CONFIG_HPP_
+
+#define NOMINMAX
+
+#if defined(_WIN32)
+#define WINVER 0x0602
+#define _WIN32_WINNT WINVER
+#define WIN32_LEAN_AND_MEAN
+
+#include <winsock2.h>
+#include <ws2tcpip.h>
+
+#include <windows.h>
+#if defined(PROJECT_ENABLE_WINFSP)
+#include <sddl.h>
+#endif // defined(PROJECT_ENABLE_WINFSP)
+
+#include <direct.h>
+#if !defined(__cplusplus)
+#include <errno.h>
+#endif // !defined(__cplusplus)
+#include <fcntl.h>
+#include <io.h>
+#include <iphlpapi.h>
+#include <objbase.h>
+#include <psapi.h>
+#include <rpc.h>
+#include <share.h>
+#include <shellapi.h>
+#include <shlobj.h>
+#include <shlwapi.h>
+#if !defined(__cplusplus)
+#include <stdio.h>
+#endif // !defined(__cplusplus)
+#include <sys/stat.h>
+#include <sys/types.h>
+#if !defined(__cplusplus)
+#include <time.h>
+#endif // !defined(__cplusplus)
+#else  // !defined(_WIN32)
+#include <arpa/inet.h>
+#include <dirent.h>
+#include <fcntl.h>
+#include <grp.h>
+#include <libgen.h>
+#include <netinet/in.h>
+#include <pwd.h>
+#include <sys/file.h>
+#include <sys/socket.h>
+#if defined(__LFS64__)
+#include <sys/stat64.h>
+#else // !defined(__LFS64__)
+#include <sys/stat.h>
+#endif // defined(__LFS64__)
+
+#if defined(__linux__)
+#include <sys/statfs.h>
+#endif //  defined(HAS_SETXATTR)
+
+#if defined(HAS_SETXATTR)
+#include <sys/types.h>
+#include <sys/xattr.h>
+#endif // defined(HAS_SETXATTR)
+
+#if defined(__APPLE__)
+#include <libproc.h>
+#include <sys/attr.h>
+#include <sys/mount.h>
+#include <sys/statvfs.h>
+#include <sys/vnode.h>
+#endif // defined(__APPLE__)
+
+#include <unistd.h>
+#endif // defined(_WIN32)
+
+#if defined(HAS_WORDEXP_H)
+#include <wordexp.h>
+#endif // defined(HAS_WORDEXP_H)
+
+#if defined(__cplusplus)
+#include <algorithm>
+#include <array>
+#include <atomic>
+#include <bit>
+#include <cerrno>
+#include <chrono>
+#include <ciso646>
+#include <climits>
+#include <codecvt>
+#include <condition_variable>
+#include <csignal>
+#include <cstdint>
+#include <cstdio>
+#include <cstdlib>
+#include <cstring>
+#include <ctime>
+#include <deque>
+#include <filesystem>
+#include <fstream>
+#include <functional>
+#include <future>
+#include <iomanip>
+#include <iostream>
+#include <iterator>
+#include <limits>
+#include <locale>
+#include <map>
+#include <memory>
+#include <mutex>
+#include <numeric>
+#include <optional>
+#include <ostream>
+#include <queue>
+#include <random>
+#include <ranges>
+#include <regex>
+#include <span>
+#include <sstream>
+#include <stdexcept>
+#include <string>
+#include <string_view>
+#include <thread>
+#include <type_traits>
+#include <unordered_map>
+#include <utility>
+#include <variant>
+#include <vector>
+#endif // defined(__cplusplus)
+
+#if defined(PROJECT_ENABLE_CURL)
+#include "curl/curl.h"
+#include "curl/multi.h"
+#endif // defined(PROJECT_ENABLE_CURL)
+
+#if defined(PROJECT_ENABLE_FUSE)
+#if FUSE_USE_VERSION >= 30
+#include <fuse.h>
+#include <fuse_lowlevel.h>
+#else
+#include <fuse/fuse.h>
+#endif
+#endif // defined(PROJECT_ENABLE_FUSE)
+
+#if defined(PROJECT_ENABLE_FZF)
+#if defined(__cplusplus)
+extern "C" {
+#endif // defined(__cplusplus)
+#include "fzf.h"
+#if defined(__cplusplus)
+}
+#endif // defined(__cplusplus)
+#endif // defined(PROJECT_ENABLE_FZF)
+
+#if defined(PROJECT_ENABLE_OPENSSL)
+#include "openssl/ssl.h"
+#endif // defined(PROJECT_ENABLE_OPENSSL)
+
+#if defined(PROJECT_ENABLE_LIBDSM)
+#if defined(__cplusplus)
+extern "C" {
+#endif // defined(__cplusplus)
+#include "bdsm/bdsm.h"
+#if defined(__cplusplus)
+}
+
+struct netbios_ns_deleter final {
+  void operator()(netbios_ns *ns) const {
+    if (ns != nullptr) {
+      netbios_ns_destroy(ns);
+    }
+  }
+};
+using netbios_ns_t = std::unique_ptr<netbios_ns, netbios_ns_deleter>;
+
+inline const auto smb_session_deleter = [](smb_session *session) {
+  if (session != nullptr) {
+    smb_session_destroy(session);
+  }
+};
+using smb_session_t = std::shared_ptr<smb_session>;
+
+struct smb_stat_deleter final {
+  void operator()(smb_stat st) const {
+    if (st != nullptr) {
+      smb_stat_destroy(st);
+    }
+  }
+};
+using smb_stat_t = std::unique_ptr<smb_file, smb_stat_deleter>;
+
+struct smb_stat_list_deleter final {
+  void operator()(smb_file *list) const {
+    if (list != nullptr) {
+      smb_stat_list_destroy(list);
+    }
+  }
+};
+using smb_stat_list_t = std::unique_ptr<smb_file, smb_stat_list_deleter>;
+#endif // defined(__cplusplus)
+#endif // defined(PROJECT_ENABLE_LIBDSM)
+
+#if defined(PROJECT_ENABLE_LIBEVENT)
+#include "event2/buffer.h"
+#include "event2/bufferevent.h"
+#include "event2/listener.h"
+#include "event2/thread.h"
+#include "event2/util.h"
+#endif // defined(PROJECT_ENABLE_LIBEVENT)
+
+#if defined(PROJECT_ENABLE_LIBSODIUM)
+#include "sodium.h"
+#endif // defined(PROJECT_ENABLE_LIBSODIUM)
+
+#if defined(PROJECT_ENABLE_SDL)
+#include "SDL.h"
+#include "SDL_gamecontroller.h"
+#include "SDL_joystick.h"
+#endif // defined(PROJECT_ENABLE_SDL)
+
+#if defined(PROJECT_ENABLE_SQLITE)
+#include "sqlite3.h"
+#endif // defined(PROJECT_ENABLE_SQLITE)
+
+#if defined(PROJECT_ENABLE_VLC)
+#include <vlc/vlc.h>
+
+#if defined(__cplusplus)
+[[nodiscard]] inline auto get_libvlc_error_msg() -> std::string {
+  const auto *msg = libvlc_errmsg();
+  return msg == nullptr ? "none" : msg;
+}
+
+struct vlc_deleter final {
+  void operator()(libvlc_instance_t *inst) const {
+    if (inst != nullptr) {
+      libvlc_release(inst);
+    }
+  }
+};
+using vlc_t = std::unique_ptr<libvlc_instance_t, vlc_deleter>;
+
+struct vlc_media_deleter final {
+  void operator()(libvlc_media_t *media) const {
+    if (media != nullptr) {
+      libvlc_media_release(media);
+    }
+  }
+};
+using vlc_media_t = std::unique_ptr<libvlc_media_t, vlc_media_deleter>;
+
+struct vlc_media_list_deleter final {
+  void operator()(libvlc_media_list_t *media_list) const {
+    if (media_list != nullptr) {
+      libvlc_media_list_release(media_list);
+    }
+  }
+};
+using vlc_media_list_t =
+    std::unique_ptr<libvlc_media_list_t, vlc_media_list_deleter>;
+
+struct vlc_string_deleter final {
+  void operator()(char *str) const {
+    if (str != nullptr) {
+      libvlc_free(str);
+    }
+  }
+};
+using vlc_string_t = std::unique_ptr<char, vlc_string_deleter>;
+#endif // defined(__cplusplus)
+#endif // defined(PROJECT_ENABLE_VLC)
+
+#if !defined(fstat64)
+#define fstat64 fstat
+#endif // !defined(fstat64)
+
+#if !defined(pread64)
+#define pread64 pread
+#endif // !defined(pread64)
+
+#if !defined(pwrite64)
+#define pwrite64 pwrite
+#endif // !defined(pwrite64)
+
+#if !defined(stat64)
+#define stat64 stat
+#endif // !defined(stat64)
+
+#if !defined(statfs64)
+#define statfs64 statfs
+#endif // !defined(statfs64)
+
+#if !defined(off64_t)
+#define off64_t std::size_t
+#endif // !defined(off64_t)
+
+#if !defined(__off64_t)
+#define __off64_t off64_t
+#endif // !defined(__off64_t)
+
+#if defined(__cplusplus)
+#if defined(PROJECT_ENABLE_BOOST)
+#include "boost/archive/text_iarchive.hpp"
+#include "boost/archive/text_oarchive.hpp"
+#include "boost/asio.hpp"
+#include "boost/asio/io_context.hpp"
+#include "boost/bind/bind.hpp"
+#include "boost/dynamic_bitset.hpp"
+#include "boost/dynamic_bitset/serialization.hpp"
+#include "boost/endian/conversion.hpp"
+#include "boost/integer.hpp"
+#include "boost/interprocess/sync/named_mutex.hpp"
+#include "boost/interprocess/sync/scoped_lock.hpp"
+#include "boost/multiprecision/cpp_dec_float.hpp"
+#include "boost/multiprecision/cpp_int.hpp"
+#include "boost/serialization/vector.hpp"
+#endif // defined(PROJECT_ENABLE_BOOST)
+
+#if defined(PROJECT_ENABLE_CLI11)
+#if defined(PROJECT_IS_MINGW) && !defined(PROJECT_IS_MINGW_UNIX)
+#include "CLI/CLI.hpp"
+#else // !defined(PROJECT_IS_MINGW) || defined(PROJECT_IS_MINGW_UNIX)
+#include "CLI11.hpp"
+#endif // defined(PROJECT_IS_MINGW) && !defined(PROJECT_IS_MINGW_UNIX)
+#endif // defined(PROJECT_ENABLE_CLI11)
+
+#if defined(PROJECT_ENABLE_CPP_HTTPLIB)
+#include "httplib.h"
+#endif // defined(PROJECT_ENABLE_JSON)
+
+#if defined(PROJECT_ENABLE_DTL)
+#include "dtl/dtl.hpp"
+#endif // defined(PROJECT_ENABLE_DTL)
+
+#if defined(PROJECT_ENABLE_JSON)
+#include "json.hpp"
+#endif // defined(PROJECT_ENABLE_JSON)
+
+#if defined(PROJECT_ENABLE_NANA)
+#include "nana/gui.hpp"
+#include "nana/gui/timer.hpp"
+#include "nana/gui/widgets/button.hpp"
+#include "nana/gui/widgets/combox.hpp"
+#include "nana/gui/widgets/group.hpp"
+#include "nana/gui/widgets/label.hpp"
+#include "nana/gui/widgets/panel.hpp"
+#include "nana/gui/widgets/picture.hpp"
+#include "nana/gui/widgets/tabbar.hpp"
+#endif // defined(PROJECT_ENABLE_NANA)
+
+#if defined(PROJECT_ENABLE_PUGIXML)
+#include "pugixml.hpp"
+#endif // defined(PROJECT_ENABLE_PUGIXML)
+
+#if defined(PROJECT_ENABLE_ROCKSDB)
+#include "rocksdb/db.h"
+#include "rocksdb/utilities/transaction_db.h"
+#endif // defined(PROJECT_ENABLE_ROCKSDB)
+
+#if defined(PROJECT_ENABLE_SFML)
+#include "RoundedRectangleShape.hpp"
+#include "SFML/Graphics.hpp"
+#include "Text2.hpp"
+#endif // defined(PROJECT_ENABLE_SFML)
+
+#if defined(PROJECT_ENABLE_SAGO_PLATFORM_FOLDERS)
+#include "platform_folders.hpp"
+#endif // defined(PROJECT_ENABLE_SAGO_PLATFORM_FOLDERS)
+
+#if defined(PROJECT_ENABLE_SPDLOG)
+#include "spdlog/async.h"
+#include "spdlog/fmt/bundled/core.h"
+#include "spdlog/fmt/bundled/format.h"
+#include "spdlog/fmt/bundled/ranges.h"
+#include "spdlog/fmt/chrono.h"
+#include "spdlog/sinks/rotating_file_sink.h"
+#include "spdlog/sinks/stdout_color_sinks.h"
+#include "spdlog/spdlog.h"
+#endif // defined(PROJECT_ENABLE_SPDLOG)
+
+#if defined(PROJECT_ENABLE_STDUUID)
+#include "uuid.h"
+#endif // defined(PROJECT_ENABLE_STDUUID)
+
+#if defined(PROJECT_ENABLE_TPL)
+#include "process.hpp"
+#endif // defined(PROJECT_ENABLE_TPL)
+
+#if defined(PROJECT_ENABLE_WINFSP)
+#include "winfsp/winfsp.hpp"
+#endif // defined(PROJECT_ENABLE_WINFSP)
+
+namespace repertory {
+using data_buffer = std::vector<unsigned char>;
+using mutex_lock = std::lock_guard<std::mutex>;
+using recur_mutex_lock = std::lock_guard<std::recursive_mutex>;
+using stop_type = std::atomic_bool;
+using unique_mutex_lock = std::unique_lock<std::mutex>;
+using unique_recur_mutex_lock = std::unique_lock<std::recursive_mutex>;
+
+#if defined(_WIN32)
+#if defined(PROJECT_ENABLE_WIN32_LONG_PATH_NAMES)
+inline constexpr const auto max_path_length = std::size_t{32767U};
+#else  // !defined(PROJECT_ENABLE_WIN32_LONG_PATH_NAMES)
+inline constexpr const auto max_path_length = std::size_t{MAX_PATH};
+#endif // defined(PROJECT_ENABLE_WIN32_LONG_PATH_NAMES)
+
+using native_handle = HANDLE;
+#else // !defined(_WIN32)
+inline constexpr const auto max_path_length = std::size_t{PATH_MAX};
+using native_handle = int;
+#if !defined(INVALID_HANDLE_VALUE)
+#define INVALID_HANDLE_VALUE (-1)
+#endif // !defined(INVALID_HANDLE_VALUE)
+#endif // defined(_WIN32)
+
+template <class... Ts> struct overloaded : Ts... {
+  using Ts::operator()...;
+};
+template <class... Ts> overloaded(Ts...) -> overloaded<Ts...>;
+
+template <typename T> struct is_collection {
+  static const bool value = false;
+};
+
+template <typename T, typename A>
+struct is_collection<std::vector<T, A>> : std::true_type {};
+
+template <typename T> struct is_collection<std::deque<T>> : std::true_type {};
+
+template <> struct is_collection<std::string> : std::true_type {};
+
+template <> struct is_collection<std::wstring> : std::true_type {};
+
+struct file_deleter final {
+  void operator()(FILE *file) {
+    if (file != nullptr) {
+      fclose(file);
+    }
+  }
+};
+using file_t = std::unique_ptr<FILE, file_deleter>;
+
+#if defined(PROJECT_ENABLE_CURL)
+struct http_range final {
+  std::uint64_t begin{};
+  std::uint64_t end{};
+};
+
+using http_headers = std::unordered_map<std::string, std::string>;
+using http_query_parameters = std::map<std::string, std::string>;
+using http_ranges = std::vector<http_range>;
+#endif // defined(PROJECT_ENABLE_CURL)
+} // namespace repertory
+#endif // defined(__cplusplus)
+
+#define REPERTORY_USES_FUNCTION_NAME()                                         \
+  static constexpr const std::string_view function_name {                      \
+    static_cast<const char *>(__FUNCTION__),                                   \
+  }
+
+#endif // REPERTORY_INCLUDE_UTILS_CONFIG_HPP_

support/include/utils/db/sqlite/db_common.hpp

@@ -0,0 +1,170 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_COMMON_HPP_
+#define REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_COMMON_HPP_
+#if defined(PROJECT_ENABLE_SQLITE)
+
+#include "utils/config.hpp"
+
+#include "utils/error.hpp"
+
+namespace repertory::utils::db::sqlite {
+using db_types_t = std::variant<std::int64_t, std::string>;
+
+struct sqlite3_deleter final {
+  void operator()(sqlite3 *db3) const;
+};
+
+using db3_t = std::unique_ptr<sqlite3, sqlite3_deleter>;
+
+struct sqlite3_statement_deleter final {
+  void operator()(sqlite3_stmt *stmt) const {
+    if (stmt != nullptr) {
+      sqlite3_finalize(stmt);
+    }
+  }
+};
+
+using db3_stmt_t = std::unique_ptr<sqlite3_stmt, sqlite3_statement_deleter>;
+
+[[nodiscard]] auto
+create_db(std::string db_path,
+          const std::map<std::string, std::string> &sql_create_tables) -> db3_t;
+
+[[nodiscard]] auto execute_sql(sqlite3 &db3, const std::string &sql,
+                               std::string &err) -> bool;
+
+void set_journal_mode(sqlite3 &db3);
+
+struct db_comp_data_t final {
+  std::string column_name;
+  std::string op_type;
+};
+
+struct db_context_t {
+  db_context_t(sqlite3 *db3_, std::string table_name_)
+      : db3(db3_), table_name(std::move(table_name_)) {}
+
+  sqlite3 *db3{};
+  std::string table_name;
+};
+
+struct db_result final {
+  struct context final {
+    db3_stmt_t stmt;
+  };
+
+  class db_column final {
+  public:
+    db_column(std::int32_t index, std::string name, db_types_t value) noexcept;
+
+    db_column() noexcept = default;
+    db_column(const db_column &) = default;
+    db_column(db_column &&column) noexcept = default;
+
+    ~db_column() = default;
+
+    auto operator=(const db_column &) -> db_column & = default;
+    auto operator=(db_column &&) -> db_column & = default;
+
+  private:
+    std::int32_t index_{};
+    std::string name_;
+    db_types_t value_;
+
+  public:
+    [[nodiscard]] auto get_index() const -> std::int32_t { return index_; }
+
+    [[nodiscard]] auto get_name() const -> std::string { return name_; }
+
+    template <typename data_type>
+    [[nodiscard]] auto get_value() const -> data_type {
+      REPERTORY_USES_FUNCTION_NAME();
+
+      return std::visit(
+          overloaded{
+              [](const data_type &value) -> data_type { return value; },
+              [](auto &&) -> data_type {
+                throw utils::error::create_exception(
+                    function_name, {
+                                       "data type not supported",
+                                   });
+              },
+          },
+          value_);
+    }
+
+#if defined(PROJECT_ENABLE_JSON)
+    [[nodiscard]] auto get_value_as_json() const -> nlohmann::json;
+#endif // defined(PROJECT_ENABLE_JSON)
+  };
+
+  class db_row final {
+  public:
+    db_row(std::shared_ptr<context> ctx);
+
+  private:
+    std::map<std::string, db_column> columns_;
+
+  public:
+    [[nodiscard]] auto get_columns() const -> std::vector<db_column>;
+
+    [[nodiscard]] auto get_column(std::int32_t index) const -> db_column;
+
+    [[nodiscard]] auto get_column(std::string name) const -> db_column;
+  };
+
+  db_result(db3_stmt_t stmt, std::int32_t res);
+
+  db_result() = default;
+  db_result(const db_result &) = default;
+  db_result(db_result &&) noexcept = default;
+
+  auto operator=(const db_result &) -> db_result & = default;
+  auto operator=(db_result &&) -> db_result & = default;
+
+  using row = db_row;
+
+private:
+  std::shared_ptr<context> ctx_;
+  mutable std::int32_t res_{};
+
+private:
+  void set_res(std::int32_t res) const { res_ = res; }
+
+public:
+  [[nodiscard]] auto get_error() const -> std::int32_t { return res_; }
+
+  [[nodiscard]] auto get_error_str() const -> std::string;
+
+  [[nodiscard]] auto get_row(std::optional<row> &opt_row) const -> bool;
+
+  [[nodiscard]] auto has_row() const -> bool;
+
+  void next_row() const;
+
+  [[nodiscard]] auto ok() const -> bool;
+};
+} // namespace repertory::utils::db::sqlite
+
+#endif // defined(PROJECT_ENABLE_SQLITE)
+#endif // REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_COMMON_HPP_

support/include/utils/db/sqlite/db_delete.hpp

@@ -0,0 +1,73 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_DELETE_HPP_
+#define REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_DELETE_HPP_
+#if defined(PROJECT_ENABLE_SQLITE)
+
+#include "utils/db/sqlite/db_common.hpp"
+
+#include "utils/db/sqlite/db_where_t.hpp"
+
+namespace repertory::utils::db::sqlite {
+class db_delete final {
+public:
+  struct context final : db_context_t {
+    struct db_delete_op_t final {
+      std::shared_ptr<context> ctx;
+
+      [[nodiscard]] auto dump() const -> std::string;
+
+      [[nodiscard]] auto go() const -> db_result;
+    };
+
+    context(sqlite3 *db3_, std::string table_name_)
+        : db_context_t(db3_, table_name_) {}
+
+    using w_t = db_where_t<context, db_delete_op_t>;
+    using wd_t = where_data_t<w_t>;
+
+    std::unique_ptr<wd_t> where_data;
+  };
+
+public:
+  db_delete(sqlite3 &db3, std::string table_name)
+      : ctx_(std::make_shared<context>(&db3, table_name)) {}
+
+  db_delete(std::shared_ptr<context> ctx) : ctx_(std::move(ctx)) {}
+
+private:
+  std::shared_ptr<context> ctx_;
+
+public:
+  [[nodiscard]] auto dump() const -> std::string;
+
+  [[nodiscard]] auto go() const -> db_result;
+
+  [[nodiscard]] auto
+  group(context::w_t::group_func_t func) -> context::w_t::wn_t;
+
+  [[nodiscard]] auto where(std::string column_name) const -> context::w_t::cn_t;
+};
+} // namespace repertory::utils::db::sqlite
+
+#endif // defined(PROJECT_ENABLE_SQLITE)
+#endif // REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_DELETE_HPP_

support/include/utils/db/sqlite/db_insert.hpp

@@ -0,0 +1,64 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_INSERT_HPP_
+#define REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_INSERT_HPP_
+#if defined(PROJECT_ENABLE_SQLITE)
+
+#include "utils/db/sqlite/db_common.hpp"
+
+namespace repertory::utils::db::sqlite {
+class db_insert final {
+public:
+  struct context final : db_context_t {
+    context(sqlite3 *db3_, std::string table_name_)
+        : db_context_t(db3_, table_name_) {}
+
+    bool or_replace{false};
+    std::map<std::string, db_types_t> values;
+  };
+
+public:
+  db_insert(sqlite3 &db3, std::string table_name)
+      : ctx_(std::make_shared<context>(&db3, table_name)) {}
+
+  db_insert(std::shared_ptr<context> ctx) : ctx_(std::move(ctx)) {}
+
+private:
+  std::shared_ptr<context> ctx_;
+
+public:
+  [[nodiscard]] auto or_replace() -> db_insert {
+    ctx_->or_replace = true;
+    return *this;
+  }
+
+  [[nodiscard]] auto column_value(std::string column_name, db_types_t value)
+      -> db_insert;
+
+  [[nodiscard]] auto dump() const -> std::string;
+
+  [[nodiscard]] auto go() const -> db_result;
+};
+} // namespace repertory::utils::db::sqlite
+
+#endif // defined(PROJECT_ENABLE_SQLITE)
+#endif // REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_INSERT_HPP_

support/include/utils/db/sqlite/db_select.hpp

@@ -0,0 +1,104 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_SELECT_HPP_
+#define REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_SELECT_HPP_
+#if defined(PROJECT_ENABLE_SQLITE)
+
+#include "utils/db/sqlite/db_common.hpp"
+
+#include "utils/db/sqlite/db_where_t.hpp"
+
+namespace repertory::utils::db::sqlite {
+class db_select final {
+public:
+  struct context final : db_context_t {
+    struct db_select_op_t final {
+      std::shared_ptr<context> ctx;
+
+      [[nodiscard]] auto dump() const -> std::string;
+
+      [[nodiscard]] auto go() const -> db_result;
+
+      [[nodiscard]] auto group_by(std::string column_name) -> db_select_op_t;
+
+      [[nodiscard]] auto limit(std::int32_t value) -> db_select_op_t;
+
+      [[nodiscard]] auto offset(std::int32_t value) -> db_select_op_t;
+
+      [[nodiscard]] auto order_by(std::string column_name, bool ascending)
+          -> db_select_op_t;
+    };
+
+    context(sqlite3 *db3_, std::string table_name_)
+        : db_context_t(db3_, table_name_) {}
+
+    using w_t = db_where_t<context, db_select_op_t>;
+    using wd_t = where_data_t<w_t>;
+
+    std::vector<std::string> columns;
+    std::map<std::string, std::string> count_columns;
+
+    std::vector<std::string> group_by;
+    std::optional<std::int32_t> limit;
+    std::optional<std::int32_t> offset;
+    std::optional<std::pair<std::string, bool>> order_by;
+
+    std::unique_ptr<wd_t> where_data;
+  };
+
+public:
+  db_select(sqlite3 &db3, std::string table_name)
+      : ctx_(std::make_shared<context>(&db3, table_name)) {}
+
+  db_select(std::shared_ptr<context> ctx) : ctx_(std::move(ctx)) {}
+
+private:
+  std::shared_ptr<context> ctx_;
+
+public:
+  [[nodiscard]] auto column(std::string column_name) -> db_select;
+
+  [[nodiscard]] auto count(std::string column_name, std::string as_column_name)
+      -> db_select;
+
+  [[nodiscard]] auto dump() const -> std::string;
+
+  [[nodiscard]] auto go() const -> db_result;
+
+  [[nodiscard]] auto group_by(std::string column_name) -> db_select;
+  [[nodiscard]] auto group(context::w_t::group_func_t func)
+
+      -> context::w_t::wn_t;
+
+  [[nodiscard]] auto limit(std::int32_t value) -> db_select;
+
+  [[nodiscard]] auto offset(std::int32_t value) -> db_select;
+
+  [[nodiscard]] auto order_by(std::string column_name, bool ascending)
+      -> db_select;
+
+  [[nodiscard]] auto where(std::string column_name) const -> context::w_t::cn_t;
+};
+} // namespace repertory::utils::db::sqlite
+
+#endif // defined(PROJECT_ENABLE_SQLITE)
+#endif // REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_SELECT_HPP_

support/include/utils/db/sqlite/db_update.hpp

@@ -0,0 +1,91 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_UPDATE_HPP_
+#define REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_UPDATE_HPP_
+#if defined(PROJECT_ENABLE_SQLITE)
+
+#include "utils/db/sqlite/db_common.hpp"
+
+#include "utils/db/sqlite/db_where_t.hpp"
+
+namespace repertory::utils::db::sqlite {
+class db_update final {
+public:
+  struct context final : db_context_t {
+    context(sqlite3 *db3_, std::string table_name_)
+        : db_context_t(db3_, table_name_) {}
+
+    struct db_update_op_t final {
+      std::shared_ptr<context> ctx;
+
+      [[nodiscard]] auto dump() const -> std::string;
+
+      [[nodiscard]] auto go() const -> db_result;
+
+      [[nodiscard]] auto limit(std::int32_t value) -> db_update_op_t;
+
+      [[nodiscard]] auto order_by(std::string column_name, bool ascending)
+
+          -> db_update_op_t;
+    };
+
+    using w_t = db_where_t<context, db_update_op_t>;
+    using wd_t = where_data_t<w_t>;
+
+    std::map<std::string, db_types_t> column_values;
+    std::optional<std::int32_t> limit;
+    std::optional<std::pair<std::string, bool>> order_by;
+
+    std::unique_ptr<wd_t> where_data;
+  };
+
+public:
+  db_update(sqlite3 &db3, std::string table_name)
+      : ctx_(std::make_shared<context>(&db3, table_name)) {}
+
+  db_update(std::shared_ptr<context> ctx) : ctx_(std::move(ctx)) {}
+
+private:
+  std::shared_ptr<context> ctx_;
+
+public:
+  [[nodiscard]] auto column_value(std::string column_name, db_types_t value)
+      -> db_update;
+
+  [[nodiscard]] auto dump() const -> std::string;
+
+  [[nodiscard]] auto go() const -> db_result;
+
+  [[nodiscard]] auto group(context::w_t::group_func_t func)
+      -> context::w_t::wn_t;
+
+  [[nodiscard]] auto limit(std::int32_t value) -> db_update;
+
+  [[nodiscard]] auto order_by(std::string column_name, bool ascending)
+      -> db_update;
+
+  [[nodiscard]] auto where(std::string column_name) const -> context::w_t::cn_t;
+};
+} // namespace repertory::utils::db::sqlite
+
+#endif // defined(PROJECT_ENABLE_SQLITE)
+#endif // REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_UPDATE_HPP_

support/include/utils/db/sqlite/db_where_t.hpp

@@ -0,0 +1,224 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_WHERE_T_HPP_
+#define REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_WHERE_T_HPP_
+#if defined(PROJECT_ENABLE_SQLITE)
+
+#include "utils/db/sqlite/db_common.hpp"
+
+namespace repertory::utils::db::sqlite {
+template <typename w_t> struct where_data_t final {
+  w_t base;
+  std::map<std::size_t, std::vector<typename w_t::action_t>> actions;
+  std::vector<db_types_t> values;
+};
+
+template <typename cn_t, typename ctx_t, typename op_t, typename w_t,
+          typename wn_t>
+struct db_next_t final {
+  std::size_t action_idx{};
+  std::shared_ptr<ctx_t> ctx;
+  std::string action;
+
+  using group_func_t = std::function<void(w_t &)>;
+
+  [[nodiscard]] auto where(std::string column_name) -> cn_t {
+    return w_t{action_idx, ctx}.where(column_name);
+  }
+
+  [[nodiscard]] auto dump() const -> std::string { return op_t{ctx}.dump(); }
+
+  [[nodiscard]] auto dump(std::int32_t &idx) const -> std::string {
+    return ctx->where_data->base.dump(idx);
+  }
+
+  [[nodiscard]] auto go() const -> auto { return op_t{ctx}.go(); }
+
+  [[nodiscard]] auto group(group_func_t func) -> wn_t {
+    return w_t{action_idx, ctx}.group(std::move(func));
+  }
+
+  [[nodiscard]] auto op() -> op_t {
+    return op_t{
+        ctx,
+    };
+  }
+};
+
+template <typename cn_t, typename ctx_t, typename op_t, typename w_t>
+struct db_where_next_t final {
+  std::size_t action_idx{};
+  std::shared_ptr<ctx_t> ctx;
+
+  using n_t = db_next_t<cn_t, ctx_t, op_t, w_t, db_where_next_t>;
+
+  [[nodiscard]] auto and_() -> n_t {
+    n_t next{
+        action_idx,
+        ctx,
+        "AND",
+    };
+
+    ctx->where_data->actions[action_idx].emplace_back(next);
+    return next;
+  }
+
+  [[nodiscard]] auto dump() const -> std::string { return op_t{ctx}.dump(); }
+
+  [[nodiscard]] auto dump(std::int32_t &idx) const -> std::string {
+    return ctx->where_data->base.dump(idx);
+  }
+
+  [[nodiscard]] auto go() const -> auto { return op_t{ctx}.go(); }
+
+  [[nodiscard]] auto op() -> op_t {
+    return op_t{
+        ctx,
+    };
+  }
+
+  [[nodiscard]] auto or_() -> n_t {
+    n_t next{
+        action_idx,
+        ctx,
+        "OR",
+    };
+
+    ctx->where_data->actions[action_idx].emplace_back(next);
+    return next;
+  }
+};
+
+template <typename ctx_t, typename op_t, typename w_t>
+struct db_comp_next_t final {
+  std::size_t action_idx{};
+  std::shared_ptr<ctx_t> ctx;
+  std::string column_name;
+
+  using wn_t = db_where_next_t<db_comp_next_t, ctx_t, op_t, w_t>;
+
+  [[nodiscard]] auto create(std::string operation, db_types_t value) {
+    ctx->where_data->actions[action_idx].emplace_back(db_comp_data_t{
+        column_name,
+        operation,
+    });
+
+    ctx->where_data->values.push_back(value);
+
+    return wn_t{
+        action_idx,
+        ctx,
+    };
+  }
+
+  auto equals(db_types_t value) -> wn_t { return create("=", value); };
+
+  auto gt(db_types_t value) -> wn_t { return create(">", value); }
+
+  auto gte(db_types_t value) -> wn_t { return create(">=", value); }
+
+  auto like(db_types_t value) -> wn_t { return create("LIKE", value); }
+
+  auto lt(db_types_t value) -> wn_t { return create("<", value); }
+
+  auto lte(db_types_t value) -> wn_t { return create("<=", value); }
+
+  auto not_equals(db_types_t value) -> wn_t { return create("!=", value); };
+};
+
+template <typename ctx_t, typename op_t> struct db_where_t final {
+  std::size_t action_idx{0U};
+  std::shared_ptr<ctx_t> ctx;
+
+  using cn_t = db_comp_next_t<ctx_t, op_t, db_where_t>;
+  using wn_t = db_where_next_t<cn_t, ctx_t, op_t, db_where_t>;
+  using n_t = db_next_t<cn_t, ctx_t, op_t, db_where_t, wn_t>;
+
+  using group_func_t = std::function<void(db_where_t &)>;
+
+  using action_t = std::variant<db_comp_data_t, n_t, db_where_t>;
+
+  [[nodiscard]] static auto dump(std::int32_t &idx,
+                                 auto &&actions) -> std::string {
+    std::stringstream stream;
+
+    for (auto &&action : actions) {
+      std::visit(overloaded{
+                     [&idx, &stream](const db_comp_data_t &comp) {
+                       stream << '"' << comp.column_name << '"' << comp.op_type
+                              << '?' + std::to_string(++idx);
+                     },
+                     [&idx, &stream](const n_t &next) {
+                       stream << ' ' << next.action << ' ';
+                     },
+                     [&idx, &stream](const db_where_t &where) {
+                       stream << '(' << dump(idx, where.get_actions()) << ')';
+                     },
+                 },
+                 action);
+    }
+
+    return stream.str();
+  }
+
+  [[nodiscard]] auto dump() const -> std::string { return op_t{ctx}.dump(); }
+
+  [[nodiscard]] auto dump(std::int32_t &idx) const -> std::string {
+    return dump(idx, ctx->where_data->actions[action_idx]);
+  }
+
+  [[nodiscard]] auto get_actions() -> auto & {
+    return ctx->where_data->actions[action_idx];
+  }
+
+  [[nodiscard]] auto get_actions() const -> const auto & {
+    return ctx->where_data->actions[action_idx];
+  }
+
+  [[nodiscard]] auto group(group_func_t func) -> wn_t {
+    ctx->where_data->actions[action_idx];
+
+    db_where_t where{ctx->where_data->actions.size(), ctx};
+    func(where);
+
+    ctx->where_data->actions[action_idx].emplace_back(where);
+
+    return wn_t{
+        action_idx,
+        ctx,
+    };
+  }
+
+  [[nodiscard]] auto where(std::string column_name) -> cn_t {
+    ctx->where_data->actions[action_idx];
+
+    return cn_t{
+        action_idx,
+        ctx,
+        column_name,
+    };
+  }
+};
+} // namespace repertory::utils::db::sqlite
+
+#endif // defined(PROJECT_ENABLE_SQLITE)
+#endif // REPERTORY_INCLUDE_UTILS_DB_SQLITE_DB_WHERE_T_HPP_

support/include/utils/encrypting_reader.hpp

@@ -0,0 +1,145 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_ENCRYPTING_READER_HPP_
+#define REPERTORY_INCLUDE_UTILS_ENCRYPTING_READER_HPP_
+#if defined(PROJECT_ENABLE_LIBSODIUM) && defined(PROJECT_ENABLE_BOOST)
+
+#include "utils/config.hpp"
+
+#include "utils/hash.hpp"
+#include "utils/types/file/i_file.hpp"
+
+namespace repertory::utils::encryption {
+class encrypting_reader final {
+public:
+  encrypting_reader(std::string_view file_name, std::string_view source_path,
+                    stop_type &stop_requested, std::string_view token,
+                    std::optional<std::string> relative_parent_path,
+                    std::size_t error_return = 0U);
+
+  encrypting_reader(std::string_view encrypted_file_path,
+                    std::string_view source_path, stop_type &stop_requested,
+                    std::string_view token, std::size_t error_return = 0U);
+
+  encrypting_reader(
+      std::string_view encrypted_file_path, std::string_view source_path,
+      stop_type &stop_requested, std::string_view token,
+      std::vector<std::array<unsigned char,
+                             crypto_aead_xchacha20poly1305_IETF_NPUBBYTES>>
+          iv_list,
+      std::size_t error_return = 0U);
+
+  encrypting_reader(const encrypting_reader &reader);
+  encrypting_reader(encrypting_reader &&) = delete;
+
+  auto operator=(const encrypting_reader &) -> encrypting_reader & = delete;
+  auto operator=(encrypting_reader &&) -> encrypting_reader & = delete;
+
+  ~encrypting_reader() noexcept = default;
+
+public:
+  using iostream = std::basic_iostream<char, std::char_traits<char>>;
+  using streambuf = std::basic_streambuf<char, std::char_traits<char>>;
+
+private:
+  utils::encryption::hash_256_t key_;
+  stop_type &stop_requested_;
+  size_t error_return_;
+  std::unique_ptr<utils::file::i_file> source_file_;
+
+private:
+  std::unordered_map<std::size_t, data_buffer> chunk_buffers_;
+  std::string encrypted_file_name_;
+  std::string encrypted_file_path_;
+  std::vector<
+      std::array<unsigned char, crypto_aead_xchacha20poly1305_IETF_NPUBBYTES>>
+      iv_list_;
+  std::size_t last_data_chunk_{};
+  std::size_t last_data_chunk_size_{};
+  std::uint64_t read_offset_{};
+  std::uint64_t total_size_{};
+
+private:
+  static const std::size_t header_size_;
+  static const std::size_t data_chunk_size_;
+  static const std::size_t encrypted_chunk_size_;
+
+private:
+  auto reader_function(char *buffer, size_t size, size_t nitems) -> size_t;
+
+public:
+  [[nodiscard]] static auto
+  calculate_decrypted_size(std::uint64_t total_size) -> std::uint64_t;
+
+  [[nodiscard]] static auto
+  calculate_encrypted_size(std::string_view source_path) -> std::uint64_t;
+
+  [[nodiscard]] auto create_iostream() const -> std::shared_ptr<iostream>;
+
+  [[nodiscard]] static constexpr auto
+  get_encrypted_chunk_size() -> std::size_t {
+    return encrypted_chunk_size_;
+  }
+
+  [[nodiscard]] static constexpr auto get_data_chunk_size() -> std::size_t {
+    return data_chunk_size_;
+  }
+
+  [[nodiscard]] auto get_encrypted_file_name() const -> std::string {
+    return encrypted_file_name_;
+  }
+
+  [[nodiscard]] auto get_encrypted_file_path() const -> std::string {
+    return encrypted_file_path_;
+  }
+
+  [[nodiscard]] auto get_error_return() const -> std::size_t {
+    return error_return_;
+  }
+
+  [[nodiscard]] auto get_iv_list()
+      -> std::vector<std::array<unsigned char,
+                                crypto_aead_xchacha20poly1305_IETF_NPUBBYTES>> {
+    return iv_list_;
+  }
+
+  [[nodiscard]] auto get_stop_requested() const -> bool {
+    return stop_requested_;
+  }
+
+  [[nodiscard]] auto get_total_size() const -> std::uint64_t {
+    return total_size_;
+  }
+
+  [[nodiscard]] static auto reader_function(char *buffer, size_t size,
+                                            size_t nitems,
+                                            void *instream) -> size_t {
+    return reinterpret_cast<encrypting_reader *>(instream)->reader_function(
+        buffer, size, nitems);
+  }
+
+  void set_read_position(std::uint64_t position) { read_offset_ = position; }
+};
+} // namespace repertory::utils::encryption
+
+#endif // defined(PROJECT_ENABLE_LIBSODIUM) && defined(PROJECT_ENABLE_BOOST)
+#endif // REPERTORY_INCLUDE_UTILS_ENCRYPTING_READER_HPP_

support/include/utils/encryption.hpp

@@ -0,0 +1,221 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_ENCRYPTION_HPP_
+#define REPERTORY_INCLUDE_UTILS_ENCRYPTION_HPP_
+#if defined(PROJECT_ENABLE_LIBSODIUM)
+
+#include "utils/config.hpp"
+
+#include "utils/error.hpp"
+#include "utils/hash.hpp"
+
+namespace repertory::utils::encryption {
+inline constexpr const std::uint32_t encryption_header_size{
+    crypto_aead_xchacha20poly1305_IETF_NPUBBYTES +
+        crypto_aead_xchacha20poly1305_IETF_ABYTES,
+};
+
+template <typename hash_t>
+inline auto generate_key(
+    std::string_view password,
+    std::function<hash_t(const unsigned char *data, std::size_t size)> hasher =
+        default_create_hash<hash_t>()) -> hash_t;
+
+template <typename hash_t>
+inline auto generate_key(
+    std::wstring_view password,
+    std::function<hash_t(const unsigned char *data, std::size_t size)> hasher =
+        default_create_hash<hash_t>()) -> hash_t;
+
+#if defined(PROJECT_ENABLE_BOOST)
+[[nodiscard]] auto decrypt_file_name(std::string_view encryption_token,
+                                     std::string &file_name) -> bool;
+
+[[nodiscard]] auto decrypt_file_path(std::string_view encryption_token,
+                                     std::string &file_path) -> bool;
+
+template <typename result_t, typename arr_t, std::size_t arr_size>
+[[nodiscard]] inline auto decrypt_data(const std::array<arr_t, arr_size> &key,
+                                       const unsigned char *buffer,
+                                       std::size_t buffer_size,
+                                       result_t &res) -> bool {
+  if (buffer_size > encryption_header_size) {
+    const std::uint32_t size =
+        boost::endian::native_to_big(static_cast<std::uint32_t>(buffer_size));
+    res.resize(buffer_size - encryption_header_size);
+    return crypto_aead_xchacha20poly1305_ietf_decrypt_detached(
+               reinterpret_cast<unsigned char *>(res.data()), nullptr,
+               &buffer[encryption_header_size], res.size(),
+               &buffer[crypto_aead_xchacha20poly1305_IETF_NPUBBYTES],
+               reinterpret_cast<const unsigned char *>(&size), sizeof(size),
+               buffer, key.data()) == 0;
+  }
+
+  return false;
+}
+
+template <typename buffer_t, typename result_t, typename arr_t,
+          std::size_t arr_size>
+[[nodiscard]] inline auto decrypt_data(const std::array<arr_t, arr_size> &key,
+                                       const buffer_t &buf,
+                                       result_t &res) -> bool {
+  return decrypt_data<result_t>(
+      key, reinterpret_cast<const unsigned char *>(buf.data()), buf.size(),
+      res);
+}
+
+template <typename buffer_t, typename result_t, typename hash_t = hash_256_t>
+[[nodiscard]] inline auto decrypt_data(
+    std::string_view password, const buffer_t &buf, result_t &res,
+    std::function<hash_t(const unsigned char *data, std::size_t size)> hasher =
+        default_create_hash<hash_t>()) -> bool {
+  return decrypt_data<buffer_t, result_t>(generate_key(password, hasher), buf,
+                                          res);
+}
+
+template <typename result_t, typename hash_t = hash_256_t>
+[[nodiscard]] inline auto decrypt_data(
+    std::string_view password, const unsigned char *buffer,
+    std::size_t buffer_size, result_t &res,
+    std::function<hash_t(const unsigned char *data, std::size_t size)> hasher =
+        default_create_hash<hash_t>()) -> bool {
+  return decrypt_data<result_t>(generate_key(password, hasher), buffer,
+                                buffer_size, res);
+}
+
+template <typename result_t, typename arr_t, std::size_t arr_size>
+inline void
+encrypt_data(const std::array<unsigned char,
+                              crypto_aead_xchacha20poly1305_IETF_NPUBBYTES> &iv,
+             const std::array<arr_t, arr_size> &key,
+             const unsigned char *buffer, std::size_t buffer_size,
+             result_t &res) {
+  REPERTORY_USES_FUNCTION_NAME();
+
+  std::array<unsigned char, crypto_aead_xchacha20poly1305_IETF_ABYTES> mac{};
+
+  const std::uint32_t size = boost::endian::native_to_big(
+      static_cast<std::uint32_t>(buffer_size + encryption_header_size));
+
+  res.resize(buffer_size + encryption_header_size);
+
+  unsigned long long mac_length{};
+  if (crypto_aead_xchacha20poly1305_ietf_encrypt_detached(
+          reinterpret_cast<unsigned char *>(&res[encryption_header_size]),
+          mac.data(), &mac_length, buffer, buffer_size,
+          reinterpret_cast<const unsigned char *>(&size), sizeof(size), nullptr,
+          iv.data(), key.data()) != 0) {
+    throw repertory::utils::error::create_exception(function_name,
+                                                    {
+                                                        "encryption failed",
+                                                    });
+  }
+
+  std::memcpy(res.data(), iv.data(), iv.size());
+  std::memcpy(&res[iv.size()], mac.data(), mac.size());
+}
+
+template <typename result_t, typename arr_t, std::size_t arr_size>
+inline void encrypt_data(const std::array<arr_t, arr_size> &key,
+                         const unsigned char *buffer, std::size_t buffer_size,
+                         result_t &res) {
+  std::array<unsigned char, crypto_aead_xchacha20poly1305_IETF_NPUBBYTES> iv{};
+  randombytes_buf(iv.data(), iv.size());
+
+  encrypt_data<result_t>(iv, key, buffer, buffer_size, res);
+}
+
+template <typename result_t, typename hash_t = hash_256_t>
+inline void encrypt_data(
+    std::string_view password, const unsigned char *buffer,
+    std::size_t buffer_size, result_t &res,
+    std::function<hash_t(const unsigned char *data, std::size_t size)> hasher =
+        default_create_hash<hash_t>()) {
+  encrypt_data<result_t>(generate_key(password, hasher), buffer, buffer_size,
+                         res);
+}
+
+template <typename buffer_t, typename result_t, typename hash_t = hash_256_t>
+inline void encrypt_data(
+    std::string_view password, const buffer_t &buf, result_t &res,
+    std::function<hash_t(const unsigned char *data, std::size_t size)> hasher =
+        default_create_hash<hash_t>()) {
+  encrypt_data<result_t>(generate_key(password, hasher),
+                         reinterpret_cast<const unsigned char *>(buf.data()),
+                         buf.size(), res);
+}
+
+template <typename buffer_t, typename result_t, typename arr_t,
+          std::size_t arr_size>
+inline void encrypt_data(const std::array<arr_t, arr_size> &key,
+                         const buffer_t &buf, result_t &res) {
+  encrypt_data<result_t>(key,
+                         reinterpret_cast<const unsigned char *>(buf.data()),
+                         buf.size(), res);
+}
+
+template <typename buffer_t, typename result_t, typename arr_t,
+          std::size_t arr_size>
+inline void
+encrypt_data(const std::array<unsigned char,
+                              crypto_aead_xchacha20poly1305_IETF_NPUBBYTES> &iv,
+             const std::array<arr_t, arr_size> &key, const buffer_t &buf,
+             result_t &res) {
+  encrypt_data<result_t>(iv, key,
+                         reinterpret_cast<const unsigned char *>(buf.data()),
+                         buf.size(), res);
+}
+
+#if defined(PROJECT_ENABLE_CURL)
+using reader_func_t =
+    std::function<bool(data_buffer &cypher_text, std::uint64_t start_offset,
+                       std::uint64_t end_offset)>;
+
+[[nodiscard]] auto
+read_encrypted_range(const http_range &range,
+                     const utils::encryption::hash_256_t &key,
+                     reader_func_t reader_func, std::uint64_t total_size,
+                     data_buffer &data) -> bool;
+#endif // defined(PROJECT_ENABLE_CURL)
+#endif // defined(PROJECT_ENABLE_BOOST)
+
+template <typename hash_t>
+inline auto generate_key(
+    std::string_view password,
+    std::function<hash_t(const unsigned char *data, std::size_t size)> hasher)
+    -> hash_t {
+  return hasher(reinterpret_cast<const unsigned char *>(password.data()),
+                password.size());
+}
+
+template <typename hash_t>
+inline auto generate_key(
+    std::wstring_view password,
+    std::function<hash_t(const unsigned char *data, std::size_t size)> hasher)
+    -> hash_t {
+  return hasher(reinterpret_cast<const unsigned char *>(password.data()),
+                password.size() * sizeof(wchar_t));
+}
+} // namespace repertory::utils::encryption
+
+#endif // defined(PROJECT_ENABLE_LIBSODIUM)
+#endif // REPERTORY_INCLUDE_UTILS_ENCRYPTION_HPP_

support/include/utils/error.hpp

@@ -0,0 +1,104 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_ERROR_HPP_
+#define REPERTORY_INCLUDE_UTILS_ERROR_HPP_
+
+#include "utils/config.hpp"
+
+namespace repertory::utils::error {
+[[nodiscard]] auto
+create_error_message(std::vector<std::string_view> items) -> std::string;
+
+[[nodiscard]] auto
+create_exception(std::string_view function_name,
+                 std::vector<std::string_view> items) -> std::runtime_error;
+
+struct i_exception_handler {
+  virtual ~i_exception_handler() {}
+
+  i_exception_handler(const i_exception_handler &) noexcept = delete;
+  i_exception_handler(i_exception_handler &&) noexcept = delete;
+  auto operator=(const i_exception_handler &) noexcept = delete;
+  auto operator=(i_exception_handler &&) noexcept = delete;
+
+  virtual void handle_error(std::string_view function_name,
+                            std::string_view msg) const = 0;
+
+  virtual void handle_exception(std::string_view function_name) const = 0;
+
+  virtual void handle_exception(std::string_view function_name,
+                                const std::exception &ex) const = 0;
+
+protected:
+  i_exception_handler() = default;
+};
+
+struct iostream_exception_handler final : i_exception_handler {
+  void handle_error(std::string_view function_name,
+                    std::string_view msg) const override {
+    std::cerr << create_error_message({
+                     function_name,
+                     msg,
+                 })
+              << std::endl;
+  }
+
+  void handle_exception(std::string_view function_name) const override {
+    std::cerr << create_error_message({
+                     function_name,
+                     "exception",
+                     "unknown",
+                 })
+              << std::endl;
+  }
+
+  void handle_exception(std::string_view function_name,
+                        const std::exception &ex) const override {
+    std::cerr << create_error_message({
+                     function_name,
+                     "exception",
+                     (ex.what() == nullptr ? "unknown" : ex.what()),
+                 })
+              << std::endl;
+  }
+};
+inline const iostream_exception_handler default_exception_handler{};
+
+extern std::atomic<const i_exception_handler *> exception_handler;
+
+#if defined(PROJECT_ENABLE_TESTING)
+[[nodiscard]] inline auto
+get_exception_handler() -> const i_exception_handler * {
+  return exception_handler;
+}
+#endif // defined(PROJECT_ENABLE_TESTING)
+
+void handle_error(std::string_view function_name, std::string_view msg);
+
+void handle_exception(std::string_view function_name);
+
+void handle_exception(std::string_view function_name, const std::exception &ex);
+
+void set_exception_handler(const i_exception_handler *handler);
+} // namespace repertory::utils::error
+
+#endif // REPERTORY_INCLUDE_UTILS_ERROR_HPP_

support/include/utils/file.hpp

@@ -0,0 +1,182 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_FILE_HPP_
+#define REPERTORY_INCLUDE_UTILS_FILE_HPP_
+
+#include "utils/config.hpp"
+
+#include "utils/path.hpp"
+#include "utils/string.hpp"
+#include "utils/types/file/i_directory.hpp"
+#include "utils/types/file/i_file.hpp"
+#include "utils/types/file/i_fs_item.hpp"
+
+namespace repertory::utils::file {
+[[nodiscard]] auto change_to_process_directory() -> bool;
+
+// INFO: has test
+[[nodiscard]] auto create_temp_name(std::string_view file_part) -> std::string;
+
+// INFO: has test
+[[nodiscard]] auto
+create_temp_name(std::wstring_view file_part) -> std::wstring;
+
+// INFO: has test
+[[nodiscard]] inline auto
+directory_exists_in_path(std::string_view path,
+                         std::string_view sub_directory) -> bool;
+
+// INFO: has test
+[[nodiscard]] inline auto
+directory_exists_in_path(std::wstring_view path,
+                         std::wstring_view sub_directory) -> bool;
+
+// INFO: has test
+[[nodiscard]] inline auto
+file_exists_in_path(std::string_view path, std::string_view file_name) -> bool;
+
+// INFO: has test
+[[nodiscard]] inline auto
+file_exists_in_path(std::wstring_view path,
+                    std::wstring_view file_name) -> bool;
+
+// INFO: has test
+[[nodiscard]] auto
+get_free_drive_space(std::string_view path) -> std::optional<std::uint64_t>;
+
+// INFO: has test
+[[nodiscard]] auto
+get_free_drive_space(std::wstring_view path) -> std::optional<std::uint64_t>;
+
+// INFO: has test
+[[nodiscard]] auto get_time(std::string_view path,
+                            time_type type) -> std::optional<std::uint64_t>;
+
+// INFO: has test
+[[nodiscard]] auto get_time(std::wstring_view path,
+                            time_type type) -> std::optional<std::uint64_t>;
+
+// INFO: has test
+[[nodiscard]] auto
+get_times(std::string_view path) -> std::optional<file_times>;
+
+// INFO: has test
+[[nodiscard]] auto
+get_times(std::wstring_view path) -> std::optional<file_times>;
+
+// INFO: has test
+[[nodiscard]] auto
+get_total_drive_space(std::string_view path) -> std::optional<std::uint64_t>;
+
+// INFO: has test
+[[nodiscard]] auto
+get_total_drive_space(std::wstring_view path) -> std::optional<std::uint64_t>;
+
+#if defined(PROJECT_ENABLE_LIBDSM)
+[[nodiscard]] auto
+smb_create_and_validate_relative_path(std::string_view smb_path,
+                                      std::string_view rel_path) -> std::string;
+
+// INFO: has test
+[[nodiscard]] auto
+smb_create_relative_path(std::string_view smb_path) -> std::string;
+
+// INFO: has test
+[[nodiscard]] auto
+smb_create_search_path(std::string_view smb_path) -> std::string;
+
+// INFO: has test
+[[nodiscard]] auto
+smb_create_smb_path(std::string_view smb_path,
+                    std::string_view rel_path) -> std::string;
+
+[[nodiscard]] auto
+smb_get_parent_path(std::string_view smb_path) -> std::string;
+
+[[nodiscard]] auto smb_get_root_path(std::string_view smb_path) -> std::string;
+
+[[nodiscard]] auto smb_get_unc_path(std::string_view smb_path) -> std::string;
+
+[[nodiscard]] auto smb_get_uri_path(std::string_view smb_path) -> std::string;
+
+[[nodiscard]] auto smb_get_uri_path(std::string_view smb_path,
+                                    std::string_view user,
+                                    std::string_view password) -> std::string;
+
+// INFO: has test
+[[nodiscard]] auto smb_parent_is_same(std::string_view smb_path1,
+                                      std::string_view smb_path2) -> bool;
+
+#define SMB_MOD_RW2                                                            \
+  (SMB_MOD_READ | SMB_MOD_WRITE | SMB_MOD_READ_EXT | SMB_MOD_WRITE_EXT |       \
+   SMB_MOD_READ_ATTR | SMB_MOD_WRITE_ATTR | SMB_MOD_READ_CTL)
+#endif // defined(PROJECT_ENABLE_LIBDSM)
+
+#if defined(PROJECT_ENABLE_JSON)
+#if defined(PROJECT_ENABLE_LIBSODIUM) && defined(PROJECT_ENABLE_BOOST)
+// INFO: has test
+[[nodiscard]] auto
+read_json_file(std::string_view path, nlohmann::json &data,
+               std::optional<std::string_view> password = std::nullopt) -> bool;
+
+// INFO: has test
+[[nodiscard]] auto read_json_file(
+    std::wstring_view path, nlohmann::json &data,
+    std::optional<std::wstring_view> password = std::nullopt) -> bool;
+
+// INFO: has test
+[[nodiscard]] auto write_json_file(
+    std::string_view path, const nlohmann::json &data,
+    std::optional<std::string_view> password = std::nullopt) -> bool;
+
+// INFO: has test
+[[nodiscard]] auto write_json_file(
+    std::wstring_view path, const nlohmann::json &data,
+    std::optional<std::wstring_view> password = std::nullopt) -> bool;
+#else  // !defined(PROJECT_ENABLE_LIBSODIUM) && defined(PROJECT_ENABLE_BOOST)
+// INFO: has test
+[[nodiscard]] auto read_json_file(std::string_view path,
+                                  nlohmann::json &data) -> bool;
+
+// INFO: has test
+[[nodiscard]] auto read_json_file(std::wstring_view path,
+                                  nlohmann::json &data) -> bool;
+
+// INFO: has test
+[[nodiscard]] auto write_json_file(std::string_view path,
+                                   const nlohmann::json &data) -> bool;
+
+// INFO: has test
+[[nodiscard]] auto write_json_file(std::wstring_view path,
+                                   const nlohmann::json &data) -> bool;
+#endif // defined(PROJECT_ENABLE_LIBSODIUM) && defined(PROJECT_ENABLE_BOOST)
+#endif // defined(PROJECT_ENABLE_JSON)
+} // namespace repertory::utils::file
+
+#endif // REPERTORY_INCLUDE_UTILS_FILE_HPP_
+
+#include "utils/file_directory.hpp"
+#include "utils/file_enc_file.hpp"
+#include "utils/file_file.hpp"
+#include "utils/file_smb_directory.hpp"
+#include "utils/file_smb_file.hpp"
+#include "utils/file_thread_file.hpp"

support/include/utils/file_directory.hpp

@@ -0,0 +1,124 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_FILE_DIRECTORY_HPP_
+#define REPERTORY_INCLUDE_UTILS_FILE_DIRECTORY_HPP_
+
+#include "utils/file.hpp"
+
+namespace repertory::utils::file {
+class directory final : public i_directory {
+public:
+  using directory_t = std::unique_ptr<directory>;
+
+  directory() noexcept = default;
+
+  directory(std::string_view path, stop_type *stop_requested = nullptr)
+      : path_(utils::path::absolute(path)), stop_requested_(stop_requested) {}
+
+  directory(std::wstring_view path, stop_type *stop_requested = nullptr)
+      : path_(utils::path::absolute(utils::string::to_utf8(path))),
+        stop_requested_(stop_requested) {}
+
+  directory(const directory &) noexcept = delete;
+
+  directory(directory &&move_dir) noexcept = default;
+
+  ~directory() override = default;
+
+private:
+  std::string path_;
+  stop_type *stop_requested_{nullptr};
+
+public:
+  [[nodiscard]] auto copy_to(std::string_view new_path,
+                             bool overwrite) const -> bool override;
+
+  [[nodiscard]] auto
+  count(bool recursive = false) const -> std::uint64_t override;
+
+  [[nodiscard]] auto
+  create_directory(std::string_view path = "") const -> fs_directory_t override;
+
+  [[nodiscard]] auto create_file(std::string_view file_name,
+                                 bool read_only) const -> fs_file_t override;
+
+  [[nodiscard]] auto exists() const -> bool override;
+
+  [[nodiscard]] auto
+  get_directory(std::string_view path) const -> fs_directory_t override;
+
+  [[nodiscard]] auto
+  get_directories() const -> std::vector<fs_directory_t> override;
+
+  [[nodiscard]] auto
+  get_file(std::string_view path) const -> fs_file_t override;
+
+  [[nodiscard]] auto get_files() const -> std::vector<fs_file_t> override;
+
+  [[nodiscard]] auto get_items() const -> std::vector<fs_item_t> override;
+
+  [[nodiscard]] auto get_path() const -> std::string override { return path_; }
+
+  [[nodiscard]] auto is_stop_requested() const -> bool override;
+
+  [[nodiscard]] auto is_symlink() const -> bool override;
+
+  [[nodiscard]] auto move_to(std::string_view new_path) -> bool override;
+
+  [[nodiscard]] auto remove() -> bool override;
+
+  [[nodiscard]] auto remove_recursively() -> bool override;
+
+  [[nodiscard]] auto
+  size(bool recursive = false) const -> std::uint64_t override;
+
+public:
+  auto operator=(const directory &) noexcept -> directory & = delete;
+
+  auto operator=(directory &&move_dir) noexcept -> directory & = default;
+
+  [[nodiscard]] operator bool() const override { return exists(); }
+};
+
+// INFO: has test
+template <typename string_t>
+[[nodiscard]] inline auto directory_exists_in_path_t(
+    std::basic_string_view<typename string_t::value_type> path,
+    std::basic_string_view<typename string_t::value_type> sub_directory)
+    -> bool {
+  return directory(utils::path::combine(path, {sub_directory})).exists();
+}
+
+// INFO: has test
+inline auto directory_exists_in_path(std::string_view path,
+                                     std::string_view sub_directory) -> bool {
+  return directory_exists_in_path_t<std::string>(path, sub_directory);
+}
+
+// INFO: has test
+inline auto directory_exists_in_path(std::wstring_view path,
+                                     std::wstring_view sub_directory) -> bool {
+  return directory_exists_in_path_t<std::wstring>(path, sub_directory);
+}
+} // namespace repertory::utils::file
+
+#endif // REPERTORY_INCLUDE_UTILS_FILE_DIRECTORY_HPP_

support/include/utils/file_enc_file.hpp

@@ -0,0 +1,122 @@
+/*
+  Copyright <2018-2024> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_UTILS_FILE_ENC_FILE_HPP_
+#define REPERTORY_INCLUDE_UTILS_FILE_ENC_FILE_HPP_
+#if defined(PROJECT_ENABLE_LIBSODIUM) && defined(PROJECT_ENABLE_BOOST)
+
+#include "utils/file.hpp"
+
+namespace repertory::utils::file {
+class enc_file final : public i_file {
+public:
+  [[nodiscard]] static auto attach_file(fs_file_t file) -> fs_file_t;
+
+public:
+  enc_file() noexcept = default;
+
+protected:
+  enc_file(fs_file_t file);
+
+public:
+  enc_file(const enc_file &) = delete;
+
+  enc_file(enc_file &&move_file) noexcept : file_(std::move(move_file.file_)) {}
+
+  ~enc_file() override { close(); }
+
+private:
+  fs_file_t file_;
+
+public:
+  void close() override;
+
+  [[nodiscard]] auto copy_to(std::string_view new_path,
+                             bool overwrite) const -> bool override;
+
+  [[nodiscard]] auto exists() const -> bool override { return file_->exists(); }
+
+  void flush() const override;
+
+  [[nodiscard]] auto get_handle() const -> native_handle override {
+    return file_->get_handle();
+  }
+
+  [[nodiscard]] auto get_path() const -> std::string override {
+    return file_->get_path();
+  }
+
+  [[nodiscard]] auto get_read_buffer_size() const -> std::uint32_t override {
+    return file_->get_read_buffer_size();
+  }
+
+  [[nodiscard]] auto
+  get_time(time_type type) const -> std::optional<std::uint64_t> override {
+    return file_->get_time(type);
+  }
+
+  [[nodiscard]] auto is_read_only() const -> bool override {
+    return file_->is_read_only();
+  }
+
+  [[nodiscard]] auto is_symlink() const -> bool override {
+    return file_->is_symlink();
+  }
+
+  [[nodiscard]] auto move_to(std::string_view new_path) -> bool override;
+
+  [[nodiscard]] auto read(unsigned char *data, std::size_t to_read,
+                          std::uint64_t offset,
+                          std::size_t *total_read = nullptr) -> bool override;
+
+  [[nodiscard]] auto remove() -> bool override;
+
+  auto set_read_buffer_size(std::uint32_t size) -> std::uint32_t override {
+    return file_->set_read_buffer_size(size);
+  }
+
+  [[nodiscard]] auto size() const -> std::optional<std::uint64_t> override;
+
+  [[nodiscard]] auto truncate(std::size_t size) -> bool override;
+
+  [[nodiscard]] auto
+  write(const unsigned char *data, std::size_t to_write, std::size_t offset,
+        std::size_t *total_written = nullptr) -> bool override;
+
+public:
+  [[nodiscard]] operator bool() const override {
+    return static_cast<bool>(*file_);
+  }
+
+  auto operator=(const enc_file &) noexcept -> enc_file & = delete;
+
+  auto operator=(enc_file &&move_file) noexcept -> enc_file & {
+    if (&move_file != this) {
+      file_ = std::move(move_file.file_);
+    }
+
+    return *this;
+  }
+};
+} // namespace repertory::utils::file
+
+#endif // defined(PROJECT_ENABLE_LIBSODIUM) && defined(PROJECT_ENABLE_BOOST)
+#endif // REPERTORY_INCLUDE_UTILS_FILE_ENC_FILE_HPP_