home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / listings / v_10_08 / ramey.exe / STEST.MAN < prev    next >
Text File  |  1991-10-06  |  2KB  |  43 lines
  1. .in 5
  2. NAME
  3.  
  4. stest - generate a file to test sort programs
  5.  
  6. SYNOPSIS
  7.  
  8. stest [-s <record size>] [ [-k <keys>] ] -n <number of records>
  9.  
  10. DESCRIPTION
  11.  
  12. stest generates a file of records to be used for testing or profiling
  13. a general purpose sort program.
  14.  
  15. .ti -4
  16. -s    if a single value is specified, use a fixed length record of
  17. the indicated number of bytes. If a range of sizes is specified,
  18. assume variable length records upto the maximum size in the range.
  19. Default is a variable length text record terminated by a newline character.
  20.  
  21. .ti -4
  22. -k    specify characters to be included in the record.
  23. Within a key specification, any number of ranges may be
  24. specified.  For example, if the sorting field will contain
  25. any combination of lower case letters, digits and spaces,
  26. use -k  ' ' '0'-'9' 'a'-'z'.
  27. Characters will appear with in a record with a frequency proportional
  28. to the number of times they appear in -k range.  For example
  29. -k 'a'-'z' '\n' '\n' -s 2-100 -n 1000 will generate a file of
  30. 1000 records with characters from 'a' to 'z' appearing with equal
  31. frequency.  Records will be approximately 14 byte long on the average
  32. since the '\n' will account for 2 out of every 28 characters in the file.
  33.  
  34. .ti -4
  35. -n indicates the number of records to be generated.  This is
  36. obligatory and may be a 32 bit number.
  37.  
  38. .ti -4
  39. <range>    a range is used to specify ranges of fields, displacements
  40. within a field and collating values.  The common syntax is
  41. <start>[-[<end>]] . <start> indicates a single value. <start>-
  42. indicates a range beginning at <start> to a large number.
  43.