palmail.txt

涉及Fax/Mail/Voice通讯编程的一个程序

PalMail(1)                                             PalMail(1)


NNAAMMEE
       PalMail - a frontend for Voice/FAX messages.

SSYYNNOOPPSSIISS
       PPaallMMaaiill

DDEESSCCRRIIPPTTIIOONN
       PPaallMMaaiill  is  an  user  interface to view, print and delete
       Voice and FAX messages.  Most commands  are  designed  for
       intuitive  use and hopefully don't nead a verbose descrip-
       tion.

       PPaallMMaaiill consists of several modes. They are  displayed  in
       the menubar at the top of the window. The currently active
       mode is emphasized. You can select  another  mode  with  a
       mouseclick  or  by  pressing the _A_l_t key together with the
       first letter of the mode. If there are two modes  starting
       with the same first letter, you have to press _A_l_t_-_S_h_i_f_t to
       activate the second mode.  E.g.  VVooccIINN is invoked by  _A_l_t_-
       _V_, VVooccOOUUTT is invoked by _A_l_t_-_S_h_i_f_t_-_V_.  You may also use the
       _l_e_f_t_- or _r_i_g_h_t_-_a_r_r_o_w keys to circulate the modes.
       Each mode has an individual menubar at the bottom  of  the
       window.   You can activate those buttons with a mouseclick
       or with the capitalized letter ( without _A_l_t ). The UUppddaattee
       button will always reread the directory or file.
       The listbox entries may be selected with the mouse or with
       the keys _U_p_, _D_o_w_n_, _S_p_a_c_e and _S_h_i_f_t_-_S_p_a_c_e_.
       The behaviour of the listbox is different for TTkk  Versions
       3.6 and 4.0, so you may try it yourself.  A doubleclick on
       an entry also activates the first command button.
       The checkbutton 'Multipage'  controls  whether  multipaged
       faxes  are displayed as one entry or as separate pages. It
       can be toggled with the mouse or with _A_l_t_-_M_.
       There is another box for displaying the  process  informa-
       tion. This text can be scrolled with the mouse or with the
       keys _S_h_i_f_t_-_U_p and _S_h_i_f_t_-_D_o_w_n_.
       PPaallMMaaiill is terminated with the EExxiitt button or by  pressing
       _E_s_c_.

       RRiinngg  displays basic information about all connections and
       phone rings.

              Normally the L_AUDIT lines (containing "#####")  of
              the  mmggeettttyy  logfile are scanned to find the neces-
              sary information.  At least loglevel 2 is required.
              The  results  are stored in _/_v_a_r_/_l_o_g_/_r_i_n_g_l_o_g_.  This
              scanning may take a while, depending on the size of
              the  logfile.   For this reason you may use ccrroonn to
              shorten the logfile periodically. The provided file
              ttaaiill__lloogg  may  be  used  as  an  example file to be
              invoked by cron.  If the ringlog file is newer than
              the  mgetty logfile, no scanning is done.  Alterna-
              tively you can patch mmggeettttyy//vvggeettttyy  to  create  the
              ringlog file itself. Ask Sven Palme for details.



                           PalMail 0.93                         1





PalMail(1)                                             PalMail(1)


              To  disable  this  mode  totally,  delete  the file
              _/_v_a_r_/_l_o_g_/_r_i_n_g_l_o_g which was created during installa-
              tion.
              You  may  RReennaammee  or DDeelleettee selected entries of the
              ringlog file or CClleeaarr the whole file.
              The command PPiicckk UUpp is useful if you  pick  up  the
              phone  manually  and  recognize a fax or a modem on
              the other end of the line.  Then you can press PPiicckk
              UUpp and your modem should take over. This would only
              work, if you invoke PPaallMMaaiill as root, since  it  has
              to  send vvggeettttyy a _k_i_l_l _-_S_I_G_U_S_R_1_.  For this reason a
              simple C-program is provided which can be run SUID.
              It  does some security checking, so I think/hope it
              is save to use it.  If you still  consider  this  a
              security hole, change the variable _A_T_A___M_O_D_E to 0750
              in the Makefile before installation.

       VVooccIINN handles incoming voice messages.

              In this mode all voice calls are displayed  in  the
              listbox.    If   the   spool   directory   (usually
              _/_v_a_r_/_s_p_o_o_l_/_v_o_i_c_e_/_i_n_c_o_m_i_n_g ) is not found, this mode
              is  not available.  PPaallMMaaiill checks the spool direc-
              tory and displays the filedate of each call.  If  a
              file  has  been renamed, the file name is also dis-
              played.  Files are sorted in the order of incoming.
              You may select one or more items in the listbox and
              press the appropriate button  to  PPllaayy,,  RReennaammee  or
              DDeelleettee  the  selected  files.  The SSttoopp button will
              stop playing a message by _k_i_l_l_a_l_l _z_p_l_a_y_.   If  more
              than one file were selected, the next selected file
              will be played.

       VVooccOOUUTT handles (outgoing) greeting messages.

              In this mode all  recorded  greeting  messages  are
              displayed  in  the listbox.  If the spool directory
              (usually _/_v_a_r_/_s_p_o_o_l_/_v_o_i_c_e_/_m_e_s_s_a_g_e_s ) is not  found,
              this mode is not available.  The system files _I_n_d_e_x
              and _b_e_e_p are not displayed. The  files  are  sorted
              alphabetically.
              You  may  PPllaayy,,  RReeccoorrdd,, AAccttiivvaattee,, rreeNNaammee or DDeelleettee
              messages. If you rreeNNaammee a file, spaces in the file-
              name  are converted to underscores.  SSttoopp will stop
              playing as well as recording.
              The file _I_n_d_e_x is internally used to  activate  one
              or  more  greeting  messages.   Errors in this file
              (e.g.  non-existing  filenames)  are  automatically
              corrected.  At  least  one  message should be acti-
              vated.  vvggeettttyy will pick a random  message  out  of
              the  activated  ones  when  it  answers  the phone.
              Activated messages are marked with a _* at the  left
              of  the filename.  The AAccttiivvaattee command toggles the
              active-status of the selected files.



                           PalMail 0.93                         2





PalMail(1)                                             PalMail(1)


              Recording will last until you press SSttoopp,,  PPllaayy  or
              again  RReeccoorrdd..  It will also stop, if you exit PPaall--
              MMaaiill..

       FFaaxxIINN handles incoming faxes.

              In this mode all incoming faxes  are  displayed  in
              the  listbox.   If  the  spool  directory  (usually
              _/_v_a_r_/_s_p_o_o_l_/_f_a_x_/_i_n_c_o_m_i_n_g ) is not found,  this  mode
              is  not available.  PPaallMMaaiill checks the spool direc-
              tory and displays the filedate and the phone number
              of the sender of each fax.  Files are sorted in the
              order of incoming.  PPaallMMaaiill manages a  database  of
              phone  numbers  and the full names of their owners.
              When somebody sends you a fax the first  time,  the
              fax  number  is  shown in the listbox. You may then
              select this fax and press AAdddd DDBB to assign  a  name
              to  the  fax  number.  It  will  be stored into the
              database. Then the full name of the sender will  be
              displayed  instead  of  the phone number whenever a
              fax from this sender is detected. To change a  name
              just select a fax from this sender and press AAdddd DDBB
              again. To remove a name do the same  and  enter  an
              empty  string  (delete  all  characters  of the old
              name). The phone number will be displayed again.
              You may also select one or more items in the  list-
              box and press the appropriate button to VViieeww,, PPrriinntt
              or DDeelleettee the selected files. The resolution of the
              faxes  is  automatically  detected  and the correct
              commands are invoked.

       FFaaxxOOUUTT handles spooled (outgoing) faxes.

              In this mode all spooled faxes are displayed in the
              listbox.    If   the   spool   directory   (usually
              _/_v_a_r_/_s_p_o_o_l_/_f_a_x_/_o_u_t_g_o_i_n_g ) is not found,  this  mode
              is  not available.  PPaallMMaaiill checks the spool direc-
              tory and displays the filedate of the JOB-file, the
              sender,  the  destination  and  the filename of the
              source of each fax. Files are sorted in  the  order
              of  incoming.   The  leftmost  letter  of each line
              indicates the status of the job:
              qq:: indicates a queued fax, which will  be  sent  at
              the next ffaaxxrruunnqq run.
              dd:: indicates an already sent fax.
              ss:: indicates a suspended fax.
              LL::  indicates  a locked fax. This will be the case,
              if ffaaxxrruunnqq just sent the fax  at  the  moment,  the
              directory was scanned.
              ??:: The JOB-file wasn't recognized.
              You may select one or more items in the listbox and
              press the appropriate button to VViieeww or  PPrriinntt  the
              selected  files.  The  resolution  of  the faxes is
              automatically detected and the correct commands are



                           PalMail 0.93                         3