home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / my2_1b.zip / READMEv1.ENG < prev    next >
Text File  |  1998-04-16  |  44KB  |  1,069 lines
  1.                              =========                           version 1.0b
  2.                         --- === My/2 === ---
  3.                              =========
  4.                 Copyright (C) 1997,1998  Alexnadr Ivanov
  5.  
  6.                 This is Electronical Translator version!
  7.  
  8. Contents list
  9. 0.        Agreement
  10. 1.        Introduction
  11. 2.        Requirements
  12. 3.        Description My/2
  13. 4.        Description of a configuration file
  14. 5.        Contents of a package
  15. 6.        Examples of use ( Structures of a network )
  16. 7.        Messages on errors
  17. 8.        Interface
  18.   8.1          Description of a main window
  19.     8.1.1       To reset the user from a modem
  20.     8.1.2       To close a entrance to the user
  21.     8.1.3       To delete the user
  22.     8.1.4       Refresh a main window
  23.     8.1.5       Sorting
  24.     8.1.6       Write the letter to the user
  25.   8.2          Description of window UserDetail/OtherDetail
  26.     8.2.1       Sorting
  27.     8.2.2       Filtering
  28.   8.3          Description of a configuration window
  29. 9.        LOG-files
  30.   9.1          LOG-files of a general traffic of the user
  31.   9.2          LOG-files of a user IP-traffic structure
  32.   9.3          Main LOG-file of the program
  33. 10.        Errors
  34. 11.        Inconveniences
  35. 12.        Thanks
  36. 13.        Restrictions of the DEMO-version
  37. 14.        Understanding of the Virtual user
  38. 15.        The remote users
  39.   15.1         Return Codes from server
  40.   15.2         Example of session
  41.  
  42.  
  43.                         0. Agreement
  44. DEMO version of the program can be freely distributed without any changes
  45. and without any fee.
  46.  
  47. DEMO version detection:
  48. At program start, DEMO version show a window, that says about limitation
  49. DEMO version. At main menu Help/About DEMO version show (DEMO) followed by
  50. version number.
  51.  
  52. If You have NOT A DEMO VERSION, You may NOT distribute it without agreement
  53. with the author.
  54.  
  55.  
  56.                         1. Introduction
  57. The program My/2 is intended for the tax and visual representation of
  58. statistics on a traffic for:
  59. 1.        IP-interfaces
  60. 2.        The users
  61. 3.        COM-port
  62. 4.        Structures of IP traffic
  63.  
  64. !!! --- ATTENTION ---!!!
  65.         At inclusion of function of a IP-analyzer, remember, that:
  66.         1.       You will see all structure of a traffic of the users.
  67.                 Probably, it infringes some Freedom of the users.
  68.         2.       If any user in your local network will install the given
  69.                 program with included function of a IP-analyzer, actually,
  70.                 he can see WHOLE traffic on your network.
  71.                 ( Many depends on a structure of a network
  72.                 See 6. Examples of use ( Structure of a network ) ).
  73.  
  74.  
  75. My / 2 is useful for HostMasters, whose hosts cost under OS / 2. But it
  76. the usual Internet user can also use at ANY type of connection with
  77. provider.
  78.  
  79.  
  80.                         2. Requirement
  81. 1.        OS/2 ( was tested on WarpConnect, WarpServer Advanced, Merlin )
  82. 2.        Installed TCP/IP ( Tested with versions 3.0, 3.1, 4.0 )
  83.  
  84.           WARNING !!!
  85.           My/2 and IPSpy NOT WORK with TCP/IP 4.1 stack ! So,
  86.           TCP/IP 4.1 is VERY DIFFERENT from 3.0, 3.1, 4.0.
  87.           I have search, but NOT FOUND documentation for TCP/IP 4.1
  88.           (such Programming Guide or something like that  :( ).
  89.  
  90. 3.        Presentation Manager
  91. 4.        HPFS
  92. 5.        Installed IPSpy
  93. 6.        Pentium and 24 & above Mb RAM recommended
  94.  
  95.  
  96.                         3. Description My/2
  97. My/2 permits to assemble statistics on the users and interfaces.
  98. Statistics is going in files. On each user file is conducted.
  99. Also files are conducted on ALL COM-ports and network interfaces.
  100. The files of statistics contain textual lines, that permits to make the
  101. analysis of statistics by any software StarOffice, C, Pascal
  102. ( I personally love REXX ).
  103.  
  104. My/2 conducts the report on:
  105.         1. General traffic of the users and interfaces
  106.         2. Structured traffic of the users
  107.         3. Detailed information on the current users
  108.  
  109.  
  110.  
  111.                         4. Description of a configuration file
  112. The configuration file IS OBLIGED to be in ETC ñ¿αÑ¬Γ«α¿¿ and to have
  113. the name my.cfg. Some parameters can be to set. Significance of parameters
  114. the on - default is everywhere indicated.
  115. If you want to insert the comment, it should be on a separate line and the
  116. line should begin with ";".
  117.  
  118. Generalized description of parameters:
  119.         THE KEY param1 param2... paramN
  120.  
  121. In a configuration file following parameters are used:
  122.  
  123. DEBUG_LEVEL     TINY
  124.         Can accept one of the following significances:
  125.         NONE -         There are no diagnostic messages
  126.         TINY -         Minimum of diagnostic messages
  127.         SMALL - ...
  128.         MEDIUM -...
  129.         LARGE - ...
  130.         HUGE -         Maximum of the diagnostic messages.
  131.         It concerns ONLY to a LOG-file.
  132.  
  133.         Default: TINY
  134.  
  135. STAT_TIMEOUT                60 ( in MIN ) up to 10 mines is approximated.
  136.                                                          In the SMALLER party
  137.         In this example - hour. If to deliver 63 or 67, all the same there
  138.         will be a hour, and if for example 70, I will be a hour and ten
  139.         minutes. This time COMPULSORY save of statistics. If for example,
  140.         the user in a hour was not disconnected, all the same will take place
  141.         save of statistics on him in appropriate files.
  142.         Statistics is dumped or on a exit of the user, or on
  143.         timeout of a time, determined in variable STAT_TIMEOUT. And
  144.         further readout new timeout begins. etc.
  145.  
  146.         Default: 60
  147.  
  148. STAT_PATH                D:\TEMP\MY ( only directory WITHOUT "\" at end )
  149.         In this directory statistics on the users is dumped. Files
  150.         with masks will be formed: "comN.MMYYYY" and "login.MMYYYY".
  151.         Accordingly statistics on the users and on COM-ports and network
  152.         Interfaces is conducted.
  153.         The network interfaces have the name LANN - where last N this number
  154.         of a network card to the on - order. And login CARDN - where last N
  155.         this number of a network card to the on - order. In statistics there
  156.         is a date and time of beginnings of the tax, end of the tax,
  157.         byte it is accepted, byte is transferred. And it is a lot of
  158.         that more. ( see item 9.1 ) Also in this directory LOG-files on
  159.         a structure of a IP-traffic of the users ( see item 9.2 ) are written.
  160.  
  161.         Default: IS NOT PRESENT
  162.  
  163. INACTIVE_TIME   7
  164.         is used for switching-off of the user till him
  165.         inactive over a specified interval of a time in minutes.
  166.         So, if the user connected, but from his /and/or/ to him
  167.         does not go a IP-traffic, switching-off of the user will take place,
  168.         as though you have pressed a button "Disconnect selected user".
  169.         The user will not be disconnected in case if:
  170.                 1. This leased line. (see item 8.1)
  171.                 2. If its COM-port is protected (see. TIMEOUT_PROTECTED_COM)
  172.                 2. If it LOGIN is protected (see. TIMEOUT_PROTECTED_USER)
  173.         If variable INACTIVE_TIME is equal 0, the users will not be
  174.         disconnected on timeout.
  175.  
  176.         To on - default: 7
  177.  
  178. TIMEOUT_PROTECTED_COM com2 com7 com12
  179.         is used to protect COM-port from
  180.         disconnect the user, which is on it on timeout (see. INACTIVE_TIME).
  181.         Can be listed up to 10 COM-port separated by SPACE.
  182.  
  183.         To on - default: IS NOT PRESENT
  184.  
  185. TIMEOUT_PROTECTED_USER alex john crazy
  186.         is used to protect the users from
  187.         disconnect on timeout, COM-port, on which it has gone has not
  188.         significance (see. INACTIVE_TIME).
  189.         Up to 10 names can be listed separated by SPACE.
  190.  
  191.         To on - default: IS NOT PRESENT
  192.  
  193. MAIL 194.84.32.67 sura.com.ru
  194.         As first parameter it is underlined mail server, through which mail on
  195.         the users (see item 8.1.6) will depart can here given as
  196.         IP-address, as DNS-name. For example:
  197.            MAIL penza.sura.com.ru sura.com.ru
  198.            MAIL 194.84.32.67 sura.com.ru
  199.            Second parameter is a domain to on - default, which will be added
  200.         at the end of the mail addresses FROM and TO at dispatch of the
  201.         letters (see item 8.1.6).
  202.         Second parameter is not certain. But if it to specify, he
  203.         will be added to the end of each mail name, IF COMPLETE MAIL ADDRESS
  204.         IS NOT SPECIFIED.
  205.  
  206.         To on - default: IS NOT PRESENT
  207.  
  208. ERRORTO MAIL alex@sura.com.ru
  209.         This parameter is necessary for redirect the messages on
  210.         errors from a screen on EMAIL or on the contrary. If costs MAIL,
  211.         EMAIL-address should be further follow. If SCREEN, second
  212.         parameter is ignored.
  213.         ATTENTION!!!
  214.         In given version ERRORTO is not used. And is always equal SCREEN,
  215.         though and it is permitted it to change.
  216.  
  217.         To on - default: SCREEN
  218.  
  219.  
  220. REFRESH_INTERVAL        3 ( in SEC )        About it a little separately.
  221.         It is used for determination, through how many seconds to interrogate
  222.         interfaces.
  223.         The speed is in this case also considered for this time. And is always
  224.         displayed in Byte/sec units. So, than more to deliver this
  225.         number, especially speed you receive. It is necessary also
  226.         to take into account, that at large significance given variable
  227.         exits and entrances users will with large later be found out.
  228.         Its significance also influences a time in LOG-files.
  229.  
  230.         Default: 3
  231.  
  232. COMUSER_PATH                D:\UUCP\PPP\CURRENT ( only directory WITHOUT "\"
  233.         at end ) This variable is used for link the user and Com-port.
  234.         If the program ßould not determine the user, in the column
  235.         Login she removes Noone. If ßould not find Com-port, in the column
  236.         Com port she removes NoPort. And, certainly, if she ßould not
  237.         determine the user, in the column Real name she removes Uncataloged User.
  238.         This KEY variable.
  239.         Sense that at pass of the user, when establishing PPP on it, it
  240.         is necessary that someone formed in this directory a file with the
  241.         following mask "comN.Login". If for example the user with login
  242.         andy on 6 com-ports has gone, in this directory there should occur a
  243.         file " com6. Andy ".
  244.         It is done is very simple: in shell at PPP-user writing
  245.         not PPP.EXE, and for example PPP.CMD which before establishing present
  246.         PPP, determines the user and COM-port and creates in
  247.         directory, which is determined in COMUSER_PATH a file
  248.         as describe above principle. A CMD-file for a example I enclose. He
  249.         refers to as PPP.CMD. In him the current user is recorded in
  250.         d:\uucp\ppp\CURRENT. Here for a example a part my passwd:
  251.         ...
  252.         Pelsi: qwerty:::elsi:/UUCP/PPP:ppp.cmd $host $port
  253.         Padi: QwErTy:::adi:/UUCP/PPP:ppp.cmd $host $port
  254.         Psba: 1sdr45:::sba:/UUCP/PPP:ppp.cmd $host $port
  255.         Pstone:qwertyh::: stone:/UUCP/PPP:ppp.cmd $host $port
  256.         ...
  257.         The time on the start PPP.CMD is spent minimal, and flexibility -
  258.         HUGE.
  259.  
  260.         Default: D:\MPTN\ETC
  261.  
  262. PASSWD_PATH                D:\UUCP\CONFHOST\passwd ( full path and filename to
  263.         passwd ) the Program uses passwd file, ONLY to determine a
  264.         real name of the user. If the given user in a file is not present,
  265.         whether or not file, My/2 in the field RealName basically window
  266.         removes Uncataloged User.
  267.  
  268.  
  269. MAIN_INTERFACE lan0
  270.         This interface, from which IP-packages will be catched. For display and
  271.         record a structure of IP-traffic. This parameter makes sense at
  272.         established variable IP_ANALIZE. And at availability
  273.         installed IPSpy for catch a packages.
  274.         !!! ATTENTION!!!
  275.         Closely read the documentation to IPSpy!
  276.  
  277.         Dfault: lan0
  278.  
  279. IP_ANALIZE     DIRECT,BROADCAST           Can accept one of the following
  280.         significances:
  281.         NONE -          Not to analyze a IP-traffic.
  282.         DIRECT -        To analyze ONLY packages, which are directed to
  283.                         this machine.
  284.         BROADCAST -     To analyze ONLY broadcast-packages.
  285.         TRANSIT -       To analyze packages to other computers.
  286.         Possible combinations are further indicated:
  287.         DIRECT,BROADCAST | DIRECT,TRANSIT | BROADCAST,TRANSIT |
  288.         DIRECT,BROADCAST,TRANSIT .
  289.  
  290.         Default: DIRECT,BROADCAST
  291.         WARNING !!!   No SPACES between "," and a chars.
  292.  
  293. SRC_IPMASK        *. *. *. * Possible significances:
  294.         0,1,2,3,4,5,6,7,8,9,., * will form a mask of IP-address for the fields
  295.         From ( see item 8.2.2 for the more detailed description of masks )
  296.  
  297.         Default: *. *. *. *
  298.  
  299. DST_IPMASK        *. *. *. * see. SRC_IPMASK
  300.  
  301.         Default: *. *. *. *
  302.  
  303. MAINW_REFRESH        10 ( It means through 10 REFRESH_INTERVALs redraw )
  304.         Through which time redraw a main Container automatically.
  305.         Is measured in REFRESH_INTERVAL intervals.
  306.         In My/2 is used as REFRESH_INTERVAL * MAINW_REFRESH
  307.  
  308.         Default: 10
  309.  
  310. LOCAL_IP        ON
  311.         Parameter speaks My/2 about a volume, which IP address to use for
  312.         the analysis of a structure of a IP-traffic, remote or local.
  313.         Usually for provider is remote. For the users - local.
  314.         If you put My/2 on a machine, ON which users connect to,
  315.         LOCAL_IP OFF, if you call to provider, ON.
  316.  
  317.         Default: OFF
  318.  
  319. CLOSE_USER_PGM VISIBLE MAXIMIZE BACKGROUND 10 " D:\WORK_PRG\OBJ\My\ccc.cmd %s -close_ppp "
  320.         First parameter VISIBLE or INVISIBLE
  321.         Second parameter MINIMIZE or MAXIMIZE
  322.         Third parameter FOREGROUND or BACKGROUND
  323.         Fourth parameter 1-60 sec . Timeout. After this timeout My/2 will be try to
  324.         close this program session.
  325.         5 parameter a Name of the started program and her parameters In
  326.         COMMAS! This key describes the program, which will be started if you
  327.         ask to close the user ( see item 8.1.2)
  328.         !!! ATTENTION!!!
  329.         Name of the program and her parameters SHOULD be in commas ( " ).
  330.         There, where costs %s, command line from four parameters is there
  331.         substituted:
  332.         1      Login ( for example alex )
  333.         2      ComPort ( for example com2 )
  334.         3      Interface name ( for example ppp3 )
  335.         4      IP address for the given user (for example 194.11.12.13)
  336.         If the IP-address was not yet determined, 0.0.0.0. Programs can be ANY
  337.         type PM or VIO. Perfectly works and REXX. I think, that will go and
  338.         DOS-session, but I did not try.
  339.  
  340.         Dfault: IS NOT PRESENT
  341.  
  342. DELETE_USER_PGM INVISIBLE MINIMIZE FOREGROUND 20 " D:\WORK_PRG\OBJ\My\ccc.cmd %s -close_ppp "
  343.         Similarly CLOSE_USER_PGM ( see. CLOSE_USER_PGM and item 8.1.3)
  344.  
  345.         Default: IS NOT PRESENT
  346.  
  347. VIRTUAL_USER    alexV      Alexandr_A._Ivanov      194.84.32.71
  348. VIRTUAL_USER    IBM        WWW_IBM_COM             www.ibm.com
  349.         ...
  350. VIRTUAL_USER    Microsoft  MICROSOST-WIN95         www.windows95.com
  351.         This parameter sets the virtual users. Them can be up to 10 ( see item 14)
  352.         In the quality IP of address it is possible to set as IP - address, as
  353.         DNS-name.
  354.         Remember, that Real_Name should contain "_" instead of " ", if you
  355.         record the virtual user. If create it(him) from a window of a
  356.         configuration, about it it is not necessary cares.
  357.  
  358.         To on - default: IS NOT PRESENT
  359.  
  360. RUN_SERVER <ON|OFF> <PORT> Permits My/2 to work as server, accepting by
  361.         the inquiries of the IP-customers.
  362.         From version 0.99 My/2 supports the remote customers on TCP/IP.
  363.         So you can from any point of the world go on My/2 server
  364.         and to receive the certain information or to execute any
  365.         action. Actions are those, that you can execute local on My/2.
  366.         See item 15 ( Remote users ).
  367.  
  368.         To on - default: ON 7777
  369.  
  370. MAX_CLIENTS 2 1-10
  371.         Maximum quantity of the simultaneously attended IP-customers.
  372.         See item 15 ( Remote users ).
  373.  
  374.         To on - default: 2
  375.  
  376. CLIENT_REFRESH 3                        1-10 ( sec. ) Parameter characterizes
  377.         a time through which to interrogate flows on the IP-customers on a
  378.         subject inactive or die. See item 15 ( Remote users ).
  379.  
  380.         To on - default: 5
  381.  
  382. CLIENT_TIMEOUT 30                       1-60 ( sec. ) Parameter characterizes
  383.         through which inactive time under duress to disconnect the
  384.         customer from server. See item 15 ( Remote users ).
  385.  
  386.         To on - default: 30
  387.  
  388. CLIENT_DEBUG_LEVEL TINY                 <NONE|TINY|SMALL|MEDIUM|LAGRE|HUGE>
  389.         A level of management LOG of a file on the remote customers.
  390.         In version 0.99 is not used.
  391.  
  392.         To on - default: TINY
  393.  
  394. REMOTE_USER alex varkuta 001002003004005006007
  395.         ...
  396. REMOTE_USER gonza jabberwock 001004005006007
  397.         Format of record: REMOTE_USER <LOGIN> <PASSWORD> <RIGHTS>. With
  398.         the help login and password the user identify self.
  399.         About the rights:
  400.         The rights represent commands, which the remote user can
  401.         execute and, actually, are a consecutive set of three-value figures.
  402.                           Æ«ÑßΓ∞: 001003006007
  403.                                   \_/\_/\_/\_/
  404.         Each figure represents a command. Are further listed
  405.         accessible in version 0.99 of a command:
  406.  
  407.         000    Empty command (NOP)
  408.         001    Requests the current users and their characteristic. Actually,
  409.                 contents of a main screen.
  410.         002    To disconnect the chosen user. Is aplicable only to 2 types of
  411.                 the users dialup and leased. See item 8.1.1
  412.         003    To close access to the user. See item 8.1.2
  413.         004    To delete the user See item 8.1.3
  414.         005    To request the information on IP to a traffic of the chosen
  415.                 user See item 8.2 Data go in the same order.
  416.         006    To request the information on other IP to a traffic See
  417.                 item 8.2 Data go in the same order.
  418.         007    To request a configuration
  419.         300    Exit
  420.         301    Authorization
  421.  
  422.         In addition see item 15
  423.  
  424.  
  425.                         5. Contents of a package
  426. 1.        My2. Exe
  427. 2.        mypm.dll, mynv.dll, mynet.dll
  428. 3.        Example of a configuration file
  429. 4.        The example PPP.CMD
  430. 5.        Given description ( readme.rus, readme.eng )
  431.  
  432.  
  433.                         6. Examples of use ( Structure of a network )
  434. My/2 it is possible to use on different purposes. It is possible to analyze
  435. a traffic in - outside of and inside in different combinations and
  436. configurations. For example:
  437.  
  438. (1)
  439.     Is optimum, as to me the following circuit seems,:
  440.  
  441.    Comp with My/2                                ┌───── IP router
  442.       ┌─────┐           ┌─────┐     ┌─────┐      │ (For example Vanguard)
  443.       │     │           │     │     │     │      \/
  444.       └─────┘           └─────┘     └─────┘     ┌──────┐
  445.      ┌───────┐── ...───┌───────┐───┌───────┐────│      │──> Internet
  446.      └───────┘         └───────┘   └─┬─┬─┬─┘    └──────┘
  447.              Local Area Network   ┌──┘ │ └─────────┐
  448.                              modem1 modem2 ...  modemN
  449.                                   MODEM ENTRANCES
  450.  
  451.      Whole TRAFFIC and from a local network and from modem entrances
  452.      will be in this case analyzed. In IP_ANALIZE it is necessary only set
  453.      a name of a network card.
  454.  
  455. (2)
  456.      It is possible to use and other. For example with two network cards:
  457.  
  458.                                  Comp with  My/2
  459.       ┌─────┐           ┌─────┐     ┌─────┐
  460.       │     │           │     │     │     │       lan1
  461.       └─────┘           └─────┘     └─────┘ (For example EiconCard)
  462.      ┌───────┐── ...───┌───────┐───┌───────┐────────────────────> Internet
  463.      └───────┘         └───────┘   └─┬─┬─┬─┘
  464.              LOCAL AREA NETWORK   ┌──┘ │ └─────────┐
  465.                 lan0          modem   modem2 ...  modemN
  466.                                   MODEM ENTRANCES
  467.  
  468.     In this case, to analyze a traffic in - outside of, you will need
  469.     to be delivered in IP_ANALIZE lan1. In this case you lose a opportunity
  470.     to analyze a structure ONLY IP-traffic from modem entrances to you
  471.     in a Local area network.
  472.  
  473.  
  474.  
  475.                         7. Message on errors
  476. 1. Variable XXXXXXX defined, but has no arguments. Useing default value.
  477.    Configuration variable from file means that any varible is determined,
  478.    but does not contain arguments. Will be used her parameters of dfault
  479.    ( see item 4 )
  480.  
  481. 2. OTHER traffic array is overheat. Counting current users only and OLD hosts.
  482.    Array on another's ( concerning our computer of address ) means is
  483.    overflowed New directions will not be added. Will be supplemented only old.
  484.  
  485. 4. User XXXX traffic array is overheat. Since all NEW HOST traffic will be
  486.    added to UNKNOWN.
  487.    Array of directions on the given user means is overflowed New directions
  488.    will not be added. Will be supplemented only old.
  489.    And new will go in OTHER.
  490.  
  491. 5. There is a number of the messages, where is spoken: "... IP analizing
  492.    function is DISABLED ".
  493.    It means, that you have requested to analyze a IP-traffic, but at you is
  494.    not correctly installed IPSpy if at all is installed.
  495.  
  496. The other messages not so are significant or simple for understanding.
  497.  
  498.  
  499.  
  500.                         8. Interface
  501. The interface is simple. One main window.
  502.  
  503.  
  504.                         8.1 Description of a main window
  505.  
  506. Main window of the program visually displays:
  507.  
  508.   0. User type (icon)
  509.   1. Physical name of a interface
  510.   2. TCP/IP a name of a interface
  511.   3. Maximum speed of a interface
  512.   4. IP address ( if LAN, own, if PPP or SLIP - remote or local [see item 4])
  513.   5. Login of the user
  514.   6. Date and time of a entrance
  515.   7. Byte it is accepted
  516.   8. Byte is transferred
  517.   9. Current speed on a input
  518.  10. Current speed on a output
  519.  11. Present name of the user
  520.  
  521. Now user types may be next:
  522.         1. Lan interface (CARD...)
  523.         2. Leased line   (USERNAME...) - Uppercase
  524.         3. Dialup entry  (username...) - Lowercase
  525. So, if in COMUSER_PATH (see. item 4) Login of user defined in UPPERCASE,
  526. than My/2 think, that it's a LEASED line, if in lowercase, then Dialup user.
  527. In all this case apropriate icon are included.
  528.  
  529. About errors and various information she gives in right status line.
  530. Left-hand is used for the contextual help on buttons.
  531. If occur which or global errors, My/2 removes modal window with the
  532. button OK. After it terminates work. Also the windows of such type are removed
  533. at the serious warnings.
  534.  
  535. It is possible to make various manipulations with the users:
  536.  1. To reset from a modem ( see  8.1.1 )
  537.  2. To close an entrance in a system ( see  8.1.2 )
  538.  3. To delete the user ( see  8.1.3 )
  539.  
  540. !!! --- ATTENTION ---!!!
  541. All these manipulations can be made ONLY with the modem users.
  542.  
  543.  
  544.  
  545.                         8.1.1  To reset the user from a modem to
  546. Reset the user from a modem it is necessary to choose item of the menu:
  547. Users/Manipulation/Disconnect or to choose the button Disconnect selected
  548. user.
  549. Thus look after, that the cursor was on the necessary user.
  550. The modem is extinguished with the help DTR.
  551.  
  552.  
  553.                         8.1.2  To close a entrance to the user
  554. To close a entrance to the user it is necessary to choose item of the menu:
  555. Users/Manipulation/Close or to choose the button Close selected user.
  556. Thus look after, that the cursor was on the necessary user.
  557. The closing of the user works, if in a configuration is determined variable
  558. CLOSE_USERPGM ( see  4 ). At closing of the user is automatically caused
  559. Disconnect ( see 8.1.1). On work of the program on closing user is allocated
  560. 10 ßѬ. ( While. Further I do this parameter variable ), through this time
  561. a compulsory stop and Terminate of this program will be executed. With all
  562. following consequences    ;)
  563.  
  564.  
  565.  
  566.                         8.1.3         To delete the user
  567. To delete the user it is necessary to choose item of the menu:
  568. Users/Manipulation/Delete or to choose the button Delete selected user.
  569. Thus look after, that the cursor was on the necessary user.
  570. The closing of the user works, if in a configuration is determined variable
  571. DELETE_USERPGM ( see 4 ). At removal of the user is automatically
  572. caused Disconnect ( see 8.1.1 ). On work of the program on removal of
  573. the user is allocated 10 ßѬ. ( While. Further I do this parameter variable ),
  574. through this time a compulsory stop and Terminate of this program will be
  575. executed. With all following consequences     ;)
  576.  
  577.  
  578.                         8.1.4  Refresh a main window
  579. That refresh the information basically a window, Choose item of menu
  580. View/Refresh. Refreshing occurs automatically through a
  581. interval = REFRESH_INTERVAL * MAINW_REFRESH.
  582. ( See 4 ). Also it occurs at change as sorting ( see » 8.1.5 ) and at
  583. detection new or disconnect of the old user.
  584.  
  585.  
  586.                         8.1.5  The sorting
  587. The Program permits to sort the current users for different attributes:
  588.   1. Login
  589.   2. Interface
  590.   3. Traffic general
  591.   4. Traffic entering
  592.   5. Traffic outgoing
  593.   6. Time on-line
  594. It is for this purpose necessary to choose item of menu Users/Sort by >...
  595. Or necessary button of toolbar. Default is exhibited Sort by name.
  596.  
  597.  
  598.                         8.1.6 Write the letter to the user
  599.  
  600. This item becomes accessible, if is determined mail server (see item 4(MAIL)).
  601. If you want, that to addresses a domain was added behind, it needs to be
  602. defined in parameter MAIL.
  603. It is possible to write the letter to the chosen user. It is for this purpose
  604. necessary to choose the user and to press "Mail to user" or from the menu
  605. User/Manipulation/MailTo.
  606. There will be a window of editing. It is there possible it and to write.
  607. To send the letter on the button Send or menu: Mail/Send.
  608.  
  609.  
  610.                         8.2 The description of window UserDetail/OtherDetail
  611. The Window UserDetail actually represent the report at present about the
  612. chosen user or interface. Above the windows are displayed:
  613.         1. Login
  614.         2. Real Name
  615.         3. IP-address
  616.         4. Name of a physical device, on which there is the given user
  617. Further, in a container the detailed information on a structure of a
  618. IP-traffic of the chosen user on following attributes goes:
  619.         1. IP-address of the sender ( From )
  620.         2. IP-address of the recepient ( To )
  621.         3. General traffic in this direction
  622.         4. General packets in this direction
  623.            From them:
  624.         5. WWW  traffic
  625.         6. WWW  packages
  626.         7. FTP  traffic
  627.         8. FTP  packages
  628.         9. SMTP traffic
  629.        10. SMTP  packages
  630.        11. POP3  traffic
  631.        12. POP3  packages
  632.        13. TELNET  traffic
  633.        14. TELNET  packages
  634.        15. TCPBEUI  traffic
  635.        16. TCPBEUI  packages
  636.        17. ICMP traffic
  637.        18. ICMP  packages
  638.        19. NEWS traffic
  639.        20. NEWS  packages
  640.        21. DNS traffic
  641.        22. DNS packages
  642. I have described the main Internet-protocols. For the analysis it quite enough.
  643. Thus, it is possible to supervise ALL, that the user does.
  644.  
  645. Difference of window OtherDetail only that it displays ALL OTHER
  646. IP-addresses, not relating to given computer. So whole transit traffic.
  647. The window OtherDetail can be called only when in a file of configuration
  648. IP_ANALIZE you have specified BROADCAST or TRANSIT. If is specified only
  649. DIRECT, the opportunity to look a another's traffic will be switched - off.
  650. If to establish IP_ANALIZE in DIRECT_BROADCAST_TRANSIT, you ßan look through
  651. WHOLE IP-traffic in network, to look where users found and to be surprised,
  652. to be surprised, to be surprised...    ;)
  653.  
  654. ATTENTION!!!
  655. Because of large volume of the information in this window, it not
  656. refresh automatically.
  657. For it refreshing there is the button Refresh.
  658.  
  659.  
  660.                         8.2.1  Sorting
  661. In the window UserDetail and OtheDetail it is possible to sort the information
  662. on three criteria:
  663.         1. From IP-address
  664.         2. To IP-address
  665.         3. General traffic
  666. Sometimes it so interesting !    ;)
  667.  
  668.  
  669.                         8.2.2  Filtering
  670. In the windows UserDetail/OtherDetail it is possible to set a mask for a
  671. conclusion ONLY certain addresses ( From or To ) in a mask in quality filler
  672. one mark - "*" is used only.
  673. To me a heap of different symbols-filler does not appeal.
  674. So examples:
  675.  
  676. Question: WHICH mask to set, to look a traffic only FROM addresses
  677.         194.84.32.67 ?
  678. Answer: In the field From to write 194.84.32.67
  679.  
  680. Question: WHICH mask to set, to look a traffic only FROM addresses,
  681.         begin with 194?
  682. Answer:       In the field From to write 194. Or 194 or 194.*.*.*
  683.  
  684. Question: Which mask to set, to look a traffic only AT addresses, begin with
  685.         194 and that in the third number of address there was figure 3?
  686. Answer:       In the field To to write 194.*.*3*.*
  687.  
  688. Question: Which mask to set, to look a traffic only AT addresses, where the
  689.         address begins on 2 and that the fourth number of address began on 7?
  690. Answer:       In the field To to write 2*.*.*.7*
  691.  
  692. Question: Which mask to set, to look a traffic only AT addresses, where the
  693.         second number of address is finished on 5 and that in the fourth
  694.         number of address there was figure 3 and only From addresses, begin on
  695.         12 and in the second number of address the last two figures 67?
  696. Answer:       In the field To to write *.*5.*.*7* In the field From to
  697.         write 12*.*67 or 12*.*67.*.*
  698.  
  699. Well, there are enough examples. At last i say, that the filters influence
  700. ONLY representation in container of the window UserDetail/OtherDetail. On
  701. LOG-files, on that other it does not influence.
  702.  
  703. In a configuration a mask the on - default for all is described. But during
  704. work for each user or interface the mask varies INDIVIDUALLY. After
  705. disconnect of the user, the mask again becomes to default.
  706.  
  707. At shift of a mask, it is possible to press the button Apply or Ok. If to
  708. press Ok, the mask will be stored for the given user and by the following call
  709. UserDetail for it will be that, which you have established. If to press
  710. Apply, the mask is simple will be applied, and at Refresh or subsequent call
  711. UserDetail for the given user the previous significances will be restored.
  712.  
  713.  
  714.                         8.3 Description of a configuration window
  715. Configuration window is simple. Change the necessary parameters and, if
  716. want, push "Save" button. New configurat will be saved and old will be
  717. backed up to "*.*_BAK". New configuration will be activated when My/2 is
  718. will be restarted.
  719.  
  720. If you consider complex for you to write a configuration file
  721. manually, create empty file my.cfg in a necessary place ( see item 4 )
  722. and start my/2. After choose item File/Configure My2 and from this window
  723. establish all necessary parameters. Leave My/2. Start again. My/2
  724. will be started with are those in parameters, which you have established.
  725.  
  726.  
  727.  
  728.  
  729.                         9. The LOG-files
  730. My/2 conducts LOG-files on following statistics:
  731.         1. General traffic
  732.         2. Structured IP-traffic
  733.         3. Message, error, warning of  program is further described every kind.
  734.  
  735.  
  736.                         9.1  LOG-files of a general traffic of the user
  737.  
  738. The given LOG-files have a following format :
  739.  
  740.   1. Date and time of a entrance
  741.   2. Date and time of a exit
  742.   3. How many byte it is accepted
  743.   4. How many byte is transferred
  744.   5. Seconds on-line
  745.   6. Login of the user
  746.   7. Attribute
  747.  
  748. All this information is recorded in files with a following mask: comN.MMYYYY
  749. and Login.MMYYYY, where MM - month, YYYY - year, N - number COM-port or network
  750. card, and Login - login of the user. These two type of files cross referred the
  751. friend on the friend. You can set a certain time COMPULSORY save of statistics.
  752. For example through A HOUR. It is made that not to lose the important
  753. information in case power-off or more any failure. The program determines a new
  754. month and year, and creates appropriate files.
  755.  
  756. Attribute - 0, 1, 2 or 3
  757.         0 -             Scheduled save of statistics
  758.         1 -             Save of statistics on reset of a interface ( For
  759.                         example the user is simple was disconnected[HANGUP])
  760.         2 -             Save of statistics on a exit from the program ( For
  761.                         example you have pressed EXIT or CLOSE[Alt + F4 ])
  762.         3 -             Scheduled save has coincided a exit from the program.
  763.  
  764.  
  765.                         9.2  LOG-files of a structure of a IP-traffic of
  766.                              the user
  767.  
  768. File with structure of a IP-traffic user:
  769.   1. Date and time of a entrance
  770.   2. Date and time of a exit
  771.   3. IP-address of the sender ( From )
  772.   3. IP-address of the recepient ( To )
  773.   4. General traffic in this direction
  774.   5. General packets in this direction
  775.      From them:
  776.   6. WWW  traffic
  777.   7. WWW  packages
  778.   8. FTP  traffic
  779.   9. FTP  packages
  780.  10. SMTP  traffic
  781.  11. SMTP  packages
  782.  12. POP3  traffic
  783.  13. POP3  packages
  784.  14. TELNET  traffic
  785.  15. TELNET  packages
  786.  16. TCPBEUI  traffic
  787.  17. TCPBEUI  packages
  788.  18. ICMP  traffic
  789.  19. ICMP  packages
  790.  20. NEWS  traffic
  791.  21. NEWS  packages
  792.  22. DNS  traffic
  793.  23. DNS  packages
  794.  24. Attribute
  795.  
  796. All this information is recorded in files with a following mask:
  797. Login.MMYYYY_IP.
  798. Where MM - month, YYYY - year. This statistics is recorded by a increasing
  799. result.
  800. Description A attribute ( see item 9.1 )
  801.  
  802. This is the information can be looked at a current moment, having pressed the
  803. button User detail ( for the particular user or interface ) or OtherDetail
  804. for interfaces, not relating to given computer. ( see 8. [the Description
  805. of window UserDetail/OtherDetail ] ).
  806.  
  807.  
  808.  
  809.                         9.3        The main LOG-file of the program
  810. A main LOG-file of the program is created in CURRENT directory and has the name
  811. my.log. His contents in many respects depends from variable DEBUG_LEVEL in a
  812. configuration file. ( see 4 )
  813.  
  814.  
  815.  
  816.                         10.       Errors
  817. 1.        Not correctly works in the sanction 1024 x768 and higher.
  818.  
  819.  
  820.                         11.       Inconveniences
  821. 1.      Operating time of the programs on closing and removal of the
  822.         users is not set up.
  823.  
  824. 2.      It is impossible to set a mask for a filter on the particular user.
  825.  
  826. 3.      It is impossible to set a type of analysis LOCAL_IP whether or not
  827.         on a particular interface.
  828.  
  829. 4.      Range of configuration parameters is not supervised. That bypass it,
  830.         see item 8.3.
  831.  
  832. 5.      Does not permit to be switched on TAB between elements of a window.
  833.         The control from a keyboard is very limited.
  834.         Is simple while the hands have not reached at me.  ;)
  835.  
  836. 6.      Until works without IPSpy.DLL
  837.  
  838.  
  839.                         12. Thanks
  840. Thanks for Alexander Kitaev  ( alx@sura.com.ru ) for the help at the creation
  841.         My/2.
  842.  
  843. Especially THANK to Anddy Zinoviev ( andy@sura.com.ru ) for the help
  844.         in the understanding PM and semaphores.   ;)
  845.  
  846. Especial thanks to Steven Gutz, who wrote a book " TCP / IP programming for
  847.         OS/2 with Applications for Presentation Manager ".
  848.  
  849. Especial thank to Edgar Buerkle who make an IPSpy - an excellent driver!!!
  850.         (100566.557@compuserve.com)
  851.  
  852.  
  853.                         13. Restriction of the DEMO-version
  854. If at you the DEMO-version, exist following restrictions:
  855.         1.      The quantity of IP-addresses for the analysis and LOG-file on
  856.                 the particular user is limited up to 500. So if the user
  857.                 worked more than with 10 addresses, only the first 500 addresses
  858.                 will be displayed and only on them a LOG-file will be
  859.                 conducted. Other will be ignored with the appropriate message
  860.                 in a window ( see item 7 ).
  861.  
  862.         2.      The quantity of IP-addresses for the analysis and LOG-file on
  863.                 transit and broadcastΓαáΣ¿¬ is limited up to 1000. So if the
  864.                 users of your network worked more than with 1000 addresses, only
  865.                 the first 50 addresses will be displayed and only on them
  866.                 a LOG-file will be conducted. Other will be ignored with the
  867.                 appropriate message in a window ( see item 7 ).
  868.  
  869. All other works completely.
  870.  
  871.  
  872.  
  873.                         14. Understanding of the Virtual user
  874. Virtual user is the user ( IP-address ), which actually IS NOT PRESENT
  875. on your computer. This user has Login, Real Name, IP-address. The given
  876. kind the user is marked special icon. And has ALL properties, as well as
  877. present user. So on his statistics AS WELL AS on the usual user is going
  878. precisely such - @.
  879. For example you create the virtual user with such parameters
  880. ( see item 4 VIRTUAL_USER ):
  881.         VIRTUAL_USER IBM WWW_IBM_COM www.ibm.com
  882. After it on your computer there will be the virtual user with IP by the
  883. address www.ibm.com - 204.146.18.33. On his statistics as well as on the
  884. usual user will be going.
  885.  
  886. If you create virtual users with DNS-names in quality of
  887. IP-address, My/2 executes resolv in IP-address. It can take away some time.
  888. So, that at the start My/2, her window can will not at once occur. At
  889. this time My/2 reads CONFIG and executes resolv DNS of a name in IP address.
  890. In case of failure, My/2 removes a window with the message on a error on
  891. each record VIRTUAL_USER in a file of a configuration, which she ßould not
  892. resolv in IP address.
  893.  
  894. The virtual users it is possible to add and in a operating time of the
  895. program. Such users are valid up to following restart My/2 ( User/Virtual/Add ).
  896. The virtual user can be removed ( User/Virtual/Delete ). The removal occurs
  897. only on a current session. If want to delete the virtual user in general,
  898. take advantage of a window of a configuration.
  899.  
  900. The first time try to create virtual user from a window of a configuration.
  901. If the user is entered from a window of a configuration, he falls in a
  902. configuration file and at following restart will be restored.
  903.  
  904. ATTENTION!!!
  905. Be afraid to create the virtual users with same Login, as at the usual user !!!
  906.  
  907.  
  908.                         15. The remote users
  909.  
  910.         The remote users this those, who authority to execute any
  911. action on My/2 server remotely on TCP/IP. So from any point Internet
  912. user can go on My/2 server and to execute on it commands, determined to him
  913. in his rights. For a configuration of the remote user in a file of
  914. configuration My/2 server following parameters answer:
  915. RUN_SERVER, MAX_CLIENTS, CLIENT_REFRESH, CLIENT_TIMEOUT, CLIENT_DEBUG_LEVEL,
  916. REMOTE_USER. See item 4.
  917.         Basically for pass on My/2 server it is enough Telnet. he needs
  918. to be let so: "telnet -p PORT MY2_SERVER_ADDRESS".
  919.         In a given moment 06.02.98 I not yet have the specialized clients
  920. for My/2. But has already begun a spelling. The customers will be:
  921.                 1. Under OS/2 on CPP or Sibyl
  922.                 2. Under Windows on Delphi
  923.                 3. And on Java in the kind Applet
  924. Dialogue of the client with server is follows:
  925. ┌──────┐ ╔══════╗
  926. │Client│ ║Server║
  927. └──────┘ ╚══════╝
  928.                     ╔═══════════════════╗
  929.                     ║Hello              ║
  930.                     ╚════════╤══════════╝
  931.                              │
  932.                     ┌────────┴──────────┐
  933.                     │Authorization      │
  934.                     └────────┬──────────┘
  935.            ┌─────────────────┤
  936.            │        ╔════════┴══════════╗ NO
  937.            │        ║Authorizatino OK ? ╟────────┐
  938.            │        ╚════════╤══════════╝        │
  939.            │                 │YES                │
  940.            │        ╔════════┴══════════╗        │
  941.            │        ║Wait for commands  ║        │
  942.            │        ╚════════╤══════════╝        │
  943.            │                 │                   │
  944.            │        ┌────────┴──────────┐        │
  945.            │        │Command            │        │
  946.            │        └────────┬──────────┘        │
  947.            │                 │                   │
  948.            │        ╔════════┴══════════╗ NO     │
  949.            │        ║Authorizatino OK ? ╟────────┤
  950.            │        ╚════════╤══════════╝        │
  951.            │                 │ YES               │
  952.            │        ╔════════┴══════════╗        │
  953.            │        ║Process the command║        │
  954.            │        ╚════════╤══════════╝        │
  955.            │                 │                   │
  956.            │   NO   ╔════════┴══════════╗        │
  957.            └────────╢It is EXIT ?       ║        │
  958.                     ╚════════╤══════════╝        │
  959.                          YES ├───────────────────┘
  960.                     ╔════════┴══════════╗
  961.                     ║ Good bye          ║
  962.                     ╚═══════════════════╝
  963.  
  964.                 15.1 Return Codes from server
  965.  
  966.         200 -          The command is recognized and executed
  967.         250 -          Any information
  968.         300 -          Warning
  969.         400 -          Error or refusal to execute a command
  970.  
  971.                 15.2 Example of session
  972.  
  973. -> Send to server
  974. <- We receive
  975. --------------------------- cut here -----------------------------------
  976. <-200 Hello, 194.84.32.71 What do You want from me?
  977. ->301 alex humptydumpty
  978. <-200 ID 0 ADDRESS 194.84.32.71 REFRESH 3 RIGHTS 001002003004005006007
  979.  
  980.  
  981. ->01
  982. <-200 2
  983. <-LAN0 DIX + 802.3        10000000 194.84.32.71 CARD0 1998.02.06 14:28:36 4723583 3796803 1299 LAN interface 0
  984. <-VRT3 Virtual3           777777 195.17.106.1 Anons 1998.02.06 14:28:36 0 0 0 0 AO Anons
  985.  
  986. ->02
  987. <-400 USE: "2 LOGIN COMPORT"
  988.  
  989. ->03
  990. <-400 USE: "3 LOGIN COMPORT INTNAME IPADDRESS"
  991.  
  992. ->04
  993. <-400 USE: "4 LOGIN COMPORT INTNAME IPADDRESS"
  994.  
  995. ->05
  996. <-400 5 LOGIN COMPORT INTERFACE IPADDRESS (6 LOGIN COMPORT INTERFACE IPADDRESS)
  997.  
  998.  
  999. ->06
  1000. <-400 5 LOGIN COMPORT INTERFACE IPADDRESS (6 LOGIN COMPORT INTERFACE IPADDRESS)
  1001.  
  1002.  
  1003. ->07
  1004. <-200 CONFIG FOLLOW
  1005. <-ETCPATH "D:\MPTN\ETC
  1006. <-CFGPATH "D:\MPTN\ETC\my.cfg
  1007. <-STAT_TIMEOUT 6
  1008. <-INACTIVE_TIMEOUT 1
  1009. <-REFRESH_INTERVAL 3
  1010. <-STAT_PATH "D:\WORK_PRG\OBJ\My\BACK
  1011. <-COMUSER_PATH "D:\UUCP\PPP\CURRENT
  1012. <-PASSWD_PATH "D:\UUCP\CONFHOST\passwd
  1013. <-IPANALIZE_MODE 7
  1014. <-IPANALIZE_INTERFACE "lan0
  1015. <-SRC_MASK "*".. *. * "
  1016. <-DST_MASK "*".. *. * "
  1017. <-MAIN_WINDOW_REFRESH 10
  1018. <-PPP_TYPE 1
  1019. <-DELETE_EXEC_PGM " D:\WORK_PRG\OBJ\My\ddd.cmd %s -d "
  1020. <-DELETE_EXEC_PGM_CTRL 2
  1021. <-DELETE_EXEC_PGM_FGBG 0
  1022. <-CLOSE_EXEC_PGM " D:\WORK_PRG\OBJ\My\ccc.cmd %s -c "
  1023. <-CLOSE_EXEC_PGM_CTRL 5
  1024. <-CLOSE_EXEC_PGM_FGBG 1
  1025. <-DEBUG_LEVEL 5
  1026. <-MAIL_SERVER "194.84.32.67
  1027. <-MAIL_DOMAIN "sura.com.ru
  1028. <-PROTECTED_COM " alex alx sanek vasia     "
  1029. <-PROTECTED_USER " com2 com3 com4      "
  1030. <-VIRTUAL_USER " Anons AO_Anons 195.17.106.1 "
  1031. <-REMOTE_USER " alex qwerty 001002003004005006007 "
  1032. <-REMOTE_USER " gonza asdfghjkl1 001004005006007 "
  1033.  
  1034.  
  1035. ->02 Anons VRT3
  1036. <-400 USER "Anons" CANNOT BE DISCONNECTED
  1037.  
  1038.  
  1039. ->05 Anons VRT3 195.16.107.1
  1040. <-300 NO TRAFFIC FOUND FOR 195.16.107.1
  1041.  
  1042.  
  1043. ->05 CARD0 LAN0 194.84.32.71
  1044. <-200 4 *. *. *. * *. *. *. * 0
  1045. <-194.84.32.71 194.84.32.71 304 2 0 0 0 0
  1046. <-194.84.32.67 194.84.32.67 220 1 0 0 0 0
  1047. <-194.84.32.71 194.84.32.71 18551 395 0 0
  1048. <-194.84.32.71 194.84.32.71 484 2 0 0 0 0
  1049.  
  1050.  
  1051. ->300
  1052. <-200 Good bye 194.84.32.71
  1053. --------------------------- cut here -----------------------------------
  1054.  
  1055. I shall be grateful for all remark, questions, proposal.
  1056. ------------------------------------------------------------------------------
  1057. Alexandr A. Ivanov
  1058. Phone:          +7(8412) 55-23-67
  1059.                 +7(8412) 55-39-67
  1060. Email:          alex@sura.com.ru
  1061. home page URL:  http://penza.sura.com.ru/~alex
  1062. home page My/2: http://penza.sura.com.ru/~alex/moreos2.html
  1063. ------------------------------------------------------------------------------
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.