NAME

Fugu - OpenBSD-style daemon utilities for Perl

SYNOPSIS

    use Fugu::Daemon;
    use Fugu::Log;
    use Fugu::EventLoop;

DESCRIPTION

Fugu gives a Perl daemon the plumbing that OpenBSD daemons share. The utilities live in the "Fugu::" modules, one concern each. This lead module holds no code: it names the distribution, and this document is the module index.

The distribution also ships "Protocol::Imsg", a sans-IO codec for the imsg(3) frame.

Fugu needs core Perl only (v5.34). Every CPAN module it can use is an optional feature, loaded lazily.

MODULES

Fugu::CLI - subcommand dispatch for a command-line tool

Fugu::Config - the OpenBSD-style configuration grammar

Fugu::Control - a control socket for a running daemon

Fugu::Curl - download one URL to one file, through curl, wget, or ftp

Fugu::Daemon - daemonization for Perl programs

Fugu::Ed25519 - verify an Ed25519 signature with core Perl

Fugu::EventLoop - one select loop for a daemon with one process

Fugu::File - file operations for a daemon and its tools

Fugu::Imsg - imsg messages over a connected stream socket

Fugu::JSONSocket - newline-delimited JSON over a UNIX socket

Fugu::KeyDir - the names, the order and the generated text of a published key directory

Fugu::Log - logging to syslog, standard error, or nowhere

Fugu::MQTT - a subscribing MQTT client for a single-threaded daemon

Fugu::Mdnsd - control mdnsd over its control socket

Fugu::OpenPGP - read an armored OpenPGP public key as bytes, and drive gpg(1) over a key

Fugu::Pidfile - locked PID file

Fugu::Privdrop - permanent drop of root privileges

Fugu::Process - child process management

Fugu::Proxy - a caching HTTP proxy

Fugu::REPL - a line editor for an operator prompt

Fugu::Random - random bytes and random passwords

Fugu::SSH - run a command on another machine over SSH

Fugu::Sandbox - pledge and unveil as a platform abstraction

Fugu::Signal - signal handlers for graceful shutdown

Fugu::Signer - one shape for the three modules that drive a signing command

Fugu::Signify - make a signify(1) key pair, sign a file, verify a signature, and read and write a SHA256 manifest

Fugu::StateFile - a small JSON state file

Fugu::TestLog - a quiet process default logger for a test file

Fugu::Timeout - run something under a time limit

Fugu::X509 - read an X.509 certificate as bytes, and drive openssl(1) over a certificate

Protocol::Imsg - the OpenBSD imsg(3) frame, as bytes

SEE ALSO

The development guide and the release flow live in the repository at <https://github.com/FuguBSD/Fugu>.

AUTHORS

Dick Olsson <hi@senzilla.io>