User:Wuseman/rar2fs
sys-fs/rar2fs is a FUSE based file system that can mount a source RAR archive/volume or a directory containing any number of RAR archives and read the contents as regular files on-the-fly. Non-archived files located in the source directory are handled transparently.
Installation
USE Flags
USE flags for sys-fs/rar2fs A FUSE based filesystem that can mount one or multiple RAR archive(s)
debug
|
Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces |
Emerge
root #emerge --ask sys-fs/rar2fsInstallation from Source
Dependencies
Install necessary dependencies:
root #emerge --ask sys-fs/fuseroot #emerge --ask app-arch/rarroot #emerge --ask app-arch/unrarInstall Rar
Download and install rar and unrar from rarlab:
1. Download and extract RarLinux from source:
user $wget2 https://www.rarlab.com/rar/rarlinux-x64-701.tar.gz -P /tmp/user $tar -xvzf /tmp/rarlinux-x64-701.tar.gz -C /tmp/2. Build and install RarLinux:
root #make -j$(($(nproc)+1)) -l$(($(nproc)+2)) -f /tmp/rar/makefile -C /tmp/rarInstall Libfuse
Build and Install fuse from Sourcefuse-installer.sh#!/bin/sh
# Requirements: emerge --ask dev-build/meson dev-build/ninja
wget2 https://github.com/libfuse/libfuse/releases/download/fuse-3.16.2/fuse-3.16.2.tar.gz -P /tmp/
tar -xvzf /tmp/fuse-3.16.2.tar.gz -C /tmp/
cd /tmp/fuse-3.16.2
mkdir /tmp/fuse-3.16.2/build
cd $_
meson configure -D disable-mtab=true
meson setup --reconfigure ../
ninja
python3 -m pytest test/
ninja install
Install Unrar
Download and install the latest unrarlib from source:
Build and Install Unrar from Sourceunrarsrc-installer.sh#!/bin/sh
# This script automates the download, compilation, and installation of unrar from source.
# Download unrarsrc-7.0.8.tar.gz from rarlab.com
wget https://www.rarlab.com/rar/unrarsrc-7.0.8.tar.gz -P /tmp/
# Extract the downloaded archive to /tmp/
tar -xvzf /tmp/unrarsrc-7.0.8.tar.gz -C /tmp
# Build libunrar.so with maximum threads available
make lib -j$(($(nproc) + 1)) -l$(($(nproc) + 2)) -C /tmp/unrar
# Install libunrar.so to system directories
make install-lib -C /tmp/unrar -f /tmp/unrar/makefile
# Clean the build directory (this is for avoid issues with libunrar.so)
# https://github.com/hasse69/rar2fs/wiki#q-23-i-get-the-libfuseso-or-compatible-library-not-found-message-when-i-try-to-run
make clean -j$(($(nproc) + 1)) -l$(($(nproc) + 2)) -C /tmp/unrar -f /tmp/unrar/makefile
# Compile unrar binary with multiple threads
make -j$(($(nproc) + 1)) -l$(($(nproc) + 2)) -C /tmp/unrar -f /tmp/unrar/makefile
# Install unrar binary to system
make install -C /tmp/unrar
# Cleanup extracted files
rm -rf -v /tmp/unrar{-7.0.8.tar.gz}
Install rar2fs
Clone the sys-fs/rar2fs repository and install:
Installer for rar2fsrar2fs-installer.sh#!/bin/sh
git clone https://github.com/hasse69/rar2fs.git -C /tmp/rar2fs
cd /tmp/rar2fs
autoreconf -f -i
./configure --with-unrar=/tmp/unrar
make -j$(($(nproc)+1)) -l$(($(nproc)+2)) -C /tmp/rar2fs
make install -C /tmp/rar2fs
Usage
Mounting
Mount a RAR archive:
user $rar2fs -o allow_other /path/to/rararchive /path/to/mount/pointUnmounting
Unmount a mounted RAR archive:
user $fusermount -u /path/to/mount/pointAutomount with /etc/fstab
To enable automounting of rar archives using rar2fs, follow these steps:
1. Install fuse if not already installed:
root #emerge --ask sys-fs/fuse2. Edit /etc/fstab to include the automount entry:
Use your preferred text editor to open /etc/fstab:
user $vim /etc/fstab3. Add the following line at the end of the file:
/etc/fstab/etc/fstabrar2fs#/path/to/rararchive /path/to/mountpoint fuse allow_other,--seek-length=1 0 0
4. Save and close the file.
5. Test the /etc/fstab entry:
root #mount -aThis command mounts all filesystems listed in /etc/fstab, including the new rar2fs entry.
Replace ~/rar/path with the actual path to your RAR archive and /mnt/rar2fs with the directory where you want to mount the archive.
Autofs
Autofs provides on-demand mounting and unmounting of filesystems based on access needs. It helps manage resources efficiently by automatically mounting filesystems when they are accessed and unmounting them after a period of inactivity.
Setting Up Autofs
To set up Autofs for managing RAR archives with sys-fs/rar2fs, follow these steps:
1. Install Autofs if not already installed:
root #emerge --ask sys-fs/autofs2. Edit /etc/auto.master to include the configuration for RAR archives:
Use your preferred text editor to open /etc/auto.master:
user $vim /etc/auto.master3. Add the following line at the end of the file to include the configuration for rar2fs:
/etc/auto.master/etc/auto.master/mnt/rar2fs /etc/auto.rar2fs --timeout=120 --ghost
This configuration specifies that Autofs should manage mounts under /mnt/rar2fs using the settings defined in /etc/auto.rar2fs.
4. Create /etc/auto.rar2fs to define the mount points and options:
Use your preferred text editor to create /etc/auto.rar2fs:
user $vim /etc/auto.rar2fs5. Add the following lines to define the mount points and options for rar2fs:
/etc/auto.rar2fsConfiguring mount points and options for rar2fs/mnt/rar2fs/rar-movies -fstype=fuse,ro,allow_other,noatime,umask=222,--seek-length=2 :rar2fs#/mnt/rar2fs/nas1/rar-movies
/mnt/rar2fs/rar-videos -fstype=fuse,ro,allow_other,noatime,umask=222,--seek-length=2 :rar2fs#/mnt/rar2fs/nas2/rar-videos
Restart Autofs to apply the changes:
Restart autofs
OpenRC
To restart autofs using OpenRC, use the following command:
root #/etc/init.d/autofs restartSystemd
To restart autofs using systemd, follow these steps:
1. Reload systemd daemon to apply any changes in configuration files:
root #systemctl daemon-reload2. Restart the autofs service:
root #systemctl restart autofsFUSE Options
The following are additional FUSE options that can be used with rar2fs:
user $rar2fs --helpusage: rar2fs source mountpoint [options]
general options:
-o opt,[opt...] mount options
-h --help print help
-V --version print version
FUSE options:
-d -o debug enable debug output (implies -f)
-f foreground operation
-s disable multi-threaded operation
-o allow_other allow access to other users
-o allow_root allow access to root
-o auto_unmount auto unmount on process termination
-o nonempty allow mounts over non-empty file/dir
-o default_permissions enable permission checking by kernel
-o fsname=NAME set filesystem name
-o subtype=NAME set filesystem type
-o large_read issue large read requests (2.4 only)
-o max_read=N set maximum size of read requests
-o hard_remove immediate removal (don't hide files)
-o use_ino let filesystem set inode numbers
-o readdir_ino try to fill in d_ino in readdir
-o direct_io use direct I/O
-o kernel_cache cache files in kernel
-o [no]auto_cache enable caching based on modification times (off)
-o umask=M set file permissions (octal)
-o uid=N set file owner
-o gid=N set file group
-o entry_timeout=T cache timeout for names (1.0s)
-o negative_timeout=T cache timeout for deleted names (0.0s)
-o attr_timeout=T cache timeout for attributes (1.0s)
-o ac_attr_timeout=T auto cache timeout for attributes (attr_timeout)
-o noforget never forget cached inodes
-o remember=T remember cached inodes for T seconds (0s)
-o nopath don't supply path if not necessary
-o intr allow requests to be interrupted
-o intr_signal=NUM signal to send on interrupt (10)
-o modules=M1[:M2...] names of modules to push onto filesystem stack
-o max_write=N set maximum size of write requests
-o max_readahead=N set maximum readahead
-o max_background=N set number of maximum background requests
-o congestion_threshold=N set kernel's congestion threshold
-o async_read perform reads asynchronously (default)
-o sync_read perform reads synchronously
-o atomic_o_trunc enable atomic open+truncate support
-o big_writes enable larger than 4kB writes
-o no_remote_lock disable remote file locking
-o no_remote_flock disable remote file locking (BSD)
-o no_remote_posix_lock disable remove file locking (POSIX)
-o [no_]splice_write use splice to write to the fuse device
-o [no_]splice_move move data while splicing to the fuse device
-o [no_]splice_read use splice to read from the fuse device
Module options:
[iconv]
-o from_code=CHARSET original encoding of file names (default: UTF-8)
-o to_code=CHARSET new encoding of the file names (default: UTF-8)
[subdir]
-o subdir=DIR prepend this directory to all paths (mandatory)
-o [no]rellinks transform absolute symlinks to relative
rar2fs options:
--exclude=F1[;F2...] exclude file filter
--seek-length=n set number of volume files that are traversed in search for headers [0=All]
--iob-size=n I/O buffer size in 'power of 2' MiB (1,2,4,8, etc.) [4]
--hist-size=n I/O buffer history size as a percentage (0-75) of total buffer size [50]
--save-eof force creation of .r2i files (end-of-file chunk)
--no-lib-check disable validation of library version(s)
--no-expand-cbr do not expand comic book RAR archives
--no-smp disable SMP support (bind to CPU #0)
--relatime update file access times relative to modify or change time
--relatime-rar like --relatime but also update main archive file(s)
--date-rar use file date from main archive file(s)
--config=file config file name [source/.rarconfig]
--no-inherit-perm do not inherit file permission mode from archive
-o locale=LOCALE set the locale for file names (default: according to LC_*/LC_CTYPE)
-o warmup[=THREADS] start background cache warmup threads (default: 5)