Mono(mono-service)

💖 mono-service — Mono(mono-service) 💖

okay bestie, sit down, grab a boba, because we're talking about the Mono ServiceProcess host and honestly? it's giving backend royalty. 👑

---

✨ NAME ✨

mono-service, mono-service2 — the Mono ServiceProcess host, aka the little program that lets your service live its truth in the background. 🫶

---

🌸 SYNOPSIS 🌸

mono-service [options] program.exe

---

🦋 DESCRIPTION 🦋

So. mono-service is a host — it's the thing that runs services built with the ServiceProcess assembly. It's not the service itself, it's the stage the service performs on. main character energy, but for a daemon. 💅

Which one do you use? Depends on your assembly vibe:

• Use mono-service to run services that use the 1.0 assemblies.
• Use mono-service2 to run services that use the 2.0 assemblies.

Now, the control situation. You talk to your service with signals, and she WILL listen:

• Send the SIGUSR1 signal to the process → the service gets paused ⏸️
• Send the SIGUSR2 signal → execution resumes ▶️
• Send the SIGTERM signal → the service shuts down cleanly 🧼✨

The following options can be used to control the service:

• -d:DIRECTORY — use this to set the working directory for the service. the default is the current directory. 🏠
• -l:LOCKFILE — specifies the file to use for locking. the default is a filename constructed in /tmp based on the name of the program that hosts the service. 🔒
• -m:MESSAGE — the name to show in the syslog. 📝
• -n:NAME — use this to specify which service to launch (in case your program contains more than one service). the default is to run the first defined service. 🥇
• --debug — use this to stop mono-service from redirecting stdin and stdout, and to prevent the program from being sent to the background. Equivalent to --no-daemon. 🐛
• --no-daemon — use this to stop mono-service from redirecting stdin and stdout, and to prevent the program from being sent to the background. Equivalent to --debug. 🐛

ngl the --debug / --no-daemon duo is literally the same thing twice and that's iconic of them honestly 💀

---

🎀 CONTROL 🎀

You can control the service by sending signals to the process. here are the commands, bestie:

Pausing service:

kill -USR1 `cat <lock file>`

Resuming service:

kill -USR2 `cat <lock file>`

Stopping the service:

kill `cat <lock file>`

the backticks matter!! cat <lock file> is reading your lock file to get the PID, and the kill is doing the actual slaying. don't skip the backticks or you'll be yelling at a file that doesn't exist. 😭

---

🌈 EXAMPLES 🌈

Start the MyService.exe assembly, with a lock in /root/service-lock:

mono-service -l:/root/service-lock MyService.exe

look at her go. so clean, so simple. obsessed. ✨

---

🔍 DEBUGGING 🔍

Messages produced by the service are logged on syslog. that's it, that's the whole section — go check your syslog. 📋

---

💌 MAILING LISTS 💌

Want to talk to the mono people? Visit http://lists.ximian.com/mailman/listinfo/mono-list for details. 📬

---

🌐 WEB SITE 🌐

Visit: http://www.mono-project.com for details. 🕸️

---

👀 SEE ALSO 👀

• mono(1)
• N:System.ServiceProcess

---

that's the whole page, bestie — every flag, every signal, every command, untouched, just with ✨flavor✨. fr fr, no cap. 💜

and that's a wrap on this Mono(mono-service) manual page — same manual name as up top, same footer energy down here. go run some services, you absolute legend. 🎀🦋💅