---
name: "Net::Server::Daemonize"
section: "3pm"
platform: "linux"
package: "perl-net-server"
version: "2.018-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Server::Daemonize"
---

# Net::Server::Daemonize(3pm)

Safe fork and daemonization utilities

## NAME

Net::Server::Daemonize - Safe fork and daemonization utilities

## SYNOPSIS

```
    use Net::Server::Daemonize qw(daemonize);
    daemonize(
      'nobody',                 # User
      'nobody',                 # Group
      '/var/state/mydaemon.pid' # Path to PID file - optional
    );
```

## DESCRIPTION

This module is intended to let you simply and safely daemonize your server on systems supporting the POSIX module. This means that your Perl script runs in the background, and it's process ID is stored in a file so you can easily stop it later.

## EXPORTED FUNCTIONS

- daemonize

  Main routine.  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), and install `$SIG`{INT} to remove the pid file.  In otherwords - daemonize.  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.
```