home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 592b.lha / XTime_v1.0 / XTime.doc < prev    next >
Encoding:
Text File  |  1992-01-06  |  4.9 KB  |  125 lines
  1. XTime v. 1.10
  2. Copyright November 1991
  3. Kurt R. Krueger and the Sirius Cybernetics Corp.
  4.  
  5.  
  6. WHAT IS IT?
  7.  
  8. XTime (pron. "Transtime") is a program I wrote while teaching myself C.
  9. XTime calculates the amount of time a file transfer will take.  This can be
  10. useful if you want to know how long a transfer will take before you actually
  11. send a file (or before you receive it).
  12.  
  13. XTime operates in two modes: file and byte.  In the first mode, you give it
  14. a file name, and it will search out the file and calculate how long it will
  15. take to send it.  XTime uses UNIX-style wildcards: *, ?, [^, and \.
  16.  
  17. Byte mode was the only mode used in the last version.  You simply put a number
  18. after XTime, and the transfer time is calculated.  How do you switch between
  19. modes?  Fortunately, XTime automagically figures out which mode you want, so
  20. you don't have to worry.  There is, of course, a way to trick XTime.  Suppose
  21. you have a text file that has the lyrics to Yes' 90125 album, and the file
  22. name is 90125.  If you type "XTime 90125", XTime will think you have a file
  23. that is 90,125 bytes long.  You can get around this in at least two ways.
  24. Either use the -f option to force file mode, or type "XTime 9012?".  As you
  25. can see, the chances of XTime being tricked are quite slim.
  26.  
  27. Syntax: XTime [-k] [-r<cps>] [-f] <[file size in bytes] or [filename]>
  28.  
  29. [] means "optional"
  30. <> means "manditory"
  31.  
  32. Thus, [-r<cps>] means that if you are going to use the -r option, then you
  33. must put a number after it.  It won't guru or anything, but your transfer
  34. rate won't get changed, either.
  35.  
  36. There are only three parameters:
  37.  
  38. -f: Force XTime to only operate in file mode.  I can't think of one time that
  39.     this would be necessary, but that does not mean that a situation doesn't
  40.     exist.  It is always preferable to allow the user to choose, not the
  41.     computer.
  42.  
  43. -k: Size is in bytes.  Thus, instead of typing "100000" for 100K, just type
  44.     "100".  This option is automatically turned off in file mode.
  45.  
  46. -r: Change default transfer rate of 232 characters per second.  For example,
  47.     if you typically have a rate of 240, type "-r240".  Hint: Do not trust
  48.     the rate that terminal programs give as they are sometimes wrong.
  49.  
  50.  
  51. HOW DO I INSTALL IT?
  52.  
  53. There are no special installation instructions.  You might want to set it up
  54. as an alias to simplify things, though.  For example, if you typically have
  55. rates of 240 cps and you prefer the -k option, you might want to do this:
  56.  
  57. Amiga: alias xtime c:xtime -r240 -k []
  58. VMS:   XTIME :== $SYS$LOGIN:XTIME -R240 -K
  59.  
  60.  
  61. SUGGESTIONS
  62.  
  63. Please write me.  (Note that if you tried in the past I inadvertently left
  64. out part of my Internet address, so your mail no doubt bounced.)
  65.  
  66. Kurt R. Krueger
  67. Internet: kkrueger@zeus.unomaha.edu
  68. BITNET  : kkrueger@unoma1
  69.  
  70. Please don't complain about the program's elegance or lack thereof if you are
  71. a C guru.  What do I know about structure? ;)
  72.  
  73. If you are using a VMS VAX, I would strongly suggest that you use SZ Shell for
  74. all of your Z-Modem transfers.  This is not so much because of the program's
  75. many features and the ease of use it adds to SZ, but because I wrote it.  You
  76. can obtain this program from ab20.larc.nasa.gov. in the incoming/vms
  77. subdirectory or by writing me.
  78.  
  79. PROBLEMS:
  80.  
  81. If you're sending a big batch of files, then there is about a second of delay
  82. in between transfers.  XTime assumes it's instantaneous, however.  With the
  83. modular fashion in which I wrote the program, fixing this nuissance would be
  84. a pain, but I will get around to it in the next version.  At any rate, the
  85. amount of error is really small.
  86. --
  87.  
  88. There is a small bug I can't fix.  If you cd to a directory and have a file
  89. in the directory above it that is 29-30 characters long, and you type this:
  90.  
  91. XTime /this_is_a_really_long_filename
  92.  
  93. You will get a "No files matched." error.  Obviously, the odds of your running
  94. into this in normal, everyday life are slimmer than the chances of my being
  95. featured on CNN for writing XTime.  Panu Hassi suggested a fix, but it didn't
  96. work.  Nonetheless, I'll track it down just for the sake of completeness.  As
  97. always, there is a way around the problem.  This works:
  98.  
  99. XTime /this_is_a_really_long_filena*
  100.  
  101. Also, you can cd to the directory it's in and type:
  102.  
  103. XTime this_is_a_really_long_filename
  104.  
  105. --
  106.  
  107. XTime works over a relevant range.  By that, I mean if you put in a value so
  108. large that the total transfer time is greater than about 546 hours, then you
  109. can expect nonsensical results.  By the way, that's 456.130 megabytes of data
  110. at 2400 bps.  I don't consider this to be a bug, but I thought it was worth a
  111. mention.  The last version of XTime was much less tolerant.  After around
  112. eight hours, the results would be nonsense.
  113.  
  114.  
  115. ACKNOWLEDGEMENTS:
  116.  
  117. -- Rich Salz, for writing Wildmat, the wildcard-matching utility.  I had to
  118.    enhance it, but it made a good skeleton.
  119.  
  120. -- Abacus, for giving me a short program for handling the DOS.
  121.  
  122. -- Panu Hassi, for beta testing this and providing some debugging help.
  123.    He must have really put it through the wringer because he found the path
  124.    bug.
  125.