home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / rxdynd06.zip / rxdyndns.txt < prev    next >
Text File  |  2002-03-18  |  5KB  |  82 lines
  1. 0.      Contents of RXDYNDNS.ZIP:
  2. 0.1     RXDYNDNS.TXT    this text
  3. 0.2     RXDYNDNS.CMD    simple DynDNS update script for OS/2 REXX
  4. 0.3     WATCHPPP.CMD    simple OS/2 ppp0 daemon using RXDYNDNS.CMD
  5. 0.4     WATCHPPP.ICO    a nice icon for WATCHPPP.CMD <PPP0.DAEMON>
  6.  
  7. 1.      Prerequisites
  8. 1.1     RXSOCK.DLL      REXX sockets library from IBM
  9. 1.2     ppp0.pid        ?:\mptn\etc\ppp0.pid watched by WATCHPPP.CMD
  10. 1.3     ifconfig.exe    dynamic IP determined by IFCONFIG PPP0
  11. 1.4     host.exe        used by WATCHPPP.CMD to get host by name
  12. 1.5     hostid.exe      used by WATCHPPP.CMD to get and set local IP
  13. 1.6     HOSTNAME        your DynDNS host, e.g. test.dnsalias.org
  14. 1.7     USERNAME        your DynDNS loginid., e.g. test
  15. 1.8     PASSWORD        your DynDNS password, e.g. test for test
  16.  
  17. 2.      Installation
  18. 2.1     Copy WATCHPPP.CMD and RXDYNDNS.CMD to a directory in your PATH.
  19. 2.2     Edit WATCHPPP.CMD to reflect your HOSTNAME, USERNAME, PASSWORD.
  20. 2.3     Use 'WATCHPPP *' (once) to (re)create a WPS object PPP0.DAEMON.
  21. 2.4     Edit PPP0.DAEMON settings as needed (e.g. use WATCHPPP.ICO).
  22. 2.5     Create a shadow of PPP0.DAEMON in the start folder <WP_START>.
  23. 2.6     Start PPP0.DAEMON manually for the first time (or reboot :-).
  24. 2.7     Move object PPP0.DAEMON from the desktop to any other folder.
  25.  
  26. 3.      WATCHPPP.CMD
  27. 3.1     The shipped version of WATCHPP.CMD updates a DynDNS host with
  28.         call RXDYNDNS 'ppp0', 'test.dnsalias.org', 'test', 'test'
  29. 3.2     You can edit this script as needed, e.g. start other tasks
  30.         as soon as a new IP (= dialup internet connection) is detected.
  31. 3.3     You can edit FORCEDIP = 1 to use a new dynamic IP as hostid
  32.         (reported by hostid.exe), if your host has no other IP.
  33. 3.4     WATCHPPP.CMD can be used as VIO program on the command line or
  34.         as PM program (started by CMD.EXE or PMREXX.EXE).  At most one
  35.         instance of WATCHPPP.CMD can run for any given interface, the
  36.         default interface is IFCONFIG = 'ppp0'.
  37. 3.5     To start a new PPP0.DAEMON call e.g. WATCHPPP 10 for a poll
  38.         cycle of 10 seconds.  To kill a running PPP0.DAEMON or to see
  39.         the usage text call WATCHPPP without arguments, this sends a
  40.         termination request to the running daemon.
  41. 3.6     In fact PPP0.DAEMON uses a private REXX queue 'PPP0.DAEMON'
  42.         to retrieve the output of ifconfig.exe etc., and terminates
  43.         itself if anybody else writes into this queue.
  44.  
  45. 4.      RXDYNDNS.CMD
  46. 4.1     RXDYNDNS can be used directly on the command line to update
  47.         a DynDNS host: RXDYNDNS interface hostname username password,
  48.         e.g. try RXDYNDNS ppp0 test.dyndns.org test test
  49. 4.2     Please edit the line COPYLEFT = ... in RXDYNDNS.CMD as soon
  50.         as you change anything else in this script, because DynDNS
  51.         can block erroneous resp. abusive update clients.
  52. 4.3     As shipped RXDYNDNS.CMD supports only the DynDNS system of
  53.         DynDNS.org for a single host without MX record. Adding more
  54.         options should be easy, but please change the COPYLEFT too.
  55. 4.4     RXDYNDNS.CMD does not actually handle the DynDNS protocol,
  56.         it only displays resp. returns the result of an attempted
  57.         update. The caller has to evaluate the result messages as
  58.         specified in: http://clients.dyndns.org/devel/codes.php
  59. 4.5     WATCHPPP.CMD simply displays any RXDYNDNS.CMD result, so the
  60.         user is responsible for the proper reaction like waiting for
  61.         a certain period or correcting invalid WATCHPPP parameters.
  62.  
  63. 5.      History
  64. 5.1     I've created RXDYNDNS 0.3 because DNSAlias-Net 2.0 had been
  65.         removed from the list of "other clients" for unknown reasons.
  66.         It's now back again, see http://clients.dyndns.org
  67. 5.2     One problem with DNSAlias-Net 2.0 could be that the author
  68.         forgot to update the client's identification (compare 4.2 ;-).
  69.         Of course you can use WATCHPPP.CMD with UPDATE.CMD instead of
  70.         RXDYNDNS.CMD.
  71. 5.3     Please note that B64encode used in DNSAlias-Net 2.0 is not
  72.         strictly correct, but DynDNS accepts it anyway.  For details
  73.         compare results of RXDYNDNS.CMD procedure MIME and B64encode.
  74. 5.4     If your domain is something like host.orgdns.org then RXDYNDNS
  75.         version 0.4 sends its update requests to members.orgdns.org
  76.         instead of members.dyndns.org, see http://www.orgdns.org
  77. 5.5     Version 0.5 sends "Connection: close" and "Pragma: no-cache"
  78.         headers in a HTTP/1.0 GET request, HTTP 1.0 has no "chunked"
  79.         replies (see HTTP/1.1 RFC 2616 19.4.6) and is easier to parse.
  80. 5.6     This is version 0.4 of RXDYNDNS.CMD, for future updates see
  81.         http://frank.ellermann.bei.t-online.de/src/rxdyndns.zip
  82.