2019-04-06 23:52:21 +00:00
|
|
|
# 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](https://github.com/s3fs-fuse/s3fs-fuse/wiki/Installation-Notes).
|
|
|
|
|
|
|
|
|
|
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
|
2020-03-19 15:13:21 +00:00
|
|
|
* 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
|
2019-11-18 00:35:15 +00:00
|
|
|
* pkg-config (or your OS equivalent)
|
2019-04-06 23:52:21 +00:00
|
|
|
|
|
|
|
|
2. 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
|
|
|
|
|
```
|
2022-01-12 15:47:13 +00:00
|
|
|
|
|
|
|
|
## Compilation on Windows (using MSYS2)
|
|
|
|
|
|
|
|
|
|
On Windows, use [MSYS2](https://www.msys2.org/) to compile for itself.
|
|
|
|
|
|
|
|
|
|
1. Install [WinFsp](https://github.com/billziss-gh/winfsp) to your machine.
|
|
|
|
|
2. Install dependencies onto MSYS2:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
cp -r "/c/Program Files (x86)/WinFsp" "./WinFsp"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
5. Write `fuse.pc` to resolve the package correctly:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
./autogen.sh
|
|
|
|
|
PKG_CONFIG_PATH="$PKG_CONFIG_PATH:$(pwd)" ./configure
|
|
|
|
|
make
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
7. Copy binary files to distribute at one place:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
mkdir ./bin
|
|
|
|
|
cp ./src/s3fs.exe ./bin/
|
|
|
|
|
cp ./WinFsp/bin/winfsp-x64.dll ./bin/
|
|
|
|
|
cp /usr/bin/msys-*.dll ./bin/
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
8. Distribute these files.
|
