home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / pgmutl / val_link.arc / VAL.HLP < prev   
Text File  |  1989-02-18  |  6KB  |  108 lines
  1. Usage:
  2. val <obj-files>,<exe-file>,<map-file>,<lib-files>
  3.  
  4. where:
  5.   <obj-files> = <ambiguous filespec> [{'+' | ' '} <ambiguous filespec>]...
  6.   <exe-file>  = <unique filespec>
  7.   <map-file>  = <unique filespec>
  8.   <lib-files> = <ambiguous filespec> [{'+'|' '} <ambiguous filespec>]...
  9.  
  10. If any of the above operands are missing, you will be prompted.  A ';' may 
  11. appear in place of a comma to take defaults for the balance of the operands.
  12.  
  13. A repsonse file may be used where ever a filespec can occur.  A response file
  14. is prefixed with a '@'.  The linker will automatically look for two response
  15. files called "VAL.ENV".  One in the directory where the linker resides and the
  16. other from the current drive/directory.  In this manner, defaults may be set.
  17. Note these files work like any response file, and carriage returns are
  18. probably not desired.
  19.  
  20. Switches, which are explained below, may appear either before or after a
  21. file specification.  A switch which immediately preceeds a file specificaion
  22. must be followed by a space.  Switch are prefixed by "/".
  23.  
  24. Press [RETURN] to continue.
  25. Switches:
  26.  
  27. Abbr       Full
  28. Name       Name        Def                    Description
  29. ---- ----------------- ------ -----------------------------------------------
  30. AH   ALignexeheader    Yes    Align EXE header to paragraph boundary
  31. BSZ  BUffersize:n      32768  Set I/O buffersize (512 - 65,024 bytes)
  32. CI   CAseignore        Yes    Linker will ignore the case of symbols
  33.      COmfile           No     Linker will to produce a .COM file
  34.      CParmaxalloc      0xFFFF Sets max paragraphs needed beyond EXE file
  35.      DEtaillevel       0      Sets the detail included in the .MAP file:
  36.                                0 - Standard link map 
  37.                                1 - Include Segment header info
  38.                                2 - Include Segment header info by module
  39.                                3 - Include data map by module
  40.                                4 - Include EXE header
  41.                                5 - Include fixup info
  42.      DOsseg            No     Use Microsoft "DOSSEG" segment ordering
  43.      EXechecksum       No     Compute checksum in .EXE header file 
  44. GHS  GRouphashsize:n   25     Hash size for group symbols (1, 1023)
  45. HLP  HElp              No     Produce this information
  46. LHS  LNamehashsize:n   25     Hash size for LNAMES symbols (1 - 1023)
  47. MP   MAp               No     Produce link map with public symbols
  48. MEX  MAXExternals:n    512    Maximum publics symbols per module (1 - 1024)
  49. MGP  MAXGroups:n       32     Maximum groups per module (1 - 1024)
  50.  
  51. Press [RETURN] to continue.
  52. Switches (continued):
  53.  
  54. Abbr       Full
  55. Name       Name        Def                    Description
  56. ---- ----------------- ------ -----------------------------------------------
  57. MLN  MAXLnames:n       512    Maximum LNAMES per module (1 - 1024)
  58. MSG  MAXSegments:n     128    Maximum segments per module (1 - 1-24)
  59. NAH  NOALignexeheader  No     Align EXE header to standard page boundary
  60. NCI  NOCAseignore      No     Linker will respect case of symbols
  61. NCO  NOCOMfile         Yes    Linker will not produce a .COM file
  62. NDO  NODOsseg          Yes    Linker will not use DOSSEG ordering
  63. NEX  NOEXechecksum     Yes    Set checksum in .EXE header file to 0
  64. NMP  NOMAp             Yes    Publics not included in link map
  65. NOB  NOOBjchecksum     Yes    Ignore checksum in .OBJ records               
  66. NPA  NOPAuse           Yes    No pause before writing executable image
  67. NSY  NOSYsfile         Yes    Linker will not produce a .SYS file
  68. NST  NOSTatistics      Yes    Linker will not give performance statistics
  69.      OBjchecksum       No     Test checksum in .OBJ records               
  70.      ORder:(text)      none   Segment ordering expression (see below)
  71.      PAuse             No     Pause before writing executable image
  72. PHS  PUblichashsize:n  525    Hash size for public symbols (1 - 1023)
  73. SHS  SEgmenthashsize:n 25     Hash size for segment (1 - 1023)
  74. STD  STACk:n           none   Insure there is a stack of at least n bytes
  75. STS  STATistics        No     Produce performance statistics for linker
  76.      SYsfile           No     Produce a .SYS file (e.g., device driver)
  77. TMP  TEmpfile:(text)  val.tmp Specifies name of linker temporary file
  78.  
  79. Press [RETURN] to continue.
  80. Segment order expressions:
  81.  
  82. <exp>     :: <term>   [{'or' |'+'|'|'} <term>  ]...
  83. <term  >  :: <factor> [{'and'|'*'|'&'} <factor>]...
  84. <factor>  :: ['!'] 
  85.          {'True'                | (always include segment)
  86.           'Talse'                | (never include segment)
  87.           'Class['  <pattern> ']'   | (inc if seg's class matches pattern)
  88.           'Group['  <pattern> ']'   | (inc if seg's group matching pattern)
  89.           'Segment['<pattern> ']'   | (inc if segment name matches pattern)
  90.           '(' <exp> ')'}
  91. <pattern> :: A pattern used to match a class, group or segment.  The pattern
  92.          may contain imbedded '?' characters which will match any single
  93.          character.  The pattern may contain a leading and/or trailing '*'
  94.          character.  If the '*' is leading, then the remaining pattern must
  95.          match the end of the class, group or segment name.  If the '*' is
  96.          trailing, then the remaining pattern must match the beginning of
  97.          the class, group or segment name.  If the '*' is both leading and
  98.          trailing, then the remaining pattern can match anywhere in the
  99.          class, group or segment name.
  100.  
  101. Press [RETURN] to continue.
  102.  
  103. Example: /DOSSEG is equivalent to:
  104.      /ORDER:(class[*code],!group[dgroup],class[begdata],
  105.          !(class[bss]|class[stack]),class[bss],class[stack])
  106.  
  107. Press [RETURN] to continue.
  108.