oss build patch

.clang-format

@@ -0,0 +1,45 @@
+---
+AccessModifierOffset: -1
+AlignEscapedNewlinesLeft: true
+AlignTrailingComments: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: true
+BasedOnStyle: Google
+BinPackParameters: false
+BreakBeforeBinaryOperators: false
+BreakBeforeBraces: Attach
+BreakConstructorInitializersBeforeComma: false
+ColumnLimit:     80
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+ExperimentalAutoDetectBinPacking: true
+IndentCaseLabels: false
+IndentFunctionDeclarationAfterType: false
+IndentWidth:     2
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: None
+ObjCSpaceBeforeProtocolList: false
+PenaltyBreakBeforeFirstCallParameter: 10
+PenaltyBreakComment: 60
+PenaltyBreakFirstLessLess: 20
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 200
+PointerAlignment: Left
+SpaceAfterControlStatementKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 1
+SpacesInAngles: false
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+Standard:        Cpp11
+TabWidth:        8
+UseTab:          Never
+...

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/general-question.md

@@ -0,0 +1,10 @@
+---
+name: General Question
+about: General Questions about CacheLib usage, compilation, and anything else
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+

.github/PULL_REQSUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+ <Replace this line with a title. Use 1 line only, 67 chars or less>
+
+Summary:
+
+<Detailed summary of the feature or the code change>
+
+Test Plan:
+
+<How was this code change tested for correctness>
+
+Issue link: 
+
+<Any links to open issues that are relevant>
+

.github/workflows/build-cachelib-centos-9.yml

@@ -0,0 +1,106 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+name: build-cachelib-centos-9
+on:
+  push:
+    tags:
+      - 'v*'
+  pull_request:
+  workflow_dispatch:
+  schedule:
+     - cron:  '0 10 * * *'
+jobs:
+  build-cachelib-centos8-latest:
+    name: "CentOS/9 - Build CacheLib with all dependencies"
+    runs-on: ubuntu-latest
+    # Docker container image name
+    container: "quay.io/centos/centos:stream9"
+    steps:
+      - name: "Show Head Commit"
+        env:
+          CONTENT: ${{ toJSON(github.event.head_commit) }}
+        run: echo "$CONTENT"
+      - name: "update packages"
+        # stock centos has a problem with CMAKE, fails with:
+        #  "cmake: symbol lookup error: cmake: undefined symbol: archive_write_add_filter_zstd"
+        # updating solves it
+        run: dnf update -y
+      - name: "install sudo,git"
+        run: dnf install -y sudo git cmake gcc procps
+      - name: "System Information"
+        run: |
+          echo === uname ===
+          uname -a
+          echo === /etc/os-release ===
+          cat /etc/os-release
+          echo === /etc/centos-release ===
+          cat /etc/centos-release
+          echo === df -hl ===
+          df -hl
+          echo === nproc ===
+          nproc || true
+          echo === free -h ===
+          free -h
+          echo === top ===
+          top -b -n1 -1 -Eg || timeout 1 top -b -n1
+          echo === env ===
+          env
+          echo === gcc -v ===
+          gcc -v
+      - name: "checkout sources"
+        uses: actions/checkout@v3
+      - name: "Add workspace as a safe directory"
+        run: git config --system --add safe.directory $GITHUB_WORKSPACE
+      - name: "Install Prerequisites"
+        run: ./contrib/build.sh -S -B
+      - name: "Test: update-submodules"
+        run: ./contrib/update-submodules.sh
+      - name: "Install dependency: zstd"
+        run: ./contrib/build-package.sh -j -v -i zstd
+      - name: "Install dependency: googleflags"
+        run: ./contrib/build-package.sh -j -v -i googleflags
+      - name: "Install dependency: googlelog"
+        run: ./contrib/build-package.sh -j -v -i googlelog
+      - name: "Install dependency: googletest"
+        run: ./contrib/build-package.sh -j -v -i googletest
+      - name: "Install dependency: sparsemap"
+        run: ./contrib/build-package.sh -j -v -i sparsemap
+      - name: "Install dependency: fmt"
+        run: ./contrib/build-package.sh -j -v -i fmt
+      - name: "Install dependency: folly"
+        run: ./contrib/build-package.sh -j -v -i folly
+      - name: "Install dependency: fizz"
+        run: ./contrib/build-package.sh -j -v -i fizz
+      - name: "Install dependency: wangle"
+        run: ./contrib/build-package.sh -j -v -i wangle
+      - name: "Install dependency: mvfst"
+        run: ./contrib/build-package.sh -j -v -i mvfst
+      - name: "Install dependency: fbthrift"
+        run: ./contrib/build-package.sh -j -v -i fbthrift
+      - name: "build CacheLib"
+        # Build cachelib in debug mode (-d)
+        run: ./contrib/build-package.sh -j -v -i -d cachelib
+      - name: "run cachebench"
+        run: ./opt/cachelib/bin/cachebench --json_test_config ./opt/cachelib/test_configs/simple_test.json
+      - uses: actions/upload-artifact@v3
+        if: failure()
+        with:
+          name: cachelib-cmake-logs
+          path: |
+            build-cachelib/CMakeFiles/*.log
+            build-cachelib/CMakeCache.txt
+            build-cachelib/Makefile
+            build-cachelib/**/Makefile
+          if-no-files-found: warn
+          retention-days: 1

.github/workflows/build-cachelib-rockylinux-9.yml

@@ -0,0 +1,107 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+name: build-cachelib-rockylinux-9.0
+on:
+  push:
+    tags:
+      - 'v*'
+  pull_request:
+  workflow_dispatch:
+  schedule:
+     - cron:  '0 17 * * *'
+jobs:
+  build-cachelib-rockylinux-9:
+    name: "RockyLinux-9.0 - Build CacheLib with all dependencies"
+    runs-on: ubuntu-latest
+    # Docker container image name
+    container: "rockylinux:9.0"
+    steps:
+      - name: "Show Head Commit"
+        env:
+          CONTENT: ${{ toJSON(github.event.head_commit) }}
+        run: echo "$CONTENT"
+      - name: "update packages"
+        # stock centos has a problem with CMAKE, fails with:
+        #  "cmake: symbol lookup error: cmake: undefined symbol: archive_write_add_filter_zstd"
+        # updating solves it
+        run: dnf update -y
+      - name: "install sudo,git"
+        run: dnf install -y sudo git cmake gcc procps
+      - name: "System Information"
+        run: |
+          echo === uname ===
+          uname -a
+          echo === /etc/os-release ===
+          cat /etc/os-release
+          echo === df -hl ===
+          df -hl
+          echo === nproc ===
+          nproc || true
+          echo === free -h ===
+          free -h
+          echo === top ===
+          top -b -n1 -1 -Eg || timeout 1 top -b -n1
+          echo === env ===
+          env
+          echo === gcc -v ===
+          gcc -v
+      - name: "checkout sources"
+        uses: actions/checkout@v3
+      - name: "Add workspace as a safe directory"
+        run: git config --system --add safe.directory $GITHUB_WORKSPACE
+      - name: "Install Prerequisites"
+        run: ./contrib/build.sh -S -B
+      - name: "Test: update-submodules"
+        run: ./contrib/update-submodules.sh
+      - name: "Install dependency: zstd"
+        run: ./contrib/build-package.sh -j -v -i zstd
+      - name: "Install dependency: googleflags"
+        run: ./contrib/build-package.sh -j -v -i googleflags
+      - name: "Install dependency: googlelog"
+        run: ./contrib/build-package.sh -j -v -i googlelog
+      - name: "Install dependency: googletest"
+        run: ./contrib/build-package.sh -j -v -i googletest
+      - name: "Install dependency: sparsemap"
+        run: ./contrib/build-package.sh -j -v -i sparsemap
+      - name: "Install dependency: fmt"
+        run: ./contrib/build-package.sh -j -v -i fmt
+      - name: "Install dependency: folly"
+        run: |
+          # see: https://aur.archlinux.org/packages/folly#comment-862543
+          sed -i '$aset(LIBDWARF_INCLUDE_DIRS "/usr/include/libdwarf-0")' cachelib/external/folly/CMake/FindLibDwarf.cmake
+          ./contrib/build-package.sh -S -j -v -i folly
+      - name: "Install dependency: fizz"
+        run: ./contrib/build-package.sh -j -v -i fizz
+      - name: "Install dependency: wangle"
+        run: ./contrib/build-package.sh -j -v -i wangle
+      - name: "Install dependency: mvfst"
+        run: ./contrib/build-package.sh -j -v -i mvfst
+      - name: "Install dependency: fbthrift"
+        run: ./contrib/build-package.sh -j -v -i fbthrift
+      - name: "build CacheLib"
+        # Build cachelib in debug mode (-d)
+        run: ./contrib/build-package.sh -j -v -i -d cachelib
+      - name: "run cachebench"
+        run: ./opt/cachelib/bin/cachebench --json_test_config ./opt/cachelib/test_configs/simple_test.json
+      - uses: actions/upload-artifact@v3
+        if: failure()
+        with:
+          name: cachelib-cmake-logs
+          path: |
+            build-cachelib/CMakeFiles/*.log
+            build-cachelib/CMakeCache.txt
+            build-cachelib/Makefile
+            build-cachelib/**/Makefile
+          if-no-files-found: warn
+          retention-days: 1