home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Divers / xppp-0.4.0.bin.tar.gz / xppp-0.4.0.bin.tar / xppp / README < prev    next >
Text File  |  1998-05-12  |  9KB  |  301 lines
  1.                 Xppp README
  2.  
  3. Xppp is an X application that lets you configurate and manage your
  4. ppp connection.
  5.  
  6. It has been tested on Linux 2.0.33 & Linux 2.0.0 .
  7.  
  8. ---------------------------------------------------------------------------------
  9.  
  10. 1.FUNCTIONALITY:
  11.  
  12.    The program is divided in 2 parts.
  13.  
  14.         1.xppp connect : This is the window from where you connect to 
  15.                 your ISP.
  16.  
  17.         2.xppp configurator : Here you enter all your data about the
  18.                 connection, i.e.: phone #, username, password,
  19.                 and some other options.
  20.  
  21.    The first time you run the program, you will have to configurate it, pressing
  22.    the CONFIGURATE button. (see NOTE below)
  23.    Once you have entered all your data, you can press the OK button in the
  24.    configuration form. This saves two connection scripts, and two configuration
  25.    files, which are later used to perform the connection by xppp.
  26.    When you have generated the scripts, and are back in the first window, you are
  27.    able to connect pressing the CONNECT button.
  28.    If you get a connection made, you can disconnect via the DISCONNECT button.
  29.    The console log will be telling you what is happening.
  30.  
  31.    These are the files that xppp generates:
  32.  
  33.             xppprc
  34.  
  35.             <connectionname>.xppprc
  36.  
  37.             <connectionname>.ppp-init (to make the connection)
  38.     and
  39.             <connectionname>.ppp-on-dialer (used by the first, to dial)
  40.  
  41.    Where <connectionname> is a name for your connection.
  42.    All the files listed above are located in /usr/local/lib/xppp
  43.  
  44.    ---------------------------------
  45.    NOTE (data needed to configurate):
  46.  
  47.    Some data is filled in by default. For example, I assume that your ISP asks
  48.    your username with the prompt 'Username:' (don't include the ' symbols).
  49.    If your ISP issue you any other prompt, you can change it (let's say 'Login:'
  50.    or any prompt in your languaje : 'Nombre:' ,'Name:' , etc.) in the input field
  51.    labeled 'Prompt1'.
  52.    Also, I assume that your ISP prompts 'Password:', if you need, you can change
  53.    it to whatever your ISP issue you to ask your password in the input field
  54.    labeled 'Prompt2'.
  55.  
  56.    You have to enter your username , and password (in invisible mode & twice for
  57.    security).
  58.  
  59.    If your ISP requires that you put any other command after identifying, you can
  60.    enter the secuence of prompt (issued by your ISP) and answer in the extra 
  61.    commands boxes.
  62.    My ISP prompts me someting like `server1>` , and I have to issue a 'ppp'
  63.    command.
  64.    In this case (or similar) you should enter '>' in the input field labeled
  65.    'Prompt3' and 'ppp' in the Answer3 input field. Of course these inputs mustn't
  66.    be filled in by everybody, only by who need it.
  67.  
  68.    If you have to dial any # to get outside tone, or anything like this, you have
  69.    to enter this with your phone # in the phone input field (in any way that can
  70.    be understood by an AT -dial- command).
  71.    For example, if you have to dial a 9 to get outside tone, and your ISP # is 
  72.    061034346, you should enter : 9,061034346
  73.  
  74.    Pressing the IP ADDRESSES button you can configurate some IP stuff.
  75.    I have assumed that your ISP assigns you a dynamic IP address, therefore
  76.    the local & remote IP inputs have a default value of '0.0.0.0' (that means 
  77.    dynamic IP assignament).
  78.    I also assume that your netmask will be '255.255.255.0', but you can change
  79.    any of the above values if you need to.
  80.    The light button labeled 'No IP default' sets dynamic IP assignament, the 
  81.    'Default route' one means that your ISP's address will be added in the routing
  82.    table as default gateway. I assume you will like these settings.
  83.    The pre & post connection options are not implemented still. If you need them,
  84.    just e-mail me.
  85.  
  86.    By pressing the CONNECTION button, you can set some modem options, like which
  87.    is your modem (/dev/modem, /dev/cua1, /dev/ttyS2, etc), the connection speed,
  88.    tone or pulse dialing, speaker volume, use or not hardware flow control, and
  89.    two options that I do not understand very well, and should not be changed :
  90.    ASYNCMAP, and ESCAPE.
  91.  
  92.    OK, at this stage, you should have everyting ready to generate the scripts.
  93.    Press OK in the main configuration form, and you will be asked for the name
  94.    of the connection, and the name of a configuration file. You can name them
  95.    however you want, but please keep the .xppprc extension for the config file
  96.    and save it in the default directory ( /usr/local/lib/xppp ).
  97.  
  98.    We are approaching to the end. Back in the first form, press the CONNECT
  99.    button, and watch the connection log. Some messages will appear, and you'll
  100.    get a 'Serial connection established' when ready.
  101.  
  102. ---------------------------------------------------------------------------------
  103.  
  104. 2.DISTRIBUTION:
  105.  
  106.    -You can get the source code and compile it. See COMPILING (3) for more info.
  107.  
  108.    -You can get the binaries, and install them. See INSTALLING (4) for more info.
  109.  
  110.    In both cases you will need xforms library (0.88 or greater).
  111.  
  112. ---------------------------------------------------------------------------------
  113.  
  114. 3.COMPILING:
  115.  
  116.    This is the list of source files you should have:
  117.  
  118.         xppp.c
  119.         xppp.h
  120.         xppp_cb.c
  121.         xppp_init.c
  122.         xppp_init.h
  123.         xppp_main.c
  124.         mytokens.h
  125.         mytokens.c
  126.         Makefile
  127.  
  128.    plus xforms library:
  129.  
  130.         libforms.so.0.88    (shared)
  131.    or
  132.         libforms.a        (static)
  133.  
  134.    the header for xforms:
  135.  
  136.         forms.h
  137.  
  138.    a directory containing pixmaps:
  139.  
  140.         ./pix/*.xpm
  141.  
  142.    and these files:
  143.  
  144.         README            (you are rading it now)
  145.         LICENSE            (GNU General Public License)
  146.         ppp-off            (used to disconnect)
  147.         xppp.8            (manual page)
  148.  
  149.    If you don't have xforms library, you can get it at: 
  150.  
  151.         http://bragg.phys.uwm.edu/xforms
  152.     or
  153.         via ftp in any mirror.
  154.  
  155.     In this case, follow the instructions supplied with the library to
  156.     compile and/or install it (and jump to Second step).
  157.  
  158.    STEPS:
  159.     -First: Once you have all the files, you should install the library and
  160.         the header file, typing:
  161.  
  162.             make install.xforms
  163.  
  164.          You can edit it to change directory settings, etc.
  165.         (if you have obtained xforms from other place, please follow the
  166.         instructions supplied with the library)
  167.  
  168.     -Second: Edit the Makefile to fit your settings if needed(not necessary
  169.         in most cases).
  170.  
  171.     -Third: type:
  172.             make
  173.  
  174.     -Fourth: type
  175.             make install
  176.             make install.man
  177.  
  178.     -That's all folks.
  179.  
  180. ---------------------------------------------------------------------------------
  181.  
  182. 4.INSTALLING:
  183.  
  184.     (installing the binaries)
  185.  
  186.    These are the files you should have:
  187.  
  188.         xppp
  189.         Makefile
  190.  
  191.    plus the library:
  192.  
  193.         libforms.so.0.88    (shared)
  194.     or
  195.         libforms.a        (static)
  196.  
  197.    a directory containing pixmaps:
  198.  
  199.         ./pix/*.xpm
  200.  
  201.    and these files:
  202.  
  203.         README            (you are rading it now)
  204.         LICENSE            (GNU General Public License)
  205.         ppp-off            (used to disconnect)
  206.         xppp.8            (manual page)
  207.  
  208.  
  209.    Note:
  210.    If you don't have xforms library, you can get it at: 
  211.  
  212.         http://bragg.phys.uwm.edu/xforms
  213.     or
  214.         via ftp in any mirror.
  215.  
  216.     In this case, follow the instructions supplied with the library to
  217.     compile and/or install it (and jump to Second step).
  218.  
  219.    STEPS:
  220.     -First: type:
  221.         make install.xforms
  222.  
  223.     -Second: type:
  224.         make install
  225.         make install.man
  226.  
  227.     -That's all!
  228.  
  229. ---------------------------------------------------------------------------------
  230.  
  231. 5.COPYRIGHT - DISCLAIMER :
  232.  
  233.    Programmed by Diego Rodrigo.
  234.    Xppp home page : http://www.geocities.com/MotorCity/5501/xppp.html
  235.  
  236.    Built with Xforms library & Form Designer.
  237.    If you need information about xforms, visit http://bragg.phys.uwm.edu/xforms
  238.  
  239.    Copyright (C) 1998 Diego Rodrigo.
  240.  
  241.     This program is free software; you can redistribute it and/or modify
  242.     it under the terms of the GNU General Public License as published by
  243.     the Free Software Foundation; either version 2 of the License, or
  244.     (at your option) any later version.
  245.  
  246.     This program is distributed in the hope that it will be useful,
  247.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  248.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  249.     GNU General Public License for more details.
  250.  
  251.     You should have received a copy of the GNU General Public License
  252.     along with this program; if not, write to the Free Software
  253.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  254.  
  255.  
  256.    If you make any change to the code, please e-mail me, so I can put it in
  257.    new versions.
  258.  
  259.  
  260. ---------------------------------------------------------------------------------
  261.  
  262. 6.TODO:
  263.  
  264.    -These two features aren't still operative:
  265.     Pre & Post connection commands
  266.  
  267.         They should be used to issue any command before & after
  268.          connecting.
  269.         They will function in a later version.
  270.  
  271.    -Improve my english (sorry).
  272.  
  273. ---------------------------------------------------------------------------------
  274.  
  275. 7.THANKS TO:
  276.  
  277.    -Daniel Gandara & Raul Jorja for teaching me the firsts concepts about the 
  278.     Linux world.
  279.  
  280.    -Marcelo Salinas for his help with ppp scripts.
  281.  
  282.    -All the people at Linux Users Group Argentina  ->  http://www.linux.org.ar
  283.  
  284.  
  285.    Don't hesitate to give me any suggestion or comment.
  286.  
  287.     Diego Rodrigo
  288.     d.rodrigo@computer.org
  289.  
  290.     Marcelo T. de Alvear 255 - 9 B
  291.     Cordoba (CBA) - 5000
  292.     ARGENTINA
  293.  
  294.     http://www.geocities.com/MotorCity/5501/xppp.html
  295.  
  296.     Optional e-mail : d.rodrigo@iname.com
  297.  
  298. ---------------------------------------------------------------------------------
  299.                   MADE IN ARGENTINA
  300. ---------------------------------------------------------------------------------
  301.