shiftfs-dkms version for Kernels 6.1.x and 6.2.x

Content:

• About
• Known Issues and Limitations
• Status
• Howto
  • Install
  • Uninstall/Remove
  • Upgrade
• Bugreports
• Credits
• Copyright

About

Note:

• This version should be compatible with Linux Kernel versions 6.1.x and 6.2.x
• But the newest version is untested for now, the commit for kernel 6.2 might break support for 6.1, but it is not given. If it doesn't work, exclude that commit, e.g. with git-revert.

The shiftfs.c file is from the Ubuntu Lunar kernel repo (master-next branch), see: git link

For an overview of shiftfs and more information see README.md in master branch.

Known Issues

Upstream is warning about potential regressions, if shiftfs is used with filesystem namespaces.

See: commit

For more known issues and limitations, see also the README.md in master branch.

Status

Last Update:

Repo:	shiftfs.c (included here):
July 2023	2023-01-31

Version:	Status:
k61	recent

If you want to post a testreport, take a look at: Testreports Issue on Github.

Howto

Install:

Requirements:

• Required Linux Kernel version (see above)
• dkms
• kernel-headers (e.g. Debian package (for 64-bit): linux-headers-amd64)

0. Check whether your kernel already includes shiftfs:

  # modinfo shiftfs

1. Download this repo:

With git:

  # git clone -b k6.1 https://github.com/toby63/shiftfs-dkms.git shiftfs-k61

2. (Optional, but recommended) Update shiftfs.c:

The shiftfs.c included might be outdated, thus the update-script. Check the upstream log whether an update is available.

Run as user:

  # ./update1

3. Compile and install shiftfs with dkms:

Run as root or with sudo:

   # make -f Makefile.dkms

Now you can check again, whether shiftfs is activated:

   # modinfo shiftfs

Uninstall/Remove:

Run as root or with sudo:

   # ./remove1

Upgrade:

Note: Check for updates regularly in the upstream log for shiftfs and in the Update log issue for updates of this repo.

• Uninstall/Remove the old version:

  Run as root or with sudo:

  # ./remove1
  

• (Optional) Update these scripts:

  Note: Check the GitHub repo whether an update is necessary.

  Run as user (inside the scripts folder):

  # git pull origin master
  

• Repeat Step 2. and 3.

Report bugs

Report bugs at: https://github.com/toby63/shiftfs-dkms/issues

Credits

• shiftfs was made by:

  • James Bottomley
  • Seth Forshee seth.forshee@canonical.com
  • Christian Brauner christian.brauner@ubuntu.com

  (recent info is in the shiftfs.c file (See: footer -> tag: MODULE_AUTHOR))

• Some files are based on the Debian package repo of bbswitch (https://salsa.debian.org/nvidia-team/bbswitch), including:

  • dkms.conf
  • Makefile
  • Makefile.dkms

• Special thanks to:

  • Stéphane Graber @stgraber
  • Christian Brauner @brauner

  for the helpful advice.

Copyright/License

General Public License, Version 2

See: LICENSE