octoleo
/
s3fs-fuse
mirror of https://github.com/s3fs-fuse/s3fs-fuse.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
s3fs-fuse/COMPILATION.md

2.3 KiB
Raw Permalink Blame History

Compilation from source code

These are generic instructions should work on almost any GNU/Linux, macOS, BSD, or similar.

If you want specific instructions for some distributions, check the wiki.

Keep in mind using the pre-built packages when available.

  1. Ensure your system satisfies build and runtime dependencies for:
  • fuse >= 2.8.4
  • automake
  • gcc-c++
  • make
  • libcurl
  • libxml2
  • openssl
  • mime.types (the package providing depends on the OS)
    • s3fs tries to detect /etc/mime.types as default regardless of the OS
    • Else s3fs tries to detect /etc/apache2/mime.types if OS is macOS
    • s3fs exits with an error if these files are not exist
    • Alternatively, you can set mime.types file path with mime option without detecting these default files
  • pkg-config (or your OS equivalent)
  1. Then compile from master via the following commands:
git clone https://github.com/s3fs-fuse/s3fs-fuse.git
cd s3fs-fuse
./autogen.sh
./configure
make
sudo make install

Compilation on Windows (using MSYS2)

On Windows, use MSYS2 to compile for itself.

  1. Install WinFsp to your machine.

  2. Install dependencies onto MSYS2:

    pacman -S git autoconf automake gcc make pkg-config libopenssl-devel libcurl-devel libxml2-devel libzstd-devel

  3. Clone this repository, then change directory into the cloned one.

  4. Copy WinFsp files to the directory:

    cp -r "/c/Program Files (x86)/WinFsp" "./WinFsp"

  5. Write fuse.pc to resolve the package correctly:

    cat > ./fuse.pc << 'EOS'
arch=x64
prefix=${pcfiledir}/WinFsp
incdir=${prefix}/inc/fuse
implib=${prefix}/bin/winfsp-${arch}.dll

Name: fuse
Description: WinFsp FUSE compatible API
Version: 2.8.4
URL: http://www.secfs.net/winfsp/
Libs: "${implib}"
Cflags: -I"${incdir}"
EOS

  6. Compile using the command line:

    ./autogen.sh
PKG_CONFIG_PATH="$PKG_CONFIG_PATH:$(pwd)" ./configure
make

  7. Copy binary files to distribute at one place:

    mkdir ./bin
cp ./src/s3fs.exe ./bin/
cp ./WinFsp/bin/winfsp-x64.dll ./bin/
cp /usr/bin/msys-*.dll ./bin/

  8. Distribute these files.