home *** CD-ROM | disk | FTP | other *** search
/ TAP YIPL / TAP_and_YIPL_Collection_CD.iso / PHREAK / GENERAL / TL098.ZIP / TL-REF.DOC < prev    next >
Text File  |  1993-02-08  |  18KB  |  410 lines
  1.  
  2.                               ToneLoc v0.98
  3.  
  4.                              Reference Manual
  5.  
  6.                                    by
  7.  
  8.                         Minor Threat & Mucho Maas
  9.  
  10.      This is the reference manual.  You should read this AFTER reading
  11. TL-USER.DOC unless:
  12.  
  13.      1. You are already familiar with Toneloc, or
  14.      2. You want to get started quickly
  15.  
  16.  
  17.  ------------------------
  18.    COMMAND LINE OPTIONS
  19.  ------------------------
  20.  
  21. Here are the command line options for ToneLoc:
  22.  
  23. Toneloc  [DataFile] /M[Mask] /X[ExMask] /R[Range] /D[ExRange] /C[Config]
  24.                     /S[StartTime] /E[EndTime] /H[Hours] /Q /T[-] /K[-]
  25.  
  26.      ToneLoc must ALWAYS be run with at least one parameter, and if you
  27. only use one parameter it MUST be the dialing mask to use.  If you only
  28. give ToneLoc one parameter, the first 8 characters of the dialing mask
  29. will also be the data file name.  So if you run "TONELOC 555-XXXX", the
  30. mask will be 555-XXXX and the data file will be 555-XXXX.DAT.
  31.  
  32.      /M - Dial Mask.  Use this parameter if you want to use a data file-
  33.           name other than your dialing mask.
  34.  
  35.      /X - Exclude dial mask.  This tells ToneLoc to -NOT- dial certain
  36.           numbers.  For example, if your local Police department has
  37.           phone numbers ranging from 555-5000 to 555-5099, and you were
  38.           using the dial mask 555-XXXX, use the exclude mask 50XX. This
  39.           mask applies to the active part of the dial mask (in this case
  40.           XXXX) and therefore should be no more than 4 characters long.
  41.           If an exclusion mask is longer than 4 characters, ToneLoc will
  42.           ignore it.  Up to 9 exclude masks are allowed at once, but all
  43.           exclusions must be sub-sets of the dialing mask.
  44.  
  45.      /C - Config File.  This tells toneloc to use a config file other
  46.           than the default, TONELOC.CFG.  You may change this for different
  47.           types of scans, but you'll probably want to make different
  48.           config files for different kinds of scanning or for different
  49.           kinds of modems.  For example, you could have a config file,
  50.           TONES.CFG, that is configured to scan for tones, and another
  51.           called CARRIERS.CFG configured to scan for carriers.
  52.  
  53.      /S - StartTime.  Tells ToneLoc to wait until a certain time to begin.
  54.           You may either use military time or end the time with a "p" for
  55.           P.M.  Example:  5:30p and 17:30 are the same.
  56.  
  57.      /E - EndTime.  Tells ToneLoc to STOP dialing at a certain time.  Use
  58.           the same notation as the /S parameter above.
  59.  
  60.      /H - Hours.  Tells ToneLoc to dial for a certain number of hours
  61.           after starting, and then exit.  "/H5:30" would mean 5 hours,
  62.           30 minutes.
  63.  
  64.      /Q - Quiet.  Tells Toneloc to suppress ALL sound.  The speaker
  65.           and all sounds will be turned off.
  66.  
  67.      /T - Sets the scan mode to look for tones, overriding whatever is
  68.           specified in the config file.  /T- will look for everything
  69.           _except_ tones.
  70.  
  71.      /K - Sets the scan mode to look for carriers, overriding whatever is
  72.           specified in the config file.  /K- will look for everything
  73.           _except_ carriers.
  74.  
  75.      These parameters may appear in any order, EXCEPT the first parameter
  76. MUST always be the datafile, and if you do not specify a dial mask with
  77. /M it MUST ALSO be the mask.
  78.  
  79.  -----------------
  80.    WHILE DIALING
  81.  -----------------
  82.  
  83.      While ToneLoc is scanning, there are several keys that do various
  84. things.  Here they are:
  85.  
  86.      A - Blanks the screen totally black, and turns off the cursor.
  87.          Press 'A' again to unblank it.
  88.  
  89.      B - Blanks the screen, but instead of making it black, it loads
  90.          the optional Alternate Screen file set in the config file.
  91.          Preess 'B' again to unblank it.
  92.  
  93.      C - Logs the current number as a "Carrier".  Say you're scanning
  94.          for tones, but you hear a carrier, you can press 'C'.
  95.  
  96.      F - Logs the current number as a "Fax".  Useful for when you
  97.          hear a fax machine while scanning.  A fax machine sounds like
  98.          a 300 baud modem underwater.
  99.  
  100.      G - Logs the current number as a "Girl".  Useful if you hear
  101.          a really cute-sounding babe saying "Hello? HELLO? <click>".
  102.  
  103.      J - Pressing 'J' will Jump to a DOS shell.  Upon returning,
  104.          ToneLoc will redial the last number.
  105.  
  106.      K - Allows you to enter a custom note for the current number.
  107.  
  108.      N - This will "Note" the current number by putting a special entry
  109.          in the logfile.  It looks like this: "* Noted *".  Use this if
  110.          you want to remember this number for later.
  111.  
  112.      P - Pauses scanning until another key is hit.
  113.  
  114.      Q - Quits scanning and exits AFTER the current dial is finished.
  115.  
  116.      R - Redials the current number.
  117.  
  118.      S - This toggles the modem speaker ON or OFF while dialing, but
  119.          ToneLoc will wait until the current dial is completed before
  120.          toggling the speaker.  If you press 'S' again before the
  121.          speaker is toggled, the speaker won't be toggled.
  122.  
  123.      T - Logs the current number as a "Tone".  Say you're scanning for
  124.          carriers, but you hear a PBX dialtone, you can press 'T'.
  125.  
  126.      V - Logs the current number as a "VMB", in case you hear a VMB
  127.          system during a scan.
  128.  
  129.      X - This will extend the current dial time by 5 seconds.  The
  130.          meter will reflect the time addition.
  131.  
  132.      Y - Logs the current number as a "Yelling Asshole".  Useful if you
  133.          hear some dick yelling "I KNOW ABOUT YOU HACKERS AND YOUR
  134.          2500 BAUD MODEMS!"
  135.  
  136.      0-9 - These are the modem volume changing keys.  They will send
  137.          the corresponding string in the config file to the modem.  They
  138.          work like <S>peaker toggle.
  139.  
  140.      [Spacebar] - Aborts the current number and goes on to the next one.
  141.  
  142.      [Escape] - Pressing Escape will abort the current dial and
  143.          exit ToneLoc.
  144.  
  145.  ----------------------
  146.    CONFIGURATION FILE
  147.  ----------------------
  148.  
  149.      ToneLoc uses a configuration file.  Before running ToneLoc, you
  150. need to edit this config file for your setup.  The config file has a
  151. little bit of help in it, so its mostly self-explanatory.  But just
  152. in case, here's an explanation of each keyword in the configuration file.
  153.  
  154.      Fossil - This tells toneloc to use the FOSSIL modem routines, which
  155.             require an external FOSSIL driver, like BNU, to be loaded.
  156.             You should only use this if the built-in SERIAL routines don't
  157.             work.
  158.  
  159.      Serial - This tells toneloc to use the fast, built-in modem routines.
  160.             If you use these, no external FOSSIL is requied.
  161.  
  162.      Port - This is which COM port to use.  ToneLoc has been tested
  163.             on COM1 - COM4 successfully.  It should, theoretically,
  164.             work up to COM8.  If you use COM5 or above, you need to
  165.             specify an IRQ and base port address (below).
  166.  
  167.      IRQ -  If you're using COM5 or above, or if your comport's IRQ
  168.             is non-standard, you need to specify this.  (see below)
  169.  
  170.      IOAddx - If your comport's base I/O address is non-standard, or
  171.             if you are using COM5 or above, need to specify the base
  172.             I/O address.  Usually they are as follows:
  173.  
  174.                PORT    ADDRESS     IRQ
  175.                ----    -------     ---
  176.                COM1      3F8        4
  177.                COM2      2F8        3
  178.                COM3      3E8        4
  179.                COM4      2E8        3
  180.  
  181.      Baud - This is the baud rate at which ToneLoc communicates with the
  182.             modem.  For a USRobotics HST or Dual Standard, it should be
  183.             set as high as the modem can handle (38400 or 57600).  If you
  184.             are losing characters on a high speed modem, try lowering
  185.             this to 19200 or 9600.
  186.  
  187.      Speaker - This tells if the modem speaker should start ON or OFF.
  188.             The number 0 (off) or 1 (on) should follow "Speaker".  You may
  189.             toggle the speaker while dialing by pressing 'S'.
  190.  
  191.      FoundSound - ToneLoc can make a noise when it finds a tone or carrier,
  192.             if you want this enabled set it to 1, otherwise set it to 0.
  193.  
  194.      Sound - ToneLoc can makes noises for speaker toggles and volume
  195.             changes. If you want to hear these sounds, set this to 1.
  196.  
  197.      InitString - This is the string that is sent to the modem when
  198.             ToneLoc is first run.  Usually this is ATZ|.  You may need to
  199.             send other parameters like X7, &N1, etc.  The following special
  200.             characters are used:
  201.  
  202.               ~ - pause for 1/2 second
  203.               | - send [Enter] to modem
  204.               < - drop DTR (don't forget to raise it)
  205.               > - raise DTR
  206.               ! - drop DTR for 1/4 second, and raise it
  207.  
  208.             These special characters are used with all modem commands.
  209.  
  210.      InitResponse - ToneLoc checks for this after initializing the modem.
  211.             If the modem doesn't send this back, toneloc will try to
  212.             initialize the modem up to 3 times.  If it doesn't work,
  213.             ToneLoc exits.
  214.  
  215.      DialString - This is the string to dial the modem.  Usually "ATDT".
  216.             If you need to dial *70 to disable call waiting, for example,
  217.             add it here like "ATDT*70".  Or if you need to dial "9" first,
  218.             put it here.
  219.  
  220.      DialSuffix - This is the string to append to the DialString AFTER
  221.             the phone number.  Sometimes, adding a comma after the number
  222.             will help to avoid false VOICE detection on a 1AESS switch.
  223.             (The post-dial click may be detected as a VOICE).
  224.  
  225.      SpeakOn - String to send to the modem that turns the speaker ON.
  226.             Usually "ATM1|" or "ATM3|".
  227.  
  228.      SpeakOff - Same as above, but to turn the speaker off.  Usually "ATM0|"
  229.  
  230.      Volume0-Volume9 - Strings that adjust the volume of the modem while
  231.             dialing.  Press '0' - '9' while dialing to adjust the modem
  232.             volume.  You could also use these as other macros besides
  233.             volume.
  234.  
  235.      HangUp - String that tells the modem to hang up during a dial
  236.             attempt.  Usually "ATH0|"
  237.  
  238.      CarrierHangup - String to hang up the modem when connected to another
  239.             modem.  Usually a quick DTR drop '!' will work.  If not, try
  240.             adding "&C1&D2" to your init string.  If that doesn't work,
  241.             try a longer DTR drop, like "<~~~>".  Finally, if that doesn't
  242.             work, try "~~~+++~~~ATH0|", but beware -- this is slow.
  243.  
  244.      ToneHangup - String to hang up the modem after it finds a tone.
  245.             Some modems require "ATH0|" rather than just a simple DTR
  246.             drop.
  247.  
  248.      LogFile - File that toneloc logs it's activity to.  Usually TONE.LOG
  249.  
  250.      CommandDelay - Number of milliseconds to pause after sending a
  251.             command to the modem.  Usually about 150.
  252.  
  253.      BetweenDelay - Number of milliseconds to pause between dial attempts.
  254.             If you have 3-way calling, or a slow switch, you'll need to
  255.             set this to a higher number.
  256.  
  257.      BetweenWipe - How to 'wipe' the meter between calls.  Cosmetic.
  258.             1 = Ends to Middle
  259.             2 = Middle to Ends
  260.             3 = Backwards
  261.             4 = Double right
  262.             5 = Triple right
  263.             6 = No wipe
  264.  
  265.      WaitDelay - How many milliseconds to wait for a carrier or tone
  266.             before hanging up and trying the next number.  Usually, for
  267.             tones you'll want 15000-20000 (15-20 seconds).  For carriers,
  268.             20000-30000 (20-30 seconds).
  269.  
  270.      NoDupes - This tells toneloc to keep a .DAT file to avoid dialing
  271.             the same number twice, in case you abort in the middle of a
  272.             scan and continue later. Recommended.
  273.  
  274.      MaxRing - If your modem reports RINGING, you can set this to abort
  275.             the call after X number of rings.  Since most PBX's answer
  276.             after 1 ring, and most carriers after 2 or 3 rings max, this
  277.             can speed up the scan.  Set this to 0 to disable it.
  278.  
  279.      ScanType - Tells ToneLoc what to scan for:
  280.  
  281.                0 = Tones
  282.                1 = Carriers
  283.                2 = Everything except tones
  284.                3 = Everything except carriers
  285.  
  286.             If you're wondering why the hell you'd want to scan for
  287.             everything EXCEPT tones or carriers, see the section in
  288.             TL-USER.DOC explaining this.
  289.  
  290.      IgnoreCD - If your modem always sets Carrier Detect (CD) as TRUE,
  291.             or if your modem is reporting false carriers to toneloc,
  292.             turn this on.  Otherwise, turn it off.
  293.  
  294.      IgnoreCTS - ToneLoc checks for CTS at startup to make sure the
  295.             modem is on and ready.  If ToneLoc always says the CTS
  296.             signal isn't there, but your modem is actually on and ready,
  297.             turn IgnoreCTS on.  This will also disable periodic checks
  298.             toneloc performs to make sure the modem hasn't been turned
  299.             off during the scan.  (what a lame thing to do)
  300.  
  301.      IgnoreUnknown - IgnoreUnknown tells toneloc to ignore modem
  302.             responses that are not recognized by toneloc.  If your modem
  303.             sends strange messages like "DIALING ...", turn this on.
  304.  
  305.      AutoSave - This is how often ToneLoc should do a backup of the .DAT
  306.             file and the LOG file.  Set this to 0 to disable it.
  307.  
  308.      BlackList - This tells ToneLoc the name of your BlackList file.  The
  309.             BlackList file is a file of phone numbers to never dial.  For
  310.             an example, see the file BLACK.LST.
  311.  
  312.      Random/Forward/Backward - ToneLoc's default mode is to dial numbers
  313.             randomly without duplication, but it can also dial forwards
  314.             and backwards sequentially. Set this to the keyword you want.
  315.  
  316.      Logging - This tells ToneLoc if it should log activity to a file.
  317.  
  318.      NoToneAbort - If your line dies, and you get "NO DIALTONE" too many
  319.             times in a row, ToneLoc will abort.  This sets the limit
  320.             of how many "NO DIALTONE"s toneloc will allow before quitting.
  321.  
  322.      GetDelay - This tells ToneLoc how many milliseconds to allow for the
  323.             modem send its responses.  Usually this is about 250, however,
  324.             if you are using a slow modem (300 or 1200 baud), it may need
  325.             to be raised to 400 or so.  If you're using a high speed modem
  326.             (38400+ bps), it may be set lower, but setting it lower doesn't
  327.             increase performance significantly.  If your modem's responses
  328.             are getting cut off, like "RIN" instead of "RINGING", or
  329.             "CONNE" instead of "CONNECT", you probably need to raise this
  330.             number a bit.
  331.  
  332.      SlowModem - SlowModem - Some modems MAY require a delay between
  333.             characters sent by ToneLoc.  This specifies how many
  334.             milliseconds to pause between each character sent.  This
  335.             should be small (0 - 25 milliseconds).
  336.  
  337.      FoundFile - This is the name of the file where ToneLoc should store
  338.             the found numbers (tones or carriers.)
  339.  
  340.      AltScreen - When you press 'B' while scanning, ToneLoc will blank
  341.             the screen and load this binary file onto the screen.  There
  342.             are a few sample .BIN files that come with ToneLoc.  This is
  343.             useful for a "parent" screen.  If you want to create your own,
  344.             use TheDraw, and save the file in <B>inary mode.
  345.  
  346.      FlogString - When ToneLoc finds a tone or carrier, it is logged
  347.             to the Found File (usually FOUND.LOG).  With FlogString, you
  348.             can customize the string that is written to the Found File.
  349.             Here are the symbols:
  350.  
  351.                %d = Date
  352.                %t = Time
  353.                %n = Number
  354.                %b = Brief result (T, C, NT, NC)
  355.                %l = Long result (Tone, Carrier, No Tone, No Carrier)
  356.                %r = Response from modem (i.e: "CONNECT 9600/ARQ")
  357.  
  358.             For example, "FlogString %n: %b, %r" would be logged like this:
  359.  
  360.                486-1993: C, CONNECT 2400/NONE
  361.  
  362.  
  363.  -----------------
  364.    DESQview INFO
  365.  -----------------
  366.  
  367.      ToneLoc runs most excellently under DESQview.  It will detect
  368. DESQview, and if DESQview is found, screen writes are directed to the
  369. screen buffer so your screen isn't trashed.  ToneLoc also releases
  370. unneeded timeslices to DESQview.  Because of this, ToneLoc uses VERY
  371. LITTLE CPU time, so you can run it in background with minimal slowdown.
  372. I tested ToneLoc with two windows open.  One was a DOS window sitting
  373. at the prompt idle (doing nothing).  The other was ToneLoc scanning.
  374. ToneLoc used about 10% of the CPU time, and the idle DOS window used
  375. about 88% (with about 2% DESQview overhead).
  376.      The file "TL-PIF.DVP" is included with ToneLoc.  To add ToneLoc
  377. to your DESQview setup, do the following:
  378.  
  379.      1. Run DESQview
  380.      2. Choose "Add a Program"
  381.      3. Type 'O' for other
  382.      4. Enter the path where ToneLoc is found
  383.      5. Move the cursor bar to "ToneLoc" and hit [Space Bar]
  384.      6. Press [Enter].
  385.  
  386. ToneLoc will be added to the list of applications on your DESQview menu.
  387. To run ToneLoc, choose "TL" from the application menu.  You will be placed
  388. at the DOS prompt with "ToneLoc " already typed.  Just finish the command
  389. line and press enter.
  390.  
  391.  ---------------
  392.    FOSSIL INFO
  393.  ---------------
  394.  
  395.      ToneLoc no longer requires a FOSSIL driver.  However, if the built-in
  396. SERIAL routines don't work, or you are using a very strange COMport, like
  397. COM16 or something, you may need to use the FOSSIL routines.  The FOSSIL
  398. routines aren't any less reliable or slower, but the FOSSIL routines
  399. require an external FOSSIL driver program to be loaded.  The two most
  400. popular FOSSIL drivers are X00 and BNU.  Just call your local PD board
  401. and search for "FOSSIL", "BNU", or "X00".  ToneLoc works with both.
  402.  
  403. --------------------------------------------------------------------------
  404.  
  405. If this doc file sucks, please us know how to improve it.
  406.  
  407.  -- Minor Threat
  408.  -- Mucho Maas
  409.  
  410.