home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / wCNews_1.0.30.lha / contrib / newsgate.man < prev    next >
Encoding:
Text File  |  1992-12-04  |  10.0 KB  |  301 lines
  1.  
  2.  
  3.  newsgate(1)                   Amiga News & Mail                    mailgate(1)
  4.  
  5.  
  6.    0 Preface       
  7.  
  8.    newsgate  and  mailgate  are  two  programms designed for use with `Amiga
  9.    UUCP  Plus  1.02'  or  it's  successors  (`wCNews';  both are abbreviated
  10.    herein  as  `AUUCP'). It should work with the CNews-Port done by Frank J.
  11.    Edwards  (aka  `CNews',  on which `Amiga UUCP Plus 1.02' and `wCNews' are
  12.    based)  and  maybe  even  with  Amiga  UUCP (by Matthew Dillon, hence the
  13.    abbreviation `DUUCP').  
  14.  
  15.  
  16.    1 Software Requirements      
  17.  
  18.    You'll  need  a  programm  called  `relaynews'  that  takes an article on
  19.    stdin,  which  injects  the  article  into  the  news  system.  Refer  to
  20.    `relaynews.man'  for  further  information - `relaynews' is the workhorse
  21.    in  CNews/AUUCP, for DUUCP you may want to write a frontend to `postnews'
  22.    with  this  name  ...   Since  Version  1.111 you may specify a different
  23.    program, compare `Usage'.  
  24.  
  25.         Furthermore, you'll  need  `sendmail'.  As  far  as  I can tell, the
  26.    plain  `sendmail'  from  DUUCP  should  do  (I'm  using  a  different one
  27.    myself).  
  28.  
  29.  
  30.    1.1 Configuration       
  31.  
  32.    Due  to  my  rfctime()-function,  you should set up two environment vars:
  33.    ENV:TZNAME  and ENV:TZOFFS. Sometimes in future, this job will be handled
  34.    by  `timed'  (not  written yet, hopefully before next switch to DST), but
  35.    for now, please add something like this to your `s:Startup-Sequence': 
  36.  
  37.                        setenv TZNAME MET 
  38.                        setenv TZOFFS +0100 
  39.  
  40.         TZNAME is   the  name  of  your  timezone,  "MET"  for  Germany  (or
  41.    "MES"/"MET  DST",  if  daylight savings time is in effect), TZOFFS is the
  42.    offset  in  ▒HHMM  from  GMT  to local time. TZOFFS *HAS* to be exactly 5
  43.    chars  long!  If  none  of  these  environment  variables  have been set,
  44.    rfctime() reverts to the timezone you specified in uulib:Config.  
  45.  
  46.                           Technical information      
  47.  
  48.       The  TIMEZONE stuff is handled by _tzset() of SAS-C. At least here,
  49.       the  trouble  starts  for  poeple  who  prefer Aztec (like me) when
  50.       trying  to  compile  ...   If GetEnv("TZOFFS") and GetEnv("TZNAME")
  51.       (GetEnv()  is  my  2.0.version of getenv() - it gives you the value
  52.       from  the  local  or  global  environment)  fail,  I take tzname[0]
  53.       (computed  by  _tzset()),  in the hope it's correct ...  _TZ is set
  54.       to the value gotten from FindConfig("TIMEZONE").  
  55.  
  56.  
  57.         Since `newsgate'  parses and rewrites the `Date:' header in order to
  58.  
  59.  
  60.  Release 06 Nov 1992     Last Change:  4 Dec 1992  3:28                  Page 1
  61.  
  62.  
  63.  newsgate(1)                   Amiga News & Mail                    mailgate(1)
  64.  
  65.  
  66.    make   it   RFC  1036  conformant  (several  news  systems  are  somewhat
  67.    nitpicking  on  timezones),  it  is  of  importance  that you set the TZ*
  68.    environment  variables  correctly.  Otherwise  you  will  get  wrong  GMT
  69.    offsets in `Date:' ...  
  70.  
  71.  
  72.         There are  some  new keywords you may add to your uucp configuration
  73.    file: 
  74.  
  75.       NewsgatePath    No
  76.       DomainPath      yes
  77.  
  78.     o `NewsgatePath'  controls  wheter  the  `Path:' header should be `Path:
  79.       news'  (`no')  or `Path: bang!path!the!mail!came' (`yes'). This can be
  80.       overridden by a commandline switch.  
  81.  
  82.     o `DomainPath'    specifies    wheter    or   not   newsname()   returns
  83.       (concatenated)  NodeName and DomainName or only the value of NodeName.
  84.       newsname()  is  used  by  newsgate  to  build  the path: sprintf(path,
  85.       "Path: %s!%s", newsname(), remainder); 
  86.  
  87.  
  88.    2 Usage       
  89.  
  90.  
  91.    Pipe incoming mail into `newsgate', e. g. via aliases: 
  92.  
  93.    uulib:Aliases 
  94.    ---------------------------------------8<---------------------------------------
  95.    news.test: "|newsgate news.test -path -relayflags -r"
  96.    --------------------------------------->8---------------------------------------
  97.  
  98.    Every  mail sent to the alias `news.group' at your node will be posted in
  99.    the newsgroup `news.test' ...  
  100.  
  101.    Usage: newsgate  <data  [news.group|-pure]  [▒path]  [▒pbhack] [-replace]
  102.                    [-distribution  dist]  [-approved  address]  [-relayflags
  103.                    flags] [-newspath path] [-relayprg prg] 
  104.  
  105.     o `-pure'  feeds  the  article into `relaynews' without any modification
  106.       (except   `news.groups',   with  will  replace  (in  conjunction  with
  107.       `-replace')/be  appended  to the article's `Newsgroups:' header). Note
  108.       that this implies ALL needed headers are already present.  
  109.  
  110.     o `▒path'áoverrides the `NewsgatePath' entry in the uucp config file.  
  111.  
  112.     o `▒pbhack'  controls  whether  a  `X-Mail-ID:'  header gets transformed
  113.       into  `Message-ID:';  defaults  to `off' (== `-pbhack'). This is for a
  114.       special  mailing  list I gate here at hactar, I assume it's not needed
  115.       anywhere else in the known universe =:-> 
  116.  
  117.     o `-newspath  pbinfo!amiga'  sets  the  `Path:'  to `pbinfo!amiga'. This
  118.  
  119.  
  120.  Page 2                  Last Change:  4 Dec 1992  3:28     Release 06 Nov 1992
  121.  
  122.  
  123.  newsgate(1)                   Amiga News & Mail                    mailgate(1)
  124.  
  125.  
  126.       overrides  everything,  regardless  of  your  setting  of  `▒path'  or
  127.       `-pure'  -  the  `Path:'  header  will  *always*  have  the  value you
  128.       specified after `-newspath'.  
  129.  
  130.     o `-distribution  x'  and  `-approved  x'  add  or  replace  (if already
  131.       present in the mail) the respective header.  
  132.  
  133.     o `-relayflags  flags'  replaces  the  default  of "-r -s" with `flags'.
  134.       Note  that  you  -  as always - have to quote the flags argument if it
  135.       contains white space.  
  136.  
  137.     o `-relayprg  prg'  replaces the default of "relaynews" with `prg'. Note
  138.       that `prg' is expected to accept the article on its stdin.  
  139.  
  140.     o `-no-x-to'  suppresses  the  creation of `X-To:', `X-Cc:' and `X-Bcc:'
  141.       headers.  
  142.  
  143.  
  144.    Run  `mailgate' for every article posted to a news group, for example via
  145.    CNews' sys-file: 
  146.  
  147.    uulib:news/sys 
  148.    --------------------------------------->8---------------------------------------
  149.    # Other gated things ...
  150.    #
  151.    amiga-lisp/contessa:amiga.lisp/all,!amiga,!local::run mailgate <%s -t "amigalisp@Pa.dec.com" -f news
  152.    amiga-slip/ccs.carleton.ca:amiga.slip/all,!amiga,!local::run mailgate <%s -t "amiga-slip@ccs.carleton.ca" -f news
  153.    amiga-dice/castrov.cuc.ab.ca:amiga.c.dice/all,!amiga,!local::run mailgate <%s -t "dice@castrov.cuc.ab.ca" -f news
  154.    amiga-linux/joker.cs.hut.fi:amiga.linux/all,!amiga,!local::run mailgate <%s -t "linux-activists0ksula.hut.fi" -f news -h "X-Mn-Key: 680X0"
  155.    test-mlist/castrov.cuc.ab.ca:test.mlist/all,!amiga,!local::run mailgate <%s -t "test.mlist@castrov.cuc.ab.ca" -f news
  156.    hactar-in/fub:hactar.in/all,!local::run mailgate <%s -t "in@fub.uucp" -f news
  157.    ---------------------------------------8<---------------------------------------
  158.  
  159.    Usage: mailgate  <article -t receipient [-f from] [-XMailID] [-h "header:
  160.                    value"] 
  161.  
  162.     o `-t  receipient'  specifies  the  receipient  to received the article.
  163.       YOU    MAY   ONLY   USE   ENVELOPE-STYLE   ADDRESSES   HERE   (i.   e.
  164.       `wusel@hactar.hanse.de',   NOT   `wusel@hactar.hanse.de  (Kai  'wusel'
  165.       Siering)')! 
  166.  
  167.     o `-f  from'  specifies the account to be put in the From_ line. Default
  168.       is  `news'.  USE  LOCAL  ADDRESSES  ONLY  (i.  e.  NO  `news@uunet' or
  169.       something like that)! 
  170.  
  171.     o `-XMailID'  enables  the  PB-hack,  duplicating  the  `Message-Id:' in
  172.       `X-Mail-ID:'.  
  173.  
  174.     o `-h  "Comment:  none  =:->"'  would  add  a header line `Comment: none
  175.       =:->'  to  the mailheader. I need this for the linux-activists mailing
  176.       list,  channel  `680X0': `-h "X-Mn-Key: 680X0"'. Don't know if anybody
  177.       else would need this =:-> 
  178.  
  179.  
  180.  Release 06 Nov 1992     Last Change:  4 Dec 1992  3:28                  Page 3
  181.  
  182.  
  183.  newsgate(1)                   Amiga News & Mail                    mailgate(1)
  184.  
  185.  
  186.  
  187.  
  188.    3 Problems/Bugreports/Suggestions       
  189.  
  190.    In  case  of  problems  or  if  you  find  a  bug,  feel free to write to
  191.    <bugs@hactar.hanse.de>.  Same  address applies for suggestions for future
  192.    (final?) releases =:-> 
  193.  
  194.    Have fun! 
  195.  
  196.                                     Snail:
  197.                            -------------------------
  198.                               Kai 'wusel' Siering
  199.                                Heidlohstrasze 3a
  200.                                D-2000 Hamburg 61
  201.                                  West Germany
  202.                            -------------------------
  203.                             Phone: +49 40 550 35 49
  204.              (Carrier (V.32bis/V.42bis/HST) from 22:00-12:00 MET)
  205.                  (Don't worry if you get "NO CARRIER" - maybe
  206.                 the system went down for a trip to India =:->)
  207.                            -------------------------
  208.               EMail: Kai 'wusel' Siering <wusel@hactar.hanse.de>
  209.                            -------------------------
  210.                  Anything related to this version of newsgate
  211.                    should be send to <bugs@hactar.hanse.de>.
  212.  
  213.                       (c) 1991-92 by Kai 'wusel' Siering
  214.                all rights reserved but no liability assumed ...
  215.  
  216.  
  217.    5 DISCLAIMER       
  218.  
  219.                           #include <stddisclaimer.h>
  220.  
  221.                            USE IT AT YOUR OWN RISK -
  222.                           and backup your disks! =:->
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  Page 4                  Last Change:  4 Dec 1992  3:28     Release 06 Nov 1992
  241.  
  242.  
  243.  newsgate(1)                   Amiga News & Mail                    mailgate(1)
  244.  
  245.  
  246.                                Table of Contents
  247.  
  248.  
  249.    0 Preface      ....................................................    1
  250.  
  251.    1 Software Requirements     .......................................    1
  252.  
  253.       1.1 Configuration      .........................................    1
  254.  
  255.    2 Usage      ......................................................    2
  256.  
  257.    3 Problems/Bugreports/Suggestions      ............................    4
  258.  
  259.    5 DISCLAIMER      .................................................    4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  Release 06 Nov 1992     Last Change:  4 Dec 1992  3:28                  Page 5
  301.