merge main into develop

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,96 @@
+---
+name: Report a bug
+description: Create a report to help us improve (but make sure to read all the documentation first).
+title: "[Bug]: <title>"
+labels: ['needs triage','kind:bug']
+assignees: 'umlaeute'
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your feedback. It is invaluable for making `v4l2loopback` a better software.
+
+        To help us making the most of your feedback (so we can e.g. fix bugs more quickly), please make sure to provide the information requested in this template.
+
+        Please keep in mind that the development of `v4l2loopback` is done by volunteers.
+        They are spending their spare time to give you a hopefully nice product and to help you if you have troubles - for free.
+
+        If you are experiencing interoperability problems with a commercial product, contact *their* support first.
+
+  - type: checkboxes
+    attributes:
+      label: Is there an existing issue for this?
+      description: |
+        Please search to see if an (open or closed) issue already exists for the bug you encountered.
+        If so, consider adding more information to the existing issue, rather than creating a new one.
+      options:
+        - label: I have searched the existing issues
+          required: true
+
+  - id: details
+    type: textarea
+    attributes:
+      label: Detail
+      description: |
+        What went wrong?
+        If you are using additional software (e.g. `obs-studio`, `ffmpeg`, ...) please make sure to include full version information (and - if it is not a very common product - a link to their webpage).
+      placeholder: |
+        What did you do (step by step)? What did you expect? What happened?
+      render: markdown
+    validations:
+      required: true
+
+  - id: version
+    type: input
+    attributes:
+      label: v4l2loopback version
+      description: |
+        What is the exact version of v4l2loopback you are using? (e.g. as reported by `sudo dmesg  | grep -i "v4l2loopback driver version"` or `git describe`)
+      placeholder: |
+        e.g. v0.13.1-10-g2014627
+    validations:
+      required: true
+
+  - id: kernelversion
+    type: input
+    attributes:
+      label: kernel version
+      description: |
+        What is the exact version of the linux kernel you are using? (reported via `uname -a`)
+      placeholder: |
+        e.g. Linux umlautT 6.7.9-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.7.9-2 (2024-03-13) x86_64 GNU/Linux
+    validations:
+      required: true
+
+
+  #  - type: dropdown
+  #    id: OS
+  #    attributes:
+  #      label: Operating System
+  #      description: Which OS are you using?
+  #      multiple: true
+  #      options:
+  #        - Linux
+  #        - macOS
+  #        - Windows
+  #        - other
+  - id: osversion
+    type: input
+    attributes:
+      label: OS Version
+      description: |
+        Which distribution/version are you using?  (numeric versions are much preferred over codenames)
+      placeholder: |
+        e.g. Ubuntu/4.10 "Warty"
+
+  - id: arch
+    type: dropdown
+    attributes:
+      label: Which CPU are you using?
+      multiple: true
+      options:
+        - amd64/x86_64 ("64bit Intel")
+        - i386 ("32bit Intel")
+        - arm64 ("64bit ARM"; e.g. Apple Silicon,...)
+        - arm ("32bit ARM"; e.g. Raspberry Pi,...)
+        - other

.github/ISSUE_TEMPLATE/config.yml

@@ -1,3 +1,4 @@
+---
 blank_issues_enabled: false
 contact_links:
   - name: Ask a Question
@@ -9,3 +10,6 @@ contact_links:
   - name: Look for more Documentation
     url: https://github.com/umlaeute/v4l2loopback/wiki
     about: Check our WIKI to see whether your question has already been answered.
+  - name: Start a discussion
+    url: https://github.com/umlaeute/v4l2loopback/discussions
+    about: Ask questions and share ideas on our "discussion" page.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,8 @@
+---
+name: Request a new feature
+about: Suggest some new great functionality (but make sure to read all the documentation first).
+title: ''
+labels: ['needs triage', 'kind: feature request']
+assignees: 'umlaeute'
+
+---

.github/workflows/kmod-compatibility-checks.yml

@@ -21,11 +21,11 @@ jobs:
         # the following does:
         # - fetch all available tags for the "buildpack-deps" Docker image
         # - fetch all available Ubuntu and Debian releases (that are still hosted on the distros' archive servers)
-        # - get the intersection of the tags and the releaess
+        # - get the intersection of the tags and the releases
         # - drop some releases (e.g. 'oldstable')
         # - format as a JSON array
         run: |
-          echo ::set-output name=matrix::$(true; (curl -s "https://hub.docker.com/v2/repositories/library/buildpack-deps/tags?page_size=1000" | jq -r '.results[] | .name' | sed -e '/[^a-z]/d' -e '/stable$/d' -e '/^\(testing\|experimental\)$/d' | sort -u; for url in http://archive.ubuntu.com/ubuntu http://deb.debian.org/debian; do curl -s "${url}/dists/" | grep "href=" | sed -e 's|.*a href="||' -e 's|".*||' -e 's|/$||'; done | sed -e '/[^a-z]/d' -e '/stable$/d' -e '/^\(testing\|experimental\)$/d' | sort -u) | sort | uniq -d | while read x; do echo -n '"'${x}'" '; done | sed -e 's|^ *|[|' -e 's| *$|]|' -e 's|  *|,|g')
+          echo matrix=$(true; (curl -s "https://hub.docker.com/v2/repositories/library/buildpack-deps/tags?page_size=1000" | jq -r '.results[] | .name' | sort -u; for url in http://archive.ubuntu.com/ubuntu; do curl -s "${url}/dists/" | grep "href=" | sed -e 's|.*a href="||' -e 's|".*||' -e 's|/$||'; done | sort -u; for d in unstable testing stable oldstable; do echo $d; done) | sort | uniq -d | while read x; do echo -n '"'${x}'" '; done | sed -e 's|^ *|[|' -e 's| *$|]|' -e 's|  *|,|g') | tee -a $GITHUB_OUTPUT
         id: set-matrix
     outputs:
       matrix: ${{ steps.set-matrix.outputs.matrix }}
@@ -41,26 +41,23 @@ jobs:
     env:
       JOB_KNOWN_FAILURES: "3.13 3.16 3.19 4.2"
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
 
       - name: Compile against all available kernel header versions
         shell: bash
         run: |
-          arch=$(dpkg --print-architecture)
           apt-get update --quiet;
           apt-get install --yes --no-install-recommends kmod
-          for kver in $(apt-cache search 'linux-headers-.*-generic' | cut -d- -f3 | sort -u -V); do
-            apt-cache search 'linux-headers-'"${kver}"'-.*-generic' | sort -V | tail -n 1 | awk '{print $1}';
-          done | xargs apt-get install --yes --no-install-recommends || true
-          for kver in $(apt-cache search "linux-headers-.*-${arch}" | cut -d- -f3 | sort -u -V); do
-            apt-cache search 'linux-headers-'"${kver}"'-.*-'"${arch}" | sort -V | tail -n 1 | awk '{print $1}';
-          done | xargs apt-get install --yes --no-install-recommends || true
-
+          apt-get install --yes --no-install-recommends dkms || true
+          apt-cache search "linux-headers-[0-9.]*-[0-9]*-" | cut -d " " -f1 \
+                | sed -e 's|linux-headers-\([0-9.]*\)-[0-9]*-\(.*\)|\0 \1 \2|' | sort -t- -k3,4 -V -r | sort  -u -k2,3 -V | cut -d " " -f1 \
+                | xargs apt-get install --yes --no-install-recommends
           failed=""
           succeeded=""
-          for kver in /lib/modules/*/build; do
-            test -d $kver || continue
-            kver=${kver%/build}
+          skipped=""
+          for kbuild in /lib/modules/*/build; do
+            test -d $kbuild || continue
+            kver=${kbuild%/build}
             kver=${kver##*/}
             echo "=== Testing ${kver} ===";
             ret=$(make KERNELRELEASE="${kver}" >&2; echo $?);
@@ -71,10 +68,16 @@ jobs:
               case " ${JOB_KNOWN_FAILURES} " in
               *" ${kver%.*} "*)
                 echo "#### Skipped known failure ${kver}";
+                skipped="${skipped} ${kver}";
                 ;;
               *)
-                echo "#### Skipped unexpected failure ${kver}";
-                failed="${failed} ${kver}";
+                if test -e "${kbuild}/.config" && ! grep -qE "^(CONFIG_VIDEO_DEV|CONFIG_VIDEO_V4L2)=" "${kbuild}/.config"; then
+                  echo "#### Skipped failure ${kver} (no v4l2 support)";
+                  skipped="${skipped} ${kver}";
+                else
+                  echo "#### Unexpected failure ${kver}";
+                  failed="${failed} ${kver}";
+                fi;
                 ;;
               esac;
             fi;
@@ -84,4 +87,7 @@ jobs:
             echo "#### Failed kernels: ${failed}";
             exit 1
           fi
+          if [ "x${skipped}" != "x" ]; then
+            echo "#### Skipped kernels: ${skipped}";
+          fi
           echo "#### Successful builds for kernels: ${succeeded}";

.github/workflows/lint.yml

@@ -0,0 +1,19 @@
+name: Code Linters
+on: [push, pull_request]
+
+jobs:
+  clang-format:
+    runs-on: ubuntu-latest
+    steps:
+      - name: install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get -y install clang-format make
+      - name: Checkout code
+        uses: actions/checkout@v2
+      - name: Check Code Formatting
+        run: |
+          make clang-format
+          git status --porcelain
+          git diff --exit-code
+

.gitignore

@@ -1,8 +1,10 @@
+*~
 .tmp_versions/
 *.cmd
 *.yuv
 Module.symvers
 modules.order
+utils/v4l2loopback-ctl.o
 utils/v4l2loopback-ctl
 v4l2loopback.ko
 v4l2loopback.mod

AUTHORS

@@ -1,22 +1,26 @@
 Aidan Thornton <makosoft AT gmail DOT com>
 Alex Hu <alex_y_xu AT yahoo DOT ca>
+Alienmaster <github AT crpykng DOT de>
 Anatolij Gutschin <agust AT denx DOT de>
 Andrii Danyleiko <DefteZ @ github>
 Angus McInnes <angus AT amcinnes DOT info>
 Anton Novikov <random.plant AT gmail DOT com>
 Attila Tőkés <tokes_atti AT yahoo DOT com>
+Benny Baumann <BenBE AT geshi DOT org>
 Dmitry Eremin <dmitry.eremin AT intel DOT com>
 Gavin Qiu <yongchengq AT gmail DOT com>
 George Chriss <gschriss AT gmail DOT com>
 Gorinich Zmey
 IOhannes m zmoelnig <zmoelnig AT iem DOT at>
+Jan-Ralf Meier <jan-ralf.meier AT gmx DOT de>
 Javier Infante <jabiinfante AT gmail DOT com>
 Jon Morley <jmorley AT pixsystem DOT com>
 Joan Bruguera <joanbrugueram AT gmail DOT com>
 Kai Kang <kai.kang AT windriver DOT com>
 Kurt Kiefer <kekiefer AT gmail DOT com>
 Michel Promonet <michel.promonet AT free DOT fr>
 Nick Sarnie <commendsarnex AT gmail DOT com>
+Oleksandr Natalenko <oleksandr AT natalenko DOT name>
 Paul Brook <paul.brook AT cocoon DOT life>
 Ricardo Ribalda Delgado <ricardo AT ribalda DOT com>
 Scott Maines <smaines AT alaya DOT com>
@@ -25,10 +29,14 @@ Tasos Sahanidis <tasos AT tasossah DOT com>
 Ted Mielczarek <ted AT mielczarek DOT org>
 Theodore Cipicchio <okready AT github>
 Thomas Hutterer <thutterer AT suse DOT de>
+Tim Gardner <tim.gardner AT canonical DOT com>
+Tobias Stoeckmann <tobias AT stoeckmann DOT org>
 Todor Minchev <todor.minchev AT linux DOT intel DOT com>
 tongdaxu <matonglidewazi AT qq DOT com>
 tz
 Vasily Levin
 WaleedTageldeen <waleed.tageldeen AT gmail DOT com>
+Wren Turkal <wt AT penguintechs DOT org>
 wuweixin <wuweixin AT gmail DOT com>
+You-Sheng Yang <vicamo.yang AT canonical DOT com>
 Yusuke Ohshima <git AT yukke DOT org>