taskdctl(1)

📦 version 1.1.0, in debian bookworm, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble

🌸 taskdctl — the Taskserver control program 💅

okay bestie, so this is the manual page for taskdctl(1), a User Manuals classic, and it's literally the little remote control for your Taskserver. let's get into it 🎀

✨ NAME ✨

taskdctl — Taskserver control program

🦋 SYNOPSIS 🦋

taskdctl [start|stop|restart|graceful|status]

💖 DESCRIPTION 💖

so the taskdctl program is what lets you start and stop Taskserver, no cap. it uses the TASKDDATA environment variable to locate the root data structure, and it queries the configuration to figure out where the pid file lives. that's the whole vibe 🫶

👑 COMMANDS 👑

Taskdctl supports several commands:

🌟 taskdctl start

Starts the server as a daemon, if it is not already running. and here's the slay part: it is harmless to run this command if the server is already running. so like, no panic, you literally cannot mess it up 🙈

🌟 taskdctl stop

Stops the server, if it is running. and again, it is harmless to run this command if the server is not running. main character energy honestly ✨

🌟 taskdctl restart

Stops the server if it's running, then starts the server again. the way it does this? by killing the server process. 💀

okay so heads up bestie — this will interrupt any current sync sessions, which will probably cause an error. not ideal, but also it is harmless to run this command if the server is not running.

🌟 taskdctl graceful

Stops the server, if it's running, by waiting for the server to go idle, then restarts the server again. it does this by sending a SIGHUP signal to the server. this will not interrupt any current sync sessions — iconic, we love a gentle queen 🌸 and yes, it is harmless to run this command if the server is not running.

🌟 taskdctl status

Shows the status of the Taskserver — whether it is running or not. quick vibe check, basically 🔥

🌈 ENVIRONMENT VARIABLES 🌈

Taskdctl requires that the TAKSDDATA environment variable be properly set. this is because the root data structure is accessed. (yes, it's spelled exactly like that on the page, i'm just the messenger 🧚)

🎀 CREDITS & COPYRIGHTS 🎀

Copyright (C) 2010 - 2015, Göteborg Bit Factory.

Taskserver is distributed under the MIT license. See <http://www.opensource.org/licenses/mit-license.php> for more information.

💜 SEE ALSO 💜

taskd(1), taskdrc(5)

For more information regarding Taskserver, see the following:

🍓 REPORTING BUGS 🍓

Bugs in Taskserver may be reported to the issue-tracker at <http://taskwarrior.org

and that's the whole page, bestie — this one's from taskd 1.1.0, dated 2015-05-10, and it's the taskdctl(1) page in the User Manuals set. go forth and control your server, you absolute legend 👑💖

📦 where this page comes from