launchd, il primo processo del Mac
Sul Mac non c’è init, non c’è systemd e cron è ancora presente ma deprecato: tutto passa da launchd, il processo con PID 1. All’avvio è lui che fa partire i servizi di sistema, al login quelli dell’utente; li riavvia se terminano, li lancia a orari stabiliti o quando succede qualcosa (un file che cambia, una connessione su una porta, un volume montato). In pratica fa il lavoro che su Linux si dividono systemd, cron e inetd.
Ogni servizio è descritto da un file plist (XML) con un’etichetta univoca, la Label, in stile dominio rovesciato: com.apple.cloudphotod, com.microsoft.update.agent, it.esempio.controllo-disco. Il comando per parlare con launchd è launchctl.
Chi ha letto la mia vecchia guida Pianificare le attività con cron ritroverà gli stessi concetti con un’altra sintassi: al posto della riga del crontab c’è un plist, al posto di crontab -e c’è launchctl bootstrap.
LaunchAgents e LaunchDaemons
La distinzione più importante è tra due tipi di servizio:
- un LaunchDaemon gira per conto del sistema, di solito come root, parte all’avvio anche se nessuno ha fatto login e non può mostrare nulla a schermo;
- un LaunchAgent gira per conto di un utente, parte al suo login, vive nella sua sessione grafica e può usare le sue cartelle, il suo portachiavi, le notifiche.
system per i demoni, gui/UID per gli agenti di ciascun utente collegato (501 è l’UID del primo utente creato sul Mac).I plist stanno in tre gruppi di cartelle. Tabella 1 – Dove si trovano:
| Cartella | Tipo | Di chi è |
|---|---|---|
/System/Library/LaunchDaemons | Demoni | Apple. Volume di sistema in sola lettura, protetto da SIP |
/System/Library/LaunchAgents | Agenti, per tutti gli utenti | Apple. Protetto da SIP |
/Library/LaunchDaemons | Demoni | Software di terze parti installato dall’amministratore (antivirus, VPN, agenti di gestione) |
/Library/LaunchAgents | Agenti, per tutti gli utenti | Software di terze parti |
~/Library/LaunchAgents | Agenti, solo per quell’utente | L’utente: è qui che mettiamo i nostri |
Le app moderne possono anche registrare i loro servizi da dentro il pacchetto .app (in Contents/Library/LaunchAgents o LaunchDaemons), senza copiare file in queste cartelle: per questo non tutto quello che gira compare negli elenchi qui sopra.
Gli elementi di login nelle Impostazioni
Da Ventura c’è un pannello grafico che riassume cosa parte da solo. Aprite Impostazioni di Sistema → Generali → Elementi login (su macOS 15 e 26 si chiama Elementi login ed estensioni). Troviamo due parti:
- Apri al login: le app che si aprono quando entriamo nell’account. Si aggiungono e si tolgono con + e −.
- La sezione dei servizi in background (su Ventura e Sonoma «Consenti in background»; su Tahoe la troviamo come «Attività app in background»): un interruttore per ogni app o produttore che ha registrato agenti o demoni.
Spegnere un interruttore impedisce a launchd di avviare i servizi di quel produttore, senza cancellare nulla: se l’app poi non funziona bene, lo riaccendiamo. È il modo più sicuro per fare pulizia, e il primo da provare prima di arrivare al Terminale. Quando un programma (o noi stessi) aggiunge un nuovo servizio, macOS mostra una notifica che segnala il nuovo elemento in background: vale la pena leggerla, perché è anche il modo in cui ci accorgiamo di software installato a nostra insaputa.
Lo stesso elenco, con il percorso esatto di ogni plist, lo otteniamo dal Terminale:
sudo sfltool dumpbtm | less # elenco completo degli elementi in background registrati
Cosa sta girando
Come faccio a sapere se un certo servizio è attivo? Il comando più rapido è quello di sempre:
launchctl list | grep -i microsoft
PID Status Label
812 0 com.microsoft.update.agent
- 0 com.microsoft.autoupdate.helper
La prima colonna è il PID (un trattino se in quel momento non è in esecuzione), la seconda il codice d’uscita dell’ultima esecuzione: 0 è tutto bene, un numero positivo è un errore del programma, un numero negativo indica che è stato terminato da un segnale (-9 = SIGKILL). Lanciato senza sudo, launchctl list mostra gli agenti del nostro utente; con sudo mostra i demoni di sistema.
Per i dettagli di un singolo servizio usiamo print, indicando il dominio:
# un agente del nostro utente
launchctl print gui/$(id -u)/com.apple.cloudphotod
# un demone di sistema
sudo launchctl print system/com.openssh.sshd
# tutto il dominio (lungo: meglio filtrare)
launchctl print gui/$(id -u) | less
Nell’output cerchiamo le righe path (il plist), program o arguments (cosa esegue), state (running o not running), runs (quante volte è partito) e last exit code. Altri due comandi utili:
launchctl blame gui/$(id -u)/com.apple.cloudphotod # perché è in esecuzione adesso
launchctl print-disabled gui/$(id -u) # servizi disattivati per il nostro utente
sudo launchctl print-disabled system # e per il sistema
I comandi di launchctl: vecchi e nuovi
Su molte guide in rete troviamo ancora launchctl load e unload. Funzionano ancora, ma Apple li considera superati (l’aiuto di launchctl suggerisce già le alternative) e su alcuni servizi danno errori poco chiari. La sintassi moderna richiede di indicare il dominio, ed è più precisa. Tabella 2 – Corrispondenze:
| Cosa vogliamo | Sintassi moderna | Vecchia sintassi |
|---|---|---|
| Caricare un servizio (e avviarlo se previsto) | launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/x.plist | launchctl load x.plist |
| Scaricarlo (e fermarlo) | launchctl bootout gui/$(id -u)/it.esempio.x | launchctl unload x.plist |
| Disattivarlo in modo permanente | launchctl disable gui/$(id -u)/it.esempio.x | launchctl unload -w x.plist |
| Riattivarlo | launchctl enable gui/$(id -u)/it.esempio.x | launchctl load -w x.plist |
| Avviarlo subito | launchctl kickstart gui/$(id -u)/it.esempio.x | launchctl start it.esempio.x |
| Riavviarlo (termina e riparte) | launchctl kickstart -k gui/$(id -u)/it.esempio.x | stop e poi start |
| Inviargli un segnale | launchctl kill SIGTERM gui/$(id -u)/it.esempio.x | kill sul PID |
Per i demoni il dominio è system e serve sudo: sudo launchctl bootstrap system /Library/LaunchDaemons/x.plist, sudo launchctl kickstart -k system/it.esempio.x.
disable e enable scrivono in un registro che sopravvive ai riavvii, ma non fermano un processo già in esecuzione: dicono solo a launchd di non caricarlo più. bootout invece ferma e scarica subito, ma al login o all’avvio successivo il servizio torna. Per spegnere qualcosa adesso e per sempre servono tutti e due: prima disable, poi bootout.
Un nostro LaunchAgent, passo per passo
Vediamo un caso concreto: uno script che ogni ora controlla lo spazio libero del disco di avvio, scrive una riga di log e ci avvisa con una notifica se si scende sotto il 10%. È un agente (gira come noi, al nostro login), quindi va in ~/Library/LaunchAgents. Negli esempi l’utente è utente: sostituitelo con il vostro nome breve (whoami).
Lo script
Per prima cosa creiamo la cartella e lo script:
mkdir -p ~/bin ~/Library/Logs
nano ~/bin/controllo-disco.sh
#!/bin/zsh
# controlla lo spazio libero del volume dati e avvisa sotto la soglia
SOGLIA=10 # percentuale minima di spazio libero
# su APFS lo spazio dell’utente è nel volume dati
uso=$(df -P /System/Volumes/Data | awk 'NR==2 { sub("%","",$5); print $5 }')
libero=$(( 100 - uso ))
echo "$(date '+%Y-%m-%d %H:%M:%S') libero ${libero}%"
if (( libero < SOGLIA )); then
osascript -e "display notification \"Spazio libero: ${libero}%\" with title \"Disco quasi pieno\""
fichmod 755 ~/bin/controllo-disco.sh
~/bin/controllo-disco.sh # proviamolo a mano prima di automatizzarlo
Il plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>it.esempio.controllo-disco</string>
<key>ProgramArguments</key>
<array>
<string>/bin/zsh</string>
<string>/Users/utente/bin/controllo-disco.sh</string>
</array>
<!-- ogni 3600 secondi, e una volta subito al caricamento -->
<key>StartInterval</key>
<integer>3600</integer>
<key>RunAtLoad</key>
<true/>
<key>StandardOutPath</key>
<string>/Users/utente/Library/Logs/controllo-disco.log</string>
<key>StandardErrorPath</key>
<string>/Users/utente/Library/Logs/controllo-disco.err</string>
</dict>
</plist>Labeldeve essere unica e, per abitudine, uguale al nome del file senza.plist.ProgramArgumentsè il comando spezzato in parole: niente stringa unica con gli spazi, niente~(launchd non lo espande), solo percorsi assoluti.StartIntervalconta i secondi. Se il Mac dorme quando scade l’intervallo, il lavoro parte una volta sola al risveglio, non tante volte quante ne ha perse. Per un orario preciso (come una riga di cron) si usa inveceStartCalendarInterval, per esempio con le chiaviHoureMinute.StandardOutPatheStandardErrorPathraccolgono quello che lo script scrive a schermo: senza, l’output va perso.- Il
PATHdi launchd è minimo (/usr/bin:/bin:/usr/sbin:/sbin): se lo script usa programmi di Homebrew, scriviamo il percorso completo (/opt/homebrew/bin/…) oppure aggiungiamo la chiaveEnvironmentVariables.
Verifica e caricamento
Prima di caricarlo controlliamo la sintassi, che è la causa di errore più frequente:
plutil -lint ~/Library/LaunchAgents/it.esempio.controllo-disco.plist
/Users/utente/Library/LaunchAgents/it.esempio.controllo-disco.plist: OK
Se è ok procediamo, altrimenti plutil indica la riga sbagliata. A questo punto carichiamo l’agente e verifichiamo che giri:
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/it.esempio.controllo-disco.plist
launchctl list | grep controllo-disco
- 0 it.esempio.controllo-disco
launchctl print gui/$(id -u)/it.esempio.controllo-disco | grep -E 'state|runs|last exit'
cat ~/Library/Logs/controllo-disco.log
2026-11-16 10:00:01 libero 41%
Per forzare un’esecuzione senza aspettare un’ora: launchctl kickstart gui/$(id -u)/it.esempio.controllo-disco. Il PID resta un trattino perché lo script dura un istante e termina: è il comportamento corretto.
Modificarlo e toglierlo
# dopo aver cambiato il plist: scarichiamo e ricarichiamo
launchctl bootout gui/$(id -u)/it.esempio.controllo-disco
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/it.esempio.controllo-disco.plist
# per eliminarlo del tutto
launchctl bootout gui/$(id -u)/it.esempio.controllo-disco
rm ~/Library/LaunchAgents/it.esempio.controllo-disco.plist
Le modifiche allo script invece valgono subito, dall’esecuzione successiva: launchd rilegge solo il plist. Un demone si costruisce allo stesso modo, ma il plist va in /Library/LaunchDaemons, deve appartenere a root:wheel con permessi 644, e si carica con sudo launchctl bootstrap system … (consiglio: usate un demone solo se lo script deve davvero girare come root o senza nessuno collegato).
Cosa disattivare, e con quanta prudenza
Il Mac è lento, la ventola gira: posso spegnere qualche servizio? Prima di toccare qualcosa conviene capire chi è. La regola pratica:
- Servizi di terze parti (
com.adobe.*,com.google.*, aggiornatori, «helper» di app che non usiamo più): sono i candidati naturali. Prima spegniamo l’interruttore in Elementi login; se non basta,disableebootout. Se l’app non ci serve più, disinstalliamola: i suoi plist spesso restano in/Library/LaunchAgentse/Library/LaunchDaemonse vanno cancellati a mano (primabootout, poirm). - Servizi Apple (
com.apple.*): di regola non si toccano. Molti dipendono l’uno dall’altro e disattivarne uno può rompere funzioni in modi difficili da collegare alla causa. I loro plist stanno nel volume di sistema in sola lettura e SIP impedisce di modificarli o di scaricare molti di essi anche consudo(l’errore tipico èOperation not permitted while System Integrity Protection is engaged).
Il caso di cloudphotod
C’è però un margine: launchctl disable su un servizio Apple del dominio utente di solito è accettato, perché scrive solo nel registro delle preferenze e non tocca i file protetti. Un esempio che mi capita di usare è cloudphotod, il processo che sincronizza la libreria di Foto con iCloud: su un Mac collegato a una rete a consumo o durante un lavoro che richiede tutta la banda, può dare fastidio.
La strada giusta, se la sincronizzazione non serve, è spegnerla dove è nata: app Foto → Impostazioni → iCloud, togliendo «Foto di iCloud». Se invece vogliamo solo fermare il servizio per un periodo, il comando corretto indica il dominio dell’utente (scritto senza dominio, launchctl disable com.apple.cloudphotod dà errore di sintassi):
launchctl print gui/$(id -u)/com.apple.cloudphotod | grep -E 'state|path' # chi è
launchctl disable gui/$(id -u)/com.apple.cloudphotod
launchctl print-disabled gui/$(id -u) | grep cloudphotod
"com.apple.cloudphotod" => disabled
Come abbiamo visto, disable non ferma il processo già avviato: l’effetto pieno lo abbiamo dopo un logout e un nuovo login, o un riavvio. Per tornare indietro:
launchctl enable gui/$(id -u)/com.apple.cloudphotod
e di nuovo logout e login. Finché il servizio è disattivato la libreria di Foto non si sincronizza: annotiamo da qualche parte cosa abbiamo spento e perché, così fra sei mesi, quando una foto non arriva sull’iPhone, sappiamo dove guardare.
Prima di disattivare un com.apple.* cerchiamo cosa fa, verifichiamo che non esista un’impostazione grafica che ottiene lo stesso risultato e teniamo pronto il comando enable. Non disattiviamo mai servizi legati a sicurezza, aggiornamenti, rete o login (com.apple.xprotect*, com.apple.softwareupdated, com.apple.mDNSResponder, com.apple.loginwindow…). Non ho verificato se ogni aggiornamento di macOS conserva o azzera queste disattivazioni: dopo un aggiornamento controlliamo con print-disabled.
Problemi comuni
| Sintomo | Causa e soluzione |
|---|---|
Bootstrap failed: 5: Input/output error | Messaggio generico. Le cause più frequenti: servizio già caricato (prima bootout), plist non valido (plutil -lint), servizio disattivato (print-disabled, poi enable), permessi o proprietario del plist sbagliati, interruttore spento in Elementi login. |
| L’agente è caricato ma lo script non fa nulla | Guardiamo StandardErrorPath e last exit code in launchctl print. Spesso è un comando non trovato per via del PATH ridotto: usiamo percorsi assoluti. |
Operation not permitted nel log dello script | Lo script legge una cartella protetta da TCC (Documenti, Scrivania, dischi esterni). Diamo l’accesso completo al disco all’interprete (/bin/zsh) in Privacy e sicurezza, o spostiamo i file altrove. |
Codice d’uscita 78 o 126 | Di solito il programma indicato non è eseguibile o il percorso è sbagliato: controlliamo ProgramArguments e i permessi (chmod 755). |
| Il servizio parte una sola volta e poi mai più | Manca StartInterval o StartCalendarInterval, oppure l’abbiamo scritto con il tipo sbagliato (<string> al posto di <integer>). |
Operation not permitted while System Integrity Protection is engaged | Stiamo cercando di scaricare un servizio Apple protetto. Lasciamolo stare: se proprio serve, valutiamo disable nel dominio corretto, con le cautele viste sopra. |
Il passo successivo
Un LaunchAgent è il modo naturale per automatizzare i backup del Mac: lo script con rsync lo trovate in Time Machine, tmutil e backup con rsync, e l’idea di base è la stessa della mia vecchia guida Un semplice backup con rsync. Per le basi del Terminale e di defaults vedi Il Terminale del Mac per sistemisti; per SIP, TCC e le altre protezioni che limitano anche launchctl, Le protezioni di macOS. Chi viene da Linux e vuole confrontare launchd con systemd, la guida Uno script per analizzare i log di Ubuntu mostra lo stesso tipo di automazione con un timer.
Prova sempre la configurazione in laboratorio, salva quella attuale prima di modificarla e tieni un accesso di emergenza (console o accesso fuori banda) quando lavori su firewall e VPN da remoto.