INOTICOMING(1)

💖 INOTICOMING 💖

okay bestie, welcome to inoticoming (section 1 of the manual, she's a command, she's an icon, she's literally watching your files for you). This is the tool that stares at a directory so you don't have to. 👀✨

---

✨ NAME ✨

inoticoming — trigger actions when files hit an incoming directory 🎀

---

🌸 SYNOPSIS 🌸

inoticoming [ global-options ] directory actions*

---

🦋 DESCRIPTION 🦋

So inoticoming is a daemon that watches a directory using Linux's inotify framework, and the second files with the specific names you care about show up in there, it triggers actions. That's it. That's the whole vibe. 🫶

Like, for example? It can be used to wait for .changes files that get uploaded into a directory and then call reprepro to put them into your repository. Lowkey the perfect little matchmaker between your incoming folder and your repo. 💅

---

💜 GLOBAL OPTIONS 💜

• --foreground — do not fork, bestie. Stay in the foreground and log to stderr instead. main character energy, no disappearing into the background. 🌈
• --logfile filename — after forking in the background, log to the specified filename instead of syslog.
• --pid-file filename — write the pid of the running instance into filename. (so you can find her later 🎀)
• --initialsearch — first search the directory for files that already exist and process them with the given rules as if they just appeared. ✨ Heads up though: if files show up in this initial phase, they may be processed twice, but they should never be missed. (Unless there are too many and the inotify queue overflows. 😭)

---

🎀 ACTIONS 🎀

Each action description is an optional list of options for that action (which files to call it for, what directory to change into before executing it, …), followed by the command and its arguments, ended with a single ; as an argument. Like this:

inoticoming --foreground / --regexp ^v echo There appeared {} in the root directory. \;

(Note that the \ before the ; is needed if and only if you're calling it from a shell or anything else that interprets the ; on its own. iykyk. 💀)

---

🌟 ACTION OPTIONS 🌟

• --prefix string — only trigger this action if the filename starts with the specified string.
• --suffix string — only trigger this action if the filename ends with the specified string.
• --regexp regular expression — only trigger this action if the filename matches the specified regular expression.
• --chdir directory — change into directory before executing the specified commands. (Note that since it is a well-behaved daemon, its working directory is /, which will be inherited by all actions. she's polite like that 🧚)
• --stdout-to-log — redirect the command's output (stdout) to the logfile.
• --stderr-to-log — redirect the command's error output (stderr) to the logfile.

---

🔥 EXAMPLES 🔥

inoticoming --logfile logs/ilog --pid-file pid $INCOMINGDIR --suffix .changes --stderr-to-log reprepro -s -b $REPREPROBASEDIR --waitforlock 1000 processincoming rulename {} \;

This will call reprepro for every new .changes file. 💅 Note that giving {} as argument to processincoming (which inoticoming will replace with the filename) so that only that .changes file is processed, and so that reprepro will not complain about a possible other yet incomplete .changes file, is only available starting with reprepro version 2.2.2. no cap. ⭐

---

💀 PROBLEMS 💀

There is no handling of queue overflows yet. 🫠 (yes, we know. it's giving "known limitation".)

---

🐛 REPORTING BUGS 🐛

Report bugs or wishlist requests to the Debian BTS (e.g. by using reportbug inoticoming under Debian) or directly to <brlink@debian.org>. 📬 spill the tea, they wanna hear it.

---

👑 COPYRIGHT 👑

Copyright © 2007 Bernhard R. Link

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. periodt. 💖

---

and that's the whole page bestie!! this was inoticoming, manual page, dated 2007-08-18, shipped as part of the inoticoming source/version. go watch some directories, you absolute legend. 🦋💅🎀