FCE_LISTEN(1)

💖 FCE_LISTEN(1) 💖

okay bestie, welcome to the Netatalk AFP Fileserver Manual, but make it cute ✨

---

🌸 Name 🌸

fce_listen — the Netatalk Filesystem Change Events listener application. she listens. that's her whole job. 👑

---

🦋 Synopsis 🦋

fce_listen [-h host] [-p port]

---

✨ Description ✨

so fce_listen is a lil listener for Netatalk's Filesystem Change Event (FCE) protocol. basically it sits there, vibes, and every UDP datagram it catches coming from the AFP server gets printed straight to stdout. that's it. no notes. 🫶

Note: this utility NEEDS netatalk to be built with FCE support turned on (that's the -Dwith-fce=true meson build option — which, good news, is enabled by default 💅). no FCE support, no listening, periodt.

---

💜 Options 💜

• -h host — server hostname or IP address, as in where is the server bestie 📍
• -p port — server port number, the lil door number you're knocking on 🚪

---

🎀 Examples 🎀

first up: tell netatalk to yeet FCE packets over to a listener chilling on localhost port 58585. pop this in afp.conf:

[Global]
fce listener = localhost:58585
fce version = 2
fce events = fmod,fdel,ddel,fcre,dcre,fmov,dmov,login,logout

then, listen to FCE events on localhost port 58585:

$ fce_listen -h localhost -p 58585
Listening for Netatalk FCE datagrams on localhost:58585...
FCE Start
ID: 1, Event: FCE_LOGIN, pid: 429918, user: nobody, Path:
ID: 2, Event: FCE_LOGOUT, pid: 429918, user: nobody, Path:
FCE Start
ID: 1, Event: FCE_LOGIN, pid: 429924, user: myuser, Path:
ID: 2, Event: FCE_FILE_DELETE, pid: 429924, user: myuser, Path: /srv/afpme/Read Me First copy
ID: 3, Event: FCE_DIR_CREATE, pid: 429924, user: myuser, Path: /srv/afpme/untitled folder
ID: 4, Event: FCE_DIR_MOVE, pid: 429924, user: myuser, source: /srv/afpme/untitled folder, Path: /srv/afpme/My Folder
ID: 5, Event: FCE_FILE_MOVE, pid: 429924, user: myuser, source: /srv/afpme/LICENSE, Path: /srv/afpme/My Folder/LICENSE

look at all those events coming in one after another, no cap, it's giving main character energy fr fr 🔥

---

🌈 See Also 🌈

• afpd(8) — go say hi 👋

---

and that's the whole page bestie!! this was Netatalk 4.5.1, mwah, stay slaying, drink water, and may your datagrams always arrive 💖✨🎀🦋