"Fossies" - the Fresh Open Source Software Archive

Member "sendpage-1.001001/docs/sendpage-manual.lyx" (3 Jan 2008, 35295 Bytes) of package /linux/privat/old/sendpage-1.001001.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 #LyX 1.3 created this file. For more info see http://www.lyx.org/
    2 \lyxformat 221
    3 \textclass book
    4 \language english
    5 \inputencoding auto
    6 \fontscheme default
    7 \graphics default
    8 \paperfontsize default
    9 \spacing single 
   10 \papersize Default
   11 \paperpackage a4
   12 \use_geometry 0
   13 \use_amsmath 0
   14 \use_natbib 0
   15 \use_numerical_citations 0
   16 \paperorientation portrait
   17 \secnumdepth 2
   18 \tocdepth 3
   19 \paragraph_separation indent
   20 \defskip medskip
   21 \quotes_language english
   22 \quotes_times 2
   23 \papercolumns 1
   24 \papersides 1
   25 \paperpagestyle default
   26 
   27 \layout Title
   28 
   29 Using Sendpage
   30 \newline 
   31 (the 
   32 \emph on 
   33 unfinished
   34 \emph default 
   35  Sendpage Manual)
   36 \layout Author
   37 
   38 Kees Cook
   39 \newline 
   40 
   41 \family typewriter 
   42 kees@outflux.net
   43 \layout Date
   44 
   45 $Revision: 191 $ $Date: 2005-02-24 15:13:27 -0800 (Thu, 24 Feb 2005) $
   46 \newline 
   47 $RCSfile$
   48 \layout Standard
   49 
   50 
   51 \begin_inset LatexCommand \tableofcontents{}
   52 
   53 \end_inset 
   54 
   55 
   56 \layout Chapter
   57 
   58 How to Install the Sendpage Daemon
   59 \layout Section
   60 
   61 Prerequisites
   62 \layout Standard
   63 
   64 In order for sendpage to operate correctly, you need several things installed
   65  and configured properly on your system.
   66  The three major items are the correct set of Perl modules, the correct
   67  syslog configuration, and a properly identified operating environment for
   68  your sendpage program.
   69 \layout Subsection
   70 
   71 Perl Modules
   72 \layout Standard
   73 
   74 All of the perl modules you need for sendpage are available from 
   75 \family typewriter 
   76 http://www.cpan.org/
   77 \family default 
   78  and instructions on how to install them can be found there.
   79  What each module does for you is described below.
   80 \layout Subsubsection
   81 
   82 
   83 \family typewriter 
   84 Net::SNPP
   85 \family default 
   86  (libnet)
   87 \layout Standard
   88 
   89 To run the SNPP client 
   90 \family typewriter 
   91 snpp
   92 \family default 
   93  that comes with the sendpage package, you need the Perl module that will
   94  talk SNPP with an SNPP server.
   95  If you've got a proper install of Perl on your system, it is likely that
   96  you already have the 
   97 \family typewriter 
   98 libnet
   99 \family default 
  100  bundle, which includes 
  101 \family typewriter 
  102 Net::SNPP
  103 \family default 
  104 .
  105 \layout Subsubsection
  106 
  107 
  108 \family typewriter 
  109 Mail::Send (MailTools)
  110 \layout Standard
  111 
  112 To send email notifications with the sendpage package, you need the 
  113 \family typewriter 
  114 Mail::Send
  115 \family default 
  116  module, which may also already be installed with Perl, depending on your
  117  distribution.
  118  This module is found in the 
  119 \family typewriter 
  120 MailTools
  121 \family default 
  122  bundle.
  123 \layout Subsubsection
  124 
  125 
  126 \family typewriter 
  127 Device::SerialPort
  128 \layout Standard
  129 
  130 Of all the prerequisites for sendpage, the 
  131 \family typewriter 
  132 Device::SerialPort
  133 \family default 
  134  module is the most important.
  135  As of version 0.20, this module has been tested to run fine under Linux,
  136  Solaris, and BSD.
  137  It should operate under AIX and HPUX, but may require some testing.
  138  To read more on how to install this module correctly, please read the 
  139 \family typewriter 
  140 Device::SerialPort
  141 \family default 
  142  
  143 \family typewriter 
  144 README
  145 \family default 
  146  file that comes with that package.
  147 \layout Standard
  148 
  149 If you're running under Windows, the 
  150 \family typewriter 
  151 Win32::SerialPort
  152 \family default 
  153  module should also work.
  154  As of sendpage version 0.9.9, this is an untested configuration, and may
  155  take a good deal of work to get it functioning correctly.
  156 \layout Subsection
  157 
  158 Syslog Configuration
  159 \layout Standard
  160 
  161 To properly examine debugging information to help you troubleshoot problems
  162  with sendpage, you need to have your syslog configuration set to correctly
  163  capture all that sendpage sends to it.
  164  Sendpage uses the 
  165 \family typewriter 
  166 daemon
  167 \family default 
  168  syslog facility by default, and a variety of syslog levels from 
  169 \family typewriter 
  170 info
  171 \family default 
  172  through 
  173 \family typewriter 
  174 alert
  175 \family default 
  176 .
  177  If you want to change the syslog facility, the following example uses 
  178 \family typewriter 
  179 local6
  180 \family default 
  181  with a minimum level of 
  182 \family typewriter 
  183 debug
  184 \family default 
  185 :
  186 \layout Subsubsection
  187 
  188 Same file or separate files
  189 \layout Standard
  190 
  191 If your syslog configuration looks like this:
  192 \layout Quotation
  193 
  194 
  195 \family typewriter 
  196 *.info;mail.none;authpriv.none;kern.none\SpecialChar ~
  197 \SpecialChar ~
  198 \SpecialChar ~
  199 \SpecialChar ~
  200 \SpecialChar ~
  201 \SpecialChar ~
  202 \SpecialChar ~
  203 \SpecialChar ~
  204 \SpecialChar ~
  205 \SpecialChar ~
  206 \SpecialChar ~
  207 \SpecialChar ~
  208 \SpecialChar ~
  209 \SpecialChar ~
  210 \SpecialChar ~
  211 \SpecialChar ~
  212 /var/log/messages
  213 \layout Standard
  214 
  215 The easiest way to add 
  216 \family typewriter 
  217 local6
  218 \family default 
  219  to your syslog configuration would be:
  220 \layout Quotation
  221 
  222 
  223 \family typewriter 
  224 *.info;
  225 \series bold 
  226 local6.*;
  227 \series default 
  228 mail.none;authpriv.none;kern.none\SpecialChar ~
  229 \SpecialChar ~
  230 \SpecialChar ~
  231 \SpecialChar ~
  232 \SpecialChar ~
  233 \SpecialChar ~
  234 \SpecialChar ~
  235 /var/log/messages
  236 \layout Standard
  237 
  238 If you want your sendpage output sent to a separate file, your syslog configurat
  239 ion would be:
  240 \layout Quotation
  241 
  242 
  243 \family typewriter 
  244 *.info;
  245 \series bold 
  246 local6.none;
  247 \series default 
  248 mail.none;authpriv.none;kern.none\SpecialChar ~
  249 \SpecialChar ~
  250 \SpecialChar ~
  251 \SpecialChar ~
  252 /var/log/messages
  253 \layout Quotation
  254 
  255 
  256 \family typewriter 
  257 \series bold 
  258 local6.*\SpecialChar ~
  259 \SpecialChar ~
  260 \SpecialChar ~
  261 \SpecialChar ~
  262 \SpecialChar ~
  263 \SpecialChar ~
  264 \SpecialChar ~
  265 \SpecialChar ~
  266 \SpecialChar ~
  267 \SpecialChar ~
  268 \SpecialChar ~
  269 \SpecialChar ~
  270 \SpecialChar ~
  271 \SpecialChar ~
  272 \SpecialChar ~
  273 \SpecialChar ~
  274 \SpecialChar ~
  275 \SpecialChar ~
  276 \SpecialChar ~
  277 \SpecialChar ~
  278 \SpecialChar ~
  279 \SpecialChar ~
  280 \SpecialChar ~
  281 \SpecialChar ~
  282 \SpecialChar ~
  283 \SpecialChar ~
  284 \SpecialChar ~
  285 \SpecialChar ~
  286 \SpecialChar ~
  287 \SpecialChar ~
  288 \SpecialChar ~
  289 \SpecialChar ~
  290 \SpecialChar ~
  291 \SpecialChar ~
  292 \SpecialChar ~
  293 \SpecialChar ~
  294 \SpecialChar ~
  295 \SpecialChar ~
  296 \SpecialChar ~
  297 \SpecialChar ~
  298 \SpecialChar ~
  299 \SpecialChar ~
  300 \SpecialChar ~
  301 \SpecialChar ~
  302 \SpecialChar ~
  303 \SpecialChar ~
  304 \SpecialChar ~
  305 \SpecialChar ~
  306 /var/log/sendpage
  307 \layout Subsubsection
  308 
  309 Split off debug output
  310 \layout Standard
  311 
  312 If you want to separate your debug output from all your other syslog files,
  313  another configuration could be:
  314 \layout Quotation
  315 
  316 
  317 \family typewriter 
  318 *.info;
  319 \series bold 
  320 local6.none;
  321 \series default 
  322 mail.none;authpriv.none;kern.none\SpecialChar ~
  323 \SpecialChar ~
  324 \SpecialChar ~
  325 \SpecialChar ~
  326 /var/log/messages
  327 \layout Quotation
  328 
  329 
  330 \family typewriter 
  331 \series bold 
  332 local6.info\SpecialChar ~
  333 \SpecialChar ~
  334 \SpecialChar ~
  335 \SpecialChar ~
  336 \SpecialChar ~
  337 \SpecialChar ~
  338 \SpecialChar ~
  339 \SpecialChar ~
  340 \SpecialChar ~
  341 \SpecialChar ~
  342 \SpecialChar ~
  343 \SpecialChar ~
  344 \SpecialChar ~
  345 \SpecialChar ~
  346 \SpecialChar ~
  347 \SpecialChar ~
  348 \SpecialChar ~
  349 \SpecialChar ~
  350 \SpecialChar ~
  351 \SpecialChar ~
  352 \SpecialChar ~
  353 \SpecialChar ~
  354 \SpecialChar ~
  355 \SpecialChar ~
  356 \SpecialChar ~
  357 \SpecialChar ~
  358 \SpecialChar ~
  359 \SpecialChar ~
  360 \SpecialChar ~
  361 \SpecialChar ~
  362 \SpecialChar ~
  363 \SpecialChar ~
  364 \SpecialChar ~
  365 \SpecialChar ~
  366 \SpecialChar ~
  367 \SpecialChar ~
  368 \SpecialChar ~
  369 \SpecialChar ~
  370 \SpecialChar ~
  371 \SpecialChar ~
  372 \SpecialChar ~
  373 \SpecialChar ~
  374 \SpecialChar ~
  375 \SpecialChar ~
  376 \SpecialChar ~
  377 /var/log/sendpage
  378 \layout Quotation
  379 
  380 
  381 \family typewriter 
  382 \series bold 
  383 *.=debug\SpecialChar ~
  384 \SpecialChar ~
  385 \SpecialChar ~
  386 \SpecialChar ~
  387 \SpecialChar ~
  388 \SpecialChar ~
  389 \SpecialChar ~
  390 \SpecialChar ~
  391 \SpecialChar ~
  392 \SpecialChar ~
  393 \SpecialChar ~
  394 \SpecialChar ~
  395 \SpecialChar ~
  396 \SpecialChar ~
  397 \SpecialChar ~
  398 \SpecialChar ~
  399 \SpecialChar ~
  400 \SpecialChar ~
  401 \SpecialChar ~
  402 \SpecialChar ~
  403 \SpecialChar ~
  404 \SpecialChar ~
  405 \SpecialChar ~
  406 \SpecialChar ~
  407 \SpecialChar ~
  408 \SpecialChar ~
  409 \SpecialChar ~
  410 \SpecialChar ~
  411 \SpecialChar ~
  412 \SpecialChar ~
  413 \SpecialChar ~
  414 \SpecialChar ~
  415 \SpecialChar ~
  416 \SpecialChar ~
  417 \SpecialChar ~
  418 \SpecialChar ~
  419 \SpecialChar ~
  420 \SpecialChar ~
  421 \SpecialChar ~
  422 \SpecialChar ~
  423 \SpecialChar ~
  424 \SpecialChar ~
  425 \SpecialChar ~
  426 \SpecialChar ~
  427 \SpecialChar ~
  428 \SpecialChar ~
  429 \SpecialChar ~
  430 \SpecialChar ~
  431 /var/log/debug
  432 \layout Standard
  433 
  434 This will allow you to view all your debug output in a single separate file.
  435 \layout Standard
  436 
  437 I find that the following syslog configuration allows me to view sendpage
  438  logging either way I want: with debugging or without debugging:
  439 \layout Quotation
  440 
  441 
  442 \family typewriter 
  443 *.info;
  444 \series bold 
  445 local6.none;
  446 \series default 
  447 mail.none;authpriv.none;kern.none\SpecialChar ~
  448 \SpecialChar ~
  449 \SpecialChar ~
  450 \SpecialChar ~
  451 /var/log/messages
  452 \layout Quotation
  453 
  454 
  455 \family typewriter 
  456 \series bold 
  457 local6.info\SpecialChar ~
  458 \SpecialChar ~
  459 \SpecialChar ~
  460 \SpecialChar ~
  461 \SpecialChar ~
  462 \SpecialChar ~
  463 \SpecialChar ~
  464 \SpecialChar ~
  465 \SpecialChar ~
  466 \SpecialChar ~
  467 \SpecialChar ~
  468 \SpecialChar ~
  469 \SpecialChar ~
  470 \SpecialChar ~
  471 \SpecialChar ~
  472 \SpecialChar ~
  473 \SpecialChar ~
  474 \SpecialChar ~
  475 \SpecialChar ~
  476 \SpecialChar ~
  477 \SpecialChar ~
  478 \SpecialChar ~
  479 \SpecialChar ~
  480 \SpecialChar ~
  481 \SpecialChar ~
  482 \SpecialChar ~
  483 \SpecialChar ~
  484 \SpecialChar ~
  485 \SpecialChar ~
  486 \SpecialChar ~
  487 \SpecialChar ~
  488 \SpecialChar ~
  489 \SpecialChar ~
  490 \SpecialChar ~
  491 \SpecialChar ~
  492 \SpecialChar ~
  493 \SpecialChar ~
  494 \SpecialChar ~
  495 \SpecialChar ~
  496 \SpecialChar ~
  497 \SpecialChar ~
  498 \SpecialChar ~
  499 \SpecialChar ~
  500 \SpecialChar ~
  501 \SpecialChar ~
  502 /var/log/sendpage
  503 \layout Quotation
  504 
  505 
  506 \family typewriter 
  507 \series bold 
  508 local6.debug\SpecialChar ~
  509 \SpecialChar ~
  510 \SpecialChar ~
  511 \SpecialChar ~
  512 \SpecialChar ~
  513 \SpecialChar ~
  514 \SpecialChar ~
  515 \SpecialChar ~
  516 \SpecialChar ~
  517 \SpecialChar ~
  518 \SpecialChar ~
  519 \SpecialChar ~
  520 \SpecialChar ~
  521 \SpecialChar ~
  522 \SpecialChar ~
  523 \SpecialChar ~
  524 \SpecialChar ~
  525 \SpecialChar ~
  526 \SpecialChar ~
  527 \SpecialChar ~
  528 \SpecialChar ~
  529 \SpecialChar ~
  530 \SpecialChar ~
  531 \SpecialChar ~
  532 \SpecialChar ~
  533 \SpecialChar ~
  534 \SpecialChar ~
  535 \SpecialChar ~
  536 \SpecialChar ~
  537 \SpecialChar ~
  538 \SpecialChar ~
  539 \SpecialChar ~
  540 \SpecialChar ~
  541 \SpecialChar ~
  542 \SpecialChar ~
  543 \SpecialChar ~
  544 \SpecialChar ~
  545 \SpecialChar ~
  546 \SpecialChar ~
  547 \SpecialChar ~
  548 \SpecialChar ~
  549 \SpecialChar ~
  550 \SpecialChar ~
  551 \SpecialChar ~
  552 /var/log/sendpage.debug
  553 \layout Subsection
  554 
  555 
  556 \family typewriter 
  557 sendpage
  558 \family default 
  559  user environment
  560 \layout Standard
  561 
  562 Sendpage performs 3 major duties on your system: 1) operates on your serial
  563  port to use the modem, 2) writes to disk to store page information, 3)
  564  operates on a network socket to receive new pages.
  565  To get these things done in a secure fashion, sendpage tries to 
  566 \series bold 
  567 not
  568 \series default 
  569  run as the 
  570 \family typewriter 
  571 root
  572 \family default 
  573  user.
  574  For some things, it must; binding to network ports below 1024 requires
  575  
  576 \family typewriter 
  577 root
  578 \family default 
  579  permissions.
  580  Also, the serial port needs to be reserved for use (with UUCP-style locking)
  581  so that other processes can share the modem with sendpage.
  582  Finally, the serial port itself will require some sort of privileges to
  583  read and write to it.
  584 \layout Subsubsection
  585 
  586 Creating a 
  587 \family typewriter 
  588 sendpage
  589 \family default 
  590  user
  591 \layout Standard
  592 
  593 To store pages and other information to disk, and to run network sessions
  594  
  595 \series bold 
  596 not
  597 \series default 
  598  as the 
  599 \family typewriter 
  600 root
  601 \family default 
  602  user, a regular user is required.
  603  For the rest of this document, it is assumed that this user is named 
  604 \begin_inset Quotes eld
  605 \end_inset 
  606 
  607 sendpage
  608 \begin_inset Quotes erd
  609 \end_inset 
  610 
  611 .
  612  This user should have no special privileges, and can be an presently unused
  613  user ID on your system.
  614  If this user is not known as 
  615 \begin_inset Quotes eld
  616 \end_inset 
  617 
  618 sendpage
  619 \begin_inset Quotes erd
  620 \end_inset 
  621 
  622 , the sendpage daemon needs to know, and this can be changed using the 
  623 \family typewriter 
  624 user
  625 \family default 
  626  configuration option.
  627 \layout Subsubsection
  628 
  629 Finding locking group
  630 \layout Standard
  631 
  632 To let sendpage reserve a serial port for use, the daemon will attempt to
  633  use UUCP-style file locking.
  634  Finding where this happens is important (and is set using the 
  635 \family typewriter 
  636 lockprefix
  637 \family default 
  638  option).
  639  Usually the locking directory is either 
  640 \family typewriter 
  641 /var/lock
  642 \family default 
  643  or 
  644 \family typewriter 
  645 /var/spool/lock
  646 \family default 
  647 , and a single group will have permission to read and write in that directory.
  648  Usually this group is the 
  649 \family typewriter 
  650 uucp
  651 \family default 
  652  group.
  653  If not, the locking group must be set using the 
  654 \family typewriter 
  655 group-lock
  656 \family default 
  657  option.
  658 \layout Subsubsection
  659 
  660 Finding tty-use group
  661 \layout Standard
  662 
  663 To let sendpage read and write to a serial port, the daemon must know which
  664  group to use to open the device.
  665  By default, sendpage expects to use the 
  666 \family typewriter 
  667 tty
  668 \family default 
  669  group, but sometimes this is the 
  670 \family typewriter 
  671 uucp
  672 \family default 
  673  group.
  674  This is set using the 
  675 \family typewriter 
  676 group-tty
  677 \family default 
  678  option.
  679  Sometimes there is no group that can read and write to the device.
  680  In these cases, you will need to change the permissions on your serial
  681  port so that some group can read and write your serial port.
  682 \layout Standard
  683 
  684 For example, if you want to use the 
  685 \family typewriter 
  686 tty
  687 \family default 
  688  group, and your serial port looks like this:
  689 \layout Quotation
  690 
  691 
  692 \family typewriter 
  693 # ls -l /dev/ttyS0
  694 \layout Quotation
  695 
  696 
  697 \family typewriter 
  698 crw------- 1 root root 4, 64 Mar 1 18:37 /dev/ttyS0
  699 \layout Standard
  700 
  701 Then you would need to change the group and permissions like this:
  702 \layout Quotation
  703 
  704 
  705 \family typewriter 
  706 # chgrp tty /dev/ttyS0
  707 \layout Quotation
  708 
  709 
  710 \family typewriter 
  711 # chmod g+rw /dev/ttyS0
  712 \layout Quotation
  713 
  714 
  715 \family typewriter 
  716 # ls -l /dev/ttyS0
  717 \layout Quotation
  718 
  719 
  720 \family typewriter 
  721 crw-
  722 \series bold 
  723 rw
  724 \series default 
  725 ---- 1 root 
  726 \series bold 
  727 tty\SpecialChar ~
  728 \SpecialChar ~
  729 
  730 \series default 
  731 4, 64 Mar 1 18:37 /dev/ttyS0
  732 \layout Section
  733 
  734 Compilation
  735 \layout Standard
  736 
  737 Since sendpage is mostly a collection of Perl modules, compilation is technicall
  738 y not required.
  739  After you've unpacked the tar file and have all your prerequisites completed,
  740  it's a simple matter of running:
  741 \layout Quotation
  742 
  743 
  744 \family typewriter 
  745 perl Makefile.PL
  746 \layout Quotation
  747 
  748 
  749 \family typewriter 
  750 make
  751 \layout Standard
  752 
  753 and you're done 
  754 \begin_inset Quotes eld
  755 \end_inset 
  756 
  757 compiling
  758 \begin_inset Quotes erd
  759 \end_inset 
  760 
  761 
  762 \layout Section
  763 
  764 Installation
  765 \layout Subsection
  766 
  767 Install the scripts and modules
  768 \layout Standard
  769 
  770 This part is easy.
  771  Just run:
  772 \layout Quotation
  773 
  774 
  775 \family typewriter 
  776 make install
  777 \layout Subsection
  778 
  779 Queue directory
  780 \layout Standard
  781 
  782 Sendpage needs to store pages and process information somewhere.
  783  By default, this is 
  784 \family typewriter 
  785 /var/spool/sendpage
  786 \family default 
  787 .
  788  If you want to create this directory somewhere else, you can change it
  789  using the 
  790 \family typewriter 
  791 queuedir
  792 \family default 
  793  and 
  794 \family typewriter 
  795 pidfileprefix
  796 \family default 
  797  options.
  798  Since the queue directory isn't there with a fresh install, you will need
  799  to create it, make it available to the 
  800 \family typewriter 
  801 sendpage
  802 \family default 
  803  user, and secure it from prying eyes:
  804 \layout Quotation
  805 
  806 
  807 \family typewriter 
  808 mkdir -p /var/spool/sendpage
  809 \layout Quotation
  810 
  811 
  812 \family typewriter 
  813 chown sendpage /var/spool/sendpage
  814 \layout Quotation
  815 
  816 
  817 \family typewriter 
  818 chmod og-rwx /var/spool/sendpage
  819 \layout Subsection
  820 
  821 Configuration files
  822 \layout Standard
  823 
  824 Now you will need to copy the configuration files for 
  825 \family typewriter 
  826 sendpage
  827 \family default 
  828 , 
  829 \family typewriter 
  830 snpp
  831 \family default 
  832 , and 
  833 \family typewriter 
  834 email2page
  835 \family default 
  836  into your 
  837 \family typewriter 
  838 /etc
  839 \family default 
  840  directory:
  841 \layout Quotation
  842 
  843 
  844 \family typewriter 
  845 cp sendpage.cf snpp.conf email2page.conf /etc
  846 \layout Standard
  847 
  848 You will be editing these files in the 
  849 \family typewriter 
  850 /etc
  851 \family default 
  852  directory to control how 
  853 \family typewriter 
  854 sendpage
  855 \family default 
  856 , 
  857 \family typewriter 
  858 snpp
  859 \family default 
  860 , and 
  861 \family typewriter 
  862 email2page
  863 \family default 
  864  behave.
  865 \layout Section
  866 
  867 Configuration
  868 \layout Standard
  869 
  870 Changing how sendpage behaves is a matter of making changes to the 
  871 \family typewriter 
  872 /etc/sendpage.cf
  873 \family default 
  874  file, and reloading the daemon.
  875  A complete list of all the options available is documented in the file
  876  itself.
  877  However, some of these are covered here for your initial configuration.
  878 \layout Subsection
  879 
  880 General debugging
  881 \layout Standard
  882 
  883 The general operations of the sendpage daemon and the functions of the SNPP
  884  server can be debugged by setting the 
  885 \family typewriter 
  886 debug
  887 \family default 
  888  option to 
  889 \begin_inset Quotes eld
  890 \end_inset 
  891 
  892 true
  893 \begin_inset Quotes erd
  894 \end_inset 
  895 
  896 .
  897  To debug Paging Centrals or Modems, their debugging is turned on separately
  898  in their respective sections.
  899 \layout Subsection
  900 
  901 How the 
  902 \family typewriter 
  903 page-daemon
  904 \family default 
  905  alias works
  906 \layout Standard
  907 
  908 When sendpage delivers (or fails to deliver) pages, it will generate email
  909  back to the sender (if there was a recorded sender), to the recipient (if
  910  there was an 
  911 \family typewriter 
  912 email-cc
  913 \family default 
  914  for the recipient), and possibly to the user set by the 
  915 \family typewriter 
  916 page-daemon
  917 \family default 
  918  option (in the case of errors).
  919 \layout Subsubsection
  920 
  921 As the 'from' address
  922 \layout Standard
  923 
  924 Since email needs to come from somewhere, the user specified in the 
  925 \family typewriter 
  926 page-daemon
  927 \family default 
  928  option (normally 
  929 \begin_inset Quotes eld
  930 \end_inset 
  931 
  932 sendpage
  933 \begin_inset Quotes erd
  934 \end_inset 
  935 
  936 ) will be used as the 
  937 \begin_inset Quotes eld
  938 \end_inset 
  939 
  940 From
  941 \begin_inset Quotes erd
  942 \end_inset 
  943 
  944  for all email generated.
  945  This can be changed globally, or it can be changed for each configured
  946  Paging Central.
  947 \layout Subsubsection
  948 
  949 For errors and warnings
  950 \layout Standard
  951 
  952 When a page fails to be delivered, the 
  953 \family typewriter 
  954 page-daemon
  955 \family default 
  956  user can also get a notification.
  957  In this way, system administrators can be notified of any failures.
  958  If this is not a desired action, it can be disabled by setting the 
  959 \family typewriter 
  960 cc-on-error
  961 \family default 
  962  option to 
  963 \begin_inset Quotes eld
  964 \end_inset 
  965 
  966 false
  967 \begin_inset Quotes erd
  968 \end_inset 
  969 
  970 .
  971  This can be configured globally, or on a per-PC basis.
  972  In the case of temporary failures, the 
  973 \family typewriter 
  974 tempfail-notify-after 
  975 \family default 
  976 option can be set to how many temporary failures you want to have happen
  977  before anyone is notified.
  978  This is 10 by default.
  979 \layout Subsection
  980 
  981 SNPP server settings
  982 \layout Standard
  983 
  984 SNPP stands for 
  985 \begin_inset Quotes eld
  986 \end_inset 
  987 
  988 Simple Network Paging Protocol
  989 \begin_inset Quotes erd
  990 \end_inset 
  991 
  992 .
  993  This is the protocol that is used to send pages to an SNPP server for delivery,
  994  similar to the Internet email protocol SMTP ('Simple Mail Transfer Protocol
  995 \begin_inset Quotes erd
  996 \end_inset 
  997 
  998 ).
  999  Sendpage has two SNPP parts: the server and the client.
 1000  The server portion is built in to the sendpage daemon, and can be configured
 1001  to listen on the network for clients who wish to send pages.
 1002  The client portion is the tool that users or other delivery processes (like
 1003  email delivery agents) will use to send pages through sendpage.
 1004  The client tool is known as 
 1005 \family typewriter 
 1006 snpp
 1007 \family default 
 1008  and is covered in the 
 1009 \begin_inset Quotes eld
 1010 \end_inset 
 1011 
 1012 How to send pages
 1013 \begin_inset Quotes erd
 1014 \end_inset 
 1015 
 1016  section.
 1017 \layout Standard
 1018 
 1019 The SNPP server presently has two configurable options: which address it
 1020  binds to, and what port it listens on.
 1021  The default port is 444, which is the standard SNPP port.
 1022  By default, sendpage will only listen on the 127.0.0.1 (localhost) address.
 1023  To change these settings change the following values:
 1024 \layout Subsubsection
 1025 
 1026 
 1027 \family typewriter 
 1028 snpp-port
 1029 \layout Standard
 1030 
 1031 This is normally 
 1032 \begin_inset Quotes eld
 1033 \end_inset 
 1034 
 1035 444
 1036 \begin_inset Quotes erd
 1037 \end_inset 
 1038 
 1039 , but can be changed to any available port on your local system.
 1040 \layout Subsubsection
 1041 
 1042 
 1043 \family typewriter 
 1044 snpp-addr
 1045 \layout Standard
 1046 
 1047 This is normally 
 1048 \begin_inset Quotes eld
 1049 \end_inset 
 1050 
 1051 localhost
 1052 \begin_inset Quotes erd
 1053 \end_inset 
 1054 
 1055 , but can be changed to any IP address available on your local system.
 1056  The special IP address 
 1057 \begin_inset Quotes eld
 1058 \end_inset 
 1059 
 1060 0.0.0.0
 1061 \begin_inset Quotes erd
 1062 \end_inset 
 1063 
 1064  means 
 1065 \begin_inset Quotes eld
 1066 \end_inset 
 1067 
 1068 all IP addresses
 1069 \begin_inset Quotes erd
 1070 \end_inset 
 1071 
 1072  on the local system.
 1073 \layout Section
 1074 
 1075 Running the 
 1076 \family typewriter 
 1077 sendpage
 1078 \family default 
 1079  daemon
 1080 \layout Standard
 1081 
 1082 Even though you need to configure your modem and Paging Centrals first,
 1083  this section covers how to start and stop the sendpage daemon.
 1084  A SysV-style init script named 
 1085 \family typewriter 
 1086 sendpage.init
 1087 \family default 
 1088  was included in the package, and can be used to perform these functions
 1089  for you, if you wish.
 1090  To control the daemon directly, here are the methods:
 1091 \layout Subsection
 1092 
 1093 Starting daemon
 1094 \layout Standard
 1095 
 1096 To start sendpage, run:
 1097 \layout Quotation
 1098 
 1099 
 1100 \family typewriter 
 1101 sendpage -bd
 1102 \layout Standard
 1103 
 1104 The silly mnemonic is 
 1105 \begin_inset Quotes eld
 1106 \end_inset 
 1107 
 1108 
 1109 \series bold 
 1110 b
 1111 \series default 
 1112 e a 
 1113 \series bold 
 1114 d
 1115 \series default 
 1116 aemon
 1117 \begin_inset Quotes erd
 1118 \end_inset 
 1119 
 1120 .
 1121 \layout Subsection
 1122 
 1123 Stopping daemon
 1124 \layout Standard
 1125 
 1126 To stop sendpage, either send the master process a 
 1127 \family typewriter 
 1128 QUIT
 1129 \family default 
 1130  signal, or run:
 1131 \layout Quotation
 1132 
 1133 
 1134 \family typewriter 
 1135 sendpage -bs
 1136 \layout Standard
 1137 
 1138 The silly mnemonic here is 
 1139 \begin_inset Quotes eld
 1140 \end_inset 
 1141 
 1142 
 1143 \series bold 
 1144 b
 1145 \series default 
 1146 e 
 1147 \series bold 
 1148 s
 1149 \series default 
 1150 topped
 1151 \begin_inset Quotes erd
 1152 \end_inset 
 1153 
 1154 .
 1155 \layout Subsection
 1156 
 1157 Reloading daemon
 1158 \layout Standard
 1159 
 1160 To reload sendpage, either send the master process a 
 1161 \family typewriter 
 1162 HUP
 1163 \family default 
 1164  signal, or run:
 1165 \layout Quotation
 1166 
 1167 
 1168 \family typewriter 
 1169 sendpage -br
 1170 \layout Standard
 1171 
 1172 Mnemonic is 
 1173 \begin_inset Quotes eld
 1174 \end_inset 
 1175 
 1176 
 1177 \series bold 
 1178 b
 1179 \series default 
 1180 e 
 1181 \series bold 
 1182 r
 1183 \series default 
 1184 eloaded
 1185 \begin_inset Quotes erd
 1186 \end_inset 
 1187 
 1188 .
 1189 \layout Subsection
 1190 
 1191 Checking status of daemon
 1192 \layout Standard
 1193 
 1194 To see if sendpage is already running (the 
 1195 \family typewriter 
 1196 -bd
 1197 \family default 
 1198  option does this too, if sendpage is already running):
 1199 \layout Quotation
 1200 
 1201 
 1202 \family typewriter 
 1203 sendpage -bq
 1204 \layout Standard
 1205 
 1206 Mnemonic is 
 1207 \begin_inset Quotes eld
 1208 \end_inset 
 1209 
 1210 
 1211 \series bold 
 1212 b
 1213 \series default 
 1214 e 
 1215 \series bold 
 1216 q
 1217 \series default 
 1218 uestioned
 1219 \begin_inset Quotes erd
 1220 \end_inset 
 1221 
 1222 .
 1223 \layout Subsection
 1224 
 1225 Checking status of queues
 1226 \layout Standard
 1227 
 1228 To see what is in the page queues, run:
 1229 \layout Quotation
 1230 
 1231 
 1232 \family typewriter 
 1233 sendpage -bp
 1234 \layout Standard
 1235 
 1236 Mnemonic is 
 1237 \begin_inset Quotes eld
 1238 \end_inset 
 1239 
 1240 
 1241 \series bold 
 1242 b
 1243 \series default 
 1244 e nice and 
 1245 \series bold 
 1246 p
 1247 \series default 
 1248 rint the contents of your queues
 1249 \begin_inset Quotes erd
 1250 \end_inset 
 1251 
 1252 .
 1253  (Okay, so I ran out of mnemonics; the options were based on 
 1254 \family typewriter 
 1255 sendmail
 1256 \family default 
 1257 's options anyway...)
 1258 \layout Section
 1259 
 1260 What are all these processes?
 1261 \layout Standard
 1262 
 1263 Sendpage runs a separate process for each Paging Central queue that it maintains.
 1264  The master process will spawn the PC children, and run the SNPP server.
 1265  New SNPP connections will be forked off as children as well.
 1266  Only the master process runs as 
 1267 \family typewriter 
 1268 root
 1269 \family default 
 1270 , and the children run as the 
 1271 \family typewriter 
 1272 sendpage
 1273 \family default 
 1274  user.
 1275  The PC children additionally run with the group IDs needed to lock and
 1276  open the serial port.
 1277 \layout Standard
 1278 
 1279 Each process will identify itself on the command line portion visible in
 1280  the process list.
 1281  For example:
 1282 \layout Quotation
 1283 
 1284 
 1285 \family typewriter 
 1286 # ps -f -p 20900 -u sendpage
 1287 \layout Quotation
 1288 
 1289 
 1290 \family typewriter 
 1291 UID\SpecialChar ~
 1292 \SpecialChar ~
 1293 \SpecialChar ~
 1294 \SpecialChar ~
 1295 \SpecialChar ~
 1296 \SpecialChar ~
 1297 PID\SpecialChar ~
 1298 \SpecialChar ~
 1299 \SpecialChar ~
 1300 PPID\SpecialChar ~
 1301 \SpecialChar ~
 1302 C\SpecialChar ~
 1303 STIME\SpecialChar ~
 1304 TTY\SpecialChar ~
 1305 TIME\SpecialChar ~
 1306 \SpecialChar ~
 1307 \SpecialChar ~
 1308 \SpecialChar ~
 1309 \SpecialChar ~
 1310 CMD
 1311 \layout Quotation
 1312 
 1313 
 1314 \family typewriter 
 1315 root\SpecialChar ~
 1316 \SpecialChar ~
 1317 \SpecialChar ~
 1318 \SpecialChar ~
 1319 \SpecialChar ~
 1320 20900\SpecialChar ~
 1321 1\SpecialChar ~
 1322 \SpecialChar ~
 1323 \SpecialChar ~
 1324 \SpecialChar ~
 1325 \SpecialChar ~
 1326 0\SpecialChar ~
 1327 Mar02\SpecialChar ~
 1328 \SpecialChar ~
 1329 ?\SpecialChar ~
 1330 \SpecialChar ~
 1331 00:00:00\SpecialChar ~
 1332 sendpage:\SpecialChar ~
 1333 accepting\SpecialChar ~
 1334 connections
 1335 \layout Quotation
 1336 
 1337 
 1338 \family typewriter 
 1339 sendpage\SpecialChar ~
 1340 20901\SpecialChar ~
 1341 20900\SpecialChar ~
 1342 0\SpecialChar ~
 1343 Mar02\SpecialChar ~
 1344 \SpecialChar ~
 1345 ?\SpecialChar ~
 1346 \SpecialChar ~
 1347 00:00:01\SpecialChar ~
 1348 sendpage:\SpecialChar ~
 1349 ameritech\SpecialChar ~
 1350 queue
 1351 \layout Quotation
 1352 
 1353 
 1354 \family typewriter 
 1355 sendpage\SpecialChar ~
 1356 20902\SpecialChar ~
 1357 20900\SpecialChar ~
 1358 0\SpecialChar ~
 1359 Mar02\SpecialChar ~
 1360 \SpecialChar ~
 1361 ?\SpecialChar ~
 1362 \SpecialChar ~
 1363 00:00:00\SpecialChar ~
 1364 sendpage:\SpecialChar ~
 1365 attpcs\SpecialChar ~
 1366 queue
 1367 \layout Quotation
 1368 
 1369 
 1370 \family typewriter 
 1371 sendpage\SpecialChar ~
 1372 20903\SpecialChar ~
 1373 20900\SpecialChar ~
 1374 0\SpecialChar ~
 1375 Mar02\SpecialChar ~
 1376 \SpecialChar ~
 1377 ?\SpecialChar ~
 1378 \SpecialChar ~
 1379 00:00:00\SpecialChar ~
 1380 sendpage:\SpecialChar ~
 1381 nextel\SpecialChar ~
 1382 queue
 1383 \layout Quotation
 1384 
 1385 
 1386 \family typewriter 
 1387 sendpage\SpecialChar ~
 1388 20904\SpecialChar ~
 1389 20900\SpecialChar ~
 1390 0\SpecialChar ~
 1391 Mar02\SpecialChar ~
 1392 \SpecialChar ~
 1393 ?\SpecialChar ~
 1394 \SpecialChar ~
 1395 00:00:00\SpecialChar ~
 1396 sendpage:\SpecialChar ~
 1397 pagenet\SpecialChar ~
 1398 queue
 1399 \layout Quotation
 1400 
 1401 
 1402 \family typewriter 
 1403 sendpage\SpecialChar ~
 1404 20905\SpecialChar ~
 1405 20900\SpecialChar ~
 1406 0\SpecialChar ~
 1407 Mar02\SpecialChar ~
 1408 \SpecialChar ~
 1409 ?\SpecialChar ~
 1410 \SpecialChar ~
 1411 00:00:00\SpecialChar ~
 1412 sendpage:\SpecialChar ~
 1413 rim-pager\SpecialChar ~
 1414 queue
 1415 \layout Quotation
 1416 
 1417 
 1418 \family typewriter 
 1419 sendpage\SpecialChar ~
 1420 20906\SpecialChar ~
 1421 20900\SpecialChar ~
 1422 0\SpecialChar ~
 1423 Mar02\SpecialChar ~
 1424 \SpecialChar ~
 1425 ?\SpecialChar ~
 1426 \SpecialChar ~
 1427 00:00:00\SpecialChar ~
 1428 sendpage:\SpecialChar ~
 1429 skytel\SpecialChar ~
 1430 queue
 1431 \layout Quotation
 1432 
 1433 
 1434 \family typewriter 
 1435 sendpage\SpecialChar ~
 1436 29833\SpecialChar ~
 1437 20900\SpecialChar ~
 1438 0\SpecialChar ~
 1439 13:53\SpecialChar ~
 1440 \SpecialChar ~
 1441 ?\SpecialChar ~
 1442 \SpecialChar ~
 1443 00:00:00\SpecialChar ~
 1444 sendpage:\SpecialChar ~
 1445 SNPP\SpecialChar ~
 1446 client:\SpecialChar ~
 1447 127.0.0.1
 1448 \layout Standard
 1449 
 1450 You'll see that process 20900 is the master and is taking SNPP connections.
 1451  Each of the PCs is identified by the name of the queue, and each attached
 1452  SNPP client shows the IP address of the peer.
 1453 \layout Chapter
 1454 
 1455 How to add a modem
 1456 \layout Section
 1457 
 1458 How are modems used?
 1459 \layout Standard
 1460 
 1461 Since TAP (
 1462 \begin_inset Quotes eld
 1463 \end_inset 
 1464 
 1465 Telocator Alphanumeric Protocol
 1466 \begin_inset Quotes erd
 1467 \end_inset 
 1468 
 1469 ) is an ASCII-based communication system, a modem is used to send pages.
 1470  When using sendpage, you can specify any number of modems.
 1471  They will all be initialized during daemon start-up to verify that they
 1472  are functioning.
 1473  After that, each Paging Central queue will be able to use any of the defined
 1474  modems.
 1475  Sendpage uses UUCP-style file locking so that your modem devices can continue
 1476  to be shared with other processes.
 1477 \layout Standard
 1478 
 1479 Once a PC queue locks a modem, it will dial out and attempt to reach the
 1480  remote Paging Central to deliver any pages in the queue.
 1481  Once all the pages have been sent (or some predefined delivery limit is
 1482  reached), the PC will hang up, unlock the modem, and continue waiting for
 1483  more pages.
 1484 \layout Section
 1485 
 1486 Configurable options
 1487 \layout Standard
 1488 
 1489 To define a new modem, you must start a new 
 1490 \begin_inset Quotes eld
 1491 \end_inset 
 1492 
 1493 section
 1494 \begin_inset Quotes erd
 1495 \end_inset 
 1496 
 1497  in your 
 1498 \family typewriter 
 1499 /etc/sendpage.cf
 1500 \family default 
 1501  file.
 1502  A modem section is written as:
 1503 \layout Quotation
 1504 
 1505 
 1506 \family typewriter 
 1507 [modem:NAME]
 1508 \layout Standard
 1509 
 1510 where 
 1511 \family typewriter 
 1512 NAME
 1513 \family default 
 1514  is what you want to identify your modem as.
 1515  The only required option in this section is the 
 1516 \family typewriter 
 1517 dev
 1518 \family default 
 1519  option, which specifies which serial port this modem is attached to.
 1520 \layout Subsection
 1521 
 1522 Debugging
 1523 \layout Standard
 1524 
 1525 Within the modem section, setting the debug option to 
 1526 \begin_inset Quotes eld
 1527 \end_inset 
 1528 
 1529 true
 1530 \begin_inset Quotes erd
 1531 \end_inset 
 1532 
 1533  will enable a character by character debugging dump of what is going in
 1534  and out of the modem.
 1535  All expected values will be reported, and all settings used to configure
 1536  the modem will be shown.
 1537 \layout Subsection
 1538 
 1539 Modem defaults
 1540 \layout Standard
 1541 
 1542 Each modem has a set of communication parameters.
 1543  By default, these settings are 9600 baud, 7 data bits, even parity, and
 1544  1 stop bit.
 1545  This is the default used by most TAP Paging Centrals.
 1546 \layout Standard
 1547 
 1548 For initialization, dialing, connect, and error strings, please see the
 1549  
 1550 \family typewriter 
 1551 /etc/sendpage.cf
 1552 \family default 
 1553  file for a full run down on each of these parameters.
 1554 \layout Subsection
 1555 
 1556 Dialing out, area codes, and long distance
 1557 \layout Standard
 1558 
 1559 Since each modem is attached to some phone line somewhere, it is possible
 1560  for sendpage to automatically determine when dialing a Paging Central if
 1561  it is considered 
 1562 \begin_inset Quotes eld
 1563 \end_inset 
 1564 
 1565 long distance
 1566 \begin_inset Quotes erd
 1567 \end_inset 
 1568 
 1569 .
 1570  To allow for this, you can specify the 
 1571 \family typewriter 
 1572 areacode
 1573 \family default 
 1574  option for a modem, along with the 
 1575 \family typewriter 
 1576 longdist
 1577 \family default 
 1578  option to define the prefix to dial for long distance dialing.
 1579  In addition to these options, there is also the 
 1580 \family typewriter 
 1581 dialout
 1582 \family default 
 1583  option used in situations where there is a constant prefix to get an outside
 1584  dial-tone (in the case of an office phone switch, PBX, or similar).
 1585 \layout Standard
 1586 
 1587 For example, imagine you had a single modem configured in an office building
 1588  in the United States with a PBX and the only way to get an outside line
 1589  was to dial 
 1590 \begin_inset Quotes eld
 1591 \end_inset 
 1592 
 1593 9
 1594 \begin_inset Quotes erd
 1595 \end_inset 
 1596 
 1597  first.
 1598  Say this PBX was in the 312 area code, and you had at least one PC configured
 1599  in the 630 area code.
 1600  To dial the 630 PC, your modem would additionally need to dial 
 1601 \begin_inset Quotes eld
 1602 \end_inset 
 1603 
 1604 1
 1605 \begin_inset Quotes erd
 1606 \end_inset 
 1607 
 1608  for long distance before dialing the PC.
 1609  The configuration for this modem would look something like:
 1610 \layout Quotation
 1611 
 1612 
 1613 \family typewriter 
 1614 [modem:hayes]
 1615 \layout Quotation
 1616 
 1617 
 1618 \family typewriter 
 1619 dev = /dev/ttyS0
 1620 \layout Quotation
 1621 
 1622 
 1623 \family typewriter 
 1624 dialout = 9,
 1625 \layout Quotation
 1626 
 1627 
 1628 \family typewriter 
 1629 areacode = 312
 1630 \layout Quotation
 1631 
 1632 
 1633 \family typewriter 
 1634 longdist = 1
 1635 \layout Standard
 1636 
 1637 When dialing a PC whose areacode was 
 1638 \begin_inset Quotes eld
 1639 \end_inset 
 1640 
 1641 312
 1642 \begin_inset Quotes erd
 1643 \end_inset 
 1644 
 1645  and phone number was 
 1646 \begin_inset Quotes eld
 1647 \end_inset 
 1648 
 1649 555-1234
 1650 \begin_inset Quotes erd
 1651 \end_inset 
 1652 
 1653 , sendpage would compare the area codes, realize the call was local, and
 1654  dial 
 1655 \family typewriter 
 1656 dialout
 1657 \family default 
 1658  + PC phone number: 
 1659 \begin_inset Quotes eld
 1660 \end_inset 
 1661 
 1662 9,555-1234
 1663 \begin_inset Quotes erd
 1664 \end_inset 
 1665 
 1666 .
 1667 \layout Standard
 1668 
 1669 When dialing a PC whose areacode was 
 1670 \begin_inset Quotes eld
 1671 \end_inset 
 1672 
 1673 630
 1674 \begin_inset Quotes erd
 1675 \end_inset 
 1676 
 1677  and phone number was 
 1678 \begin_inset Quotes eld
 1679 \end_inset 
 1680 
 1681 555-6789
 1682 \begin_inset Quotes erd
 1683 \end_inset 
 1684 
 1685 , sendpage would compare the area codes, realize the call was long distance,
 1686  and dial 
 1687 \family typewriter 
 1688 dialout
 1689 \family default 
 1690  + 
 1691 \family typewriter 
 1692 longdist
 1693 \family default 
 1694  + PC area code + PC phone number: 
 1695 \begin_inset Quotes eld
 1696 \end_inset 
 1697 
 1698 9,1630555-6789
 1699 \begin_inset Quotes erd
 1700 \end_inset 
 1701 
 1702 .
 1703 \layout Standard
 1704 
 1705 Technically, you would not have to specify 
 1706 \begin_inset Quotes eld
 1707 \end_inset 
 1708 
 1709 
 1710 \family typewriter 
 1711 longdist = 1
 1712 \family default 
 1713 
 1714 \begin_inset Quotes erd
 1715 \end_inset 
 1716 
 1717  since that is the default.
 1718  Since a modem's area code is unset by default, the 
 1719 \family typewriter 
 1720 longdist
 1721 \family default 
 1722  default would have no effect.
 1723 \layout Section
 1724 
 1725 The 
 1726 \family typewriter 
 1727 modemtest
 1728 \family default 
 1729  tool
 1730 \layout Standard
 1731 
 1732 Since modems (and serial ports) can be a real pain to get running correctly,
 1733  there is a tool included in the sendpage package 
 1734 \begin_inset Quotes eld
 1735 \end_inset 
 1736 
 1737 examples
 1738 \begin_inset Quotes erd
 1739 \end_inset 
 1740 
 1741  directory called 
 1742 \family typewriter 
 1743 modemtest
 1744 \family default 
 1745 .
 1746  This is a quick-and-dirty Perl script that will attempt to operate on a
 1747  given serial port and talk to the modem in a way similar to how sendpage
 1748  would attempt communication.
 1749 \layout Standard
 1750 
 1751 The idea is, if 
 1752 \family typewriter 
 1753 modemtest
 1754 \family default 
 1755  can talk to your modem, then sendpage should be able to as well.
 1756  This tool was provided to help troubleshoot any problems with a serial
 1757  port, the 
 1758 \family typewriter 
 1759 Device::SerialPort
 1760 \family default 
 1761  module, or the modem itself.
 1762 \layout Chapter
 1763 
 1764 How to add a Paging Central
 1765 \layout Section
 1766 
 1767 What is a Paging Central?
 1768 \layout Section
 1769 
 1770 Configurable options
 1771 \layout Subsection
 1772 
 1773 Debugging
 1774 \layout Subsection
 1775 
 1776 Communication settings (and modem fall-back)
 1777 \layout Subsection
 1778 
 1779 Character control settings
 1780 \layout Subsection
 1781 
 1782 Queue run settings
 1783 \layout Chapter
 1784 
 1785 How to add a Recipient
 1786 \layout Section
 1787 
 1788 What is a recipient?
 1789 \layout Subsection
 1790 
 1791 PIN@PC style
 1792 \layout Subsection
 1793 
 1794 Alias style
 1795 \layout Section
 1796 
 1797 Configurable options
 1798 \layout Subsection
 1799 
 1800 Debugging
 1801 \layout Subsection
 1802 
 1803 
 1804 \family typewriter 
 1805 email-cc
 1806 \layout Subsection
 1807 
 1808 
 1809 \family typewriter 
 1810 dest
 1811 \layout Section
 1812 
 1813 How to test aliases
 1814 \layout Chapter
 1815 
 1816 How to send pages
 1817 \layout Section
 1818 
 1819 From the command line
 1820 \layout Subsection
 1821 
 1822 Local use of 
 1823 \family typewriter 
 1824 snpp
 1825 \layout Subsection
 1826 
 1827 Remote use of 
 1828 \family typewriter 
 1829 snpp
 1830 \layout Subsubsection
 1831 
 1832 Making changes to 
 1833 \family typewriter 
 1834 /etc/snpp.conf
 1835 \layout Subsection
 1836 
 1837 Third-party SNPP clients
 1838 \layout Section
 1839 
 1840 From an email gateway
 1841 \layout Subsection
 1842 
 1843 How 
 1844 \family typewriter 
 1845 email2page
 1846 \family default 
 1847  works
 1848 \layout Subsubsection
 1849 
 1850 Header rules
 1851 \layout Subsubsection
 1852 
 1853 Body rules
 1854 \layout Subsubsection
 1855 
 1856 Prefix, suffix, and joining strings
 1857 \layout Subsection
 1858 
 1859 How 
 1860 \family typewriter 
 1861 sendmail2snpp
 1862 \family default 
 1863  works
 1864 \layout Subsection
 1865 
 1866 Example of how to configure with 
 1867 \family typewriter 
 1868 sendmail
 1869 \layout Subsection
 1870 
 1871 Example of how to configure with 
 1872 \family typewriter 
 1873 postfix
 1874 \layout Section
 1875 
 1876 From a web page
 1877 \layout Chapter
 1878 
 1879 Paging Central configuration tuning guidelines
 1880 \layout Section
 1881 
 1882 TAP quirks
 1883 \layout Subsection
 1884 
 1885 TAP specification
 1886 \layout Subsection
 1887 
 1888 Control characters in a page
 1889 \layout Subsection
 1890 
 1891 Response codes from the Paging Central
 1892 \layout Subsection
 1893 
 1894 Block sizes
 1895 \layout Subsection
 1896 
 1897 Page limits
 1898 \layout Subsection
 1899 
 1900 Block limits
 1901 \layout Section
 1902 
 1903 How to figure out which of 
 1904 \family typewriter 
 1905 esc
 1906 \family default 
 1907 ,
 1908 \family typewriter 
 1909  ctrl
 1910 \family default 
 1911 , or 
 1912 \family typewriter 
 1913 lfok
 1914 \family default 
 1915  to use for a PC
 1916 \layout Section
 1917 
 1918 How to figure out 
 1919 \family typewriter 
 1920 maxchars
 1921 \family default 
 1922  for a PC
 1923 \layout Subsection
 1924 
 1925 Errors vs timeouts during transmission
 1926 \layout Subsection
 1927 
 1928 Example method
 1929 \layout Subsubsection
 1930 
 1931 Try 10 characters
 1932 \layout Subsubsection
 1933 
 1934 Try half block limit
 1935 \layout Subsubsection
 1936 
 1937 Try half block limit + 1
 1938 \layout Subsubsection
 1939 
 1940 Try block limit
 1941 \layout Subsubsection
 1942 
 1943 Try block limit + 1
 1944 \layout Chapter
 1945 
 1946 Trouble shooting
 1947 \layout Section
 1948 
 1949 Does the modem work?
 1950 \layout Section
 1951 
 1952 Does the Paging Central work?
 1953 \layout Chapter
 1954 
 1955 Configuration Options
 1956 \layout Section
 1957 
 1958 sendpage.cf
 1959 \layout Subsection
 1960 
 1961 Global
 1962 \layout Subsection
 1963 
 1964 Modem
 1965 \layout Subsection
 1966 
 1967 Paging Central
 1968 \layout Subsection
 1969 
 1970 Recipient
 1971 \layout Section
 1972 
 1973 snpp.conf
 1974 \layout Section
 1975 
 1976 email2page.conf
 1977 \the_end