Net::Se...emonize(3)

💖 NAME 💖

Okay so this page is filed under Net::Se...emonize(3) in the User Contributed Perl Documentation set — yes, the header is a little truncated, slay — and the full manual name is Net::Server::Daemonize(3). The module itself is Net::Server::Daemonize: Safe fork and daemonization utilities. 🎀

✨ SYNOPSIS ✨

This is the whole vibe check:

           use Net::Server::Daemonize qw(daemonize);

           daemonize(
             'nobody',                 # User
             'nobody',                 # Group
             '/var/state/mydaemon.pid' # Path to PID file - optional
           );

🌸 DESCRIPTION 🌸

Okay so this module is intended to let you simply and safely daemonize your server on systems supporting the POSIX module. That means your Perl script runs in the background, and its process ID is stored in a file so you can easily stop it later. Literally iconic. 💖

🫶 EXPORTED FUNCTIONS 🫶

daemonize

Main routine, the main character energy. Arguments are user (or userid), group (or group id or space delimited list of groups), and pid_file (path to file). This routine will:

• check on the pid file
• safely fork
• create the pid file (storing the pid in the file)
• become another user and group
• close STDIN, STDOUT and STDERR
• separate from the process group (become session leader)
• install $SIG{INT} to remove the pid file

Basically: daemonize, periodt. All errors result in a die. As of version 0.89 the pid_file is optional. 🎀

safe_fork

Block SIGINT during fork. No arguments. Returns pid of forked child. All errors result in a die. 💀

set_user

Become another user and group. Arguments are user (or userid) and group (or group id or space delimited list of groups). 🫶

set_uid

Become another user. Argument is user (or userid). All errors die. ⚰️

set_gid

Become another group. Arguments are groups (or group ids or space delimited list of groups or group ids). All errors die. 🧚

get_uid

Find the uid. Argument is user (userid returns userid). Returns userid. All errors die. 🔍

get_gid

Find the gids. Arguments are groups or space delimited list of groups. All errors die. 🔍

is_root_user

Determine if the process is running as root. Returns 1 or undef. 👑

check_pid_file

Arguments are pid_file (full path to pid_file). Checks for existence of pid_file. If file exists, open it and determine if the process that created it is still running. This is done first by checking for a /proc file system and second using a "ps" command (BSD syntax). (If neither of these options exist it assumed that the process has ended.) If the process is still running, it aborts. Otherwise, returns true. All errors die. 😭

create_pid_file.

Arguments are pid_file (full path to pid_file). Calls check_pid_file. If it is successful (no pid_file exists), creates a pid file and stores $$ in the file. 🍓

unlink_pid_file

Does just that. 💅

👑 SEE ALSO 👑

• Net::Server.
• Net::Daemon, The Perl Cookbook Recipe 17.15.

🌈 AUTHORS 🌈

• Jeremy Howard <j+daemonize@howard.fm> — Program flow, concepts and initial work.
• Paul Seamons <paul@seamons.com> — Code rework and componentization. Ongoing maintainer.

💜 LICENSE 💜

This package may be distributed under the terms of either the GNU General Public License or the Perl Artistic License.

All rights reserved. 🫶

---

Okay bestie, that's the whole page. Cute little footer vibe check: source/version is perl v5.42.0, dated 2023-03-15, and the footer tag is Net::Se...emonize(3). Bye, slay, and may your daemons stay safely in the background. 💖✨