Skip to content

INSTALLATION.md

Latest commit

 

History

History
232 lines (160 loc) · 4.7 KB

INSTALLATION.md

File metadata and controls

232 lines (160 loc) · 4.7 KB

🚀 Guide d'Installation Optimisée - xsshend

Pré-requis

  • Rust : version 1.70 ou supérieure (recommandé : dernière version stable)
  • OpenSSL (optionnel mais recommandé pour accélérer la compilation)

Vérifier votre version de Rust :

rustc --version

Si besoin, mettre à jour Rust :

rustup update stable

Installation Standard

Via Cargo (crates.io)

cargo install xsshend

⏱️ Temps estimé : 5-10 minutes (selon votre machine)

⚡ Installation Rapide (Recommandé)

Le temps de compilation peut être considérablement réduit en utilisant OpenSSL du système au lieu de le compiler depuis les sources.

Option 1 : Utiliser OpenSSL du Système

Sur Ubuntu/Debian

# Installer les dépendances OpenSSL
sudo apt-get update
sudo apt-get install -y libssl-dev pkg-config

# Installer xsshend
cargo install xsshend

⏱️ Temps estimé : 2-3 minutes

Sur Fedora/RHEL/CentOS

# Installer les dépendances OpenSSL
sudo dnf install -y openssl-devel pkg-config

# Installer xsshend
cargo install xsshend

Sur Arch Linux

# Installer les dépendances OpenSSL
sudo pacman -S openssl pkg-config

# Installer xsshend
cargo install xsshend

Sur macOS

# Installer OpenSSL via Homebrew
brew install openssl pkg-config

# Installer xsshend
cargo install xsshend

Option 2 : Compilation Parallèle

Utiliser tous les cœurs CPU pour accélérer la compilation :

# Linux/macOS
cargo install xsshend -j $(nproc)

# macOS (alternative)
cargo install xsshend -j $(sysctl -n hw.ncpu)

Option 3 : Combinaison (Plus Rapide)

# Ubuntu/Debian
sudo apt-get install -y libssl-dev pkg-config
cargo install xsshend -j $(nproc)

⏱️ Temps estimé : 1-2 minutes

Installation depuis les Sources

Cloner et Installer

# Cloner le dépôt
git clone https://github.com/willisback/xsshend.git
cd xsshend

# Installation standard
cargo install --path .

# Ou installation rapide avec jobs parallèles
cargo install --path . -j $(nproc)

Mode Développement

# Build en mode debug (plus rapide)
cargo build

# Exécuter directement
./target/debug/xsshend --help

# Build en mode release (optimisé)
cargo build --release
./target/release/xsshend --help

Résolution de Problèmes

Erreur : "could not find libssl"

Solution : Installer OpenSSL développement

# Ubuntu/Debian
sudo apt-get install libssl-dev pkg-config

# Fedora/RHEL
sudo dnf install openssl-devel pkg-config

Erreur : "unstable feature 'let_chains'"

Solution : Mettre à jour Rust ou utiliser la version 0.3.1+

rustup update stable
cargo install xsshend --force

Compilation Trop Lente

Solutions :

  1. Installer OpenSSL du système (voir Option 1 ci-dessus)
  2. Utiliser la compilation parallèle avec -j
  3. Vérifier l'espace disque disponible (minimum 2 Go recommandé)
  4. Utiliser cargo install --locked xsshend pour éviter les mises à jour de dépendances

Erreur de Version Rust

Solution : Mettre à jour Rust vers une version >= 1.70

rustup update stable
rustup default stable

Vérification de l'Installation

# Vérifier la version installée
xsshend --version

# Afficher l'aide
xsshend --help

# Lancer les tests (si installé depuis les sources)
cargo test

Désinstallation

cargo uninstall xsshend

Optimisations Avancées

Cache de Compilation

Pour les développeurs qui compilent fréquemment :

# Installer sccache pour mettre en cache les compilations
cargo install sccache

# Configurer Rust pour utiliser sccache
export RUSTC_WRAPPER=sccache

# Puis compiler normalement
cargo install xsshend

Build Minimal (Pas Recommandé)

Si vous avez vraiment besoin de réduire la taille et le temps de compilation :

# Clone le dépôt d'abord
git clone https://github.com/willisback/xsshend.git
cd xsshend

# Build avec optimisations minimales
cargo build --release --no-default-features

⚠️ Attention : Certaines fonctionnalités peuvent être désactivées

Support

Comparaison des Temps de Compilation

Méthode Temps Estimé Recommandé
Installation standard (vendored OpenSSL) 5-10 min ❌
OpenSSL système 2-3 min ✅
OpenSSL système + jobs parallèles 1-2 min ✅✅
Build depuis sources (debug) 1-2 min 🔧

Temps basés sur une machine avec CPU 4 cœurs, 8 Go RAM, SSD