totoro

A simple web interface to line printer daemon (lpd) printing on OpenBSD.

May work on other unixes, or may not.

Installation

These installation instructions assume OpenBSD.

Copy the perl script to the cgi-bin directory:

doas cp print.pl /var/www/cgi-bin/

Perl

Install perl packages:

doas pkg_add p5-Any-URI-Escape p5-YAML p5-Clone

As of this writing, Net::Printer and URI::Query are not in openbsd packages, so we'll install them locally. You may want to check if this has changed.

To install them locally, first install local::lib:

doas pkg_add p5-local-lib

Then tell perl to install modules to /var/www/perl5:

PATH="/var/www/perl5/bin${PATH:+:${PATH}}"; export PATH;
PERL5LIB="/var/www/perl5/lib/perl5${PERL5LIB:+:${PERL5LIB}}"; export PERL5LIB;
PERL_LOCAL_LIB_ROOT="/var/www/perl5${PERL_LOCAL_LIB_ROOT:+:${PERL_LOCAL_LIB_ROOT}}"; export PERL_LOCAL_LIB_ROOT;
PERL_MB_OPT="--install_base \"/var/www/perl5\""; export PERL_MB_OPT;
PERL_MM_OPT="INSTALL_BASE=/var/www/perl5"; export PERL_MM_OPT;

Then install dependencies:

perl -MCPAN -e "use local::lib '/var/www/perl5'; install Net::Printer;"
perl -MCPAN -e "use local::lib '/var/www/perl5'; install URI::Query;"

Daemons

Set up httpd and slowcgi:

NOTE: these instructions set up httpd and slowcgi without chroot. Probably it can be made to work in a chroot.

Add to /etc/httpd.conf:

chroot "/"
logdir "/var/www/logs"

server "totoro" {
        listen on * port 80
        root "/var/www/htdocs"

        # cgi
        location "/" {
            fastcgi socket "/var/www/run/slowcgi.sock"
            root "/var/www/cgi-bin/print.pl"
        }
        location "/" {
            root "/var/www/print.pl"
            fastcgi socket "/var/www/run/slowcgi.sock"
        }
}

Set daemon flags and start:

$ doas rcctl set slowcgi flags "-p /"
$ doas rcctl enable httpd slowcgi
$ doas rcctl start httpd slowcgi

If your printer is not already set up yet, read up on lpd(8) and printcap(5).

Usage

Place any jobs files into /var/www/jobs.

Visit the web interface in a web browser.