plpfuse(8)

📦
version 1.0.26 · 2 versions
, in ubuntu stonking

💖 plpfuse — the girlies are MOUNTING an EPOC device 💖

okay so real quick, bestie: this is the manual page for plpfuse, section 8 of the system administration commands, and it's literally the glow-up your Psion has been waiting for. let's get into it 🦋

✨ NAME ✨

plpfuse — a daemon that mounts an EPOC device as a file system 💅

🌸 SYNOPSIS 🌸

plpfuse [-V] [-d] [-h] [-p [HOST:]PORT] [LONG-OPTIONS] MOUNTPOINT

🎀 DESCRIPTION 🎀

okay so plpfuse is a file system, right, and what it does is give you file-system access to your EPOC device. it mounts the EPOC device's file systems right there in your computer's file system. no cap. 🫶

and like — just like the other front-ends, this program auto-reconnects after a link failure, so you can literally just keep the EPOC device mounted all the time, even when it's not connected. main character energy fr fr. and thanks to Rudolf Koenig's clever error handling, you don't have to worry about blocked I/O processes when the psion isn't available. iconic. you'll simply get a "device not configured" error when you access a file on a previously connected psion that's been disconnected. after that, the mount point will appear with the drives missing. but the second the psion is connected again, the subdirectories reappear (possibly with a few seconds' delay). we love a comeback story 😭

now, EPOC file attributes get mapped like this, keep up:

  • readable on the EPOC device → mapped to user-readable on UNIX
  • read-only → inverted and mapped to user-writable
  • system, hidden and archived → mapped to the extended user attribute user.psion as the single characters s, h and a

so the extended attribute can be up to three characters long. and listen — if you try to read or write any other extended attribute, you get an error. periodt. ✋

💅 OPTIONS 💅

  • -V, --version — displays the version and dips. bye bestie 👋
  • -h, --help — shows a short help text and exits.
  • -d, --debug — produces debugging logs. you can specify it more than once to crank the debug level up (up to 3 times). the more the merrier honestly 🔥
  • -p, --port=[host:]port — tells it which host and port to connect to (like, the port where ncpd is listening on, iykyk). by default the host is 127.0.0.1 and the port gets looked up in /etc/services. and if it's not found there? fallback builtin of 7501. she always has a plan B 💜

💀 BUGS 💀

okay so this one's a little tragic. because UNIX file names are simply byte strings, if your EPOC device uses a different character set from the computer it's connected to — which is highly likely — then characters that are differently encoded between the two character sets will not translate between the two systems. 💀

it is usually safe to use 7-bit ASCII characters, avoiding colon (invalid on EPOC) and slash (invalid on UNIX).

this problem may be fixed in future 🙈 — for now, stay in your ASCII lane, bestie.

🦋 SEE ALSO 🦋

ncpd(8), plpprintd(8), plpftp(1), sisinstall(1), fusermount(1)

go read those too, they're all part of the friend group 🌈

👑 AUTHOR 👑

Reuben Thomas, based on plpnfsd by Fritz Elfert, and FUSE example code by Miklos Szeredi (miklos@szeredi.hu).

plpnfsd itself was heavily based on p3nfsd by Rudolf Koenig (rfkoenig@immd4.informatik.uni-erlangen.de) and plp_1_7 by Philip Proudman (phil@proudman51.freeserve.co.uk), with patches from Matt Gumbley (matt@gumbley.demon.co.uk).

Man page by Reuben Thomas <rrt@sc3d.org>, based on the man page for plpnfsd by John Lines (john+plpman@paladin.demon.co.uk).

and that's the whole page bestie, no cap, go mount something iconic 💖✨🎀

this has been plpfuse(8) from plptools 1.0.26 — system administration commands, mwah, take care of her 🫶💜

📦 where this page comes from