2 * CMD - Wine-compatible command line interface - built-in functions.
4 * Copyright (C) 1999 D A Pickles
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 * On entry to each function, global variables quals, param1, param2 contain
24 * the qualifiers (uppercased and concatenated) and parameters entered, with
25 * environment-variable and batch parameter substitution already done.
30 * - No support for pipes, shell parameters
31 * - Lots of functionality missing from builtins
32 * - Messages etc need international support
35 #define WIN32_LEAN_AND_MEAN
39 #include "wine/debug.h"
41 WINE_DEFAULT_DEBUG_CHANNEL(cmd);
43 void WCMD_execute (char *orig_command, char *parameter, char *substitution);
45 struct env_stack *saved_environment;
46 struct env_stack *pushd_directories;
48 extern HINSTANCE hinst;
49 extern char *inbuilt[];
50 extern int echo_mode, verify_mode, defaultColor;
51 extern char quals[MAX_PATH], param1[MAX_PATH], param2[MAX_PATH];
52 extern BATCH_CONTEXT *context;
53 extern DWORD errorlevel;
57 /****************************************************************************
60 * Clear the terminal screen.
63 void WCMD_clear_screen (void) {
65 /* Emulate by filling the screen from the top left to bottom right with
66 spaces, then moving the cursor to the top left afterwards */
67 CONSOLE_SCREEN_BUFFER_INFO consoleInfo;
68 HANDLE hStdOut = GetStdHandle(STD_OUTPUT_HANDLE);
70 if (GetConsoleScreenBufferInfo(hStdOut, &consoleInfo))
75 screenSize = consoleInfo.dwSize.X * (consoleInfo.dwSize.Y + 1);
79 FillConsoleOutputCharacter(hStdOut, ' ', screenSize, topLeft, &screenSize);
80 SetConsoleCursorPosition(hStdOut, topLeft);
84 /****************************************************************************
87 * Change the default i/o device (ie redirect STDin/STDout).
90 void WCMD_change_tty (void) {
96 /****************************************************************************
99 * Copy a file or wildcarded set.
100 * FIXME: No wildcard support
103 void WCMD_copy (void) {
109 static const char overwrite[] = "Overwrite file (Y/N)?";
110 char string[8], outpath[MAX_PATH], inpath[MAX_PATH], *infile, copycmd[3];
113 if (param1[0] == 0x00) {
114 WCMD_output ("Argument missing\n");
118 if ((strchr(param1,'*') != NULL) && (strchr(param1,'%') != NULL)) {
119 WCMD_output ("Wildcards not yet supported\n");
123 /* If no destination supplied, assume current directory */
124 if (param2[0] == 0x00) {
128 GetFullPathName (param2, sizeof(outpath), outpath, NULL);
129 if (outpath[strlen(outpath) - 1] == '\\')
130 outpath[strlen(outpath) - 1] = '\0';
131 hff = FindFirstFile (outpath, &fd);
132 if (hff != INVALID_HANDLE_VALUE) {
133 if (fd.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
134 GetFullPathName (param1, sizeof(inpath), inpath, &infile);
135 strcat (outpath, "\\");
136 strcat (outpath, infile);
141 /* /-Y has the highest priority, then /Y and finally the COPYCMD env. variable */
142 if (strstr (quals, "/-Y"))
144 else if (strstr (quals, "/Y"))
147 len = GetEnvironmentVariable ("COPYCMD", copycmd, sizeof(copycmd));
148 force = (len && len < sizeof(copycmd) && ! lstrcmpi (copycmd, "/Y"));
152 hff = FindFirstFile (outpath, &fd);
153 if (hff != INVALID_HANDLE_VALUE) {
155 WCMD_output (overwrite);
156 ReadFile (GetStdHandle(STD_INPUT_HANDLE), string, sizeof(string), &count, NULL);
157 if (toupper(string[0]) == 'Y') force = TRUE;
162 status = CopyFile (param1, outpath, FALSE);
163 if (!status) WCMD_print_error ();
167 /****************************************************************************
170 * Create a directory.
172 * this works recursivly. so mkdir dir1\dir2\dir3 will create dir1 and dir2 if
173 * they do not already exist.
176 static BOOL create_full_path(CHAR* path)
182 new_path = HeapAlloc(GetProcessHeap(),0,strlen(path)+1);
183 strcpy(new_path,path);
185 while ((len = strlen(new_path)) && new_path[len - 1] == '\\')
186 new_path[len - 1] = 0;
188 while (!CreateDirectory(new_path,NULL))
191 DWORD last_error = GetLastError();
192 if (last_error == ERROR_ALREADY_EXISTS)
195 if (last_error != ERROR_PATH_NOT_FOUND)
201 if (!(slash = strrchr(new_path,'\\')) && ! (slash = strrchr(new_path,'/')))
207 len = slash - new_path;
209 if (!create_full_path(new_path))
214 new_path[len] = '\\';
216 HeapFree(GetProcessHeap(),0,new_path);
220 void WCMD_create_dir (void) {
222 if (param1[0] == 0x00) {
223 WCMD_output ("Argument missing\n");
226 if (!create_full_path(param1)) WCMD_print_error ();
229 /****************************************************************************
232 * Delete a file or wildcarded set.
235 * - Testing shows /A is repeatable, eg. /a-r /ar matches all files
236 * - Each set is a pattern, eg /ahr /as-r means
237 * readonly+hidden OR nonreadonly system files
238 * - The '-' applies to a single field, ie /a:-hr means read only
242 void WCMD_delete (char *command) {
245 int argsProcessed = 0;
246 char *argN = command;
248 /* Loop through all args */
250 char *thisArg = WCMD_parameter (command, argno++, &argN);
251 if (argN && argN[0] != '/') {
255 char fpath[MAX_PATH];
259 WINE_TRACE("del: Processing arg %s (quals:%s)\n", thisArg, quals);
262 /* If filename part of parameter is * or *.*, prompt unless
264 if ((strstr (quals, "/Q") == NULL) && (strstr (quals, "/P") == NULL)) {
268 char fname[MAX_PATH];
271 /* Convert path into actual directory spec */
272 GetFullPathName (thisArg, sizeof(fpath), fpath, NULL);
273 WCMD_splitpath(fpath, drive, dir, fname, ext);
275 /* Only prompt for * and *.*, not *a, a*, *.a* etc */
276 if ((strcmp(fname, "*") == 0) &&
277 (*ext == 0x00 || (strcmp(ext, ".*") == 0))) {
279 char question[MAXSTRING];
281 /* Ask for confirmation */
282 sprintf(question, "%s, ", fpath);
283 ok = WCMD_ask_confirm(question, TRUE);
285 /* Abort if answer is 'N' */
290 hff = FindFirstFile (thisArg, &fd);
291 if (hff == INVALID_HANDLE_VALUE) {
292 WCMD_output ("%s :File Not Found\n", thisArg);
295 /* Support del <dirname> by just deleting all files dirname\* */
296 if ((strchr(thisArg,'*') == NULL) && (strchr(thisArg,'?') == NULL)
297 && (fd.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)) {
298 char modifiedParm[MAX_PATH];
299 strcpy(modifiedParm, thisArg);
300 strcat(modifiedParm, "\\*");
302 WCMD_delete(modifiedParm);
307 /* Build the filename to delete as <supplied directory>\<findfirst filename> */
308 strcpy (fpath, thisArg);
310 p = strrchr (fpath, '\\');
313 strcat (fpath, fd.cFileName);
315 else strcpy (fpath, fd.cFileName);
316 if (!(fd.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)) {
318 char *nextA = strstr (quals, "/A");
320 /* Handle attribute matching (/A) */
323 while (nextA != NULL && !ok) {
325 char *thisA = (nextA+2);
328 /* Skip optional : */
329 if (*thisA == ':') thisA++;
331 /* Parse each of the /A[:]xxx in turn */
332 while (*thisA && *thisA != '/') {
334 BOOL attribute = FALSE;
336 /* Match negation of attribute first */
342 /* Match attribute */
344 case 'R': attribute = (fd.dwFileAttributes & FILE_ATTRIBUTE_READONLY);
346 case 'H': attribute = (fd.dwFileAttributes & FILE_ATTRIBUTE_HIDDEN);
348 case 'S': attribute = (fd.dwFileAttributes & FILE_ATTRIBUTE_SYSTEM);
350 case 'A': attribute = (fd.dwFileAttributes & FILE_ATTRIBUTE_ARCHIVE);
353 WCMD_output ("Syntax error\n");
356 /* Now check result, keeping a running boolean about whether it
357 matches all parsed attribues so far */
358 if (attribute && !negate) {
360 } else if (!attribute && negate) {
368 /* Save the running total as the final result */
371 /* Step on to next /A set */
372 nextA = strstr (nextA+1, "/A");
376 /* /P means prompt for each file */
377 if (ok && strstr (quals, "/P") != NULL) {
378 char question[MAXSTRING];
380 /* Ask for confirmation */
381 sprintf(question, "%s, Delete", fpath);
382 ok = WCMD_ask_confirm(question, FALSE);
385 /* Only proceed if ok to */
388 /* If file is read only, and /F supplied, delete it */
389 if (fd.dwFileAttributes & FILE_ATTRIBUTE_READONLY &&
390 strstr (quals, "/F") != NULL) {
391 SetFileAttributes(fpath, fd.dwFileAttributes & ~FILE_ATTRIBUTE_READONLY);
394 /* Now do the delete */
395 if (!DeleteFile (fpath)) WCMD_print_error ();
399 } while (FindNextFile(hff, &fd) != 0);
405 /* Handle no valid args */
406 if (argsProcessed == 0) {
407 WCMD_output ("Argument missing\n");
412 /****************************************************************************
415 * Echo input to the screen (or not). We don't try to emulate the bugs
416 * in DOS (try typing "ECHO ON AGAIN" for an example).
419 void WCMD_echo (const char *command) {
421 static const char eon[] = "Echo is ON\n", eoff[] = "Echo is OFF\n";
424 if ((command[0] == '.') && (command[1] == 0)) {
425 WCMD_output (newline);
430 count = strlen(command);
432 if (echo_mode) WCMD_output (eon);
433 else WCMD_output (eoff);
436 if (lstrcmpi(command, "ON") == 0) {
440 if (lstrcmpi(command, "OFF") == 0) {
444 WCMD_output_asis (command);
445 WCMD_output (newline);
449 /**************************************************************************
452 * Batch file loop processing.
453 * FIXME: We don't exhaustively check syntax. Any command which works in MessDOS
454 * will probably work here, but the reverse is not necessarily the case...
457 void WCMD_for (char *p) {
462 char set[MAX_PATH], param[MAX_PATH];
465 if (lstrcmpi (WCMD_parameter (p, 1, NULL), "in")
466 || lstrcmpi (WCMD_parameter (p, 3, NULL), "do")
467 || (param1[0] != '%')) {
468 WCMD_output ("Syntax error\n");
471 lstrcpyn (set, WCMD_parameter (p, 2, NULL), sizeof(set));
472 WCMD_parameter (p, 4, &cmd);
473 lstrcpy (param, param1);
476 * If the parameter within the set has a wildcard then search for matching files
477 * otherwise do a literal substitution.
481 while (*(item = WCMD_parameter (set, i, NULL))) {
482 if (strpbrk (item, "*?")) {
483 hff = FindFirstFile (item, &fd);
484 if (hff == INVALID_HANDLE_VALUE) {
488 WCMD_execute (cmd, param, fd.cFileName);
489 } while (FindNextFile(hff, &fd) != 0);
493 WCMD_execute (cmd, param, item);
499 /*****************************************************************************
502 * Execute a command after substituting variable text for the supplied parameter
505 void WCMD_execute (char *orig_cmd, char *param, char *subst) {
507 char *new_cmd, *p, *s, *dup;
510 size = lstrlen (orig_cmd);
511 new_cmd = (char *) LocalAlloc (LMEM_FIXED | LMEM_ZEROINIT, size);
512 dup = s = strdup (orig_cmd);
514 while ((p = strstr (s, param))) {
516 size += lstrlen (subst);
517 new_cmd = (char *) LocalReAlloc ((HANDLE)new_cmd, size, 0);
519 strcat (new_cmd, subst);
520 s = p + lstrlen (param);
523 WCMD_process_command (new_cmd);
525 LocalFree ((HANDLE)new_cmd);
529 /**************************************************************************
532 * Simple on-line help. Help text is stored in the resource file.
535 void WCMD_give_help (char *command) {
540 command = WCMD_strtrim_leading_spaces(command);
541 if (lstrlen(command) == 0) {
542 LoadString (hinst, 1000, buffer, sizeof(buffer));
543 WCMD_output_asis (buffer);
546 for (i=0; i<=WCMD_EXIT; i++) {
547 if (CompareString (LOCALE_USER_DEFAULT, NORM_IGNORECASE | SORT_STRINGSORT,
548 param1, -1, inbuilt[i], -1) == 2) {
549 LoadString (hinst, i, buffer, sizeof(buffer));
550 WCMD_output_asis (buffer);
554 WCMD_output ("No help available for %s\n", param1);
559 /****************************************************************************
562 * Batch file jump instruction. Not the most efficient algorithm ;-)
563 * Prints error message if the specified label cannot be found - the file pointer is
564 * then at EOF, effectively stopping the batch file.
565 * FIXME: DOS is supposed to allow labels with spaces - we don't.
568 void WCMD_goto (void) {
570 char string[MAX_PATH];
572 if (param1[0] == 0x00) {
573 WCMD_output ("Argument missing\n");
576 if (context != NULL) {
577 char *paramStart = param1;
579 /* Handle special :EOF label */
580 if (lstrcmpi (":eof", param1) == 0) {
581 context -> skip_rest = TRUE;
585 /* Support goto :label as well as goto label */
586 if (*paramStart == ':') paramStart++;
588 SetFilePointer (context -> h, 0, NULL, FILE_BEGIN);
589 while (WCMD_fgets (string, sizeof(string), context -> h)) {
590 if ((string[0] == ':') && (lstrcmpi (&string[1], paramStart) == 0)) return;
592 WCMD_output ("Target to GOTO not found\n");
597 /*****************************************************************************
600 * Push a directory onto the stack
603 void WCMD_pushd (char *command) {
604 struct env_stack *curdir;
607 if (strchr(command, '/') != NULL) {
608 SetLastError(ERROR_INVALID_PARAMETER);
613 curdir = LocalAlloc (LMEM_FIXED, sizeof (struct env_stack));
614 thisdir = LocalAlloc (LMEM_FIXED, 1024 * sizeof(WCHAR));
615 if( !curdir || !thisdir ) {
618 WCMD_output ("out of memory\n");
622 /* Change directory using CD code with /D parameter */
624 GetCurrentDirectoryW (1024, thisdir);
626 WCMD_setshow_default(command);
632 curdir -> next = pushd_directories;
633 curdir -> strings = thisdir;
634 if (pushd_directories == NULL) {
635 curdir -> u.stackdepth = 1;
637 curdir -> u.stackdepth = pushd_directories -> u.stackdepth + 1;
639 pushd_directories = curdir;
644 /*****************************************************************************
647 * Pop a directory from the stack
650 void WCMD_popd (void) {
651 struct env_stack *temp = pushd_directories;
653 if (!pushd_directories)
656 /* pop the old environment from the stack, and make it the current dir */
657 pushd_directories = temp->next;
658 SetCurrentDirectoryW(temp->strings);
659 LocalFree (temp->strings);
663 /****************************************************************************
666 * Batch file conditional.
667 * FIXME: Much more syntax checking needed!
670 void WCMD_if (char *p) {
672 int negate = 0, test = 0;
673 char condition[MAX_PATH], *command, *s;
675 if (!lstrcmpi (param1, "not")) {
677 lstrcpy (condition, param2);
680 lstrcpy (condition, param1);
682 if (!lstrcmpi (condition, "errorlevel")) {
683 if (errorlevel >= atoi(WCMD_parameter (p, 1+negate, NULL))) test = 1;
684 WCMD_parameter (p, 2+negate, &command);
686 else if (!lstrcmpi (condition, "exist")) {
687 if (GetFileAttributesA(WCMD_parameter (p, 1+negate, NULL)) != INVALID_FILE_ATTRIBUTES) {
690 WCMD_parameter (p, 2+negate, &command);
692 else if (!lstrcmpi (condition, "defined")) {
693 if (GetEnvironmentVariableA(WCMD_parameter (p, 1+negate, NULL), NULL, 0) > 0) {
696 WCMD_parameter (p, 2+negate, &command);
698 else if ((s = strstr (p, "=="))) {
700 if (!lstrcmpi (condition, WCMD_parameter (s, 0, NULL))) test = 1;
701 WCMD_parameter (s, 1, &command);
704 WCMD_output ("Syntax error\n");
707 if (test != negate) {
708 command = strdup (command);
709 WCMD_process_command (command);
714 /****************************************************************************
717 * Move a file, directory tree or wildcarded set of files.
720 void WCMD_move (void) {
725 char input[MAX_PATH];
726 char output[MAX_PATH];
729 char fname[MAX_PATH];
732 if (param1[0] == 0x00) {
733 WCMD_output ("Argument missing\n");
737 /* If no destination supplied, assume current directory */
738 if (param2[0] == 0x00) {
742 /* If 2nd parm is directory, then use original filename */
743 /* Convert partial path to full path */
744 GetFullPathName (param1, sizeof(input), input, NULL);
745 GetFullPathName (param2, sizeof(output), output, NULL);
746 WINE_TRACE("Move from '%s'('%s') to '%s'\n", input, param1, output);
748 /* Split into components */
749 WCMD_splitpath(input, drive, dir, fname, ext);
751 hff = FindFirstFile (input, &fd);
752 while (hff != INVALID_HANDLE_VALUE) {
757 WINE_TRACE("Processing file '%s'\n", fd.cFileName);
759 /* Build src & dest name */
763 /* See if dest is an existing directory */
764 attribs = GetFileAttributes(output);
765 if (attribs != INVALID_FILE_ATTRIBUTES &&
766 (attribs & FILE_ATTRIBUTE_DIRECTORY)) {
767 strcpy(dest, output);
769 strcat(dest, fd.cFileName);
771 strcpy(dest, output);
774 strcat(src, fd.cFileName);
776 WINE_TRACE("Source '%s'\n", src);
777 WINE_TRACE("Dest '%s'\n", dest);
779 /* Check if file is read only, otherwise move it */
780 attribs = GetFileAttributesA(src);
781 if ((attribs != INVALID_FILE_ATTRIBUTES) &&
782 (attribs & FILE_ATTRIBUTE_READONLY)) {
783 SetLastError(ERROR_ACCESS_DENIED);
786 status = MoveFile (src, dest);
794 /* Step on to next match */
795 if (FindNextFile(hff, &fd) == 0) {
797 hff = INVALID_HANDLE_VALUE;
803 /****************************************************************************
806 * Wait for keyboard input.
809 void WCMD_pause (void) {
814 WCMD_output (anykey);
815 ReadFile (GetStdHandle(STD_INPUT_HANDLE), string, sizeof(string), &count, NULL);
818 /****************************************************************************
821 * Delete a directory.
824 void WCMD_remove_dir (char *command) {
827 int argsProcessed = 0;
828 char *argN = command;
830 /* Loop through all args */
832 char *thisArg = WCMD_parameter (command, argno++, &argN);
833 if (argN && argN[0] != '/') {
834 WINE_TRACE("rd: Processing arg %s (quals:%s)\n", thisArg, quals);
837 /* If subdirectory search not supplied, just try to remove
838 and report error if it fails (eg if it contains a file) */
839 if (strstr (quals, "/S") == NULL) {
840 if (!RemoveDirectory (thisArg)) WCMD_print_error ();
842 /* Otherwise use ShFileOp to recursively remove a directory */
845 SHFILEOPSTRUCT lpDir;
848 if (strstr (quals, "/Q") == NULL) {
850 char question[MAXSTRING];
852 /* Ask for confirmation */
853 sprintf(question, "%s, ", thisArg);
854 ok = WCMD_ask_confirm(question, TRUE);
856 /* Abort if answer is 'N' */
863 lpDir.pFrom = thisArg;
864 lpDir.fFlags = FOF_SILENT | FOF_NOCONFIRMATION | FOF_NOERRORUI;
865 lpDir.wFunc = FO_DELETE;
866 if (SHFileOperationA(&lpDir)) WCMD_print_error ();
871 /* Handle no valid args */
872 if (argsProcessed == 0) {
873 WCMD_output ("Argument missing\n");
879 /****************************************************************************
885 void WCMD_rename (void) {
890 char input[MAX_PATH];
894 char fname[MAX_PATH];
900 /* Must be at least two args */
901 if (param1[0] == 0x00 || param2[0] == 0x00) {
902 WCMD_output ("Argument missing\n");
907 /* Destination cannot contain a drive letter or directory separator */
908 if ((strchr(param1,':') != NULL) || (strchr(param1,'\\') != NULL)) {
909 SetLastError(ERROR_INVALID_PARAMETER);
915 /* Convert partial path to full path */
916 GetFullPathName (param1, sizeof(input), input, NULL);
917 WINE_TRACE("Rename from '%s'('%s') to '%s'\n", input, param1, param2);
918 dotDst = strchr(param2, '.');
920 /* Split into components */
921 WCMD_splitpath(input, drive, dir, fname, ext);
923 hff = FindFirstFile (input, &fd);
924 while (hff != INVALID_HANDLE_VALUE) {
930 WINE_TRACE("Processing file '%s'\n", fd.cFileName);
932 /* FIXME: If dest name or extension is *, replace with filename/ext
933 part otherwise use supplied name. This supports:
936 However, windows has a more complex algorithum supporting eg
937 ?'s and *'s mid name */
938 dotSrc = strchr(fd.cFileName, '.');
940 /* Build src & dest name */
944 dirLen = strlen(src);
945 strcat(src, fd.cFileName);
948 if (param2[0] == '*') {
949 strcat(dest, fd.cFileName);
950 if (dotSrc) dest[dirLen + (dotSrc - fd.cFileName)] = 0x00;
952 strcat(dest, param2);
953 if (dotDst) dest[dirLen + (dotDst - param2)] = 0x00;
956 /* Build Extension */
957 if (dotDst && (*(dotDst+1)=='*')) {
958 if (dotSrc) strcat(dest, dotSrc);
960 if (dotDst) strcat(dest, dotDst);
963 WINE_TRACE("Source '%s'\n", src);
964 WINE_TRACE("Dest '%s'\n", dest);
966 /* Check if file is read only, otherwise move it */
967 attribs = GetFileAttributesA(src);
968 if ((attribs != INVALID_FILE_ATTRIBUTES) &&
969 (attribs & FILE_ATTRIBUTE_READONLY)) {
970 SetLastError(ERROR_ACCESS_DENIED);
973 status = MoveFile (src, dest);
981 /* Step on to next match */
982 if (FindNextFile(hff, &fd) == 0) {
984 hff = INVALID_HANDLE_VALUE;
990 /*****************************************************************************
993 * Make a copy of the environment.
995 static WCHAR *WCMD_dupenv( const WCHAR *env )
1005 len += (lstrlenW(&env[len]) + 1);
1007 env_copy = LocalAlloc (LMEM_FIXED, (len+1) * sizeof (WCHAR) );
1010 WCMD_output ("out of memory\n");
1013 memcpy (env_copy, env, len*sizeof (WCHAR));
1019 /*****************************************************************************
1022 * setlocal pushes the environment onto a stack
1023 * Save the environment as unicode so we don't screw anything up.
1025 void WCMD_setlocal (const char *s) {
1027 struct env_stack *env_copy;
1030 /* DISABLEEXTENSIONS ignored */
1032 env_copy = LocalAlloc (LMEM_FIXED, sizeof (struct env_stack));
1035 WCMD_output ("out of memory\n");
1039 env = GetEnvironmentStringsW ();
1041 env_copy->strings = WCMD_dupenv (env);
1042 if (env_copy->strings)
1044 env_copy->next = saved_environment;
1045 saved_environment = env_copy;
1047 /* Save the current drive letter */
1048 GetCurrentDirectory (MAX_PATH, cwd);
1049 env_copy->u.cwd = cwd[0];
1052 LocalFree (env_copy);
1054 FreeEnvironmentStringsW (env);
1058 /*****************************************************************************
1061 static inline WCHAR *WCMD_strchrW(WCHAR *str, WCHAR ch)
1072 /*****************************************************************************
1075 * endlocal pops the environment off a stack
1076 * Note: When searching for '=', search from char position 1, to handle
1077 * special internal environment variables =C:, =D: etc
1079 void WCMD_endlocal (void) {
1080 WCHAR *env, *old, *p;
1081 struct env_stack *temp;
1084 if (!saved_environment)
1087 /* pop the old environment from the stack */
1088 temp = saved_environment;
1089 saved_environment = temp->next;
1091 /* delete the current environment, totally */
1092 env = GetEnvironmentStringsW ();
1093 old = WCMD_dupenv (GetEnvironmentStringsW ());
1096 n = lstrlenW(&old[len]) + 1;
1097 p = WCMD_strchrW(&old[len] + 1, '=');
1101 SetEnvironmentVariableW (&old[len], NULL);
1106 FreeEnvironmentStringsW (env);
1108 /* restore old environment */
1109 env = temp->strings;
1112 n = lstrlenW(&env[len]) + 1;
1113 p = WCMD_strchrW(&env[len] + 1, '=');
1117 SetEnvironmentVariableW (&env[len], p);
1122 /* Restore current drive letter */
1123 if (IsCharAlpha(temp->u.cwd)) {
1126 sprintf(envvar, "=%c:", temp->u.cwd);
1127 if (GetEnvironmentVariable(envvar, cwd, MAX_PATH)) {
1128 WINE_TRACE("Resetting cwd to %s\n", cwd);
1129 SetCurrentDirectory(cwd);
1137 /*****************************************************************************
1138 * WCMD_setshow_attrib
1140 * Display and optionally sets DOS attributes on a file or directory
1142 * FIXME: Wine currently uses the Unix stat() function to get file attributes.
1143 * As a result only the Readonly flag is correctly reported, the Archive bit
1144 * is always set and the rest are not implemented. We do the Right Thing anyway.
1146 * FIXME: No SET functionality.
1150 void WCMD_setshow_attrib (void) {
1155 char flags[9] = {" "};
1157 if (param1[0] == '-') {
1162 if (lstrlen(param1) == 0) {
1163 GetCurrentDirectory (sizeof(param1), param1);
1164 strcat (param1, "\\*");
1167 hff = FindFirstFile (param1, &fd);
1168 if (hff == INVALID_HANDLE_VALUE) {
1169 WCMD_output ("%s: File Not Found\n",param1);
1173 if (!(fd.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)) {
1174 if (fd.dwFileAttributes & FILE_ATTRIBUTE_HIDDEN) {
1177 if (fd.dwFileAttributes & FILE_ATTRIBUTE_SYSTEM) {
1180 if (fd.dwFileAttributes & FILE_ATTRIBUTE_ARCHIVE) {
1183 if (fd.dwFileAttributes & FILE_ATTRIBUTE_READONLY) {
1186 if (fd.dwFileAttributes & FILE_ATTRIBUTE_TEMPORARY) {
1189 if (fd.dwFileAttributes & FILE_ATTRIBUTE_COMPRESSED) {
1192 WCMD_output ("%s %s\n", flags, fd.cFileName);
1193 for (count=0; count < 8; count++) flags[count] = ' ';
1195 } while (FindNextFile(hff, &fd) != 0);
1200 /*****************************************************************************
1201 * WCMD_setshow_default
1203 * Set/Show the current default directory
1206 void WCMD_setshow_default (char *command) {
1215 WINE_TRACE("Request change to directory '%s'\n", command);
1217 /* Skip /D and trailing whitespace if on the front of the command line */
1218 if (CompareString (LOCALE_USER_DEFAULT,
1219 NORM_IGNORECASE | SORT_STRINGSORT,
1220 command, 2, "/D", -1) == 2) {
1222 while (*command && *command==' ') command++;
1225 GetCurrentDirectory (sizeof(cwd), cwd);
1226 if (strlen(command) == 0) {
1231 /* Remove any double quotes, which may be in the
1232 middle, eg. cd "C:\Program Files"\Microsoft is ok */
1235 if (*command != '"') *pos++ = *command;
1240 /* Search for approprate directory */
1241 WINE_TRACE("Looking for directory '%s'\n", string);
1242 hff = FindFirstFile (string, &fd);
1243 while (hff != INVALID_HANDLE_VALUE) {
1244 if (fd.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
1245 char fpath[MAX_PATH];
1248 char fname[MAX_PATH];
1251 /* Convert path into actual directory spec */
1252 GetFullPathName (string, sizeof(fpath), fpath, NULL);
1253 WCMD_splitpath(fpath, drive, dir, fname, ext);
1256 sprintf(string, "%s%s%s", drive, dir, fd.cFileName);
1259 hff = INVALID_HANDLE_VALUE;
1263 /* Step on to next match */
1264 if (FindNextFile(hff, &fd) == 0) {
1266 hff = INVALID_HANDLE_VALUE;
1271 /* Change to that directory */
1272 WINE_TRACE("Really changing to directory '%s'\n", string);
1274 status = SetCurrentDirectory (string);
1277 WCMD_print_error ();
1281 /* Restore old directory if drive letter would change, and
1282 CD x:\directory /D (or pushd c:\directory) not supplied */
1283 if ((strstr(quals, "/D") == NULL) &&
1284 (param1[1] == ':') && (toupper(param1[0]) != toupper(cwd[0]))) {
1285 SetCurrentDirectory(cwd);
1289 /* Set special =C: type environment variable, for drive letter of
1290 change of directory, even if path was restored due to missing
1291 /D (allows changing drive letter when not resident on that
1293 if ((string[1] == ':') && IsCharAlpha (string[0])) {
1296 strncpy(env+1, string, 2);
1298 SetEnvironmentVariable(env, string);
1305 /****************************************************************************
1308 * Set/Show the system date
1309 * FIXME: Can't change date yet
1312 void WCMD_setshow_date (void) {
1314 char curdate[64], buffer[64];
1317 if (lstrlen(param1) == 0) {
1318 if (GetDateFormat (LOCALE_USER_DEFAULT, 0, NULL, NULL,
1319 curdate, sizeof(curdate))) {
1320 WCMD_output ("Current Date is %s\n", curdate);
1321 if (strstr (quals, "/T") == NULL) {
1322 WCMD_output("Enter new date: ");
1323 ReadFile (GetStdHandle(STD_INPUT_HANDLE), buffer, sizeof(buffer), &count, NULL);
1329 else WCMD_print_error ();
1336 /****************************************************************************
1339 static int WCMD_compare( const void *a, const void *b )
1342 const char * const *str_a = a, * const *str_b = b;
1343 r = CompareString( LOCALE_USER_DEFAULT, NORM_IGNORECASE | SORT_STRINGSORT,
1344 *str_a, -1, *str_b, -1 );
1345 if( r == CSTR_LESS_THAN ) return -1;
1346 if( r == CSTR_GREATER_THAN ) return 1;
1350 /****************************************************************************
1351 * WCMD_setshow_sortenv
1353 * sort variables into order for display
1354 * Optionally only display those who start with a stub
1355 * returns the count displayed
1357 static int WCMD_setshow_sortenv(const char *s, const char *stub)
1359 UINT count=0, len=0, i, displayedcount=0, stublen=0;
1362 if (stub) stublen = strlen(stub);
1364 /* count the number of strings, and the total length */
1366 len += (lstrlen(&s[len]) + 1);
1370 /* add the strings to an array */
1371 str = LocalAlloc (LMEM_FIXED | LMEM_ZEROINIT, count * sizeof (char*) );
1375 for( i=1; i<count; i++ )
1376 str[i] = str[i-1] + lstrlen(str[i-1]) + 1;
1378 /* sort the array */
1379 qsort( str, count, sizeof (char*), WCMD_compare );
1382 for( i=0; i<count; i++ ) {
1383 if (!stub || CompareString (LOCALE_USER_DEFAULT,
1384 NORM_IGNORECASE | SORT_STRINGSORT,
1385 str[i], stublen, stub, -1) == 2) {
1386 /* Don't display special internal variables */
1387 if (str[i][0] != '=') {
1388 WCMD_output_asis(str[i]);
1389 WCMD_output_asis("\n");
1396 return displayedcount;
1399 /****************************************************************************
1402 * Set/Show the environment variables
1405 void WCMD_setshow_env (char *s) {
1412 if (param1[0] == 0x00 && quals[0] == 0x00) {
1413 env = GetEnvironmentStrings ();
1414 WCMD_setshow_sortenv( env, NULL );
1418 /* See if /P supplied, and if so echo the prompt, and read in a reply */
1419 if (CompareString (LOCALE_USER_DEFAULT,
1420 NORM_IGNORECASE | SORT_STRINGSORT,
1421 s, 2, "/P", -1) == 2) {
1422 char string[MAXSTRING];
1426 while (*s && *s==' ') s++;
1428 /* If no parameter, or no '=' sign, return an error */
1429 if (!(*s) || ((p = strchr (s, '=')) == NULL )) {
1430 WCMD_output ("Argument missing\n");
1434 /* Output the prompt */
1436 if (strlen(p) != 0) WCMD_output(p);
1438 /* Read the reply */
1439 ReadFile (GetStdHandle(STD_INPUT_HANDLE), string, sizeof(string), &count, NULL);
1441 string[count-1] = '\0'; /* ReadFile output is not null-terminated! */
1442 if (string[count-2] == '\r') string[count-2] = '\0'; /* Under Windoze we get CRLF! */
1443 WINE_TRACE("set /p: Setting var '%s' to '%s'\n", s, string);
1444 status = SetEnvironmentVariable (s, string);
1449 p = strchr (s, '=');
1451 env = GetEnvironmentStrings ();
1452 if (WCMD_setshow_sortenv( env, s ) == 0) {
1453 WCMD_output ("Environment variable %s not defined\n", s);
1460 if (strlen(p) == 0) p = NULL;
1461 status = SetEnvironmentVariable (s, p);
1462 gle = GetLastError();
1463 if ((!status) & (gle == ERROR_ENVVAR_NOT_FOUND)) {
1465 } else if ((!status)) WCMD_print_error();
1469 /****************************************************************************
1472 * Set/Show the path environment variable
1475 void WCMD_setshow_path (char *command) {
1480 if (strlen(param1) == 0) {
1481 status = GetEnvironmentVariable ("PATH", string, sizeof(string));
1483 WCMD_output_asis ( "PATH=");
1484 WCMD_output_asis ( string);
1485 WCMD_output_asis ( "\n");
1488 WCMD_output ("PATH not found\n");
1492 if (*command == '=') command++; /* Skip leading '=' */
1493 status = SetEnvironmentVariable ("PATH", command);
1494 if (!status) WCMD_print_error();
1498 /****************************************************************************
1499 * WCMD_setshow_prompt
1501 * Set or show the command prompt.
1504 void WCMD_setshow_prompt (void) {
1508 if (strlen(param1) == 0) {
1509 SetEnvironmentVariable ("PROMPT", NULL);
1513 while ((*s == '=') || (*s == ' ')) s++;
1514 if (strlen(s) == 0) {
1515 SetEnvironmentVariable ("PROMPT", NULL);
1517 else SetEnvironmentVariable ("PROMPT", s);
1521 /****************************************************************************
1524 * Set/Show the system time
1525 * FIXME: Can't change time yet
1528 void WCMD_setshow_time (void) {
1530 char curtime[64], buffer[64];
1534 if (strlen(param1) == 0) {
1536 if (GetTimeFormat (LOCALE_USER_DEFAULT, 0, &st, NULL,
1537 curtime, sizeof(curtime))) {
1538 WCMD_output ("Current Time is %s\n", curtime);
1539 if (strstr (quals, "/T") == NULL) {
1540 WCMD_output ("Enter new time: ", curtime);
1541 ReadFile (GetStdHandle(STD_INPUT_HANDLE), buffer, sizeof(buffer), &count, NULL);
1547 else WCMD_print_error ();
1554 /****************************************************************************
1557 * Shift batch parameters.
1558 * Optional /n says where to start shifting (n=0-8)
1561 void WCMD_shift (char *command) {
1564 if (context != NULL) {
1565 char *pos = strchr(command, '/');
1570 } else if (*(pos+1)>='0' && *(pos+1)<='8') {
1571 start = (*(pos+1) - '0');
1573 SetLastError(ERROR_INVALID_PARAMETER);
1578 WINE_TRACE("Shifting variables, starting at %d\n", start);
1579 for (i=start;i<=8;i++) {
1580 context -> shift_count[i] = context -> shift_count[i+1] + 1;
1582 context -> shift_count[9] = context -> shift_count[9] + 1;
1587 /****************************************************************************
1590 * Set the console title
1592 void WCMD_title (char *command) {
1593 SetConsoleTitle(command);
1596 /****************************************************************************
1599 * Copy a file to standard output.
1602 void WCMD_type (char *command) {
1605 char *argN = command;
1606 BOOL writeHeaders = FALSE;
1608 if (param1[0] == 0x00) {
1609 WCMD_output ("Argument missing\n");
1613 if (param2[0] != 0x00) writeHeaders = TRUE;
1615 /* Loop through all args */
1618 char *thisArg = WCMD_parameter (command, argno++, &argN);
1626 WINE_TRACE("type: Processing arg '%s'\n", thisArg);
1627 h = CreateFile (thisArg, GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING,
1628 FILE_ATTRIBUTE_NORMAL, NULL);
1629 if (h == INVALID_HANDLE_VALUE) {
1630 WCMD_print_error ();
1631 WCMD_output ("%s :Failed\n", thisArg);
1635 WCMD_output("\n%s\n\n", thisArg);
1637 while (ReadFile (h, buffer, sizeof(buffer), &count, NULL)) {
1638 if (count == 0) break; /* ReadFile reports success on EOF! */
1640 WCMD_output_asis (buffer);
1647 /****************************************************************************
1650 * Display verify flag.
1651 * FIXME: We don't actually do anything with the verify flag other than toggle
1655 void WCMD_verify (char *command) {
1657 static const char von[] = "Verify is ON\n", voff[] = "Verify is OFF\n";
1660 count = strlen(command);
1662 if (verify_mode) WCMD_output (von);
1663 else WCMD_output (voff);
1666 if (lstrcmpi(command, "ON") == 0) {
1670 else if (lstrcmpi(command, "OFF") == 0) {
1674 else WCMD_output ("Verify must be ON or OFF\n");
1677 /****************************************************************************
1680 * Display version info.
1683 void WCMD_version (void) {
1685 WCMD_output (version_string);
1689 /****************************************************************************
1692 * Display volume info and/or set volume label. Returns 0 if error.
1695 int WCMD_volume (int mode, char *path) {
1697 DWORD count, serial;
1698 char string[MAX_PATH], label[MAX_PATH], curdir[MAX_PATH];
1701 if (lstrlen(path) == 0) {
1702 status = GetCurrentDirectory (sizeof(curdir), curdir);
1704 WCMD_print_error ();
1707 status = GetVolumeInformation (NULL, label, sizeof(label), &serial, NULL,
1711 if ((path[1] != ':') || (lstrlen(path) != 2)) {
1712 WCMD_output_asis("Syntax Error\n\n");
1715 wsprintf (curdir, "%s\\", path);
1716 status = GetVolumeInformation (curdir, label, sizeof(label), &serial, NULL,
1720 WCMD_print_error ();
1723 WCMD_output ("Volume in drive %c is %s\nVolume Serial Number is %04x-%04x\n\n",
1724 curdir[0], label, HIWORD(serial), LOWORD(serial));
1726 WCMD_output ("Volume label (11 characters, ENTER for none)?");
1727 ReadFile (GetStdHandle(STD_INPUT_HANDLE), string, sizeof(string), &count, NULL);
1729 string[count-1] = '\0'; /* ReadFile output is not null-terminated! */
1730 if (string[count-2] == '\r') string[count-2] = '\0'; /* Under Windoze we get CRLF! */
1732 if (lstrlen(path) != 0) {
1733 if (!SetVolumeLabel (curdir, string)) WCMD_print_error ();
1736 if (!SetVolumeLabel (NULL, string)) WCMD_print_error ();
1742 /**************************************************************************
1745 * Exit either the process, or just this batch program
1749 void WCMD_exit (void) {
1751 int rc = atoi(param1); /* Note: atoi of empty parameter is 0 */
1753 if (context && lstrcmpi(quals, "/B") == 0) {
1755 context -> skip_rest = TRUE;
1761 /**************************************************************************
1764 * Issue a message and ask 'Are you sure (Y/N)', waiting on a valid
1767 * Returns True if Y answer is selected
1770 BOOL WCMD_ask_confirm (char *message, BOOL showSureText) {
1772 char msgbuffer[MAXSTRING];
1773 char Ybuffer[MAXSTRING];
1774 char Nbuffer[MAXSTRING];
1775 char answer[MAX_PATH] = "";
1778 /* Load the translated 'Are you sure', plus valid answers */
1779 LoadString (hinst, WCMD_CONFIRM, msgbuffer, sizeof(msgbuffer));
1780 LoadString (hinst, WCMD_YES, Ybuffer, sizeof(Ybuffer));
1781 LoadString (hinst, WCMD_NO, Nbuffer, sizeof(Nbuffer));
1783 /* Loop waiting on a Y or N */
1784 while (answer[0] != Ybuffer[0] && answer[0] != Nbuffer[0]) {
1785 WCMD_output_asis (message);
1787 WCMD_output_asis (msgbuffer);
1789 WCMD_output_asis (" (");
1790 WCMD_output_asis (Ybuffer);
1791 WCMD_output_asis ("/");
1792 WCMD_output_asis (Nbuffer);
1793 WCMD_output_asis (")?");
1794 ReadFile (GetStdHandle(STD_INPUT_HANDLE), answer, sizeof(answer),
1796 answer[0] = toupper(answer[0]);
1799 /* Return the answer */
1800 return (answer[0] == Ybuffer[0]);
1803 /*****************************************************************************
1806 * Lists or sets file associations (assoc = TRUE)
1807 * Lists or sets file types (assoc = FALSE)
1809 void WCMD_assoc (char *command, BOOL assoc) {
1812 DWORD accessOptions = KEY_READ;
1814 LONG rc = ERROR_SUCCESS;
1815 char keyValue[MAXSTRING];
1816 DWORD valueLen = MAXSTRING;
1820 /* See if parameter includes '=' */
1822 newValue = strchr(command, '=');
1823 if (newValue) accessOptions |= KEY_WRITE;
1825 /* Open a key to HKEY_CLASSES_ROOT for enumerating */
1826 if (RegOpenKeyEx(HKEY_CLASSES_ROOT, "", 0,
1827 accessOptions, &key) != ERROR_SUCCESS) {
1828 WINE_FIXME("Unexpected failure opening HKCR key: %d\n", GetLastError());
1832 /* If no parameters then list all associations */
1833 if (*command == 0x00) {
1836 /* Enumerate all the keys */
1837 while (rc != ERROR_NO_MORE_ITEMS) {
1838 char keyName[MAXSTRING];
1841 /* Find the next value */
1842 nameLen = MAXSTRING;
1843 rc = RegEnumKeyEx(key, index++,
1845 NULL, NULL, NULL, NULL);
1847 if (rc == ERROR_SUCCESS) {
1849 /* Only interested in extension ones if assoc, or others
1851 if ((keyName[0] == '.' && assoc) ||
1852 (!(keyName[0] == '.') && (!assoc)))
1854 char subkey[MAXSTRING];
1855 strcpy(subkey, keyName);
1856 if (!assoc) strcat(subkey, "\\Shell\\Open\\Command");
1858 if (RegOpenKeyEx(key, subkey, 0,
1859 accessOptions, &readKey) == ERROR_SUCCESS) {
1861 valueLen = sizeof(keyValue);
1862 rc = RegQueryValueEx(readKey, NULL, NULL, NULL,
1863 (LPBYTE)keyValue, &valueLen);
1864 WCMD_output_asis(keyName);
1865 WCMD_output_asis("=");
1866 /* If no default value found, leave line empty after '=' */
1867 if (rc == ERROR_SUCCESS) {
1868 WCMD_output_asis(keyValue);
1870 WCMD_output_asis("\n");
1875 RegCloseKey(readKey);
1879 /* Parameter supplied - if no '=' on command line, its a query */
1880 if (newValue == NULL) {
1882 char subkey[MAXSTRING];
1884 /* Query terminates the parameter at the first space */
1885 strcpy(keyValue, command);
1886 space = strchr(keyValue, ' ');
1887 if (space) *space=0x00;
1889 /* Set up key name */
1890 strcpy(subkey, keyValue);
1891 if (!assoc) strcat(subkey, "\\Shell\\Open\\Command");
1893 if (RegOpenKeyEx(key, subkey, 0,
1894 accessOptions, &readKey) == ERROR_SUCCESS) {
1896 rc = RegQueryValueEx(readKey, NULL, NULL, NULL,
1897 (LPBYTE)keyValue, &valueLen);
1898 WCMD_output_asis(command);
1899 WCMD_output_asis("=");
1900 /* If no default value found, leave line empty after '=' */
1901 if (rc == ERROR_SUCCESS) WCMD_output_asis(keyValue);
1902 WCMD_output_asis("\n");
1903 RegCloseKey(readKey);
1906 char msgbuffer[MAXSTRING];
1907 char outbuffer[MAXSTRING];
1909 /* Load the translated 'File association not found' */
1911 LoadString (hinst, WCMD_NOASSOC, msgbuffer, sizeof(msgbuffer));
1913 LoadString (hinst, WCMD_NOFTYPE, msgbuffer, sizeof(msgbuffer));
1915 sprintf(outbuffer, msgbuffer, keyValue);
1916 WCMD_output_asis(outbuffer);
1920 /* Not a query - its a set or clear of a value */
1923 char subkey[MAXSTRING];
1925 /* Get pointer to new value */
1929 /* Set up key name */
1930 strcpy(subkey, command);
1931 if (!assoc) strcat(subkey, "\\Shell\\Open\\Command");
1933 /* If nothing after '=' then clear value - only valid for ASSOC */
1934 if (*newValue == 0x00) {
1936 if (assoc) rc = RegDeleteKey(key, command);
1937 if (assoc && rc == ERROR_SUCCESS) {
1938 WINE_TRACE("HKCR Key '%s' deleted\n", command);
1940 } else if (assoc && rc != ERROR_FILE_NOT_FOUND) {
1945 char msgbuffer[MAXSTRING];
1946 char outbuffer[MAXSTRING];
1948 /* Load the translated 'File association not found' */
1950 LoadString (hinst, WCMD_NOASSOC, msgbuffer, sizeof(msgbuffer));
1952 LoadString (hinst, WCMD_NOFTYPE, msgbuffer, sizeof(msgbuffer));
1954 sprintf(outbuffer, msgbuffer, keyValue);
1955 WCMD_output_asis(outbuffer);
1959 /* It really is a set value = contents */
1961 rc = RegCreateKeyEx(key, subkey, 0, NULL, REG_OPTION_NON_VOLATILE,
1962 accessOptions, NULL, &readKey, NULL);
1963 if (rc == ERROR_SUCCESS) {
1964 rc = RegSetValueEx(readKey, NULL, 0, REG_SZ,
1965 (LPBYTE)newValue, strlen(newValue));
1966 RegCloseKey(readKey);
1969 if (rc != ERROR_SUCCESS) {
1973 WCMD_output_asis(command);
1974 WCMD_output_asis("=");
1975 WCMD_output_asis(newValue);
1976 WCMD_output_asis("\n");
1986 /****************************************************************************
1989 * Clear the terminal screen.
1992 void WCMD_color (void) {
1994 /* Emulate by filling the screen from the top left to bottom right with
1995 spaces, then moving the cursor to the top left afterwards */
1996 CONSOLE_SCREEN_BUFFER_INFO consoleInfo;
1997 HANDLE hStdOut = GetStdHandle(STD_OUTPUT_HANDLE);
1999 if (param1[0] != 0x00 && strlen(param1) > 2) {
2000 WCMD_output ("Argument invalid\n");
2004 if (GetConsoleScreenBufferInfo(hStdOut, &consoleInfo))
2010 screenSize = consoleInfo.dwSize.X * (consoleInfo.dwSize.Y + 1);
2015 /* Convert the color hex digits */
2016 if (param1[0] == 0x00) {
2017 color = defaultColor;
2019 color = strtoul(param1, NULL, 16);
2022 /* Fail if fg == bg color */
2023 if (((color & 0xF0) >> 4) == (color & 0x0F)) {
2028 /* Set the current screen contents and ensure all future writes
2029 remain this color */
2030 FillConsoleOutputAttribute(hStdOut, color, screenSize, topLeft, &screenSize);
2031 SetConsoleTextAttribute(hStdOut, color);