Leaked source code of windows server 2003
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

194 lines
5.7 KiB

  1. ;/*
  2. ; * Microsoft Confidential
  3. ; * Copyright (C) Microsoft Corporation 1991
  4. ; * All Rights Reserved.
  5. ; */
  6. SETVER Command overview
  7. MS-DOS 5.00
  8. 05/13/90
  9. SETVER is an external MS-DOS command which allows the user to
  10. determine the MS-DOS version number will be reported by MS-DOS
  11. to a specified user application. This will allow applications
  12. which check for a specific version of MS-DOS to run under
  13. MS-DOS 5.0.
  14. A version table has been included as part of the MS-DOS system
  15. files on the user's boot disk. SETVER will update the system
  16. files so that next time and times thereafter, that MS-DOS is
  17. booted, the updated version table will be in effect. NOTE: The
  18. changes to the version table will not take effect until the
  19. user reboots using the updated version of the table.
  20. NOTE:
  21. Currently there is 512 bytes set aside for entries in the
  22. table but Ericst may want to up it in the near future so
  23. for right now I wouldn't mention the number of entries
  24. which the table will hold. Right now it will hold a minimum
  25. of 34 entries.
  26. ==========================================================================
  27. USEAGE:
  28. List table: SETVER [D:]
  29. Add entry: SETVER [D:] name.ext N.NN
  30. Delete entry: SETVER [D:] name.ext /DELETE
  31. Display help SETVER /?
  32. WHERE:
  33. D: is the drive containing MSDOS.SYS
  34. name.ext is the executable file name
  35. N.NN is the major and minor version numbers
  36. /DELETE is any combination of /D - /DELETE
  37. ==========================================================================
  38. MESSAGES:
  39. If the table is being updated and there are no errors detected
  40. this message will be displayed.
  41. "Version table successfully updated"
  42. If the version table is only being displayed it will listed
  43. on the screen in the format:
  44. WIN200.BIN 3.30
  45. EXCEL.EXE 4.01
  46. MYPROG.EXE 3.20
  47. DELNODE.EXE 4.01
  48. ==========================================================================
  49. EXAMPLE 1:
  50. SETVER a: excel.exe 4.01
  51. This example will add a new entry in the table for EXCEL.EXE
  52. to the version table on drive A: and will tell DOS to always
  53. report the MS-DOS version number 4.01 to this application.
  54. EXAMPLE 2:
  55. SETVER a: excel.exe /DELETE
  56. This example will delete the EXCEL.EXE entry from the version
  57. table on drive A:.
  58. EXAMPLE 3:
  59. SETVER
  60. This example will list the contents of the version table
  61. on the current drive.
  62. EXAMPLE 4:
  63. SETVER /?
  64. This example will cause the SETVER command to display
  65. help in using the command.
  66. ==========================================================================
  67. RETURN CODES:
  68. 0 Successful completion
  69. 1 Invalid command switch
  70. 2 Invalid file name specified
  71. 3 Insuffient memory
  72. 4 Invalid version number format
  73. 5 Specified entry was not found in table
  74. 6 MS-DOS system files not found
  75. 7 Invalid drive specifier
  76. 8 Too many command line parameters
  77. 9 Missing parameters
  78. 10 Error reading MS-DOS system files
  79. 11 Version table is corrupt in system files
  80. 12 Specifed MS-DOS system files do not support a version table
  81. 13 Insuffient space in version table for new entry
  82. 14 Error writing MS-DOS system files
  83. ==========================================================================
  84. ERROR MESSAGES:
  85. ERROR: Invalid switch
  86. The user specified an invalid command line switch.
  87. ERROR: Invalid file name
  88. The user specified an invalid file name for a new
  89. version table entry. Possible causes are the specified
  90. file name did not follow standard MS-DOS file naming
  91. conventions or was a reserved MS-DOS file name
  92. ERROR: Insuffient memory
  93. There is insuffient memory for the program to run.
  94. ERROR: Invalid version number format must be 2.11 - 9.99
  95. An invalid version number was specified. Possible causes
  96. of this are that the specified version number was not in
  97. the proper format or it was less than 2.11 or greater than
  98. 9.99.
  99. ERROR: Specified entry was not found in the version table
  100. The tried to delete an entry which was not in the existing
  101. version table.
  102. ERROR: File MSDOS.SYS not found on specified drive
  103. The user specified a drive which does not contain MS-DOS
  104. system files.
  105. ERROR: Invalid drive specifier
  106. The user specified a drive that does not exist.
  107. ERROR: Too many command line parameters
  108. The user specifed too many command line parameters such as
  109. by specifing both a version number and the /DELETE switch.
  110. ERROR: Missing parameter
  111. The user entered a file name but forgot to include either
  112. a version number or the /DELETE switch.
  113. ERROR: Reading MS-DOS system file
  114. There was an error trying to read the system files on the
  115. specified drive. Possible cause is that the specified drive
  116. does not contain system files.
  117. ERROR: Version table is corrupt
  118. An error was detected in the version table and it is not
  119. useable. The user should replace the system files on that
  120. disk and try again.
  121. ERROR: System files on the specifed drive do not support a version table
  122. The user specified a drive which contains MS-DOS system files
  123. which at not version 5.0 or above.
  124. ERROR: Insuffient space in version table for new entry
  125. The version table on the specified drive is full. The user can
  126. delete some entries from the table and try again.
  127. NOTE: To be sure of room for the new entry the user should be
  128. sure that the entry that is deleted has a file name
  129. at least as long as the new entry.
  130. ERROR: Writing MS-DOS system file
  131. There was an error while trying to write the updated version
  132. version table. This would be caused by a bad disk.