.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "SENDPAGE 1p" .TH SENDPAGE 1p "2021-01-08" "perl v5.32.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" sendpage \- listen for pages via SNPP, and send pages via modem .SH "SYNOPSIS" .IX Header "SYNOPSIS" sendpage [\s-1OPTIONS\s0] [recipient ...] .SH "OPTIONS" .IX Header "OPTIONS" .IP "\-bd" 4 .IX Item "-bd" Start sendpage in \*(L"daemon mode\*(R" where it will start all the Paging Central queues and wait for pages to be delivered. When sendpage runs as a daemon, it must be running as the 'sendpage' user as specified in the sendpage.cf file. .IP "\-bp" 4 .IX Item "-bp" Display all the pages waiting in the Paging Central queues. .IP "\-bv" 4 .IX Item "-bv" Try to expand the \*(L"recipient\*(R" name, using the recipient aliases specified in the configuration file. .IP "\-bs" 4 .IX Item "-bs" Shutdown the running sendpage daemon and all its children. If a Paging Central is in the middle of delivering a page, it will finish up and exit as soon as its current page is handled. .IP "\-br" 4 .IX Item "-br" This will send a \s-1SIGHUP\s0 to the master daemon. When the master gets the \&\s-1SIGHUP,\s0 it will re-read its configuration file, and restart all the Paging Centrals. It will wait for any busy Paging Centrals to finish before continuing. .IP "\-bq" 4 .IX Item "-bq" This displays the state of the running daemons: Running or Not running. If a pid file is stale (the file exists, but the process doesn't), it will mark that pid as \*(L"Stale\*(R". .IP "\-q[R pc]" 4 .IX Item "-q[R pc]" This will send a \s-1SIGUSR1\s0 signal to either the master daemon, or, if the Paging Central is specified, just that Paging Central in particular. When the master gets a \s-1SIGUSR1,\s0 it will send it to each of the running Paging Centrals. If the Paging Central is not busy, it will immediately start a queue run. .IP "\-C \s-1FILE\s0" 4 .IX Item "-C FILE" Read the configuration file \s-1FILE\s0 instead of the default /etc/sendpage/sendpage.cf .IP "\-h" 4 .IX Item "-h" Display a summary of all the available command line options. .IP "\-d" 4 .IX Item "-d" Turn on debugging (like \*(L"debug=true\*(R" in /etc/sendpage/sendpage.cf) .IP "\-f \s-1USER\s0" 4 .IX Item "-f USER" Show that the sent page is coming from \s-1USER.\s0 Default is the current user. .IP "\-m \s-1MESSAGE\s0" 4 .IX Item "-m MESSAGE" Send the given \s-1MESSAGE\s0 instead of reading text from stdin. .IP "\-n" 4 .IX Item "-n" Do not notify the 'from' user about the status of the page. .SH "DESCRIPTION" .IX Header "DESCRIPTION" Sendpage can run as the delivery agent, or as a client to insert a page into the paging queue. For the various command-line arguments, the idea here was to use sendmail-style arguments where I can, not to fully implement every option that sendmail has. I just want the learning curve of sendpage to be small for people already familiar with sendmail. .SH "FILES" .IX Header "FILES" .IP "\fI/etc/sendpage/sendpage.cf\fR" 4 .IX Item "/etc/sendpage/sendpage.cf" Default location for sendpage.cf, which holds all the configuration information for sendpage, including Paging Central definitions, recipients, and various other behaviors. .IP "\fI/var/spool/sendpage\fR" 4 .IX Item "/var/spool/sendpage" Default directory for all the Paging Central queues and pid files. .IP "\fI/var/lock\fR" 4 .IX Item "/var/lock" Default directory to keep the UUCP-style device locks. .SH "AUTHOR" .IX Header "AUTHOR" Kees Cook .SH "BUGS" .IX Header "BUGS" Oh, I bet this code is crawling with them. :) I've done my best to test this code, but I'm only one person. If you find strange behavior, please let me know. .SH "COPYRIGHT" .IX Header "COPYRIGHT" sendpage is free software; it can be used under the terms of the \s-1GNU\s0 General Public License. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBperl\fR\|(1), \fBkill\fR\|(1), \fBDevice::SerialPort\fR\|(3), \fBMail::Send\fR\|(3), \&\fBSendpage::KeesConf\fR\|(3), \fBSendpage::KeesLog\fR\|(3), \&\fBSendpage::Modem\fR\|(3), \fBSendpage::PagingCentral\fR\|(3), \fBSendpage::PageQueue\fR\|(3), \&\fBSendpage::Page\fR\|(3), \fBSendpage::Recipient\fR\|(3), \fBSendpage::Queue\fR\|(3)