smbmount/README.md
2025-05-15 19:09:48 +02:00

73 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# smbmount
`smbmount` est un script Bash pour monter facilement des partages SMB en bénéficiant dune complétion dynamique basée sur la découverte réseau via Avahi.
---
## Fonctionnalités
* **Montage SMB simplifié** : script Bash qui facilite le montage de partages SMB.
* **Complétion dynamique** : suggestions automatiques des serveurs SMB disponibles sur le réseau grâce à Avahi.
* Installation flexible :
* Au niveau système (avec droits administrateur).
* En mode utilisateur (sans droits, dans `~/.local`).
---
## Prérequis
* Linux avec `bash`
* `avahi-browse` installé (généralement dans le paquet `avahi-utils`)
* Accès aux dossiers dinstallation (voir ci-dessous)
---
## Installation
Utilise le `Makefile` pour installer automatiquement :
```bash
make install
```
* Si tu as les droits décriture dans `/usr/local/bin` et `/etc/bash_completion.d`, linstallation se fera au niveau système.
* Sinon, le script sera installé dans `~/.local/bin` et la complétion dans `~/.bash_completion.d`.
### Configuration complémentaire (mode utilisateur)
Si linstallation est en mode utilisateur, ajoute ces lignes à ton fichier `~/.bashrc` pour que le script et la complétion soient bien pris en compte :
```bash
export PATH="$HOME/.local/bin:$PATH"
[ -f "$HOME/.bash_completion.d/smbmount" ] && source "$HOME/.bash_completion.d/smbmount"
```
Puis recharge ton shell :
```bash
source ~/.bashrc
```
---
## Utilisation
```bash
smbmount -A <nom_serveur> [options]
```
* La complétion fonctionne sur largument `<nom_serveur>`, en proposant la liste des serveurs SMB détectés.
* Par exemple, tape `smbmount -A <Tab><Tab>` pour voir les serveurs disponibles.
---
## Désinstallation
Pour supprimer linstallation (mode système ou utilisateur), lance :
```bash
make uninstall
```