Skip to content

Mount a WebDAV resource as a regular file system

License

MIT, GPL-3.0 licenses found

Licenses found

MIT
LICENSE
GPL-3.0
COPYING
Notifications You must be signed in to change notification settings

simonchen/davfs2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

davfs2

Mount a WebDAV resource as a regular file system. The current source has pulled from http://download.savannah.nongnu.org/releases/davfs2/ (original v1.7.0)

Prerequisite

  • Your kernel must include either the coda file system or the fuse file system or both. They may be loadable modules. Almost all Linux kernels support at least one of them.

Features

  • The package doesn't support WebDAV-resource with https

  • Mipsel architecture supported only.

  • 要使用davfs2, 必须确认linux内核已经集成coda或者fuse文件系统(/sys/fs/fuse.ko)

  • 当前只支持mipsel 架构(例如 MT7620/MT7621 soc)

  • 不支持WebDAV HTTPS

Note You might try the following command to enable fuse

modprobe fuse

Installation

You simply extract the released bin.tar.gz

image

  • there are two exectuable files mount.davfs2 unmount.davfs2 can be put in system binary folder - /sbin or any directory you like
  • and the 'davfs2' folder should be put in system folder /etc/ or any directory you like but you'll need to manually finish the Customized configurations

Quick start - Mount the WebDAV-resource

assume that you have built the WebDav-resource with server url http://0.0.0.0:8080 and you wanna mount to /mnt/fuse , you can type in the command line as follow:

mount.davfs http://0.0.0.0:8080 /mnt/fuse

Note

  • the server url could need credential as a secrets file (optional), you will be asked the credential if there is no secrets file.
  • the mount point binds with certain dav_user and dav_group (see below)

Default configurations

/etc/davfs2/davfs2.conf

  • secrets(optional): /etc/davfs2/secrets
  • cache_dir: /tmp/davfs2
  • dav_user: admin
  • dav_group: root

Customized configurations

The default configurations can be overridden by command option for example:

mount.davfs2 <server-url> <mountpoint> -o conf=/tmp/davfs2.conf

Here /tmp/davfs2.conf is the customized config file that have overwrited the default /etc/davfs2/davfs2.conf

Note

  • more options such as secrets, cache_dir, dav_user, dav_group etc. can be overridden in davfs2.conf
  • you should realize that /tmp/davfs2.conf could be lost once you restart system, please make sure that you put davfs2conf in a permanent directory.

Remove permission limitation

  • secrets: The owner of secrets file doesn't have to be same as current user (permission check is removed)
  • davfs2.conf: Natively, the variable dav_user dav_group can be only changed from system wide (i.e, /etc/davfs2/davfs2.conf), if you don't have permission to modify the sytem config file /etc/davfs2/davfs2.conf, the user / group name will always be davfs2, thus, you're in a trouble that you also have no permission to create the group as possible. For now, the limitation has been removed, dav_user dav_group can be changed from any scope whatever the davfs2.conf is located at.

FAQ

http://savannah.nongnu.org/support/?group=davfs2

For developer: Using musl-gcc wrapper instead of Toolchain gcc compiler

Refers to https://www.musl-libc.org/faq.html

Adding some missing sources such as fstab.c / rsmatch that musl didn't provide, hence alonging to change config.h.in and src/Makefile.in

musl

./configure --host=mipsel-unknown-linux-gnu && make install

zlib

./configure --prefix=/usr/local/musl --includedir="/usr/local/musl/include" --libdir="/usr/local/musl/lib" --static --sharedlibdir=.

expat (alternative to libxml2)

./configure --prefix=/usr/local/musl --enable-static --host=mipsel-unknown-linux-gnu

neno

./configure LDFLAGS="-Wl,-L/usr/local/musl/lib,-lexpat" CPPFLAGS=-I/usr/local/musl/include --prefix=/usr/local/musl --with-expat --enable-static --host=mipsel-unknown-linux-gnu
ln -s /usr/local/musl/bin/neon-config /usr/local/bin/neon-config

davfs2

./configure dav_user=admin dav_group=root dav_syscachedir=/tmp/cache_davfs2 CC="/usr/local/musl/bin/musl-gcc" CFLAGS="-I/usr/local/musl/include -I/usr/local/musl/include/neon" CPPFLAGS="-I/usr/local/musl/include -I/usr/local/musl/include/neon" LDFLAGS="-Wl,-Bstatic -L/usr/local/musl/lib" --prefix=/usr/local/musl --sysconfdir=/etc  --host=mipsel-unknown-linux-gnu