diff --git a/FUSE-Mount.md b/FUSE-Mount.md index 37d240f..ba5b6a6 100644 --- a/FUSE-Mount.md +++ b/FUSE-Mount.md @@ -203,6 +203,16 @@ mount -t weed fuse /mnt -o "filer='192.168.0.1:8888,192.168.0.2:8888',filer.path Now you can operate the SeaweedFS files, browsing or modifying directories and files, in local file system. To unmount, just shut it down the "weed mount". +#### Disk name (`-volumeName`) + +Where the platform labels the mount — Finder on macOS, Explorer on Windows, and `mount`/`df` on Linux and FreeBSD — the name is derived from the mounted path: `-filer.path` first, then the `-dir` mount point, then the filer address. `-volumeName` overrides that derivation without changing what is mounted: + +```bash +weed mount -filer=localhost:8888 -dir=/mnt/seaweedfs -filer.path=/ -volumeName=Photos +``` + +Leave `-volumeName` empty to keep the derived name. On Windows the override is the volume label Explorer shows; the UNC share name (e.g. `\\seaweedfs\Images`) is unaffected. See [[Mount on Windows]] for the Windows-specific details. + #### Mount with fstab ``` diff --git a/Mount-on-Windows.md b/Mount-on-Windows.md index b82cbde..b3209c7 100644 --- a/Mount-on-Windows.md +++ b/Mount-on-Windows.md @@ -38,9 +38,26 @@ Stop the mount with Ctrl-C, which unmounts cleanly and flushes pending writes. K | `-readOnly` | Reject every modification at the WinFsp layer. | | `-cacheMetaTtlSec` | How long WinFsp may cache attributes and directory entries. | | `-debug.fuse` | Log every filesystem operation. | +| `-volumeName` | Name shown by Explorer for the disk, overriding the name taken from `-filer.path` or `-dir`. See [Disk name](#disk-name). | Everything else — `-cacheDirForRead`, `-cacheSizeMBForRead`, `-chunkSizeLimitMB`, `-collection`, `-replication`, `-concurrentWriters` — behaves as it does elsewhere. See [[FUSE Mount]]. +### Disk name + +Explorer labels the mounted disk after the mounted path: + +* `-filer.path=/Image Disk` shows up as `Image Disk`. +* Mounting the whole tree (`-filer.path=/`) takes the name from the mount point instead, so `-dir=\\seaweedfs\Images` labels the disk `Images` while still mounting everything. +* A bare drive letter (`-dir=S:`) has no name to take, so the disk falls back to the filer address. + +The derived name can collide with the real drive it sits on, or with another mount's label. `-volumeName` overrides the derivation without changing what is mounted: + +```powershell +weed.exe mount -filer=127.0.0.1:8888 -dir=\\seaweedfs\Images -volumeName=Photos +``` + +This mounts `\\seaweedfs\Images` as before but labels the disk `Photos`. The UNC share name (`\\seaweedfs\Images`) is unaffected — only the volume label changes. Leave `-volumeName` empty to keep the old behaviour. Commas in the value are replaced with `+`, since WinFsp treats commas as option separators. + #### Case sensitivity The filer is case-sensitive, and so is the mount by default: `Report.txt` and `report.txt` are two files. Some Windows software assumes otherwise and will misbehave. `-windows.caseInsensitive` makes the mount match Windows expectations, at the cost of making one of any two names that differ only in case unreachable. WinFsp cannot do NTFS-style mixed sensitivity, so it is one or the other for the whole mount.